@heybox/hb-sdk 0.9.1-alpha.4 → 0.9.1-alpha.6

package/types/modules/navigation/app-pages/index.d.ts

@@ -1,4 +0,0 @@
-import type { OpenAppPageOptions, OpenAppPagePayload } from './types';
-export type { MiniProgramAppPageTarget, MiniProgramGameDetailGameType, MiniProgramGameDetailPage, OpenAppPageOptions, OpenAppPagePayload, OpenAppPageResult, OpenGameDetailAppPagePayload, OpenGameDetailAppPageOptions, OpenMiniProgramAppPagePayload, OpenMiniProgramAppPageOptions, OpenPostDetailAppPagePayload, OpenPostDetailAppPageOptions, OpenUserDetailAppPagePayload, OpenUserDetailAppPageOptions, } from './types';
-/** 校验并规范化打开黑盒 App 页面参数。 */
-export declare function normalizeOpenAppPageOptions(options: OpenAppPageOptions): OpenAppPagePayload;

package/types/modules/navigation/app-pages/types.d.ts

@@ -1,135 +0,0 @@
-import type { MiniProgramShareExtraValue } from '../../share/types';
-/**
- * 小程序可请求打开的黑盒 App 页面目标。
- *
- * @remarks
- * - `game_detail`：小黑盒游戏详情页。
- * - `user_detail`：小黑盒用户详情页。
- * - `post_detail`：小黑盒帖子详情页，可选定位评论。
- * - `mini_program`：另一个公开发布的小程序。
- *
- * 移动端 Host 支持全部目标；PC Host 支持 `game_detail` 与 `mini_program`。该联合不接受任意
- * URL、scheme、目标版本或内部路由路径，不支持的目标会在 SDK 或 Host 边界明确拒绝。
- */
-export type MiniProgramAppPageTarget = 'game_detail' | 'user_detail' | 'post_detail' | 'mini_program';
-/**
- * 游戏详情的游戏平台类型：`pc`、`console`（主机）或 `mobile`（移动游戏）。
- * 值区分大小写，不接受平台别名。
- */
-export type MiniProgramGameDetailGameType = 'pc' | 'console' | 'mobile';
-/** 游戏详情首屏：`game` 为详情主页，`wiki` 为百科页；省略时由 Host 选择默认页。 */
-export type MiniProgramGameDetailPage = 'game' | 'wiki';
-/**
- * 打开游戏详情页的公共参数。
- *
- * @remarks
- * 当前 PC Host 仅使用规范化后的 `appId` 发起游戏详情导航；`gameType` 仍须合法，但
- * `page`、`hSrc`、`skuId` 等细分提示只在支持它们的 Host 上生效。
- */
-export interface OpenGameDetailAppPageOptions {
-    /** 固定为 `game_detail`。 */
-    target: 'game_detail';
-    /**
-     * 游戏 app ID。字符串会 trim，数字会经 `String(value)` 转换；结果必须非空。
-     * SDK 不校验 ID 是否为整数、是否存在或属于 `gameType`，调用方应传真实目录 ID。
-     */
-    appId: string | number;
-    /** 游戏平台类型；只接受大小写完全一致的 `pc`、`console` 或 `mobile`。 */
-    gameType: MiniProgramGameDetailGameType;
-    /** 首屏子页面；只接受 `game` 或 `wiki`，省略时由 Host 决定。 */
-    page?: MiniProgramGameDetailPage;
-    /** 来源追踪标识；字符串会 trim，JavaScript 数字会字符串化；结果必须非空，省略时不发送。 */
-    hSrc?: string;
-    /**
-     * 商品场景的默认 SKU ID。字符串会 trim，数字会字符串化；结果必须非空，省略时不发送。
-     * 是否展示或选中商品由目标 Host 与游戏详情页能力决定。
-     */
-    skuId?: string | number;
-}
-/** 打开小黑盒用户详情页的公共参数；当前 PC Host 不支持该目标。 */
-export interface OpenUserDetailAppPageOptions {
-    /** 固定为 `user_detail`。 */
-    target: 'user_detail';
-    /**
-     * 用户 `heybox_id`。必须直接传字符串；SDK 会 trim 并拒绝空值，不会像其他 ID 一样接受
-     * number，也不校验用户是否存在。
-     */
-    userId: string;
-}
-/** 打开小黑盒帖子详情页的公共参数；当前 PC Host 不支持该目标。 */
-export interface OpenPostDetailAppPageOptions {
-    /** 固定为 `post_detail`。 */
-    target: 'post_detail';
-    /** 帖子 ID；字符串会 trim，数字会字符串化，结果必须非空。 */
-    linkId: string | number;
-    /** 可选的根评论 ID；字符串会 trim，数字会字符串化，结果必须非空。 */
-    rootCommentId?: string | number;
-    /**
-     * 可选的目标评论 ID；字符串会 trim，数字会字符串化，结果必须非空。
-     * SDK 不要求同时提供 `rootCommentId`，最终定位行为由帖子页决定。
-     */
-    commentId?: string | number;
-}
-/** 打开另一个公开发布小程序的参数。 */
-export interface OpenMiniProgramAppPageOptions {
-    /** 固定为 `mini_program`。 */
-    target: 'mini_program';
-    /** 目标小程序 ID。SDK 会 trim 并拒绝空值；实际可访问性与版本由 Host 决定。 */
-    miniProgramId: string;
-    /**
-     * 可选启动数据。目标小程序通过 `share.getExtra()` 同步读取；省略与显式传入 `null` 含义不同。
-     * 值域、嵌套和 128 字节 MessagePack 上限与分享 `extra` 完全一致。
-     */
-    extra?: MiniProgramShareExtraValue;
-}
-/**
- * 打开黑盒 App 页面的判别联合参数。
- *
- * @remarks
- * `target` 决定其余必填字段。`options` 必须是非 null、非数组的对象；SDK 会在 bridge 前
- * 校验已知字段，并把 `appId`、`skuId`、`linkId` 和评论 ID 规范化为字符串。空字符串、
- * 非法枚举或与 `target` 不匹配的必填字段会以 `INVALID_PARAMS` 拒绝，且不会调用 Host。
- * 对允许 number 的 ID，SDK 只执行 `String(value).trim()`，不校验有限值、整数、正负、长度
- * 或资源是否存在；业务应传真实的有限 ID，不要依赖 `NaN`、`Infinity` 等字符串化结果。
- *
- * 每个目标只会转发上方列出的白名单字段。额外的 `url`、`path`、`scheme`、`windowId` 或
- * 其他未知字段会被丢弃，不能用于打开任意页面或覆盖 Runtime 构造的受控路由。
- *
- * @see [navigation.openAppPage](/reference/sdk/navigation/openAppPage)
- */
-export type OpenAppPageOptions = OpenGameDetailAppPageOptions | OpenUserDetailAppPageOptions | OpenPostDetailAppPageOptions | OpenMiniProgramAppPageOptions;
-/**
- * 打开游戏详情页的规范化 bridge payload；`appId` 与可选 `skuId` 已转换为非空字符串。
- */
-export type OpenGameDetailAppPagePayload = Omit<OpenGameDetailAppPageOptions, 'appId' | 'skuId'> & {
-    appId: string;
-    skuId?: string;
-};
-/** 打开用户详情页的规范化 bridge payload；`userId` 已 trim 为非空字符串。 */
-export type OpenUserDetailAppPagePayload = Omit<OpenUserDetailAppPageOptions, 'userId'> & {
-    userId: string;
-};
-/** 打开帖子详情页的规范化 bridge payload；帖子与评论 ID 均为非空字符串。 */
-export type OpenPostDetailAppPagePayload = Omit<OpenPostDetailAppPageOptions, 'linkId' | 'rootCommentId' | 'commentId'> & {
-    linkId: string;
-    rootCommentId?: string;
-    commentId?: string;
-};
-/** 打开目标小程序的规范化 bridge payload；`miniProgramId` 已 trim。 */
-export type OpenMiniProgramAppPagePayload = Omit<OpenMiniProgramAppPageOptions, 'miniProgramId'> & {
-    miniProgramId: string;
-};
-/**
- * `navigation.openAppPage` 发送给 Host Runtime 的判别联合 payload。
- *
- * @remarks 只包含目标白名单字段；Runtime 会再次校验并构造固定的 Host 页面路由。
- */
-export type OpenAppPagePayload = OpenGameDetailAppPagePayload | OpenUserDetailAppPagePayload | OpenPostDetailAppPagePayload | OpenMiniProgramAppPagePayload;
-/**
- * `navigation.openAppPage` 成功时 resolve `undefined`。
- *
- * @remarks
- * 成功表示 Host 已接收参数并发起路由，不表示目标页加载完成，也不返回目标页数据、关闭结果
- * 或返回当前小程序时的回调值。
- */
-export type OpenAppPageResult = void;

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

