@heybox/hb-sdk 0.4.3 → 0.4.4

package/dist/protocol.cjs.js

@@ -89,6 +89,20 @@ const STORAGE_SET_STORAGE_METHOD = 'storage.setStorage';
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
 const NETWORK_REQUEST_METHOD = 'network.request';
+/** 展示 toast 能力方法名。 */
+const UI_SHOW_TOAST_METHOD = 'ui.showToast';
+/** 展示全局 loading 能力方法名。 */
+const UI_SHOW_LOADING_METHOD = 'ui.showLoading';
+/** 隐藏全局 loading 能力方法名。 */
+const UI_HIDE_LOADING_METHOD = 'ui.hideLoading';
+/** 震动反馈能力方法名。 */
+const DEVICE_VIBRATE_METHOD = 'device.vibrate';
+/** 写入文本剪贴板能力方法名。 */
+const DEVICE_SET_CLIPBOARD_METHOD = 'device.setClipboard';
+/** 关闭当前小程序容器能力方法名。 */
+const NAVIGATION_CLOSE_METHOD = 'navigation.close';
+/** 重载当前小程序容器能力方法名。 */
+const NAVIGATION_RELOAD_METHOD = 'navigation.reload';
 /**
  * 小程序开放能力目录。
  *
@@ -159,19 +173,75 @@ const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
         permission: 'network.request',
         risk: 'high',
     },
+    {
+        method: UI_SHOW_TOAST_METHOD,
+        module: 'ui',
+        capability: UI_SHOW_TOAST_METHOD,
+        permission: 'ui.toast',
+        risk: 'low',
+    },
+    {
+        method: UI_SHOW_LOADING_METHOD,
+        module: 'ui',
+        capability: UI_SHOW_LOADING_METHOD,
+        permission: 'ui.loading',
+        risk: 'low',
+    },
+    {
+        method: UI_HIDE_LOADING_METHOD,
+        module: 'ui',
+        capability: UI_HIDE_LOADING_METHOD,
+        permission: 'ui.loading',
+        risk: 'low',
+    },
+    {
+        method: DEVICE_VIBRATE_METHOD,
+        module: 'device',
+        capability: DEVICE_VIBRATE_METHOD,
+        permission: 'device.vibrate',
+        risk: 'low',
+    },
+    {
+        method: DEVICE_SET_CLIPBOARD_METHOD,
+        module: 'device',
+        capability: DEVICE_SET_CLIPBOARD_METHOD,
+        permission: 'device.clipboard.write',
+        risk: 'medium',
+    },
+    {
+        method: NAVIGATION_CLOSE_METHOD,
+        module: 'navigation',
+        capability: NAVIGATION_CLOSE_METHOD,
+        permission: 'navigation.close',
+        risk: 'medium',
+    },
+    {
+        method: NAVIGATION_RELOAD_METHOD,
+        module: 'navigation',
+        capability: NAVIGATION_RELOAD_METHOD,
+        permission: 'navigation.reload',
+        risk: 'medium',
+    },
 ];
 
 exports.AUTH_LOGIN_METHOD = AUTH_LOGIN_METHOD;
+exports.DEVICE_SET_CLIPBOARD_METHOD = DEVICE_SET_CLIPBOARD_METHOD;
+exports.DEVICE_VIBRATE_METHOD = DEVICE_VIBRATE_METHOD;
 exports.MINI_PROGRAM_BRIDGE_NONCE_PARAM = MINI_PROGRAM_BRIDGE_NONCE_PARAM;
 exports.MINI_PROGRAM_MESSAGE_NAMESPACE = MINI_PROGRAM_MESSAGE_NAMESPACE;
 exports.MINI_PROGRAM_MESSAGE_VERSION = MINI_PROGRAM_MESSAGE_VERSION;
 exports.MINI_PROGRAM_PROTOCOL_CAPABILITIES = MINI_PROGRAM_PROTOCOL_CAPABILITIES;
+exports.NAVIGATION_CLOSE_METHOD = NAVIGATION_CLOSE_METHOD;
+exports.NAVIGATION_RELOAD_METHOD = NAVIGATION_RELOAD_METHOD;
 exports.NETWORK_REQUEST_METHOD = NETWORK_REQUEST_METHOD;
 exports.SDK_HANDSHAKE_METHOD = SDK_HANDSHAKE_METHOD;
 exports.SHARE_SCREENSHOT_METHOD = SHARE_SCREENSHOT_METHOD;
 exports.SHARE_SHOW_SHARE_MENU_METHOD = SHARE_SHOW_SHARE_MENU_METHOD;
 exports.STORAGE_GET_STORAGE_METHOD = STORAGE_GET_STORAGE_METHOD;
 exports.STORAGE_SET_STORAGE_METHOD = STORAGE_SET_STORAGE_METHOD;
+exports.UI_HIDE_LOADING_METHOD = UI_HIDE_LOADING_METHOD;
+exports.UI_SHOW_LOADING_METHOD = UI_SHOW_LOADING_METHOD;
+exports.UI_SHOW_TOAST_METHOD = UI_SHOW_TOAST_METHOD;
 exports.USER_GET_INFO_METHOD = USER_GET_INFO_METHOD;
 exports.VIEWPORT_GET_WINDOW_INFO_METHOD = VIEWPORT_GET_WINDOW_INFO_METHOD;
 exports.VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD = VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD;

package/dist/protocol.esm.js

@@ -87,6 +87,20 @@ const STORAGE_SET_STORAGE_METHOD = 'storage.setStorage';
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
 const NETWORK_REQUEST_METHOD = 'network.request';
+/** 展示 toast 能力方法名。 */
+const UI_SHOW_TOAST_METHOD = 'ui.showToast';
+/** 展示全局 loading 能力方法名。 */
+const UI_SHOW_LOADING_METHOD = 'ui.showLoading';
+/** 隐藏全局 loading 能力方法名。 */
+const UI_HIDE_LOADING_METHOD = 'ui.hideLoading';
+/** 震动反馈能力方法名。 */
+const DEVICE_VIBRATE_METHOD = 'device.vibrate';
+/** 写入文本剪贴板能力方法名。 */
+const DEVICE_SET_CLIPBOARD_METHOD = 'device.setClipboard';
+/** 关闭当前小程序容器能力方法名。 */
+const NAVIGATION_CLOSE_METHOD = 'navigation.close';
+/** 重载当前小程序容器能力方法名。 */
+const NAVIGATION_RELOAD_METHOD = 'navigation.reload';
 /**
  * 小程序开放能力目录。
  *
@@ -157,6 +171,55 @@ const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
         permission: 'network.request',
         risk: 'high',
     },
+    {
+        method: UI_SHOW_TOAST_METHOD,
+        module: 'ui',
+        capability: UI_SHOW_TOAST_METHOD,
+        permission: 'ui.toast',
+        risk: 'low',
+    },
+    {
+        method: UI_SHOW_LOADING_METHOD,
+        module: 'ui',
+        capability: UI_SHOW_LOADING_METHOD,
+        permission: 'ui.loading',
+        risk: 'low',
+    },
+    {
+        method: UI_HIDE_LOADING_METHOD,
+        module: 'ui',
+        capability: UI_HIDE_LOADING_METHOD,
+        permission: 'ui.loading',
+        risk: 'low',
+    },
+    {
+        method: DEVICE_VIBRATE_METHOD,
+        module: 'device',
+        capability: DEVICE_VIBRATE_METHOD,
+        permission: 'device.vibrate',
+        risk: 'low',
+    },
+    {
+        method: DEVICE_SET_CLIPBOARD_METHOD,
+        module: 'device',
+        capability: DEVICE_SET_CLIPBOARD_METHOD,
+        permission: 'device.clipboard.write',
+        risk: 'medium',
+    },
+    {
+        method: NAVIGATION_CLOSE_METHOD,
+        module: 'navigation',
+        capability: NAVIGATION_CLOSE_METHOD,
+        permission: 'navigation.close',
+        risk: 'medium',
+    },
+    {
+        method: NAVIGATION_RELOAD_METHOD,
+        module: 'navigation',
+        capability: NAVIGATION_RELOAD_METHOD,
+        permission: 'navigation.reload',
+        risk: 'medium',
+    },
 ];
 
-export { AUTH_LOGIN_METHOD, MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, MINI_PROGRAM_PROTOCOL_CAPABILITIES, NETWORK_REQUEST_METHOD, SDK_HANDSHAKE_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, USER_GET_INFO_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD, isMiniProgramBridgeMessage };
+export { AUTH_LOGIN_METHOD, DEVICE_SET_CLIPBOARD_METHOD, DEVICE_VIBRATE_METHOD, MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, MINI_PROGRAM_PROTOCOL_CAPABILITIES, NAVIGATION_CLOSE_METHOD, NAVIGATION_RELOAD_METHOD, NETWORK_REQUEST_METHOD, SDK_HANDSHAKE_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, UI_HIDE_LOADING_METHOD, UI_SHOW_LOADING_METHOD, UI_SHOW_TOAST_METHOD, USER_GET_INFO_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD, isMiniProgramBridgeMessage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "",
   "exports": {
     ".": {

package/skill/references/api-protocol.md

@@ -38,17 +38,25 @@ export type {
 } from './protocol/types';
 export {
   AUTH_LOGIN_METHOD,
+  DEVICE_SET_CLIPBOARD_METHOD,
+  DEVICE_VIBRATE_METHOD,
   MINI_PROGRAM_PROTOCOL_CAPABILITIES,
+  NAVIGATION_CLOSE_METHOD,
+  NAVIGATION_RELOAD_METHOD,
   NETWORK_REQUEST_METHOD,
   SHARE_SCREENSHOT_METHOD,
   SHARE_SHOW_SHARE_MENU_METHOD,
   STORAGE_GET_STORAGE_METHOD,
   STORAGE_SET_STORAGE_METHOD,
+  UI_HIDE_LOADING_METHOD,
+  UI_SHOW_LOADING_METHOD,
+  UI_SHOW_TOAST_METHOD,
   USER_GET_INFO_METHOD,
   VIEWPORT_GET_WINDOW_INFO_METHOD,
   VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD,
 } from './protocol/capabilities';
 export type {
+  MiniProgramDeviceMethod,
   MiniProgramAuthMethod,
   MiniProgramBridgeMethod,
   MiniProgramCapabilityDefinition,
@@ -58,9 +66,11 @@ export type {
   MiniProgramCapabilityResult,
   MiniProgramCapabilityResultMap,
   MiniProgramCapabilityRisk,
+  MiniProgramNavigationMethod,
   MiniProgramNetworkMethod,
   MiniProgramShareMethod,
   MiniProgramStorageMethod,
+  MiniProgramUiMethod,
   MiniProgramUserMethod,
   MiniProgramViewportMethod,
 } from './protocol/capabilities';
@@ -104,6 +114,28 @@ export type {
   NetworkRequestPayload,
   NetworkResponsePayload,
 } from './modules/network';
+export type {
+  HideLoadingPayload,
+  HideLoadingResult,
+  MiniProgramToastStatus,
+  ShowLoadingPayload,
+  ShowLoadingResult,
+  ShowToastPayload,
+  ShowToastResult,
+} from './modules/ui';
+export type {
+  MiniProgramVibrateIntensity,
+  SetClipboardPayload,
+  SetClipboardResult,
+  VibratePayload,
+  VibrateResult,
+} from './modules/device';
+export type {
+  ClosePayload,
+  CloseResult,
+  ReloadPayload,
+  ReloadResult,
+} from './modules/navigation';
 ```
 
 ## Protocol context
@@ -136,5 +168,5 @@ Reference 由 `packages/hb-sdk` 的公开导出与源码注释自动生成，不
 
 | 导出面 | Classes | Functions | Interfaces | Types | Constants |
 | --- | ---: | ---: | ---: | ---: | ---: |
-| Root API | 3 | 4 | 23 | 20 | 0 |
-| Protocol API | 0 | 1 | 21 | 32 | 14 |
+| Root API | 3 | 4 | 30 | 32 | 3 |
+| Protocol API | 0 | 1 | 25 | 47 | 21 |

package/skill/references/api-root.md

@@ -19,7 +19,7 @@
 ## Package metadata
 
 - Package: `@heybox/hb-sdk`
-- Version at generation time: `0.4.3`
+- Version at generation time: `0.4.4`
 - Public root export: `@heybox/hb-sdk`
 - Protocol export: `@heybox/hb-sdk/protocol`
 - Vite plugin export: `@heybox/hb-sdk/vite`
@@ -30,7 +30,7 @@
 export { createMiniProgramSDK, MiniProgramSDK } from './core/sdk';
 export { HbMiniProgramSDKError, HbMiniProgramNetworkError } from './core/errors';
 export type { MiniProgramSDKOptions } from './core/client';
-export { ready, on, off, auth, user, share, viewport, storage, network } from './core/singleton';
+export { ready, on, off, auth, user, share, viewport, storage, network, ui, device, navigation } from './core/singleton';
 export type {
   MiniProgramEventHandler,
   MiniProgramEventName,
@@ -83,8 +83,33 @@ export type {
   NetworkRequestPayload,
   NetworkResponsePayload,
 } from './modules/network';
+export type {
+  HideLoadingPayload,
+  HideLoadingResult,
+  MiniProgramToastStatus,
+  MiniProgramUiModule,
+  ShowLoadingPayload,
+  ShowLoadingResult,
+  ShowToastPayload,
+  ShowToastResult,
+} from './modules/ui';
+export type {
+  MiniProgramDeviceModule,
+  MiniProgramVibrateIntensity,
+  SetClipboardPayload,
+  SetClipboardResult,
+  VibratePayload,
+  VibrateResult,
+} from './modules/device';
+export type {
+  ClosePayload,
+  CloseResult,
+  MiniProgramNavigationModule,
+  ReloadPayload,
+  ReloadResult,
+} from './modules/navigation';
 
-import { auth, network, off, on, ready, share, storage, viewport, user } from './core/singleton';
+import { auth, device, navigation, network, off, on, ready, share, storage, ui, viewport, user } from './core/singleton';
 
 const hbSDK = {
   ready,
@@ -96,6 +121,9 @@ const hbSDK = {
   viewport,
   storage,
   network,
+  ui,
+  device,
+  navigation,
 };
 
 export default hbSDK;
@@ -327,6 +355,53 @@ await share.screenshot({
 });
 ```
 
+### 基础 UI
+
+```ts
+import { ui } from '@heybox/hb-sdk';
+
+await ui.showToast({
+  message: '保存成功',
+  status: 'success',
+});
+
+await ui.showLoading({
+  dismissible: true,
+});
+
+await ui.hideLoading();
+```
+
+`showToast()` 的 `message` 会 trim 后发送给宿主，不能为空，最长 120 个字符；`status` 只支持 `success` 和 `error`，不传时展示普通文本 toast。loading 是全局单例，多次 `showLoading()` 会覆盖当前配置，`hideLoading()` 在未展示时也会成功。
+
+### 设备能力
+
+```ts
+import { device } from '@heybox/hb-sdk';
+
+await device.vibrate({
+  intensity: 'light',
+  delay: 0,
+});
+
+await device.setClipboard({
+  text: 'hello',
+});
+```
+
+`vibrate()` 的 `intensity` 默认为 `light`，还支持 `medium` 和 `heavy`；`delay` 默认为 `0`，必须是 `0..5000` 的整数毫秒。`setClipboard()` 第一版只支持文本写入，`text` 必须是非空字符串，最长 10000 个字符，不会自动 trim 写入内容，也不提供读取或清空剪贴板能力。
+
+### 导航控制
+
+```ts
+import { navigation } from '@heybox/hb-sdk';
+
+await navigation.reload();
+await navigation.close();
+```
+
+`navigation.close()` 请求宿主关闭当前小程序容器，`navigation.reload()` 请求宿主重载当前小程序页面/容器。调用后 JS 上下文可能被宿主销毁，不保证后续代码继续执行；这两个能力不接受 `reason`、`force`、`confirm` 或 `fallbackUrl` 等扩展参数。
+
 ### 窗口信息
 
 ```ts

package/skill/references/llms-index.md

@@ -26,8 +26,8 @@ This site documents the iframe-side SDK for external mini programs. For AI retri
 - [Root functions](./llms/reference/root/functions/README.md)
 - [Root interfaces](./llms/reference/root/interfaces/README.md): `on/off` 会基于该映射推导 handler 参数类型。 |
 - [Protocol interfaces](./llms/reference/protocol/interfaces/README.md): 所有请求失败都会被规范化成该结构，SDK 侧再包装为 `HbMiniProgramSDKError`。 |
-- [Root types](./llms/reference/root/types/README.md): `user.getInfo` 不需要入参。
-- [Protocol types](./llms/reference/protocol/types/README.md): `user.getInfo` 不需要入参。
+- [Root types](./llms/reference/root/types/README.md): `navigation.close` 不需要入参。
+- [Protocol types](./llms/reference/protocol/types/README.md): `navigation.close` 不需要入参。
 ## Guides
 - [Agent Skill 安装](./llms/guide/agent-skill.md): `hb-sdk` Agent Skill 用来让 AI / Agent 按本仓库约定使用 `@heybox/hb-sdk` 和配套 `hb-sdk` CLI，包括 iframe 小程序接入、`ready`、用户信息、登录、事件、CLI 创建模板、`hb-sdk dev` 本地调试、CLI 登录态、协议边界和常见错误处理。
 - [用户与登录](./llms/guide/auth.md): 用户与授权模块当前分工：

package/skill/references/safety-boundaries.md

@@ -12,7 +12,7 @@
 
 - 调用模块能力前会自动等待 `ready()`，但业务仍建议在页面启动阶段显式 `await ready()`，便于集中处理握手失败。
 - `user.getInfo()` 不会触发登录；登录必须由业务在用户操作后调用 `auth.login()`。
-- 分享、截图、storage 和网络请求只开放稳定窄接口，不透传黑盒客户端内部协议参数。
+- 分享、截图、UI、设备、导航、storage 和网络请求只开放稳定窄接口，不透传黑盒客户端内部协议参数。
 - `network.request()` 的 `validateStatus` 只在 SDK 本地执行，不会被序列化给父容器。
 - `on()` 返回取消监听函数；组件卸载或页面销毁时应主动取消监听。
 - 使用 `createMiniProgramSDK()` 创建独立实例后，不再需要时应调用 `destroy()`。

package/skill/skill.json

@@ -1,11 +1,11 @@
 {
   "name": "hb-sdk",
-  "skillVersion": "0.4.3+skill.4ff08ec8601f",
+  "skillVersion": "0.4.4+skill.77f95b6757e8",
   "sdk": {
     "package": "@heybox/hb-sdk",
-    "version": "0.4.3",
-    "compatibility": "0.4.3"
+    "version": "0.4.4",
+    "compatibility": "0.4.4"
   },
   "source": "https://open.xiaoheihe.cn/agent-skills/hb-sdk",
-  "integrity": "sha256-4ff08ec8601fb16bcad10c4f654ce4a87d36a4f058e256a77704ba3e7369a1c7"
+  "integrity": "sha256-77f95b6757e86f4fd6ec2bc865bab4a3781403d5e1db9b3e729407a7fbd7f01a"
 }

package/types/core/sdk.d.ts

@@ -5,6 +5,9 @@ import { type MiniProgramStorageModule } from '../modules/storage';
 import { type MiniProgramNetworkModule } from '../modules/network';
 import { type MiniProgramViewportModule } from '../modules/viewport';
 import { type MiniProgramUserModule } from '../modules/user';
+import { type MiniProgramUiModule } from '../modules/ui';
+import { type MiniProgramDeviceModule } from '../modules/device';
+import { type MiniProgramNavigationModule } from '../modules/navigation';
 import type { MiniProgramEventHandler, MiniProgramEventName } from '../protocol/types';
 /**
  * 外部小程序 SDK 实例。
@@ -41,6 +44,12 @@ export declare class MiniProgramSDK {
     readonly storage: MiniProgramStorageModule;
     /** 网络请求相关开放能力。 */
     readonly network: MiniProgramNetworkModule;
