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

package/types/miniapp-publish/index.d.ts

@@ -1,61 +1,541 @@
+import { MiniProgramPermissionKey, WorkspaceCardsManifest } from '@heybox/hb-sdk-protocol';
+
+/** 小程序发布类别：`tool` 为工具、`game` 为游戏、`other` 为其他；新上传版本必须声明，历史读取可缺省。 */
+type MiniappCategory = 'tool' | 'game' | 'other';
+/**
+ * 校验项目配置或产物中的小程序类别。
+ *
+ * @param value - 待校验值，只接受 `tool`、`game`、`other` 或 `undefined`；不做 trim 或大小写转换。
+ * @param sourceLabel - 错误消息中的字段来源，默认 `package.json#heybox.category`。
+ * @returns 合法类别原值；输入 `undefined` 时返回 `undefined`，由发布流程另行检查是否必填。
+ * @throws `Error` 输入为其他值（包括 null 或空字符串）时抛出带字段来源的错误。
+ */
+declare function parseMiniappCategory(value: unknown, sourceLabel?: string): MiniappCategory | undefined;
+
+type MiniappPermissionKey = MiniProgramPermissionKey;
+/** 构建产物中一个已启用的权限声明；未启用的项目配置项会在构建时被省略。 */
+interface SimpleMiniappPermissionDeclaration {
+    /** 固定为 true，表示应用请求使用该权限；不等同于平台已经批准。 */
+    enabled: true;
+}
+/** 构建产物中的网络权限声明，附带是否请求小黑盒官方域名访问的配置。 */
+interface NetworkMiniappPermissionDeclaration extends SimpleMiniappPermissionDeclaration {
+    /** 是否申请官方域名访问，项目省略时规范化为 false；实际启用还需远端批准该配置。 */
+    useOfficialDomain: boolean;
+}
+/**
+ * 构建规范化后写入 Manifest 的权限对象；仅包含请求启用的权限，空对象表示无权限需求。
+ *
+ * @remarks
+ * 这是本地声明，不是运行时授权结果。仅需声明的权限按声明生效；要求平台批准的权限还需与远端批准
+ * 求交，network 的 useOfficialDomain 配置也需同时获批。显式声明中缺失某权限表示不请求该权限；
+ * SDK 0.9 系列起项目必须提供该对象，0.8 历史产物未声明时另按迁移规则处理。
+ */
+type MiniappPermissionDeclarations = Partial<Record<Exclude<MiniappPermissionKey, 'network'>, SimpleMiniappPermissionDeclaration> & {
+    network: NetworkMiniappPermissionDeclaration;
+}>;
+
+declare const MINIAPP_COMPANION_TARGETS: readonly ["windows-x64", "macos-arm64"];
+declare const MINIAPP_COMPANION_CAPABILITIES: readonly ["stdio", "attachments", "notifications"];
+/** Companion 二进制目标：Windows x64 或 macOS arm64；不是小程序的通用平台列表。 */
+type MiniappCompanionTarget = (typeof MINIAPP_COMPANION_TARGETS)[number];
+/**
+ * Companion 声明的能力标识：`stdio` 为标准输入输出、`attachments` 为受管附件、`notifications` 为通知。
+ * 声明不代表当前宿主可用；实际能力以启动后 Session 返回的 capability 集合为准。
+ */
+type MiniappCompanionCapability = (typeof MINIAPP_COMPANION_CAPABILITIES)[number];
+/** 构建生成的单个 Companion ZIP 归档描述；不使用项目声明中的 source 目录。 */
+interface MiniappCompanionManifestTarget {
+    /** 相对构建目录的 ZIP 路径，固定为 `companions/{alias}/{target}.zip`。 */
+    path: string;
+    /** ZIP 文件完整字节数，必须为正安全整数；不是解压后的大小。 */
+    size: number;
+    /** ZIP 完整字节的 SHA-256，使用 64 位小写十六进制字符串。 */
+    sha256: string;
+    /** 解压归档中的启动入口，由构建时从项目声明校验并保留。 */
+    entrypoint: {
+        /** 普通可执行文件或 macOS `.app` bundle；Windows 仅支持 executable。 */
+        kind: 'executable' | 'app-bundle';
+        /** 相对归档根目录的入口路径，使用 `/` 分隔；不是 ZIP 路径或项目 source 路径。 */
+        path: string;
+    };
+    /** V1 固定为普通权限启动，不支持请求管理员权限。 */
+    elevation: 'none';
+    /** 启动参数列表；最多 64 项，每项 1024 UTF-8 bytes，总计 16 KiB，不允许 NUL、CR 或 LF。 */
+    args: string[];
+}
+/** 一个 Companion alias 对应的展示信息、声明能力与平台归档。 */
+interface MiniappCompanionManifestDefinition {
+    /** 非空展示名称，最多 120 个 Unicode code point。 */
+    displayName: string;
+    /** 无重复的声明能力列表，可为空；不表示平台批准或宿主已提供这些能力。 */
+    capabilities: MiniappCompanionCapability[];
+    /** 按二进制目标索引的已生成归档，至少提供一个目标。 */
+    targets: Partial<Record<MiniappCompanionTarget, MiniappCompanionManifestTarget>>;
+}
+/**
+ * 发布 Manifest 的 Companion 声明，键为以小写字母开头、长度 1–32 的小写字母/数字/连字符 alias。
+ *
+ * @remarks
+ * 声明时对象必须非空，所有 alias 合计最多 64 个 target 描述符。归档由构建插件生成，
+ * 不应把含 source 目录的项目配置直接当作此类型；运行时还需声明 companion 权限并获得平台批准。
+ */
+type MiniappCompanionManifestDeclarations = Record<string, MiniappCompanionManifestDefinition>;
+
+/**
+ * `package.json#heybox.platforms` 接受的平台值，顺序同时是 Manifest 的规范化输出顺序。
+ *
+ * @remarks 项目仍应只声明实际完成适配并经过验收的平台；模板默认值不是自动兼容承诺。
+ */
+declare const MINIAPP_PLATFORM_VALUES: readonly ["android", "ios", "ohos", "windows", "macos", "linux"];
+/** `package.json#heybox.platforms` 中单个平台标识。 */
+type MiniappPlatform = (typeof MINIAPP_PLATFORM_VALUES)[number];
+/** 平台声明硬切点：产物 hb-sdk 版本达到该值时，必须显式声明非空 `platforms`。 */
+declare const MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION = "0.9.0";
+/**
+ * 历史兜底平台集合。
+ *
+ * @remarks
+ * 仅在 `sdkVersion` 缺失或 SemVer precedence 低于 `MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION`，
+ * 且 Manifest 完全没有 `platforms` 字段时生效，不是任何非法声明的兜底。
+ *
+ * 不含 `linux`：客户端暂无 linux 基线，后端 `x_os_type` 也不映射该平台，声明了也进不了运行门禁。
+ */
+declare const MINIAPP_LEGACY_DEFAULT_PLATFORM_VALUES: readonly ["android", "ios", "ohos", "windows", "macos"];
+/**
+ * 历史兜底平台集合的旧名称。
+ *
+ * @deprecated Since 0.8.3. 请改用 {@link MINIAPP_LEGACY_DEFAULT_PLATFORM_VALUES}，本别名取值与之一致，仅为不破坏既有 import 保留。
+ */
+declare const MINIAPP_LEGACY_MOBILE_PLATFORM_VALUES: readonly ["android", "ios", "ohos", "windows", "macos"];
+/**
+ * `package.json#heybox.window` 的开发者声明字段。
+ *
+ * @remarks
+ * 只描述**开窗初值**与可缩放性，不是窗口当前尺寸；运行期尺寸请用 `viewport.getWindowInfo()`。
+ * 位置（`x` / `y`）不开放声明，由用户拖拽产生并由宿主记忆。
+ */
+interface MiniappWindowDeclaration {
+    /** 默认窗口内容宽度（逻辑像素），正整数，不超过 16384。 */
+    defaultWidth?: number;
+    /** 默认窗口内容高度（逻辑像素），正整数，不超过 16384。 */
+    defaultHeight?: number;
+    /** 尺寸下限宽度；必须与 defaultWidth 同时声明，且不大于 defaultWidth。 */
+    minWidth?: number;
+    /** 尺寸下限高度；必须与 defaultHeight 同时声明，且不大于 defaultHeight。 */
+    minHeight?: number;
+    /** 是否允许用户手动拖拽改变尺寸。 */
+    resizable?: boolean;
+}
+/** 构建生成的小程序发布 Manifest；可选字段用于兼容历史产物，发布前仍需完整校验。 */
+interface MiniappManifest {
+    /** 原始产物可带额外元数据；发布校验返回值只保留已知字段。 */
+    [key: string]: unknown;
+    /** 展示名称；SDK `0.8.2` 起需与图标、封面一起提供。 */
+    name?: string;
+    /** 相对构建目录的图标路径。 */
+    icon?: string;
+    /** 相对构建目录的封面路径，1–5 张，按展示顺序排列。 */
+    coverImages?: string[];
+    /** 生成产物时实际安装的 hb-sdk 版本，不是小程序发布版本。 */
+    sdkVersion: string;
+    /** 小程序发布版本：完整 SemVer，可含 prerelease，不允许 build metadata 或 core `0.0.0`。 */
+    version: string;
+    /** 小程序承诺适配的非空、无重复目标平台列表。 */
+    platforms: readonly MiniappPlatform[];
+    /** 产物权限声明；SDK `0.9` 系列起必须显式提供，无权限需求时使用空对象。 */
+    permissions?: MiniappPermissionDeclarations;
+    /** 构建生成的 Companion 归档声明，不是含 source 目录的项目 authoring 配置。 */
+    companions?: MiniappCompanionManifestDeclarations;
+    /** 构建生成的工作区卡片不可变合同与执行制品回执。 */
+    workspaceCards?: WorkspaceCardsManifest;
+    /** 桌面窗口的可选初值、最小尺寸及是否可缩放。 */
+    window?: MiniappWindowDeclaration;
+    /** 关联游戏 App ID 字符串，最多 20 个；空列表在发布校验结果中省略。 */
+    bindAppIds?: readonly string[];
+    /** 发布类别；历史读取可缺省，发布校验必须提供。 */
+    category?: MiniappCategory;
+}
+/**
+ * 判断小程序版本是否符合公开 Manifest 版本规则。
+ *
+ * @param version - 待判断的 `package.json.version` / Manifest 版本字符串；首尾空白会先被
+ * 移除，但函数不会把规范化后的字符串返回给调用方。
+ * @returns trim 后满足小程序严格版本规则时返回 `true`，否则返回 `false`。对类型声明允许的
+ * 字符串输入，该函数只返回布尔值，不抛出校验错误。
+ *
+ * @remarks
+ * 接受形式为 canonical SemVer `MAJOR.MINOR.PATCH[-PRERELEASE]`。trim 后的输入必须与
+ * `semver` 严格解析得到的 `version` 完全相同，因此不完整版本（如 `1.2`）、`v` / `=`
+ * 前缀、范围表达式、额外段，以及 major/minor/patch 或纯数字 prerelease 标识中的前导零
+ * 都返回 `false`。只有首尾空白会被忽略，内部空白不会被修复。
+ *
+ * 合法 prerelease（如 `1.2.3-alpha.1`、`0.0.1-rc.0`）可以使用。build metadata 即使符合
+ * 标准 SemVer（如 `1.2.3+build.1`）也被小程序发布合同显式禁止。模板占位 core
+ * `0.0.0` 同样禁止，包括 `0.0.0-alpha` 等 prerelease；至少应提升 patch/minor/major
+ * 之一，例如 `0.0.1-alpha.1`。
+ *
+ * 这是无 I/O、无状态修改的 predicate，适合表单即时判断。实际 Vite / `hb-sdk build`
+ * 流程会调用同规则的 package version validator：成功时返回 trim 后版本并写入 Manifest，
+ * 失败时抛出带 `package.json.version` 来源的错误；调用本函数为 `true` 不能跳过正式构建。
+ *
+ * {@link resolveMiniappManifestPlatforms} 处理的是 Manifest `sdkVersion` 对平台声明策略的
+ * SemVer precedence，不是当前小程序的发布 `version`。不要用本函数替代平台解析，也不要
+ * 把项目 version 当作 sdkVersion 传入。
+ *
+ * @example
+ * ```ts
+ * import { isValidVersion } from '@heybox/hb-sdk/miniapp-publish'
+ *
+ * isValidVersion(' 1.2.3 ') // true
+ * isValidVersion('1.2.3-alpha.1') // true
+ * isValidVersion('0.0.1-alpha.1') // true
+ * isValidVersion('1.2') // false
+ * isValidVersion('v1.2.3') // false
+ * isValidVersion('1.2.3+build.1') // false
+ * isValidVersion('0.0.0-alpha') // false
+ * ```
+ *
+ * @see {@link resolveMiniappManifestPlatforms}
+ * @see {@link https://docs.xiaoheihe.cn/hb_sdk/reference/symbols/vite/functions/miniappManifest | miniappManifest}
+ */
+declare function isValidMiniappManifestVersion(version: string): boolean;
+/**
+ * 校验发布 Manifest 并返回规范化后的已知字段。
+ *
+ * @param manifest - 从构建产物读取的 Manifest，图片和 Companion 路径相对构建目录。
+ * @returns 新对象：规范化版本、名称、平台与游戏绑定，省略空绑定及未声明的可选字段；不保留未知字段。
+ * @throws `Error` 版本、平台、资料、权限、窗口、游戏绑定或生成的 Companion 声明非法，以及类别缺失时抛出。
+ * @remarks
+ * 不修改输入对象，不执行文件 I/O；不会验证图片/归档是否存在、内容摘要是否匹配，也不查询远端发布资格。
+ * 成功仅表示 Manifest 字段通过校验，不能替代文件检查与服务端发布预检。
+ */
+declare function validateMiniappManifestForDeploy(manifest: MiniappManifest): {
+    category?: MiniappCategory | undefined;
+    bindAppIds?: readonly string[] | undefined;
+    window?: MiniappWindowDeclaration | undefined;
+    workspaceCards?: WorkspaceCardsManifest | undefined;
+    companions?: MiniappCompanionManifestDeclarations | undefined;
+    permissions?: Partial<Record<"storage" | "workspaceCards" | "userInfo" | "steamLibrary" | "share" | "cloud_storage" | "filesystem" | "clipboard" | "leaderboard" | "companion" | "appProtocol", SimpleMiniappPermissionDeclaration> & {
+        network: NetworkMiniappPermissionDeclaration;
+    }> | undefined;
+    platforms: readonly ("windows" | "macos" | "android" | "ios" | "ohos" | "linux")[];
+    name?: string | undefined;
+    icon?: string | undefined;
+    coverImages?: string[] | undefined;
+    version: string;
+    sdkVersion: string;
+};
+/**
+ * Manifest 平台解析所采用的策略。
+ *
+ * @remarks
+ * - `explicit`：Manifest 自身拥有合法、非空的 `platforms` 字段；无论 sdkVersion 是否低于
+ *   `0.9.0`，显式声明都优先且不会被兼容默认值覆盖。
+ * - `legacy_mobile_default`：Manifest 完全没有 `platforms` 字段，且 sdkVersion 缺失/空白或
+ *   SemVer precedence 低于 `0.9.0`；最终按 {@link MINIAPP_LEGACY_DEFAULT_PLATFORM_VALUES} 兜底。
+ *
+ * 字面量 `legacy_mobile_default` 已作为详情接口 wire 值下发、并持久化进后端平台快照；
+ * 兜底集合虽已由移动端三件套扩为五平台，这里仍保持原字符串不变，避免存储与协议迁移。
+ */
+type MiniappPlatformPolicy = 'explicit' | 'legacy_mobile_default';
+/**
+ * Manifest 平台声明的规范化解析结果，供 CLI、开放平台网页、后端与 Runtime 共用。
+ *
+ * @remarks
+ * 返回对象通过 `Object.freeze()` 冻结，字段和数组在类型层也都是只读值。调用方应把其中
+ * 的数组视为不可变集合，不要修改、重新排序或自行合并 fallback。`platformsDeclared` 与
+ * `policy` 用于保留“显式声明”与“历史缺声明默认”的来源差异。
+ */
+interface MiniappPlatformResolution {
+    /**
+     * 规范化后的显式声明。`explicit` 时按固定顺序
+     * `android`、`ios`、`ohos`、`windows`、`macos`、`linux` 排列并只保留声明项；
+     * `legacy_mobile_default` 时是冻结的空数组，表示历史产物没有声明，而不是“不支持平台”。
+     */
+    readonly declared: readonly MiniappPlatform[];
+    /**
+     * 最终用于展示、校验和运行判断的平台集合。`explicit` 时与规范化后的 `declared` 相同；
+     * `legacy_mobile_default` 时固定为 {@link MINIAPP_LEGACY_DEFAULT_PLATFORM_VALUES}。
+     */
+    readonly effective: readonly MiniappPlatform[];
+    /**
+     * Manifest 是否拥有经过校验的显式 `platforms` 字段。显式声明时为 `true`，
+     * 历史 fallback 得到相同 effective 集合时仍为 `false`。
+     */
+    readonly platformsDeclared: boolean;
+    /** 本次解析采用的来源策略；与 `platformsDeclared` 保持一致。 */
+    readonly policy: MiniappPlatformPolicy;
+}
+/**
+ * 解析 Manifest 平台声明，是 `0.9.0` 硬切规则的唯一实现。
+ *
+ * @param sdkVersion - 产物写入 Manifest 的 hb-sdk 版本，不是小程序自身的发布 version。
+ * `undefined`、空字符串和纯空白按历史“缺失 sdkVersion”处理；其他字符串会先 trim，再按
+ * canonical strict SemVer 校验并参与 precedence 比较。
+ * @param manifest - 待解析的不可信 Manifest。必须是非 `null`、非数组的对象；函数只读取其
+ * 自有 `platforms` 字段，其他字段不参与平台解析。
+ * @returns 冻结的 {@link MiniappPlatformResolution}。显式声明返回规范排序后的 declared /
+ * effective；历史兼容返回空 declared 与历史兜底平台集合 effective。
+ * @throws `manifest` 不是对象时抛出；非空 sdkVersion 不完整、含 `v` 前缀或 build metadata、
+ * 不是 canonical SemVer 时抛出；sdkVersion precedence 达到 `0.9.0` 但缺少 platforms 时抛出；
+ * 显式 platforms 不是非空数组、包含未知/非字符串/重复平台时抛出。
+ *
+ * @remarks
+ * 解析顺序与后端领域层保持一致：先校验 Manifest 对象，再处理 sdkVersion；只要非空
+ * sdkVersion 非法，即使存在合法 platforms 也会抛出，不会忽略版本。版本比较使用 SemVer
+ * precedence，不做字符串比较：`0.9.0-alpha.1 < 0.9.0`，而 `0.10.0 > 0.9.0`。
+ *
+ * Manifest 拥有 `platforms` 字段时总是走 `explicit`：字段必须是非空数组，每项必须属于
+ * `MINIAPP_PLATFORM_VALUES` 且不能重复；结果按固定平台词表排序，而不是保留输入顺序。
+ * 该规则与 sdkVersion 是否缺失、低于或达到硬切点无关。显式声明一旦非法绝不回退到
+ * legacy 默认值。
+ *
+ * Manifest 完全没有 `platforms` 字段时才判断硬切：sdkVersion 缺失/空白，或 precedence
+ * 低于 `MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION`（`0.9.0`）时返回
+ * `legacy_mobile_default`；`0.9.0` 稳定版及更高版本直接抛错。`0.9.0-*` prerelease 仍低于
+ * 稳定硬切点，因此可解析历史缺失声明。
+ *
+ * 返回对象被 `Object.freeze()`；显式声明数组和 legacy 的空 declared 数组也被冻结。所有
+ * 数组均以 readonly 合同暴露，调用方应直接消费 `effective`，不得再比较版本或补默认值。
+ *
+ * 当前 Vite 构建入口
+ * {@link https://docs.xiaoheihe.cn/hb_sdk/reference/symbols/vite/functions/miniappManifest | miniappManifest}
+ * 会从 `package.json#heybox.platforms` 读取并写入显式声明；legacy 分支只用于解析缺少字段
+ * 的历史产物，不是新项目省略 platforms 的许可。
+ *
+ * {@link https://docs.xiaoheihe.cn/hb_sdk/reference/symbols/miniapp-publish/functions/isValidVersion | isValidVersion}
+ * 判断的是小程序发布 `version`，并额外拒绝模板值 `0.0.0`；本函数的 sdkVersion 是 hb-sdk
+ * 版本，`0.0.0` 本身是可比较的 strict SemVer 并低于硬切点。两类版本不能互换校验。
+ *
+ * @example
+ * ```ts
+ * import { resolveMiniappManifestPlatforms } from '@heybox/hb-sdk/miniapp-publish'
+ *
+ * const explicit = resolveMiniappManifestPlatforms('0.9.0', {
+ *   platforms: ['linux', 'android', 'macos'],
+ * })
+ * console.log(explicit)
+ * // {
+ * //   declared: ['android', 'macos', 'linux'],
+ * //   effective: ['android', 'macos', 'linux'],
+ * //   platformsDeclared: true,
+ * //   policy: 'explicit'
+ * // }
+ *
+ * const legacy = resolveMiniappManifestPlatforms('0.9.0-alpha.1', {})
+ * console.log(legacy.effective) // ['android', 'ios', 'ohos', 'windows', 'macos']
+ * ```
+ *
+ * @see {@link MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION}
+ * @see {@link MINIAPP_LEGACY_DEFAULT_PLATFORM_VALUES}
+ * @see {@link https://docs.xiaoheihe.cn/hb_sdk/reference/symbols/miniapp-publish/functions/isValidVersion | isValidVersion}
+ * @see {@link https://docs.xiaoheihe.cn/hb_sdk/reference/symbols/vite/functions/miniappManifest | miniappManifest}
+ */
+declare function resolveMiniappManifestPlatforms(sdkVersion: string | undefined, manifest: unknown): MiniappPlatformResolution;
+
+/**
+ * {@link parseMiniappBindAppIds} 的诊断文案配置。
+ *
+ * @remarks
+ * 该选项只改变抛出 `Error` 的来源前缀，不改变校验、排序或返回值。函数不会 trim、补全或
+ * 校验标签；调用方应传能准确定位配置位置的非空文本。
+ */
+interface ParseMiniappBindAppIdsOptions {
+    /**
+     * 写入每条错误消息开头的来源标签，默认 `package.json#heybox.bindAppIds`。
+     *
+     * @remarks
+     * Manifest 校验器会传 `manifest.bindAppIds`，因此同一个非法值可明确指出来自项目声明还是
+     * 构建产物。传入值会原样插入文案，不会自动添加冒号、路径或字段名。
+     */
+    sourceLabel?: string;
+}
+/**
+ * 校验并规范化小程序关联的游戏 App ID。
+ *
+ * @param value - 不可信声明。`undefined` 和 `[]` 均返回空绑定；其他值必须是最多 20 项的
+ * 字符串数组，不接受 `null`、单个字符串、number 数组或类数组对象。
+ * @param options - 可选诊断来源；`sourceLabel` 默认 `package.json#heybox.bindAppIds`，并原样
+ * 作为所有错误消息的前缀。
+ * @returns 新建、按 appid 数值升序排列且经 `Object.freeze` 冻结的 `readonly string[]`。
+ * 输入数组及其顺序不会被修改；空输入也返回新的冻结空数组。
+ * @throws `Error` `${sourceLabel} 必须是字符串数组`：`value` 不是数组。
+ * @throws `Error` `${sourceLabel} 最多包含 20 个游戏 appid`：输入数组超过 20 项；数量检查
+ * 先于逐项格式检查。
+ * @throws `Error` `${sourceLabel} 包含非法游戏 appid：<value>`：任一项不是 string，或不匹配
+ * `/^[1-9]\d*$/`。因此空串、首尾空白、`0`、前导零、正负号、小数、指数和非十进制字符
+ * 都不会被自动修正。
+ * @throws `Error` `${sourceLabel} 包含超出正 int32 范围的游戏 appid：<value>`：十进制值
+ * 大于 `2147483647` 或不能成为安全整数。
+ * @throws `Error` `${sourceLabel} 包含重复游戏 appid：<value>`：规范字符串在同一数组重复。
+ *
+ * @remarks
+ * 合法范围是闭区间 `1..2147483647`，每项在输出中仍保持十进制 string。排序按数值而不是
+ * 字典序执行，所以 `['3513350', '730', '10']` 输出为 `['10', '730', '3513350']`。
+ * 函数先复制后排序并冻结结果，不排序或冻结调用方传入的数组。
+ *
+ * 这是同步、纯离线的格式规范化函数，不访问网络，也不确认 appid 是否真实存在、可绑定或
+ * 属于当前开发者。`miniappManifest()` 用它校验 `package.json#heybox.bindAppIds` 并把非空结果
+ * 写入 Manifest；远端 deploy 预检和提审才校验游戏可用性。缺失和空数组在普通构建中都表示
+ * 无绑定，函数本身不处理 `remote deploy --from-version` 的历史快照继承语义。
+ *
+ * `bindAppIds` 是版本发布元数据，不是 Runtime 权限，也不会因调用
+ * [navigation.openAppPage](/reference/sdk/navigation/openAppPage) 而变化。后者的 `appId` 是一次
+ * 页面导航参数，允许 string 或 number、只要求字符串化后非空，不适用本函数的数组、int32、
+ * 前导零、去重、20 项或排序规则。
+ *
+ * @example
+ * ```ts
+ * import { parseMiniappBindAppIds } from '@heybox/hb-sdk/miniapp-publish'
+ *
+ * const declared = ['3513350', '730', '10']
+ * const appIds = parseMiniappBindAppIds(declared)
+ *
+ * console.log(appIds) // ['10', '730', '3513350']
+ * console.log(declared) // ['3513350', '730', '10']，输入顺序不变
+ * console.log(Object.isFrozen(appIds)) // true
+ * ```
+ *
+ * @see [miniappManifest](/reference/symbols/vite/functions/miniappManifest)
+ * @see [navigation.openAppPage](/reference/sdk/navigation/openAppPage)
+ * @see [CLI 与远端发布](/guide/cli#生产构建)
+ */
+declare function parseMiniappBindAppIds(value: unknown, options?: ParseMiniappBindAppIdsOptions): readonly string[];
+
+/** 小程序展示资料；项目声明和构建产物使用相同字段，图片路径的根目录不同。 */
+interface MiniappBasicInfo {
+    /** NFKC 规范化并移除首尾 Unicode 空白后的名称，长度为 1–40 个 Unicode code point。 */
+    name: string;
+    /** 图标的规范相对路径；项目声明相对项目目录，Manifest 相对构建目录。 */
+    icon: string;
+    /** 1–5 个互不重复的封面相对路径，按展示顺序排列。 */
+    coverImages: string[];
+}
+/**
+ * 规范化并校验小程序展示名称。
+ *
+ * @param raw - 原始名称，必须是字符串。
+ * @returns NFKC 规范化、去除首尾 Unicode White_Space 后的名称；不折叠规范化后的内部空白。
+ * @throws `Error` 输入不是字符串，或规范化后不是 1–40 个 Unicode code point、不含文字或数字，或包含控制字符、
+ * 格式字符、行/段分隔符以及 HTML 特殊字符 `<`、`>`、`&`、双引号或单引号时抛出。
+ */
+declare function normalizeBasicInfoName(raw: unknown): string;
+/**
+ * 校验项目声明或 Manifest 中的小程序展示资料。
+ *
+ * @param value - `package.json#heybox` 或 Manifest 对象，读取 `name`、`icon`、`coverImages`。
+ * @param sdkVersion - 产物 SDK 版本，默认 `0.8.2`；用于判断历史产物是否允许缺失全部资料。
+ * @returns 名称规范化后的新资料对象；仅版本早于 `0.8.2` 且三项均无自有属性时返回 `undefined`。
+ * @throws `Error` SDK 版本非法、资料字段不齐、名称/图片路径非法，或封面不是 1–5 个互不重复的路径时抛出。
+ * @remarks
+ * 图片路径必须使用 `/` 分隔的非空相对路径，扩展名为 JPEG、PNG、GIF 或 WebP；拒绝 URL、点段、
+ * 控制字符和构建/缓存等保留目录。此函数只校验声明，不读取文件，也不验证图片字节、尺寸或存在性。
+ */
+declare function parseMiniappBasicInfo(value: Record<string, unknown>, sdkVersion?: string): MiniappBasicInfo | undefined;
+
+/**
+ * 在浏览器中校验构建产物的展示资料图片，并创建预览 URL。
+ *
+ * @param manifest - 构建产物 Manifest，必须包含合法的 `sdkVersion`。
+ * @param files - 构建文件列表；`relativePath` 必须精确匹配 Manifest 中的图片路径。
+ * @returns 名称、图标 `icon_url` 和按原顺序排列的 `cover_image_urls`；允许缺失资料的历史产物返回 `undefined`。
+ * @throws `Error` 资料非法、图片缺失/为空/超过 10 MiB、格式与扩展名不符、超过 4000 万像素、
+ * icon 不是 200×200，或仍使用脚手架占位图片时拒绝；浏览器解码和摘要计算失败也会拒绝。
+ * @remarks
+ * 需要浏览器提供 `crypto.subtle`、`createImageBitmap` 和 object URL API；不生成或回写 Manifest。
+ * 失败时会释放本次已创建的 URL；成功后所有 URL 由调用方在预览结束或替换时释放。
+ * @example
+ * ```ts
+ * import { previewMiniappBasicInfo } from '@heybox/hb-sdk/miniapp-publish';
+ *
+ * const preview = await previewMiniappBasicInfo(manifest, files);
+ * if (preview) {
+ *   try {
+ *     const image = new Image();
+ *     image.src = preview.icon_url;
+ *     await image.decode();
+ *     document.body.append(image);
+ *   } finally {
+ *     // 已加载的图像可继续显示；不再需要从这些 URL 加载时释放。
+ *     [preview.icon_url, ...preview.cover_image_urls].forEach(URL.revokeObjectURL);
+ *   }
+ * }
+ * ```
+ */
+declare function previewMiniappBasicInfo(manifest: Record<string, unknown>, files: readonly {
+    relativePath: string;
+    file: Blob;
+}[]): Promise<{
+    name: string;
+    icon_url: string;
+    cover_image_urls: string[];
+} | undefined>;
+
+/**
+ * 检查 HTML 是否包含 Runtime Gate 的三个结构标记。
+ *
+ * @param html - 待检查的完整 HTML 文本，使用 HTML parser 解析。
+ * @returns Gate、隐藏样式及 bootstrap 标记均出现时返回 `true`，否则返回 `false`。
+ * @remarks 只识别标记，不验证脚本内容、标记所在节点或宿主握手；不能据此判断页面安全或实际可运行。
+ */
+declare function hasMiniappRuntimeGate(html: string): boolean;
+
 /** CDN 上传接口使用的小程序产物业务 scope。 */
