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

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

@@ -1,319 +0,0 @@
-import type { SetDisplayPayload, SetDisplayResult } from '../../protocol';
-import type { MiniProgramOperationRequester, MiniProgramRequester } from '../../core/client';
-/**
- * 小程序安全区域信息。
- *
- * @remarks
- * 所有字段单位均为逻辑像素，坐标原点是当前小程序可用窗口的左上角。Runtime 会把
- * 四条边界夹取到窗口范围内，并保证 `right >= left`、`bottom >= top`；`width` 恒等于
- * `right - left`，`height` 恒等于 `bottom - top`。
- *
- * Host 未提供安全区域或某条边界无效时，Runtime 分别以 `left = 0`、
- * `right = windowWidth`、`top = statusBarHeight`、`bottom = windowHeight` 降级，再把结果
- * 夹取到当前窗口范围内。因此安全区域可能退化为零宽或零高矩形，但不会越过窗口边界。
- *
- * @see {@link MiniProgramWindowInfoResult}
- */
-export interface MiniProgramSafeArea {
-    /** 安全区域左边界横坐标；从窗口左边缘起算，范围为 `0` 到 `windowWidth`。 */
-    left: number;
-    /** 安全区域右边界横坐标；从窗口左边缘起算，且不小于 `left`。 */
-    right: number;
-    /** 安全区域上边界纵坐标；从窗口上边缘起算，Host 未提供有效值时取 `statusBarHeight`。 */
-    top: number;
-    /** 安全区域下边界纵坐标；从窗口上边缘起算，且不小于 `top`。 */
-    bottom: number;
-    /** 安全区域宽度，恒等于 `right - left`，单位逻辑像素。 */
-    width: number;
-    /** 安全区域高度，恒等于 `bottom - top`，单位逻辑像素。 */
-    height: number;
-}
-/**
- * 小程序窗口信息。
- *
- * @remarks
- * 该结构统一描述调用时的屏幕尺寸、可用窗口尺寸、安全区域与顶部偏移等容器信息。
- * 窗口可缩放的平台上，尺寸可能在后续用户拖拽后变化；需要最新值时重新调用
- * `viewport.getWindowInfo()`。
- *
- * Runtime 会把无效 `pixelRatio` 降级为 `1`，把无效屏幕尺寸降级为对应窗口尺寸，
- * 把无效窗口尺寸降级为 `0`。导航栏高度读取失败或返回无效值时，`statusBarHeight`
- * 与 `screenTop` 均降级为 `0`；安全区域再基于这些归一化值计算。
- *
- * @see {@link MiniProgramViewportModule.getWindowInfo}
- */
-export interface MiniProgramWindowInfoResult {
-    /** 设备像素比；Host 返回非有限值或非正数时为 `1`。 */
-    pixelRatio: number;
-    /** 屏幕宽度，单位逻辑像素；Host 值无效时退回到 `windowWidth`。 */
-    screenWidth: number;
-    /** 屏幕高度，单位逻辑像素；Host 值无效时退回到 `windowHeight`。 */
-    screenHeight: number;
-    /** 当前小程序可使用的窗口内容宽度，单位逻辑像素；Host 值无效时为 `0`。 */
-    windowWidth: number;
-    /** 当前小程序可使用的窗口内容高度，单位逻辑像素；Host 值无效时为 `0`。 */
-    windowHeight: number;
-    /** 状态栏或顶部导航占用高度，单位逻辑像素；读取失败或值无效时为 `0`。 */
-    statusBarHeight: number;
-    /** 当前窗口内经过边界夹取并补齐 `width`、`height` 的安全区域。 */
-    safeArea: MiniProgramSafeArea;
-    /** 顶部可用偏移兼容值，单位逻辑像素；当前恒等于 `statusBarHeight`。 */
-    screenTop: number;
-}
-export { VIEWPORT_SET_DISPLAY_METHOD } from '../../protocol/capabilities';
-export type { MiniProgramDisplayState, MiniProgramOrientationMode, SetDisplayPayload, SetDisplayResult } from '../../protocol';
-export { VIEWPORT_GET_WINDOW_INFO_METHOD } from '../../protocol/capabilities';
-export { VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD } from '../../protocol/capabilities';
-/** `viewport.getWindowInfo` 不接收 options 或 payload，调用时无需传入参数。 */
-export type GetWindowInfoPayload = void;
-/** `viewport.getWindowInfo` 返回调用时经过 Runtime 归一化的窗口快照。 */
-export type GetWindowInfoResult = MiniProgramWindowInfoResult;
-/**
- * 导航栏关闭按钮与状态栏图标/文字的前景样式。
- *
- * @remarks
- * `light` 请求 Host 使用白色或浅色前景，适合深色背景；`dark` 请求 Host 使用黑色
- * 或深色前景，适合浅色背景。该类型没有 `auto`、`system` 或恢复默认值；需要跟随
- * 页面主题时，应在主题变化后重新调用
- * {@link MiniProgramViewportModule.setNavigationBarStyle}。
- *
- * 取值表达的是对比度语义，不是固定色号。具体颜色、透明度以及状态栏和关闭按钮的
- * 渲染方式由当前 Host 与操作系统决定。
- *
- * @see {@link MiniProgramSetNavigationBarStyleOptions.foregroundStyle}
- */
-export type MiniProgramNavigationBarForegroundStyle = 'light' | 'dark';
-/**
- * 设置导航栏样式的配置。
- *
- * @remarks
- * `options` 必须是对象，且 `foregroundStyle` 是必填字段。Runtime 只接受精确的
- * `light` 或 `dark` 字符串；缺少字段、传入 `null`、数组或其他值都会以
- * `INVALID_PARAMS` 拒绝。
- *
- * 当前仅开放关闭按钮与状态栏图标/文字的前景明暗样式，不设置导航栏背景色。
- *
- * @see {@link MiniProgramNavigationBarForegroundStyle}
- */
-export interface MiniProgramSetNavigationBarStyleOptions {
-    /**
-     * 导航栏关闭按钮与状态栏图标/文字的前景样式。
-     *
-     * @remarks
-     * 该字段必填且仅接受 `light` 或 `dark`。`light` 适合深色背景，`dark` 适合浅色
-     * 背景；它不读取网页背景，也不会自动跟随 `prefers-color-scheme`。
-     */
-    foregroundStyle: MiniProgramNavigationBarForegroundStyle;
-}
-/**
- * `viewport.setNavigationBarStyle` 的必填入参。
- *
- * @see {@link MiniProgramSetNavigationBarStyleOptions}
- */
-export type SetNavigationBarStylePayload = MiniProgramSetNavigationBarStyleOptions;
-/**
- * `viewport.setNavigationBarStyle` 的结果；Host 完成设置后固定以 `undefined` resolve。
- *
- * @remarks
- * Host 内部返回的其他值不会透传给 Mini-program，该结果也不包含最终渲染色值。
- */
-export type SetNavigationBarStyleResult = void;
-export type { MiniProgramViewportMethod } from '../../protocol/capabilities';
-/** 外部小程序可调用的 Viewport 模块。 */
-export interface MiniProgramViewportModule {
-    /**
-     * 设置当前小程序的窗口方向和全屏状态。
-     *
-     * @param options - 方向与全屏目标，至少提供一个字段；省略的字段保持当前目标值。
-     * @returns Host 完成原生方向与胶囊设置、布局稳定后返回 `{ supported: true }`；能力缺失或
-     * 请求不受支持时返回 `{ supported: false }`，调用方仍应按实际窗口与安全区布局。
-     * @throws {@link HbMiniProgramSDKError} `INVALID_PARAMS` 表示参数不合法；
-     * `ORIENTATION_TIMEOUT` 表示展示操作超时，`ORIENTATION_FAILED` 表示执行失败，
-     * `ORIENTATION_SUPERSEDED` 表示被后续不同目标替代，`REQUEST_CANCELLED` 表示操作已取消。
-     * SDK 或 Runtime 销毁、握手失败等其他错误保留对应 SDK 错误码。
-     *
-     * @remarks
-     * 新容器默认竖屏、非全屏。省略字段保持当前目标值，至少传一个字段；合并后横屏强制全屏，竖屏按 fullscreen 控制。
-     * 全屏同时收起胶囊和宿主额外顶部栏，不保证原生内容铺满容器；页面应按实际 WebView 窗口和安全区适配。
-     * 系统状态栏、手势条不保证隐藏，重要控件仍应按实际窗口与安全区信息避让。
-     * 横屏时仅设置 fullscreen: false 不会退出全屏；退出需同时设置 orientation: portrait、fullscreen: false。
-     * 宿主退出按钮恢复竖屏、非全屏；仅设置 orientation: portrait 则保留当前全屏目标。
-     * 设置持续到下次调用或退出容器；SPA 路由应在进入时明确设置所需状态。
-     * 后续设置先合并目标，再取消不同的旧设置；旧调用以 ORIENTATION_SUPERSEDED 失败。
-     * 相同目标共用操作；方向和全屏一起确认，失败时一起恢复最后确认状态。
-     * 本方法等待 Host 展示操作完成，由 Runtime 的操作截止时间控制，不使用普通 bridge 请求的独立超时计时器。
-     * 操作超时或 SDK 销毁会向 Host 传递取消；不要依赖迟到的 Host 成功结果推进业务状态。
-     * 窗口尺寸与安全区变化通过 viewport_change 事件通知。
-     * 方向或全屏状态确认变化时通过 display_change 通知，包括用户点击宿主退出全屏按钮。
-     * display_change 不回放初始状态；重复设置、不支持、失败或取消不会发出展示状态变化通知。
-     * 返回 supported: true 表示原生方向与胶囊设置已完成；不支持时返回 supported: false，保留原生状态。
-     * 降级时宿主仍尽力收起 H5 顶部栏，不能据此假定屏幕已旋转或胶囊已隐藏；布局始终按实际窗口适配。
-     * SDK 统一处理能力缺失错误；超时、取消、参数或其他执行错误仍抛出。
-     *
-     * @example
-     * ```ts
-     * import hbSDK from '@heybox/hb-sdk'
-     *
-     * // 同时恢复竖屏和非全屏，避免保留之前的全屏目标。
-     * const result = await hbSDK.viewport.setDisplay({ orientation: 'portrait', fullscreen: false })
-     * if (!result.supported) console.log('Host 不支持原生展示设置')
-     * ```
-     *
-     * @since 0.8.1-alpha.4
-     * @hbPlatform android
-     * @hbPlatform ios
-     * @hbPlatform ohos
-     * @hbClient android numeric-dot \>= 1.3.396
-     * @hbClient ios numeric-dot \>= 1.3.396
-     * @hbClient ohos none
-     * @experimental
-     */
-    setDisplay(options: SetDisplayPayload): Promise<SetDisplayResult>;
-    /**
-     * 获取当前小程序窗口信息。
-     *
-     * @returns 调用时经过 Runtime 归一化的设备像素比、屏幕与窗口尺寸、安全区域及顶部偏移快照。
-     * @throws {@link HbMiniProgramSDKError} 当前 Host 未开放窗口测量能力时以 `METHOD_FORBIDDEN`
-     * 拒绝；握手失败、Runtime 已卸载、SDK 已销毁、请求超时或 Host 测量失败时抛出对应
-     * bridge / Runtime 错误。
-     *
-     * @remarks
-     * 该方法无入参，不触发用户授权，也无需在 `package.json#heybox.permissions` 中声明。
-     * 每次调用都会重新读取当前窗口并返回一次性快照；它不订阅尺寸变化。PC 可缩放窗口
-     * 可能在用户拖拽、Host 恢复窗口或系统缩放变化后得到新尺寸，需要最新值时应重新调用。
-     *
-     * `package.json#heybox.window` 的 `defaultWidth`、`defaultHeight`、`minWidth`、
-     * `minHeight` 与 `resizable` 只控制开窗初值和用户拖拽约束，不能替代本 API 的运行时
-     * 查询。该方法只读取几何信息；导航栏前景色由
-     * {@link MiniProgramViewportModule.setNavigationBarStyle} 单独设置。
-     *
-     * @example
-     * ```ts
-     * import hbSDK from '@heybox/hb-sdk'
-     *
-     * const info = await hbSDK.viewport.getWindowInfo()
-     * const safeInsets = {
-     *   top: info.safeArea.top,
-     *   right: info.windowWidth - info.safeArea.right,
-     *   bottom: info.windowHeight - info.safeArea.bottom,
-     *   left: info.safeArea.left,
-     * }
-     *
-     * const root = document.documentElement
-     * for (const [edge, value] of Object.entries(safeInsets)) {
-     *   root.style.setProperty(`--safe-area-${edge}`, `${value}px`)
-     * }
-     * // 窗口尺寸变化后重新调用 getWindowInfo()，不要长期缓存这次结果。
-     * ```
-     *
-     * @see {@link MiniProgramWindowInfoResult}
-     * @see {@link MiniProgramViewportModule.setNavigationBarStyle}
-     * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/window-size/ | 窗口尺寸与可缩放性}
-     *
-     * @since 0.2.0-alpha.0
-     * @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
-     */
-    getWindowInfo(): Promise<GetWindowInfoResult>;
-    /**
-     * 设置导航栏关闭按钮与状态栏图标/文字的前景样式。
-     *
-     * @param options - 必填的前景样式配置。`foregroundStyle` 只能是 `light` 或 `dark`。
-     * @returns Host 报告本次设置完成后以 `undefined` resolve；不会返回当前样式或实际渲染色值。
-     * @throws {@link HbMiniProgramSDKError} `options` 不是对象，或 `foregroundStyle` 缺失、
-     * 不是 `light`/`dark` 时以 `INVALID_PARAMS` 拒绝；当前 Host 未开放该能力时以
-     * `METHOD_FORBIDDEN` 拒绝，Host 无法处理当前请求时以 `REQUEST_UNSUPPORTED` 拒绝。
-     * 握手失败、SDK 或 Runtime 已销毁、bridge 请求超时以及 Host 设置失败时抛出对应
-     * SDK 错误。
-     *
-     * @remarks
-     * 该 API 无需在 `package.json#heybox.permissions` 中声明权限，也不要求可信用户手势
-     * 或平台批准；仍需当前 Host 开放 `viewport.setNavigationBarStyle` capability。
-     *
-     * 该方法只控制关闭按钮和状态栏图标/文字的前景明暗，不修改导航栏背景色，也不
-     * 改变网页自身的 `color-scheme`。它不提供读取接口、自动主题模式或恢复默认值；
-     * 后续调用可以覆盖先前样式，Host 重建容器后也不应依赖先前调用继续生效。
-     *
-     * 移动端 Host 将该语义应用到 App 顶部容器和系统状态栏，PC Host 将其应用到桌面
-     * 小程序窗口的导航控件；不同操作系统可以采用不同的实际颜色和渲染方式。Browser
-     * Dev Host 只更新本地设备预览中的 Host chrome，不能替代真机或桌面客户端验收。
-     *
-     * {@link MiniProgramViewportModule.getWindowInfo} 只读取窗口几何与安全区域，既不会
-     * 返回当前前景样式，也不是调用本方法的前置条件。`package.json#heybox.window` 只
-     * 声明开窗尺寸和可缩放性，与导航栏前景样式互不覆盖。
-     *
-     * @example
-     * ```ts
-     * import hbSDK from '@heybox/hb-sdk'
-     *
-     * const colorScheme = window.matchMedia('(prefers-color-scheme: dark)')
-     *
-     * async function syncNavigationBarStyle() {
-     *   await hbSDK.viewport.setNavigationBarStyle({
-     *     // 深色页面使用浅色前景，浅色页面使用深色前景。
-     *     foregroundStyle: colorScheme.matches ? 'light' : 'dark',
-     *   })
-     * }
-     *
-     * await syncNavigationBarStyle()
-     * const handleColorSchemeChange = () => {
-     *   void syncNavigationBarStyle().catch(console.error)
-     * }
-     * colorScheme.addEventListener('change', handleColorSchemeChange)
-     * window.addEventListener('pagehide', () => {
-     *   colorScheme.removeEventListener('change', handleColorSchemeChange)
-     * }, { once: true })
-     * ```
-     *
-     * @see {@link MiniProgramNavigationBarForegroundStyle}
-     * @see {@link MiniProgramSetNavigationBarStyleOptions}
-     * @see {@link MiniProgramViewportModule.getWindowInfo}
-     * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/window-size/ | 窗口尺寸与可缩放性}
-     * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
-     *
-     * @since 0.4.0
-     * @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
-     */
-    setNavigationBarStyle(options: MiniProgramSetNavigationBarStyleOptions): Promise<SetNavigationBarStyleResult>;
-}
-/**
- * 获取当前小程序窗口信息。
- *
- * @param requester - 底层 bridge 请求能力。
- * @returns 当前小程序可用窗口信息。
- * @throws {@link HbMiniProgramSDKError} 当 bridge、父容器或宿主能力调用失败时抛出。
- */
-export declare function getWindowInfo(requester: MiniProgramRequester): Promise<GetWindowInfoResult>;
-/**
- * 设置导航栏关闭按钮与状态栏图标/文字的前景样式。
- *
- * @param requester - 底层 bridge 请求能力。
- * @param options - 导航栏样式配置。
- * @returns 宿主接受设置后 resolve。
- * @throws {@link HbMiniProgramSDKError} 当 bridge、父容器或宿主能力调用失败时抛出。
- */
-export declare function setNavigationBarStyle(requester: MiniProgramRequester, options: MiniProgramSetNavigationBarStyleOptions): Promise<SetNavigationBarStyleResult>;
-/**
- * 创建 Viewport 模块。
- *
- * @param requester - 底层 bridge 请求能力。
- * @returns 面向业务层的 Viewport 模块对象。
- */
-export declare function createViewportModule(requester: MiniProgramOperationRequester): MiniProgramViewportModule;

