@skillbuilder/miniapp-simulator 0.2.4 → 0.2.7

package/lib/remote-client.js

@@ -1,6 +1,6 @@
-import { R as r, a as O, c as e } from "./client-BDt3WDu_.mjs";
+import { R as r, a as O, c as e } from "./client-BjYHK9LR.mjs";
 import { B as s, M as _ } from "./options-B34ipLmF.mjs";
-import { M } from "./index-7MeYFlk_.mjs";
+import { M } from "./index-CqClPZVv.mjs";
 export {
   s as BusinessLine,
   _ as MINIAPP_SCREENSHOT_ERROR_CODE,

package/lib/types/host/shadow-host.d.ts

@@ -39,8 +39,8 @@ export interface MiniAppShadowHost {
      * 盖住后审核员既看不到小工具也点不到它。
      */
     sidePanel: HTMLElement;
-    /** 设置侧栏宽度；传 0 收起。bounds 自动让出对应宽度并重新居中设备。 */
-    setSidePanelWidth(width: number): void;
+    /** 设置侧栏最小/最大宽度；传 0 收起。bounds 自动让出对应宽度。 */
+    setSidePanelWidth(width: number, maxWidth?: number): void;
     /** 销毁：移除创建的宿主元素 */
     destroy(): void;
 }

package/lib/types/remote/audit-controller.d.ts

@@ -5,6 +5,11 @@ export interface AuditPackageSnapshot {
         path: string;
         size: number;
     }>;
+    sources?: Array<{
+        path: string;
+        text: string;
+    }>;
+    sourceScanComplete?: boolean;
 }
 export interface AuditControllerDeps {
     /** 当前 simulator 实例（需支持 registerInjection / reload） */

package/lib/types/remote/audit-package-sources.d.ts

@@ -0,0 +1,9 @@
+import type { MiniAppFileMap } from "../types";
+/** 源码仅供远程评测插件静态扫描，使用字符串避免 loadFiles 转移 ArrayBuffer 后失效。 */
+export declare function collectAuditSources(files: MiniAppFileMap): {
+    sources: Array<{
+        path: string;
+        text: string;
+    }>;
+    sourceScanComplete: boolean;
+};

package/lib/types/remote/audit-telemetry.d.ts

@@ -1,23 +1,36 @@
 export type AuditApmFields = Record<string, string | number | null | undefined>;
-/** 候选点位和终态共用一份扁平契约；缺失值省略，布尔值转为 0/1。 */
-export declare function toAuditPaintFields(input: unknown): AuditApmFields;
-interface AuditTelemetryMetadata {
+export interface AuditMetricRecord extends AuditApmFields {
+    name: string;
+    time?: number;
+    memory?: number;
+    size?: number;
+    score?: number;
+    weight?: number;
+    ratio?: number;
+    value?: number;
+    unit?: string;
+    count?: number;
+    result?: string;
+}
+/** 仅清理缺失和非法数值，不推断字段名、类型或单位。 */
+export declare function compactFields(fields: AuditApmFields): AuditApmFields;
+/** 首屏直接指定 time，不依赖输入字段名称推断。 */
+export declare function toAuditPaintRecords(input: unknown, emit?: {
+    fcp: boolean;
+    lcp: boolean;
+}): AuditApmFields[];
+interface PackageMetadata {
     appType?: string;
     declaredAppType?: string;
     features?: string[];
-    policyVersion?: string;
-    rulesVersion?: string;
-    probeVersion?: string;
 }
-/** 只上报静态聚合，不把文件路径清单带入 APM。 */
-export declare function toAuditPackageFields(pkg: {
+export declare function toAuditPackageRecords(pkg: {
     zipBytes: number;
     files: Array<{
         path: string;
         size: number;
     }>;
-}, metadata: AuditTelemetryMetadata, uncompressedJsThresholdBytes: number): AuditApmFields;
-/** 报告和派生指标转成 APM 可检索的扁平标量。 */
-export declare function toAuditResultFields(report: unknown, metrics?: unknown): AuditApmFields;
-export declare function compactFields(fields: AuditApmFields): AuditApmFields;
+}, metadata: PackageMetadata, uncompressedJsThresholdBytes: number): AuditApmFields[];
+/** 终态：每个指标同时携带实测值、得分和权重，诊断状态集中在摘要中。 */
+export declare function toAuditResultRecords(report: unknown, metrics?: unknown): AuditApmFields[];
 export {};

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

@@ -50,7 +50,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;
@@ -196,7 +196,7 @@ export interface RemoteAuditStartArgs {
      */
     durationMs?: number;
     armingMs?: number;
-    declaredAppType?: "tool" | "game2d" | "game3d" | "video";
+    declaredAppType?: "tool" | "game2d" | "game3d";
 }
 /**
  * 评测报告的跨 iframe 序列化契约。
@@ -274,8 +274,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/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

@@ -803,8 +803,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/workbench.js

@@ -1,4 +1,4 @@
-import { c as Mn } from "./client-BDt3WDu_.mjs";
+import { c as Mn } from "./client-BjYHK9LR.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.7",
   "description": "Designable Miniapp Simulator - 技术栈无关的小应用 PC 预览与审核模拟器 SDK",
   "main": "lib/index.js",
   "module": "lib/index.js",