-export declare const MINIAPP_UPLOAD_SCOPE = "activity";
+declare const MINIAPP_UPLOAD_SCOPE = "activity";
 /** 完整 CDN 上传 key 的默认长度上限；旧固定版本流程按字符计数，上传会话流程按 UTF-8 bytes 计数。 */
-export declare const ACTIVITY_UPLOAD_KEY_MAX_LENGTH = 64;
+declare const ACTIVITY_UPLOAD_KEY_MAX_LENGTH = 64;
 /** 单次向 CDN 申请上传信息时包含的最大文件数；当前合同固定为 `50`。 */
-export declare const MINIAPP_UPLOAD_BATCH_SIZE = 50;
+declare const MINIAPP_UPLOAD_BATCH_SIZE = 50;
 /** Web 构建产物的默认总大小上限，单位为 bytes；当前为 100 MiB。 */
-export declare const MINIAPP_UPLOAD_TOTAL_SIZE_LIMIT_BYTES: number;
+declare const MINIAPP_UPLOAD_TOTAL_SIZE_LIMIT_BYTES: number;
 /** Companion 归档的临时总大小上限，单位为 bytes；当前为 500 MiB。 */
-export declare const MINIAPP_COMPANION_UPLOAD_TEMPORARY_SIZE_LIMIT_BYTES: number;
+declare const MINIAPP_COMPANION_UPLOAD_TEMPORARY_SIZE_LIMIT_BYTES: number;
 /** 查询当前开发者账号是否具备小程序访问资格的开放平台 API 路径。 */
