@x-viewer/core 0.21.3 → 0.21.5

package/dist/types/core/Configs.d.ts

@@ -82,8 +82,14 @@ export interface ModelConfig {
      */
     src: string;
     /**
-     * Explicit file format specification.
-     * Used when the format cannot be determined from the source URL.
+     * Raw file bytes when the host cannot expose a fetchable URL.
+     * When set, loaders use this buffer instead of downloading {@link src}.
+     * For 3D buffer loading, {@link fileFormat} is required.
+     */
+    data?: ArrayBuffer | Uint8Array;
+    /**
+     * Explicit file format (extension without dot), e.g. `glb`, `dwg`, `stl`.
+     * Required when {@link data} is set for 3D buffer loading; also used when the format cannot be inferred from {@link src}.
      * @hidden
      */
     fileFormat?: string;

package/dist/types/core/dxf/DxfLoader.d.ts

@@ -271,6 +271,10 @@ export declare class DxfLoader extends THREE.Loader {
      * @returns DxfData
      */
     loadAsyncEx(url: string, dxfDataId?: string, onProgress?: (event: ProgressEvent) => void): Promise<DxfData>;
+    /**
+     * Like {@link loadAsyncEx} but parses from in-memory bytes (DWG/DXF) instead of fetching a URL.
+     */
+    loadAsyncExFromBuffer(data: ArrayBuffer | Uint8Array, dxfDataId?: string, onProgress?: (event: ProgressEvent) => void): Promise<DxfData>;
     /**
      * Loads dxf asynchronously. It mainly contains 2 steps:
      * 1. Parses file content
@@ -279,10 +283,19 @@ export declare class DxfLoader extends THREE.Loader {
      * @param onProgress on progress callback
      */
     loadAsync(url: string, onProgress?: (event: ProgressEvent) => void): Promise<DxfData>;
+    /**
+     * Same as {@link loadAsync} but reads DWG/DXF from memory (no network).
+     */
+    loadAsyncFromBuffer(data: ArrayBuffer | Uint8Array, onProgress?: (event: ProgressEvent) => void): Promise<DxfData>;
     /**
      * Parses dxf contents from given url.
      */
     parse(url: string, onProgress?: (event: ProgressEvent) => void): Promise<IDxf>;
+    /**
+     * Parses DWG/DXF from memory (same pipeline as {@link parse} after download).
+     */
+    parseFromBuffer(data: ArrayBuffer | Uint8Array, onProgress?: (event: ProgressEvent) => void): Promise<IDxf>;
+    private parseDownloadedContent;
     /**
      * Aborts loading or parsing progress if any.
      * We cann't resume any progress once aborted.

package/dist/types/core/helpers/LoadingHelper.d.ts

@@ -15,6 +15,33 @@ export declare class LoadingHelper {
     loadModel(src: string, fileFormat?: string, onProgress?: (event: ProgressEvent) => void, requestHeader?: {
         [header: string]: string;
     }): Promise<THREE.Object3D | void>;
+    /**
+     * Loads a 3D model from memory (no URL fetch). {@link fileFormat} is required (e.g. `glb`, `fbx`, `stl`, `dwg`).
+     * For `.gltf` with external `.bin`/textures, use {@link loadGltfFromBuffer} with a non-empty resource path instead.
+     */
+    loadModelFromBuffer(data: ArrayBuffer | Uint8Array, fileFormat: string, onProgress?: (event: ProgressEvent) => void): Promise<THREE.Object3D | void>;
+    /** FBX (binary or ASCII) from memory. */
+    loadFbxFromBuffer(data: ArrayBuffer | Uint8Array): Promise<THREE.Object3D>;
+    /**
+     * Wavefront OBJ from memory (UTF-8). Does not fetch remote MTL; use {@link loadObj} with URLs if materials are external.
+     */
+    loadObjFromBuffer(data: ArrayBuffer | Uint8Array): Promise<THREE.Object3D>;
+    /** STL from memory; applies the same Y-up correction as {@link loadStl}. */
+    loadStlFromBuffer(data: ArrayBuffer | Uint8Array): Promise<THREE.Object3D>;
+    /** PLY from memory; same material assignment as {@link loadPly}. */
+    loadPlyFromBuffer(data: ArrayBuffer | Uint8Array): Promise<THREE.Object3D>;
+    /** IFC is not supported on buffer/URL loaders in this build. */
+    loadIfcFromBuffer(): Promise<THREE.Object3D>;
+    /** ESRI Shapefile (.shp) from memory. */
+    loadShpFromBuffer(data: ArrayBuffer | Uint8Array): Promise<THREE.Object3D>;
+    /** Collada (.dae) from memory (UTF-8 XML). */
+    loadDaeFromBuffer(data: ArrayBuffer | Uint8Array): Promise<THREE.Object3D>;
+    /** Rhino 3DM from memory (WASM). */
+    load3dmFromBuffer(data: ArrayBuffer | Uint8Array): Promise<THREE.Object3D>;
+    /** JPEG or PNG bytes as a textured plane (same as {@link loadImage} after blob URL). */
+    loadRasterImageFromBuffer(data: ArrayBuffer | Uint8Array, kind: "png" | "jpeg", onProgress?: (event: ProgressEvent) => void): Promise<THREE.Object3D>;
+    /** glTF (.gltf JSON or .glb binary) from memory; {@link resourcePath} resolves relative `.bin`/textures. */
+    loadGltfFromBuffer(data: ArrayBuffer | Uint8Array, resourcePath?: string): Promise<THREE.Object3D>;
     loadGltf(url: string, onProgress?: (event: ProgressEvent) => void, requestHeader?: {
         [header: string]: string;
     }): Promise<THREE.Object3D>;
@@ -59,6 +86,10 @@ export declare class LoadingHelper {
     loadDxf(url: string, onProgress?: (event: ProgressEvent) => void, requestHeader?: {
         [header: string]: string;
     }): Promise<THREE.Object3D>;
+    /**
+     * Loads DWG/DXF from memory (no URL fetch). Same output as {@link loadDxf}.
+     */
+    loadDxfFromBuffer(data: ArrayBuffer | Uint8Array, onProgress?: (event: ProgressEvent) => void): Promise<THREE.Object3D>;
     /**
      * Loads dxf data, including entities, tables(layers, blocks), etc.
      * The difference from loadDxf includes
@@ -68,6 +99,10 @@ export declare class LoadingHelper {
     loadDxfEx(url: string, dxfDataId?: string, onProgress?: (event: ProgressEvent) => void, onLoad?: () => void, cfg?: DxfLoaderConfig, requestHeader?: {
         [header: string]: string;
     }): Promise<DxfData>;
+    /**
+     * Like {@link loadDxfEx} but reads DWG/DXF from a buffer (no network).
+     */
+    loadDxfExFromBuffer(data: ArrayBuffer | Uint8Array, dxfDataId?: string, onProgress?: (event: ProgressEvent) => void, onLoad?: () => void, cfg?: DxfLoaderConfig): Promise<DxfData>;
     loadPly(url: string, onProgress?: (event: ProgressEvent) => void, requestHeader?: {
         [header: string]: string;
     }): Promise<THREE.Object3D>;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@x-viewer/core",
-    "version": "0.21.3",
+    "version": "0.21.5",
     "homepage": "https://dwg.thingraph.site/",
     "description": "WebGL-based 2D/3D viewer engine built on Three.js. View DWG/DXF/PDF files in the browser with no server required. Supports glTF, OBJ, FBX, IFC, STL and BimTiles formats.",
     "author": "thingraph",