@heybox/hb-sdk 0.4.3 → 0.4.4

package/dist/devtools/mock-host/main.js

@@ -68,6 +68,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';
 /**
  * 小程序开放能力目录。
  *
@@ -138,6 +152,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',
+    },
 ];
 
 var browser = {};
@@ -3773,19 +3836,48 @@ const MINI_PROGRAM_MOCK_RUNTIME_METHOD_HANDLERS = {
     [STORAGE_GET_STORAGE_METHOD]: (runtime, payload) => runtime.getStorage(payload),
     [STORAGE_SET_STORAGE_METHOD]: (runtime, payload) => runtime.setStorage(payload),
     [NETWORK_REQUEST_METHOD]: (runtime, payload) => runtime.requestNetwork(payload),
+    [UI_SHOW_TOAST_METHOD]: (runtime, payload) => runtime.showToast(payload),
+    [UI_SHOW_LOADING_METHOD]: (runtime, payload) => runtime.showLoading(payload),
+    [UI_HIDE_LOADING_METHOD]: (runtime, payload) => runtime.hideLoading(payload),
+    [DEVICE_VIBRATE_METHOD]: (runtime, payload) => runtime.vibrate(payload),
+    [DEVICE_SET_CLIPBOARD_METHOD]: (runtime, payload) => runtime.setClipboard(payload),
+    [NAVIGATION_CLOSE_METHOD]: (runtime, payload) => runtime.close(payload),
+    [NAVIGATION_RELOAD_METHOD]: (runtime, payload) => runtime.reload(payload),
 };
 class MiniProgramMockRuntime {
     constructor(adapter, options = {}) {
         this.adapter = adapter;
         this.options = options;
+        this.clipboardText = null;
+        this.closed = false;
+        this.loading = {
+            dismissible: false,
+            visible: false,
+        };
+        this.records = [];
+        this.toasts = [];
+        this.vibrates = [];
     }
     async runMethod(method, payload) {
         if (!isMiniProgramMockRuntimeMethod(method)) {
             throw createMockBridgeError('METHOD_NOT_FOUND', `未开放小程序能力: ${method}`);
         }
+        if (this.closed && method !== NAVIGATION_CLOSE_METHOD) {
+            throw createMockBridgeError('INVALID_STATE', '当前小程序容器已关闭');
+        }
         const handler = MINI_PROGRAM_MOCK_RUNTIME_METHOD_HANDLERS[method];
         return handler(this, payload);
     }
+    getState() {
+        return {
+            clipboardText: this.clipboardText,
+            closed: this.closed,
+            loading: { ...this.loading },
+            records: [...this.records],
+            toasts: [...this.toasts],
+            vibrates: [...this.vibrates],
+        };
+    }
     async login() {
         const result = await loginAndGetMiniProgramRuntimeUserInfo(this.adapter);
         this.options.onAuthChange?.(result);
@@ -3815,6 +3907,80 @@ class MiniProgramMockRuntime {
     requestNetwork(payload) {
         return requestMiniProgramRuntimeNetwork(payload, this.adapter);
     }
+    async showToast(payload) {
+        const toast = readShowToastPayload(payload);
+        this.toasts.unshift(toast);
+        this.toasts.splice(10);
+        this.record(UI_SHOW_TOAST_METHOD, toast);
+        renderMockToast(toast);
+        await this.options.onToast?.(toast);
+    }
+    async showLoading(payload) {
+        this.loading = readShowLoadingPayload(payload);
+        this.record(UI_SHOW_LOADING_METHOD, this.loading);
+        renderMockLoading(this.loading);
+        await this.options.onLoadingChange?.({ ...this.loading });
+    }
+    async hideLoading(payload) {
+        assertEmptyPayload(payload, 'ui.hideLoading');
+        this.loading = {
+            dismissible: false,
+            visible: false,
+        };
+        this.record(UI_HIDE_LOADING_METHOD, this.loading);
+        renderMockLoading(this.loading);
+        await this.options.onLoadingChange?.({ ...this.loading });
+    }
+    async vibrate(payload) {
+        const action = readVibratePayload(payload);
+        this.vibrates.unshift(action);
+        this.vibrates.splice(10);
+        this.record(DEVICE_VIBRATE_METHOD, action);
+        if (typeof navigator !== 'undefined' && typeof navigator.vibrate === 'function') {
+            navigator.vibrate(action.pattern);
+        }
+        await this.options.onVibrate?.(action);
+    }
+    async setClipboard(payload) {
+        const text = readSetClipboardPayload(payload);
+        this.record(DEVICE_SET_CLIPBOARD_METHOD, { text });
+        try {
+            if (typeof navigator !== 'undefined' && navigator.clipboard?.writeText) {
+                await navigator.clipboard.writeText(text);
+            }
+        }
+        catch {
+            // Browser clipboard permissions are intentionally non-blocking in the mock host.
+        }
+        this.clipboardText = text;
+        await this.options.onClipboardText?.(text);
+    }
+    async close(payload) {
+        assertEmptyPayload(payload, 'navigation.close');
+        this.record(NAVIGATION_CLOSE_METHOD, { closed: this.closed });
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        closeMockIframe();
+        await this.options.onClose?.();
+    }
+    async reload(payload) {
+        assertEmptyPayload(payload, 'navigation.reload');
+        this.record(NAVIGATION_RELOAD_METHOD, {});
+        await this.options.onReload?.();
+        if (!this.options.onReload) {
+            reloadMockIframe();
+        }
+    }
+    record(method, payload) {
+        this.records.unshift({
+            method,
+            payload,
+            timestamp: Date.now(),
+        });
+        this.records.splice(30);
+    }
 }
 function isMiniProgramMockRuntimeMethod(method) {
     return MINI_PROGRAM_MOCK_RUNTIME_METHODS.includes(method);
@@ -3844,6 +4010,215 @@ function toMockBridgeError(error) {
 function isObjectLike(value) {
     return (typeof value === 'object' || typeof value === 'function') && value !== null;
 }
+function readShowToastPayload(payload) {
+    if (!isPlainRecord(payload)) {
+        throw createMockBridgeError('INVALID_PARAMS', 'ui.showToast options 必须是对象');
+    }
+    assertOnlyAllowedKeys(payload, new Set(['message', 'status']), 'ui.showToast');
+    if (typeof payload.message !== 'string') {
+        throw createMockBridgeError('INVALID_PARAMS', 'ui.showToast message 必须是字符串');
+    }
+    const message = payload.message.trim();
+    if (!message) {
+        throw createMockBridgeError('INVALID_PARAMS', 'ui.showToast message 不能为空');
+    }
+    if (message.length > 120) {
+        throw createMockBridgeError('INVALID_PARAMS', 'ui.showToast message 不能超过 120 个字符');
+    }
+    if (payload.status !== undefined && payload.status !== 'success' && payload.status !== 'error') {
+        throw createMockBridgeError('INVALID_PARAMS', 'ui.showToast status 必须是 success 或 error');
+    }
+    return {
+        message,
+        status: payload.status,
+        timestamp: Date.now(),
+    };
+}
+function readShowLoadingPayload(payload) {
+    if (payload === undefined) {
+        return {
+            dismissible: false,
+            visible: true,
+        };
+    }
+    if (!isPlainRecord(payload)) {
+        throw createMockBridgeError('INVALID_PARAMS', 'ui.showLoading options 必须是对象');
+    }
+    assertOnlyAllowedKeys(payload, new Set(['dismissible']), 'ui.showLoading');
+    if (payload.dismissible !== undefined && typeof payload.dismissible !== 'boolean') {
+        throw createMockBridgeError('INVALID_PARAMS', 'ui.showLoading dismissible 必须是布尔值');
+    }
+    return {
+        dismissible: payload.dismissible === true,
+        visible: true,
+    };
+}
+function readVibratePayload(payload) {
+    if (payload !== undefined && !isPlainRecord(payload)) {
+        throw createMockBridgeError('INVALID_PARAMS', 'device.vibrate options 必须是对象');
+    }
+    if (payload !== undefined) {
+        assertOnlyAllowedKeys(payload, new Set(['intensity', 'delay']), 'device.vibrate');
+    }
+    const intensity = payload?.intensity ?? 'light';
+    if (intensity !== 'light' && intensity !== 'medium' && intensity !== 'heavy') {
+        throw createMockBridgeError('INVALID_PARAMS', 'device.vibrate intensity 必须是 light、medium 或 heavy');
+    }
+    const delay = payload?.delay ?? 0;
+    if (!Number.isInteger(delay) || delay < 0 || delay > 5000) {
+        throw createMockBridgeError('INVALID_PARAMS', 'device.vibrate delay 必须是 0..5000 的整数毫秒');
+    }
+    return {
+        delay,
+        intensity,
+        pattern: createVibratePattern(intensity),
+        timestamp: Date.now(),
+    };
+}
+function readSetClipboardPayload(payload) {
+    if (!isPlainRecord(payload)) {
+        throw createMockBridgeError('INVALID_PARAMS', 'device.setClipboard options 必须是对象');
+    }
+    const extraKeys = Object.keys(payload).filter(key => key !== 'text');
+    if (extraKeys.length > 0) {
+        throw createMockBridgeError('INVALID_PARAMS', `device.setClipboard 不支持字段: ${extraKeys.join(', ')}`);
+    }
+    if (typeof payload.text !== 'string') {
+        throw createMockBridgeError('INVALID_PARAMS', 'device.setClipboard text 必须是字符串');
+    }
+    if (!payload.text.trim()) {
+        throw createMockBridgeError('INVALID_PARAMS', 'device.setClipboard text 不能为空');
+    }
+    if (payload.text.length > 10000) {
+        throw createMockBridgeError('INVALID_PARAMS', 'device.setClipboard text 不能超过 10000 个字符');
+    }
+    return payload.text;
+}
+function assertEmptyPayload(payload, methodName) {
+    if (payload === undefined) {
+        return;
+    }
+    if (!isPlainRecord(payload) || Object.keys(payload).length > 0) {
+        throw createMockBridgeError('INVALID_PARAMS', `${methodName} 不支持参数`);
+    }
+}
+function assertOnlyAllowedKeys(payload, allowedKeys, methodName) {
+    const invalidKeys = Object.keys(payload).filter(key => !allowedKeys.has(key));
+    if (invalidKeys.length > 0) {
+        throw createMockBridgeError('INVALID_PARAMS', `${methodName} 不支持字段: ${invalidKeys.join(', ')}`);
+    }
+}
+function createVibratePattern(intensity) {
+    switch (intensity) {
+        case 'heavy':
+            return 40;
+        case 'medium':
+            return 25;
+        case 'light':
+        default:
+            return 10;
+    }
+}
+function renderMockToast(toast) {
+    const document = readDocument();
+    if (!document) {
+        return;
+    }
+    const element = findOrCreateMockElement(document, 'hb-sdk-mock-runtime-toast');
+    element.textContent = toast.message;
+    element.dataset.status = toast.status ?? 'default';
+    element.style.cssText = [
+        'position:fixed',
+        'left:50%',
+        'bottom:48px',
+        'transform:translateX(-50%)',
+        'z-index:2147483647',
+        'max-width:80%',
+        'padding:8px 12px',
+        'border-radius:6px',
+        'background:rgba(17,24,39,.92)',
+        'color:#fff',
+        'font:13px/1.4 -apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif',
+        'box-shadow:0 8px 24px rgba(0,0,0,.18)',
+        'pointer-events:none',
+        'white-space:pre-wrap',
+    ].join(';');
+}
+function renderMockLoading(state) {
+    const document = readDocument();
+    if (!document) {
+        return;
+    }
+    const element = findOrCreateMockElement(document, 'hb-sdk-mock-runtime-loading');
+    element.hidden = !state.visible;
+    element.dataset.dismissible = String(state.dismissible);
+    element.textContent = '加载中...';
+    element.style.cssText = [
+        'position:fixed',
+        'inset:0',
+        'z-index:2147483646',
+        'display:flex',
+        'align-items:center',
+        'justify-content:center',
+        'background:rgba(15,23,42,.16)',
+        'color:#fff',
+        'font:14px/1.4 -apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif',
+        'pointer-events:none',
+    ].join(';');
+}
+function reloadMockIframe() {
+    const iframe = readMockIframe();
+    if (!iframe) {
+        return;
+    }
+    setTimeout(() => {
+        iframe.src = iframe.src;
+    }, 0);
+}
+function closeMockIframe() {
+    const iframe = readMockIframe();
+    if (!iframe) {
+        return;
+    }
+    iframe.hidden = true;
+    iframe.dataset.hbSdkMockClosed = 'true';
+    const document = readDocument();
+    const parent = iframe.parentElement;
+    if (!document || !parent) {
+        return;
+    }
+    const element = findOrCreateMockElement(document, 'hb-sdk-mock-runtime-closed');
+    element.textContent = '小程序已关闭';
+    element.style.cssText = [
+        'display:flex',
+        'align-items:center',
+        'justify-content:center',
+        'min-height:240px',
+        'color:#64748b',
+        'font:14px/1.4 -apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif',
+    ].join(';');
+    parent.appendChild(element);
+}
+function readMockIframe() {
+    const document = readDocument();
+    return document?.querySelector('iframe') ?? null;
+}
+function findOrCreateMockElement(document, id) {
+    const current = document.getElementById(id);
+    if (current) {
+        return current;
+    }
+    const element = document.createElement('div');
+    element.id = id;
+    document.body.appendChild(element);
+    return element;
+}
+function readDocument() {
+    return typeof document === 'undefined' ? null : document;
+}
+function isPlainRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
 
 const MINI_PROGRAM_URL_QUERY_PARAM = 'mini_url';
 const MINI_PROGRAM_DEV_SHELL_URL = 'heybox-mini-dev://sandbox';

package/dist/index.cjs.js

@@ -473,6 +473,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';
 
 /**
  * 唤起登录授权，并在流程返回后刷新用户公开基础资料。
@@ -728,6 +742,59 @@ function createUserModule(requester) {
     };
 }
 
+/** 展示 toast。 */
+function showToast(requester, options) {
+    return requester.request(UI_SHOW_TOAST_METHOD, options);
+}
+/** 展示全局 loading。 */
+function showLoading(requester, options) {
+    return requester.request(UI_SHOW_LOADING_METHOD, options ?? {});
+}
+/** 隐藏全局 loading。 */
+function hideLoading(requester) {
+    return requester.request(UI_HIDE_LOADING_METHOD);
+}
+/** 创建 UI 模块。 */
+function createUiModule(requester) {
+    return {
+        showToast: options => showToast(requester, options),
+        showLoading: options => showLoading(requester, options),
+        hideLoading: () => hideLoading(requester),
+    };
+}
+
+/** 触发宿主震动反馈。 */
+function vibrate(requester, options) {
+    return requester.request(DEVICE_VIBRATE_METHOD, options ?? {});
+}
+/** 写入系统文本剪贴板。 */
+function setClipboard(requester, options) {
+    return requester.request(DEVICE_SET_CLIPBOARD_METHOD, options);
+}
+/** 创建设备能力模块。 */
+function createDeviceModule(requester) {
+    return {
+        vibrate: options => vibrate(requester, options),
+        setClipboard: options => setClipboard(requester, options),
+    };
+}
+
+/** 请求宿主关闭当前小程序容器。 */
+function close(requester) {
+    return requester.request(NAVIGATION_CLOSE_METHOD);
+}
+/** 请求宿主重载当前小程序容器。 */
+function reload(requester) {
+    return requester.request(NAVIGATION_RELOAD_METHOD);
+}
+/** 创建导航能力模块。 */
+function createNavigationModule(requester) {
+    return {
+        close: () => close(requester),
+        reload: () => reload(requester),
+    };
+}
+
 /**
  * 外部小程序 SDK 实例。
  *
@@ -763,6 +830,12 @@ class MiniProgramSDK {
     storage;
     /** 网络请求相关开放能力。 */
     network;
