@xtctwins/tctwins-bimx-engine 0.3.8 → 0.3.9

package/types/pages/BimxViewerEntry.vue.d.ts

@@ -3,7 +3,7 @@ import { NavCubePos, TallPanelPos, ThemeColor, Offset, ToolPos, EditPrivilege }
 import { BcfContent } from '../store/bcfReflect';
 import { UserInfo } from '../store/userInfoStore';
 import { Locale } from '../i18n';
-declare const _default: import('vue').DefineComponent<{
+type __VLS_Props = {
     instruction?: InstructionContent | undefined;
     fileId?: string;
     fileName?: string;
@@ -14,8 +14,6 @@ declare const _default: import('vue').DefineComponent<{
     multiModel?: boolean;
     filePaths?: string[];
     modelIds?: string[];
-    loadSequential?: boolean;
-    loadInterval?: number;
     themeColor?: ThemeColor;
     topHeight?: number;
     bottomHeight?: number;
@@ -61,67 +59,10 @@ declare const _default: import('vue').DefineComponent<{
     userInfo?: UserInfo;
     editPrivilege?: EditPrivilege;
     locale?: Locale;
-}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     emitHandler: (...args: any[]) => void;
-}, string, import('vue').PublicProps, Readonly<{
-    instruction?: InstructionContent | undefined;
-    fileId?: string;
-    fileName?: string;
-    filePath?: string;
-    modelBuffer?: ArrayBuffer;
-    metaBuffer?: ArrayBuffer;
-    modelType?: string;
-    multiModel?: boolean;
-    filePaths?: string[];
-    modelIds?: string[];
-    loadSequential?: boolean;
-    loadInterval?: number;
-    themeColor?: ThemeColor;
-    topHeight?: number;
-    bottomHeight?: number;
-    leftWidth?: number;
-    rightWidth?: number;
-    treePos?: TallPanelPos;
-    inspectorPos?: TallPanelPos;
-    commentPos?: ToolPos;
-    annotationPos?: ToolPos;
-    roamPos?: ToolPos;
-    navCubePos?: NavCubePos;
-    navCubeSize?: number;
-    skyboxImg?: HTMLImageElement;
-    commentOffset?: Offset;
-    measureOffset?: Offset;
-    hideTool?: boolean;
-    phone?: boolean;
-    loadMeta?: boolean;
-    showNavCube?: boolean;
-    outliersDetect?: boolean;
-    backButton?: boolean;
-    backgroundColor?: string;
-    tree?: boolean;
-    reset?: boolean;
-    roam?: boolean;
-    cameraView?: boolean;
-    measure?: boolean;
-    section?: boolean;
-    comment?: boolean;
-    anno?: boolean;
-    screenshot?: boolean;
-    inspector?: boolean;
-    setting?: boolean;
-    fullscreen?: boolean;
-    navigate?: boolean;
-    share?: boolean;
-    cooperate?: boolean;
-    hidden?: boolean;
-    bcf?: boolean;
-    mouse?: boolean;
-    enjoy?: boolean;
-    bcfContent?: BcfContent;
-    userInfo?: UserInfo;
-    editPrivilege?: EditPrivilege;
-    locale?: Locale;
-}> & Readonly<{
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     onEmitHandler?: ((...args: any[]) => any) | undefined;
 }>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;

package/types/store/toolbars.d.ts

@@ -30,7 +30,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -42,7 +42,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
@@ -62,7 +62,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
         img: string;
         imgActive: string;
         isActive: boolean;
-        position?: (0 | 1 | 2) | undefined;
+        position?: 0 | 1 | 2 | undefined;
     }[];
     visibleTools: (state: {
         isPc: boolean;
@@ -76,7 +76,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -88,7 +88,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
@@ -111,7 +111,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -123,7 +123,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
@@ -146,7 +146,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -158,7 +158,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
@@ -181,7 +181,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -193,7 +193,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
@@ -216,7 +216,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -228,7 +228,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
@@ -251,7 +251,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -263,7 +263,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
@@ -286,7 +286,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -298,7 +298,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
@@ -321,7 +321,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -333,7 +333,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
@@ -356,7 +356,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -368,7 +368,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
@@ -391,7 +391,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -403,7 +403,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
@@ -426,7 +426,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -438,7 +438,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
@@ -480,7 +480,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -492,7 +492,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
@@ -512,7 +512,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
         img: string;
         imgActive: string;
         isActive: boolean;
-        position?: (0 | 1 | 2) | undefined;
+        position?: 0 | 1 | 2 | undefined;
     }[];
     visibleTools: (state: {
         isPc: boolean;
@@ -526,7 +526,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -538,7 +538,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
@@ -561,7 +561,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -573,7 +573,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
@@ -596,7 +596,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -608,7 +608,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
@@ -631,7 +631,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -643,7 +643,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
@@ -666,7 +666,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -678,7 +678,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
@@ -701,7 +701,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -713,7 +713,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
@@ -736,7 +736,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -748,7 +748,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
@@ -771,7 +771,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -783,7 +783,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
@@ -806,7 +806,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -818,7 +818,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
@@ -841,7 +841,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -853,7 +853,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
@@ -876,7 +876,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         mTools: {
             id: number;
@@ -888,7 +888,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
             img: string;
             imgActive: string;
             isActive: boolean;
-            position?: (0 | 1 | 2) | undefined;
+            position?: 0 | 1 | 2 | undefined;
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];

package/types/utils/OSSHelper.d.ts

@@ -1,7 +1,5 @@
 export default class OSSHelper {
     static getBuffer(filePath: string, done: Function, error?: Function): Promise<void>;
-    /** 下载单个文件并返回 ArrayBuffer（Promise 风格，便于并发） */
-    static fetchBuffer(filePath: string): Promise<ArrayBuffer>;
     static requestFileFromOSS(filePath: string, isFile: boolean, done: Function, error: Function): Promise<void>;
     static downloadFile(filePath: string): Promise<ArrayBuffer>;
 }

package/types/viewerManager/load/loadModel.d.ts

@@ -1,32 +1,3 @@
-export interface ModelLoadResult {
-    code: 200 | -1;
-    result: string;
-    msg?: string;
-}
-export interface ModelLoadItem {
-    /** 模型 ID；为空时由 filePath 推导 */
-    modelId?: string;
-    /** 下载来源路径（http 完整地址 或 OSS 相对地址），为空表示直接使用 buffer */
-    filePath?: string;
-    /** 已下载好的模型二进制（filePath 为空时必填） */
-    buffer?: ArrayBuffer;
-    /** 已就绪的 meta 二进制（可选） */
-    metaBuffer?: ArrayBuffer;
-    /** 透传引擎 cfg：{ position, scale, rotation, matrix, origin, brightness, ... } */
-    options?: Record<string, any>;
-}
-export interface ModelLoaderConfig {
-    /** 模型类型（xtc / glb / ifc），默认 xtc */
-    modelType?: string;
-    /** 是否加载 meta（.xts）；不传则运行时取 getConfig("loadMeta") */
-    loadMeta?: boolean;
-    /** 事件回调：modelLoaded / metaLoading / metaLoaded */
-    emit?: (event_name: string, content: any) => void;
-    /** 多模型是否顺序加载：true 等待每个模型加载完成再加载下一个；false 各自就绪即加载（默认推荐），默认 true */
-    sequential?: boolean;
-    /** 非顺序加载时的发起间隔毫秒数（仅作节流），默认 0 表示不节流 */
-    loadInterval?: number;
-}
 /**
  * BIMX 模型加载
  * @param modelId 模型 ID
@@ -38,62 +9,3 @@ export interface ModelLoaderConfig {
  *                - position / rotation / scale / origin / alignTo: 多模型坐标对齐参数
  */
 export default function viewerLoadModel(modelId: string, modelType: string, modelArrayBuffer: ArrayBuffer, callback?: Function, options?: Record<string, any>): void;
-/**
- * 模型加载器：统一封装「下载 -> 引擎加载 -> meta 加载」。
- *
- * 相比逐模型串行「下载-加载」，这里会：
- *  - 顺序加载时用流水线预取：下载第 i 个模型的同时加载第 i-1 个，让网络与解析重叠；
- *  - 非顺序加载时所有模型并发下载、就绪即加载；
- *  - 单文件（model + meta）并发下载；
- *  - OSS STS client 在 OSSHelper 内缓存复用，不再每个文件都申请一次凭证。
- */
-export declare class ModelLoader {
-    private modelType;
-    private loadMetaOverride?;
-    private emit;
-    /** 多模型是否顺序加载（默认 true） */
-    private sequential;
-    /** 非顺序加载的发起间隔（毫秒，默认 0 = 不节流） */
-    private loadInterval;
-    private metaBuffer?;
-    private metaReady;
-    private metaEventsBound;
-    private pendingMetaModel?;
-    constructor(config?: ModelLoaderConfig);
-    /** 运行时判断是否加载 meta（跟随 config，避免 setup 阶段 getConfig 尚未就绪） */
-    private getLoadMeta;
-    /** viewer 销毁/重建时重置内部 meta 状态 */
-    reset(): void;
-    /** 外部传入已就绪的 meta buffer（单模型外部 buffer 场景，可能晚于模型到达） */
-    setMetaBuffer(buffer?: ArrayBuffer): void;
-    /** 下载单个文件（http 直连 / OSS），返回 Promise<ArrayBuffer> */
-    private fetch;
-    /** 模型主体下载路径：http 直接用原地址；OSS 补上 .xtc 等类型后缀 */
-    private downloadModelPath;
-    /** 加载单个已就绪 buffer 的模型到引擎，模型成功后自动处理 meta */
-    loadSingle(modelId: string, buffer: ArrayBuffer, metaBuffer?: ArrayBuffer, options?: Record<string, any>): Promise<ModelLoadResult>;
-    /** 引擎模型加载成功后处理 meta：可用则立即加载，否则挂起等 setMetaBuffer */
-    private handleMetaAfterModelLoad;
-    private loadMetadata;
-    /** 绑定引擎 meta 事件（只绑一次），转发给 emit */
-    private bindMetaEvents;
-    /** 按路径加载单个模型：并发下载 model + meta，下载完再引擎加载；下载失败不抛异常 */
-    loadFromPath(modelId: string, filePath: string, options?: Record<string, any>): Promise<ModelLoadResult | undefined>;
-    /** 下载 meta（.xts）；失败不阻断主流程 */
-    private downloadMeta;
-    /** 准备单个模型：并发下载 model + meta，返回可直接加载的数据；下载失败 buffer 为空（不抛异常） */
-    private prepareItem;
-    /**
-     * 多模型加载。
-     *
-     * sequential=true：一个一个来，等当前模型 loaded 后再加载下一个。
-     * sequential=false（对齐 xtctwins 示例用法）：所有模型同时开始下载，
-     *   「谁的 buffer 先到就立即加载谁」，互不等待、默认不插入任何延迟。
-     *   这样下载与解析天然重叠，是引擎下最快的加载方式。
-     *
-     * loadInterval 仅作为可选的发起节流（默认 0 不节流）。
-     */
-    loadMulti(items: ModelLoadItem[]): Promise<ModelLoadResult[]>;
-    /** 延迟指定毫秒数 */
-    private sleep;
-}