@skillbuilder/miniapp-simulator 0.2.8 → 0.2.9

package/lib/remote-client.js

@@ -1,6 +1,6 @@
-import { R as r, a as O, c as e } from "./client-C59iNO5u.mjs";
+import { R as r, a as O, c as e } from "./client-CX13jDtT.mjs";
 import { B as s, M as _ } from "./options-B34ipLmF.mjs";
-import { M } from "./index-BSj1bmle.mjs";
+import { M } from "./index-DwepISqo.mjs";
 export {
   s as BusinessLine,
   _ as MINIAPP_SCREENSHOT_ERROR_CODE,

package/lib/types/core/simulator.d.ts

@@ -1,5 +1,242 @@
 import type { KeyboardPanelHost } from "../gesture/keyboard-panel";
-import type { MiniAppSimulator as MiniAppSimulatorInterface, MiniAppSimulatorOptions } from "../types";
+import type { OffloadedResourceSession } from "../offload/resource-session";
+import type { InjectionModule } from "../injection";
+import type { MiniAppContentMode, MiniAppEventHandler, MiniAppEventName, MiniAppFileMap, MiniAppGamePlaytestController, MiniAppGestureController, MiniAppHostApiController, MiniAppInspectorController, MiniAppLoadFilesOptions, MiniAppLoadFilesResult, MiniAppLoadZipOptions, MiniAppLoadZipResult, MiniAppLoadZipSource, MiniAppNotePreviewController, MiniAppPermissionSheetController, MiniAppPhoneFrame, MiniAppRedirectOptions, MiniAppScreenShotResult, MiniAppSimulator as MiniAppSimulatorInterface, MiniAppSimulatorOptions, MiniAppSimulatorRoute, MiniAppSimulatorStatus, MiniAppViewport, MiniAppWidgetCoverController } from "../types";
+declare class MiniAppSimulatorImpl implements MiniAppSimulatorInterface {
+    private readonly runtimeOptions;
+    private readonly lifecycle;
+    private readonly events;
+    /** SDK 在消费方 root 内创建的 shadow 宿主（含 stage / bounds） */
+    private readonly shadowHost;
+    private readonly phoneVibration;
+    /**
+     * 注入清单：security / jsapi / render-done 三个内置模块在 constructor 注册，
+     * 跨 reload 持久存在；后续可由 plugin 追加自定义注入。
+     */
+    private readonly injection;
+    private options;
+    private renderer;
+    /** 只允许最新一次加载继续提交状态；快速切版本时旧解析/挂载会被静默回收。 */
+    private loadGeneration;
+    private loadedUrl;
+    /** 当前 load 的触发来源，供 beforeLoad 事件标记 */
+    private loadSource;
+    /** SW 渲染模式：当前生效的 SW 宿主与已挂载 id（下次加载 / 销毁时 UNMOUNT 回收） */
+    private swHost;
+    private swMountedId;
+    /**
+     * 重算 head 注入所需的入参快照。SW 直供下 head 是 mount 时算好交给 worker 的，
+     * reload 只是重导航虚拟 URL，不会重新走注入装配；运行期新增注入模块（评测探针）
+     * 必须靠这份快照重算并 remount 才能生效。
+     */
+    private swInjectionContext;
+    /**
+     * setHeapLimitOverride 生效前的原值，供恢复用。undefined 表示当前没有覆盖。
+     * 只记一次：评测期间反复改值也只能回到最初的线上限值。
+     */
+    private baseHeapLimit;
+    /** 同步注入与 getLaunchOptions 共用的当前 usr 根路径。 */
+    private userDataPath;
+    /** SW 注册失败后置位：远程 appUrl 后续以真实 URL 直连（跳过 SW 代理） */
+    private serviceWorkerUnavailable;
+    private detachStageFit;
+    /** request / xhsRequest / abortRequest 的独立执行层。 */
+    private readonly requestRuntime;
+    private readonly storageScope;
+    /**
+     * 宿主能力 map：构造时来自 `options.hostApi`，运行时通过 `simulator.hostApi.set` 增删。
+     * **不会**自动注册到 bridge.handlers；只供内置 bridge handler 按需调用，
+     * 即"bridge 实现自己决定是调宿主能力还是 native-ui"。
+     */
+    private readonly hostApiMap;
+    private readonly showJsApiAlert;
+    /** 持久化的用户自定义 gesture plugin：跨 reload / renderer 重建保留 */
+    private readonly gesturePlugins;
+    /** 持久化的选取模式开启状态：跨 reload / renderer 重建后自动重应用 */
+    private inspectorEnabled;
+    /** 可视化选取的单选 / 多选模式：跨 renderer 重建保留 */
+    private inspectorSelectionMode;
+    private readonly tracker;
+    /** Debug 调试面板（仅 options.debug 时实例化）；跨 reload 持久存在 */
+    private devtoolsPanel;
+    /** Debug 面板唤起快捷键卸载函数 */
+    private detachDevtoolsShortcut;
+    /** 当前页面路由（note / minitool / profile） */
+    private currentRoute;
+    /** 小工具收起后回落的活动页（note 笔记页 / profile 个人页） */
+    private activePage;
+    /** JSAPI 模块共用的只读运行态视图；字段访问始终读取最新模拟器状态。 */
+    private get jsapiContext();
+    readonly hostApi: MiniAppHostApiController;
+    readonly gesture: MiniAppGestureController;
+    readonly gamePlaytest: MiniAppGamePlaytestController;
+    readonly inspector: MiniAppInspectorController;
+    readonly notePreview: MiniAppNotePreviewController;
+    readonly widgetCover: MiniAppWidgetCoverController;
+    readonly permissionSheet: MiniAppPermissionSheetController;
+    constructor(options: MiniAppSimulatorOptions, runtimeOptions?: {
+        keyboardPanelHost?: KeyboardPanelHost;
+        requestManagerFrameUrl?: string;
+        gateways?: Record<string, string>;
+        businessLine?: string;
+        trackerContext?: () => Record<string, string | number | undefined>;
+    });
+    /**
+     * 初始化 Debug 调试面板：以 fixed 停靠窗口右侧（挂 document.body，不遮挡模拟器舞台），
+     * 注册 Shift+Cmd/Ctrl+U 唤起快捷键。能力开关仅供内部调试并触发整页 reload。
+     */
+    private initDevtools;
+    /** 从当前归一化选项构造调试面板快照 */
+    private buildDevtoolsSnapshot;
+    /** device 作为渲染容器，bounds 作为 stageFit 默认边界 */
+    private normalizeContext;
+    /** 去掉仅在创建期使用、normalize 不需要的 host / 回调字段 */
+    private stripHostOptions;
+    /** 实例创建时把 option 级回调绑定到对应事件 */
+    private bindLifecycleCallbacks;
+    /**
+     * 合并补丁并重新归一化（深合并 notePreview / security / review，与 updateConfig 一致）。
+     * 入参允许是已归一化形态（来自 this.options）+ 局部覆盖。
+     */
+    private mergeOptions;
+    get status(): MiniAppSimulatorStatus;
+    /**
+     * 尝试调用宿主注册的 getUserInfo handler 获取用户信息，
+     * 用于更新笔记页导航栏与个人页（资料区 / 卡片作者行）的头像和昵称。
+     * 未注册或调用失败时静默保留默认值。
+     */
+    private tryResolveHostUserInfo;
+    private syncRendererRednoteContext;
+    private syncRendererProfileContext;
+    /** 小工具封面：同步到 renderer 壳层（笔记尾卡 + 个人页卡片两处生效） */
+    private syncRendererWidgetCover;
+    /** 更新当前路由；变化时统一发出 routerChange 事件（宿主调用与内部跳转共用） */
+    private setRoute;
+    /** 壳层路由变化：note/profile（头像 / 返回 / 宿主跳转）、minitool（sheet 唤起）、back（sheet 收起回落活动页） */
+    private handleShellRouteChange;
+    getCurrentRoute(): MiniAppSimulatorRoute;
+    redirectTo(route: MiniAppSimulatorRoute, options?: MiniAppRedirectOptions): Promise<void>;
+    load(): Promise<void>;
+    private isCurrentLoad;
+    /** 终止当前 guest，并回收其 renderer 与 SW 挂载。 */
+    private interruptCurrentGuest;
+    private loadCurrent;
+    unload(): void;
+    /**
+     * 执行宿主定制项：函数则直接调用；`{ toast }` 则弹该文案并回成功。
+     */
+    private runHostEntry;
+    private runUnsupportedJsApi;
+    /** 注册模拟器 JSAPI 领域模块；未声明事件仍由 fallback 分发。 */
+    private registerBuiltinBridgeHandlers;
+    reload(): Promise<void>;
+    resize(viewport: MiniAppViewport): void;
+    /** @deprecated 创建实例时传入完整配置；配置变化时销毁并重新创建实例。 */
+    updateConfig(options: Partial<Omit<MiniAppSimulatorOptions, "mount" | "shadow">>): void;
+    setViewport(viewport: MiniAppViewport): void;
+    setZoomFactor(factor: number): void;
+    switchMode(mode: MiniAppContentMode): Promise<void>;
+    switchContentMode(mode: MiniAppContentMode): Promise<void>;
+    switchPhoneFrame(frame: string | MiniAppPhoneFrame | false): Promise<void>;
+    switchDevice(device: string): void;
+    loadApp(appUrl: string, options?: {
+        query?: MiniAppSimulatorOptions["query"];
+    }): Promise<void>;
+    loadZip(source: MiniAppLoadZipSource, options?: MiniAppLoadZipOptions): Promise<MiniAppLoadZipResult>;
+    loadFiles(files: MiniAppFileMap, options?: MiniAppLoadFilesOptions, offloaded?: OffloadedResourceSession): Promise<MiniAppLoadFilesResult>;
+    /**
+     * loadZip / loadFiles 走 `iframe-service-worker`（Web 运行时）：把包文件挂载给
+     * Service Worker 当同源虚拟服务器直供。使用前请把 renderer 设为 `iframe-service-worker`。
+     */
+    private assertServiceWorkerLoader;
+    /** SW 模式前置校验：环境/配置不满足直接抛（宿主据此提示加载失败）。 */
+    private assertServiceWorkerUsable;
+    private toLoadMeta;
+    /** 注册 + 激活 SW（打点注册结果 / 耗时）；注册失败置 serviceWorkerUnavailable，后续跳过 SW。 */
+    private acquireServiceWorkerHost;
+    /** SW 路径：算注入载荷 → 挂载原始文件到 SW → 以同源虚拟 URL 直连（SW 改写 HTML + 下发 CSP）。 */
+    private loadViaServiceWorker;
+    /** 是否对当前远程 appUrl 启用 SW 代理：SW 渲染器 + 配了 scriptUrl + 环境支持 + 未注册失败 + appUrl 为跨域 http(s)。 */
+    private shouldProxyRemoteViaServiceWorker;
+    /** load() 内调用：远程 appUrl 满足条件时挂进 SW 走同源代理；失败经 error 事件暴露并抛出。 */
+    private maybeMountRemoteViaServiceWorker;
+    /** 半屏/全屏壳层收起后再次唤起时，先恢复 SW 注册与内存挂载表，再加载虚拟 URL。 */
+    private restoreServiceWorkerMount;
+    /** 远程 SW 代理：fetch 远程入口 HTML（需开 CORS）→ 注入 → 仅挂入口+remoteBase → appUrl 改写为同源虚拟 URL，子资源由 SW 回源。 */
+    private mountRemoteViaServiceWorker;
+    setTouchEmulation(enabled: boolean): Promise<void>;
+    /** 回收 SW 模式的挂载。 */
+    private unmountServiceWorkerContent;
+    private resolveLoadUrl;
+    private isCurrentServiceWorkerMountUrl;
+    /**
+     * 开关小应用 DevTools。仅 webview 渲染器实现（独立 webContents）；
+     * iframe 渲染器无该能力时为 no-op（DevTools 由宿主整窗负责）。
+     */
+    setDevtools(open: boolean): void;
+    /**
+     * 开关手势 overlay 的 pointer-events（touchEmulation 时生效）。
+     * 宿主嵌入 DevTools 做 Elements 审查时应设为 false，让点击穿透到 guest。
+     */
+    setGestureOverlayInteractionEnabled(enabled: boolean): void;
+    /**
+     * 返回小应用渲染容器的 webContents id（仅 webview 渲染器，dom-ready 后可用，否则 null）。
+     * 不做 lifecycle 断言：宿主可能在 load 完成后立即轮询。
+     */
+    getWebContentsId(): number | null;
+    /**
+     * 注册宿主侧扩展注入模块（评测探针等）。下次 load / reload 生效。
+     *
+     * 注册后会把 security 重新移回末位：seal 锁定内置原型，探针必须在它之前安装，
+     * 否则 hook 目标属性已不可配置，采集静默归零。
+     */
+    registerInjection(module: InjectionModule): void;
+    /** 注销扩展注入模块；下次 load / reload 生效。返回是否命中。 */
+    unregisterInjection(id: string): boolean;
+    /**
+     * 打开评测面板等内容的独立容器：竖直摆放时在设备右侧，旋转时在设备下方。
+     *
+     * 右侧面板在 width 与 maxWidth 之间适度扩展，底部面板占满挂载区宽度。
+     * 设备由 stageFit 在剩余区域内等比适配，桌面操作模式下靠上摆放。
+     */
+    openSidePanel(width: number, maxWidth?: number): HTMLElement;
+    /** 收起侧栏并清空其内容；设备恢复占满整个挂载区。 */
+    closeSidePanel(): void;
+    /** 整块模拟器容器，包含设备、侧栏及容器内留白。 */
+    getInteractionRegions(): readonly HTMLElement[];
+    /**
+     * 临时调整 guest 堆熔断线，供体验评测使用；传 null 恢复建实例时的值。
+     *
+     * 熔断会把整个 iframe 换成 about:blank，注入的探针随 Realm 一起消失，本次采集
+     * 只能作废——而"内存占用大"正是评测最该测出来的事。改值后须调 refreshInjection
+     * 并 reload 才会重新下发 resource-guard 的新阈值。
+     */
+    setHeapLimitOverride(maxHeapUsedBytes: number | false | null): void;
+    /**
+     * 重算 head 注入并就地替换 SW 已挂载实例的注入载荷。
+     *
+     * SW 直供路径下 head 是 mount 时一次性算好交给 worker 的，reload 只重导航虚拟 URL，
+     * 拿到的仍是旧 HTML。运行期通过 registerInjection 新增的模块必须调一次本方法，
+     * 之后的 reload 才会带上新注入。
+     *
+     * 返回 false 表示当前不是 SW 直供状态（无快照），调用方应改走完整 load。
+     */
+    refreshInjection(): Promise<boolean>;
+    capture(): Promise<Blob>;
+    /**
+     * 主动截取小工具运行画面（完整画面）：成功返回 base64 dataURL，失败返回 code + reason（不抛异常）。
+     * 结果同时以 `screenShot` 事件（source: "manual"）对外发出。
+     */
+    screenShot(): Promise<MiniAppScreenShotResult>;
+    destroy(reason?: string): void;
+    on<E extends MiniAppEventName>(event: E, handler: MiniAppEventHandler<E>): () => void;
+    once<E extends MiniAppEventName>(event: E, handler: MiniAppEventHandler<E>): () => void;
+    off<E extends MiniAppEventName>(event: E, handler: MiniAppEventHandler<E>): void;
+    /** 根据渲染器类型创建对应的 Transport；webview 手势 IPC 与 jsapi bridge 共用通道 */
+    private createTransport;
+    private createRenderer;
+    private bindRendererEvents;
+}
 export declare function createMiniAppSimulator(options: MiniAppSimulatorOptions): MiniAppSimulatorInterface;
 /** @internal 远程 Runtime 注入服务端托管资源；不属于接入方配置。 */
 export declare function createRuntimeMiniAppSimulator(options: MiniAppSimulatorOptions, runtimeOptions: {
@@ -8,4 +245,5 @@ export declare function createRuntimeMiniAppSimulator(options: MiniAppSimulatorO
     gateways?: Record<string, string>;
     businessLine?: string;
     trackerContext?: () => Record<string, string | number | undefined>;
-}): MiniAppSimulatorInterface;
+}): MiniAppSimulatorImpl;
+export {};

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