package/types/protocol/capabilities.d.ts

@@ -1,2 +0,0 @@
-export { AUTH_LOGIN_METHOD, CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD, CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD, CLOUD_LEADERBOARD_GET_INFO_METHOD, CLOUD_LEADERBOARD_GET_LIST_METHOD, CLOUD_LEADERBOARD_SUBMIT_METHOD, DIRECTORY_CREATE_METHOD, DIRECTORY_EXISTS_METHOD, DIRECTORY_LIST_METHOD, DIRECTORY_REMOVE_METHOD, DEVICE_EXECUTE_PROTOCOL_METHOD, DEVICE_SET_CLIPBOARD_METHOD, DEVICE_VIBRATE_METHOD, FILES_PICK_DIRECTORY_METHOD, FILES_PICK_FILES_METHOD, FILES_SAVE_FILE_METHOD, FILE_CREATE_METHOD, FILE_EXISTS_METHOD, FILE_READ_BYTES_METHOD, FILE_READ_TEXT_METHOD, FILE_REMOVE_METHOD, FILE_STAT_METHOD, FILE_WRITE_BYTES_METHOD, FILE_WRITE_TEXT_METHOD, MINI_PROGRAM_PROTOCOL_CAPABILITIES, NAVIGATION_CLOSE_METHOD, NAVIGATION_OPEN_APP_PAGE_METHOD, NAVIGATION_RELOAD_METHOD, NETWORK_REQUEST_METHOD, NETWORK_DOWNLOAD_METHOD, SHARE_COPY_LINK_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, UI_HIDE_LOADING_METHOD, UI_SHOW_LOADING_METHOD, UI_SHOW_TOAST_METHOD, USER_GET_INFO_METHOD, USER_GET_STEAM_GAME_LIST_METHOD, USER_REVOKE_AUTHORIZATION_METHOD, VIEWPORT_SET_DISPLAY_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD, } from '@heybox/hb-sdk-protocol';
-export type { MiniProgramAuthMethod, MiniProgramBridgeMethod, MiniProgramCapabilityDefinition, MiniProgramCapabilityModule, MiniProgramCapabilityPayload, MiniProgramCapabilityPayloadMap, MiniProgramCapabilityResult, MiniProgramCapabilityResultMap, MiniProgramCapabilityRisk, MiniProgramCloudMethod, MiniProgramDeviceMethod, MiniProgramDirectoryMethod, MiniProgramFileMethod, MiniProgramFilesMethod, MiniProgramNavigationMethod, MiniProgramNetworkMethod, MiniProgramShareMethod, MiniProgramStorageMethod, MiniProgramUiMethod, MiniProgramUserMethod, MiniProgramViewportMethod, } from '@heybox/hb-sdk-protocol';

