@inweb/viewer-visualize 26.7.0 → 26.7.2

package/lib/Viewer/Draggers/index.d.ts

@@ -42,5 +42,4 @@ import { IDraggersRegistry } from "@inweb/viewer-core";
  * viewer.setActiveDragger("MyDragger");
  * ```
  */
-declare const draggers: IDraggersRegistry;
-export { draggers };
+export declare const draggers: IDraggersRegistry;

package/lib/Viewer/Loaders/FileLoader.d.ts

@@ -0,0 +1,10 @@
+export declare class FileLoader {
+    private requestHeader;
+    private withCredentials;
+    private abortSignal;
+    constructor();
+    setRequestHeader(requestHeader: HeadersInit): void;
+    setWithCredentials(withCredentials: boolean): void;
+    setAbortSignal(abortSignal: AbortSignal): void;
+    load(file: any, onProgress?: (event: any) => void): Promise<ArrayBuffer>;
+}

package/lib/Viewer/Loaders/VSFFileLoader.d.ts

@@ -0,0 +1,8 @@
+import { Loader, LoadParams } from "@inweb/viewer-core";
+import { Viewer } from "../Viewer";
+export declare class VSFFileLoader extends Loader {
+    viewer: Viewer;
+    constructor(viewer: Viewer);
+    isSupport(file: any, format?: string): boolean;
+    load(file: any, format?: string, params?: LoadParams): Promise<this>;
+}

package/lib/Viewer/Loaders/VSFXFileLoader.d.ts

@@ -0,0 +1,8 @@
+import { Loader, LoadParams } from "@inweb/viewer-core";
+import { Viewer } from "../Viewer";
+export declare class VSFXFileLoader extends Loader {
+    viewer: Viewer;
+    constructor(viewer: Viewer);
+    isSupport(file: any, format?: string): boolean;
+    load(file: any, format?: string, params?: LoadParams): Promise<this>;
+}

package/lib/Viewer/Loaders/index.d.ts

@@ -27,8 +27,7 @@ import { ILoadersRegistry } from "@inweb/viewer-core";
  * @example Implementing a custom loader.
  *
  * ```javascript
- * import { Loader } from "@inweb/viewer-core";
- * import { loaders, Viewer } from "@inweb/viewer-visualize";
+ * import { Loader, loaders, Viewer } from "@inweb/viewer-visualize";
  *
  * class MyLoader extends Loader {
  *   public viewer: Viewer;
@@ -55,7 +54,7 @@ import { ILoadersRegistry } from "@inweb/viewer-core";
  *     this.viewer.syncOverlay();
  *     this.viewer.resize();
  *
- *     this.viewer.emitEvent({ type: "databasechunk", data: model, file });
+ *     this.viewer.emitEvent({ type: "databasechunk", data, file });
  *
  *     return Promise.resove(this);
  *   };

package/lib/Viewer/Viewer.d.ts

@@ -199,33 +199,84 @@ export declare class Viewer extends EventEmitter2<ViewerEventMap & CanvasEventMa
     loadReferences(model: Model | File | Assembly): Promise<this>;
     applyModelTransformMatrix(model: Model | Assembly): void;
     applySceneGraphSettings(options?: IOptions): void;
