@heybox/hb-sdk 0.9.3-alpha.5 → 0.9.3-alpha.6

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-_0y5rm2x.js"></script>
-    <link rel="modulepreload" crossorigin href="/assets/desktop-app-launch-lns4avol.js">
+    <script type="module" crossorigin src="/assets/index-Br7UpHGt.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/desktop-app-launch-CFl6m8k-.js">
     <link rel="stylesheet" crossorigin href="/assets/index-7Cq8iNcD.css">
   </head>
   <body>

package/dist/index.cjs.js

@@ -7299,7 +7299,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.3-alpha.5';
+    : '0.9.3-alpha.6';
 
 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

@@ -7295,7 +7295,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.3-alpha.5';
+    : '0.9.3-alpha.6';
 
 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

@@ -10304,7 +10304,7 @@ async function ensureBasicInfoDirectory(rootPath, relative) {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.3-alpha.5';
+    : '0.9.3-alpha.6';
 
 /**
  * iframe 与调试台页面的开发期 console 捕获转发。

package/dist/vite.esm.js

@@ -10301,7 +10301,7 @@ async function ensureBasicInfoDirectory(rootPath, relative) {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.3-alpha.5';
+    : '0.9.3-alpha.6';
 
 /**
  * iframe 与调试台页面的开发期 console 捕获转发。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk",
-  "version": "0.9.3-alpha.5",
+  "version": "0.9.3-alpha.6",
   "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.3-alpha.5"
+    "@heybox/hb-sdk-protocol": "0.9.3-alpha.6"
   },
   "peerDependencies": {
     "vite": ">=5"
@@ -128,12 +128,12 @@
     "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-api": "~1.28.17",
-    "@heybox/hb-sdk-runtime": "~0.9.3-alpha.5",
+    "@heybox/hb-sdk-runtime": "~0.9.3-alpha.6",
     "@heybox-domain/heybox-vue3-ui": "~0.1.0",
+    "@heybox-domain/heybox-theme": "~0.1.0",
     "@heybox/runtime": "~0.2.1",
     "@heybox/runtime-policy": "~0.2.1",
+    "@heybox/hb-api": "~1.28.17",
     "@heybox/runtime-transport-fetch": "~0.2.1"
   },
   "publishConfig": {

package/skill/SKILL.md

@@ -17,6 +17,12 @@ Before implementing screenshot flows or upgrading the SDK, use the canonical doc
 
 Before upgrading, verify both the page layout and the captured image. Do not only update the dependency or invocation without explaining screenshot behavior changes. Read exact version cutoffs, dimensions, parameters, and Host support from the canonical documentation fetched for this task; never substitute an older installed Skill snapshot.
 
+## 展示 API 迁移：升级前必查
+
+实现 `viewport.setDisplay` 调用流程或升级 SDK 前，先通过 canonical 文档索引读取该方法的 Reference 与迁移预告。主动向开发者说明已公布的返回值迁移安排，包括目标版本、是否已生效，以及需要准备的兼容和错误处理。
+
+核对项目已安装的 SDK 与公告中的版本门槛。当前和计划契约均以本次读取的 canonical 文档为准，不提前套用未来契约，不把不支持结果当作设置成功，也不依赖旧 Skill 快照。建议升级前验证支持和不支持两种 Host。
+
 ## Canonical Documentation
 
 The only maintained hb-sdk guidance source is:

package/skill/skill.json

@@ -1,16 +1,16 @@
 {
   "name": "hb-sdk",
-  "skillVersion": "0.9.3-alpha.5+skill.4d7b063940c3",
+  "skillVersion": "0.9.3-alpha.6+skill.d0d502673711",
   "sdk": {
     "package": "@heybox/hb-sdk",
-    "version": "0.9.3-alpha.5",
-    "compatibility": "0.9.3-alpha.5"
+    "version": "0.9.3-alpha.6",
+    "compatibility": "0.9.3-alpha.6"
   },
   "distribution": {
     "type": "npm",
     "package": "@heybox/hb-sdk",
-    "version": "0.9.3-alpha.5",
+    "version": "0.9.3-alpha.6",
     "path": "skill"
   },
-  "integrity": "sha256-4d7b063940c341502cf34c481b656be96ac27f1a252055b2b1af445c6392264c"
+  "integrity": "sha256-d0d502673711f5d077ee62e657749125788e396d5203894b7077dfe866fd2990"
 }

package/types/index.d.ts

@@ -3685,6 +3685,13 @@ interface MiniProgramViewportModule {
     /**
      * 设置当前小程序的窗口方向和全屏状态。
      *
+     * SDK `1.0.0` 计划将本方法调整为 `Promise<void>`：设置完成时正常返回，不支持时抛出明确错误；
+     * 切换失败、超时或取消仍抛出对应错误。当前仍返回 `{ supported: boolean }`，现有行为保持不变。
+     *
+     * 请提前补齐 `try/catch`，过渡期保留 `supported: false` 判断，并先检查返回值是否存在再读取该字段；
+     * 避免直接解构返回值或将未来的空返回值当作失败。仅在确认设置成功后继续依赖该设置的操作。
+     * 不支持时的错误码与适配期限会在 `1.0.0` 正式发布前公告，并提供预发布版本验证。
+     *
      * @param options - 方向与全屏目标，至少提供一个字段；省略的字段保持当前目标值。
      * @returns Host 完成原生方向与胶囊设置、布局稳定后返回 `{ supported: true }`；能力缺失或
      * 请求不受支持时返回 `{ supported: false }`，调用方仍应按实际窗口与安全区布局。