package/types/protocol/constants.d.ts

@@ -1 +0,0 @@
-export { MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, MINI_PROGRAM_OPERATION_PROGRESS_METHOD, RUNTIME_LOCATION_PROBE_METHOD, SDK_CSP_VIOLATION_METHOD, SDK_HANDSHAKE_METHOD, SDK_LOCATION_REPORT_METHOD, } from '@heybox/hb-sdk-protocol';

package/types/protocol/dev-session.d.ts

@@ -1,74 +0,0 @@
-import type { MiniProgramRuntimePermissionsSnapshot } from './runtime-permissions';
-import type { MiniProgramLocalDevGrant, MiniProgramLocalDevPermissionDeclarations } from '@heybox/hb-sdk-protocol';
-/**
- * 网关限流状态。
- *
- * 加性、向后兼容字段：老宿主页或老 Runtime 忽略即可。CLI 收到 403/429 后把状态透出给
- * 调试页与宿主页，让手机端停止「重连 → 打接口 → 被拒 → 再重连」的自激循环。
- */
-export interface MiniProgramDevRateLimitState {
-    /** 是否处于限流中；仅在限流时下发，取值为 true。 */
-    limited: boolean;
-    /** 网关建议的等待时长（毫秒）。 */
-    retryAfterMs?: number;
-    /** 限流预计解除的绝对时间（Unix 毫秒）。 */
-    untilTs?: number;
-    /** 网关原文摘要，仅用于展示。 */
-    message?: string;
-}
-export interface MiniProgramLocalDevContextFields {
-    local_dev_grant?: MiniProgramLocalDevGrant;
-    context_revision?: number;
-    declared_permissions?: MiniProgramLocalDevPermissionDeclarations;
-    platforms?: readonly string[];
-    dev_session_id?: string;
-    local_dev_launch_token?: string;
-    mini_program_id?: string;
-    companion_manifest_sha256?: string;
-    /** 限流状态；正常时不下发该字段。 */
-    rate_limit?: MiniProgramDevRateLimitState | null;
-}
-/** Dev Shell 读取局域网 Dev Session endpoint 的 query 参数。 */
-export declare const MINI_PROGRAM_DEV_CONTEXT_QUERY_PARAM = "dev_context_url";
-/** Browser Dev Host 创建和读取 Dev Session 的固定路径。 */
-export declare const MINI_PROGRAM_DEV_CONTEXT_PATH = "/__hb_sdk__/dev-context";
-/** 详情 H5 从 `mini_url` origin 发现其余启动参数的固定路径。 */
-export declare const MINI_PROGRAM_DEV_LAUNCH_PATH = "/__hb_sdk__/launch.json";
-/** Dev Session 当前使用的 schema 版本。 */
-export declare const MINI_PROGRAM_DEV_SESSION_SCHEMA_VERSION: 1;
-/** `launch.json` 当前使用的 schema 版本。 */
-export declare const MINI_PROGRAM_DEV_LAUNCH_SCHEMA_VERSION: 1;
-/** Browser Dev Host 创建 Dev Session 时接收的请求。 */
-export interface MiniProgramDevSessionCreatePayload {
-    mini_url_origin: string;
-    /** 仅用于兼容旧 Node 服务；当前服务端忽略该字段并自行读取远端权限。 */
-    runtime_permissions?: MiniProgramRuntimePermissionsSnapshot;
-}
-/** Browser Dev Host 创建 Dev Session 后返回的短期引用。 */
-export interface MiniProgramDevSessionCreateResult {
-    expires_at: number;
-    token: string;
-}
-/** Runtime Host 通过短期引用读取的不可变 Dev Session 快照。 */
-export interface MiniProgramDevSessionSnapshot extends MiniProgramLocalDevContextFields {
-    schema_version: typeof MINI_PROGRAM_DEV_SESSION_SCHEMA_VERSION;
-    revision: number;
-    expires_at: number;
-    mini_url_origin: string;
-    runtime_permissions: MiniProgramRuntimePermissionsSnapshot;
-}
-/** 详情 H5 在只带 `mini_url` 启动后拉取的其余调试参数。 */
-export interface MiniProgramDevLaunchSnapshot extends MiniProgramLocalDevContextFields {
-    schema_version: typeof MINI_PROGRAM_DEV_LAUNCH_SCHEMA_VERSION;
-    sdk_version?: string;
-    mini_program_id?: string;
-    local_dev_launch_token?: string;
-    /** CLI 进程身份，重启后变化；不作为授权凭据。 */
-    dev_session_id?: string;
-    /** 启动票过期时间，Unix 毫秒。 */
-    expires_at?: number;
-    companion_manifest_sha256?: string;
-    companion_artifact_access_token?: string;
-    dev_context_url?: string;
-    runtime_permissions?: MiniProgramRuntimePermissionsSnapshot;
-}

