@lark-apaas/coding-html-devserver 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/README.md

@@ -0,0 +1,54 @@
+# @lark-apaas/coding-html-devserver
+
+miaoda-coding **html stack** 的 dev/build 工具链。**vite 被封装在内部**——消费方（html 模板）只依赖本包、调它的 bin,**`package.json` 里看不到 vite、也没有 `vite.config`**。
+
+- **dev**:内部用 vite 起 dev server,拿 vite 原生 **HMR/热更新**(WS,经 `MIAODA_WS_HOST` 切独立域名穿沙箱网关) + `/dev/health` 探活 + 平台脚本注入。
+- **build**:**不走 vite build**,纯拷贝 `src → dist/output`(文件名/路径/结构逐字保留)+ 平台脚本注入 + 可选 HTML 压缩。
+- **平台脚本注入**:dev / build 共用一份清单,**用户不感知**、源文件保持纯净。
+
+## 为什么这么设计
+
+html stack 要的是 vite 那种**即时热更新体验**(轮询追不上),所以 dev 直接借 vite;但 vite build 会打包/加 hash/改写路径,跟"纯 HTML 产物 = 源码"冲突,所以 build 自己做纯拷贝。vite 全程是本包的内部依赖,对用户透明。
+
+## 用法
+
+```jsonc
+// 消费方（html 模板）package.json —— 全程不出现 vite
+"devDependencies": { "@lark-apaas/coding-html-devserver": "^0.1.0" },
+"scripts": {
+  "dev":   "coding-html-devserver dev",
+  "build": "coding-html-devserver build"
+}
+```
+
+```bash
+coding-html-devserver dev   [--root src] [--port 8001] [--host 0.0.0.0]
+coding-html-devserver build [--root src] [--out dist/output] [--no-minify]
+```
+
+端口优先级:`--port` > `CLIENT_DEV_PORT` env > `8001`。绑定 `0.0.0.0`、`allowedHosts: true`、不设 `base`(prefix 由沙箱网关剥)。HMR 在 `MIAODA_WS_HOST` 存在时切独立 WS 域名(对齐 vite-react 网关方案)。
+
+## 平台注入(方案 A:烧进 SDK)
+
+注入清单是内部常量 `PLATFORM_TAGS`,随版本走、用户不可配置。改注入 = 发新版 → 模板 bump → re-render。注入实现只有一份(`injectTags`),dev 经 vite `transformIndexHtml` 插件调用、build 在拷贝后调用,两条路一致。
+
+描述符对齐 vite 的 `HtmlTagDescriptor`:
+
+```ts
+{ tag: 'script', attrs: { src: 'https://cdn/x.js', async: true }, injectTo: 'head' } // 外链 CDN
+{ tag: 'script', children: 'window.__X__=1', injectTo: 'head-prepend' }              // 内联 JS
+```
+
+机制:按 `injectTo` 分组保序、同 `src`/`id` 去重、内联 `</script>` 转义、畸形 HTML 锚点兜底。
+
+> 当前 `PLATFORM_TAGS` 为占位空清单;机制已完整实现并测试,真实平台脚本地址确定后填入即可,对 API 无影响。
+
+## 公共 API
+
+`startDevServer` · `buildStatic` · `createHtmlViteConfig` · `injectPlatformTags` · `injectTags` · `serializeTag` · `healthPlugin` · `platformInjectPlugin` · 类型 `HtmlTagDescriptor` 等。
+
+## 工程
+
+ESM 包(vite 8 仅 ESM)。`tsc → lib/`(NodeNext)。Node ≥22。
+
+设计文档:[`docs/superpowers/plans/2026-06-05-html-devserver-sdk.md`](../../../docs/superpowers/plans/2026-06-05-html-devserver-sdk.md)

package/bin/coding-html-devserver.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../lib/cli.js');

package/lib/build.d.ts

