@heybox/hb-sdk 0.9.4-alpha.1 → 0.9.4-alpha.2

package/dist/devtools/browser-dev-host/index.html

@@ -5,8 +5,8 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="theme-color" content="#f4f5f7" />
     <title>小程序工坊调试台</title>
-    <script type="module" crossorigin src="/assets/index-DW4VxPMl.js"></script>
-    <link rel="modulepreload" crossorigin href="/assets/desktop-app-launch-6LCHEMSe.js">
+    <script type="module" crossorigin src="/assets/index-CnC7wDP_.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/desktop-app-launch-BBIYbjgT.js">
     <link rel="stylesheet" crossorigin href="/assets/index-h-fYisyX.css">
   </head>
   <body>

package/dist/index.cjs.js

@@ -7485,7 +7485,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.4-alpha.1';
+    : '0.9.4-alpha.2';
 
 const RUNTIME_MODES = new Set(['production', 'preview', 'development', 'unknown']);
 const OPERATING_SYSTEM_NAMES = new Set(['android', 'ios', 'ohos', 'windows', 'macos', 'linux', 'unknown']);

package/dist/index.esm.js

@@ -7481,7 +7481,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.4-alpha.1';
+    : '0.9.4-alpha.2';
 
 const RUNTIME_MODES = new Set(['production', 'preview', 'development', 'unknown']);
 const OPERATING_SYSTEM_NAMES = new Set(['android', 'ios', 'ohos', 'windows', 'macos', 'linux', 'unknown']);

package/dist/vite.cjs.js