-    open(file: FileSource, params?: {
-        format?: string;
-        mode?: string;
-    }): Promise<this>;
-    /**
-     * Deprecated since `26.4`. Use {@link open | open()} instead.
-     */
-    openVsfFile(buffer: Uint8Array | ArrayBuffer): this;
     /**
-     * Loads a `VSFX` file into the viewer.
+     * Loads a file into the viewer.
+     *
+     * The viewer must be {@link initialize | initialized} before opening the file. Otherwise, `open()` does
+     * nothing.
+     *
+     * This method requires a `Client` instance to be specified to load file from the Open Cloud Server.
+     * The file geometry data on the Open Cloud Server must be converted into a `vsfx` format, otherwise an
+     * exception will be thrown.
+     *
+     * For files from Open Cloud Server, the default model will be loaded. If there is no default model,
+     * first availiable model will be loaded. If no models are found in the file, an exception will be
+     * thrown.
      *
-     * This method does not support {@link IOptions.enableStreamingMode | streaming} or
-     * {@link IOptions.enablePartialMode | partial streaming} mode.
+     * For URLs, the file extension is used to determine the file format. For a `ArrayBuffer` and `Data
+     * URL`, a file format must be specified using `params.format` parameter (see below). If no appropriate
+     * loader is found for the specified format, an exception will be thrown.
      *
      * If there was an active dragger before opening the file, it will be deactivated. After opening the
      * file, you must manually activate the required dragger.
      *
+     * To open a large files, enable {@link IOptions.enablePartialMode | partial streaming} mode before
+     * opening. Partial streaming is only supported when opening files from an Open Cloud Server, but not
+     * local files and URLs. Example:
+     *
+     * ```javascript
+     * viewer.options.enableStreamingMode = true;
+     * viewer.options.enablePartialMode = true;
+     * await viewer.open(file);
+     * ```
+     *
      * Fires:
      *
      * - {@link OpenEvent | open}
      * - {@link GeometryStartEvent | geometrystart}
      * - {@link GeometryProgressEvent | geometryprogress}
      * - {@link DatabaseChunkEvent | databasechunk}
+     * - {@link GeometryChunkEvent | geometrychunk}
      * - {@link GeometryEndEvent | geometryend}
      * - {@link GeometryErrorEvent | geometryerror}
      *
-     * @param buffer - Binary data buffer to load.
+     * @param file - File to load. Can be one of:
+     *
+     *   - `File`, `Assembly` or `Model` instance from the Open Cloud Server
+     *   - File `URL` string
+     *   - {@link https://developer.mozilla.org/docs/Web/HTTP/Basics_of_HTTP/Data_URIs | Data URL} string
+     *   - {@link https://developer.mozilla.org/docs/Web/API/File | Web API File} object
+     *   - {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer | ArrayBuffer}
+     *       object
+     *
+     * @param params - Loading parameters.
+     * @param params.format - File format string. Required when loading a file as `ArrayBuffer` or `Data
+     *   URL`.
+     * @param params.mode - Reserved for future use.
+     * @param params.requestHeader - The
+     *   {@link https://developer.mozilla.org/docs/Glossary/Request_header | request header} used in HTTP
+     *   request.
+     * @param params.withCredentials - Whether the HTTP request uses credentials such as cookies,
+     *   authorization headers or TLS client certificates. See
+     *   {@link https://developer.mozilla.org/docs/Web/API/XMLHttpRequest/withCredentials | XMLHttpRequest.withCredentials}
+     *   for more details.
+     */
+    open(file: FileSource, params?: {
+        format?: string;
+        mode?: string;
+        requestHeader?: HeadersInit;
+        withCredentials?: boolean;
+    }): Promise<this>;
+    /**
+     * Deprecated since `26.4`. Use {@link open | open()} instead.
+     *
+     * @deprecated
+     */
+    openVsfFile(buffer: Uint8Array | ArrayBuffer): this;
+    /**
+     * Deprecated since `26.4`. Use {@link open | open()} instead.
+     *
+     * @deprecated
      */
     openVsfxFile(buffer: Uint8Array | ArrayBuffer): this;
     cancel(): this;

package/lib/index.d.ts

@@ -1,8 +1,9 @@
-export { draggers } from "./Viewer/Draggers";
-export { commands } from "./Viewer/Commands";
-export { components } from "./Viewer/Components";
-export { loaders } from "./Viewer/Loaders";
-export { Viewer } from "./Viewer/Viewer";
+export * from "./Viewer/Draggers";
+export * from "./Viewer/Commands";
+export * from "./Viewer/Components";
+export * from "./Viewer/Loaders";
+export * from "./Viewer/Loaders/FileLoader";
+export * from "./Viewer/Viewer";
 export { OdBaseDragger } from "./Viewer/Draggers/Common/OdBaseDragger";
 export { MarkupType } from "./Viewer/Markup/MarkupFactory";
 export * from "@inweb/viewer-core";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inweb/viewer-visualize",
