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

package/types/vite/index.d.ts

@@ -1,5 +1,14 @@
-import type { IncomingMessage, Server, ServerResponse } from 'node:http';
-import { MINIAPP_PLATFORM_VALUES, type MiniappPlatform } from '../miniapp-manifest/schema';
+import { Server, IncomingMessage, ServerResponse } from 'node:http';
+
+/**
+ * `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];
+
 /**
  * {@link miniappManifest} 返回的 Vite 插件契约。
  *
@@ -8,7 +17,7 @@ import { MINIAPP_PLATFORM_VALUES, type MiniappPlatform } from '../miniapp-manife
  * 也不应手动调用这些 Vite hook。该接口不包含小程序声明；目标平台、权限、窗口、游戏绑定和 Companion
  * 等配置统一来自距离 Vite `root` 最近的 `package.json#heybox`。
  */
-export interface MiniappManifestPlugin {
+interface MiniappManifestPlugin {
     /** 固定为 `heybox-miniapp-manifest`，同一份 Vite 配置必须且只能注册一个实例。 */
     name: string;
     /** 校验资源基准路径，并向 Vite 注入 SDK 版本和开发期日志开关。 */
@@ -32,7 +41,7 @@ export interface MiniappManifestPlugin {
  * @remarks
  * 这是插件返回值暴露的 hook 类型，不是 `miniappManifest()` 的配置项。业务项目应让 Vite 创建并传入服务实例。
  */
-export interface MiniappManifestDevServer {
+interface MiniappManifestDevServer {
     /** Vite 底层 HTTP 服务；middleware mode 或尚未监听时可能为空。 */
     httpServer?: Server | null;
     /** Vite 配置重载入口；插件会在重载期间保留当前本地调试快照。 */
@@ -49,7 +58,7 @@ export interface MiniappManifestDevServer {
  * 该接口描述 Vite hook 数据，不是插件 options；`miniappManifest()` 必须无参调用。小程序声明请写入
  * `package.json#heybox`，不要写入 Vite 配置。
  */
-export interface MiniappManifestUserConfig {
+interface MiniappManifestUserConfig {
     /**
      * Vite 资源基准路径。省略时插件返回 `./`；显式配置只接受空字符串或 `./`，以便版本目录内相对加载资源。
      */
@@ -58,7 +67,7 @@ export interface MiniappManifestUserConfig {
     define?: Record<string, string>;
 }
 /** {@link MiniappManifestPlugin.closeBundle} 使用的最小 Rollup 插件上下文。 */
-export interface MiniappManifestPluginContext {
+interface MiniappManifestPluginContext {
     /** 输出缺少迁移期声明等非阻断构建警告。 */
     warn: (message: string) => void;
 }
@@ -69,7 +78,7 @@ export interface MiniappManifestPluginContext {
  * 这是 Vite 传给插件的 hook 数据，不是应用作者需要创建的 options。插件从中确定项目根目录、输出目录、
  * serve/build 分支和 HMR WebSocket 白名单。
  */
-export interface MiniappManifestResolvedConfig {
+interface MiniappManifestResolvedConfig {
     /** Vite 项目根目录；小程序配置从该目录向上找到的最近 `package.json` 读取。 */
     root: string;
     /** `serve` 只准备本地调试，`build` 还会校验产物并生成 `manifest.json`。 */
@@ -95,22 +104,23 @@ export interface MiniappManifestResolvedConfig {
         name?: string;
     }[];
 }
-export { MINIAPP_PLATFORM_VALUES };
-export type { MiniappPlatform };
+
+declare const HB_SDK_WORKSPACE_CARD_DEV_ARTIFACT_PREFIX = "/__hb_sdk__/";
+declare const HB_SDK_WORKSPACE_CARD_GENERATION_HEADER = "x-hb-sdk-workspace-cards-generation";
 /**
  * `hb-sdk dev` 为本地 Companion 产物访问注入的进程环境变量名。
  *
  * @remarks
  * 该变量由 CLI 管理，不是项目配置项。应用代码不应读取、设置、记录或转发它的值。
  */
-export declare const HB_SDK_COMPANION_ARTIFACT_ACCESS_TOKEN_ENV = "HB_SDK_COMPANION_ARTIFACT_ACCESS_TOKEN";
+declare const HB_SDK_COMPANION_ARTIFACT_ACCESS_TOKEN_ENV = "HB_SDK_COMPANION_ARTIFACT_ACCESS_TOKEN";
 /**
  * `hb-sdk dev` 为本地小程序 Manifest 访问注入的进程环境变量名。
  *
  * @remarks
  * 该变量由 CLI 管理，不是项目配置项。应用代码不应读取、设置、记录或转发它的值。
  */
-export declare const HB_SDK_MINI_PROGRAM_MANIFEST_ACCESS_TOKEN_ENV = "HB_SDK_MINI_PROGRAM_MANIFEST_ACCESS_TOKEN";
+declare const HB_SDK_MINI_PROGRAM_MANIFEST_ACCESS_TOKEN_ENV = "HB_SDK_MINI_PROGRAM_MANIFEST_ACCESS_TOKEN";
 /**
  * 创建工坊小程序使用的 Vite 插件。
  *
@@ -216,4 +226,7 @@ export declare const HB_SDK_MINI_PROGRAM_MANIFEST_ACCESS_TOKEN_ENV = "HB_SDK_MIN
  * @see [窗口尺寸与可缩放性](/guide/window-size) `heybox.window` 字段与 Host 消费语义。
  * @see [受管桌面程序](/guide/companion) Companion 声明、归档和本地联调边界。
  */
-export declare function miniappManifest(): MiniappManifestPlugin;
+declare function miniappManifest(): MiniappManifestPlugin;
+
+export { HB_SDK_COMPANION_ARTIFACT_ACCESS_TOKEN_ENV, HB_SDK_MINI_PROGRAM_MANIFEST_ACCESS_TOKEN_ENV, HB_SDK_WORKSPACE_CARD_DEV_ARTIFACT_PREFIX, HB_SDK_WORKSPACE_CARD_GENERATION_HEADER, MINIAPP_PLATFORM_VALUES, miniappManifest };
+export type { MiniappManifestDevServer, MiniappManifestPlugin, MiniappManifestPluginContext, MiniappManifestResolvedConfig, MiniappManifestUserConfig, MiniappPlatform };

package/dist/cli-chunks/runtime-gate-C__ySQYU.cjs

@@ -1,65 +0,0 @@
-'use strict';
-
-var runtimePermissionEnv = require('./runtime-permission-env-CHeBjX3l.cjs');
-
-// Shorthands
-/**
- * Parses an HTML string.
- *
- * @param html Input HTML string.
- * @param options Parsing options.
- * @returns Document
- *
- * @example
- *
- * ```js
- * const parse5 = require('parse5');
- *
- * const document = parse5.parse('<!DOCTYPE html><html><head></head><body>Hi there!</body></html>');
- *
- * console.log(document.childNodes[1].tagName); //> 'html'
- *```
- */
-function parse(html, options) {
-    return runtimePermissionEnv.Parser.parse(html, options);
-}
-
-const RUNTIME_GATE_MARKER = 'data-heybox-runtime-gate';
-const RUNTIME_GATE_STYLE_MARKER = 'data-heybox-runtime-gate-style';
-const RUNTIME_GATE_BOOTSTRAP_MARKER = 'data-heybox-runtime-gate-bootstrap';
-/**
- * 检查 HTML 是否包含 Runtime Gate 的三个结构标记。
- *
- * @param html - 待检查的完整 HTML 文本，使用 HTML parser 解析。
- * @returns Gate、隐藏样式及 bootstrap 标记均出现时返回 `true`，否则返回 `false`。
- * @remarks 只识别标记，不验证脚本内容、标记所在节点或宿主握手；不能据此判断页面安全或实际可运行。
- */
-function hasMiniappRuntimeGate(html) {
-    const document = parse(html);
-    let hasGate = false;
-    let hasGateStyle = false;
-    let hasGateBootstrap = false;
-    walk(document, (element) => {
-        hasGate ||= hasAttr(element, RUNTIME_GATE_MARKER);
-        hasGateStyle ||= hasAttr(element, RUNTIME_GATE_STYLE_MARKER);
-        hasGateBootstrap ||= hasAttr(element, RUNTIME_GATE_BOOTSTRAP_MARKER);
-    });
-    return hasGate && hasGateStyle && hasGateBootstrap;
-}
-function readAttr(element, name) {
-    return element.attrs.find((attr) => attr.name.toLowerCase() === name)?.value;
-}
-function hasAttr(element, name) {
-    return readAttr(element, name) !== undefined;
-}
-function walk(node, visit) {
-    if ('tagName' in node)
-        visit(node);
-    if ('childNodes' in node)
-        for (const child of node.childNodes)
-            walk(child, visit);
-    if ('content' in node && node.content)
-        walk(node.content, visit);
-}
-
-exports.hasMiniappRuntimeGate = hasMiniappRuntimeGate;