@skillbuilder/miniapp-simulator 0.2.4 → 0.2.8

package/lib/types/remote/protocol.d.ts

@@ -1,4 +1,5 @@
 import type { BusinessLine } from "../business-line";
+import type { KeyboardPanelCommand, KeyboardPanelState } from "../gesture/keyboard-panel";
 import type { ManagedRequestChunk, ManagedRequestHeaders, ManagedRequestOptions, ManagedRequestResult } from "../runtime/request/request-types";
 import type { MiniAppContentMode, MiniAppFileMap, MiniAppHostApiRequest, MiniAppInspectorSelectionMode, MiniAppLoadFilesOptions, MiniAppLoadZipOptions, MiniAppRedirectOptions, MiniAppSecurityOptions, MiniAppSimulatorOptions, MiniAppSimulatorRoute, MiniAppViewport } from "../types";
 /**
@@ -14,6 +15,8 @@ export declare const REMOTE_INSPECTOR_PAUSE_RUNTIME_CAPABILITY = "inspectorPause
  * 版本不一致会让老 runtime 直接握手失败，而评测是可选能力，缺失只应降级。
  */
 export declare const REMOTE_AUDIT_CAPABILITY = "audit";
+/** Client 可在外层页面承载 Runtime 的键位编辑浮窗。 */
+export declare const REMOTE_KEYBOARD_PANEL_CAPABILITY = "keyboardPanelPortal";
 export declare const REMOTE_SIMULATOR_CAPABILITIES: string[];
 export type RemoteSimulatorSerializableOptions = Omit<MiniAppSimulatorOptions, "mount" | "appId" | "renderer" | "serviceWorker" | "security" | "jsapi" | "hostApi" | "tracker" | "runtimeLimits" | "onEvent" | "onReady" | "onBeforeLoad" | "onLoad" | "onRenderDone" | "onError" | "onNavigation" | "onConsole" | "onNetwork" | "onDestroy" | "onRouterChange" | "onScreenShot"> & {
     appUrl?: string;
@@ -39,6 +42,7 @@ export interface RemoteSimulatorConnectMessage {
     hostApiStubs: Record<string, {
         toast: string;
     }>;
+    clientCapabilities?: string[];
     options: RemoteSimulatorSerializableOptions;
 }
 /** Mars 队列项提供的稳定业务标识；随评测点位进入 APM，不进入被测 guest。 */
@@ -50,7 +54,7 @@ export interface RemoteAuditContext {
 }
 /** Runtime 发给宿主的内部评测点位；只允许扁平标量字段。 */
 export interface RemoteAuditTelemetryPayload {
-    name: "miniapp_audit_session" | "miniapp_audit_sample" | "miniapp_audit_paint" | "miniapp_audit_incident" | "miniapp_audit_package" | "miniapp_audit_result";
+    name: "miniapp_audit_session" | "miniapp_audit_paint" | "miniapp_audit_incident" | "miniapp_audit_package" | "miniapp_audit_result";
     sessionId: string;
     fields: Record<string, string | number | null | undefined>;
     flush?: boolean;
@@ -60,6 +64,8 @@ export interface RemoteSimulatorReadyMessage {
     protocolVersion: number;
     runtimeVersion: string;
     capabilities: string[];
+    /** 当前 Runtime entry 自身的模块地址，供外层页面复用同一资源。 */
+    runtimeModuleUrl?: string;
 }
 export interface RemoteSimulatorRequestMessage {
     type: "request";
@@ -82,6 +88,23 @@ export interface RemoteSimulatorEventMessage {
     event: string;
     payload: unknown;
 }
+export interface RemoteKeyboardPanelStateMessage {
+    type: "keyboard-panel-state";
+    controllerId: string;
+    revision: number;
+    /** null 显式销毁该控制器的浮窗；后续状态不能复活它。 */
+    state: KeyboardPanelState | null;
+}
+export interface RemoteKeyboardPanelCommandMessage {
+    type: "keyboard-panel-command";
+    controllerId: string;
+    command: KeyboardPanelCommand;
+}
+export interface RemoteKeyboardPanelPresenceMessage {
+    type: "keyboard-panel-presence";
+    controllerId: string;
+    active: boolean;
+}
 /** Runtime 请求宿主执行不可序列化的 hostApi handler。 */
 export interface RemoteHostApiRequestMessage {
     type: "host-api-request";
@@ -132,7 +155,7 @@ export interface RemoteHostRequestEventMessage {
 export type RemoteSimulatorPortMessage = {
     type: "worker-visibility";
     visible: boolean;
-} | RemoteSimulatorReadyMessage | RemoteSimulatorRequestMessage | RemoteSimulatorResponseMessage | RemoteSimulatorEventMessage | RemoteHostApiRequestMessage | RemoteHostApiResponseMessage | RemoteHostRequestMessage | RemoteHostRequestResponseMessage | RemoteHostRequestAbortMessage | RemoteHostRequestEventMessage;
+} | RemoteKeyboardPanelStateMessage | RemoteKeyboardPanelCommandMessage | RemoteKeyboardPanelPresenceMessage | RemoteSimulatorReadyMessage | RemoteSimulatorRequestMessage | RemoteSimulatorResponseMessage | RemoteSimulatorEventMessage | RemoteHostApiRequestMessage | RemoteHostApiResponseMessage | RemoteHostRequestMessage | RemoteHostRequestResponseMessage | RemoteHostRequestAbortMessage | RemoteHostRequestEventMessage;
 export type RemoteSimulatorMethod = "load" | "loadZip" | "loadFiles" | "loadApp" | "unload" | "reload" | "setViewport" | "switchContentMode" | "switchPhoneFrame" | "switchDevice" | "setTouchEmulation" | "permissionSheet.show" | "permissionSheet.hide" | "notePreview.update" | "notePreview.updateUser" | "notePreview.updateAppCard" | "widgetCover.update" | "router.redirectTo" | "router.getRoute" | "inspector.enable" | "inspector.disable" | "inspector.toggle" | "inspector.clear" | "inspector.setSelectionMode" | "inspector.getSelectionMode" | "inspector.getSceneTree" | "inspector.selectByRef" | "capture" | "screenShot" | "setAutoScreenShot" | "hostApi.sync" | "hostApi.emit" | "audit.start" | "audit.stop" | "audit.status" | "audit.report" | "audit.setPolicy" | "destroy";
 export interface RemoteLoadZipArgs {
     buffer: ArrayBuffer;
@@ -196,7 +219,7 @@ export interface RemoteAuditStartArgs {
      */
     durationMs?: number;
     armingMs?: number;
-    declaredAppType?: "tool" | "game2d" | "game3d" | "video";
+    declaredAppType?: "tool" | "game2d" | "game3d";
 }
 /**
  * 评测报告的跨 iframe 序列化契约。
@@ -274,8 +297,19 @@ export interface RemoteAuditReport {
         interactionCount: number;
         firstInteractionAt?: number;
     };
-    appType: "tool" | "game2d" | "game3d" | "video";
+    appType: "tool" | "game2d" | "game3d";
     tagMismatch: boolean;
+    classification?: {
+        engine?: string;
+        evidence: string[];
+        inferred: boolean;
+        frameworks?: Array<{
+            id: string;
+            confidence: "strong" | "candidate";
+            evidence: string[];
+        }>;
+        sourceScanComplete?: boolean;
+    };
     versions: {
         policyVersion: string;
         rulesVersion: string;

package/lib/types/remote/runtime-entry.d.ts

@@ -1 +1,2 @@
-export {};
+export { keyboardPanelCommandNeedsGameFocus } from "../gesture/keyboard-panel";
+export { createKeyboardPanelView } from "../gesture/keyboard-panel-view";

package/lib/types/remote/runtime.d.ts

@@ -13,4 +13,4 @@ export interface RemoteRuntimeConfig {
     /** 与本 Runtime release 绑定的独立评测插件；仅 Mars 审核会话动态加载。 */
     auditPluginUrl?: string;
 }
-export declare function startRemoteMiniAppSimulatorRuntime(): void;
+export declare function startRemoteMiniAppSimulatorRuntime(runtimeModuleUrl: string): void;

package/lib/types/runtime/jsapi-modules/interaction.d.ts

@@ -1,4 +1,4 @@
 import type { SimulatorJsapiContext } from "./context";
 import type { SimulatorJsapiModule } from "./types";
-export type InteractionJsapiModuleContext = Pick<SimulatorJsapiContext, "overlayRoot" | "showNotePublish" | "vibrate">;
+export type InteractionJsapiModuleContext = Pick<SimulatorJsapiContext, "overlayRoot" | "showNotePublish" | "vibrate" | "loadedUrl" | "fileSystemHost" | "fileSystemMountId" | "appId">;
 export declare function createInteractionJsapiModule(context: InteractionJsapiModuleContext): SimulatorJsapiModule;

package/lib/types/runtime/jsapi-modules/local-media.d.ts

@@ -0,0 +1,4 @@
+import { type SimulatorFileSystemContext } from "./filesystem";
+export declare const SIMULATOR_FILE_MARKER = "/_xhsfile_/";
+/** Read virtual media through its app-scoped bridge, including outside the SW scope. */
+export declare function readSimulatorMediaBlob(context: SimulatorFileSystemContext, source: string): Promise<Blob>;

package/lib/types/runtime/jsapi-modules/media.d.ts

@@ -1,5 +1,5 @@
 import { type MiniAppHostApiHandler } from "../../types";
-import { type SimulatorFileSystemContext } from "./filesystem";
+import type { SimulatorFileSystemContext } from "./filesystem";
 import type { SimulatorJsapiModule } from "./types";
 /** The simulator state used by browser media APIs. */
 export interface MediaJsapiModuleContext extends SimulatorFileSystemContext {

package/lib/types/runtime/jsapi-modules/note-publish-media.d.ts

@@ -0,0 +1,9 @@
+import type { NotePublishViewData } from "../../native-ui/note-publish";
+import type { SimulatorFileSystemContext } from "./filesystem";
+/** Object URLs belong to one preview and are released when it settles or fails to prepare. */
+export declare function createNotePublishMediaResolver(context: SimulatorFileSystemContext & {
+    readonly loadedUrl: string;
+}): {
+    prepare(data: NotePublishViewData): Promise<NotePublishViewData>;
+    dispose(): void;
+};

package/lib/types/tracker/constants.d.ts

@@ -8,7 +8,7 @@ export declare const APM_ENDPOINT: Record<MiniAppApmRegion, {
     production: string;
     development: string;
 }>;
-/** 批量上报：缓冲达到此条数立即发送 */
+/** 批量上报：单次请求最多此条数；缓冲达到此条数触发发送。 */
 export declare const APM_BATCH_MAX = 10;
 /** 批量上报：缓冲未满时最多等待此毫秒后发送 */
 export declare const APM_BATCH_FLUSH_MS = 10000;

package/lib/types/tracker/default-tracker.d.ts

@@ -2,7 +2,7 @@ import type { MiniAppApmRegion, MiniAppTrackerEvent } from "../types";
 /** 默认 Tracker 的上报方法集合 */
 export interface DefaultTracker {
     sendCustomPoint(event: MiniAppTrackerEvent): void;
-    /** 立即发送缓冲中的所有打点 */
+    /** 将缓冲中的所有打点加入发送队列 */
     flush(): void;
 }
 export interface DefaultTrackerDeliveryResult {

package/lib/types/types/options.d.ts

@@ -487,6 +487,9 @@ export interface MiniAppSimulatorOptions extends MiniAppLifecycleCallbacks {
     debug?: boolean;
     /** 开启鼠标→触摸事件模拟，使桌面端鼠标操作还原真机 touch 行为（显示小手光标与触点圆点） */
     touchEmulation?: boolean;
+    /** 桌面审核操作面板（区域键位映射与屏幕旋转），默认关闭；Mars Runtime 自动启用。
+     * 启用时默认开启 touchEmulation；显式关闭 touchEmulation 时面板一并关闭。 */
+    desktopControls?: boolean;
     /** Visual Inspector 运行时能力；游戏暂停代理默认关闭。 */
     visualInspector?: MiniAppVisualInspectorOptions;
     /** 在父级 bounds 内自适应缩放；默认开启，可传 `false` 关闭或 `{ resizeHandle: true }` 启用手动拖拽缩放 */
@@ -548,6 +551,7 @@ export interface NormalizedMiniAppSimulatorOptions extends Omit<MiniAppSimulator
     timeout: number;
     debug: boolean;
     touchEmulation: boolean;
+    desktopControls: boolean;
     visualInspector: NormalizedMiniAppVisualInspectorOptions;
     stageFit: false | NormalizedMiniAppStageFitOptions;
     jsapi: NormalizedMiniAppJsApiOptions;
@@ -803,8 +807,8 @@ export interface MiniAppSimulator {
      * 返回 false 表示当前不是 SW 直供状态。
      */
     refreshInjection(): Promise<boolean>;
-    /** 打开与设备画布并排的侧栏，返回可挂载内容的容器。 */
-    openSidePanel(width: number): HTMLElement;
+    /** 打开与设备画布并排的侧栏；宽度在 width 与 maxWidth 之间自适应。 */
+    openSidePanel(width: number, maxWidth?: number): HTMLElement;
     /** 收起侧栏并清空其内容。 */
     closeSidePanel(): void;
     /** 整块模拟器的交互区域（设备、侧栏及内部留白），用于边界监听。 */

package/lib/types/types/renderer.d.ts

@@ -1,3 +1,5 @@
+import type { ScreenRotationDirection } from "../utils/screen-coordinates";
+import type { KeyboardPanelHost } from "../gesture/keyboard-panel";
 import type { InjectionRegistry } from "../injection/registry";
 import type { NotePublishResult, NotePublishViewData } from "../native-ui/note-publish/view-data";
 import type { MiniAppPermissionKind, MiniAppPermissionSheetResult } from "../native-ui/permission-sheet/types";
@@ -99,6 +101,12 @@ export interface RendererAdapterContext {
     debug: boolean;
     /** 是否启用鼠标→触摸事件模拟 */
     touchEmulation?: boolean;
+    /** 显示桌面审核操作面板。 */
+    desktopControls?: boolean;
+    /** Remote Client 承载键位浮窗的内部通道。 */
+    keyboardPanelHost?: KeyboardPanelHost;
+    /** 整台设备 CSS 按指定方向旋转 90 度，保持 guest 逻辑视口尺寸。 */
+    rotateScreen?: (direction: ScreenRotationDirection) => void;
     /** jsapi 注入与 mock 配置 */
     jsapi: NormalizedMiniAppJsApiOptions;
     contentMode: MiniAppContentMode;

package/lib/types/utils/screen-coordinates.d.ts

@@ -0,0 +1,31 @@
+export type ScreenRotationDirection = "clockwise" | "counterclockwise";
+export type ScreenRotation = 0 | -90 | -180 | -270;
+/** 设备 CSS 旋转只改变显示方向，载体的 offset 尺寸始终属于 guest 逻辑视口。 */
+export declare function getScreenRotation(element: Element): ScreenRotation;
+/** host client 坐标 → guest / 元素局部 CSS 像素；保留屏幕外拖拽坐标。 */
+export declare function hostToLocal(element: HTMLElement, hostX: number, hostY: number): {
+    x: number;
+    y: number;
+};
+/** guest / 元素局部 CSS 像素 → host client 坐标。 */
+export declare function localToHost(element: HTMLElement, x: number, y: number): {
+    x: number;
+    y: number;
+};
+/** host 向量 → guest 向量；行/页单位传 false，只转换方向、不缩放。 */
+export declare function hostVectorToLocal(element: HTMLElement, dx: number, dy: number, scaleToPixels?: boolean): {
+    x: number;
+    y: number;
+};
+/** 局部矩形在 host client 空间的轴对齐包围盒。 */
+export declare function localRectToHost(element: HTMLElement, rect: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};

package/lib/workbench.js

@@ -1,4 +1,4 @@
-import { c as Mn } from "./client-BDt3WDu_.mjs";
+import { c as Mn } from "./client-C59iNO5u.mjs";
 function Sn(a, i) {
   const e = /* @__PURE__ */ new Map();
   let v = 0, l = !1, w, b, L, m, u;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillbuilder/miniapp-simulator",
-  "version": "0.2.4",
+  "version": "0.2.8",
   "description": "Designable Miniapp Simulator - 技术栈无关的小应用 PC 预览与审核模拟器 SDK",
   "main": "lib/index.js",
   "module": "lib/index.js",