+    /** UI 交互相关开放能力。 */
+    readonly ui: MiniProgramUiModule;
+    /** 设备相关开放能力。 */
+    readonly device: MiniProgramDeviceModule;
+    /** 导航与容器控制相关开放能力。 */
+    readonly navigation: MiniProgramNavigationModule;
     constructor(options?: MiniProgramSDKOptions);
     /**
      * 等待 SDK 与父容器完成握手。

package/types/core/singleton.d.ts

@@ -4,6 +4,9 @@ import type { MiniProgramStorageModule } from '../modules/storage';
 import type { MiniProgramNetworkModule } from '../modules/network';
 import type { MiniProgramViewportModule } from '../modules/viewport';
 import type { MiniProgramUserModule } from '../modules/user';
+import type { MiniProgramUiModule } from '../modules/ui';
+import type { MiniProgramDeviceModule } from '../modules/device';
+import type { MiniProgramNavigationModule } from '../modules/navigation';
 import type { MiniProgramEventHandler, MiniProgramEventName } from '../protocol/types';
 /**
  * 等待默认 SDK 实例与父容器完成握手。
@@ -40,5 +43,11 @@ export declare const viewport: MiniProgramViewportModule;
 export declare const storage: MiniProgramStorageModule;
 /** 默认 SDK 实例的 network 模块。 */
 export declare const network: MiniProgramNetworkModule;