-export declare const USER_MINIPROGRAM_ACCESS_STATUS_API_PATH = "/mall/developer/user_miniprogram/access_status";
+declare const USER_MINIPROGRAM_ACCESS_STATUS_API_PATH = "/mall/developer/user_miniprogram/access_status";
 /** 查询当前开发者可管理主体列表的开放平台 API 路径。 */
-export declare const DEVELOPER_ENTITY_LIST_API_PATH = "/mall/developer/entity/list";
+declare const DEVELOPER_ENTITY_LIST_API_PATH = "/mall/developer/entity/list";
 /** 切换当前开发者主体的开放平台 API 路径。 */
-export declare const DEVELOPER_ENTITY_SWITCH_API_PATH = "/mall/developer/entity/switch";
+declare const DEVELOPER_ENTITY_SWITCH_API_PATH = "/mall/developer/entity/switch";
 /** 查询当前主体下小程序列表的开放平台 API 路径。 */
-export declare const LIST_USER_MINIPROGRAM_API_PATH = "/mall/developer/user_miniprogram/list";
+declare const LIST_USER_MINIPROGRAM_API_PATH = "/mall/developer/user_miniprogram/list";
 /** 创建小程序的开放平台 API 路径。 */
-export declare const CREATE_USER_MINIPROGRAM_API_PATH = "/mall/developer/user_miniprogram/create";
+declare const CREATE_USER_MINIPROGRAM_API_PATH = "/mall/developer/user_miniprogram/create";
 /** 查询单个小程序详情的开放平台 API 路径。 */