@@ -45,6 +45,11 @@ export interface MiniAppShadowHost {
     sidePanel: HTMLElement;
     /** 设置竖直摆放时侧栏最小/最大宽度；传 0 收起。bounds 自动让出面板空间。 */
     setSidePanelWidth(width: number, maxWidth?: number): void;
+    /** 同一宿主内，整台手机转过 90° 后可用于显示的区域。 */
+    getQuarterTurnBounds(bounds: HTMLElement): {
+        width: number;
+        height: number;
+    };
     /** 桌面工具栏的空间只影响宿主布局。 */
     setDesktopControls(enabled: boolean): void;
     /** 整台设备每次按指定方向旋转 90°，四次回到原位，不改变 guest 逻辑尺寸。 */

package/lib/types/offload/manifest.d.ts

@@ -0,0 +1,12 @@
+export declare const RESOURCE_MANIFEST_PATH = "__xhs_offload__/resources.json";
+export interface OffloadedResource {
+    fileId: string;
+    size: number;
+    sha256: string;
+    mimeType: string;
+}
+export interface ResourceManifest {
+    artifactId: string;
+    resources: Map<string, OffloadedResource>;
+}
+export declare function parseResourceManifest(bytes: ArrayBuffer | undefined): ResourceManifest;

package/lib/types/offload/resource-session.d.ts

@@ -0,0 +1,33 @@
+import { BusinessLine } from "../business-line";
+import type { MiniAppHostRequest } from "../types";
+import type { ResourceManifest } from "./manifest";
+export interface OffloadedResourceContext {
+    url: string;
+    params: Record<string, string>;
+    creatorId: string;
+    request: MiniAppHostRequest;
+}
+export declare function getOffloadedResourceRoute(businessLine: BusinessLine, { edith, appId, contentId }: {
+    edith: string;
+    appId: string;
+    contentId: string;
+}): Pick<OffloadedResourceContext, "url" | "params"> | undefined;
+/** 一个精简包的签名表。SW 只能按已登记的包内路径查询。 */
+export declare class OffloadedResourceSession {
+    readonly manifest: ResourceManifest;
+    private readonly context;
+    private readonly onUnavailable;
+    private readonly lifetime;
+    private readonly addresses;
+    private readonly ids;
+    private pending?;
+    private retryAfter;
+    private refreshAfter;
+    private refreshCount;
+    constructor(manifest: ResourceManifest, context: OffloadedResourceContext, onUnavailable: (count: number) => void);
+    dispose(): void;
+    resolve(path: string, rejectedUrl?: string): Promise<string>;
+    prepare(): Promise<void>;
+    private unresolvedIds;
+    private exchange;
+}

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

@@ -44,6 +44,8 @@ export interface RemoteMiniAppSimulator {
     load(): Promise<void>;
     loadZip(source: Blob | ArrayBuffer | Uint8Array, options?: {
         entry?: string;
+        offloaded?: boolean;
+        creatorId?: string;
     }): Promise<MiniAppLoadZipResult>;
     loadFiles(files: RemoteMethodArgumentMap["loadFiles"][0]["files"], options?: RemoteMethodArgumentMap["loadFiles"][0]["options"]): Promise<MiniAppLoadFilesResult>;
     loadApp(url: string, options?: RemoteMethodArgumentMap["loadApp"][1]): Promise<void>;

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

@@ -15,6 +15,8 @@ export declare const REMOTE_INSPECTOR_PAUSE_RUNTIME_CAPABILITY = "inspectorPause
  * 版本不一致会让老 runtime 直接握手失败，而评测是可选能力，缺失只应降级。
  */
 export declare const REMOTE_AUDIT_CAPABILITY = "audit";
+/** 当前会话支持加载带外移资源清单的精简包。 */
+export declare const REMOTE_OFFLOADED_PACKAGE_CAPABILITY = "offloadedPackage";
 /** Client 可在外层页面承载 Runtime 的键位编辑浮窗。 */
 export declare const REMOTE_KEYBOARD_PANEL_CAPABILITY = "keyboardPanelPortal";
 export declare const REMOTE_SIMULATOR_CAPABILITIES: string[];
@@ -159,7 +161,10 @@ export type RemoteSimulatorPortMessage = {
 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;
-    options?: Omit<MiniAppLoadZipOptions, "jszip">;
+    options?: Omit<MiniAppLoadZipOptions, "jszip"> & {
+        offloaded?: boolean;
+        creatorId?: string;
+    };
 }
 export interface RemoteLoadFilesArgs {
     files: MiniAppFileMap;

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

@@ -1,5 +1,6 @@
 /** Runtime 与 Service Worker 随同一 release 发布，协议版本必须精确一致。 */
-export declare const SERVICE_WORKER_PROTOCOL_VERSION = 5;
+export declare const SERVICE_WORKER_PROTOCOL_VERSION = 6;
+export declare const SW_OFFLOADED_URL = "miniapp:offloaded-resource-url";
 /** 资源 SW 重启后，向持有包快照的可信宿主请求恢复 Worker 挂载。 */
 export declare const SW_WORKER_MOUNT_RECOVERY = "miniapp:restore-worker-mount";
 /** 当前 Service Worker 提供的文件系统操作。 */

package/lib/types/sw/service-worker-host.d.ts

@@ -8,6 +8,7 @@ import { type ServiceWorkerFileSystemArgs, type ServiceWorkerFileSystemOperation
 /** 是否具备启用 SW 模式的运行环境（API 可用 + 安全上下文）。 */
 export declare function isServiceWorkerHostSupported(): boolean;
 export interface ServiceWorkerMountInput {
+    offloaded?: import("../offload/resource-session").OffloadedResourceSession;
     worker?: import("../worker/adapters/package-policy").WorkerMountPolicy;
     id: string;
     /** 入口文件包内路径（如 `index.html`），用于生成虚拟 URL。 */

package/lib/types/sw/worker/mount-store.d.ts

@@ -1,13 +1,15 @@
-/**
- * 挂载表 —— id → 已挂载小工具实例。多预览实例 / 多 iframe 共用一个 SW，按 id 前缀隔离。
- * 负责 MOUNT/UNMOUNT 的存储，以及请求路径 → 实例的两级归属查找（`/<id>/` 标记 + clientId 反查）。
- */
+import type { OffloadedResource } from "../../offload/manifest";
 import type { WorkerMountPolicy } from "../../worker/adapters/package-policy";
 export interface MountedFile {
     bytes: ArrayBuffer;
     mime: string;
 }
 export interface MountedApp {
+    offloaded?: {
+        id: string;
+        resources: Map<string, OffloadedResource>;
+        lifetime: AbortController;
+    };
     worker?: WorkerMountPolicy;
     /** 以包内文件路径为键缓存原始字节及独立 CSP 响应。 */
     workerResponses: Map<string, Response>;
@@ -25,6 +27,7 @@ export interface MountedApp {
 }
 export declare const STORE: Map<string, MountedApp>;
 export interface MountInput {
+    offloaded?: Map<string, OffloadedResource>;
     worker?: WorkerMountPolicy;
     id: string;
     files: Record<string, ArrayBuffer>;

package/lib/types/sw/worker/offloaded.d.ts

@@ -0,0 +1,3 @@
+import type { OffloadedResource } from "../../offload/manifest";
+import type { MountedApp } from "./mount-store";
+export declare function serveOffloaded(app: MountedApp, path: string, resource: OffloadedResource, request: Request): Promise<Response>;

package/lib/types/utils/stage-fit.d.ts

@@ -3,4 +3,10 @@ import type { NormalizedMiniAppStageFitOptions } from "../types";
  * 在 bounds 内对 container 做自适应缩放（默认 100% 撑满；可选右上角拖拽调整 scaleMultiplier）。
  * 卸载时恢复挂载前的内联样式。
  */
-export declare function attachMiniAppStageFit(container: HTMLElement, config: NormalizedMiniAppStageFitOptions): () => void;
+export declare function attachMiniAppStageFit(container: HTMLElement, config: NormalizedMiniAppStageFitOptions, rotation?: {
+    host: HTMLElement;
+    getQuarterTurnBounds(bounds: HTMLElement): {
+        width: number;
+        height: number;
+    };
+}): () => void;

package/lib/workbench.js

@@ -1,4 +1,4 @@
-import { c as Mn } from "./client-C59iNO5u.mjs";
+import { c as Mn } from "./client-CX13jDtT.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.8",
+  "version": "0.2.9",
   "description": "Designable Miniapp Simulator - 技术栈无关的小应用 PC 预览与审核模拟器 SDK",
   "main": "lib/index.js",
   "module": "lib/index.js",
@@ -55,6 +55,7 @@
   "dependencies": {
     "@koa/router": "^15.7.0",
     "@koa/send": "^6.0.0",
+    "@noble/hashes": "1.8.0",
     "chokidar": "^4.0.3",
     "html-to-image": "^1.11.13",
     "jszip": "^3.10.1",