+/** 默认 SDK 实例的 UI 模块。 */
+export declare const ui: MiniProgramUiModule;
+/** 默认 SDK 实例的 device 模块。 */
+export declare const device: MiniProgramDeviceModule;
+/** 默认 SDK 实例的 navigation 模块。 */
+export declare const navigation: MiniProgramNavigationModule;
 /** 重置默认 SDK 实例，仅用于测试。 */
 export declare function resetDefaultSDKForTest(): void;

package/types/index.d.ts

@@ -1,7 +1,7 @@
 export { createMiniProgramSDK, MiniProgramSDK } from './core/sdk';
 export { HbMiniProgramSDKError, HbMiniProgramNetworkError } from './core/errors';
 export type { MiniProgramSDKOptions } from './core/client';
-export { ready, on, off, auth, user, share, viewport, storage, network } from './core/singleton';
+export { ready, on, off, auth, user, share, viewport, storage, network, ui, device, navigation } from './core/singleton';
 export type { MiniProgramEventHandler, MiniProgramEventName, MiniProgramEventPayloadMap, } from './protocol/types';
 export type { LoginPayload, LoginResult, MiniProgramAuthModule } from './modules/auth';
 export type { GetUserInfoPayload, GetUserInfoResult, MiniProgramUserInfo, MiniProgramUserInfoResult, MiniProgramUserModule, } from './modules/user';
