gltf-parser-plugin 1.0.9 → 1.1.1

package/build/index.d.ts

@@ -24,6 +24,16 @@ export declare class GLTFParserPlugin implements MeshHelperHost {
     private _loader;
     private readonly _gltfRegex;
     private readonly _options;
+    private _structureData;
+    private _oidNodeMap;
+    private _structurePromise;
+    private _modelInfo;
+    private _modelInfoPromise;
+    private _frozenOids;
+    private _isolatedOids;
+    private _trackedMeshes;
+    private _meshListeners;
+    private _isPluginRemoving;
     oids: number[];
     private renderer;
     private splitMeshCache;
@@ -49,6 +59,34 @@ export declare class GLTFParserPlugin implements MeshHelperHost {
      */
     clearCache(): Promise<void>;
     parseTile(buffer: ArrayBuffer, tile: any, extension: any, uri: string, abortSignal: AbortSignal): Promise<any>;
+    private _getStructureUrl;
+    private _buildOidNodeMap;
+    private _fetchStructureData;
+    private _ensureStructureLoaded;
+    /**
+     * 根据 oid 获取 structure.json 中对应的节点树数据
+     * 包含 bbox、children、name 等完整结构信息
+     * 首次调用时会自动从 tileset URL 推导并请求 structure.json
+     */
+    getNodeTreeByOid(oid: number): Promise<StructureNode | null>;
+    /**
+     * 根据 oid 数组批量获取 structure.json 中对应的节点树数据
+     */
+    getNodeTreeByOids(oids: number[]): Promise<Map<number, StructureNode>>;
+    /**
+     * 获取完整的 structure.json 数据
+     * 首次调用时会自动请求
+     */
+    getStructureData(): Promise<StructureData | null>;
+    private _getModelInfoUrl;
+    private _fetchModelInfo;
+    private _ensureModelInfoLoaded;
+    /**
+     * 获取 modelInfo.json 数据
+     * 包含模型的基本信息：动画支持、材质数量、顶点数、三角形数等
+     * 首次调用时会自动从 tileset URL 推导并请求 modelInfo.json
+     */
+    getModelInfo(): Promise<ModelInfo | null>;
     /**
      * Load model callback
      */
@@ -72,8 +110,46 @@ export declare class GLTFParserPlugin implements MeshHelperHost {
     private _setupMaterial;
     /**
      * Query feature information from intersection
+     * Respects freeze and isolate filters
      */
     queryFeatureFromIntersection(hit: Intersection): FeatureInfo;
+    private _isOidBlocked;
+    private _trackMesh;
+    private _untrackMesh;
+    private _onCollectorMeshChange;
+    private _syncCollectorMeshes;
+    /**
+     * 冻结指定构件，被冻结的构件不再响应任何交互和事件
+     */
+    freezeByOids(oids: number[]): void;
+    /**
+     * 解冻指定构件
+     */
+    unfreezeByOids(oids: number[]): void;
+    /**
+     * 解冻全部构件
+     */
+    unfreeze(): void;
+    /**
+     * 获取当前被冻结的 OID 数组
+     */
+    getFrozenOids(): number[];
+    /**
+     * 隔离指定构件，隔离模式下只有被隔离的构件才能响应交互和事件
+     */
+    isolateByOids(oids: number[]): void;
+    /**
+     * 取消隔离指定构件
+     */
+    unisolateByOids(oids: number[]): void;
+    /**
+     * 取消全部隔离，恢复所有构件的交互能力
+     */
+    unisolate(): void;
+    /**
+     * 获取当前被隔离的 OID 数组
+     */
+    getIsolatedOids(): number[];
     /**
      * 内部方法：根据 oid 获取 mesh 数组
      */
@@ -176,4 +252,37 @@ declare interface MeshHelperHost {
     _getMeshesByOidInternal(oid: number): Mesh[];
 }
 
+/**
+ * modelInfo.json 的数据结构
+ */
+export declare interface ModelInfo {
+    animatable: boolean;
+    images: number;
+    materials: number;
+    pbr: boolean;
+    textures: number;
+    triangles: number;
+    vertices: number;
+}
+
+/**
+ * structure.json 的完整数据结构
+ */
+export declare interface StructureData {
+    defaultTree?: number;
+    idField?: string;
+    trees: StructureNode[];
+}
+
+/**
+ * structure.json 中的树节点结构
+ */
+export declare interface StructureNode {
+    id?: number;
+    name?: string;
+    bbox?: number[];
+    children?: StructureNode[];
+    [key: string]: unknown;
+}
+
 export { }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gltf-parser-plugin",
-  "version": "1.0.9",
+  "version": "1.1.1",
   "description": "A plugin for parsing GLTF files",
   "type": "module",
   "main": "./build/gltf-parser-plugin.module.js",
@@ -28,20 +28,20 @@
   "author": "maptalks",
   "license": "MIT",
   "devDependencies": {
-    "@types/node": "^25.3.3",
+    "@types/node": "^25.4.0",
     "@types/three": "^0.183.1",
-    "@typescript-eslint/eslint-plugin": "^8.56.1",
-    "@typescript-eslint/parser": "^8.56.1",
-    "eslint": "^10.0.2",
+    "@typescript-eslint/eslint-plugin": "^8.57.0",
+    "@typescript-eslint/parser": "^8.57.0",
+    "eslint": "^10.0.3",
     "typescript": "^5.9.3",
     "vite": "^7.3.1",
     "vite-plugin-dts": "^4.5.4",
     "vitest": "^4.0.18"
   },
   "dependencies": {
-    "3d-tiles-renderer": "^0.4.21",
-    "@maptalks/gltf-loader": "^0.124.3",
-    "@maptalks/transcoders.draco": "^0.124.3",
+    "3d-tiles-renderer": "^0.4.22",
+    "@maptalks/gltf-loader": "^0.124.4",
+    "@maptalks/transcoders.draco": "^0.124.4",
     "three": "^0.183.2"
   }
 }