@@ -10315,7 +10315,7 @@ async function ensureBasicInfoDirectory(rootPath, relative) {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.4-alpha.1';
+    : '0.9.4-alpha.2';
 
 /**
  * iframe 与调试台页面的开发期 console 捕获转发。
@@ -20502,6 +20502,46 @@ function shouldSkipMiniappPlatformCspFromEnv(env = process.env) {
     return env[HB_SDK_RUNTIME_PERMISSION_CONTEXT_ENV] === VERIFIED_RUNTIME_PERMISSION_CONTEXT && env[HB_SDK_RUNTIME_USE_OFFICIAL_DOMAIN_ENV] === '1';
 }
 
+/** 与平台 H5 保持相同的语法兼容下限；SDK 独立分发，不依赖内部 Platform 包。 */
+const MINIAPP_BROWSER_TARGETS = ['chrome64', 'safari12'];
+/** Vite 的聚合目标别名不能直接交给 esbuild 的目标数组。 */
+const VITE_TARGET_ALIASES = new Set(['modules', 'baseline-widely-available']);
+function resolveMiniappBuildTargets(target) {
+    const configured = typeof target === 'string' ? [target] : target || [];
+    const byEngine = new Map();
+    const other = new Set();
+    for (const value of [...MINIAPP_BROWSER_TARGETS, ...configured]) {
+        if (VITE_TARGET_ALIASES.has(value) || value === 'esnext')
+            continue;
+        const matched = /^([a-z]+)(\d+(?:\.\d+)*)$/.exec(value);
+        if (!matched) {
+            other.add(value);
+            continue;
+        }
+        const [, engine, version] = matched;
+        const current = byEngine.get(engine);
+        // esbuild 的同一内核重复目标会互相覆盖，必须先选最旧版本，不能只拼接数组。
+        if (!current || compareVersions(version, current.version) < 0)
+            byEngine.set(engine, { target: value, version });
+    }
+    return [...byEngine.values()].map((value) => value.target).concat([...other]);
+}
+function compareVersions(left, right) {
+    const a = left.split('.').map(Number);
+    const b = right.split('.').map(Number);
+    for (let index = 0; index < Math.max(a.length, b.length); index++) {
+        const difference = (a[index] ?? 0) - (b[index] ?? 0);
+        if (difference)
+            return difference;
+    }
+    return 0;
+}
+function assertMiniappBuildCompiler(esbuild) {
+    if (esbuild === false) {
+        throw new Error('工坊小程序生产构建不能设置 esbuild: false；必须保留 Chrome 64 / Safari 12 的语法降级，以免旧 WebView 在 SDK 握手前解析失败。');
+    }
+}
+
 /**
  * dev serve 时在入口 HTML 最早位置注入无依赖 console 捕获 bootstrap。
  *
@@ -20616,10 +20656,13 @@ const devSnapshotStores = devSnapshotRegistry[devSnapshotStoreKey];
  *
  * Hook 行为如下：
  *
- * - `config`：省略 `base` 时补为 `'./'`，显式值只接受 `''` / `'./'`；注入 SDK 构建版本，且仅
- *   `vite serve` 注入开发日志编译常量；
+ * - `config`：省略 `base` 时补为 `'./'`，显式值只接受 `''` / `'./'`；生产构建按 Chrome 64 / Safari 12
+ *   转换 Vite 编译脚本的 JavaScript 语法，保留更旧的自定义目标，拒绝 `esbuild: false`；注入 SDK 构建版本，且仅
+ *   `vite serve` 注入开发日志编译常量。语法转换不处理原样复制或远端加载的脚本，不包含运行时 API polyfill，
+ *   也不会更新已发布旧产物；
  * - `configResolved`：确认插件唯一性，记录真实 `root`、`build.outDir`、`serve|build` 命令和精确 HMR
- *   WebSocket 地址；直接 `vite build` 使用该实际 `outDir`，`hb-sdk build` 则由 CLI 固定为 `dist/`；
+ *   WebSocket 地址，并再次确认生产环境的语法兼容目标；直接 `vite build` 使用该实际 `outDir`，
+ *   `hb-sdk build` 则由 CLI 固定为 `dist/`；
  * - `configureServer`：为 `hb-sdk dev` 注册设备日志、本地小程序 Manifest 与 Companion Manifest/ZIP
  *   中间件；敏感路由只接受数值 loopback socket/Host、`GET|HEAD` 和 CLI 注入的独立短期令牌，快照在
  *   配置重载时按 digest 保留，并在服务真正关闭时清理；
@@ -20700,8 +20743,20 @@ function miniappManifest() {
             // command 在本钩子时序早于 configResolved，必须取自 env 命令而非闭包；
             // 旧调用方（测试等）未传 env 时按 build 处理。
             const isServe = env?.command === 'serve';
+            if (!isServe)
+                assertMiniappBuildCompiler(config.esbuild);
+            const buildTargets = !isServe ? resolveMiniappBuildTargets(config.build?.target) : undefined;
+            if (buildTargets) {
+                // 先替换原配置中的目标，避免 Vite 的数组合并重新带入别名或重复内核目标。
+                config.build = { ...config.build, target: buildTargets };
+                for (const environment of Object.values(config.environments ?? {})) {
+                    if (environment.build)
+                        environment.build.target = resolveMiniappBuildTargets(environment.build.target);
+                }
+            }
             return {
                 ...(config.base === undefined ? { base: './' } : {}),
+                ...(buildTargets ? { build: { target: buildTargets } } : {}),
                 define: {
                     [sdkVersionBuildConstant]: JSON.stringify(resolveSdkVersion()),
                     // 仅 vite serve（hb-sdk dev）注入；vite build / hb-sdk build 永不注入，捕获模块被死代码消除。
@@ -20719,6 +20774,14 @@ function miniappManifest() {
             root = resolved.root;
             outDir = resolved.build.outDir;
             command = resolved.command;
+            if (command === 'build') {
+                assertMiniappBuildCompiler(resolved.esbuild);
+                resolved.build.target = resolveMiniappBuildTargets(resolved.build.target);
+                for (const environment of Object.values(resolved.environments ?? {})) {
+                    if (environment.build)
+                        environment.build.target = resolveMiniappBuildTargets(environment.build.target);
+                }
+            }
             hmrWebSocketUrl = resolveHmrWebSocketUrl(resolved);
             configuredDeviceLogUploadUrls = resolveConfiguredDeviceLogUploadUrls(resolved);
         },
@@ -20746,7 +20809,9 @@ function miniappManifest() {
                         bindAppIds: readMiniappBindAppIdsFromPackageJson(root),
                     });
                 }
-                catch { /* 读取失败不推断为缺失。 */ }
+                catch {
+                    /* 读取失败不推断为缺失。 */
+                }
                 for (const warning of warnings)
                     server.config.logger.warn(`[${warning.code}] ${warning.message}`);
                 metadataWarningsShown = true;