-  "version": "26.7.0",
+  "version": "26.7.2",
   "description": "JavaScript library for rendering CAD and BIM files in a browser using VisualizeJS",
   "homepage": "https://cloud.opendesign.com/docs/index.html",
   "license": "SEE LICENSE IN LICENSE",
@@ -29,10 +29,10 @@
     "docs": "typedoc"
   },
   "dependencies": {
-    "@inweb/client": "~26.7.0",
-    "@inweb/eventemitter2": "~26.7.0",
-    "@inweb/markup": "~26.7.0",
-    "@inweb/viewer-core": "~26.7.0"
+    "@inweb/client": "~26.7.2",
+    "@inweb/eventemitter2": "~26.7.2",
+    "@inweb/markup": "~26.7.2",
+    "@inweb/viewer-core": "~26.7.2"
   },
   "visualizeJS": "https://public-fhemb7e3embacwec.z02.azurefd.net/libs/visualizejs/master/Visualize.js"
 }

package/src/Viewer/Draggers/index.ts

@@ -78,7 +78,7 @@ import { OrbitAroundBuildingDragger } from "./OrbitAroundBuildingDragger";
  * viewer.setActiveDragger("MyDragger");
  * ```
  */
-const draggers: IDraggersRegistry = draggersRegistry("visualizejs");
+export const draggers: IDraggersRegistry = draggersRegistry("visualizejs");
 
 // build-in draggers
 
@@ -93,5 +93,3 @@ draggers.registerDragger("CuttingPlaneXAxis", (viewer) => new OdCuttingPlaneXAxi
 draggers.registerDragger("CuttingPlaneYAxis", (viewer) => new OdCuttingPlaneYAxisDragger(viewer));
 draggers.registerDragger("CuttingPlaneZAxis", (viewer) => new OdCuttingPlaneZAxisDragger(viewer));
 draggers.registerDragger("Walk", (viewer) => new OdaWalkDragger(viewer));
-
-export { draggers };

package/src/Viewer/Loaders/FileLoader.ts

@@ -0,0 +1,108 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2002-2025, Open Design Alliance (the "Alliance").
+// All rights reserved.
+//
+// This software and its documentation and related materials are owned by
+// the Alliance. The software may only be incorporated into application
+// programs owned by members of the Alliance, subject to a signed
+// Membership Agreement and Supplemental Software License Agreement with the
+// Alliance. The structure and organization of this software are the valuable
+// trade secrets of the Alliance and its suppliers. The software is also
+// protected by copyright law and international treaty provisions. Application
+// programs incorporating this software must include the following statement
+// with their copyright notices:
+//
+//   This application incorporates Open Design Alliance software pursuant to a
+//   license agreement with Open Design Alliance.
+//   Open Design Alliance Copyright (C) 2002-2025 by Open Design Alliance.
+//   All rights reserved.
+//
+// By use of this software, its documentation or related materials, you
+// acknowledge and accept the above terms.
+///////////////////////////////////////////////////////////////////////////////
+
+export class FileLoader {
+  private requestHeader: HeadersInit;
+  private withCredentials: boolean;
+  private abortSignal: AbortSignal;
+
+  constructor() {
+    this.requestHeader = {};
+    this.withCredentials = false;
+    this.abortSignal = undefined;
+  }
+
+  setRequestHeader(requestHeader: HeadersInit) {
+    this.requestHeader = requestHeader;
+  }
+
+  setWithCredentials(withCredentials: boolean) {
+    this.withCredentials = withCredentials;
+  }
+
+  setAbortSignal(abortSignal: AbortSignal) {
+    this.abortSignal = abortSignal;
+  }
+
+  load(file: any, onProgress?: (event) => void): Promise<ArrayBuffer> {
+    if (typeof file === "string") {
+      const request = new Request(file, {
+        headers: new Headers(this.requestHeader),
+        credentials: this.withCredentials ? "include" : "same-origin",
+        signal: this.abortSignal,
+      });
+
+      return fetch(request)
+        .then((response) => {
+          if (!response.ok) throw new Error(`Failed to fetch "${response.url}", status ${response.status}`);
+
+          const contentLength = response.headers.get("X-File-Size") || response.headers.get("Content-Length");
+          const total = parseInt(contentLength || "", 10) || 0;
+          const lengthComputable = total > 0;
+
+          const stream = new ReadableStream({
+            async start(controller) {
+              const reader = response.body.getReader();
+              let loaded = 0;
+              try {
+                while (true) {
+                  const { done, value } = await reader.read();
+                  if (done) break;
+                  if (onProgress) {
+                    loaded += value.byteLength;
+                    onProgress(new ProgressEvent("progress", { lengthComputable, loaded, total }));
+                  }
+                  controller.enqueue(value);
+                }
+                controller.close();
+              } catch (e) {
+                controller.error(e);
+              }
+            },
+          });
+
+          return new Response(stream);
+        })
+        .then((response) => response.arrayBuffer());
+    }
+
+    if (file instanceof globalThis.File) {
+      return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = () => resolve(reader.result as any);
+        reader.onerror = () => reject(reader.error);
+        reader.onprogress = onProgress;
+        reader.readAsArrayBuffer(new Blob([file]));
+      });
+    }
+
+    if (onProgress) {
+      const total = (file as ArrayBuffer).byteLength;
+      const lengthComputable = total > 0;
+      const loaded = total;
+      onProgress(new ProgressEvent("progress", { lengthComputable, loaded, total }));
+    }
+
+    return Promise.resolve(file);
+  }
+}

package/src/Viewer/Loaders/{VSFBufferLoader.ts → VSFFileLoader.ts}

@@ -21,10 +21,11 @@
 // acknowledge and accept the above terms.
 ///////////////////////////////////////////////////////////////////////////////
 
-import { Loader } from "@inweb/viewer-core";
+import { Loader, LoadParams } from "@inweb/viewer-core";
 import { Viewer } from "../Viewer";
+import { FileLoader } from "./FileLoader";
 
-export class VSFBufferLoader extends Loader {
+export class VSFFileLoader extends Loader {
   public viewer: Viewer;
 
   constructor(viewer: Viewer) {
@@ -33,16 +34,32 @@ export class VSFBufferLoader extends Loader {
   }
 
   override isSupport(file: any, format?: string): boolean {
-    return file instanceof ArrayBuffer && /vsf$/i.test(format);
+    return (
+      (typeof file === "string" || file instanceof globalThis.File || file instanceof ArrayBuffer) &&
+      /vsf$/i.test(format)
+    );
   }
 
-  override load(buffer: any, format?: string): Promise<this> {
-    if (!this.viewer.visualizeJs) return Promise.resolve(this);
+  override async load(file: any, format?: string, params?: LoadParams): Promise<this> {
+    if (!this.viewer.visualizeJs) return this;
+
+    const progress = (event: ProgressEvent) => {
+      const { lengthComputable, loaded, total } = event;
+      const progress = lengthComputable ? loaded / total : 1;
+      this.viewer.emitEvent({ type: "geometryprogress", data: progress, file });
+    };
+
+    const loader = new FileLoader();
+    loader.setRequestHeader(params.requestHeader);
+    loader.setWithCredentials(params.withCredentials);
+    loader.setAbortSignal(this.abortController.signal);
+
+    const buffer = await loader.load(file, progress);
+    const data = new Uint8Array(buffer);
 
     const visLib = this.viewer.visLib();
     const visViewer = visLib.getViewer();
 
-    const data = new Uint8Array(buffer);
     visViewer.parseFile(data);
 
     this.viewer.syncOpenCloudVisualStyle(false);
@@ -50,9 +67,8 @@ export class VSFBufferLoader extends Loader {
     this.viewer.syncOverlay();
     this.viewer.resize();
 
-    this.viewer.emitEvent({ type: "geometryprogress", data: 1, file: buffer });
-    this.viewer.emitEvent({ type: "databasechunk", data, file: buffer });
+    this.viewer.emitEvent({ type: "databasechunk", data, file });
 
-    return Promise.resolve(this);
+    return this;
   }
 }

package/src/Viewer/Loaders/{VSFXBufferLoader.ts → VSFXFileLoader.ts}

@@ -21,10 +21,11 @@
 // acknowledge and accept the above terms.
 ///////////////////////////////////////////////////////////////////////////////
 
-import { Loader } from "@inweb/viewer-core";
+import { Loader, LoadParams } from "@inweb/viewer-core";
 import { Viewer } from "../Viewer";
+import { FileLoader } from "./FileLoader";
 
-export class VSFXBufferLoader extends Loader {
+export class VSFXFileLoader extends Loader {
   public viewer: Viewer;
 
   constructor(viewer: Viewer) {
@@ -33,16 +34,32 @@ export class VSFXBufferLoader extends Loader {
   }
 
   override isSupport(file: any, format?: string): boolean {
-    return file instanceof ArrayBuffer && /vsfx$/i.test(format);
+    return (
+      (typeof file === "string" || file instanceof globalThis.File || file instanceof ArrayBuffer) &&
+      /vsfx$/i.test(format)
+    );
   }
 
-  override load(buffer: any, format?: string): Promise<this> {
-    if (!this.viewer.visualizeJs) return Promise.resolve(this);
+  override async load(file: any, format?: string, params?: LoadParams): Promise<this> {
+    if (!this.viewer.visualizeJs) return this;
+
+    const progress = (event: ProgressEvent) => {
+      const { lengthComputable, loaded, total } = event;
+      const progress = lengthComputable ? loaded / total : 1;
+      this.viewer.emitEvent({ type: "geometryprogress", data: progress, file });
+    };
+
+    const loader = new FileLoader();
+    loader.setRequestHeader(params.requestHeader);
+    loader.setWithCredentials(params.withCredentials);
+    loader.setAbortSignal(this.abortController.signal);
+
+    const buffer = await loader.load(file, progress);
+    const data = new Uint8Array(buffer);
 
     const visLib = this.viewer.visLib();
     const visViewer = visLib.getViewer();
 
-    const data = new Uint8Array(buffer);
     visViewer.parseVsfx(data);
 
     this.viewer.syncOpenCloudVisualStyle(false);
@@ -50,9 +67,8 @@ export class VSFXBufferLoader extends Loader {
     this.viewer.syncOverlay();
     this.viewer.resize();
 
-    this.viewer.emitEvent({ type: "geometryprogress", data: 1, file: buffer });
-    this.viewer.emitEvent({ type: "databasechunk", data, file: buffer });
+    this.viewer.emitEvent({ type: "databasechunk", data, file });
 
-    return Promise.resolve(this);
+    return this;
   }
 }

package/src/Viewer/Loaders/index.ts

@@ -23,10 +23,10 @@
 
 import { ILoadersRegistry, loadersRegistry } from "@inweb/viewer-core";
 
-import { VSFBufferLoader } from "./VSFBufferLoader";
+import { VSFFileLoader } from "./VSFFileLoader";
 import { VSFCloudLoader } from "./VSFCloudLoader";
 
-import { VSFXBufferLoader } from "./VSFXBufferLoader";
+import { VSFXFileLoader } from "./VSFXFileLoader";
 import { VSFXCloudLoader } from "./VSFXCloudLoader";
 import { VSFXCloudStreamingLoader } from "./VSFXCloudStreamingLoader";
 import { VSFXCloudPartialLoader } from "./VSFXCloudPartialLoader";
@@ -59,8 +59,7 @@ import { VSFXCloudPartialLoader } from "./VSFXCloudPartialLoader";
  * @example Implementing a custom loader.
  *
  * ```javascript