package/types/protocol/guards.d.ts

@@ -1 +0,0 @@
-export { isMiniProgramBridgeMessage, isMiniProgramByteArray, isMiniProgramDirectoryDescriptor, isMiniProgramDirectoryRef, isMiniProgramDownloadProgressPayload, isMiniProgramFileDescriptor, isMiniProgramFileRef, isMiniProgramFileStat, isMiniProgramFileSystemEntityDescriptor, isMiniProgramPathRootRef, isMiniProgramRelativePath, } from '@heybox/hb-sdk-protocol';

package/types/protocol/runtime-permissions.d.ts

@@ -1,2 +0,0 @@
-export { isManagedMiniProgramRuntimePermissionKey, parseMiniProgramRuntimePermissions, } from '@heybox/hb-sdk-protocol';
-export type { MiniProgramRuntimePermissionEntry, MiniProgramRuntimePermissionsSnapshot, MiniProgramRuntimePermissionStatus, ParsedMiniProgramRuntimePermissions, } from '@heybox/hb-sdk-protocol';

package/types/protocol/types.d.ts

@@ -1,22 +0,0 @@
-import type { MiniProgramEventName, MiniProgramEventPayloadMap } from '@heybox/hb-sdk-protocol';
-export type { MiniProgramBridgeError, MiniProgramBridgeCancelMessage, MiniProgramBridgeMessage, MiniProgramBridgeMessageType, MiniProgramBridgeProgressMessage, MiniProgramEventName, MiniProgramEventPayloadMap, RuntimeLocationProbePayload, SDKCSPBlockedResourceType, SDKCSPViolationPayload, SDKHandshakePayload, SDKLocationReportPayload, SDKLocationReportTrigger, } from '@heybox/hb-sdk-protocol';
-/**
- * 小程序生命周期或业务事件监听函数。
- *
- * @typeParam T - 受
- * [MiniProgramEventName](/reference/symbols/root/types/MiniProgramEventName) 约束的事件名；它决定
- * `payload` 的精确类型。
- * @param payload - 由
- * [MiniProgramEventPayloadMap](/reference/symbols/root/interfaces/MiniProgramEventPayloadMap) 按 `T`
- * 索引得到的事件载荷。
- *
- * @remarks
- * handler 在 event bus 派发时同步调用，返回值会被忽略且 Promise 不会被等待。普通事件 handler
- * 之间没有异常隔离：同步抛错会从当前派发传播，并可能阻止同一事件的后续 handler；异步 handler
- * 的 rejected Promise 也不会被 SDK 捕获。监听器应在自身边界处理同步和异步错误。
- *
- * 生命周期事件不会重放，只派发给事件到达时已经注册的监听器。需要查询当前握手状态时，使用
- * [getHandshakeState()](/reference/sdk/lifecycle/getHandshakeState) 或
- * [onHandshakeStateChange()](/reference/sdk/lifecycle/onHandshakeStateChange)。
- */
-export type MiniProgramEventHandler<T extends MiniProgramEventName = MiniProgramEventName> = (payload: MiniProgramEventPayloadMap[T]) => void;

