@heybox/hb-sdk 0.9.2-alpha.8 → 0.9.2

package/dist/protocol.cjs.js

@@ -504,6 +504,7 @@ const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
  * @see [MINI_PROGRAM_BRIDGE_NONCE_PARAM](/reference/symbols/protocol/constants/MINI_PROGRAM_BRIDGE_NONCE_PARAM) iframe URL 中的 nonce 参数名。
  * @see [MINI_PROGRAM_PROTOCOL_CAPABILITIES](/reference/symbols/protocol/constants/MINI_PROGRAM_PROTOCOL_CAPABILITIES) 公开 method 与权限 requirement 目录。
  * @see [parseMiniProgramRuntimePermissions](/reference/symbols/protocol/functions/parseMiniProgramRuntimePermissions) Runtime 权限快照解析器。
+ * @since 0.3.1
  */
 function isMiniProgramBridgeMessage(value) {
     if (!isRecord$3(value))
@@ -588,6 +589,7 @@ function isMiniProgramBridgeMessage(value) {
  * @see [PathRoot](/reference/symbols/root/interfaces/PathRoot) 提供 `file()` / `directory()` 的 SDK 路径入口。
  * @see [FileSystem](/reference/symbols/root/interfaces/FileSystem) `files.sandbox` 逻辑路径能力。
  * @see [DirectoryHandle](/reference/symbols/root/interfaces/DirectoryHandle) 已授权目录下的相对路径能力。
+ * @since 0.8.0
  */
 function isMiniProgramRelativePath(value) {
     if (typeof value !== 'string' || !value || value.startsWith('/') || value.endsWith('/')) {
@@ -654,6 +656,7 @@ function isMiniProgramRelativePath(value) {
  * @see [PathRoot](/reference/symbols/root/interfaces/PathRoot) SDK 公开的逻辑路径 root 能力。
  * @see [FilesModule](/reference/symbols/root/interfaces/FilesModule) 提供 `files.sandbox` 与目录 picker 的入口。
  * @see [DirectoryHandle](/reference/symbols/root/interfaces/DirectoryHandle) 可作为 derived path root 的目录代理。
+ * @since 0.8.0
  */
 function isMiniProgramPathRootRef(value) {
     if (!isRecord$3(value))
@@ -720,6 +723,7 @@ function isMiniProgramPathRootRef(value) {
  * @see [isMiniProgramFileDescriptor](/reference/symbols/protocol/functions/isMiniProgramFileDescriptor) 包含名称和 mode 的文件 descriptor guard。
  * @see [isMiniProgramDirectoryRef](/reference/symbols/protocol/functions/isMiniProgramDirectoryRef) 可用 `'.'` 指向 root 自身的目录引用 guard。
  * @see [FileHandle](/reference/symbols/root/interfaces/FileHandle) 使用文件引用的公开 I/O 代理。
+ * @since 0.8.0
  */
 function isMiniProgramFileRef(value) {
     if (!isRecord$3(value) || value.kind !== 'file')
@@ -787,6 +791,7 @@ function isMiniProgramFileRef(value) {
  * @see [isMiniProgramDirectoryDescriptor](/reference/symbols/protocol/functions/isMiniProgramDirectoryDescriptor) 包含名称和 mode 的目录 descriptor guard。
  * @see [isMiniProgramFileRef](/reference/symbols/protocol/functions/isMiniProgramFileRef) 不接受 root 自身 `'.'` 的文件引用 guard。
  * @see [DirectoryHandle](/reference/symbols/root/interfaces/DirectoryHandle) 使用目录引用的公开路径操作代理。
+ * @since 0.8.0
  */
 function isMiniProgramDirectoryRef(value) {
     if (!isRecord$3(value) || value.kind !== 'directory')
@@ -861,6 +866,7 @@ function isMiniProgramDirectoryRef(value) {
  * @see [FileHandle](/reference/symbols/root/interfaces/FileHandle) 校验后由 SDK 建立的文件代理。
  * @see [PickFilesResult](/reference/symbols/protocol/types/PickFilesResult) picker 的 direct-ref 文件结果。
  * @see [SaveFileResult](/reference/symbols/protocol/types/SaveFileResult) save picker 的 direct-ref 文件结果。
+ * @since 0.8.0
  */
 function isMiniProgramFileDescriptor(value) {
     return (isRecord$3(value) &&
@@ -931,6 +937,7 @@ function isMiniProgramFileDescriptor(value) {
  * @see [FilesModule](/reference/symbols/root/interfaces/FilesModule) `files` 公开能力入口。
  * @see [DirectoryHandle](/reference/symbols/root/interfaces/DirectoryHandle) 校验后由 SDK 建立的目录代理。
  * @see [PickDirectoryResult](/reference/symbols/protocol/types/PickDirectoryResult) picker 的 direct-ref 返回契约。
+ * @since 0.8.0
  */
 function isMiniProgramDirectoryDescriptor(value) {
     return (isRecord$3(value) &&
@@ -996,6 +1003,7 @@ function isMiniProgramDirectoryDescriptor(value) {
  * @see [FileSystemEntity](/reference/symbols/root/types/FileSystemEntity) SDK 公开的 FileHandle/DirectoryHandle 联合。
  * @see [FileHandle](/reference/symbols/root/interfaces/FileHandle) 文件 descriptor 对应的能力代理。
  * @see [DirectoryHandle](/reference/symbols/root/interfaces/DirectoryHandle) 目录 descriptor 对应的能力代理及 `list()` 入口。
+ * @since 0.8.0
  */
 function isMiniProgramFileSystemEntityDescriptor(value) {
     return isMiniProgramFileDescriptor(value) || isMiniProgramDirectoryDescriptor(value);
@@ -1051,6 +1059,7 @@ function isMiniProgramFileSystemEntityDescriptor(value) {
  * @see [CompanionStdio](/reference/symbols/root/interfaces/CompanionStdio) Companion 原始字节 stdin/stdout/stderr。
  * @see [isMiniProgramFileDescriptor](/reference/symbols/protocol/functions/isMiniProgramFileDescriptor) 文件 descriptor guard。
  * @see [isMiniProgramDirectoryDescriptor](/reference/symbols/protocol/functions/isMiniProgramDirectoryDescriptor) 目录 descriptor guard。
+ * @since 0.8.0
  */
 function isMiniProgramByteArray(value) {
     return value instanceof Uint8Array && value.buffer instanceof ArrayBuffer;
@@ -1110,6 +1119,7 @@ function isMiniProgramByteArray(value) {
  * @see [FileStatResult](/reference/symbols/protocol/types/FileStatResult) `file.stat` 的 wire 返回类型。
  * @see [FileStat](/reference/symbols/root/interfaces/FileStat) SDK 向业务返回的元数据快照。
  * @see [FileHandle](/reference/symbols/root/interfaces/FileHandle) 提供 `stat()` 的当前 session 文件代理。
+ * @since 0.8.0
  */
 function isMiniProgramFileStat(value) {
     return (isRecord$3(value) &&
@@ -1170,6 +1180,7 @@ function isMiniProgramFileStat(value) {
  * @see [DownloadProgress](/reference/symbols/root/interfaces/DownloadProgress) `onProgress` 接收的公开 SDK 进度类型。
  * @see [network.download](/reference/sdk/network/download) 产生并消费该进度的下载能力。
  * @see [isMiniProgramBridgeMessage](/reference/symbols/protocol/functions/isMiniProgramBridgeMessage) operation progress envelope 的最低校验。
+ * @since 0.8.0
  */
 function isMiniProgramDownloadProgressPayload(value) {
     if (!isRecord$3(value) ||
@@ -1296,6 +1307,7 @@ const MANAGED_RUNTIME_PERMISSION_KEYS = new Set(MINI_PROGRAM_PERMISSION_KEYS);
  * @see [parseMiniProgramRuntimePermissions](/reference/symbols/protocol/functions/parseMiniProgramRuntimePermissions) 完整 snapshot 的 trim、legacy 归一化与 config 校验。
  * @see [MINI_PROGRAM_PROTOCOL_CAPABILITIES](/reference/symbols/protocol/constants/MINI_PROGRAM_PROTOCOL_CAPABILITIES) method 到 permission requirement 的权威映射。
  * @see [权限声明](/guide/permissions) Manifest 声明、平台批准与 Runtime 状态的完整流程。
+ * @since 0.6.4
  */
 function isManagedMiniProgramRuntimePermissionKey(key) {
     return MANAGED_RUNTIME_PERMISSION_KEYS.has(key);
@@ -1371,6 +1383,7 @@ function isManagedMiniProgramRuntimePermissionKey(key) {
  * @see {@link isManagedMiniProgramRuntimePermissionKey}
  * @see {@link MINI_PROGRAM_PROTOCOL_CAPABILITIES}
  * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
+ * @since 0.6.4
  */
 function parseMiniProgramRuntimePermissions(snapshot) {
     if (!isRecord$2(snapshot) || snapshot.schema_version !== 1 || !Array.isArray(snapshot.entries)) {

package/dist/protocol.esm.js

@@ -502,6 +502,7 @@ const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
  * @see [MINI_PROGRAM_BRIDGE_NONCE_PARAM](/reference/symbols/protocol/constants/MINI_PROGRAM_BRIDGE_NONCE_PARAM) iframe URL 中的 nonce 参数名。
  * @see [MINI_PROGRAM_PROTOCOL_CAPABILITIES](/reference/symbols/protocol/constants/MINI_PROGRAM_PROTOCOL_CAPABILITIES) 公开 method 与权限 requirement 目录。
  * @see [parseMiniProgramRuntimePermissions](/reference/symbols/protocol/functions/parseMiniProgramRuntimePermissions) Runtime 权限快照解析器。
+ * @since 0.3.1
  */
 function isMiniProgramBridgeMessage(value) {
     if (!isRecord$3(value))
@@ -586,6 +587,7 @@ function isMiniProgramBridgeMessage(value) {
  * @see [PathRoot](/reference/symbols/root/interfaces/PathRoot) 提供 `file()` / `directory()` 的 SDK 路径入口。
  * @see [FileSystem](/reference/symbols/root/interfaces/FileSystem) `files.sandbox` 逻辑路径能力。
  * @see [DirectoryHandle](/reference/symbols/root/interfaces/DirectoryHandle) 已授权目录下的相对路径能力。
+ * @since 0.8.0
  */
 function isMiniProgramRelativePath(value) {
     if (typeof value !== 'string' || !value || value.startsWith('/') || value.endsWith('/')) {
@@ -652,6 +654,7 @@ function isMiniProgramRelativePath(value) {
  * @see [PathRoot](/reference/symbols/root/interfaces/PathRoot) SDK 公开的逻辑路径 root 能力。
  * @see [FilesModule](/reference/symbols/root/interfaces/FilesModule) 提供 `files.sandbox` 与目录 picker 的入口。
  * @see [DirectoryHandle](/reference/symbols/root/interfaces/DirectoryHandle) 可作为 derived path root 的目录代理。
+ * @since 0.8.0
  */
 function isMiniProgramPathRootRef(value) {
     if (!isRecord$3(value))
@@ -718,6 +721,7 @@ function isMiniProgramPathRootRef(value) {
  * @see [isMiniProgramFileDescriptor](/reference/symbols/protocol/functions/isMiniProgramFileDescriptor) 包含名称和 mode 的文件 descriptor guard。
  * @see [isMiniProgramDirectoryRef](/reference/symbols/protocol/functions/isMiniProgramDirectoryRef) 可用 `'.'` 指向 root 自身的目录引用 guard。
  * @see [FileHandle](/reference/symbols/root/interfaces/FileHandle) 使用文件引用的公开 I/O 代理。
+ * @since 0.8.0
  */
 function isMiniProgramFileRef(value) {
     if (!isRecord$3(value) || value.kind !== 'file')
@@ -785,6 +789,7 @@ function isMiniProgramFileRef(value) {
  * @see [isMiniProgramDirectoryDescriptor](/reference/symbols/protocol/functions/isMiniProgramDirectoryDescriptor) 包含名称和 mode 的目录 descriptor guard。
  * @see [isMiniProgramFileRef](/reference/symbols/protocol/functions/isMiniProgramFileRef) 不接受 root 自身 `'.'` 的文件引用 guard。
  * @see [DirectoryHandle](/reference/symbols/root/interfaces/DirectoryHandle) 使用目录引用的公开路径操作代理。
+ * @since 0.8.0
  */
 function isMiniProgramDirectoryRef(value) {
     if (!isRecord$3(value) || value.kind !== 'directory')
@@ -859,6 +864,7 @@ function isMiniProgramDirectoryRef(value) {
  * @see [FileHandle](/reference/symbols/root/interfaces/FileHandle) 校验后由 SDK 建立的文件代理。
  * @see [PickFilesResult](/reference/symbols/protocol/types/PickFilesResult) picker 的 direct-ref 文件结果。
  * @see [SaveFileResult](/reference/symbols/protocol/types/SaveFileResult) save picker 的 direct-ref 文件结果。
+ * @since 0.8.0
  */
 function isMiniProgramFileDescriptor(value) {
     return (isRecord$3(value) &&
@@ -929,6 +935,7 @@ function isMiniProgramFileDescriptor(value) {
  * @see [FilesModule](/reference/symbols/root/interfaces/FilesModule) `files` 公开能力入口。
  * @see [DirectoryHandle](/reference/symbols/root/interfaces/DirectoryHandle) 校验后由 SDK 建立的目录代理。
  * @see [PickDirectoryResult](/reference/symbols/protocol/types/PickDirectoryResult) picker 的 direct-ref 返回契约。
+ * @since 0.8.0
  */
 function isMiniProgramDirectoryDescriptor(value) {
     return (isRecord$3(value) &&
@@ -994,6 +1001,7 @@ function isMiniProgramDirectoryDescriptor(value) {
  * @see [FileSystemEntity](/reference/symbols/root/types/FileSystemEntity) SDK 公开的 FileHandle/DirectoryHandle 联合。
  * @see [FileHandle](/reference/symbols/root/interfaces/FileHandle) 文件 descriptor 对应的能力代理。
  * @see [DirectoryHandle](/reference/symbols/root/interfaces/DirectoryHandle) 目录 descriptor 对应的能力代理及 `list()` 入口。
+ * @since 0.8.0
  */
 function isMiniProgramFileSystemEntityDescriptor(value) {
     return isMiniProgramFileDescriptor(value) || isMiniProgramDirectoryDescriptor(value);
@@ -1049,6 +1057,7 @@ function isMiniProgramFileSystemEntityDescriptor(value) {
  * @see [CompanionStdio](/reference/symbols/root/interfaces/CompanionStdio) Companion 原始字节 stdin/stdout/stderr。
  * @see [isMiniProgramFileDescriptor](/reference/symbols/protocol/functions/isMiniProgramFileDescriptor) 文件 descriptor guard。
  * @see [isMiniProgramDirectoryDescriptor](/reference/symbols/protocol/functions/isMiniProgramDirectoryDescriptor) 目录 descriptor guard。
+ * @since 0.8.0
  */
 function isMiniProgramByteArray(value) {
     return value instanceof Uint8Array && value.buffer instanceof ArrayBuffer;
@@ -1108,6 +1117,7 @@ function isMiniProgramByteArray(value) {
  * @see [FileStatResult](/reference/symbols/protocol/types/FileStatResult) `file.stat` 的 wire 返回类型。
  * @see [FileStat](/reference/symbols/root/interfaces/FileStat) SDK 向业务返回的元数据快照。
  * @see [FileHandle](/reference/symbols/root/interfaces/FileHandle) 提供 `stat()` 的当前 session 文件代理。
+ * @since 0.8.0
  */
 function isMiniProgramFileStat(value) {
     return (isRecord$3(value) &&
@@ -1168,6 +1178,7 @@ function isMiniProgramFileStat(value) {
  * @see [DownloadProgress](/reference/symbols/root/interfaces/DownloadProgress) `onProgress` 接收的公开 SDK 进度类型。
  * @see [network.download](/reference/sdk/network/download) 产生并消费该进度的下载能力。
  * @see [isMiniProgramBridgeMessage](/reference/symbols/protocol/functions/isMiniProgramBridgeMessage) operation progress envelope 的最低校验。
+ * @since 0.8.0
  */
 function isMiniProgramDownloadProgressPayload(value) {
     if (!isRecord$3(value) ||
@@ -1294,6 +1305,7 @@ const MANAGED_RUNTIME_PERMISSION_KEYS = new Set(MINI_PROGRAM_PERMISSION_KEYS);
  * @see [parseMiniProgramRuntimePermissions](/reference/symbols/protocol/functions/parseMiniProgramRuntimePermissions) 完整 snapshot 的 trim、legacy 归一化与 config 校验。
  * @see [MINI_PROGRAM_PROTOCOL_CAPABILITIES](/reference/symbols/protocol/constants/MINI_PROGRAM_PROTOCOL_CAPABILITIES) method 到 permission requirement 的权威映射。
  * @see [权限声明](/guide/permissions) Manifest 声明、平台批准与 Runtime 状态的完整流程。
+ * @since 0.6.4
  */
 function isManagedMiniProgramRuntimePermissionKey(key) {
     return MANAGED_RUNTIME_PERMISSION_KEYS.has(key);
@@ -1369,6 +1381,7 @@ function isManagedMiniProgramRuntimePermissionKey(key) {
  * @see {@link isManagedMiniProgramRuntimePermissionKey}
  * @see {@link MINI_PROGRAM_PROTOCOL_CAPABILITIES}
  * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
+ * @since 0.6.4
  */
 function parseMiniProgramRuntimePermissions(snapshot) {
     if (!isRecord$2(snapshot) || snapshot.schema_version !== 1 || !Array.isArray(snapshot.entries)) {

package/dist/vite.cjs.js

@@ -10141,6 +10141,7 @@ const BASIC_INFO_MAX_PIXELS = 40_000_000;
  * @returns NFKC 规范化、去除首尾 Unicode White_Space 后的名称；不折叠规范化后的内部空白。
  * @throws `Error` 输入不是字符串，或规范化后不是 1–40 个 Unicode code point、不含文字或数字，或包含控制字符、
  * 格式字符、行/段分隔符以及 HTML 特殊字符 `<`、`>`、`&`、双引号或单引号时抛出。
+ * @since 0.8.2
  */
 function normalizeBasicInfoName(raw) {
     if (typeof raw !== 'string')
@@ -10172,6 +10173,7 @@ function validateBasicInfoPath(raw) {
  * @remarks
  * 图片路径必须使用 `/` 分隔的非空相对路径，扩展名为 JPEG、PNG、GIF 或 WebP；拒绝 URL、点段、
  * 控制字符和构建/缓存等保留目录。此函数只校验声明，不读取文件，也不验证图片字节、尺寸或存在性。
+ * @since 0.8.2
  */
 function parseMiniappBasicInfo(value, sdkVersion = '0.8.2') {
     sdkVersion = sdkVersion.trim();
@@ -10302,7 +10304,7 @@ async function ensureBasicInfoDirectory(rootPath, relative) {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.2-alpha.8';
+    : '0.9.2';
 
 /**
  * iframe 与调试台页面的开发期 console 捕获转发。
@@ -10675,6 +10677,7 @@ const MINIAPP_BIND_APP_IDS_MAX_COUNT = 20;
  * @see [miniappManifest](/reference/symbols/vite/functions/miniappManifest)
  * @see [navigation.openAppPage](/reference/sdk/navigation/openAppPage)
  * @see [CLI 与远端发布](/guide/cli#生产构建)
+ * @since 0.8.1
  */
 function parseMiniappBindAppIds(value, options = {}) {
     const sourceLabel = options.sourceLabel ?? 'package.json#heybox.bindAppIds';
@@ -10711,6 +10714,7 @@ function parseMiniappBindAppIds(value, options = {}) {
  * @param sourceLabel - 错误消息中的字段来源，默认 `package.json#heybox.category`。
  * @returns 合法类别原值；输入 `undefined` 时返回 `undefined`，由发布流程另行检查是否必填。
  * @throws `Error` 输入为其他值（包括 null 或空字符串）时抛出带字段来源的错误。
+ * @since 0.8.3
  */
 function parseMiniappCategory(value, sourceLabel = 'package.json#heybox.category') {
     if (value === undefined)
@@ -20658,6 +20662,7 @@ const devSnapshotStores = devSnapshotRegistry[devSnapshotStoreKey];
  * @see [权限声明](/guide/permissions) `heybox.permissions` 严格 schema 与迁移规则。
  * @see [窗口尺寸与可缩放性](/guide/window-size) `heybox.window` 字段与 Host 消费语义。
  * @see [受管桌面程序](/guide/companion) Companion 声明、归档和本地联调边界。
+ * @since 0.3.1
  */
 function miniappManifest() {
     const includeCompanions = process.env.HB_SDK_SKIP_COMPANIONS !== '1';

package/dist/vite.esm.js

@@ -10138,6 +10138,7 @@ const BASIC_INFO_MAX_PIXELS = 40_000_000;
  * @returns NFKC 规范化、去除首尾 Unicode White_Space 后的名称；不折叠规范化后的内部空白。
  * @throws `Error` 输入不是字符串，或规范化后不是 1–40 个 Unicode code point、不含文字或数字，或包含控制字符、
  * 格式字符、行/段分隔符以及 HTML 特殊字符 `<`、`>`、`&`、双引号或单引号时抛出。
+ * @since 0.8.2
  */
 function normalizeBasicInfoName(raw) {
     if (typeof raw !== 'string')
@@ -10169,6 +10170,7 @@ function validateBasicInfoPath(raw) {
  * @remarks
  * 图片路径必须使用 `/` 分隔的非空相对路径，扩展名为 JPEG、PNG、GIF 或 WebP；拒绝 URL、点段、
  * 控制字符和构建/缓存等保留目录。此函数只校验声明，不读取文件，也不验证图片字节、尺寸或存在性。
+ * @since 0.8.2
  */
 function parseMiniappBasicInfo(value, sdkVersion = '0.8.2') {
     sdkVersion = sdkVersion.trim();
@@ -10299,7 +10301,7 @@ async function ensureBasicInfoDirectory(rootPath, relative) {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.2-alpha.8';
+    : '0.9.2';
 
 /**
  * iframe 与调试台页面的开发期 console 捕获转发。
@@ -10672,6 +10674,7 @@ const MINIAPP_BIND_APP_IDS_MAX_COUNT = 20;
  * @see [miniappManifest](/reference/symbols/vite/functions/miniappManifest)
  * @see [navigation.openAppPage](/reference/sdk/navigation/openAppPage)
  * @see [CLI 与远端发布](/guide/cli#生产构建)
+ * @since 0.8.1
  */
 function parseMiniappBindAppIds(value, options = {}) {
     const sourceLabel = options.sourceLabel ?? 'package.json#heybox.bindAppIds';
@@ -10708,6 +10711,7 @@ function parseMiniappBindAppIds(value, options = {}) {
  * @param sourceLabel - 错误消息中的字段来源，默认 `package.json#heybox.category`。
  * @returns 合法类别原值；输入 `undefined` 时返回 `undefined`，由发布流程另行检查是否必填。
  * @throws `Error` 输入为其他值（包括 null 或空字符串）时抛出带字段来源的错误。
+ * @since 0.8.3
  */
 function parseMiniappCategory(value, sourceLabel = 'package.json#heybox.category') {
     if (value === undefined)
@@ -20655,6 +20659,7 @@ const devSnapshotStores = devSnapshotRegistry[devSnapshotStoreKey];
  * @see [权限声明](/guide/permissions) `heybox.permissions` 严格 schema 与迁移规则。
  * @see [窗口尺寸与可缩放性](/guide/window-size) `heybox.window` 字段与 Host 消费语义。
  * @see [受管桌面程序](/guide/companion) Companion 声明、归档和本地联调边界。
+ * @since 0.3.1
  */
 function miniappManifest() {
     const includeCompanions = process.env.HB_SDK_SKIP_COMPANIONS !== '1';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk",
-  "version": "0.9.2-alpha.8",
+  "version": "0.9.2",
   "sideEffects": [
     "./src/index.ts",
     "./src/core/singleton.ts",
@@ -76,7 +76,7 @@
     "undici": "^7.28.0",
     "ws": "^8.18.0",
     "sharp": "^0.34.5",
-    "@heybox/hb-sdk-protocol": "0.9.2-alpha.8"
+    "@heybox/hb-sdk-protocol": "0.9.2"
   },
   "peerDependencies": {
     "vite": ">=5"
@@ -130,11 +130,11 @@
     "rollup-plugin-dts": "6.4.0",
     "@heybox-domain/heybox-theme": "~0.1.0",
     "@heybox/hb-api": "~1.28.14",
-    "@heybox/hb-sdk-runtime": "~0.9.2-alpha.8",
+    "@heybox/hb-sdk-runtime": "~0.9.2",
     "@heybox-domain/heybox-vue3-ui": "~0.1.0",
+    "@heybox/runtime-policy": "~0.2.1",
     "@heybox/runtime": "~0.2.1",
-    "@heybox/runtime-transport-fetch": "~0.2.1",
-    "@heybox/runtime-policy": "~0.2.1"
+    "@heybox/runtime-transport-fetch": "~0.2.1"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
@@ -187,6 +187,7 @@
     "check:docs-sync": "pnpm --filter @heybox-docs/docs-hb_sdk run check:reference && node scripts/skill/generate-manifest.mjs --check && node scripts/skill/validate-skill.mjs",
     "check:compatibility-evidence": "node scripts/validate-compatibility-evidence.mjs",
     "check:api-semver": "node ../../ops/jobs/hb-sdk-docs-contract/semantic-diff.cjs",
+    "check:since-tags": "node scripts/verify-since-against-tags.mjs",
     "clean": "rimraf ./dist && rimraf ./types",
     "test:unit": "vitest run",
     "test:types:characterization": "tsc -p tsconfig.characterization.json --noEmit --pretty false",

package/skill/skill.json

@@ -1,15 +1,15 @@
 {
   "name": "hb-sdk",
-  "skillVersion": "0.9.2-alpha.8+skill.4d7b063940c3",
+  "skillVersion": "0.9.2+skill.4d7b063940c3",
   "sdk": {
     "package": "@heybox/hb-sdk",
-    "version": "0.9.2-alpha.8",
-    "compatibility": "0.9.2-alpha.8"
+    "version": "0.9.2",
+    "compatibility": "0.9.2"
   },
   "distribution": {
     "type": "npm",
     "package": "@heybox/hb-sdk",
-    "version": "0.9.2-alpha.8",
+    "version": "0.9.2",
     "path": "skill"
   },
   "integrity": "sha256-4d7b063940c341502cf34c481b656be96ac27f1a252055b2b1af445c6392264c"

package/types/card-controller.d.ts

@@ -3651,6 +3651,11 @@ interface WorkspaceCardsControllerAuthoring {
     actions?: Readonly<Record<string, WorkspaceCardActionHandle>>;
     refresh?: WorkspaceCardController['refresh'];
 }
+/**
+ * 工作区卡片定义入口。
+ *
+ * @since 0.9.1
+ */
 declare function defineCard<T extends WorkspaceCardAuthorDefinition>(definition: T): T;
 declare const actionInput: {
     readonly string: (options?: {
@@ -3663,19 +3668,46 @@ declare const actionInput: {
     }) => WorkspaceCardActionInputSchema;
     readonly object: (properties: Readonly<Record<string, WorkspaceCardActionInputSchema>>) => WorkspaceCardActionInputSchema;
 };
+/**
+ * 工作区卡片 action 定义入口。
+ *
+ * @since 0.9.1
+ */
 declare function defineAction<Input extends WorkspaceCardJson>(definition: {
     input?: WorkspaceCardActionInputSchema;
     run(ctx: WorkspaceCardControllerContext, input: Input): WorkspaceCardControllerResult | Promise<WorkspaceCardControllerResult>;
 }): WorkspaceCardActionHandle<Input>;
+/**
+ * 打开小程序 action 定义入口。
+ *
+ * @since 0.9.1
+ */
 declare function defineOpenMiniProgramAction<Input extends WorkspaceCardJson = WorkspaceCardJson>(options?: {
     input?: WorkspaceCardActionInputSchema;
 }): WorkspaceCardActionHandle<Input>;
+/**
+ * 工作区卡片控制器定义入口。
+ *
+ * @since 0.9.1
+ */
 declare function defineWorkspaceCardsController<T extends WorkspaceCardsControllerAuthoring>(controller: T): T;
-/** 定义控制器；构建器和 Host 分别验证静态 action 表。 */
+/**
+ * 定义控制器；构建器和 Host 分别验证静态 action 表。
+ *
+ * @since 0.9.1
+ */
 declare function defineWorkspaceCardController<T extends WorkspaceCardController>(controller: T): T;
-/** 生成固定受管 invoke 入口；身份由 Host 根据真实卡片绑定。 */
+/**
+ * 生成固定受管 invoke 入口；身份由 Host 根据真实卡片绑定。
+ *
+ * @since 0.9.1
+ */
 declare function invoke(actionId: string, params?: WorkspaceCardJson): ViewAction;
-/** 只允许打开当前小程序。 */
+/**
+ * 只允许打开当前小程序。
+ *
+ * @since 0.9.1
+ */
 declare function openMiniProgram(actionId: string, params?: WorkspaceCardJson): ViewAction;
 
 export { actionInput, badge, barChart, button, carousel, defineAction, defineCard, defineOpenMiniProgramAction, defineWorkspaceCardController, defineWorkspaceCardsController, divider, expandable, fields, frame, grid, group, hstack, icon, image, invoke, list, meter, openMiniProgram, radialProgress, region, renderer, spacer, tabs, text, textField, toggle, viewDocument, vstack, zstack };