@@ -0,0 +1,23 @@
+export interface BuildOptions {
+    /** 静态根目录（相对 cwd），默认 'src'。 */
+    root?: string;
+    /** 产物目录（相对 cwd），默认 'dist/output'。 */
+    outDir?: string;
+    /** 是否压缩 HTML（含内联 css/js），默认 true。 */
+    minify?: boolean;
+}
+export interface BuildResult {
+    readonly root: string;
+    readonly outDir: string;
+    /** 注入（并按需压缩）过的 html 产物绝对路径列表。 */
+    readonly htmlFiles: string[];
+}
+/**
+ * build：把 `root` 全量**纯拷贝**到 `outDir`（文件名/路径/结构逐字保留），
+ * 再对产物里的每个 `.html` 注入平台脚本、按需原地压缩。
+ *
+ * 不走 vite build —— 不打包、不加 hash、不改写路径，保证「产物 = 源码」。
+ * 注入与 dev 共用 `injectPlatformTags`，两条路一致。
+ */
+export declare function buildStatic(opts?: BuildOptions): Promise<BuildResult>;
+//# sourceMappingURL=build.d.ts.map

package/lib/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;CAC9B;AAID;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAuB/E"}

package/lib/build.js

@@ -0,0 +1,50 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildStatic = buildStatic;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const transform_1 = require("./transform");
+const minify_1 = require("./minify");
+const HTML_EXT = new Set(['.html', '.htm']);
+/**
+ * build：把 `root` 全量**纯拷贝**到 `outDir`（文件名/路径/结构逐字保留），
+ * 再对产物里的每个 `.html` 注入平台脚本、按需原地压缩。
+ *
+ * 不走 vite build —— 不打包、不加 hash、不改写路径，保证「产物 = 源码」。
+ * 注入与 dev 共用 `injectPlatformTags`，两条路一致。
+ */
+async function buildStatic(opts = {}) {
+    const root = node_path_1.default.resolve(opts.root ?? 'src');
+    const outDir = node_path_1.default.resolve(opts.outDir ?? 'dist/output');
+    const doMinify = opts.minify ?? true;
+    await node_fs_1.default.promises.rm(outDir, { recursive: true, force: true });
+    await node_fs_1.default.promises.mkdir(outDir, { recursive: true });
+    await node_fs_1.default.promises.cp(root, outDir, { recursive: true });
+    const htmlFiles = [];
+    for (const file of walk(outDir)) {
+        if (!HTML_EXT.has(node_path_1.default.extname(file).toLowerCase()))
+            continue;
+        let html = await node_fs_1.default.promises.readFile(file, 'utf8');
+        html = (0, transform_1.injectPlatformTags)(html);
+        if (doMinify) {
+            // 用 HBS-保护版 minify：占位符 {{...}} 在 CSS / inline JS 里不会被压坏
+            html = await (0, minify_1.minifyHtmlWithHbsProtection)(html);
+        }
+        await node_fs_1.default.promises.writeFile(file, html, 'utf8');
+        htmlFiles.push(file);
+    }
+    return { root, outDir, htmlFiles };
+}
+function* walk(dir) {
+    for (const entry of node_fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+        const full = node_path_1.default.join(dir, entry.name);
+        if (entry.isDirectory())
+            yield* walk(full);
+        else
+            yield full;
+    }
+}
+//# sourceMappingURL=build.js.map

package/lib/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":";;;;;AA8BA,kCAuBC;AArDD,sDAAyB;AACzB,0DAA6B;AAC7B,2CAAiD;AACjD,qCAAuD;AAkBvD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAE5C;;;;;;GAMG;AACI,KAAK,UAAU,WAAW,CAAC,OAAqB,EAAE;IACvD,MAAM,IAAI,GAAG,mBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,mBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,aAAa,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;IAErC,MAAM,iBAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,MAAM,iBAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,iBAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAExD,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,mBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YAAE,SAAS;QAC9D,IAAI,IAAI,GAAG,MAAM,iBAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpD,IAAI,GAAG,IAAA,8BAAkB,EAAC,IAAI,CAAC,CAAC;QAChC,IAAI,QAAQ,EAAE,CAAC;YACb,wDAAwD;YACxD,IAAI,GAAG,MAAM,IAAA,oCAA2B,EAAC,IAAI,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,iBAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAChD,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AACrC,CAAC;AAED,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAW;IACxB,KAAK,MAAM,KAAK,IAAI,iBAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,GAAG,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,KAAK,CAAC,WAAW,EAAE;YAAE,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YACtC,MAAM,IAAI,CAAC;IAClB,CAAC;AACH,CAAC"}

