3dviewer-sdk 1.0.14 → 1.0.16

package/dist/index.d.mts

@@ -36,6 +36,8 @@ declare enum ViewerMessageType {
     TREE_SELECT_NODE = "viewer-tree-select-node",
     TREE_GET_NODE_IDS = "viewer-tree-get-node-ids",
     TREE_NODE_IDS = "viewer-tree-node-ids",
+    TREE_GET_NODES = "viewer-tree-get-nodes",
+    TREE_NODES = "viewer-tree-nodes",
     PDF_PLAN_MODE = "viewer-pdf-plan-mode",
     PDF_DOCUMENT_MODE = "viewer-pdf-document-mode",
     PDF_FIRST_PAGE = "viewer-pdf-first-page",
@@ -91,6 +93,19 @@ type StateObjectItem = {
         type: string;
     };
 };
+type TreeNodeItem = {
+    id: string;
+    name: string;
+    type: number;
+    parent?: string;
+    childs?: string[];
+    modelFileId?: string;
+    persistentId?: string;
+    categoryName?: string;
+    familyName?: string;
+    typeName?: string;
+    isRealNode: boolean;
+};
 type PdfModeEventPayload = {
     mode: "plan" | "document";
     timestamp: number;
@@ -127,6 +142,12 @@ type ViewerEventMap = {
         nodeIds: string[];
         timestamp: number;
     };
+    "modelTree:nodes": {
+        requestId: string;
+        nodes: TreeNodeItem[];
+        rootNodeIds?: string[];
+        timestamp: number;
+    };
     "sheets:list": {
         requestId: string;
         sheets: {
@@ -237,8 +258,7 @@ declare class InteractionModule {
         }) => void) => () => void;
     };
     constructor(viewer: Viewer3D);
-    enablePan(): void;
-    disablePan(): void;
+    pan(): void;
     select(): void;
     areaSelect(): void;
     orbit(): void;