@@ -9,6 +9,9 @@ export type { MiniProgramScreenshotOptions, MiniProgramScreenshotRect, MiniProgr
 export type { GetWindowInfoPayload, GetWindowInfoResult, MiniProgramNavigationBarForegroundStyle, MiniProgramSafeArea, MiniProgramSetNavigationBarStyleOptions, MiniProgramViewportModule, MiniProgramWindowInfoResult, SetNavigationBarStylePayload, SetNavigationBarStyleResult, } from './modules/viewport';
 export type { GetStoragePayload, GetStorageResult, MiniProgramStorageModule, SetStoragePayload, } from './modules/storage';
 export type { MiniProgramNetworkHeaders, MiniProgramNetworkModule, MiniProgramNetworkParams, MiniProgramNetworkRequestConfig, MiniProgramNetworkRequestMethod, MiniProgramNetworkResponse, MiniProgramNetworkValidateStatus, NetworkRequestPayload, NetworkResponsePayload, } from './modules/network';
+export type { HideLoadingPayload, HideLoadingResult, MiniProgramToastStatus, MiniProgramUiModule, ShowLoadingPayload, ShowLoadingResult, ShowToastPayload, ShowToastResult, } from './modules/ui';
+export type { MiniProgramDeviceModule, MiniProgramVibrateIntensity, SetClipboardPayload, SetClipboardResult, VibratePayload, VibrateResult, } from './modules/device';
+export type { ClosePayload, CloseResult, MiniProgramNavigationModule, ReloadPayload, ReloadResult, } from './modules/navigation';
 import { off, on, ready } from './core/singleton';
 declare const hbSDK: {
     ready: typeof ready;
@@ -20,5 +23,8 @@ declare const hbSDK: {
     viewport: import(".").MiniProgramViewportModule;
     storage: import(".").MiniProgramStorageModule;
     network: import(".").MiniProgramNetworkModule;
+    ui: import(".").MiniProgramUiModule;
+    device: import(".").MiniProgramDeviceModule;
+    navigation: import(".").MiniProgramNavigationModule;
 };
 export default hbSDK;

package/types/modules/device/index.d.ts

@@ -0,0 +1,34 @@
+import type { MiniProgramRequester } from '../../core/client';
+export { DEVICE_SET_CLIPBOARD_METHOD, DEVICE_VIBRATE_METHOD, } from '../../protocol/capabilities';
+/** 震动强度。 */
+export type MiniProgramVibrateIntensity = 'light' | 'medium' | 'heavy';
+/** `device.vibrate` 入参。 */
+export interface VibratePayload {
+    /** 震动强度，默认 light。 */
+    intensity?: MiniProgramVibrateIntensity;
+    /** 延迟触发毫秒数，默认 0。 */
+    delay?: number;
+}
+/** `device.vibrate` 无稳定返回值。 */
+export type VibrateResult = void;
+/** `device.setClipboard` 入参。 */
+export interface SetClipboardPayload {
+    /** 要写入系统剪贴板的文本。 */
+    text: string;
+}
+/** `device.setClipboard` 无稳定返回值。 */
+export type SetClipboardResult = void;
+export type { MiniProgramDeviceMethod } from '../../protocol/capabilities';
+/** 外部小程序可调用的 device 模块。 */
+export interface MiniProgramDeviceModule {
+    /** 触发宿主震动反馈。 */
+    vibrate(options?: VibratePayload): Promise<void>;
+    /** 写入系统文本剪贴板。 */
+    setClipboard(options: SetClipboardPayload): Promise<void>;
+}
+/** 触发宿主震动反馈。 */
+export declare function vibrate(requester: MiniProgramRequester, options?: VibratePayload): Promise<void>;
+/** 写入系统文本剪贴板。 */
+export declare function setClipboard(requester: MiniProgramRequester, options: SetClipboardPayload): Promise<void>;
+/** 创建设备能力模块。 */
+export declare function createDeviceModule(requester: MiniProgramRequester): MiniProgramDeviceModule;

package/types/modules/navigation/index.d.ts

@@ -0,0 +1,24 @@
+import type { MiniProgramRequester } from '../../core/client';
+export { NAVIGATION_CLOSE_METHOD, NAVIGATION_RELOAD_METHOD, } from '../../protocol/capabilities';
+/** `navigation.close` 不需要入参。 */
+export type ClosePayload = void;
+/** `navigation.close` 无稳定返回值。 */
+export type CloseResult = void;
+/** `navigation.reload` 不需要入参。 */
+export type ReloadPayload = void;
+/** `navigation.reload` 无稳定返回值。 */
+export type ReloadResult = void;
+export type { MiniProgramNavigationMethod } from '../../protocol/capabilities';
+/** 外部小程序可调用的 navigation 模块。 */
+export interface MiniProgramNavigationModule {
+    /** 请求宿主关闭当前小程序容器。 */
+    close(): Promise<void>;
+    /** 请求宿主重载当前小程序容器。 */
+    reload(): Promise<void>;
+}
+/** 请求宿主关闭当前小程序容器。 */
+export declare function close(requester: MiniProgramRequester): Promise<void>;
+/** 请求宿主重载当前小程序容器。 */
+export declare function reload(requester: MiniProgramRequester): Promise<void>;
+/** 创建导航能力模块。 */
+export declare function createNavigationModule(requester: MiniProgramRequester): MiniProgramNavigationModule;

package/types/modules/ui/index.d.ts

@@ -0,0 +1,42 @@
+import type { MiniProgramRequester } from '../../core/client';
+export { UI_HIDE_LOADING_METHOD, UI_SHOW_LOADING_METHOD, UI_SHOW_TOAST_METHOD, } from '../../protocol/capabilities';
+/** Toast 展示状态。 */
+export type MiniProgramToastStatus = 'success' | 'error';
+/** `ui.showToast` 入参。 */
+export interface ShowToastPayload {
+    /** Toast 文案。 */
+    message: string;
+    /** Toast 状态；不传时展示普通文本 toast。 */
+    status?: MiniProgramToastStatus;
+}
+/** `ui.showToast` 无稳定返回值。 */
+export type ShowToastResult = void;
+/** `ui.showLoading` 入参。 */
+export interface ShowLoadingPayload {
+    /** 是否允许用户手动关闭 loading。 */
+    dismissible?: boolean;
+}
+/** `ui.showLoading` 无稳定返回值。 */
+export type ShowLoadingResult = void;
+/** `ui.hideLoading` 不需要入参。 */
+export type HideLoadingPayload = void;
+/** `ui.hideLoading` 无稳定返回值。 */
+export type HideLoadingResult = void;
+export type { MiniProgramUiMethod } from '../../protocol/capabilities';
+/** 外部小程序可调用的 UI 模块。 */
+export interface MiniProgramUiModule {
+    /** 展示 toast。 */
+    showToast(options: ShowToastPayload): Promise<void>;
+    /** 展示全局 loading。 */
+    showLoading(options?: ShowLoadingPayload): Promise<void>;
+    /** 隐藏全局 loading。 */
+    hideLoading(): Promise<void>;
+}
+/** 展示 toast。 */
+export declare function showToast(requester: MiniProgramRequester, options: ShowToastPayload): Promise<void>;
+/** 展示全局 loading。 */
+export declare function showLoading(requester: MiniProgramRequester, options?: ShowLoadingPayload): Promise<void>;
+/** 隐藏全局 loading。 */
+export declare function hideLoading(requester: MiniProgramRequester): Promise<void>;
+/** 创建 UI 模块。 */
+export declare function createUiModule(requester: MiniProgramRequester): MiniProgramUiModule;