-export declare const DETAIL_USER_MINIPROGRAM_API_PATH = "/mall/developer/user_miniprogram/detail";
+declare const DETAIL_USER_MINIPROGRAM_API_PATH = "/mall/developer/user_miniprogram/detail";
 /** 创建本地开发启动凭据的开放平台 API 路径。 */
-export declare const CREATE_USER_MINIPROGRAM_LOCAL_DEV_LAUNCH_TOKEN_API_PATH = "/mall/developer/user_miniprogram/local_dev_launch_token";
+declare const CREATE_USER_MINIPROGRAM_LOCAL_DEV_LAUNCH_TOKEN_API_PATH = "/mall/developer/user_miniprogram/local_dev_launch_token";
 /** 查询小程序预览白名单的开放平台 API 路径。 */
-export declare const USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH = "/mall/developer/user_miniprogram/preview_allowlist";
+declare const USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH = "/mall/developer/user_miniprogram/preview_allowlist";
 /** 更新小程序预览白名单的开放平台 API 路径。 */
-export declare const UPDATE_USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH = "/mall/developer/user_miniprogram/preview_allowlist/update";
+declare const UPDATE_USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH = "/mall/developer/user_miniprogram/preview_allowlist/update";
 /** 创建小程序云排行榜的开放平台 API 路径。 */