package/types/skill-metadata.d.ts

@@ -1,18 +0,0 @@
-export declare const HB_SDK_PACKAGE_NAME = "@heybox/hb-sdk";
-export declare const HB_SDK_SKILL_NAME = "hb-sdk";
-export interface SkillContentFileEntry {
-    /** 相对 Skill 根目录的路径，例如 `SKILL.md`。 */
-    path: string;
-    /** 原始文件字节；字符串按 UTF-8 处理，与 scripts/skill/skill-metadata.mjs 保持一致。 */
-    content: string | Buffer;
-}
-/**
- * 计算 Skill 可分发内容（不含 `skill.json` manifest）的内容哈希。
- *
- * 该实现必须与 `scripts/skill/skill-metadata.mjs` 的 `createSkillContentHash` 语义完全一致：
- * 按 `path` 升序排序后依次写入 `path`、`\0`、`content`、`\0`，最后取 sha256 十六进制摘要。
- * 发布到 npm 的包内不含 `scripts/`，因此这里保留独立实现，供 CLI 运行期校验已安装 Skill。
- */
-export declare function createSkillContentHash(fileEntries: readonly SkillContentFileEntry[]): {
-    hex: string;
-};

package/types/vite/html-policy.d.ts

@@ -1,6 +0,0 @@
-export declare const PRODUCTION_CSP: string;
-export declare function enforceMiniappHtmlPolicy(html: string, options?: {
-    deviceLogUploadUrls?: readonly string[];
-    hmrWebSocketUrl?: string;
-    skipPlatformCsp?: boolean;
-}): string;

package/types/vite/runtime-permission-env.d.ts

@@ -1,9 +0,0 @@
-export declare const HB_SDK_RUNTIME_USE_OFFICIAL_DOMAIN_ENV = "HB_SDK_RUNTIME_USE_OFFICIAL_DOMAIN";
-export declare const HB_SDK_RUNTIME_PERMISSION_CONTEXT_ENV = "HB_SDK_RUNTIME_PERMISSION_CONTEXT";
-export declare function shouldSkipMiniappPlatformCspFromEnv(env?: NodeJS.ProcessEnv): boolean;
-export declare function createMiniappPlatformCspEnv(env: NodeJS.ProcessEnv, skipPlatformCsp: boolean): {
-    HB_SDK_RUNTIME_PERMISSION_CONTEXT: string;
-    HB_SDK_RUNTIME_USE_OFFICIAL_DOMAIN: string;
-    TZ?: string | undefined;
-};
-export declare function withMiniappPlatformCspEnv<T>(skipPlatformCsp: boolean, action: () => Promise<T>, env?: NodeJS.ProcessEnv): Promise<T>;