@@ -1,312 +0,0 @@
-import type { MiniProgramRequester } from '../../core/client';
-import { type OpenAppPageOptions } from './app-pages';
-export { NAVIGATION_CLOSE_METHOD, NAVIGATION_OPEN_APP_PAGE_METHOD, NAVIGATION_RELOAD_METHOD } from '../../protocol/capabilities';
-export type { MiniProgramAppPageTarget, MiniProgramGameDetailGameType, MiniProgramGameDetailPage, OpenAppPageOptions, OpenAppPagePayload, OpenAppPageResult, OpenGameDetailAppPagePayload, OpenGameDetailAppPageOptions, OpenMiniProgramAppPagePayload, OpenMiniProgramAppPageOptions, OpenPostDetailAppPagePayload, OpenPostDetailAppPageOptions, OpenUserDetailAppPagePayload, OpenUserDetailAppPageOptions, } from './app-pages';
-/**
- * `navigation.close` 的无参 payload。
- *
- * @remarks
- * App-facing API 必须以 `close()` 调用，不能传入强制关闭、关闭原因或窗口标识。Host Runtime
- * 为兼容 bridge 调用会接受 `undefined` 或空普通对象；非空对象、数组和其他值会以
- * `INVALID_PARAMS` 拒绝。
- *
- * @see [navigation.close](/reference/sdk/navigation/close)
- */
-export type ClosePayload = void;
-/**
- * `navigation.close` 的成功结果为 `undefined`。
- *
- * @remarks
- * 成功只表示 Host 的关闭原语已经接受并完成本次请求，不表示页面在 Promise resolve 后仍有
- * 可继续执行的生命周期，也不返回关闭状态、原因或新页面信息。
- */
-export type CloseResult = void;
-/**
- * `navigation.reload` 的无参 payload。
- *
- * @remarks
- * App-facing API 必须以 `reload()` 调用，不能传入缓存、目标 URL 或强制刷新选项。Host Runtime
- * 为兼容 bridge 调用会接受 `undefined` 或空普通对象；非空对象、数组和其他值会以
- * `INVALID_PARAMS` 拒绝。
- *
- * @see [navigation.reload](/reference/sdk/navigation/reload)
- */
-export type ReloadPayload = void;
-/**
- * `navigation.reload` 的成功结果为 `undefined`。
- *
- * @remarks
- * 成功只表示 Host 的 reload 原语已接受请求，不表示旧页面可继续执行，也不返回新页面的
- * `ready` 状态、加载结果或新 SDK 实例。
- */
-export type ReloadResult = void;
-export type { MiniProgramNavigationMethod } from '../../protocol/capabilities';
-/** 外部小程序可调用的 navigation 模块。 */
-export interface MiniProgramNavigationModule {
-    /**
-     * 请求宿主关闭当前小程序容器。
-     *
-     * @returns Host 关闭原语接受请求后 resolve `undefined`；这不是“页面仍可继续执行”的确认。
-     * @throws {@link HbMiniProgramSDKError} `INVALID_PARAMS` 表示通过底层协议传入了非空 payload；
-     * App-facing `close()` 本身没有参数。
-     * @throws {@link HbMiniProgramSDKError} `METHOD_FORBIDDEN` / `METHOD_NOT_FOUND` 表示当前 Host
-     * 未实现或未开放关闭原语；`REQUEST_UNSUPPORTED` 表示 Host 无法执行当前关闭请求。
-     * @throws {@link HbMiniProgramSDKError} `RUNTIME_DESTROYED` / `RUNTIME_UNAVAILABLE` /
-     * `SDK_DESTROYED` 表示 Runtime、容器或 SDK 已进入终态。SDK 握手失败或 Host 在调用超时内
-     * 未接受请求时，还会返回对应握手错误码或 `REQUEST_TIMEOUT`。其他 Host 关闭错误保留其
-     * SDK 错误码。
-     *
-     * @remarks
-     * 该方法在 `android`、`ios`、`ohos`、`windows`、`macos` 上公开，但实际 Host 必须提供
-     * `presentation.close` 原语；缺失时 fail closed。调用无需 `package.json#heybox.permissions`
-     * 声明、平台批准、用户授权或可信用户手势。
-     *
-     * Host 接受请求后可以立即销毁 iframe 和当前 JavaScript 上下文。不要依赖 `await close()`
-     * 后的语句、timer、微任务、事件监听或内存状态完成关键工作；当前上下文销毁后，pending
-     * 与后续 SDK 请求会失败。每次调用都会直接转发给 Host，不是可查询的关闭状态或幂等事务。
-     *
-     * 需要保留的数据必须在调用前写完并等待成功，例如先 await
-     * [storage.setStorage](/reference/sdk/storage/setStorage) 或业务服务端请求，再调用本方法。
-     * `storage.setStorage` 自身要求 `storage` 权限；这不会让 `navigation.close` 也需要该权限。
-     *
-     * Host 销毁当前运行环境时会尽力派发 [on('unload')](/reference/sdk/lifecycle/on)，但
-     * `unload` 不重放且可能来不及送达，只适合停止轮询、释放观察者等快速幂等清理，不能作为
-     * 最后一次持久化机会。需要保留容器但创建新页面上下文时使用
-     * [navigation.reload](/reference/sdk/navigation/reload)，不要把 close 当作 reload。
-     *
-     * @example
-     * ```ts
-     * import hbSDK from '@heybox/hb-sdk'
-     *
-     * async function saveAndClose(draftText: string) {
-     *   // 所有必须完成的写入都放在 close 之前，并等待 Host 确认持久化。
-     *   await hbSDK.storage.setStorage({
-     *     key: 'draft',
-     *     data: { text: draftText, updatedAt: Date.now() },
-     *   })
-     *
-     *   await hbSDK.navigation.close()
-     *   // 不要在这里安排必须执行的业务逻辑；当前上下文可能已经终止。
-     * }
-     * ```
-     *
-     * @see [navigation.reload](/reference/sdk/navigation/reload)
-     * @see [lifecycle.on](/reference/sdk/lifecycle/on)
-     * @see [storage.setStorage](/reference/sdk/storage/setStorage)
-     * @see [生命周期与事件](/guide/lifecycle)
-     * @see [权限声明](/guide/permissions#无需声明的-api)
-     *
-     * @since 0.4.4
-     * @hbPlatform android
-     * @hbPlatform ios
-     * @hbPlatform ohos
-     * @hbPlatform windows
-     * @hbPlatform macos
-     * @hbClient android none
-     * @hbClient ios none
-     * @hbClient ohos none
-     * @hbClient windows none
-     * @hbClient macos none
-     */
-    close(): Promise<void>;
-    /**
-     * 请求宿主重载当前小程序容器。
-     *
-     * @returns Host reload 原语接受请求后 resolve `undefined`；这不是旧页面仍可继续执行的确认。
-     * @throws {@link HbMiniProgramSDKError} `INVALID_PARAMS` 表示通过底层协议传入了非空 payload；
-     * App-facing `reload()` 本身没有参数。
-     * @throws {@link HbMiniProgramSDKError} `METHOD_FORBIDDEN` / `METHOD_NOT_FOUND` 表示当前 Host
-     * 未实现或未开放 reload 原语；`REQUEST_UNSUPPORTED` 表示 Host 无法执行当前 reload 请求。
-     * @throws {@link HbMiniProgramSDKError} `RUNTIME_DESTROYED` / `RUNTIME_UNAVAILABLE` /
-     * `SDK_DESTROYED` 表示 Runtime、旧页面上下文或 SDK 已进入终态。SDK 握手失败或 Host 在
-     * 调用超时内未接受请求时，还会返回对应握手错误码或 `REQUEST_TIMEOUT`；其他 Host reload
-     * 错误保留其 SDK 错误码。
-     *
-     * @remarks
-     * 该方法在 `android`、`ios`、`ohos`、`windows`、`macos` 上公开，但实际 Host 必须提供
-     * `presentation.reload` 原语；缺失时 fail closed。调用无需 `package.json#heybox.permissions`
-     * 声明、平台批准、用户授权或可信用户手势。
-     *
-     * Host 接受请求后会用新的页面运行上下文替换当前上下文。模块内变量、DOM、timer、未完成
-     * Promise、当前 SDK 实例以及通过 `on()` / `onHandshakeStateChange()` 注册的监听都不会跨
-     * reload 保留；新页面会重新加载 SDK、重新握手并重新注册所需监听。不要依赖
-     * `await reload()` 后的语句完成初始化或清理。每次调用都会直接转发给 Host，不会合并为
-     * 幂等的“正在重载”状态。
-     *
-     * 需要跨 reload 恢复的数据必须在调用前写完并等待成功，例如先 await
-     * [storage.setStorage](/reference/sdk/storage/setStorage) 或业务服务端请求。SDK storage 按
-     * canonical 小程序身份持久化，可由新页面重新读取，但 `storage.setStorage` 自身要求
-     * `storage` 权限；这不会让 `navigation.reload` 也需要该权限。
-     *
-     * Host 终止旧页面时会尽力派发 [on('unload')](/reference/sdk/lifecycle/on)，但 `unload`
-     * 不重放且可能来不及送达，只适合停止轮询、释放观察者等快速幂等清理，不能作为最后一次
-     * 持久化机会。若要终止整个小程序容器而不是创建新页面上下文，使用
-     * [navigation.close](/reference/sdk/navigation/close)。
-     *
-     * @example
-     * ```ts
-     * import hbSDK from '@heybox/hb-sdk'
-     *
-     * async function persistFiltersAndReload(filters: { tag: string }) {
-     *   await hbSDK.storage.setStorage({
-     *     key: 'game_filters',
-     *     data: filters,
-     *   })
-     *
-     *   await hbSDK.navigation.reload()
-     *   // 不要在这里安排必须执行的逻辑；新页面应从 storage 恢复 filters。
-     * }
-     * ```
-     *
-     * @see [navigation.close](/reference/sdk/navigation/close)
-     * @see [lifecycle.on](/reference/sdk/lifecycle/on)
-     * @see [storage.setStorage](/reference/sdk/storage/setStorage)
-     * @see [生命周期与事件](/guide/lifecycle)
-     * @see [权限声明](/guide/permissions#无需声明的-api)
-     *
-     * @since 0.4.4
-     * @hbPlatform android
-     * @hbPlatform ios
-     * @hbPlatform ohos
-     * @hbPlatform windows
-     * @hbPlatform macos
-     * @hbClient android none
-     * @hbClient ios none
-     * @hbClient ohos none
-     * @hbClient windows none
-     * @hbClient macos none
-     */
-    reload(): Promise<void>;
-    /**
-     * 请求宿主打开受 SDK 白名单约束的黑盒 App 页面或公开小程序。
-     *
-     * @param options - 由 `target` 判别的目标页参数；字段与规范化规则见 {@link OpenAppPageOptions}。
-     * @returns Host 接收参数并发起页面路由后 resolve `undefined`；不会等待目标页加载或返回目标页结果。
-     * @throws {@link HbMiniProgramSDKError} `INVALID_PARAMS` 表示 `options`、`target`、必填 ID、
-     * `gameType`、`page` 或其他已知字段不合法。SDK 会在调用 bridge 前拒绝这些输入。
-     * @throws {@link HbMiniProgramSDKError} `METHOD_FORBIDDEN` / `METHOD_NOT_FOUND` 表示当前 Host
-     * 未实现或未开放该能力；`REQUEST_UNSUPPORTED` 表示 Host 不支持所选目标或路由形状，例如
-     * 当前 PC Host 的 `user_detail`、`post_detail`，或缺少 `navigation.openGameDetail` 子能力。
-     * @throws {@link HbMiniProgramSDKError} `RUNTIME_DESTROYED` / `RUNTIME_UNAVAILABLE` /
-     * `SDK_DESTROYED` 表示 Runtime、容器或 SDK 已进入终态。SDK 握手失败或 Host 路由调用超时
-     * 时，还会返回对应握手错误码或 `REQUEST_TIMEOUT`；其他 Host 路由失败保留其 SDK 错误码。
-     *
-     * @remarks
-     * 公开白名单包含游戏详情、用户详情、帖子详情和公开小程序；不能传任意 URL、scheme、版本
-     * 或客户端内部路径。`mini_program` 只接受 `miniProgramId` 与可选 `extra`，目标版本和访问性
-     * 由 Host 决定。`extra` 与分享扩展数据使用相同格式，目标小程序通过 `share.getExtra()` 读取。
-     * Runtime 会在 Host 边界再次校验，页面提供的字段不能覆盖目标路径或窗口展示参数。
-     *
-     * 打开 `mini_program` 前，支持方向控制的 Host 会先把当前容器恢复为竖屏、非全屏，并等待
-     * 宿主确认后才打开目标；确认状态变化时发出 `display_change`（`source: 'api'`）。恢复阶段
-     * 最多等待 10 秒，超时返回 `ORIENTATION_TIMEOUT` 并取消宿主方向操作。SDK 总请求超时
-     * 返回 `REQUEST_TIMEOUT`，同时通知 Runtime 取消；SDK 销毁也会取消尚未完成的跳转。
-     * 恢复错误或请求取消后不会打开目标，晚到的方向成功回复也不会继续跳转。没有方向原语
-     * 或返回 `supported: false` 的旧 Host 仍允许跳转。返回当前小程序后不会
-     * 自动回到原方向，需要横屏的页面应在 `show` 事件中重新调用 `viewport.setDisplay()`。
-     *
-     * 移动端 Host 支持全部四类目标。当前 Windows/macOS PC Host 支持 `game_detail` 和
-     * `mini_program`，仍不支持 `user_detail`、`post_detail`；游戏详情只把 `appId` 交给导航，
-     * `gameType` 仍须合法，而 `page`、`hSrc`、`skuId` 不保证在 PC 生效。调用方应按目标和平台
-     * 处理 `REQUEST_UNSUPPORTED`，不能仅凭方法出现在能力目录中推断每种目标都可用。
-     *
-     * 该调用无需 `package.json#heybox.permissions` 声明、平台批准、用户授权或可信用户手势。
-     * 它只发起一次 App 导航，没有返回值或 disposer，也不会替代
-     * [navigation.close](/reference/sdk/navigation/close) 或
-     * [navigation.reload](/reference/sdk/navigation/reload) 对当前小程序容器的控制。
-     *
-     * @example
-     * ```ts
-     * import hbSDK from '@heybox/hb-sdk'
-     *
-     * async function openGameWiki() {
-     *   await hbSDK.navigation.openAppPage({
-     *     target: 'game_detail',
-     *     appId: 578080,
-     *     gameType: 'pc',
-     *     page: 'wiki',
-     *     hSrc: 'workshop',
-     *   })
-     * }
-     *
-     * async function openUserProfile(heyboxId: string) {
-     *   await hbSDK.navigation.openAppPage({
-     *     target: 'user_detail',
-     *     userId: heyboxId,
-     *   })
-     * }
-     *
-     * async function openPostComment(linkId: number, rootCommentId: number, commentId: number) {
-     *   await hbSDK.navigation.openAppPage({
-     *     target: 'post_detail',
-     *     linkId,
-     *     rootCommentId,
-     *     commentId,
-     *   })
-     * }
-     *
-     * async function openMiniProgram() {
-     *   await hbSDK.navigation.openAppPage({
-     *     target: 'mini_program',
-     *     miniProgramId: '2e2b8e19-8d73-45f8-8785-b87fd5535510',
-     *     extra: { page: 'ranking' },
-     *   })
-     * }
-     * ```
-     *
-     * @see {@link OpenGameDetailAppPageOptions}
-     * @see {@link OpenUserDetailAppPageOptions}
-     * @see {@link OpenPostDetailAppPageOptions}
-     * @see {@link OpenMiniProgramAppPageOptions}
-     * @see [navigation.close](/reference/sdk/navigation/close)
-     * @see [navigation.reload](/reference/sdk/navigation/reload)
-     * @see [权限声明](/guide/permissions#无需声明的-api)
-     *
-     * @since 0.5.2
-     * @hbPlatform android
-     * @hbPlatform ios
-     * @hbPlatform ohos
-     * @hbPlatform windows
-     * @hbPlatform macos
-     * @hbClient android none
-     * @hbClient ios none
-     * @hbClient ohos none
-     * @hbClient windows none
-     * @hbClient macos none
-     */
-    openAppPage(options: OpenAppPageOptions): Promise<void>;
-}
-/**
- * 请求宿主关闭当前小程序容器。
- *
- * @param requester - 底层 bridge 请求能力。
- * @returns Host 接受关闭请求后 resolve `undefined`；当前页面上下文随后可能立即终止。
- * @throws {@link HbMiniProgramSDKError} Host 能力缺失、关闭失败或 SDK / Runtime 已终止时抛出。
- * @remarks 必须完成的持久化工作应在调用前结束；该能力无需 Manifest 权限或可信用户手势。
- * @see [navigation.close](/reference/sdk/navigation/close)
- */
-export declare function close(requester: MiniProgramRequester): Promise<void>;
-/**
- * 请求宿主重载当前小程序容器。
- *
- * @param requester - 底层 bridge 请求能力。
- * @returns Host 接受 reload 请求后 resolve `undefined`；旧页面上下文随后会被替换。
- * @throws {@link HbMiniProgramSDKError} Host 能力缺失、reload 失败或 SDK / Runtime 已终止时抛出。
- * @remarks 跨页面状态应在调用前持久化；该能力无需 Manifest 权限或可信用户手势。
- * @see [navigation.reload](/reference/sdk/navigation/reload)
- */
-export declare function reload(requester: MiniProgramRequester): Promise<void>;
-/**
- * 请求宿主打开受 SDK 白名单约束的黑盒 App 页面或公开小程序。
- *
- * @param requester - 底层 bridge 请求能力。
- * @param options - 由 `target` 判别的目标页参数；发送前会校验并规范化。
- * @returns Host 发起受控页面路由后 resolve `undefined`。
- * @throws {@link HbMiniProgramSDKError} 参数非法、目标不受 Host 支持、路由失败或 SDK /
- * Runtime 已终止时抛出。
- * @remarks 该能力不接受任意 URL、版本或内部路由，也无需 Manifest 权限或可信用户手势。
- * @see [navigation.openAppPage](/reference/sdk/navigation/openAppPage)
- */
-export declare function openAppPage(requester: MiniProgramRequester, options: OpenAppPageOptions): Promise<void>;
-/** 创建导航能力模块。 */
-export declare function createNavigationModule(requester: MiniProgramRequester): MiniProgramNavigationModule;