package/lib/cli.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/lib/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/lib/cli.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const dev_1 = require("./dev");
+const build_1 = require("./build");
+const flags_1 = require("./flags");
+const USAGE = `Usage: coding-html-devserver <dev|build> [options]
+
+  dev    [--root src] [--port 8001] [--host 0.0.0.0]
+  build  [--root src] [--out dist/output] [--no-minify]`;
+async function main() {
+    const [command, ...rest] = process.argv.slice(2);
+    const flags = (0, flags_1.parseFlags)(rest);
+    switch (command) {
+        case 'dev': {
+            const server = await (0, dev_1.startDevServer)(flags);
+            const shutdown = () => {
+                void server.close().then(() => process.exit(0));
+            };
+            process.on('SIGINT', shutdown);
+            process.on('SIGTERM', shutdown);
+            break;
+        }
+        case 'build': {
+            const { outDir, htmlFiles } = await (0, build_1.buildStatic)(flags);
+            // eslint-disable-next-line no-console
+            console.log(`[coding-html-devserver] build complete → ${outDir} (${htmlFiles.length} html)`);
+            break;
+        }
+        case '--help':
+        case '-h':
+        case undefined:
+            // eslint-disable-next-line no-console
+            console.log(USAGE);
+            break;
+        default:
+            // eslint-disable-next-line no-console
+            console.error(`Unknown command: ${command}\n\n${USAGE}`);
+            process.exit(1);
+    }
+}
+void main().catch((err) => {
+    // eslint-disable-next-line no-console
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/lib/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;AAAA,+BAAuC;AACvC,mCAAsC;AACtC,mCAAqC;AAErC,MAAM,KAAK,GAAG;;;wDAG0C,CAAC;AAEzD,KAAK,UAAU,IAAI;IACjB,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,IAAA,kBAAU,EAAC,IAAI,CAAC,CAAC;IAE/B,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,MAAM,MAAM,GAAG,MAAM,IAAA,oBAAc,EAAC,KAAK,CAAC,CAAC;YAC3C,MAAM,QAAQ,GAAG,GAAS,EAAE;gBAC1B,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAClD,CAAC,CAAC;YACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAChC,MAAM;QACR,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAA,mBAAW,EAAC,KAAK,CAAC,CAAC;YACvD,sCAAsC;YACtC,OAAO,CAAC,GAAG,CAAC,4CAA4C,MAAM,KAAK,SAAS,CAAC,MAAM,QAAQ,CAAC,CAAC;YAC7F,MAAM;QACR,CAAC;QACD,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI,CAAC;QACV,KAAK,SAAS;YACZ,sCAAsC;YACtC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACnB,MAAM;QACR;YACE,sCAAsC;YACtC,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC;YACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACxB,sCAAsC;IACtC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/lib/dev.d.ts

@@ -0,0 +1,8 @@
+import type { ViteDevServer } from 'vite';
+import { type HtmlViteOptions } from './vite-config';
+/**
+ * 起 html stack 的 dev server（vite 封装在内，用户不感知）。
+ * 热更新走 vite 原生 HMR/WS。
+ */
+export declare function startDevServer(opts?: HtmlViteOptions): Promise<ViteDevServer>;
+//# sourceMappingURL=dev.d.ts.map

package/lib/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../src/dev.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAY3E;;;GAGG;AACH,wBAAsB,cAAc,CAAC,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAMvF"}

package/lib/dev.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startDevServer = startDevServer;
+const vite_config_1 = require("./vite-config");
+/**
+ * vite 7/8 的 Node API 是 ESM-only（package `exports` 无 CJS 入口）。本包编译为
+ * CommonJS，而 tsc 在 `module: CommonJS` 下会把字面 `import()` 降级成 `require()`
+ * —— 对 ESM-only 的 vite 会 `ERR_REQUIRE_ESM`。用 `new Function` 包一层，让 tsc
+ * 看不到这是 import()，从而保留运行时真正的动态 ESM import。
+ */
+const importESM = new Function('specifier', 'return import(specifier)');
+/**
+ * 起 html stack 的 dev server（vite 封装在内，用户不感知）。
+ * 热更新走 vite 原生 HMR/WS。
+ */
+async function startDevServer(opts = {}) {
+    const { createServer } = await importESM('vite');
+    const server = await createServer((0, vite_config_1.createHtmlViteConfig)(opts));
+    await server.listen();
+    server.printUrls();
+    return server;
+}
+//# sourceMappingURL=dev.js.map

package/lib/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../src/dev.ts"],"names":[],"mappings":";;AAiBA,wCAMC;AAtBD,+CAA2E;AAE3E;;;;;GAKG;AACH,MAAM,SAAS,GAAG,IAAI,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAEvD,CAAC;AAEhB;;;GAGG;AACI,KAAK,UAAU,cAAc,CAAC,OAAwB,EAAE;IAC7D,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,SAAS,CAAwB,MAAM,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAA,kCAAoB,EAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,SAAS,EAAE,CAAC;IACnB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib/flags.d.ts

@@ -0,0 +1,10 @@
+import type { HtmlViteOptions } from './vite-config';
+import type { BuildOptions } from './build';
+export interface Flags extends HtmlViteOptions, BuildOptions {
+}
+/**
+ * 解析 CLI flags。`--port` 缺值/非整数/越界直接抛错（否则 NaN 会漏过 vite-config
+ * 的 `??` fallback 流进 vite，给出难懂的报错）。
+ */
+export declare function parseFlags(argv: string[]): Flags;
+//# sourceMappingURL=flags.d.ts.map

package/lib/flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../src/flags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,MAAM,WAAW,KAAM,SAAQ,eAAe,EAAE,YAAY;CAAG;AAE/D;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,CAkBhD"}

package/lib/flags.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseFlags = parseFlags;
+/**
+ * 解析 CLI flags。`--port` 缺值/非整数/越界直接抛错（否则 NaN 会漏过 vite-config
+ * 的 `??` fallback 流进 vite，给出难懂的报错）。
+ */
+function parseFlags(argv) {
+    const flags = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === '--root')
+            flags.root = argv[++i];
+        else if (arg === '--host')
+            flags.host = argv[++i];
+        else if (arg === '--out')
+            flags.outDir = argv[++i];
+        else if (arg === '--no-minify')
+            flags.minify = false;
+        else if (arg === '--port') {
+            const raw = argv[++i];
+            const n = Number(raw);
+            if (!Number.isInteger(n) || n < 0 || n > 65535) {
+                throw new Error(`--port 需要 0-65535 的整数，收到: ${raw ?? '(空)'}`);
+            }
+            flags.port = n;
+        }
+    }
+    return flags;
+}
+//# sourceMappingURL=flags.js.map