- * import { Loader } from "@inweb/viewer-core";
- * import { loaders, Viewer } from "@inweb/viewer-visualize";
+ * import { Loader, loaders, Viewer } from "@inweb/viewer-visualize";
  *
  * class MyLoader extends Loader {
  *   public viewer: Viewer;
@@ -87,7 +86,7 @@ import { VSFXCloudPartialLoader } from "./VSFXCloudPartialLoader";
  *     this.viewer.syncOverlay();
  *     this.viewer.resize();
  *
- *     this.viewer.emitEvent({ type: "databasechunk", data: model, file });
+ *     this.viewer.emitEvent({ type: "databasechunk", data, file });
  *
  *     return Promise.resove(this);
  *   };
@@ -100,10 +99,10 @@ export const loaders: ILoadersRegistry = loadersRegistry("visualizejs");
 
 // build-in loaders
 
-loaders.registerLoader("vsf-buffer", (viewer: any) => new VSFBufferLoader(viewer));
+loaders.registerLoader("vsf-file", (viewer: any) => new VSFFileLoader(viewer));
 loaders.registerLoader("vsf-cloud", (viewer: any) => new VSFCloudLoader(viewer));
 
-loaders.registerLoader("vsfx-buffer", (viewer: any) => new VSFXBufferLoader(viewer));
+loaders.registerLoader("vsfx-file", (viewer: any) => new VSFXFileLoader(viewer));
 loaders.registerLoader("vsfx-cloud", (viewer: any) => new VSFXCloudLoader(viewer));
 loaders.registerLoader("vsfx-cloud-streaming", (viewer: any) => new VSFXCloudStreamingLoader(viewer));
 loaders.registerLoader("vsfx-cloud-partial", (viewer: any) => new VSFXCloudPartialLoader(viewer));