@@ -20874,7 +20939,9 @@ function miniappManifest() {
                 if (requestedDigest)
                     return Promise.resolve(snapshots.get(requestedDigest));
                 // manifest 与制品可能同时请求；本轮构建只准备一次，失败后允许下次请求重试。
-                pendingSnapshot ??= buildSnapshot().finally(() => { pendingSnapshot = undefined; });
+                pendingSnapshot ??= buildSnapshot().finally(() => {
+                    pendingSnapshot = undefined;
+                });
                 return pendingSnapshot;
             };
             server.middlewares.use(async (request, response, next) => {
@@ -21038,10 +21105,7 @@ function miniappManifest() {
             const enforced = enforceMiniappHtmlPolicy(html, {
                 ...(command === 'serve'
                     ? {
-                        deviceLogUploadUrls: Array.from(new Set([
-                            ...configuredDeviceLogUploadUrls,
-                            ...resolveViteDeviceLogUploadUrls(devServer?.resolvedUrls),
-                        ])),
+                        deviceLogUploadUrls: Array.from(new Set([...configuredDeviceLogUploadUrls, ...resolveViteDeviceLogUploadUrls(devServer?.resolvedUrls)])),
                         hmrWebSocketUrl,
                     }
                     : {}),
@@ -21321,12 +21385,13 @@ function resolveConfiguredDeviceLogUploadUrls(resolved) {
     else {
         hosts.add('127.0.0.1');
     }
-    return Array.from(hosts, host => createDeviceLogUploadUrl(protocol, host, resolved.server.port)).filter((url) => Boolean(url));
+    return Array.from(hosts, (host) => createDeviceLogUploadUrl(protocol, host, resolved.server.port)).filter((url) => Boolean(url));
 }
 function resolveViteDeviceLogUploadUrls(resolvedUrls) {
     if (!resolvedUrls)
         return [];
-    return Array.from(new Set([...resolvedUrls.local, ...resolvedUrls.network].map(url => {
+    return Array.from(new Set([...resolvedUrls.local, ...resolvedUrls.network]
+        .map((url) => {
         try {
             const endpoint = new URL(DEVICE_LOG_PATH, url);
             if (endpoint.protocol !== 'http:' && endpoint.protocol !== 'https:')
@@ -21340,7 +21405,8 @@ function resolveViteDeviceLogUploadUrls(resolvedUrls) {
         catch {
             return undefined;
         }
-    }).filter((url) => Boolean(url))));
+    })
+        .filter((url) => Boolean(url))));
 }
 function createDeviceLogUploadUrl(protocol, host, port) {
     try {

package/dist/vite.esm.js

@@ -10312,7 +10312,7 @@ async function ensureBasicInfoDirectory(rootPath, relative) {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.4-alpha.1';
+    : '0.9.4-alpha.2';
 
 /**
  * iframe 与调试台页面的开发期 console 捕获转发。
@@ -20499,6 +20499,46 @@ function shouldSkipMiniappPlatformCspFromEnv(env = process.env) {
     return env[HB_SDK_RUNTIME_PERMISSION_CONTEXT_ENV] === VERIFIED_RUNTIME_PERMISSION_CONTEXT && env[HB_SDK_RUNTIME_USE_OFFICIAL_DOMAIN_ENV] === '1';
 }
 
+/** 与平台 H5 保持相同的语法兼容下限；SDK 独立分发，不依赖内部 Platform 包。 */
+const MINIAPP_BROWSER_TARGETS = ['chrome64', 'safari12'];
+/** Vite 的聚合目标别名不能直接交给 esbuild 的目标数组。 */
+const VITE_TARGET_ALIASES = new Set(['modules', 'baseline-widely-available']);
+function resolveMiniappBuildTargets(target) {
+    const configured = typeof target === 'string' ? [target] : target || [];
+    const byEngine = new Map();
+    const other = new Set();
+    for (const value of [...MINIAPP_BROWSER_TARGETS, ...configured]) {
+        if (VITE_TARGET_ALIASES.has(value) || value === 'esnext')
+            continue;
+        const matched = /^([a-z]+)(\d+(?:\.\d+)*)$/.exec(value);
+        if (!matched) {
+            other.add(value);
+            continue;
+        }
+        const [, engine, version] = matched;
+        const current = byEngine.get(engine);
+        // esbuild 的同一内核重复目标会互相覆盖，必须先选最旧版本，不能只拼接数组。
+        if (!current || compareVersions(version, current.version) < 0)
+            byEngine.set(engine, { target: value, version });
+    }
+    return [...byEngine.values()].map((value) => value.target).concat([...other]);
+}
+function compareVersions(left, right) {
+    const a = left.split('.').map(Number);
+    const b = right.split('.').map(Number);
+    for (let index = 0; index < Math.max(a.length, b.length); index++) {
+        const difference = (a[index] ?? 0) - (b[index] ?? 0);
+        if (difference)
+            return difference;
+    }
+    return 0;
+}
+function assertMiniappBuildCompiler(esbuild) {
+    if (esbuild === false) {
+        throw new Error('工坊小程序生产构建不能设置 esbuild: false；必须保留 Chrome 64 / Safari 12 的语法降级，以免旧 WebView 在 SDK 握手前解析失败。');
+    }
+}
+
 /**
  * dev serve 时在入口 HTML 最早位置注入无依赖 console 捕获 bootstrap。
  *
@@ -20613,10 +20653,13 @@ const devSnapshotStores = devSnapshotRegistry[devSnapshotStoreKey];
  *
  * Hook 行为如下：
  *
- * - `config`：省略 `base` 时补为 `'./'`，显式值只接受 `''` / `'./'`；注入 SDK 构建版本，且仅
- *   `vite serve` 注入开发日志编译常量；
+ * - `config`：省略 `base` 时补为 `'./'`，显式值只接受 `''` / `'./'`；生产构建按 Chrome 64 / Safari 12
+ *   转换 Vite 编译脚本的 JavaScript 语法，保留更旧的自定义目标，拒绝 `esbuild: false`；注入 SDK 构建版本，且仅
+ *   `vite serve` 注入开发日志编译常量。语法转换不处理原样复制或远端加载的脚本，不包含运行时 API polyfill，
+ *   也不会更新已发布旧产物；
  * - `configResolved`：确认插件唯一性，记录真实 `root`、`build.outDir`、`serve|build` 命令和精确 HMR
- *   WebSocket 地址；直接 `vite build` 使用该实际 `outDir`，`hb-sdk build` 则由 CLI 固定为 `dist/`；
+ *   WebSocket 地址，并再次确认生产环境的语法兼容目标；直接 `vite build` 使用该实际 `outDir`，
+ *   `hb-sdk build` 则由 CLI 固定为 `dist/`；
  * - `configureServer`：为 `hb-sdk dev` 注册设备日志、本地小程序 Manifest 与 Companion Manifest/ZIP
  *   中间件；敏感路由只接受数值 loopback socket/Host、`GET|HEAD` 和 CLI 注入的独立短期令牌，快照在
  *   配置重载时按 digest 保留，并在服务真正关闭时清理；
@@ -20697,8 +20740,20 @@ function miniappManifest() {
             // command 在本钩子时序早于 configResolved，必须取自 env 命令而非闭包；
             // 旧调用方（测试等）未传 env 时按 build 处理。
             const isServe = env?.command === 'serve';
+            if (!isServe)
+                assertMiniappBuildCompiler(config.esbuild);
+            const buildTargets = !isServe ? resolveMiniappBuildTargets(config.build?.target) : undefined;
+            if (buildTargets) {
+                // 先替换原配置中的目标，避免 Vite 的数组合并重新带入别名或重复内核目标。
+                config.build = { ...config.build, target: buildTargets };
+                for (const environment of Object.values(config.environments ?? {})) {
+                    if (environment.build)
+                        environment.build.target = resolveMiniappBuildTargets(environment.build.target);
+                }
+            }
             return {
                 ...(config.base === undefined ? { base: './' } : {}),
+                ...(buildTargets ? { build: { target: buildTargets } } : {}),
                 define: {
                     [sdkVersionBuildConstant]: JSON.stringify(resolveSdkVersion()),
                     // 仅 vite serve（hb-sdk dev）注入；vite build / hb-sdk build 永不注入，捕获模块被死代码消除。
@@ -20716,6 +20771,14 @@ function miniappManifest() {
             root = resolved.root;
             outDir = resolved.build.outDir;
             command = resolved.command;
+            if (command === 'build') {
+                assertMiniappBuildCompiler(resolved.esbuild);
+                resolved.build.target = resolveMiniappBuildTargets(resolved.build.target);
+                for (const environment of Object.values(resolved.environments ?? {})) {
+                    if (environment.build)
+                        environment.build.target = resolveMiniappBuildTargets(environment.build.target);
+                }
+            }
             hmrWebSocketUrl = resolveHmrWebSocketUrl(resolved);
             configuredDeviceLogUploadUrls = resolveConfiguredDeviceLogUploadUrls(resolved);
         },
@@ -20743,7 +20806,9 @@ function miniappManifest() {
                         bindAppIds: readMiniappBindAppIdsFromPackageJson(root),
                     });
                 }
-                catch { /* 读取失败不推断为缺失。 */ }
+                catch {
+                    /* 读取失败不推断为缺失。 */
+                }
                 for (const warning of warnings)
                     server.config.logger.warn(`[${warning.code}] ${warning.message}`);
                 metadataWarningsShown = true;
@@ -20871,7 +20936,9 @@ function miniappManifest() {
                 if (requestedDigest)
                     return Promise.resolve(snapshots.get(requestedDigest));
                 // manifest 与制品可能同时请求；本轮构建只准备一次，失败后允许下次请求重试。
-                pendingSnapshot ??= buildSnapshot().finally(() => { pendingSnapshot = undefined; });
+                pendingSnapshot ??= buildSnapshot().finally(() => {
+                    pendingSnapshot = undefined;
+                });
                 return pendingSnapshot;
             };
             server.middlewares.use(async (request, response, next) => {
@@ -21035,10 +21102,7 @@ function miniappManifest() {
             const enforced = enforceMiniappHtmlPolicy(html, {
                 ...(command === 'serve'
                     ? {
-                        deviceLogUploadUrls: Array.from(new Set([
-                            ...configuredDeviceLogUploadUrls,
-                            ...resolveViteDeviceLogUploadUrls(devServer?.resolvedUrls),
-                        ])),
+                        deviceLogUploadUrls: Array.from(new Set([...configuredDeviceLogUploadUrls, ...resolveViteDeviceLogUploadUrls(devServer?.resolvedUrls)])),
                         hmrWebSocketUrl,
                     }
                     : {}),
@@ -21318,12 +21382,13 @@ function resolveConfiguredDeviceLogUploadUrls(resolved) {
     else {
         hosts.add('127.0.0.1');
     }
-    return Array.from(hosts, host => createDeviceLogUploadUrl(protocol, host, resolved.server.port)).filter((url) => Boolean(url));
+    return Array.from(hosts, (host) => createDeviceLogUploadUrl(protocol, host, resolved.server.port)).filter((url) => Boolean(url));
 }
 function resolveViteDeviceLogUploadUrls(resolvedUrls) {
     if (!resolvedUrls)
         return [];
-    return Array.from(new Set([...resolvedUrls.local, ...resolvedUrls.network].map(url => {
+    return Array.from(new Set([...resolvedUrls.local, ...resolvedUrls.network]
+        .map((url) => {
         try {
             const endpoint = new URL(DEVICE_LOG_PATH, url);
             if (endpoint.protocol !== 'http:' && endpoint.protocol !== 'https:')
@@ -21337,7 +21402,8 @@ function resolveViteDeviceLogUploadUrls(resolvedUrls) {
         catch {
             return undefined;
         }
-    }).filter((url) => Boolean(url))));
+    })
+        .filter((url) => Boolean(url))));
 }
 function createDeviceLogUploadUrl(protocol, host, port) {
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk",
-  "version": "0.9.4-alpha.1",
+  "version": "0.9.4-alpha.2",
   "sideEffects": [
     "./src/index.ts",
     "./src/core/singleton.ts",
@@ -76,7 +76,7 @@
     "undici": "^7.28.0",
     "ws": "^8.18.0",
     "sharp": "^0.34.5",
-    "@heybox/hb-sdk-protocol": "0.9.4-alpha.1"
+    "@heybox/hb-sdk-protocol": "0.9.4-alpha.2"
   },
   "peerDependencies": {
     "vite": ">=5"
@@ -128,13 +128,13 @@
     "vitest": "^3.2.4",
     "@ai-desktop/view-contract": "file:../hb-sdk-protocol/vendor/view-contract-2.2.2-6ac49bbf6410.tgz",
     "rollup-plugin-dts": "6.4.0",
+    "@heybox-domain/heybox-theme": "~0.1.0",
+    "@heybox/hb-sdk-runtime": "~0.9.4-alpha.2",
     "@heybox-domain/heybox-vue3-ui": "~0.1.0",
     "@heybox/hb-api": "~1.28.17",
-    "@heybox-domain/heybox-theme": "~0.1.0",
-    "@heybox/hb-sdk-runtime": "~0.9.4-alpha.1",
     "@heybox/runtime": "~0.2.1",
-    "@heybox/runtime-policy": "~0.2.1",
-    "@heybox/runtime-transport-fetch": "~0.2.1"
+    "@heybox/runtime-transport-fetch": "~0.2.1",
+    "@heybox/runtime-policy": "~0.2.1"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",

package/skill/skill.json

@@ -1,15 +1,15 @@
 {
   "name": "hb-sdk",
-  "skillVersion": "0.9.4-alpha.1+skill.d0d502673711",
+  "skillVersion": "0.9.4-alpha.2+skill.d0d502673711",
   "sdk": {
     "package": "@heybox/hb-sdk",
-    "version": "0.9.4-alpha.1",
-    "compatibility": "0.9.4-alpha.1"
+    "version": "0.9.4-alpha.2",
+    "compatibility": "0.9.4-alpha.2"
   },
   "distribution": {
     "type": "npm",
     "package": "@heybox/hb-sdk",
-    "version": "0.9.4-alpha.1",
+    "version": "0.9.4-alpha.2",
     "path": "skill"
   },
   "integrity": "sha256-d0d502673711f5d077ee62e657749125788e396d5203894b7077dfe866fd2990"

package/types/vite/index.d.ts

@@ -1,4 +1,5 @@
 import { Server, IncomingMessage, ServerResponse } from 'node:http';
+import { Http2SecureServer } from 'node:http2';
 
 /**
  * `package.json#heybox.platforms` 接受的平台值，顺序同时是 Manifest 的规范化输出顺序。
@@ -20,7 +21,7 @@ type MiniappPlatform = (typeof MINIAPP_PLATFORM_VALUES)[number];
 interface MiniappManifestPlugin {
     /** 固定为 `heybox-miniapp-manifest`，同一份 Vite 配置必须且只能注册一个实例。 */
     name: string;
-    /** 校验资源基准路径，并向 Vite 注入 SDK 版本和开发期日志开关。 */
+    /** 校验资源基准路径、保留生产语法兼容下限，并注入 SDK 版本和开发期日志开关。 */
     config: (config: MiniappManifestUserConfig, env?: {
         command: 'build' | 'serve';
     }) => MiniappManifestUserConfig | void;
@@ -49,7 +50,7 @@ interface MiniappManifestDevServer {
         };
     };
     /** Vite 底层 HTTP 服务；middleware mode 或尚未监听时可能为空。 */
-    httpServer?: Server | null;
+    httpServer?: Server | Http2SecureServer | null;
     /** Vite 配置重载入口；插件会在重载期间保留当前本地调试快照。 */
     restart?: (forceOptimize?: boolean) => Promise<void>;
     /** 用于挂载 `hb-sdk dev` 本机调试中间件的 Connect middleware 容器。 */
@@ -69,6 +70,18 @@ interface MiniappManifestUserConfig {
      * Vite 资源基准路径。省略时插件返回 `./`；显式配置只接受空字符串或 `./`，以便版本目录内相对加载资源。
      */
     base?: string;
+    /** 生产构建始终叠加 Chrome 64 / Safari 12；更保守的项目目标继续生效。 */
+    build?: {
+        target?: string | string[] | false;
+    };
+    /** 生产构建不能关闭 esbuild；具体编译选项由 Vite 定义。 */
+    esbuild?: object | false;
+    /** Vite 6+ 的环境构建目标；生产环境同样保留平台语法兼容下限。 */
+    environments?: Record<string, {
+        build?: {
+            target?: string | string[] | false;
+        };
+    }>;
     /** 插件返回给 Vite 的编译期常量；业务项目无需通过该接口传入或覆盖。 */
     define?: Record<string, string>;
 }
@@ -92,17 +105,29 @@ interface MiniappManifestResolvedConfig {
     /** Vite 构建输出目录；Manifest 和 Companion 归档写入该目录。 */
     build: {
         outDir: string;
+        /** 生产构建在最终配置中再次保留平台语法兼容下限。 */
+        target?: string | string[] | false;
     };
+    /** 用于识别其他 config hook 是否关闭了生产构建的语法降级。 */
+    esbuild?: object | false;
+    /** Vite 6+ 已解析的环境构建目标。 */
+    environments?: Record<string, {
+        build?: {
+            target?: string | string[] | false;
+        };
+    }>;
     /** 开发服务网络配置，用于收窄注入 HTML 的 HMR WebSocket CSP。 */
     server: {
         host?: string | boolean;
-        https?: boolean | Record<string, unknown>;
+        /** 只读取是否启用 HTTPS，不要求 Node ServerOptions 具备字符串索引。 */
+        https?: boolean | object;
         port?: number;
         hmr?: boolean | {
             clientPort?: number;
             host?: string;
             port?: number;
-            protocol?: 'ws' | 'wss';
+            /** 与 Vite 的 HMR 配置类型保持一致，具体 URL 仍由 HTML 策略校验。 */
+            protocol?: string;
         };
     };
     /** 已解析插件列表；存在时用于拒绝重复注册 `miniappManifest()`。 */
@@ -172,10 +197,13 @@ declare const HB_SDK_MINI_PROGRAM_MANIFEST_ACCESS_TOKEN_ENV = "HB_SDK_MINI_PROGR
  *
  * Hook 行为如下：
  *
- * - `config`：省略 `base` 时补为 `'./'`，显式值只接受 `''` / `'./'`；注入 SDK 构建版本，且仅
- *   `vite serve` 注入开发日志编译常量；
+ * - `config`：省略 `base` 时补为 `'./'`，显式值只接受 `''` / `'./'`；生产构建按 Chrome 64 / Safari 12
+ *   转换 Vite 编译脚本的 JavaScript 语法，保留更旧的自定义目标，拒绝 `esbuild: false`；注入 SDK 构建版本，且仅
+ *   `vite serve` 注入开发日志编译常量。语法转换不处理原样复制或远端加载的脚本，不包含运行时 API polyfill，
+ *   也不会更新已发布旧产物；
  * - `configResolved`：确认插件唯一性，记录真实 `root`、`build.outDir`、`serve|build` 命令和精确 HMR
- *   WebSocket 地址；直接 `vite build` 使用该实际 `outDir`，`hb-sdk build` 则由 CLI 固定为 `dist/`；
+ *   WebSocket 地址，并再次确认生产环境的语法兼容目标；直接 `vite build` 使用该实际 `outDir`，
+ *   `hb-sdk build` 则由 CLI 固定为 `dist/`；
  * - `configureServer`：为 `hb-sdk dev` 注册设备日志、本地小程序 Manifest 与 Companion Manifest/ZIP
  *   中间件；敏感路由只接受数值 loopback socket/Host、`GET|HEAD` 和 CLI 注入的独立短期令牌，快照在
  *   配置重载时按 digest 保留，并在服务真正关闭时清理；