package/lib/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../src/flags.ts"],"names":[],"mappings":";;AASA,gCAkBC;AAtBD;;;GAGG;AACH,SAAgB,UAAU,CAAC,IAAc;IACvC,MAAM,KAAK,GAAU,EAAE,CAAC;IACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,KAAK,QAAQ;YAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;aACxC,IAAI,GAAG,KAAK,QAAQ;YAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;aAC7C,IAAI,GAAG,KAAK,OAAO;YAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;aAC9C,IAAI,GAAG,KAAK,aAAa;YAAE,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;aAChD,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACtB,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACtB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC;gBAC/C,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/lib/html-tags.d.ts

@@ -0,0 +1,25 @@
+/**
+ * HTML 标签注入原语。
+ *
+ * 描述符对齐 vite 的 `HtmlTagDescriptor`：泛化、向前兼容——
+ * 今天注 `<script>`，以后要注 `<link>`/`<meta>` 不用改契约。
+ */
+export type InjectPosition = 'head' | 'head-prepend' | 'body' | 'body-prepend';
+export interface HtmlTagDescriptor {
+    /** 标签名，如 'script' | 'link' | 'meta'。 */
+    tag: string;
+    /** 属性。`true` → 裸属性；`false`/`undefined` → 跳过；字符串 → key="value"。 */
+    attrs?: Record<string, string | boolean | undefined>;
+    /** 内联内容（如 inline `<script>` 的 body）。 */
+    children?: string;
+    /** 注入位置，默认 'head'。 */
+    injectTo?: InjectPosition;
+}
+export declare function serializeTag(tag: HtmlTagDescriptor): string;
+/**
+ * 把一组 tag 注入 html。
+ * - 已存在的（同 src / 同 id）跳过，保证幂等
+ * - 按 injectTo 分组、组内保序，确定性输出
+ */
+export declare function injectTags(html: string, tags: HtmlTagDescriptor[]): string;
+//# sourceMappingURL=html-tags.d.ts.map