-export declare const CREATE_USER_MINIPROGRAM_LEADERBOARD_API_PATH = "/mall/developer/user_miniprogram/leaderboard/create";
+declare const CREATE_USER_MINIPROGRAM_LEADERBOARD_API_PATH = "/mall/developer/user_miniprogram/leaderboard/create";
 /** 查询单个小程序云排行榜详情的开放平台 API 路径。 */
-export declare const DETAIL_USER_MINIPROGRAM_LEADERBOARD_API_PATH = "/mall/developer/user_miniprogram/leaderboard/detail";
+declare const DETAIL_USER_MINIPROGRAM_LEADERBOARD_API_PATH = "/mall/developer/user_miniprogram/leaderboard/detail";
 /** 查询小程序云排行榜列表的开放平台 API 路径。 */
-export declare const LIST_USER_MINIPROGRAM_LEADERBOARD_API_PATH = "/mall/developer/user_miniprogram/leaderboard/list";
+declare const LIST_USER_MINIPROGRAM_LEADERBOARD_API_PATH = "/mall/developer/user_miniprogram/leaderboard/list";
 /** 删除小程序云排行榜的开放平台 API 路径。 */
-export declare const DELETE_USER_MINIPROGRAM_LEADERBOARD_API_PATH = "/mall/developer/user_miniprogram/leaderboard/delete";
+declare const DELETE_USER_MINIPROGRAM_LEADERBOARD_API_PATH = "/mall/developer/user_miniprogram/leaderboard/delete";
 /** 在上传或复用版本前执行发布预检的开放平台 API 路径。 */
