@heybox/hb-sdk 0.8.1-alpha.13 → 0.8.1-alpha.15

package/types/miniapp-manifest/schema.d.ts

@@ -3,6 +3,27 @@ import type { MiniappCompanionManifestDeclarations } from './companion-types';
 export declare const MINIAPP_TEMPLATE_VERSION = "0.0.0";
 export declare const MINIAPP_PLATFORM_VALUES: readonly ["android", "ios", "ohos", "windows", "macos", "linux"];
 export type MiniappPlatform = (typeof MINIAPP_PLATFORM_VALUES)[number];
+/** 窗口尺寸字段的脏值兜底上限；真正的上限是宿主侧显示器 workArea。 */
+export declare const MINIAPP_WINDOW_SIZE_MAX = 16384;
+/**
+ * `package.json#heybox.window` 的开发者声明字段。
+ *
+ * @remarks
+ * 只描述**开窗初值**与可缩放性，不是窗口当前尺寸；运行期尺寸请用 `viewport.getWindowInfo()`。
+ * 位置（`x` / `y`）不开放声明，由用户拖拽产生并由宿主记忆。
+ */
+export interface MiniappWindowDeclaration {
+    /** 默认窗口内容宽度（逻辑像素），正整数，不超过 16384。 */
+    defaultWidth?: number;
+    /** 默认窗口内容高度（逻辑像素），正整数，不超过 16384。 */
+    defaultHeight?: number;
+    /** 尺寸下限宽度；必须与 defaultWidth 同时声明，且不大于 defaultWidth。 */
+    minWidth?: number;
+    /** 尺寸下限高度；必须与 defaultHeight 同时声明，且不大于 defaultHeight。 */
+    minHeight?: number;
+    /** 是否允许用户手动拖拽改变尺寸。 */
+    resizable?: boolean;
+}
 /**
  * 桌面平台子集：从唯一平台词表 `MINIAPP_PLATFORM_VALUES` 派生，`satisfies` 阻止它漂移出词表。
  * 小程序声明其中任一平台，即视为该项目承诺适配 PC / 桌面端；调试台据此取舍桌面调试入口。
@@ -19,6 +40,8 @@ export interface MiniappManifest {
     platforms: readonly MiniappPlatform[];
     permissions?: MiniappPermissionDeclarations;
     companions?: MiniappCompanionManifestDeclarations;
+    window?: MiniappWindowDeclaration;
+    bindAppIds?: readonly string[];
 }
 export interface ParseMiniappManifestResult {
     manifest: MiniappManifest;
@@ -30,6 +53,8 @@ export declare function validateMiniappManifestVersion(version: unknown, sourceL
 export declare function renderMiniappManifest(manifest: MiniappManifest): string;
 export declare function parseMiniappManifestJson(raw: string, sourceLabel?: string): ParseMiniappManifestResult;
 export declare function validateMiniappManifestForDeploy(manifest: MiniappManifest): {
+    bindAppIds?: readonly string[] | undefined;
+    window?: MiniappWindowDeclaration | undefined;
     companions?: MiniappCompanionManifestDeclarations | undefined;
     permissions?: Partial<Record<"userInfo" | "steamLibrary" | "share" | "storage" | "filesystem" | "clipboard" | "leaderboard" | "companion", import("./permissions").SimpleMiniappPermissionDeclaration> & {
         network: import("./permissions").NetworkMiniappPermissionDeclaration;
@@ -40,4 +65,18 @@ export declare function validateMiniappManifestForDeploy(manifest: MiniappManife
 };
 export declare function validateMiniappPlatforms(platforms: unknown, sourceLabel?: string): readonly MiniappPlatform[];
 export declare function areMiniappPlatformsEqual(left: readonly MiniappPlatform[], right: readonly MiniappPlatform[]): boolean;
+/**
+ * 校验并归一化 `package.json#heybox.window` / `manifest.window` 声明。
+ *
+ * @remarks
+ * 与 `heybox.permissions` 同样的严格风格：未知字段报错，不做静默忽略。
+ * `width` / `height` 显式给出改名提示；`x` / `y` 按未知字段显式报错（`INV-NO-DEV-POSITION`）。
+ * 未声明时返回 `undefined`，由调用方决定不写入产物。
+ * @param value - 待校验的原始声明（不可信输入）。
+ * @param sourceLabel - 报错前缀，默认指向开发者声明路径。
+ * @throws 当声明不是非空对象、含未知字段、数值/布尔类型不合法或 min/default 不配对时抛出。
+ */
+export declare function validateMiniappWindow(value: unknown, sourceLabel?: string): MiniappWindowDeclaration | undefined;
+/** 比较两份窗口声明是否逐字段一致；未声明视同 `undefined`。 */
+export declare function areMiniappWindowsEqual(left: MiniappWindowDeclaration | undefined, right: MiniappWindowDeclaration | undefined): boolean;
 export declare function validateSdkVersion(version: unknown, sourceLabel?: string): string;

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

@@ -27,6 +27,7 @@ export declare const REOPEN_USER_MINIPROGRAM_API_PATH = "/mall/developer/user_mi
 export declare const UPDATE_SQUARE_DISPLAY_API_PATH = "/mall/developer/user_miniprogram/square_display/update";
 export declare const LIST_USER_MINIPROGRAM_VERSION_API_PATH = "/mall/developer/user_miniprogram/version/list";
 export { isValidMiniappManifestVersion as isValidVersion } from '../miniapp-manifest/schema';
+export { parseMiniappBindAppIds, type ParseMiniappBindAppIdsOptions } from '../miniapp-manifest/bindings';
 export declare function normalizeRelativePath(relativePath: string): string;
 export declare function relativePathContainsNodeModulesSegment(relativePath: string): boolean;
 export declare function getMiniProgramUploadAlias(miniProgramId: string): string;

package/types/vite/index.d.ts

@@ -50,4 +50,5 @@ export interface MiniappManifestResolvedConfig {
 export { MINIAPP_PLATFORM_VALUES };
 export type { MiniappPlatform };
 export declare const HB_SDK_COMPANION_ARTIFACT_ACCESS_TOKEN_ENV = "HB_SDK_COMPANION_ARTIFACT_ACCESS_TOKEN";
+export declare const HB_SDK_MINI_PROGRAM_MANIFEST_ACCESS_TOKEN_ENV = "HB_SDK_MINI_PROGRAM_MANIFEST_ACCESS_TOKEN";
 export declare function miniappManifest(): MiniappManifestPlugin;