@heybox/hb-sdk 0.4.3 → 0.4.5

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 = {};
@@ -3240,65 +3303,6 @@ async function loginAndGetMiniProgramRuntimeUserInfo(platformAdapter) {
     return getMiniProgramRuntimeUserInfo(platformAdapter);
 }
 
-function getMiniProgramRuntimeWindowInfo(platformAdapter) {
-    const metrics = platformAdapter.viewport.getViewportMetrics();
-    const windowWidth = getViewportWidth(metrics);
-    const windowHeight = getViewportHeight(metrics);
-    const screenWidth = getPositiveNumber(metrics.screenWidth, windowWidth);
-    const screenHeight = getPositiveNumber(metrics.screenHeight, windowHeight);
-    const navigationBarHeight = getNavigationBarHeight(platformAdapter);
-    const safeAreaHeight = Math.max(windowHeight - navigationBarHeight, 0);
-    return {
-        pixelRatio: getPositiveNumber(metrics.pixelRatio, 1),
-        screenWidth,
-        screenHeight,
-        windowWidth,
-        windowHeight,
-        statusBarHeight: navigationBarHeight,
-        safeArea: {
-            left: 0,
-            right: windowWidth,
-            top: navigationBarHeight,
-            bottom: windowHeight,
-            width: windowWidth,
-            height: safeAreaHeight,
-        },
-        screenTop: navigationBarHeight,
-    };
-}
-function getMiniProgramRuntimeViewportRect(platformAdapter) {
-    const metrics = platformAdapter.viewport.getViewportMetrics();
-    const width = getPositiveNumber(metrics.innerWidth, getPositiveNumber(metrics.documentElementClientWidth, 0));
-    const height = getPositiveNumber(metrics.innerHeight, getPositiveNumber(metrics.documentElementClientHeight, 0));
-    return {
-        left: 0,
-        top: 0,
-        width,
-        height,
-    };
-}
-function getNavigationBarHeight(platformAdapter) {
-    try {
-        return platformAdapter.viewport.getNavigationBarHeight();
-    }
-    catch {
-        return 0;
-    }
-}
-function getViewportWidth(metrics) {
-    return getPositiveNumber(metrics.innerWidth, getPositiveNumber(metrics.documentElementClientWidth, 0));
-}
-function getViewportHeight(metrics) {
-    return getPositiveNumber(metrics.innerHeight, getPositiveNumber(metrics.documentElementClientHeight, 0));
-}
-function getPositiveNumber(value, fallback) {
-    const numberValue = Number(value);
-    if (!Number.isFinite(numberValue) || numberValue <= 0) {
-        return fallback;
-    }
-    return numberValue;
-}
-
 const DEFAULT_STORAGE_KEY_MAX_LENGTH = 128;
 const STORAGE_KEY_CHAR_RE = /^[A-Za-z0-9_-]+$/;
 function createMiniProgramRuntimeBridgeError(code, message, data) {
@@ -3384,86 +3388,292 @@ function stringifyMiniProgramRuntimeJsonData(data, options) {
     return value;
 }
 
-/** 设置导航栏关闭按钮与状态栏图标/文字的前景样式。 */
-function setMiniProgramRuntimeNavigationBarStyle(payload, platformAdapter) {
-    return platformAdapter.viewport.setNavigationBarStyle(readMiniProgramNavigationBarStyleOptions(payload));
+const NETWORK_REQUEST_ALLOWED_KEYS = new Set([
+    'url',
+    'method',
+    'params',
+    'data',
+    'headers',
+    'timeout',
+    'withCredentials',
+]);
+const NETWORK_REQUEST_MAX_TIMEOUT = 30000;
+const NETWORK_REQUEST_MAX_BODY_BYTES = 2 * 1024 * 1024;
+const NETWORK_REQUEST_DENIED_HEADERS = new Set([
+    'authorization',
+    'connection',
+    'content-length',
+    'cookie',
+    'host',
+    'origin',
+    'proxy-authorization',
+    'referer',
+    'set-cookie',
+    'transfer-encoding',
+    'user-agent',
+]);
+const NETWORK_HTTP_METHODS = new Set([
+    'GET',
+    'POST',
+    'PUT',
+    'PATCH',
+    'DELETE',
+    'HEAD',
+    'OPTIONS',
+]);
+/** network.request：校验桥接参数并委托平台适配层完成真实 HTTP 交换。 */
+async function requestMiniProgramRuntimeNetwork(payload, platformAdapter) {
+    return platformAdapter.network.request(readMiniProgramRuntimeNetworkRequest(payload));
 }
-function readMiniProgramNavigationBarStyleOptions(payload) {
-    assertMiniProgramRuntimeRecord(payload, 'viewport.setNavigationBarStyle 参数必须是对象');
-    const foregroundStyle = payload.foregroundStyle;
-    if (!isNavigationBarForegroundStyle(foregroundStyle)) {
-        throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', 'viewport.setNavigationBarStyle foregroundStyle 必须是 light 或 dark');
-    }
-    return {
-        foregroundStyle,
+function readMiniProgramRuntimeNetworkRequest(payload) {
+    assertMiniProgramRuntimeRecord(payload, 'network.request 参数必须是对象');
+    assertNetworkAllowedKeys(payload);
+    const request = {
+        url: readNetworkRequestUrl(payload.url),
     };
+    if (payload.method !== undefined) {
+        request.method = readNetworkMethod(payload.method);
+    }
+    if (payload.params !== undefined) {
+        request.params = readUnknownRecord(payload.params, 'network.request params 必须是对象');
+    }
+    if (payload.data !== undefined) {
+        assertNetworkRequestBody(payload.data);
+        request.data = payload.data;
+    }
+    if (payload.headers !== undefined) {
+        request.headers = readNetworkRequestHeaders(payload.headers);
+    }
+    if (payload.timeout !== undefined) {
+        request.timeout = readMiniProgramRuntimeNonNegativeNumber(payload.timeout, 'network.request timeout 必须是非负数字');
+        if (request.timeout > NETWORK_REQUEST_MAX_TIMEOUT) {
+            throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', `network.request timeout 不能超过 ${NETWORK_REQUEST_MAX_TIMEOUT}ms`);
+        }
+    }
+    if (payload.withCredentials !== undefined) {
+        request.withCredentials = readMiniProgramRuntimeBoolean(payload.withCredentials, 'network.request withCredentials 必须是布尔值');
+    }
+    return request;
 }
-function isNavigationBarForegroundStyle(value) {
-    return value === 'light' || value === 'dark';
-}
-
-/** 展示基础分享面板。 */
-function showMiniProgramRuntimeShareMenu(payload, platformAdapter) {
-    return platformAdapter.share.showShareMenu(readMiniProgramShareMenuOptions(payload));
-}
-function readMiniProgramShareMenuOptions(payload) {
-    assertMiniProgramRuntimeRecord(payload, 'share.showShareMenu 参数必须是对象');
-    const title = readMiniProgramRuntimeRequiredString(payload.title, 'share.showShareMenu title 必须是非空字符串');
-    const desc = readMiniProgramRuntimeRequiredString(payload.desc, 'share.showShareMenu desc 必须是非空字符串');
-    const url = readMiniProgramRuntimeHttpUrl(payload.url, 'share.showShareMenu url 必须是 HTTP(S) URL');
-    const imageUrl = payload.imageUrl === undefined
-        ? undefined
-        : readMiniProgramRuntimeHttpUrl(payload.imageUrl, 'share.showShareMenu imageUrl 必须是 HTTP(S) URL');
-    const channel = payload.channel;
-    if (channel !== undefined && !isShareChannel(channel)) {
-        throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', 'share.showShareMenu channel 不合法');
+function assertNetworkAllowedKeys(payload) {
+    const invalidKeys = Object.keys(payload).filter(key => !NETWORK_REQUEST_ALLOWED_KEYS.has(key));
+    if (invalidKeys.length > 0) {
+        throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', `network.request 不支持字段: ${invalidKeys.join(', ')}`);
     }
-    return {
-        title,
-        desc,
-        url,
-        imageUrl,
-        channel,
-    };
 }
-function isShareChannel(value) {
-    return (value === 'wechatSession' ||
-        value === 'wechatTimeline' ||
-        value === 'qqFriend' ||
-        value === 'qzone' ||
-        value === 'weibo');
+function readNetworkRequestUrl(value) {
+    const requestUrl = readMiniProgramRuntimeHttpUrl(value, 'network.request url 必须是 HTTP(S) URL');
+    assertPublicNetworkRequestUrl(requestUrl);
+    return requestUrl;
 }
-
-/** 截图并唤起分享。 */
-function shareMiniProgramRuntimeScreenshot(payload, platformAdapter) {
-    const options = readMiniProgramScreenshotOptions(payload);
-    const rect = options.rect || getMiniProgramRuntimeViewportRect(platformAdapter);
-    return platformAdapter.share.shareScreenshot({
-        rect,
-        delay: options.delay,
-        saveToAlbum: options.saveToAlbum,
-    });
+function assertPublicNetworkRequestUrl(requestUrl) {
+    const url = new URL(requestUrl);
+    if (url.username || url.password) {
+        throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', 'network.request url 不允许包含用户信息');
+    }
+    if (isUnsafeNetworkHost(url.hostname)) {
+        throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', 'network.request url 不允许指向本机、内网或保留地址');
+    }
 }
-function readMiniProgramScreenshotOptions(payload) {
-    if (payload === undefined || payload === null) {
-        return {};
+function isUnsafeNetworkHost(hostname) {
+    const normalizedHost = hostname.toLowerCase();
+    const ipv6Host = normalizedHost.startsWith('[') && normalizedHost.endsWith(']')
+        ? normalizedHost.slice(1, -1)
+        : normalizedHost;
+    if (normalizedHost === 'localhost' ||
+        normalizedHost.endsWith('.localhost') ||
+        normalizedHost.endsWith('.local') ||
+        normalizedHost === 'metadata.google.internal') {
+        return true;
     }
-    assertMiniProgramRuntimeRecord(payload, 'share.screenshot 参数必须是对象');
-    const options = {};
-    if (payload.rect !== undefined) {
-        options.rect = readScreenshotRect(payload.rect);
+    if (isUnsafeIPv4Host(normalizedHost)) {
+        return true;
     }
-    if (payload.delay !== undefined) {
-        options.delay = readMiniProgramRuntimeNonNegativeNumber(payload.delay, 'share.screenshot delay 必须是非负数字');
+    return isUnsafeIPv6Host(ipv6Host);
+}
+function isUnsafeIPv4Host(hostname) {
+    if (!/^\d{1,3}(\.\d{1,3}){3}$/.test(hostname)) {
+        return false;
     }
-    if (payload.saveToAlbum !== undefined) {
-        options.saveToAlbum = readMiniProgramRuntimeBoolean(payload.saveToAlbum, 'share.screenshot saveToAlbum 必须是布尔值');
+    const parts = hostname.split('.').map(part => Number(part));
+    if (parts.some(part => !Number.isInteger(part) || part < 0 || part > 255)) {
+        return true;
     }
-    return options;
+    const [a, b] = parts;
+    return (a === 0 ||
+        a === 10 ||
+        a === 127 ||
+        (a === 100 && b >= 64 && b <= 127) ||
+        (a === 169 && b === 254) ||
+        (a === 172 && b >= 16 && b <= 31) ||
+        (a === 192 && b === 168));
 }
-function readScreenshotRect(value) {
-    assertMiniProgramRuntimeRecord(value, 'share.screenshot rect 必须是对象');
-    const left = readMiniProgramRuntimeNonNegativeNumber(value.left, 'share.screenshot rect.left 必须是非负数字');
+function isUnsafeIPv6Host(hostname) {
+    return (hostname === '::' ||
+        hostname === '::1' ||
+        hostname.startsWith('fc') ||
+        hostname.startsWith('fd') ||
+        hostname.startsWith('fe80:'));
+}
+function readNetworkRequestHeaders(value) {
+    const headers = readStringRecord(value, 'network.request headers 必须是 Record<string, string>');
+    const deniedHeader = Object.keys(headers).find(isDeniedNetworkRequestHeader);
+    if (deniedHeader) {
+        throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', `network.request 不允许设置敏感请求头: ${deniedHeader}`);
+    }
+    return headers;
+}
+function isDeniedNetworkRequestHeader(headerName) {
+    const normalizedHeaderName = headerName.trim().toLowerCase();
+    return (NETWORK_REQUEST_DENIED_HEADERS.has(normalizedHeaderName) ||
+        normalizedHeaderName.startsWith('x-heybox-') ||
+        normalizedHeaderName.startsWith('x-xhh-'));
+}
+function assertNetworkRequestBody(data) {
+    if (isUnsupportedNetworkRequestBody(data)) {
+        throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', 'network.request data 不支持 File、Blob 或 FormData，请使用专用上传能力');
+    }
+    const bodyBytes = estimateNetworkRequestBodyBytes(data);
+    if (bodyBytes > NETWORK_REQUEST_MAX_BODY_BYTES) {
+        throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', `network.request data 不能超过 ${NETWORK_REQUEST_MAX_BODY_BYTES} 字节`);
+    }
+}
+function isUnsupportedNetworkRequestBody(data) {
+    return ((typeof Blob !== 'undefined' && data instanceof Blob) ||
+        (typeof FormData !== 'undefined' && data instanceof FormData));
+}
+function estimateNetworkRequestBodyBytes(data) {
+    if (typeof data === 'string') {
+        return getMiniProgramRuntimeUtf8ByteLength(data);
+    }
+    if (data instanceof ArrayBuffer) {
+        return data.byteLength;
+    }
+    if (ArrayBuffer.isView(data)) {
+        return data.byteLength;
+    }
+    if (typeof URLSearchParams !== 'undefined' && data instanceof URLSearchParams) {
+        return getMiniProgramRuntimeUtf8ByteLength(data.toString());
+    }
+    try {
+        const serialized = JSON.stringify(data);
+        return serialized ? getMiniProgramRuntimeUtf8ByteLength(serialized) : 0;
+    }
+    catch {
+        throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', 'network.request data 必须可序列化');
+    }
+}
+function readNetworkMethod(value) {
+    const method = readMiniProgramRuntimeRequiredString(value, 'network.request method 必须是字符串').trim().toUpperCase();
+    if (!NETWORK_HTTP_METHODS.has(method)) {
+        throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', 'network.request method 不合法');
+    }
+    return method;
+}
+function readUnknownRecord(value, message) {
+    assertMiniProgramRuntimeRecord(value, message);
+    return { ...value };
+}
+function readStringRecord(value, message) {
+    assertMiniProgramRuntimeRecord(value, message);
+    return Object.entries(value).reduce((headers, [key, headerValue]) => {
+        if (!key.trim() || typeof headerValue !== 'string') {
+            throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', message);
+        }
+        headers[key] = headerValue;
+        return headers;
+    }, {});
+}
+
+function getMiniProgramRuntimeWindowInfo(platformAdapter) {
+    const metrics = platformAdapter.viewport.getViewportMetrics();
+    const windowWidth = getViewportWidth(metrics);
+    const windowHeight = getViewportHeight(metrics);
+    const screenWidth = getPositiveNumber(metrics.screenWidth, windowWidth);
+    const screenHeight = getPositiveNumber(metrics.screenHeight, windowHeight);
+    const navigationBarHeight = getNavigationBarHeight(platformAdapter);
+    const safeAreaHeight = Math.max(windowHeight - navigationBarHeight, 0);
+    return {
+        pixelRatio: getPositiveNumber(metrics.pixelRatio, 1),
+        screenWidth,
+        screenHeight,
+        windowWidth,
+        windowHeight,
+        statusBarHeight: navigationBarHeight,
+        safeArea: {
+            left: 0,
+            right: windowWidth,
+            top: navigationBarHeight,
+            bottom: windowHeight,
+            width: windowWidth,
+            height: safeAreaHeight,
+        },
+        screenTop: navigationBarHeight,
+    };
+}
+function getMiniProgramRuntimeViewportRect(platformAdapter) {
+    const metrics = platformAdapter.viewport.getViewportMetrics();
+    const width = getPositiveNumber(metrics.innerWidth, getPositiveNumber(metrics.documentElementClientWidth, 0));
+    const height = getPositiveNumber(metrics.innerHeight, getPositiveNumber(metrics.documentElementClientHeight, 0));
+    return {
+        left: 0,
+        top: 0,
+        width,
+        height,
+    };
+}
+function getNavigationBarHeight(platformAdapter) {
+    try {
+        return platformAdapter.viewport.getNavigationBarHeight();
+    }
+    catch {
+        return 0;
+    }
+}
+function getViewportWidth(metrics) {
+    return getPositiveNumber(metrics.innerWidth, getPositiveNumber(metrics.documentElementClientWidth, 0));
+}
+function getViewportHeight(metrics) {
+    return getPositiveNumber(metrics.innerHeight, getPositiveNumber(metrics.documentElementClientHeight, 0));
+}
+function getPositiveNumber(value, fallback) {
+    const numberValue = Number(value);
+    if (!Number.isFinite(numberValue) || numberValue <= 0) {
+        return fallback;
+    }
+    return numberValue;
+}
+
+/** 截图并唤起分享。 */
+function shareMiniProgramRuntimeScreenshot(payload, platformAdapter) {
+    const options = readMiniProgramScreenshotOptions(payload);
+    const rect = options.rect || getMiniProgramRuntimeViewportRect(platformAdapter);
+    return platformAdapter.share.shareScreenshot({
+        rect,
+        delay: options.delay,
+        saveToAlbum: options.saveToAlbum,
+    });
+}
+function readMiniProgramScreenshotOptions(payload) {
+    if (payload === undefined || payload === null) {
+        return {};
+    }
+    assertMiniProgramRuntimeRecord(payload, 'share.screenshot 参数必须是对象');
+    const options = {};
+    if (payload.rect !== undefined) {
+        options.rect = readScreenshotRect(payload.rect);
+    }
+    if (payload.delay !== undefined) {
+        options.delay = readMiniProgramRuntimeNonNegativeNumber(payload.delay, 'share.screenshot delay 必须是非负数字');
+    }
+    if (payload.saveToAlbum !== undefined) {
+        options.saveToAlbum = readMiniProgramRuntimeBoolean(payload.saveToAlbum, 'share.screenshot saveToAlbum 必须是布尔值');
+    }
+    return options;
+}
+function readScreenshotRect(value) {
+    assertMiniProgramRuntimeRecord(value, 'share.screenshot rect 必须是对象');
+    const left = readMiniProgramRuntimeNonNegativeNumber(value.left, 'share.screenshot rect.left 必须是非负数字');
     const top = readMiniProgramRuntimeNonNegativeNumber(value.top, 'share.screenshot rect.top 必须是非负数字');
     const width = readMiniProgramRuntimePositiveNumber(value.width, 'share.screenshot rect.width 必须是正数');
     const height = readMiniProgramRuntimePositiveNumber(value.height, 'share.screenshot rect.height 必须是正数');
@@ -3475,6 +3685,38 @@ function readScreenshotRect(value) {
     };
 }
 
+/** 展示基础分享面板。 */
+function showMiniProgramRuntimeShareMenu(payload, platformAdapter) {
+    return platformAdapter.share.showShareMenu(readMiniProgramShareMenuOptions(payload));
+}
+function readMiniProgramShareMenuOptions(payload) {
+    assertMiniProgramRuntimeRecord(payload, 'share.showShareMenu 参数必须是对象');
+    const title = readMiniProgramRuntimeRequiredString(payload.title, 'share.showShareMenu title 必须是非空字符串');
+    const desc = readMiniProgramRuntimeRequiredString(payload.desc, 'share.showShareMenu desc 必须是非空字符串');
+    const url = readMiniProgramRuntimeHttpUrl(payload.url, 'share.showShareMenu url 必须是 HTTP(S) URL');
+    const imageUrl = payload.imageUrl === undefined
+        ? undefined
+        : readMiniProgramRuntimeHttpUrl(payload.imageUrl, 'share.showShareMenu imageUrl 必须是 HTTP(S) URL');
+    const channel = payload.channel;
+    if (channel !== undefined && !isShareChannel(channel)) {
+        throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', 'share.showShareMenu channel 不合法');
+    }
+    return {
+        title,
+        desc,
+        url,
+        imageUrl,
+        channel,
+    };
+}
+function isShareChannel(value) {
+    return (value === 'wechatSession' ||
+        value === 'wechatTimeline' ||
+        value === 'qqFriend' ||
+        value === 'qzone' ||
+        value === 'weibo');
+}
+
 /** 获取小程序隔离 storage。 */
 function getMiniProgramRuntimeStorage(payload, options, platformAdapter) {
     const { key } = readMiniProgramGetStoragePayload(payload, options.maxKeyLength);
@@ -3565,227 +3807,189 @@ function hashString(value) {
     return (hash >>> 0).toString(36);
 }
 
-const NETWORK_REQUEST_ALLOWED_KEYS = new Set([
-    'url',
-    'method',
-    'params',
-    'data',
-    'headers',
-    'timeout',
-    'withCredentials',
-]);
-const NETWORK_REQUEST_MAX_TIMEOUT = 30000;
-const NETWORK_REQUEST_MAX_BODY_BYTES = 2 * 1024 * 1024;
-const NETWORK_REQUEST_DENIED_HEADERS = new Set([
-    'authorization',
-    'connection',
-    'content-length',
-    'cookie',
-    'host',
-    'origin',
-    'proxy-authorization',
-    'referer',
-    'set-cookie',
-    'transfer-encoding',
-    'user-agent',
-]);
-const NETWORK_HTTP_METHODS = new Set([
-    'GET',
-    'POST',
-    'PUT',
-    'PATCH',
-    'DELETE',
-    'HEAD',
-    'OPTIONS',
-]);
-/** network.request：校验桥接参数并委托平台适配层完成真实 HTTP 交换。 */
-async function requestMiniProgramRuntimeNetwork(payload, platformAdapter) {
-    return platformAdapter.network.request(readMiniProgramRuntimeNetworkRequest(payload));
-}
-function readMiniProgramRuntimeNetworkRequest(payload) {
-    assertMiniProgramRuntimeRecord(payload, 'network.request 参数必须是对象');
-    assertNetworkAllowedKeys(payload);
-    const request = {
-        url: readNetworkRequestUrl(payload.url),
-    };
-    if (payload.method !== undefined) {
-        request.method = readNetworkMethod(payload.method);
-    }
-    if (payload.params !== undefined) {
-        request.params = readUnknownRecord(payload.params, 'network.request params 必须是对象');
-    }
-    if (payload.data !== undefined) {
-        assertNetworkRequestBody(payload.data);
-        request.data = payload.data;
-    }
-    if (payload.headers !== undefined) {
-        request.headers = readNetworkRequestHeaders(payload.headers);
-    }
-    if (payload.timeout !== undefined) {
-        request.timeout = readMiniProgramRuntimeNonNegativeNumber(payload.timeout, 'network.request timeout 必须是非负数字');
-        if (request.timeout > NETWORK_REQUEST_MAX_TIMEOUT) {
-            throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', `network.request timeout 不能超过 ${NETWORK_REQUEST_MAX_TIMEOUT}ms`);
-        }
-    }
-    if (payload.withCredentials !== undefined) {
-        request.withCredentials = readMiniProgramRuntimeBoolean(payload.withCredentials, 'network.request withCredentials 必须是布尔值');
-    }
-    return request;
-}
-function assertNetworkAllowedKeys(payload) {
-    const invalidKeys = Object.keys(payload).filter(key => !NETWORK_REQUEST_ALLOWED_KEYS.has(key));
-    if (invalidKeys.length > 0) {
-        throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', `network.request 不支持字段: ${invalidKeys.join(', ')}`);
-    }
-}
-function readNetworkRequestUrl(value) {
-    const requestUrl = readMiniProgramRuntimeHttpUrl(value, 'network.request url 必须是 HTTP(S) URL');
-    assertPublicNetworkRequestUrl(requestUrl);
-    return requestUrl;
-}
-function assertPublicNetworkRequestUrl(requestUrl) {
-    const url = new URL(requestUrl);
-    if (url.username || url.password) {
-        throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', 'network.request url 不允许包含用户信息');
-    }
-    if (isUnsafeNetworkHost(url.hostname)) {
-        throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', 'network.request url 不允许指向本机、内网或保留地址');
-    }
-}
-function isUnsafeNetworkHost(hostname) {
-    const normalizedHost = hostname.toLowerCase();
-    const ipv6Host = normalizedHost.startsWith('[') && normalizedHost.endsWith(']')
-        ? normalizedHost.slice(1, -1)
-        : normalizedHost;
-    if (normalizedHost === 'localhost' ||
-        normalizedHost.endsWith('.localhost') ||
-        normalizedHost.endsWith('.local') ||
-        normalizedHost === 'metadata.google.internal') {
-        return true;
-    }
-    if (isUnsafeIPv4Host(normalizedHost)) {
-        return true;
-    }
-    return isUnsafeIPv6Host(ipv6Host);
-}
-function isUnsafeIPv4Host(hostname) {
-    if (!/^\d{1,3}(\.\d{1,3}){3}$/.test(hostname)) {
-        return false;
-    }
-    const parts = hostname.split('.').map(part => Number(part));
-    if (parts.some(part => !Number.isInteger(part) || part < 0 || part > 255)) {
-        return true;
-    }
-    const [a, b] = parts;
-    return (a === 0 ||
-        a === 10 ||
-        a === 127 ||
-        (a === 100 && b >= 64 && b <= 127) ||
-        (a === 169 && b === 254) ||
-        (a === 172 && b >= 16 && b <= 31) ||
-        (a === 192 && b === 168));
-}
-function isUnsafeIPv6Host(hostname) {
-    return (hostname === '::' ||
-        hostname === '::1' ||
-        hostname.startsWith('fc') ||
-        hostname.startsWith('fd') ||
-        hostname.startsWith('fe80:'));
-}
-function readNetworkRequestHeaders(value) {
-    const headers = readStringRecord(value, 'network.request headers 必须是 Record<string, string>');
-    const deniedHeader = Object.keys(headers).find(isDeniedNetworkRequestHeader);
-    if (deniedHeader) {
-        throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', `network.request 不允许设置敏感请求头: ${deniedHeader}`);
-    }
-    return headers;
-}
-function isDeniedNetworkRequestHeader(headerName) {
-    const normalizedHeaderName = headerName.trim().toLowerCase();
-    return (NETWORK_REQUEST_DENIED_HEADERS.has(normalizedHeaderName) ||
-        normalizedHeaderName.startsWith('x-heybox-') ||
-        normalizedHeaderName.startsWith('x-xhh-'));
-}
-function assertNetworkRequestBody(data) {
-    if (isUnsupportedNetworkRequestBody(data)) {
-        throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', 'network.request data 不支持 File、Blob 或 FormData，请使用专用上传能力');
-    }
-    const bodyBytes = estimateNetworkRequestBodyBytes(data);
-    if (bodyBytes > NETWORK_REQUEST_MAX_BODY_BYTES) {
-        throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', `network.request data 不能超过 ${NETWORK_REQUEST_MAX_BODY_BYTES} 字节`);
-    }
-}
-function isUnsupportedNetworkRequestBody(data) {
-    return ((typeof Blob !== 'undefined' && data instanceof Blob) ||
-        (typeof FormData !== 'undefined' && data instanceof FormData));
-}
-function estimateNetworkRequestBodyBytes(data) {
-    if (typeof data === 'string') {
-        return getMiniProgramRuntimeUtf8ByteLength(data);
-    }
-    if (data instanceof ArrayBuffer) {
-        return data.byteLength;
-    }
-    if (ArrayBuffer.isView(data)) {
-        return data.byteLength;
-    }
-    if (typeof URLSearchParams !== 'undefined' && data instanceof URLSearchParams) {
-        return getMiniProgramRuntimeUtf8ByteLength(data.toString());
-    }
-    try {
-        const serialized = JSON.stringify(data);
-        return serialized ? getMiniProgramRuntimeUtf8ByteLength(serialized) : 0;
-    }
-    catch {
-        throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', 'network.request data 必须可序列化');
-    }
-}
-function readNetworkMethod(value) {
-    const method = readMiniProgramRuntimeRequiredString(value, 'network.request method 必须是字符串').trim().toUpperCase();
-    if (!NETWORK_HTTP_METHODS.has(method)) {
-        throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', 'network.request method 不合法');
-    }
-    return method;
+/** 设置导航栏关闭按钮与状态栏图标/文字的前景样式。 */
+function setMiniProgramRuntimeNavigationBarStyle(payload, platformAdapter) {
+    return platformAdapter.viewport.setNavigationBarStyle(readMiniProgramNavigationBarStyleOptions(payload));
 }
-function readUnknownRecord(value, message) {
-    assertMiniProgramRuntimeRecord(value, message);
-    return { ...value };
+function readMiniProgramNavigationBarStyleOptions(payload) {
+    assertMiniProgramRuntimeRecord(payload, 'viewport.setNavigationBarStyle 参数必须是对象');
+    const foregroundStyle = payload.foregroundStyle;
+    if (!isNavigationBarForegroundStyle(foregroundStyle)) {
+        throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', 'viewport.setNavigationBarStyle foregroundStyle 必须是 light 或 dark');
+    }
+    return {
+        foregroundStyle,
+    };
 }
-function readStringRecord(value, message) {
-    assertMiniProgramRuntimeRecord(value, message);
-    return Object.entries(value).reduce((headers, [key, headerValue]) => {
-        if (!key.trim() || typeof headerValue !== 'string') {
-            throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', message);
-        }
-        headers[key] = headerValue;
-        return headers;
-    }, {});
+function isNavigationBarForegroundStyle(value) {
+    return value === 'light' || value === 'dark';
 }
 
-const MINI_PROGRAM_MOCK_RUNTIME_METHODS = MINI_PROGRAM_PROTOCOL_CAPABILITIES.map(capability => capability.method);
+const MINI_PROGRAM_MOCK_RUNTIME_METHODS = MINI_PROGRAM_PROTOCOL_CAPABILITIES.map((capability) => capability.method);
 const MINI_PROGRAM_MOCK_RUNTIME_METHOD_HANDLERS = {
-    [AUTH_LOGIN_METHOD]: runtime => runtime.login(),
-    [USER_GET_INFO_METHOD]: runtime => runtime.getUserInfo(),
+    [AUTH_LOGIN_METHOD]: (runtime) => runtime.login(),
+    [USER_GET_INFO_METHOD]: (runtime) => runtime.getUserInfo(),
     [SHARE_SHOW_SHARE_MENU_METHOD]: (runtime, payload) => runtime.showShareMenu(payload),
     [SHARE_SCREENSHOT_METHOD]: (runtime, payload) => runtime.shareScreenshot(payload),
-    [VIEWPORT_GET_WINDOW_INFO_METHOD]: runtime => runtime.getWindowInfo(),
+    [VIEWPORT_GET_WINDOW_INFO_METHOD]: (runtime) => runtime.getWindowInfo(),
     [VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD]: (runtime, payload) => runtime.setNavigationBarStyle(payload),
     [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),
 };
+function createBrowserMockRuntimePlatformAdapter(options) {
+    return {
+        app: {
+            getCurrentHref: options.getCurrentHref,
+        },
+        launch: {
+            async getMiniProgramInfo() {
+                return {
+                    pageUrl: options.getMiniProgramPageUrl(),
+                };
+            },
+        },
+        auth: {
+            async getCurrentUserId() {
+                return options.getCurrentUser()?.heybox_id;
+            },
+            async login() {
+                await options.login();
+            },
+        },
+        user: {
+            async getUserBasicInfo(userId) {
+                const currentUser = options.getCurrentUser();
+                if (!currentUser || currentUser.heybox_id !== userId) {
+                    return undefined;
+                }
+                return {
+                    nickname: currentUser.nickname,
+                    avatar: currentUser.avatar,
+                };
+            },
+        },
+        share: {
+            async showShareMenu(params) {
+                return {
+                    ok: true,
+                    platform: 'hb-sdk-mock-host',
+                    type: 'showShareMenu',
+                    params,
+                };
+            },
+            async shareScreenshot(params) {
+                return {
+                    ok: true,
+                    platform: 'hb-sdk-mock-host',
+                    type: 'screenshot',
+                    params,
+                };
+            },
+        },
+        viewport: {
+            setDocumentTitle(title) {
+                options.setDocumentTitle?.(title);
+            },
+            setNavigationBarStyle(styleOptions) {
+                return options.setNavigationBarStyle?.(styleOptions);
+            },
+            getViewportMetrics() {
+                const rect = options.iframe.getBoundingClientRect();
+                const width = Math.max(1, Math.round(rect.width));
+                const height = Math.max(1, Math.round(rect.height));
+                const currentWindow = options.iframe.ownerDocument.defaultView ?? readWindow();
+                return {
+                    innerWidth: width,
+                    innerHeight: height,
+                    documentElementClientWidth: width,
+                    documentElementClientHeight: height,
+                    screenWidth: currentWindow?.screen.width || width,
+                    screenHeight: currentWindow?.screen.height || height,
+                    pixelRatio: currentWindow?.devicePixelRatio || 1,
+                };
+            },
+            getNavigationBarHeight() {
+                return 0;
+            },
+        },
+        ui: {
+            async showToast() {
+                return undefined;
+            },
+            async showLoading() {
+                return undefined;
+            },
+            async hideLoading() {
+                return undefined;
+            },
+        },
+        device: {
+            async vibrate() {
+                return undefined;
+            },
+            async setClipboard() {
+                return undefined;
+            },
+        },
+        navigation: {
+            async close() {
+                return undefined;
+            },
+            async reload() {
+                return undefined;
+            },
+        },
+        storage: {
+            getStorage: options.getStorage,
+            setStorage: options.setStorage,
+        },
+        network: {
+            request: options.requestNetwork,
+        },
+    };
+}
 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 +4019,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 +4122,219 @@ 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 rawDelay = payload?.delay;
+    if (rawDelay !== undefined && (typeof rawDelay !== 'number' || !Number.isInteger(rawDelay) || rawDelay < 0 || rawDelay > 5000)) {
+        throw createMockBridgeError('INVALID_PARAMS', 'device.vibrate delay 必须是 0..5000 的整数毫秒');
+    }
+    const delay = rawDelay ?? 0;
+    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 readWindow() {
+    return typeof window === 'undefined' ? undefined : window;
+}
+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';
@@ -3892,8 +4383,30 @@ iframe.src = appendNonce(miniProgramUrl, nonce);
 iframe.allow = 'clipboard-read; clipboard-write';
 elements.device.appendChild(iframe);
 elements.miniUrl.textContent = miniProgramUrl;
-const runtime = new MiniProgramMockRuntime(createBrowserMockRuntimeAdapter(), {
-    onAuthChange: result => postEvent('authChange', result),
+const runtime = new MiniProgramMockRuntime(createBrowserMockRuntimePlatformAdapter({
+    iframe,
+    getCurrentHref: () => location.href,
+    getCurrentUser: () => currentUser,
+    getMiniProgramPageUrl: () => miniProgramUrl,
+    getStorage: ({ key }) => storage.get(key),
+    async login() {
+        currentUser = createUserFromForm();
+        updateUserStatus();
+    },
+    requestNetwork,
+    setDocumentTitle(title) {
+        document.title = title;
+    },
+    setNavigationBarStyle(options) {
+        navigationBarStyle = options.foregroundStyle;
+        document.documentElement.dataset.navigationBarStyle = navigationBarStyle;
+    },
+    async setStorage({ key, value }) {
+        storage.set(key, value);
+        updateStorageSnapshot();
+    },
+}), {
+    onAuthChange: (result) => postEvent('authChange', result),
 });
 updateUserStatus();
 updateStorageSnapshot();
@@ -3925,98 +4438,6 @@ elements.mobileLanSelect.addEventListener('change', () => {
     void updateMobileQrCode();
 });
 const mobileAppQrReady = setupMobileAppQr();
-function createBrowserMockRuntimeAdapter() {
-    return {
-        app: {
-            getCurrentHref() {
-                return location.href;
-            },
-        },
-        launch: {
-            async getMiniProgramInfo() {
-                return {
-                    pageUrl: miniProgramUrl,
-                };
-            },
-        },
-        auth: {
-            async getCurrentUserId() {
-                return currentUser?.heybox_id;
-            },
-            async login() {
-                currentUser = createUserFromForm();
-                updateUserStatus();
-            },
-        },
-        user: {
-            async getUserBasicInfo(userId) {
-                if (!currentUser || currentUser.heybox_id !== userId) {
-                    return undefined;
-                }
-                return {
-                    nickname: currentUser.nickname,
-                    avatar: currentUser.avatar,
-                };
-            },
-        },
-        share: {
-            async showShareMenu(options) {
-                return {
-                    ok: true,
-                    platform: 'hb-sdk-mock-host',
-                    type: 'showShareMenu',
-                    params: options,
-                };
-            },
-            async shareScreenshot(options) {
-                return {
-                    ok: true,
-                    platform: 'hb-sdk-mock-host',
-                    type: 'screenshot',
-                    params: options,
-                };
-            },
-        },
-        viewport: {
-            setDocumentTitle(title) {
-                document.title = title;
-            },
-            setNavigationBarStyle(options) {
-                navigationBarStyle = options.foregroundStyle;
-                document.documentElement.dataset.navigationBarStyle = navigationBarStyle;
-            },
-            getViewportMetrics() {
-                const rect = iframe.getBoundingClientRect();
-                const width = Math.max(1, Math.round(rect.width));
-                const height = Math.max(1, Math.round(rect.height));
-                return {
-                    innerWidth: width,
-                    innerHeight: height,
-                    documentElementClientWidth: width,
-                    documentElementClientHeight: height,
-                    screenWidth: window.screen.width || width,
-                    screenHeight: window.screen.height || height,
-                    pixelRatio: window.devicePixelRatio || 1,
-                };
-            },
-            getNavigationBarHeight() {
-                return 0;
-            },
-        },
-        storage: {
-            getStorage({ key }) {
-                return storage.get(key);
-            },
-            async setStorage({ key, value }) {
-                storage.set(key, value);
-                updateStorageSnapshot();
-            },
-        },
-        network: {
-            request: requestNetwork,
-        },
-    };
-}
 function handleMessage(event) {
     if (event.source !== iframe.contentWindow || !isBridgeMessage(event.data)) {
         return;
@@ -4086,9 +4507,7 @@ async function readNetworkProxyResponse(response) {
     catch {
         throw {
             code: response.status === 404 ? 'MOCK_NETWORK_PROXY_NOT_FOUND' : 'MOCK_NETWORK_PROXY_ERROR',
-            message: response.status === 404
-                ? 'mock network proxy 不可用，请重启 hb-sdk dev'
-                : text,
+            message: response.status === 404 ? 'mock network proxy 不可用，请重启 hb-sdk dev' : text,
         };
     }
 }
@@ -4325,7 +4744,7 @@ function pushLog(method, detail) {
     });
     logs.splice(30);
     elements.logs.innerHTML = logs
-        .map(log => `<article class="log"><strong>${escapeHtml(log.method)} · ${escapeHtml(log.timestamp)}</strong><pre>${escapeHtml(JSON.stringify(log.detail, null, 2))}</pre></article>`)
+        .map((log) => `<article class="log"><strong>${escapeHtml(log.method)} · ${escapeHtml(log.timestamp)}</strong><pre>${escapeHtml(JSON.stringify(log.detail, null, 2))}</pre></article>`)
         .join('');
 }
 function appendNonce(input, value) {
@@ -4366,10 +4785,5 @@ function isRecord(value) {
     return typeof value === 'object' && value !== null;
 }
 function escapeHtml(value) {
-    return String(value)
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;')
-        .replace(/'/g, '&#039;');
+    return String(value).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&#039;');
 }