+    /** UI 交互相关开放能力。 */
+    ui;
+    /** 设备相关开放能力。 */
+    device;
+    /** 导航与容器控制相关开放能力。 */
+    navigation;
     constructor(options) {
         this.client = new MiniProgramBridgeClient(options);
         this.auth = createAuthModule(this.client);
@@ -771,6 +844,9 @@ class MiniProgramSDK {
         this.viewport = createViewportModule(this.client);
         this.storage = createStorageModule(this.client);
         this.network = createNetworkModule(this.client);
+        this.ui = createUiModule(this.client);
+        this.device = createDeviceModule(this.client);
+        this.navigation = createNavigationModule(this.client);
     }
     /**
      * 等待 SDK 与父容器完成握手。
@@ -896,6 +972,22 @@ const storage = {
 const network = {
     request: config => getDefaultSDK().network.request(config),
 };
+/** 默认 SDK 实例的 UI 模块。 */
+const ui = {
+    showToast: options => getDefaultSDK().ui.showToast(options),
+    showLoading: options => getDefaultSDK().ui.showLoading(options),
+    hideLoading: () => getDefaultSDK().ui.hideLoading(),
+};
+/** 默认 SDK 实例的 device 模块。 */
+const device = {
+    vibrate: options => getDefaultSDK().device.vibrate(options),
+    setClipboard: options => getDefaultSDK().device.setClipboard(options),
+};
+/** 默认 SDK 实例的 navigation 模块。 */
+const navigation = {
+    close: () => getDefaultSDK().navigation.close(),
+    reload: () => getDefaultSDK().navigation.reload(),
+};
 
 const hbSDK = {
     ready,
@@ -907,6 +999,9 @@ const hbSDK = {
     viewport,
     storage,
     network,
+    ui,
+    device,
+    navigation,
 };
 
 exports.HbMiniProgramNetworkError = HbMiniProgramNetworkError;
@@ -915,11 +1010,14 @@ exports.MiniProgramSDK = MiniProgramSDK;
 exports.auth = auth;
 exports.createMiniProgramSDK = createMiniProgramSDK;
 exports.default = hbSDK;
+exports.device = device;
+exports.navigation = navigation;
 exports.network = network;
 exports.off = off;
 exports.on = on;
 exports.ready = ready;
 exports.share = share;
 exports.storage = storage;
+exports.ui = ui;
 exports.user = user;
 exports.viewport = viewport;

package/dist/index.esm.js

@@ -469,6 +469,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';
 
 /**
  * 唤起登录授权，并在流程返回后刷新用户公开基础资料。
@@ -724,6 +738,59 @@ function createUserModule(requester) {
     };
 }
 
+/** 展示 toast。 */
+function showToast(requester, options) {
+    return requester.request(UI_SHOW_TOAST_METHOD, options);
+}
+/** 展示全局 loading。 */
+function showLoading(requester, options) {
+    return requester.request(UI_SHOW_LOADING_METHOD, options ?? {});
+}
+/** 隐藏全局 loading。 */
+function hideLoading(requester) {
+    return requester.request(UI_HIDE_LOADING_METHOD);
+}
+/** 创建 UI 模块。 */
+function createUiModule(requester) {
+    return {
+        showToast: options => showToast(requester, options),
+        showLoading: options => showLoading(requester, options),
+        hideLoading: () => hideLoading(requester),
+    };
+}
+
+/** 触发宿主震动反馈。 */
+function vibrate(requester, options) {
+    return requester.request(DEVICE_VIBRATE_METHOD, options ?? {});
+}
+/** 写入系统文本剪贴板。 */
+function setClipboard(requester, options) {
+    return requester.request(DEVICE_SET_CLIPBOARD_METHOD, options);
+}
+/** 创建设备能力模块。 */
+function createDeviceModule(requester) {
+    return {
+        vibrate: options => vibrate(requester, options),
+        setClipboard: options => setClipboard(requester, options),
+    };
+}
+
+/** 请求宿主关闭当前小程序容器。 */
+function close(requester) {
+    return requester.request(NAVIGATION_CLOSE_METHOD);
+}
+/** 请求宿主重载当前小程序容器。 */
+function reload(requester) {
+    return requester.request(NAVIGATION_RELOAD_METHOD);
+}
+/** 创建导航能力模块。 */
+function createNavigationModule(requester) {
+    return {
+        close: () => close(requester),
+        reload: () => reload(requester),
+    };
+}
+
 /**
  * 外部小程序 SDK 实例。
  *
@@ -759,6 +826,12 @@ class MiniProgramSDK {
     storage;
     /** 网络请求相关开放能力。 */
     network;
+    /** UI 交互相关开放能力。 */
+    ui;
+    /** 设备相关开放能力。 */
+    device;
+    /** 导航与容器控制相关开放能力。 */
+    navigation;
     constructor(options) {
         this.client = new MiniProgramBridgeClient(options);
         this.auth = createAuthModule(this.client);
@@ -767,6 +840,9 @@ class MiniProgramSDK {
         this.viewport = createViewportModule(this.client);
         this.storage = createStorageModule(this.client);
         this.network = createNetworkModule(this.client);
+        this.ui = createUiModule(this.client);
+        this.device = createDeviceModule(this.client);
+        this.navigation = createNavigationModule(this.client);
     }
     /**
      * 等待 SDK 与父容器完成握手。
@@ -892,6 +968,22 @@ const storage = {
 const network = {
     request: config => getDefaultSDK().network.request(config),
 };
+/** 默认 SDK 实例的 UI 模块。 */
+const ui = {
+    showToast: options => getDefaultSDK().ui.showToast(options),
+    showLoading: options => getDefaultSDK().ui.showLoading(options),
+    hideLoading: () => getDefaultSDK().ui.hideLoading(),
+};
+/** 默认 SDK 实例的 device 模块。 */
+const device = {
+    vibrate: options => getDefaultSDK().device.vibrate(options),
+    setClipboard: options => getDefaultSDK().device.setClipboard(options),
+};
+/** 默认 SDK 实例的 navigation 模块。 */
+const navigation = {
+    close: () => getDefaultSDK().navigation.close(),
+    reload: () => getDefaultSDK().navigation.reload(),
+};
 
 const hbSDK = {
     ready,
@@ -903,6 +995,9 @@ const hbSDK = {
     viewport,
     storage,
     network,
+    ui,
+    device,
+    navigation,
 };
 
-export { HbMiniProgramNetworkError, HbMiniProgramSDKError, MiniProgramSDK, auth, createMiniProgramSDK, hbSDK as default, network, off, on, ready, share, storage, user, viewport };
+export { HbMiniProgramNetworkError, HbMiniProgramSDKError, MiniProgramSDK, auth, createMiniProgramSDK, hbSDK as default, device, navigation, network, off, on, ready, share, storage, ui, user, viewport };