package/src/Viewer/Viewer.ts

@@ -851,7 +851,77 @@ export class Viewer
     this.update();
   }
 
-  async open(file: FileSource, params: { format?: string; mode?: string } = {}): Promise<this> {
+  /**
+   * Loads a file into the viewer.
+   *
+   * The viewer must be {@link initialize | initialized} before opening the file. Otherwise, `open()` does
+   * nothing.
+   *
+   * This method requires a `Client` instance to be specified to load file from the Open Cloud Server.
+   * The file geometry data on the Open Cloud Server must be converted into a `vsfx` format, otherwise an
+   * exception will be thrown.
+   *
+   * For files from Open Cloud Server, the default model will be loaded. If there is no default model,
+   * first availiable model will be loaded. If no models are found in the file, an exception will be
+   * thrown.
+   *
+   * For URLs, the file extension is used to determine the file format. For a `ArrayBuffer` and `Data
+   * URL`, a file format must be specified using `params.format` parameter (see below). If no appropriate
+   * loader is found for the specified format, an exception will be thrown.
+   *
+   * If there was an active dragger before opening the file, it will be deactivated. After opening the
+   * file, you must manually activate the required dragger.
+   *
+   * To open a large files, enable {@link IOptions.enablePartialMode | partial streaming} mode before
+   * opening. Partial streaming is only supported when opening files from an Open Cloud Server, but not
+   * local files and URLs. Example:
+   *
+   * ```javascript
+   * viewer.options.enableStreamingMode = true;
+   * viewer.options.enablePartialMode = true;
+   * await viewer.open(file);
+   * ```
+   *
+   * Fires:
+   *
+   * - {@link OpenEvent | open}
+   * - {@link GeometryStartEvent | geometrystart}
+   * - {@link GeometryProgressEvent | geometryprogress}
+   * - {@link DatabaseChunkEvent | databasechunk}
+   * - {@link GeometryChunkEvent | geometrychunk}
+   * - {@link GeometryEndEvent | geometryend}
+   * - {@link GeometryErrorEvent | geometryerror}
+   *
+   * @param file - File to load. Can be one of:
+   *
+   *   - `File`, `Assembly` or `Model` instance from the Open Cloud Server
+   *   - File `URL` string
+   *   - {@link https://developer.mozilla.org/docs/Web/HTTP/Basics_of_HTTP/Data_URIs | Data URL} string
+   *   - {@link https://developer.mozilla.org/docs/Web/API/File | Web API File} object
+   *   - {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer | ArrayBuffer}
+   *       object
+   *
+   * @param params - Loading parameters.
+   * @param params.format - File format string. Required when loading a file as `ArrayBuffer` or `Data
+   *   URL`.
+   * @param params.mode - Reserved for future use.
+   * @param params.requestHeader - The
+   *   {@link https://developer.mozilla.org/docs/Glossary/Request_header | request header} used in HTTP
+   *   request.
+   * @param params.withCredentials - Whether the HTTP request uses credentials such as cookies,
+   *   authorization headers or TLS client certificates. See
+   *   {@link https://developer.mozilla.org/docs/Web/API/XMLHttpRequest/withCredentials | XMLHttpRequest.withCredentials}
+   *   for more details.
+   */
+  async open(
+    file: FileSource,
+    params: {
+      format?: string;
+      mode?: string;
+      requestHeader?: HeadersInit;
+      withCredentials?: boolean;
+    } = {}
+  ): Promise<this> {
     if (!this.visualizeJs) return this;
 
     this.cancel();
@@ -895,8 +965,14 @@ export class Viewer
 
   /**
    * Deprecated since `26.4`. Use {@link open | open()} instead.
+   *
+   * @deprecated
    */
   openVsfFile(buffer: Uint8Array | ArrayBuffer): this {
+    console.warn(
+      "Viewer.openVsfFile() has been deprecated since 26.4 and will be removed in a future release, use Viewer.open() instead."
+    );
+
     if (!this.visualizeJs) return this;
 
     this.cancel();
@@ -929,26 +1005,15 @@ export class Viewer
   }
 
   /**
-   * Loads a `VSFX` file into the viewer.
-   *
-   * This method does not support {@link IOptions.enableStreamingMode | streaming} or
-   * {@link IOptions.enablePartialMode | partial streaming} mode.
-   *
-   * If there was an active dragger before opening the file, it will be deactivated. After opening the
-   * file, you must manually activate the required dragger.
-   *
-   * Fires:
-   *
-   * - {@link OpenEvent | open}
-   * - {@link GeometryStartEvent | geometrystart}
-   * - {@link GeometryProgressEvent | geometryprogress}
-   * - {@link DatabaseChunkEvent | databasechunk}
-   * - {@link GeometryEndEvent | geometryend}
-   * - {@link GeometryErrorEvent | geometryerror}
+   * Deprecated since `26.4`. Use {@link open | open()} instead.
    *
-   * @param buffer - Binary data buffer to load.
+   * @deprecated
    */
   openVsfxFile(buffer: Uint8Array | ArrayBuffer): this {
+    console.warn(
+      "Viewer.openVsfxFile() has been deprecated since 26.4 and will be removed in a future release, use Viewer.open() instead."
+    );
+
     if (!this.visualizeJs) return this;
 
     this.cancel();

package/src/index.ts

@@ -21,11 +21,12 @@
 // acknowledge and accept the above terms.
 ///////////////////////////////////////////////////////////////////////////////
 
-export { draggers } from "./Viewer/Draggers";
-export { commands } from "./Viewer/Commands";
-export { components } from "./Viewer/Components";
-export { loaders } from "./Viewer/Loaders";
-export { Viewer } from "./Viewer/Viewer";
+export * from "./Viewer/Draggers";
+export * from "./Viewer/Commands";
+export * from "./Viewer/Components";
+export * from "./Viewer/Loaders";
+export * from "./Viewer/Loaders/FileLoader";
+export * from "./Viewer/Viewer";
 
 export { OdBaseDragger } from "./Viewer/Draggers/Common/OdBaseDragger";
 export { MarkupType } from "./Viewer/Markup/MarkupFactory";

package/lib/Viewer/Loaders/VSFBufferLoader.d.ts

@@ -1,8 +0,0 @@
-import { Loader } from "@inweb/viewer-core";
-import { Viewer } from "../Viewer";
-export declare class VSFBufferLoader extends Loader {
-    viewer: Viewer;
-    constructor(viewer: Viewer);
-    isSupport(file: any, format?: string): boolean;
-    load(buffer: any, format?: string): Promise<this>;
-}

package/lib/Viewer/Loaders/VSFXBufferLoader.d.ts

@@ -1,8 +0,0 @@
-import { Loader } from "@inweb/viewer-core";
-import { Viewer } from "../Viewer";
-export declare class VSFXBufferLoader extends Loader {
-    viewer: Viewer;
-    constructor(viewer: Viewer);
-    isSupport(file: any, format?: string): boolean;
-    load(buffer: any, format?: string): Promise<this>;
-}