package/lib/html-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-tags.d.ts","sourceRoot":"","sources":["../src/html-tags.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,cAAc,GAAG,MAAM,GAAG,cAAc,CAAC;AAE/E,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;IACrD,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AA+BD,wBAAgB,YAAY,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAO3D;AAwDD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAkB1E"}

package/lib/html-tags.js

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * HTML 标签注入原语。
+ *
+ * 描述符对齐 vite 的 `HtmlTagDescriptor`：泛化、向前兼容——
+ * 今天注 `<script>`，以后要注 `<link>`/`<meta>` 不用改契约。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeTag = serializeTag;
+exports.injectTags = injectTags;
+const VOID_TAGS = new Set(['link', 'meta', 'base', 'br', 'hr', 'img', 'input', 'source']);
+function escapeAttr(value) {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+function serializeAttrs(attrs) {
+    if (!attrs)
+        return '';
+    const parts = [];
+    for (const [key, value] of Object.entries(attrs)) {
+        if (value === false || value === undefined)
+            continue;
+        if (value === true)
+            parts.push(key);
+        else
+            parts.push(`${key}="${escapeAttr(value)}"`);
+    }
+    return parts.length ? ' ' + parts.join(' ') : '';
+}
+/** 防止内联内容里的 `</script>` 提前闭合标签。 */
+function escapeChildren(tag, content) {
+    if (tag.toLowerCase() === 'script') {
+        return content.replace(/<\/(script)/gi, '<\\/$1');
+    }
+    return content;
+}
+function serializeTag(tag) {
+    const attrs = serializeAttrs(tag.attrs);
+    if (VOID_TAGS.has(tag.tag.toLowerCase())) {
+        return `<${tag.tag}${attrs}>`;
+    }
+    const children = tag.children ? escapeChildren(tag.tag, tag.children) : '';
+    return `<${tag.tag}${attrs}>${children}</${tag.tag}>`;
+}
+/** 该 tag 是否已存在于 html，用于幂等去重。 */
+function isAlreadyPresent(html, tag) {
+    const src = tag.attrs?.src;
+    if (typeof src === 'string' && src) {
+        // 锚定到属性边界，避免 "/app" 误判命中 "/app.js"（与下面 id 分支一致）
+        return new RegExp(`src=["']${src.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}["']`).test(html);
+    }
+    const id = tag.attrs?.id;
+    if (typeof id === 'string' && id) {
+        return new RegExp(`id=["']${id.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}["']`).test(html);
+    }
+    return false;
+}
+/** 每个位置的锚点 fallback 链——畸形 HTML（缺 head/body）也能稳定落点。 */
+const ANCHORS = {
+    'head-prepend': [
+        { re: /<head[^>]*>/i, where: 'after' },
+        { re: /<html[^>]*>/i, where: 'after' },
+    ],
+    head: [
+        { re: /<\/head>/i, where: 'before' },
+        { re: /<body[^>]*>/i, where: 'before' },
+        { re: /<\/html>/i, where: 'before' },
+    ],
+    'body-prepend': [
+        { re: /<body[^>]*>/i, where: 'after' },
+        { re: /<\/head>/i, where: 'after' },
+        { re: /<html[^>]*>/i, where: 'after' },
+    ],
+    body: [
+        { re: /<\/body>/i, where: 'before' },
+        { re: /<\/html>/i, where: 'before' },
+    ],
+};
+function insertAt(html, position, tags) {
+    if (!tags.length)
+        return html;
+    const block = '\n' + tags.map((t) => '  ' + serializeTag(t)).join('\n');
+    for (const anchor of ANCHORS[position]) {
+        const m = anchor.re.exec(html);
+        if (!m)
+            continue;
+        const idx = anchor.where === 'after' ? m.index + m[0].length : m.index;
+        return html.slice(0, idx) + block + html.slice(idx);
+    }
+    // 兜底：prepend 位置贴文档头，append 位置贴文档尾
+    return position.endsWith('prepend') ? block + '\n' + html : html + block;
+}
+/**
+ * 把一组 tag 注入 html。
+ * - 已存在的（同 src / 同 id）跳过，保证幂等
+ * - 按 injectTo 分组、组内保序，确定性输出
+ */
+function injectTags(html, tags) {
+    if (!tags.length)
+        return html;
+    const groups = {
+        'head-prepend': [],
+        head: [],
+        'body-prepend': [],
+        body: [],
+    };
+    for (const tag of tags) {
+        if (isAlreadyPresent(html, tag))
+            continue;
+        groups[tag.injectTo ?? 'head'].push(tag);
+    }
+    let out = html;
+    out = insertAt(out, 'head-prepend', groups['head-prepend']);
+    out = insertAt(out, 'head', groups['head']);
+    out = insertAt(out, 'body-prepend', groups['body-prepend']);
+    out = insertAt(out, 'body', groups['body']);
+    return out;
+}
+//# sourceMappingURL=html-tags.js.map

package/lib/html-tags.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,24 @@
+export { startDevServer } from './dev';
+export { createHtmlViteConfig } from './vite-config';
+export type { HtmlViteOptions } from './vite-config';
+export { buildStatic } from './build';
+export type { BuildOptions, BuildResult } from './build';
+export { minifyHtmlWithHbsProtection } from './minify';
+export { injectPlatformTags, PLATFORM_TAGS } from './transform';
+export type { InjectPlatformOptions } from './transform';
+export { viewContextTag, buildRenderContext } from './transform/view-context';
+export type { ViewContextOptions, RequestRenderContext } from './transform/view-context';
+export { slardarTags } from './transform/slardar';
+export type { SlardarOptions } from './transform/slardar';
+export { previewBridgeTags, MIAODA_PREVIEW_BRIDGE_URL } from './transform/preview-bridge';
+export { injectOgMeta } from './transform/og-meta';
+export type { OgMetaOptions } from './transform/og-meta';
+export { injectTags, serializeTag } from './html-tags';
+export type { HtmlTagDescriptor, InjectPosition } from './html-tags';
+export { healthPlugin, HEALTH_ENDPOINT } from './plugins/health';
+export { platformInjectPlugin } from './plugins/inject';
+export type { PlatformInjectPluginOptions } from './plugins/inject';
+export { viteClientPatchPlugin } from './plugins/vite-client-patch';
+export { wsWatchdogPlugin } from './plugins/ws-watchdog';
+export type { WsWatchdogPluginOptions } from './plugins/ws-watchdog';
+//# 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":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAEvD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9E,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAErE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC"}

package/lib/index.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wsWatchdogPlugin = exports.viteClientPatchPlugin = exports.platformInjectPlugin = exports.HEALTH_ENDPOINT = exports.healthPlugin = exports.serializeTag = exports.injectTags = exports.injectOgMeta = exports.MIAODA_PREVIEW_BRIDGE_URL = exports.previewBridgeTags = exports.slardarTags = exports.buildRenderContext = exports.viewContextTag = exports.PLATFORM_TAGS = exports.injectPlatformTags = exports.minifyHtmlWithHbsProtection = exports.buildStatic = exports.createHtmlViteConfig = exports.startDevServer = void 0;
+var dev_1 = require("./dev");
+Object.defineProperty(exports, "startDevServer", { enumerable: true, get: function () { return dev_1.startDevServer; } });
+var vite_config_1 = require("./vite-config");
+Object.defineProperty(exports, "createHtmlViteConfig", { enumerable: true, get: function () { return vite_config_1.createHtmlViteConfig; } });
+var build_1 = require("./build");
+Object.defineProperty(exports, "buildStatic", { enumerable: true, get: function () { return build_1.buildStatic; } });
+var minify_1 = require("./minify");
+Object.defineProperty(exports, "minifyHtmlWithHbsProtection", { enumerable: true, get: function () { return minify_1.minifyHtmlWithHbsProtection; } });
+var transform_1 = require("./transform");
+Object.defineProperty(exports, "injectPlatformTags", { enumerable: true, get: function () { return transform_1.injectPlatformTags; } });
+Object.defineProperty(exports, "PLATFORM_TAGS", { enumerable: true, get: function () { return transform_1.PLATFORM_TAGS; } });
+var view_context_1 = require("./transform/view-context");
+Object.defineProperty(exports, "viewContextTag", { enumerable: true, get: function () { return view_context_1.viewContextTag; } });
+Object.defineProperty(exports, "buildRenderContext", { enumerable: true, get: function () { return view_context_1.buildRenderContext; } });
+var slardar_1 = require("./transform/slardar");
+Object.defineProperty(exports, "slardarTags", { enumerable: true, get: function () { return slardar_1.slardarTags; } });
+var preview_bridge_1 = require("./transform/preview-bridge");
+Object.defineProperty(exports, "previewBridgeTags", { enumerable: true, get: function () { return preview_bridge_1.previewBridgeTags; } });
+Object.defineProperty(exports, "MIAODA_PREVIEW_BRIDGE_URL", { enumerable: true, get: function () { return preview_bridge_1.MIAODA_PREVIEW_BRIDGE_URL; } });
+var og_meta_1 = require("./transform/og-meta");
+Object.defineProperty(exports, "injectOgMeta", { enumerable: true, get: function () { return og_meta_1.injectOgMeta; } });
+var html_tags_1 = require("./html-tags");
+Object.defineProperty(exports, "injectTags", { enumerable: true, get: function () { return html_tags_1.injectTags; } });
+Object.defineProperty(exports, "serializeTag", { enumerable: true, get: function () { return html_tags_1.serializeTag; } });
+var health_1 = require("./plugins/health");
+Object.defineProperty(exports, "healthPlugin", { enumerable: true, get: function () { return health_1.healthPlugin; } });
+Object.defineProperty(exports, "HEALTH_ENDPOINT", { enumerable: true, get: function () { return health_1.HEALTH_ENDPOINT; } });
+var inject_1 = require("./plugins/inject");
+Object.defineProperty(exports, "platformInjectPlugin", { enumerable: true, get: function () { return inject_1.platformInjectPlugin; } });
+var vite_client_patch_1 = require("./plugins/vite-client-patch");
+Object.defineProperty(exports, "viteClientPatchPlugin", { enumerable: true, get: function () { return vite_client_patch_1.viteClientPatchPlugin; } });
+var ws_watchdog_1 = require("./plugins/ws-watchdog");
+Object.defineProperty(exports, "wsWatchdogPlugin", { enumerable: true, get: function () { return ws_watchdog_1.wsWatchdogPlugin; } });
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6BAAuC;AAA9B,qGAAA,cAAc,OAAA;AACvB,6CAAqD;AAA5C,mHAAA,oBAAoB,OAAA;AAG7B,iCAAsC;AAA7B,oGAAA,WAAW,OAAA;AAEpB,mCAAuD;AAA9C,qHAAA,2BAA2B,OAAA;AAEpC,yCAAgE;AAAvD,+GAAA,kBAAkB,OAAA;AAAE,0GAAA,aAAa,OAAA;AAE1C,yDAA8E;AAArE,8GAAA,cAAc,OAAA;AAAE,kHAAA,kBAAkB,OAAA;AAE3C,+CAAkD;AAAzC,sGAAA,WAAW,OAAA;AAEpB,6DAA0F;AAAjF,mHAAA,iBAAiB,OAAA;AAAE,2HAAA,yBAAyB,OAAA;AACrD,+CAAmD;AAA1C,uGAAA,YAAY,OAAA;AAErB,yCAAuD;AAA9C,uGAAA,UAAU,OAAA;AAAE,yGAAA,YAAY,OAAA;AAGjC,2CAAiE;AAAxD,sGAAA,YAAY,OAAA;AAAE,yGAAA,eAAe,OAAA;AACtC,2CAAwD;AAA/C,8GAAA,oBAAoB,OAAA;AAE7B,iEAAoE;AAA3D,0HAAA,qBAAqB,OAAA;AAC9B,qDAAyD;AAAhD,+GAAA,gBAAgB,OAAA"}

package/lib/minify.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 压缩 HTML，同时保护 HBS（Handlebars）占位符。
+ *
+ * `{{csrfToken}}` / `{{{appAvatar}}}` 这类占位符是部署运行时（vefaas）替换的，直接交给
+ * html-minifier-terser 会被解析破坏（minifyCSS 会把 `width:{{w}}px` 压成 `width:{}`，
+ * minifyJS 也会在 `var n={{x}}` 处抛错）。先把它们抽出来用 `__HBS_<i>__` 占位，压缩完再放回。
+ *
+ * 行为对齐 `@lark-apaas/coding-preset-vite-react` 的 minifyHtmlWithHbsProtection。
+ */
+export declare function minifyHtmlWithHbsProtection(html: string): Promise<string>;
+//# sourceMappingURL=minify.d.ts.map

package/lib/minify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minify.d.ts","sourceRoot":"","sources":["../src/minify.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAsB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmB/E"}

package/lib/minify.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.minifyHtmlWithHbsProtection = minifyHtmlWithHbsProtection;
+const html_minifier_terser_1 = require("html-minifier-terser");
+/**
+ * 压缩 HTML，同时保护 HBS（Handlebars）占位符。
+ *
+ * `{{csrfToken}}` / `{{{appAvatar}}}` 这类占位符是部署运行时（vefaas）替换的，直接交给
+ * html-minifier-terser 会被解析破坏（minifyCSS 会把 `width:{{w}}px` 压成 `width:{}`，
+ * minifyJS 也会在 `var n={{x}}` 处抛错）。先把它们抽出来用 `__HBS_<i>__` 占位，压缩完再放回。
+ *
+ * 行为对齐 `@lark-apaas/coding-preset-vite-react` 的 minifyHtmlWithHbsProtection。
+ */
+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)]);
+}
+//# sourceMappingURL=minify.js.map

package/lib/minify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"minify.js","sourceRoot":"","sources":["../src/minify.ts"],"names":[],"mappings":";;AAWA,kEAmBC;AA9BD,+DAA8C;AAE9C;;;;;;;;GAQG;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"}

package/lib/plugins/health.d.ts

@@ -0,0 +1,10 @@
+import type { Plugin } from 'vite';
+/**
+ * 妙搭沙箱外壳探活接口。协议对齐 `@lark-apaas/coding-preset-vite-react`：
+ *   - connection refused / timeout → dev server 没起来 → 外壳重启沙箱
+ *   - 200 + { ready: true }         → 应用已就绪
+ *   - 200 + { ready: false }        → 还在启动
+ */
+export declare const HEALTH_ENDPOINT = "/dev/health";
+export declare function healthPlugin(): Plugin;
+//# 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;;;;;GAKG;AACH,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C,wBAAgB,YAAY,IAAI,MAAM,CAuBrC"}