-export declare const PRECHECK_USER_MINIPROGRAM_VERSION_API_PATH = "/mall/developer/user_miniprogram/version/precheck";
+declare const PRECHECK_USER_MINIPROGRAM_VERSION_API_PATH = "/mall/developer/user_miniprogram/version/precheck";
 /** 将小程序版本提交审核的开放平台 API 路径。 */
-export declare const SUBMIT_USER_MINIPROGRAM_AUDIT_API_PATH = "/mall/developer/user_miniprogram/version/submit_audit";
+declare const SUBMIT_USER_MINIPROGRAM_AUDIT_API_PATH = "/mall/developer/user_miniprogram/version/submit_audit";
 /** 查询小程序版本预览信息的开放平台 API 路径。 */
-export declare const USER_MINIPROGRAM_VERSION_PREVIEW_INFO_API_PATH = "/mall/developer/user_miniprogram/version/preview_info";
+declare const USER_MINIPROGRAM_VERSION_PREVIEW_INFO_API_PATH = "/mall/developer/user_miniprogram/version/preview_info";
 /** 撤回待审核小程序版本的开放平台 API 路径。 */
-export declare const WITHDRAW_USER_MINIPROGRAM_VERSION_API_PATH = "/mall/developer/user_miniprogram/version/withdraw";
+declare const WITHDRAW_USER_MINIPROGRAM_VERSION_API_PATH = "/mall/developer/user_miniprogram/version/withdraw";
 /** 发布审核通过的小程序版本的开放平台 API 路径。 */
-export declare const RELEASE_USER_MINIPROGRAM_VERSION_API_PATH = "/mall/developer/user_miniprogram/version/release";
+declare const RELEASE_USER_MINIPROGRAM_VERSION_API_PATH = "/mall/developer/user_miniprogram/version/release";
 /** 下架当前线上小程序的开放平台 API 路径。 */
-export declare const TAKE_DOWN_USER_MINIPROGRAM_API_PATH = "/mall/developer/user_miniprogram/take_down";
+declare const TAKE_DOWN_USER_MINIPROGRAM_API_PATH = "/mall/developer/user_miniprogram/take_down";
 /** 重新开放已下架小程序的开放平台 API 路径。 */
-export declare const REOPEN_USER_MINIPROGRAM_API_PATH = "/mall/developer/user_miniprogram/reopen";
+declare const REOPEN_USER_MINIPROGRAM_API_PATH = "/mall/developer/user_miniprogram/reopen";
 /** 更新小程序广场展示状态的开放平台 API 路径。 */
-export declare const UPDATE_SQUARE_DISPLAY_API_PATH = "/mall/developer/user_miniprogram/square_display/update";
+declare const UPDATE_SQUARE_DISPLAY_API_PATH = "/mall/developer/user_miniprogram/square_display/update";
 /** 查询小程序历史版本列表的开放平台 API 路径。 */
-export declare const LIST_USER_MINIPROGRAM_VERSION_API_PATH = "/mall/developer/user_miniprogram/version/list";
-export { parseMiniappCategory, type MiniappCategory } from '../miniapp-manifest/category';
-export { isValidMiniappManifestVersion as isValidVersion } from '../miniapp-manifest/schema';
-export { MINIAPP_LEGACY_DEFAULT_PLATFORM_VALUES, MINIAPP_LEGACY_MOBILE_PLATFORM_VALUES, MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION, resolveMiniappManifestPlatforms, type MiniappPlatformPolicy, type MiniappPlatformResolution, } from '../miniapp-manifest/schema';
-export { parseMiniappBindAppIds, type ParseMiniappBindAppIdsOptions } from '../miniapp-manifest/bindings';
+declare const LIST_USER_MINIPROGRAM_VERSION_API_PATH = "/mall/developer/user_miniprogram/version/list";
+
 /**
  * 将扫描到的相对路径转换为统一的 `/` 分隔形式。
  *
@@ -79,7 +559,7 @@ export { parseMiniappBindAppIds, type ParseMiniappBindAppIdsOptions } from '../m
  * @see {@link shouldUploadDistFile}
  * @see {@link https://docs.xiaoheihe.cn/hb_sdk/reference/symbols/protocol/functions/isMiniProgramRelativePath | isMiniProgramRelativePath}
  */
-export declare function normalizeRelativePath(relativePath: string): string;
+declare function normalizeRelativePath(relativePath: string): string;
 /**
  * 判断路径中是否包含大小写不敏感的完整 `node_modules` 目录段。
  *
@@ -104,7 +584,7 @@ export declare function normalizeRelativePath(relativePath: string): string;
  * @see [shouldUploadDistFile](/reference/symbols/miniapp-publish/functions/shouldUploadDistFile)
  * @see [miniapp-publish](/reference/miniapp-publish/)
  */
-export declare function relativePathContainsNodeModulesSegment(relativePath: string): boolean;
+declare function relativePathContainsNodeModulesSegment(relativePath: string): boolean;
 /**
  * 为小程序 ID 计算稳定、紧凑的上传路径别名。
  *
@@ -117,9 +597,9 @@ export declare function relativePathContainsNodeModulesSegment(relativePath: str
  * console.log(/^[a-z0-9]+$/.test(alias)); // true
  * ```
  */
-export declare function getMiniProgramUploadAlias(miniProgramId: string): string;
+declare function getMiniProgramUploadAlias(miniProgramId: string): string;
 /** 生成旧版固定版本上传 key 所需的输入。 */