@@ -270,6 +290,7 @@ declare class NodeModule {
 
 type FilesConfig = {
     baseUrl?: string;
+    conversionUrl?: string;
     viewerPath?: string;
     uploadPath?: string;
 };
@@ -358,7 +379,7 @@ declare class FilesModule {
     render(file?: File, options?: ConvertOptions): Promise<PreparedViewerData>;
     private resolveFile;
     private normalizeBaseUrl;
-    private resolveBaseUrl;
+    private resolveConversionUrl;
     private resolveViewerPath;
     private normalizeSdkViewerPath;
     private resolveViewerOrigin;
@@ -475,16 +496,30 @@ declare class ToolbarModule {
     private postStatesObjectsGetList;
 }
 
-type GetNodeIdsOptions = {
+type ModelTreeRequestOptions = {
     onlyRealNodes?: boolean;
     timeoutMs?: number;
 };
+type GetNodeIdsOptions = ModelTreeRequestOptions;
+type GetNodesOptions = ModelTreeRequestOptions;
+type ModelTreeNode = TreeNodeItem;
+type ModelTreeHierarchyNode = ModelTreeNode & {
+    children: ModelTreeHierarchyNode[];
+};
 declare class ModelTreeModule {
     private viewer;
     constructor(viewer: Viewer3D);
     open(): void;
     selectNode(nodeId: string | number): void;
     getNodeIds(options?: GetNodeIdsOptions): Promise<string[]>;
+    getNodes(options?: GetNodesOptions): Promise<ModelTreeNode[]>;
+    getTree(options?: GetNodesOptions): Promise<ModelTreeHierarchyNode[]>;
+    private requestNodes;
+    private resolveTimeoutMs;
+    private postPanelOpen;
+    private postTreeSelectNode;
+    private postTreeGetNodeIds;
+    private postTreeGetNodes;
 }
 
 type MarkupRequestOptions = {
@@ -524,6 +559,7 @@ type Viewer3DOptions = {
     container: HTMLElement | string;
     url?: string;
     baseUrl?: string;
+    conversionUrl?: string;
     viewerPath?: string;
     uploadPath?: string;
     file?: File;

package/dist/index.d.ts

@@ -36,6 +36,8 @@ declare enum ViewerMessageType {
     TREE_SELECT_NODE = "viewer-tree-select-node",
     TREE_GET_NODE_IDS = "viewer-tree-get-node-ids",
     TREE_NODE_IDS = "viewer-tree-node-ids",
+    TREE_GET_NODES = "viewer-tree-get-nodes",
+    TREE_NODES = "viewer-tree-nodes",
     PDF_PLAN_MODE = "viewer-pdf-plan-mode",
     PDF_DOCUMENT_MODE = "viewer-pdf-document-mode",
     PDF_FIRST_PAGE = "viewer-pdf-first-page",
@@ -91,6 +93,19 @@ type StateObjectItem = {
         type: string;
     };
 };
+type TreeNodeItem = {
+    id: string;
+    name: string;
+    type: number;
+    parent?: string;
+    childs?: string[];
+    modelFileId?: string;
+    persistentId?: string;
+    categoryName?: string;
+    familyName?: string;
+    typeName?: string;
+    isRealNode: boolean;
+};
 type PdfModeEventPayload = {
     mode: "plan" | "document";
     timestamp: number;
@@ -127,6 +142,12 @@ type ViewerEventMap = {
         nodeIds: string[];
         timestamp: number;
     };
+    "modelTree:nodes": {
+        requestId: string;
+        nodes: TreeNodeItem[];
+        rootNodeIds?: string[];
+        timestamp: number;
+    };
     "sheets:list": {
         requestId: string;
         sheets: {
@@ -237,8 +258,7 @@ declare class InteractionModule {
         }) => void) => () => void;
     };
     constructor(viewer: Viewer3D);
-    enablePan(): void;
-    disablePan(): void;
+    pan(): void;
     select(): void;
     areaSelect(): void;
     orbit(): void;
@@ -270,6 +290,7 @@ declare class NodeModule {
 
 type FilesConfig = {
     baseUrl?: string;
+    conversionUrl?: string;
     viewerPath?: string;
     uploadPath?: string;
 };
@@ -358,7 +379,7 @@ declare class FilesModule {
     render(file?: File, options?: ConvertOptions): Promise<PreparedViewerData>;
     private resolveFile;
     private normalizeBaseUrl;
-    private resolveBaseUrl;
+    private resolveConversionUrl;
     private resolveViewerPath;
     private normalizeSdkViewerPath;
     private resolveViewerOrigin;
@@ -475,16 +496,30 @@ declare class ToolbarModule {
     private postStatesObjectsGetList;
 }
 
-type GetNodeIdsOptions = {
+type ModelTreeRequestOptions = {
     onlyRealNodes?: boolean;
     timeoutMs?: number;
 };
+type GetNodeIdsOptions = ModelTreeRequestOptions;
+type GetNodesOptions = ModelTreeRequestOptions;
+type ModelTreeNode = TreeNodeItem;
+type ModelTreeHierarchyNode = ModelTreeNode & {
+    children: ModelTreeHierarchyNode[];
+};
 declare class ModelTreeModule {
     private viewer;
     constructor(viewer: Viewer3D);
     open(): void;
     selectNode(nodeId: string | number): void;
     getNodeIds(options?: GetNodeIdsOptions): Promise<string[]>;
+    getNodes(options?: GetNodesOptions): Promise<ModelTreeNode[]>;
+    getTree(options?: GetNodesOptions): Promise<ModelTreeHierarchyNode[]>;
+    private requestNodes;
+    private resolveTimeoutMs;
+    private postPanelOpen;
+    private postTreeSelectNode;
+    private postTreeGetNodeIds;
+    private postTreeGetNodes;
 }
 
 type MarkupRequestOptions = {
@@ -524,6 +559,7 @@ type Viewer3DOptions = {
     container: HTMLElement | string;
     url?: string;
     baseUrl?: string;
+    conversionUrl?: string;
     viewerPath?: string;
     uploadPath?: string;
     file?: File;

package/dist/index.js

@@ -80,11 +80,8 @@ var InteractionModule = class {
       panChange: (cb) => this.viewer._on("interaction:pan-change", cb)
     };
   }
-  enablePan() {
-    this.viewer.postToViewer("viewer-pan-toggle" /* PAN_TOGGLE */, { enabled: true });
-  }
-  disablePan() {
-    this.viewer.postToViewer("viewer-pan-toggle" /* PAN_TOGGLE */, { enabled: false });
+  pan() {
+    this.viewer.postToViewer("viewer-pan-toggle" /* PAN_TOGGLE */);
   }
   select() {
     this.viewer.postToViewer("viewer-select" /* SELECT */);
@@ -145,8 +142,8 @@ var NodeModule = class {
 };
 
 // src/modules/files.module.ts
-var DEFAULT_API_BASE_URL = "https://dev.3dviewer.anybim.vn/service/conversion";
-var DEFAULT_VIEWER_ORIGIN = "http://localhost:3000";
+var DEFAULT_CONVERSION_URL = "https://dev.3dviewer.anybim.vn/service/conversion";
+var DEFAULT_VIEWER_BASE_URL = "https://dev.3dviewer.anybim.vn";
 var SDK_VIEWER_PATH = "/mainviewer-sdk";
 var LEGACY_VIEWER_PATH = "/mainviewer";
 var FilesModule = class {
@@ -293,9 +290,9 @@ var FilesModule = class {
   normalizeBaseUrl(input) {
     return input.trim().replace(/\/+$/, "");
   }
-  // Resolve API base URL with default fallback.
-  resolveBaseUrl() {
-    const raw = this.config.baseUrl || this.viewer.getOptions().baseUrl || DEFAULT_API_BASE_URL;
+  // Resolve conversion API URL with default fallback.
+  resolveConversionUrl() {
+    const raw = this.config.conversionUrl || this.viewer.getOptions().conversionUrl || DEFAULT_CONVERSION_URL;
     return this.normalizeBaseUrl(raw);
   }
   // Resolve viewer route path for all SDK flows.
@@ -321,26 +318,26 @@ var FilesModule = class {
   }
   // Viewer host used to open iframe after conversion completes.
   resolveViewerOrigin() {
-    const viewerUrl = this.viewer.getOptions().url;
-    if (viewerUrl) {
+    const configuredViewerBaseUrl = this.config.baseUrl || this.viewer.getOptions().baseUrl;
+    if (configuredViewerBaseUrl) {
       try {
-        return this.normalizeBaseUrl(new URL(viewerUrl, window.location.href).origin);
+        return this.normalizeBaseUrl(new URL(configuredViewerBaseUrl, window.location.href).origin);
       } catch {
       }
     }
-    const configuredBaseUrl = this.config.baseUrl || this.viewer.getOptions().baseUrl;
-    if (configuredBaseUrl) {
+    const viewerUrl = this.viewer.getOptions().url;
+    if (viewerUrl) {
       try {
-        return this.normalizeBaseUrl(new URL(configuredBaseUrl, window.location.href).origin);
+        return this.normalizeBaseUrl(new URL(viewerUrl, window.location.href).origin);
       } catch {
       }
     }
-    return this.normalizeBaseUrl(DEFAULT_VIEWER_ORIGIN);
+    return this.normalizeBaseUrl(DEFAULT_VIEWER_BASE_URL);
   }
-  // Resolve conversion service root from configured API base URL.
+  // Resolve conversion service root from configured conversion URL.
   // Do not auto-append path segments (e.g. "/service/conversion").
   resolveHostConversion() {
-    return this.resolveBaseUrl();
+    return this.resolveConversionUrl();
   }
   // Resolve upload path sent to conversion APIs.
   getUploadPath() {
@@ -891,28 +888,56 @@ var ToolbarModule = class {
 };
 
 // src/modules/model-tree.module.ts
-function createRequestId2() {
-  return `tree_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;
+function createRequestId2(prefix) {
+  return `${prefix}_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;
+}
+function buildTree(nodes, rootNodeIds) {
+  const uniqueNodes = Array.from(
+    nodes.reduce((map, node) => {
+      map.set(node.id, node);
+      return map;
+    }, /* @__PURE__ */ new Map()),
+    ([, node]) => node
+  );
+  const hierarchyMap = new Map(
+    uniqueNodes.map((node) => [node.id, { ...node, children: [] }])
+  );
+  const childrenByParent = /* @__PURE__ */ new Map();
+  uniqueNodes.forEach((node) => {
+    var _a;
+    if (!node.parent) return;
+    const current = (_a = childrenByParent.get(node.parent)) != null ? _a : [];
+    current.push(node.id);
+    childrenByParent.set(node.parent, current);
+  });
+  hierarchyMap.forEach((node) => {
+    var _a, _b;
+    const childIdsFromNode = ((_a = node.childs) != null ? _a : []).filter((childId) => hierarchyMap.has(childId));
+    const fallbackChildIds = (_b = childrenByParent.get(node.id)) != null ? _b : [];
+    const childIds = childIdsFromNode.length > 0 ? childIdsFromNode : fallbackChildIds;
+    node.children = Array.from(new Set(childIds)).map((childId) => hierarchyMap.get(childId)).filter((child) => Boolean(child));
+  });
+  const rootIds = Array.isArray(rootNodeIds) && rootNodeIds.length > 0 ? rootNodeIds.filter((id) => hierarchyMap.has(id)) : uniqueNodes.filter((node) => !node.parent || !hierarchyMap.has(node.parent)).map((node) => node.id);
+  return Array.from(new Set(rootIds)).map((id) => hierarchyMap.get(id)).filter((node) => Boolean(node));
 }
 var ModelTreeModule = class {
   constructor(viewer) {
     this.viewer = viewer;
   }
   open() {
-    this.viewer.postToViewer("viewer-panel-open" /* PANEL_OPEN */, {
+    this.postPanelOpen({
       panel: "model-tree",
       format: "3d"
     });
   }
   selectNode(nodeId) {
-    this.viewer.postToViewer("viewer-tree-select-node" /* TREE_SELECT_NODE */, {
+    this.postTreeSelectNode({
       nodeId: String(nodeId)
     });
   }
   getNodeIds(options) {
-    var _a;
-    const requestId = createRequestId2();
-    const timeoutMs = Math.max(1e3, (_a = options == null ? void 0 : options.timeoutMs) != null ? _a : 1e4);
+    const requestId = createRequestId2("tree");
+    const timeoutMs = this.resolveTimeoutMs(options);
     return new Promise((resolve, reject) => {
       const timer = setTimeout(() => {
         off();
@@ -924,12 +949,58 @@ var ModelTreeModule = class {
         off();
         resolve(payload.nodeIds);
       });
-      this.viewer.postToViewer("viewer-tree-get-node-ids" /* TREE_GET_NODE_IDS */, {
+      this.postTreeGetNodeIds({
         requestId,
         onlyRealNodes: (options == null ? void 0 : options.onlyRealNodes) !== false
       });
     });
   }
+  getNodes(options) {
+    return this.requestNodes(options).then((response) => response.nodes);
+  }
+  getTree(options) {
+    return this.requestNodes(options).then((response) => buildTree(response.nodes, response.rootNodeIds));
+  }
+  requestNodes(options) {
+    const requestId = createRequestId2("tree_nodes");
+    const timeoutMs = this.resolveTimeoutMs(options);
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        off();
+        reject(new Error("Timeout while getting model tree nodes from viewer"));
+      }, timeoutMs);
+      const off = this.viewer._on("modelTree:nodes", (payload) => {
+        if (payload.requestId !== requestId) return;
+        clearTimeout(timer);
+        off();
+        resolve({
+          nodes: payload.nodes,
+          rootNodeIds: payload.rootNodeIds
+        });
+      });
+      this.postTreeGetNodes({
+        requestId,
+        // For backward compatibility, default includes helper/system nodes unless caller opts in.
+        onlyRealNodes: (options == null ? void 0 : options.onlyRealNodes) === true
+      });
+    });
+  }
+  resolveTimeoutMs(options) {
+    var _a;
+    return Math.max(1e3, (_a = options == null ? void 0 : options.timeoutMs) != null ? _a : 1e4);
+  }
+  postPanelOpen(payload) {
+    this.viewer.postToViewer("viewer-panel-open" /* PANEL_OPEN */, payload);
+  }
+  postTreeSelectNode(payload) {
+    this.viewer.postToViewer("viewer-tree-select-node" /* TREE_SELECT_NODE */, payload);
+  }
+  postTreeGetNodeIds(payload) {
+    this.viewer.postToViewer("viewer-tree-get-node-ids" /* TREE_GET_NODE_IDS */, payload);
+  }
+  postTreeGetNodes(payload) {
+    this.viewer.postToViewer("viewer-tree-get-nodes" /* TREE_GET_NODES */, payload);
+  }
 };
 
 // src/modules/markup.module.ts
@@ -1131,6 +1202,32 @@ var Viewer3D = class {
           });
           break;
         }
+        case "viewer-tree-nodes" /* TREE_NODES */: {
+          const payload = data.payload;
+          if (!payload || !payload.requestId || !Array.isArray(payload.nodes)) break;
+          this._emit("modelTree:nodes", {
+            requestId: String(payload.requestId),
+            nodes: payload.nodes.filter((node) => node && typeof node === "object").map((node) => {
+              var _a2, _b2;
+              return {
+                id: String((_a2 = node.id) != null ? _a2 : ""),
+                name: String((_b2 = node.name) != null ? _b2 : ""),
+                type: Number(node.type) || 0,
+                parent: node.parent ? String(node.parent) : void 0,
+                childs: Array.isArray(node.childs) ? node.childs.map(String) : [],
+                modelFileId: node.modelFileId ? String(node.modelFileId) : void 0,
+                persistentId: node.persistentId ? String(node.persistentId) : void 0,
+                categoryName: node.categoryName ? String(node.categoryName) : void 0,
+                familyName: node.familyName ? String(node.familyName) : void 0,
+                typeName: node.typeName ? String(node.typeName) : void 0,
+                isRealNode: Boolean(node.isRealNode)
+              };
+            }),
+            rootNodeIds: Array.isArray(payload.rootNodeIds) ? payload.rootNodeIds.map(String) : void 0,
+            timestamp: Number(payload.timestamp) || Date.now()
+          });
+          break;
+        }
         case "viewer-sheets-list" /* SHEETS_LIST */: {
           const payload = data.payload;
           if (!payload || !payload.requestId || !Array.isArray(payload.sheets)) break;

package/dist/index.mjs

@@ -54,11 +54,8 @@ var InteractionModule = class {
       panChange: (cb) => this.viewer._on("interaction:pan-change", cb)
     };
   }
-  enablePan() {
-    this.viewer.postToViewer("viewer-pan-toggle" /* PAN_TOGGLE */, { enabled: true });
-  }
-  disablePan() {
-    this.viewer.postToViewer("viewer-pan-toggle" /* PAN_TOGGLE */, { enabled: false });
+  pan() {
+    this.viewer.postToViewer("viewer-pan-toggle" /* PAN_TOGGLE */);
   }
   select() {
     this.viewer.postToViewer("viewer-select" /* SELECT */);
@@ -119,8 +116,8 @@ var NodeModule = class {
 };
 
 // src/modules/files.module.ts
-var DEFAULT_API_BASE_URL = "https://dev.3dviewer.anybim.vn/service/conversion";
-var DEFAULT_VIEWER_ORIGIN = "http://localhost:3000";
+var DEFAULT_CONVERSION_URL = "https://dev.3dviewer.anybim.vn/service/conversion";
+var DEFAULT_VIEWER_BASE_URL = "https://dev.3dviewer.anybim.vn";
 var SDK_VIEWER_PATH = "/mainviewer-sdk";
 var LEGACY_VIEWER_PATH = "/mainviewer";
 var FilesModule = class {
@@ -267,9 +264,9 @@ var FilesModule = class {
   normalizeBaseUrl(input) {
     return input.trim().replace(/\/+$/, "");
   }
-  // Resolve API base URL with default fallback.
-  resolveBaseUrl() {
-    const raw = this.config.baseUrl || this.viewer.getOptions().baseUrl || DEFAULT_API_BASE_URL;
+  // Resolve conversion API URL with default fallback.
+  resolveConversionUrl() {
+    const raw = this.config.conversionUrl || this.viewer.getOptions().conversionUrl || DEFAULT_CONVERSION_URL;
     return this.normalizeBaseUrl(raw);
   }
   // Resolve viewer route path for all SDK flows.
@@ -295,26 +292,26 @@ var FilesModule = class {
   }
   // Viewer host used to open iframe after conversion completes.
   resolveViewerOrigin() {
-    const viewerUrl = this.viewer.getOptions().url;
-    if (viewerUrl) {
+    const configuredViewerBaseUrl = this.config.baseUrl || this.viewer.getOptions().baseUrl;
+    if (configuredViewerBaseUrl) {
       try {
-        return this.normalizeBaseUrl(new URL(viewerUrl, window.location.href).origin);
+        return this.normalizeBaseUrl(new URL(configuredViewerBaseUrl, window.location.href).origin);
       } catch {
       }
     }
-    const configuredBaseUrl = this.config.baseUrl || this.viewer.getOptions().baseUrl;
-    if (configuredBaseUrl) {
+    const viewerUrl = this.viewer.getOptions().url;
+    if (viewerUrl) {
       try {
-        return this.normalizeBaseUrl(new URL(configuredBaseUrl, window.location.href).origin);
+        return this.normalizeBaseUrl(new URL(viewerUrl, window.location.href).origin);
       } catch {
       }
     }
-    return this.normalizeBaseUrl(DEFAULT_VIEWER_ORIGIN);
+    return this.normalizeBaseUrl(DEFAULT_VIEWER_BASE_URL);
   }
-  // Resolve conversion service root from configured API base URL.
+  // Resolve conversion service root from configured conversion URL.
   // Do not auto-append path segments (e.g. "/service/conversion").
   resolveHostConversion() {
-    return this.resolveBaseUrl();
+    return this.resolveConversionUrl();
   }
   // Resolve upload path sent to conversion APIs.
   getUploadPath() {
@@ -865,28 +862,56 @@ var ToolbarModule = class {
 };
 
 // src/modules/model-tree.module.ts
-function createRequestId2() {
-  return `tree_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;
+function createRequestId2(prefix) {
+  return `${prefix}_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;
+}
+function buildTree(nodes, rootNodeIds) {
+  const uniqueNodes = Array.from(
+    nodes.reduce((map, node) => {
+      map.set(node.id, node);
+      return map;
+    }, /* @__PURE__ */ new Map()),
+    ([, node]) => node
+  );
+  const hierarchyMap = new Map(
+    uniqueNodes.map((node) => [node.id, { ...node, children: [] }])
+  );
+  const childrenByParent = /* @__PURE__ */ new Map();
+  uniqueNodes.forEach((node) => {
+    var _a;
+    if (!node.parent) return;
+    const current = (_a = childrenByParent.get(node.parent)) != null ? _a : [];
+    current.push(node.id);
+    childrenByParent.set(node.parent, current);
+  });
+  hierarchyMap.forEach((node) => {
+    var _a, _b;
+    const childIdsFromNode = ((_a = node.childs) != null ? _a : []).filter((childId) => hierarchyMap.has(childId));
+    const fallbackChildIds = (_b = childrenByParent.get(node.id)) != null ? _b : [];
+    const childIds = childIdsFromNode.length > 0 ? childIdsFromNode : fallbackChildIds;
+    node.children = Array.from(new Set(childIds)).map((childId) => hierarchyMap.get(childId)).filter((child) => Boolean(child));
+  });
+  const rootIds = Array.isArray(rootNodeIds) && rootNodeIds.length > 0 ? rootNodeIds.filter((id) => hierarchyMap.has(id)) : uniqueNodes.filter((node) => !node.parent || !hierarchyMap.has(node.parent)).map((node) => node.id);
+  return Array.from(new Set(rootIds)).map((id) => hierarchyMap.get(id)).filter((node) => Boolean(node));
 }
 var ModelTreeModule = class {
   constructor(viewer) {
     this.viewer = viewer;
   }
   open() {
-    this.viewer.postToViewer("viewer-panel-open" /* PANEL_OPEN */, {
+    this.postPanelOpen({
       panel: "model-tree",
       format: "3d"
     });
   }
   selectNode(nodeId) {
-    this.viewer.postToViewer("viewer-tree-select-node" /* TREE_SELECT_NODE */, {
+    this.postTreeSelectNode({
       nodeId: String(nodeId)
     });
   }
   getNodeIds(options) {
-    var _a;
-    const requestId = createRequestId2();
-    const timeoutMs = Math.max(1e3, (_a = options == null ? void 0 : options.timeoutMs) != null ? _a : 1e4);
+    const requestId = createRequestId2("tree");
+    const timeoutMs = this.resolveTimeoutMs(options);
     return new Promise((resolve, reject) => {
       const timer = setTimeout(() => {
         off();
@@ -898,12 +923,58 @@ var ModelTreeModule = class {
         off();
         resolve(payload.nodeIds);
       });
-      this.viewer.postToViewer("viewer-tree-get-node-ids" /* TREE_GET_NODE_IDS */, {
+      this.postTreeGetNodeIds({
         requestId,
         onlyRealNodes: (options == null ? void 0 : options.onlyRealNodes) !== false
       });
     });
   }
+  getNodes(options) {
+    return this.requestNodes(options).then((response) => response.nodes);
+  }
+  getTree(options) {
+    return this.requestNodes(options).then((response) => buildTree(response.nodes, response.rootNodeIds));
+  }
+  requestNodes(options) {
+    const requestId = createRequestId2("tree_nodes");
+    const timeoutMs = this.resolveTimeoutMs(options);
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        off();
+        reject(new Error("Timeout while getting model tree nodes from viewer"));
+      }, timeoutMs);
+      const off = this.viewer._on("modelTree:nodes", (payload) => {
+        if (payload.requestId !== requestId) return;
+        clearTimeout(timer);
+        off();
+        resolve({
+          nodes: payload.nodes,
+          rootNodeIds: payload.rootNodeIds
+        });
+      });
+      this.postTreeGetNodes({
+        requestId,
+        // For backward compatibility, default includes helper/system nodes unless caller opts in.
+        onlyRealNodes: (options == null ? void 0 : options.onlyRealNodes) === true
+      });
+    });
+  }
+  resolveTimeoutMs(options) {
+    var _a;
+    return Math.max(1e3, (_a = options == null ? void 0 : options.timeoutMs) != null ? _a : 1e4);
+  }
+  postPanelOpen(payload) {
+    this.viewer.postToViewer("viewer-panel-open" /* PANEL_OPEN */, payload);
+  }
+  postTreeSelectNode(payload) {
+    this.viewer.postToViewer("viewer-tree-select-node" /* TREE_SELECT_NODE */, payload);
+  }
+  postTreeGetNodeIds(payload) {
+    this.viewer.postToViewer("viewer-tree-get-node-ids" /* TREE_GET_NODE_IDS */, payload);
+  }
+  postTreeGetNodes(payload) {
+    this.viewer.postToViewer("viewer-tree-get-nodes" /* TREE_GET_NODES */, payload);
+  }
 };
 
 // src/modules/markup.module.ts
@@ -1105,6 +1176,32 @@ var Viewer3D = class {
           });
           break;
         }
+        case "viewer-tree-nodes" /* TREE_NODES */: {
+          const payload = data.payload;
+          if (!payload || !payload.requestId || !Array.isArray(payload.nodes)) break;
+          this._emit("modelTree:nodes", {
+            requestId: String(payload.requestId),
+            nodes: payload.nodes.filter((node) => node && typeof node === "object").map((node) => {
+              var _a2, _b2;
+              return {
+                id: String((_a2 = node.id) != null ? _a2 : ""),
+                name: String((_b2 = node.name) != null ? _b2 : ""),
+                type: Number(node.type) || 0,
+                parent: node.parent ? String(node.parent) : void 0,
+                childs: Array.isArray(node.childs) ? node.childs.map(String) : [],
+                modelFileId: node.modelFileId ? String(node.modelFileId) : void 0,
+                persistentId: node.persistentId ? String(node.persistentId) : void 0,
+                categoryName: node.categoryName ? String(node.categoryName) : void 0,
+                familyName: node.familyName ? String(node.familyName) : void 0,
+                typeName: node.typeName ? String(node.typeName) : void 0,
+                isRealNode: Boolean(node.isRealNode)
+              };
+            }),
+            rootNodeIds: Array.isArray(payload.rootNodeIds) ? payload.rootNodeIds.map(String) : void 0,
+            timestamp: Number(payload.timestamp) || Date.now()
+          });
+          break;
+        }
         case "viewer-sheets-list" /* SHEETS_LIST */: {
           const payload = data.payload;
           if (!payload || !payload.requestId || !Array.isArray(payload.sheets)) break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "3dviewer-sdk",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [