3dviewer-sdk 1.0.28 → 1.1.1

package/dist/index.js

@@ -165,7 +165,7 @@ var NodeModule = class {
   constructor(viewer) {
     this.viewer = viewer;
     this.on = {
-      select: (cb) => this.viewer._on("node:select", cb),
+      // SDK no longer supports first-node-only select events; listen to selectionChange for the full node list.
       selectionChange: (cb) => this.viewer._on("node:selection-change", cb)
     };
   }
@@ -212,52 +212,75 @@ var FilesModule = class {
   // Upload file to conversion server and keep generated baseFileId in session.
   async upload(file) {
     const target = this.resolveFile(file);
-    return this.withOperation({ stage: "uploading", message: "Uploading file..." }, async () => {
-      var _a;
-      this.viewer._emit("files:upload:start", { fileName: target.name });
-      await this.uploadInternal(target);
-      const baseFileId = ((_a = this.getUploadSessionForFile(target)) == null ? void 0 : _a.baseFileId) || "";
-      this.viewer._emit("files:upload:success", { fileName: target.name, baseFileId });
-      return { fileName: target.name, baseFileId };
-    });
+    return this.withOperation(
+      { stage: "uploading", message: "Uploading file..." },
+      async () => {
+        var _a;
+        this.viewer._emit("files:upload:start", { fileName: target.name });
+        await this.uploadInternal(target);
+        const baseFileId = ((_a = this.getUploadSessionForFile(target)) == null ? void 0 : _a.baseFileId) || "";
+        this.viewer._emit("files:upload:success", {
+          fileName: target.name,
+          baseFileId
+        });
+        return { fileName: target.name, baseFileId };
+      }
+    );
   }
   // Trigger conversion flow and resolve final viewer metadata.
   async convert(file, options = {}) {
     const target = this.resolveFile(file);
-    return this.withOperation({ stage: "converting", message: "Converting file..." }, async () => {
-      this.viewer._emit("files:conversion:start", { fileName: target.name });
-      try {
-        const prepared = await this.convertInternal(target, options);
-        this.viewer._emit("files:conversion:success", prepared);
-        return prepared;
-      } catch (e) {
-        this.viewer._emit("files:conversion:error", { fileName: target.name, error: this.toErrorMessage(e) });
-        throw e;
+    return this.withOperation(
+      { stage: "converting", message: "Converting file..." },
+      async () => {
+        this.viewer._emit("files:conversion:start", { fileName: target.name });
+        try {
+          const prepared = await this.convertInternal(target, options);
+          this.viewer._emit("files:conversion:success", prepared);
+          return prepared;
+        } catch (e) {
+          this.viewer._emit("files:conversion:error", {
+            fileName: target.name,
+            error: this.toErrorMessage(e)
+          });
+          throw e;
+        }
       }
-    });
+    );
   }
   // Convenience API: upload first, then convert in one call.
   async prepare(file, options = {}) {
     const target = this.resolveFile(file);
-    return this.withOperation({ stage: "uploading", message: "Preparing file..." }, async () => {
-      await this.uploadInternal(target);
-      const prepared = await this.convertInternal(target, options);
-      return prepared;
-    });
+    return this.withOperation(
+      { stage: "uploading", message: "Preparing file..." },
+      async () => {
+        await this.uploadInternal(target);
+        const prepared = await this.convertInternal(target, options);
+        return prepared;
+      }
+    );
   }
   // Trigger the newer downloadUrl-based conversion flow.
   async convertV2(options) {
-    return this.withOperation({ stage: "converting", message: "Converting file..." }, async () => {
-      this.viewer._emit("files:conversion:start", { fileName: options.filename });
-      try {
-        const prepared = await this.convertV2Internal(options);
-        this.viewer._emit("files:conversion:success", prepared);
-        return prepared;
-      } catch (e) {
-        this.viewer._emit("files:conversion:error", { fileName: options.filename, error: this.toErrorMessage(e) });
-        throw e;
+    return this.withOperation(
+      { stage: "converting", message: "Converting file..." },
+      async () => {
+        this.viewer._emit("files:conversion:start", {
+          fileName: options.filename
+        });
+        try {
+          const prepared = await this.convertV2Internal(options);
+          this.viewer._emit("files:conversion:success", prepared);
+          return prepared;
+        } catch (e) {
+          this.viewer._emit("files:conversion:error", {
+            fileName: options.filename,
+            error: this.toErrorMessage(e)
+          });
+          throw e;
+        }
       }
-    });
+    );
   }
   // Check stream file info by one or more baseFileId values.
   async checkFileInfo(baseFileIds) {
@@ -273,7 +296,9 @@ var FilesModule = class {
       body: JSON.stringify(payload)
     });
     if (!response.ok) {
-      throw new Error(`Check file info failed (${response.status} ${response.statusText})`);
+      throw new Error(
+        `Check file info failed (${response.status} ${response.statusText})`
+      );
     }
     const text = await response.text();
     if (!text) return null;
@@ -291,27 +316,34 @@ var FilesModule = class {
       this.viewer.open(url);
       this.viewer._emit("files:render:success", { url });
     } catch (e) {
-      this.viewer._emit("files:render:error", { url, error: this.toErrorMessage(e) });
+      this.viewer._emit("files:render:error", {
+        url,
+        error: this.toErrorMessage(e)
+      });
       throw e;
     }
   }
   // Full pipeline: upload + convert + open iframe.
   async render(file, options = {}) {
     const target = this.resolveFile(file);
-    return this.withOperation({ stage: "uploading", message: "Uploading + converting + opening..." }, async () => {
-      await this.upload(target);
-      const prepared = await this.convert(target, options);
-      this.updateState({ stage: "rendering", message: "Opening viewer..." });
-      this.open(prepared);
-      this.viewer._emit("files:load:success", prepared);
-      return prepared;
-    });
+    return this.withOperation(
+      { stage: "uploading", message: "Uploading + converting + opening..." },
+      async () => {
+        await this.upload(target);
+        const prepared = await this.convert(target, options);
+        this.updateState({ stage: "rendering", message: "Opening viewer..." });
+        this.open(prepared);
+        this.viewer._emit("files:load:success", prepared);
+        return prepared;
+      }
+    );
   }
   // Resolve file argument, fallback to options.file, and persist it back.
   resolveFile(file) {
     const optFile = this.viewer.getOptions().file;
     const target = file || optFile;
-    if (!target) throw new Error("No file provided. Pass a File or set options.file");
+    if (!target)
+      throw new Error("No file provided. Pass a File or set options.file");
     this.viewer.patchOptions({ file: target });
     return target;
   }
@@ -332,7 +364,8 @@ var FilesModule = class {
       if (viewerUrl) {
         try {
           const pathname = new URL(viewerUrl, window.location.href).pathname;
-          if (pathname && pathname !== "/") return this.normalizeViewerPath(pathname);
+          if (pathname && pathname !== "/")
+            return this.normalizeViewerPath(pathname);
         } catch {
         }
       }
@@ -349,14 +382,18 @@ var FilesModule = class {
     const configuredViewerBaseUrl = this.config.baseUrl || this.viewer.getOptions().baseUrl;
     if (configuredViewerBaseUrl) {
       try {
-        return this.normalizeBaseUrl(new URL(configuredViewerBaseUrl, window.location.href).origin);
+        return this.normalizeBaseUrl(
+          new URL(configuredViewerBaseUrl, window.location.href).origin
+        );
       } catch {
       }
     }
     const viewerUrl = this.viewer.getOptions().url;
     if (viewerUrl) {
       try {
-        return this.normalizeBaseUrl(new URL(viewerUrl, window.location.href).origin);
+        return this.normalizeBaseUrl(
+          new URL(viewerUrl, window.location.href).origin
+        );
       } catch {
       }
     }
@@ -377,7 +414,8 @@ var FilesModule = class {
   }
   // Create a UUID-like baseFileId when caller does not provide one.
   createBaseFileId() {
-    if (typeof crypto !== "undefined" && "randomUUID" in crypto) return crypto.randomUUID();
+    if (typeof crypto !== "undefined" && "randomUUID" in crypto)
+      return crypto.randomUUID();
     return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
       const r = Math.floor(Math.random() * 16);
       const v = c === "x" ? r : r & 3 | 8;
@@ -408,15 +446,25 @@ var FilesModule = class {
       const session = existing || this.createUploadSession(file);
       const hostConversion = this.resolveHostConversion();
       const path = this.getUploadPath();
-      const url = `${hostConversion}/api/File/upload?path=${encodeURIComponent(path)}`;
+      const url = `${hostConversion}/api/File/upload?path=${encodeURIComponent(
+        path
+      )}`;
       const formData = new FormData();
       formData.append("file", file, file.name);
-      const res = await fetch(url, { method: "POST", body: formData, headers: { Accept: "text/plain" } });
-      if (!res.ok) throw new Error(`Upload failed (${res.status} ${res.statusText})`);
+      const res = await fetch(url, {
+        method: "POST",
+        body: formData,
+        headers: { Accept: "text/plain" }
+      });
+      if (!res.ok)
+        throw new Error(`Upload failed (${res.status} ${res.statusText})`);
       this.lastUploadSession = session;
     } catch (e) {
       const msg = this.toErrorMessage(e);
-      this.viewer._emit("files:upload:error", { fileName: file.name, error: msg });
+      this.viewer._emit("files:upload:error", {
+        fileName: file.name,
+        error: msg
+      });
       throw e;
     }
   }
@@ -570,11 +618,20 @@ var FilesModule = class {
     const baseMajorRev = (_b = cacheResult.baseMajorRev) != null ? _b : 0;
     const baseMinorRev = (_c = cacheResult.baseMinorRev) != null ? _c : 0;
     const fileName = cacheResult.filename || cacheResult.fileName || file.name;
-    const cacheListItem = { baseFileId, baseMajorRev, baseMinorRev, fileName };
+    const cacheListItem = {
+      baseFileId,
+      baseMajorRev,
+      baseMinorRev,
+      fileName
+    };
     if (cacheResult.cacheStatus !== 2) {
-      throw new Error(`Conversion not ready after first request (cacheStatus=${(_d = cacheResult.cacheStatus) != null ? _d : "unknown"})`);
+      throw new Error(
+        `Conversion not ready after first request (cacheStatus=${(_d = cacheResult.cacheStatus) != null ? _d : "unknown"})`
+      );
     }
-    const query = new URLSearchParams({ fileList: JSON.stringify([cacheListItem]) }).toString();
+    const query = new URLSearchParams({
+      fileList: JSON.stringify([cacheListItem])
+    }).toString();
     const viewerBase = this.resolveViewerOrigin();
     const viewerPath = this.resolveViewerPath();
     const url = `${viewerBase}${viewerPath}?${query}`;
@@ -589,10 +646,19 @@ var FilesModule = class {
     const baseMinorRev = (_e = (_d = cacheResult.baseMinorRev) != null ? _d : options.baseMinorRev) != null ? _e : 0;
     const fileName = cacheResult.filename || cacheResult.fileName || options.filename;
     if (cacheResult.cacheStatus !== void 0 && cacheResult.cacheStatus !== 2) {
-      throw new Error(`Conversion not ready after v2 request (cacheStatus=${cacheResult.cacheStatus})`);
+      throw new Error(
+        `Conversion not ready after v2 request (cacheStatus=${cacheResult.cacheStatus})`
+      );
     }
-    const cacheListItem = { baseFileId, baseMajorRev, baseMinorRev, fileName };
-    const query = new URLSearchParams({ fileList: JSON.stringify([cacheListItem]) }).toString();
+    const cacheListItem = {
+      baseFileId,
+      baseMajorRev,
+      baseMinorRev,
+      fileName
+    };
+    const query = new URLSearchParams({
+      fileList: JSON.stringify([cacheListItem])
+    }).toString();
     const viewerBase = this.resolveViewerOrigin();
     const viewerPath = this.resolveViewerPath();
     const url = `${viewerBase}${viewerPath}?${query}`;
@@ -603,6 +669,15 @@ var FilesModule = class {
     const elapsedMs = this.operationStartTime > 0 ? Date.now() - this.operationStartTime : 0;
     this.state = { ...this.state, ...next, elapsedMs };
     this.viewer._emit("files:state", this.state);
+    this.viewer._emit("loading:change", {
+      loading: this.state.isLoading,
+      phase: this.toViewerLoadingPhase(this.state.stage)
+    });
+  }
+  toViewerLoadingPhase(stage) {
+    if (stage === "error") return "error";
+    if (stage === "idle" || stage === "completed") return "ready";
+    return "loading";
   }
   // Shared wrapper to handle loading state lifecycle and top-level errors.
   async withOperation(initial, run) {
@@ -614,7 +689,11 @@ var FilesModule = class {
     });
     try {
       const result = await run();
-      this.updateState({ isLoading: false, stage: "completed", message: "Completed" });
+      this.updateState({
+        isLoading: false,
+        stage: "completed",
+        message: "Completed"
+      });
       return result;
     } catch (e) {
       const msg = this.toErrorMessage(e);
@@ -984,7 +1063,11 @@ var ModelTreeModule = class {
   }
   selectNodes(nodeIds) {
     const normalizedNodeIds = this.normalizeNodeIds(nodeIds);
-    console.log("[3dviewer-sdk] modelTree.selectNodes", { nodeIds, normalizedNodeIds });
+    console.log("[3dviewer-sdk] modelTree.selectNodes post message", {
+      nodeIds,
+      normalizedNodeIds,
+      willClearSelection: normalizedNodeIds.length === 0
+    });
     this.postTreeSelectNode({
       nodeIds: normalizedNodeIds
     });
@@ -1263,12 +1346,50 @@ var Viewer3D = class {
     this.containerEl = null;
     this.iframeEl = null;
     this.initialized = false;
+    this.viewerReady = false;
+    this.readyPayload = null;
+    this.readyWaiters = [];
+    this.loadingState = {
+      loading: false,
+      phase: "ready"
+    };
     this.emitter = new Emitter();
     this.handleMessage = (event) => {
-      var _a, _b, _c, _d, _e;
+      var _a, _b, _c;
       const data = event.data;
       if (!data || typeof data !== "object") return;
       switch (data.type) {
+        case "viewer-loading-change" /* LOADING_CHANGE */: {
+          const payload = data.payload;
+          if (!payload) break;
+          this.setLoadingState({
+            loading: Boolean(payload.loading),
+            phase: payload.phase,
+            viewId: payload.viewId ? String(payload.viewId) : void 0,
+            modelFileId: payload.modelFileId ? String(payload.modelFileId) : void 0,
+            timestamp: payload.timestamp ? Number(payload.timestamp) : void 0
+          });
+          break;
+        }
+        case "viewer-ready" /* READY */: {
+          const payload = data.payload;
+          const readyPayload = {
+            ready: true,
+            viewId: (payload == null ? void 0 : payload.viewId) ? String(payload.viewId) : void 0,
+            modelFileId: (payload == null ? void 0 : payload.modelFileId) ? String(payload.modelFileId) : void 0,
+            timestamp: Number(payload == null ? void 0 : payload.timestamp) || Date.now()
+          };
+          this.setLoadingState({
+            loading: false,
+            phase: "ready",
+            viewId: readyPayload.viewId,
+            modelFileId: readyPayload.modelFileId,
+            timestamp: readyPayload.timestamp
+          });
+          this.resolveReady(readyPayload);
+          this._emit("viewer:ready", readyPayload);
+          break;
+        }
         case "viewer-home-click" /* HOME_CLICK */:
           this._emit("camera:home", { timestamp: Date.now() });
           break;
@@ -1283,9 +1404,6 @@ var Viewer3D = class {
           });
           break;
         }
-        case "viewer-node-select" /* NODE_SELECT */:
-          this._emit("node:select", { nodeId: String((_b = (_a = data.payload) == null ? void 0 : _a.nodeId) != null ? _b : ""), timestamp: Date.now() });
-          break;
         case "viewer-node-selection-change" /* NODE_SELECTION_CHANGE */: {
           const payload = data.payload;
           const rawNodeIds = payload == null ? void 0 : payload.nodeIds;
@@ -1297,7 +1415,9 @@ var Viewer3D = class {
           break;
         }
         case "viewer-pan-change" /* PAN_CHANGE */:
-          this._emit("interaction:pan-change", { enabled: Boolean((_c = data.payload) == null ? void 0 : _c.enabled) });
+          this._emit("interaction:pan-change", {
+            enabled: Boolean((_a = data.payload) == null ? void 0 : _a.enabled)
+          });
           break;
         case "viewer-pdf-plan-mode" /* PDF_PLAN_MODE */: {
           const payload = data.payload;
@@ -1355,7 +1475,8 @@ var Viewer3D = class {
         }
         case "viewer-tree-node-ids" /* TREE_NODE_IDS */: {
           const payload = data.payload;
-          if (!payload || !payload.requestId || !Array.isArray(payload.nodeIds)) break;
+          if (!payload || !payload.requestId || !Array.isArray(payload.nodeIds))
+            break;
           this._emit("modelTree:node-ids", {
             requestId: String(payload.requestId),
             nodeIds: payload.nodeIds.map(String),
@@ -1365,7 +1486,8 @@ var Viewer3D = class {
         }
         case "viewer-tree-nodes" /* TREE_NODES */: {
           const payload = data.payload;
-          if (!payload || !payload.requestId || !Array.isArray(payload.nodes)) break;
+          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) => {
@@ -1391,7 +1513,8 @@ var Viewer3D = class {
         }
         case "viewer-sheets-list" /* SHEETS_LIST */: {
           const payload = data.payload;
-          if (!payload || !payload.requestId || !Array.isArray(payload.sheets)) break;
+          if (!payload || !payload.requestId || !Array.isArray(payload.sheets))
+            break;
           this._emit("sheets:list", {
             requestId: String(payload.requestId),
             sheets: payload.sheets.map((sheet) => {
@@ -1403,17 +1526,18 @@ var Viewer3D = class {
                 viewId: sheet.viewId ? String(sheet.viewId) : void 0
               };
             }),
-            activeSheetId: (_d = payload.activeSheetId) != null ? _d : null,
+            activeSheetId: (_b = payload.activeSheetId) != null ? _b : null,
             timestamp: Number(payload.timestamp) || Date.now()
           });
           break;
         }
         case "viewer-object-properties-list" /* OBJECT_PROPERTIES_LIST */: {
           const payload = data.payload;
-          if (!payload || !payload.requestId || !Array.isArray(payload.properties)) break;
+          if (!payload || !payload.requestId || !Array.isArray(payload.properties))
+            break;
           this._emit("object-properties:list", {
             requestId: String(payload.requestId),
-            selectionKey: String((_e = payload.selectionKey) != null ? _e : ""),
+            selectionKey: String((_c = payload.selectionKey) != null ? _c : ""),
             nodeIds: Array.isArray(payload.nodeIds) ? payload.nodeIds.map(String) : [],
             persistentIds: Array.isArray(payload.persistentIds) ? payload.persistentIds.map(String) : [],
             properties: payload.properties.filter((item) => item && typeof item === "object").map((item) => ({ ...item })),
@@ -1423,7 +1547,8 @@ var Viewer3D = class {
         }
         case "viewer-linked-objects-list" /* LINKED_OBJECTS_LIST */: {
           const payload = data.payload;
-          if (!payload || !payload.requestId || !Array.isArray(payload.linkedObjects)) break;
+          if (!payload || !payload.requestId || !Array.isArray(payload.linkedObjects))
+            break;
           this._emit("linked-objects:list", {
             requestId: String(payload.requestId),
             linkedObjects: payload.linkedObjects.filter((item) => item && typeof item === "object").map((item) => ({ ...item })),
@@ -1433,11 +1558,12 @@ var Viewer3D = class {
         }
         case "viewer-states-objects-list" /* STATES_OBJECTS_LIST */: {
           const payload = data.payload;
-          if (!payload || !payload.requestId || !Array.isArray(payload.statesObjects)) break;
+          if (!payload || !payload.requestId || !Array.isArray(payload.statesObjects))
+            break;
           this._emit("states-objects:list", {
             requestId: String(payload.requestId),
             statesObjects: payload.statesObjects.map((item) => {
-              var _a2, _b2, _c2, _d2, _e2, _f, _g;
+              var _a2, _b2, _c2, _d, _e, _f, _g;
               return {
                 id: String((_a2 = item.id) != null ? _a2 : ""),
                 name: String((_b2 = item.name) != null ? _b2 : ""),
@@ -1450,7 +1576,7 @@ var Viewer3D = class {
                   };
                 }) : [],
                 states: {
-                  color: String((_e2 = (_d2 = item.states) == null ? void 0 : _d2.color) != null ? _e2 : ""),
+                  color: String((_e = (_d = item.states) == null ? void 0 : _d.color) != null ? _e : ""),
                   type: String((_g = (_f = item.states) == null ? void 0 : _f.type) != null ? _g : "")
                 }
               };
@@ -1461,7 +1587,8 @@ var Viewer3D = class {
         }
         case "viewer-markup-list" /* MARKUP_LIST */: {
           const payload = data.payload;
-          if (!payload || !payload.requestId || !Array.isArray(payload.markups)) break;
+          if (!payload || !payload.requestId || !Array.isArray(payload.markups))
+            break;
           this._emit("markup:list", {
             requestId: String(payload.requestId),
             markups: payload.markups.map((markup) => {
@@ -1530,6 +1657,36 @@ var Viewer3D = class {
     var _a;
     return (_a = this.options.url) != null ? _a : null;
   }
+  on(event, cb) {
+    return this._on(event, cb);
+  }
+  off(event, cb) {
+    this._off(event, cb);
+  }
+  getLoadingState() {
+    return { ...this.loadingState };
+  }
+  ready(options) {
+    if (this.viewerReady && this.readyPayload) {
+      return Promise.resolve({ ...this.readyPayload });
+    }
+    const timeoutMs = options == null ? void 0 : options.timeoutMs;
+    return new Promise((resolve, reject) => {
+      const waiter = {
+        resolve: (payload) => resolve({ ...payload }),
+        reject
+      };
+      if (typeof timeoutMs === "number" && timeoutMs > 0) {
+        waiter.timer = setTimeout(() => {
+          this.readyWaiters = this.readyWaiters.filter(
+            (item) => item !== waiter
+          );
+          reject(new Error("Timeout while waiting for viewer to be ready"));
+        }, timeoutMs);
+      }
+      this.readyWaiters.push(waiter);
+    });
+  }
   // ===== lifecycle =====
   init() {
     if (this.initialized) return;
@@ -1541,7 +1698,12 @@ var Viewer3D = class {
   async render(file) {
     this.ensureInit();
     if (this.iframeEl) return;
+    this.resetReadyState();
     if (!this.options.url) return this.files.render(file);
+    this.setLoadingState({
+      loading: true,
+      phase: "loading"
+    });
     const iframe = document.createElement("iframe");
     iframe.src = this.withInitialOptions(this.options.url);
     iframe.style.border = "none";
@@ -1549,13 +1711,19 @@ var Viewer3D = class {
     iframe.style.height = this.options.height || "100%";
     iframe.width = this.options.width || "100%";
     iframe.height = this.options.height || "100%";
-    if (this.options.sandbox) iframe.setAttribute("sandbox", this.options.sandbox);
+    if (this.options.sandbox)
+      iframe.setAttribute("sandbox", this.options.sandbox);
     this.containerEl.appendChild(iframe);
     this.iframeEl = iframe;
   }
   open(url) {
     this.ensureInit();
     this.options.url = url;
+    this.resetReadyState();
+    this.setLoadingState({
+      loading: true,
+      phase: "loading"
+    });
     const finalUrl = this.withInitialOptions(url);
     if (!this.iframeEl) {
       this.render();
@@ -1574,16 +1742,27 @@ var Viewer3D = class {
     this.iframeEl = null;
     this.containerEl = null;
     this.initialized = false;
+    this.rejectReadyWaiters(
+      new Error("Viewer was destroyed before becoming ready")
+    );
   }
   ensureInit() {
-    if (!this.initialized) throw new Error("Call viewer.init() before using viewer");
+    if (!this.initialized)
+      throw new Error("Call viewer.init() before using viewer");
   }
   withInitialOptions(url) {
+    var _a;
     try {
       const parsedUrl = new URL(url, window.location.href);
       const initialToolbar = this.normalizeInitialToolbar();
       if (initialToolbar) {
-        parsedUrl.searchParams.set("useToolbar", JSON.stringify(initialToolbar));
+        parsedUrl.searchParams.set(
+          "useToolbar",
+          JSON.stringify(initialToolbar)
+        );
+      }
+      if (((_a = this.options.ui) == null ? void 0 : _a.loadingIndicator) === false) {
+        parsedUrl.searchParams.set("loadingIndicator", "false");
       }
       return parsedUrl.toString();
     } catch {
@@ -1597,17 +1776,25 @@ var Viewer3D = class {
       return { [initialToolbar]: true };
     }
     if (Array.isArray(initialToolbar)) {
-      return initialToolbar.reduce((result, target) => {
-        result[target] = true;
-        return result;
-      }, {});
+      return initialToolbar.reduce(
+        (result, target) => {
+          result[target] = true;
+          return result;
+        },
+        {}
+      );
     }
-    const entries = Object.entries(initialToolbar).filter(([, enabled]) => enabled === true);
+    const entries = Object.entries(initialToolbar).filter(
+      ([, enabled]) => enabled === true
+    );
     if (entries.length === 0) return null;
-    return entries.reduce((result, [target]) => {
-      result[target] = true;
-      return result;
-    }, {});
+    return entries.reduce(
+      (result, [target]) => {
+        result[target] = true;
+        return result;
+      },
+      {}
+    );
   }
   // ===== typed internal events used by modules =====
   _on(event, cb) {
@@ -1619,6 +1806,30 @@ var Viewer3D = class {
   _emit(event, payload) {
     this.emitter.emit(event, payload);
   }
+  resetReadyState() {
+    this.viewerReady = false;
+    this.readyPayload = null;
+  }
+  setLoadingState(payload) {
+    this.loadingState = { ...payload };
+    this._emit("loading:change", this.loadingState);
+  }
+  resolveReady(payload) {
+    this.viewerReady = true;
+    this.readyPayload = { ...payload };
+    this.readyWaiters.forEach((waiter) => {
+      if (waiter.timer) clearTimeout(waiter.timer);
+      waiter.resolve(payload);
+    });
+    this.readyWaiters = [];
+  }
+  rejectReadyWaiters(error) {
+    this.readyWaiters.forEach((waiter) => {
+      if (waiter.timer) clearTimeout(waiter.timer);
+      waiter.reject(error);
+    });
+    this.readyWaiters = [];
+  }
   // ===== postMessage bridge =====
   postToViewer(type, payload) {
     var _a;