-export interface MiniappUploadKeyInput {
+interface MiniappUploadKeyInput {
     /** 小程序 ID；函数会将其转换为稳定上传别名。 */
     miniProgramId: string;
     /** 要写入上传 key 的版本字符串；调用方应先完成版本合法性校验。 */
@@ -142,14 +622,14 @@ export interface MiniappUploadKeyInput {
  * }); // /u/<alias>/1.2.3/assets/app.js
  * ```
  */
-export declare function getMiniappUploadKey(input: MiniappUploadKeyInput): string;
+declare function getMiniappUploadKey(input: MiniappUploadKeyInput): string;
 /** 参与旧版上传路径校验的构建产物条目。 */
-export interface UploadPathItem {
+interface UploadPathItem {
     /** 构建产物相对路径。 */
     relativePath: string;
 }
 /** 旧版固定版本上传路径的校验选项。 */
-export interface ValidateUploadPathsOptions {
+interface ValidateUploadPathsOptions {
     /** 小程序 ID，用于计算上传 key 中的稳定别名。 */
     miniProgramId: string;
     /** 要写入上传 key 的版本字符串。 */
@@ -175,7 +655,7 @@ export interface ValidateUploadPathsOptions {
  * if (error) throw new Error(error);
  * ```
  */
-export declare function validateUploadPaths(items: UploadPathItem[], options: ValidateUploadPathsOptions): string | undefined;
+declare function validateUploadPaths(items: UploadPathItem[], options: ValidateUploadPathsOptions): string | undefined;
 /**
  * 参与上传总大小计算的构建产物条目。
  *
@@ -183,7 +663,7 @@ export declare function validateUploadPaths(items: UploadPathItem[], options: Va
  * {@link validateUploadTotalSize} 只读取 `size`，不会读取或校验 `relativePath`。同一类型也供
  * `validateMiniappUploadSizeBudgets()` 使用，后者才根据规范化路径区分 Web 与 Companion 预算。
  */
-export interface UploadSizeItem {
+interface UploadSizeItem {
     /**
      * 构建产物相对路径。直接调用 {@link validateUploadTotalSize} 时该字段不参与计算；预算包装
      * 函数会把规范化后以 `companions/` 开头的路径归入 Companion 组。
@@ -196,7 +676,7 @@ export interface UploadSizeItem {
     size: number;
 }
 /** {@link validateUploadTotalSize} 的总量上限选项。 */
-export interface ValidateUploadTotalSizeOptions {
+interface ValidateUploadTotalSizeOptions {
     /**
      * 总大小上限，单位为 bytes；省略时使用 `MINIAPP_UPLOAD_TOTAL_SIZE_LIMIT_BYTES`，当前为
      * `104857600` bytes（100 MiB）。总和恰好等于上限仍合法，只有严格大于才算超限。
@@ -264,7 +744,7 @@ export interface ValidateUploadTotalSizeOptions {
  * @see [shouldUploadDistFile](/reference/symbols/miniapp-publish/functions/shouldUploadDistFile)
  * @see [miniapp-publish](/reference/miniapp-publish/)
  */
-export declare function validateUploadTotalSize(items: UploadSizeItem[], options?: ValidateUploadTotalSizeOptions): "构建产物总大小超过 100MB，请删除未引用资源或压缩图片后重新 deploy" | undefined;
+declare function validateUploadTotalSize(items: UploadSizeItem[], options?: ValidateUploadTotalSizeOptions): "构建产物总大小超过 100MB，请删除未引用资源或压缩图片后重新 deploy" | undefined;
 /**
  * 分别校验 Web 构建产物与 Companion 归档的总大小预算。
  *
@@ -281,7 +761,7 @@ export declare function validateUploadTotalSize(items: UploadSizeItem[], options
  * if (error) throw new Error(error);
  * ```
  */
-export declare function validateMiniappUploadSizeBudgets(items: UploadSizeItem[], options?: {
+declare function validateMiniappUploadSizeBudgets(items: UploadSizeItem[], options?: {
     webLimitBytes?: number;
     companionLimitBytes?: number;
 }): "构建产物总大小超过 100MB，请删除未引用资源或压缩图片后重新 deploy" | "Companion 归档总大小超过 500MiB 上限，请缩减归档后重新 deploy" | undefined;
@@ -338,25 +818,25 @@ export declare function validateMiniappUploadSizeBudgets(items: UploadSizeItem[]
  * @see [validateUploadTotalSize](/reference/symbols/miniapp-publish/functions/validateUploadTotalSize)
  * @see [miniapp-publish](/reference/miniapp-publish/)
  */
-export declare function shouldUploadDistFile(relativePath: string): boolean;
+declare function shouldUploadDistFile(relativePath: string): boolean;
 /**
  * 参与整包签名和上传会话映射的构建产物文件。
  *
  * 路径必须是规范相对路径，大小必须是大于或等于 `0` 的 safe integer。
  */
-export interface MiniappArtifactFile {
+interface MiniappArtifactFile {
     /** 使用 `/` 分隔的构建产物相对路径；不能包含绝对路径、点目录段、控制字符、逗号或通配符。 */
     relativePath: string;
     /** 文件大小，单位为 bytes；必须是大于或等于 `0` 的 safe integer。 */
     size: number;
 }
 /** 上传会话使用的逐文件完整性凭据，由本地文件内容计算。 */
-export interface MiniappArtifactFileReceipt extends MiniappArtifactFile {
+interface MiniappArtifactFileReceipt extends MiniappArtifactFile {
     /** 文件内容 SHA-256，使用 64 位小写十六进制字符串。 */
     sha256: string;
 }
 /** 服务端上传会话返回的单个文件映射。 */
-export interface MiniappUploadSessionFile {
+interface MiniappUploadSessionFile {
     /** 与创建会话时提交值一致的规范相对路径。 */
     relative_path: string;
     /** 服务端签发的非空完整 CDN 上传 key；同一会话内必须唯一。 */
@@ -367,7 +847,7 @@ export interface MiniappUploadSessionFile {
     sha256: string;
 }
 /** v2 上传会话复用的已验证 Companion Blob，不包含会话 CDN key。 */
-export interface MiniappReusedCompanionFile {
+interface MiniappReusedCompanionFile {
     relative_path: string;
     size: number;
     sha256: string;
@@ -391,7 +871,7 @@ export interface MiniappReusedCompanionFile {
  * // ['assets/app.js', 'index.html']
  * ```
  */
-export declare function prepareMiniappArtifactFiles<T extends MiniappArtifactFile>(files: readonly T[]): (T & {
+declare function prepareMiniappArtifactFiles<T extends MiniappArtifactFile>(files: readonly T[]): (T & {
     relativePath: string;
 })[];
 /**
@@ -411,7 +891,7 @@ export declare function prepareMiniappArtifactFiles<T extends MiniappArtifactFil
  * if (error) throw new Error(error);
  * ```
  */
-export declare function validateMiniappUploadPathLengths(files: readonly Pick<MiniappArtifactFile, 'relativePath'>[], options: {
+declare function validateMiniappUploadPathLengths(files: readonly Pick<MiniappArtifactFile, 'relativePath'>[], options: {
     miniProgramId: string;
     maxLength?: number;
 }): string | undefined;
@@ -427,7 +907,7 @@ export declare function validateMiniappUploadPathLengths(files: readonly Pick<Mi
  * // 将 header 写入 SHA-256，再按排序结果依次写入文件 header 和内容。
  * ```
  */
-export declare function createMiniappArtifactSignatureHeader(fileCount: number): Uint8Array<ArrayBuffer>;
+declare function createMiniappArtifactSignatureHeader(fileCount: number): Uint8Array<ArrayBuffer>;
 /**
  * 创建单个文件的 v1 framing header。
  *
@@ -442,7 +922,7 @@ export declare function createMiniappArtifactSignatureHeader(fileCount: number):
  * });
  * ```
  */
-export declare function createMiniappArtifactFileHeader(file: MiniappArtifactFile): Uint8Array<ArrayBuffer>;
+declare function createMiniappArtifactFileHeader(file: MiniappArtifactFile): Uint8Array<ArrayBuffer>;
 /**
  * 校验服务端 session 文件映射，并计算仍需上传的文件。
  *
@@ -471,7 +951,7 @@ export declare function createMiniappArtifactFileHeader(file: MiniappArtifactFil
  * console.log(resolved.missingFiles.length); // 1
  * ```
  */
-export declare function resolveMiniappUploadSessionFiles<T extends MiniappArtifactFile>(localFiles: readonly T[], serverFiles: readonly MiniappUploadSessionFile[], uploadedKeys: readonly string[], reusedCompanionFiles: readonly MiniappReusedCompanionFile[]): {
+declare function resolveMiniappUploadSessionFiles<T extends MiniappArtifactFile>(localFiles: readonly T[], serverFiles: readonly MiniappUploadSessionFile[], uploadedKeys: readonly string[], reusedCompanionFiles: readonly MiniappReusedCompanionFile[]): {
     files: {
         file: T & {
             relativePath: string;
@@ -514,16 +994,14 @@ export declare function resolveMiniappUploadSessionFiles<T extends MiniappArtifa
  * }, receipt);
  * ```
  */
-export declare function validateMiniappCompanionFileReceipts(companions: unknown, files: readonly MiniappArtifactFileReceipt[]): void;
-export { parseMiniappBasicInfo, normalizeBasicInfoName } from '../miniapp-manifest/basic-info';
-export { previewMiniappBasicInfo } from '../miniapp-manifest/basic-info-browser';
-export { validateMiniappManifestForDeploy } from '../miniapp-manifest/schema';
-export type { MiniappBasicInfo } from '../miniapp-manifest/basic-info';
-export type { MiniappManifest, MiniappWindowDeclaration } from '../miniapp-manifest/schema';
-export type { MiniappCompanionManifestDeclarations, MiniappCompanionManifestDefinition, MiniappCompanionManifestTarget, MiniappCompanionTarget, MiniappCompanionCapability, } from '../miniapp-manifest/companion-types';
-export type { MiniappPermissionDeclarations, NetworkMiniappPermissionDeclaration, SimpleMiniappPermissionDeclaration, } from '../miniapp-manifest/permissions';
-export { hasMiniappRuntimeGate } from '../miniapp-manifest/runtime-gate';
+declare function validateMiniappCompanionFileReceipts(companions: unknown, files: readonly MiniappArtifactFileReceipt[]): void;
+/** 工作区制品与同一次上传 receipt 精确匹配，拒绝未声明的执行文件。 */
+declare function validateMiniappWorkspaceCardFileReceipts(value: unknown, files: readonly MiniappArtifactFileReceipt[]): void;
+
 /** 查询平台权限目录和最近申请。 */
-export declare const LIST_USER_MINIPROGRAM_PERMISSION_APPLICATION_API_PATH = "/mall/developer/user_miniprogram/runtime_permission/application_list";
+declare const LIST_USER_MINIPROGRAM_PERMISSION_APPLICATION_API_PATH = "/mall/developer/user_miniprogram/runtime_permission/application_list";
 /** 提交不绑定版本的平台权限申请。 */
-export declare const SUBMIT_USER_MINIPROGRAM_PERMISSION_APPLICATION_API_PATH = "/mall/developer/user_miniprogram/runtime_permission/application_submit";
+declare const SUBMIT_USER_MINIPROGRAM_PERMISSION_APPLICATION_API_PATH = "/mall/developer/user_miniprogram/runtime_permission/application_submit";
+
+export { ACTIVITY_UPLOAD_KEY_MAX_LENGTH, CREATE_USER_MINIPROGRAM_API_PATH, CREATE_USER_MINIPROGRAM_LEADERBOARD_API_PATH, CREATE_USER_MINIPROGRAM_LOCAL_DEV_LAUNCH_TOKEN_API_PATH, DELETE_USER_MINIPROGRAM_LEADERBOARD_API_PATH, DETAIL_USER_MINIPROGRAM_API_PATH, DETAIL_USER_MINIPROGRAM_LEADERBOARD_API_PATH, DEVELOPER_ENTITY_LIST_API_PATH, DEVELOPER_ENTITY_SWITCH_API_PATH, LIST_USER_MINIPROGRAM_API_PATH, LIST_USER_MINIPROGRAM_LEADERBOARD_API_PATH, LIST_USER_MINIPROGRAM_PERMISSION_APPLICATION_API_PATH, LIST_USER_MINIPROGRAM_VERSION_API_PATH, MINIAPP_COMPANION_UPLOAD_TEMPORARY_SIZE_LIMIT_BYTES, MINIAPP_LEGACY_DEFAULT_PLATFORM_VALUES, MINIAPP_LEGACY_MOBILE_PLATFORM_VALUES, MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION, MINIAPP_UPLOAD_BATCH_SIZE, MINIAPP_UPLOAD_SCOPE, MINIAPP_UPLOAD_TOTAL_SIZE_LIMIT_BYTES, PRECHECK_USER_MINIPROGRAM_VERSION_API_PATH, RELEASE_USER_MINIPROGRAM_VERSION_API_PATH, REOPEN_USER_MINIPROGRAM_API_PATH, SUBMIT_USER_MINIPROGRAM_AUDIT_API_PATH, SUBMIT_USER_MINIPROGRAM_PERMISSION_APPLICATION_API_PATH, TAKE_DOWN_USER_MINIPROGRAM_API_PATH, UPDATE_SQUARE_DISPLAY_API_PATH, UPDATE_USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH, USER_MINIPROGRAM_ACCESS_STATUS_API_PATH, USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH, USER_MINIPROGRAM_VERSION_PREVIEW_INFO_API_PATH, WITHDRAW_USER_MINIPROGRAM_VERSION_API_PATH, createMiniappArtifactFileHeader, createMiniappArtifactSignatureHeader, getMiniProgramUploadAlias, getMiniappUploadKey, hasMiniappRuntimeGate, isValidMiniappManifestVersion as isValidVersion, normalizeBasicInfoName, normalizeRelativePath, parseMiniappBasicInfo, parseMiniappBindAppIds, parseMiniappCategory, prepareMiniappArtifactFiles, previewMiniappBasicInfo, relativePathContainsNodeModulesSegment, resolveMiniappManifestPlatforms, resolveMiniappUploadSessionFiles, shouldUploadDistFile, validateMiniappCompanionFileReceipts, validateMiniappManifestForDeploy, validateMiniappUploadPathLengths, validateMiniappUploadSizeBudgets, validateMiniappWorkspaceCardFileReceipts, validateUploadPaths, validateUploadTotalSize };
+export type { MiniappArtifactFile, MiniappArtifactFileReceipt, MiniappBasicInfo, MiniappCategory, MiniappCompanionCapability, MiniappCompanionManifestDeclarations, MiniappCompanionManifestDefinition, MiniappCompanionManifestTarget, MiniappCompanionTarget, MiniappManifest, MiniappPermissionDeclarations, MiniappPlatformPolicy, MiniappPlatformResolution, MiniappReusedCompanionFile, MiniappUploadKeyInput, MiniappUploadSessionFile, MiniappWindowDeclaration, NetworkMiniappPermissionDeclaration, ParseMiniappBindAppIdsOptions, SimpleMiniappPermissionDeclaration, UploadPathItem, UploadSizeItem, ValidateUploadPathsOptions, ValidateUploadTotalSizeOptions };