babylonjs-loaders 7.22.5 → 7.23.1

package/babylonjs.loaders.module.d.ts

@@ -5,6 +5,14 @@ export * from "babylonjs-loaders/OBJ/index";
 export * from "babylonjs-loaders/STL/index";
 export * from "babylonjs-loaders/SPLAT/index";
 
+}
+declare module "babylonjs-loaders/dynamic" {
+/**
+ * Registers the async plugin factories for all built-in loaders.
+ * Loaders will be dynamically imported on demand, only when a SceneLoader load operation needs each respective loader.
+ */
+export function registerBuiltInLoaders(): void;
+
 }
 declare module "babylonjs-loaders/glTF/index" {
 export * from "babylonjs-loaders/glTF/glTFFileLoader";
@@ -45,6 +53,22 @@ export class GLTFValidation {
     static ValidateAsync(data: string | Uint8Array, rootUrl: string, fileName: string, getExternalResource: (uri: string) => Promise<Uint8Array>): Promise<GLTF2.IGLTFValidationResults>;
 }
 
+}
+declare module "babylonjs-loaders/glTF/glTFFileLoader.metadata" {
+export const GLTFMagicBase64Encoded = "Z2xURg";
+export const GLTFFileLoaderMetadata: {
+    readonly name: "gltf";
+    readonly extensions: {
+        readonly ".gltf": {
+            readonly isBinary: false;
+        };
+        readonly ".glb": {
+            readonly isBinary: true;
+        };
+    };
+    readonly canDirectLoad: (data: string) => boolean;
+};
+
 }
 declare module "babylonjs-loaders/glTF/glTFFileLoader" {
 import * as GLTF2 from "babylonjs-gltf2interface";
@@ -54,16 +78,15 @@ import { Camera } from "babylonjs/Cameras/camera";
 import { BaseTexture } from "babylonjs/Materials/Textures/baseTexture";
 import { Material } from "babylonjs/Materials/material";
 import { AbstractMesh } from "babylonjs/Meshes/abstractMesh";
-import { ISceneLoaderPluginFactory, ISceneLoaderPluginAsync, ISceneLoaderProgressEvent, ISceneLoaderAsyncResult } from "babylonjs/Loading/sceneLoader";
-import { SceneLoaderPluginOptions } from "babylonjs/Loading/sceneLoader";
+import { ISceneLoaderPluginFactory, ISceneLoaderPluginAsync, ISceneLoaderProgressEvent, ISceneLoaderAsyncResult, SceneLoaderPluginOptions } from "babylonjs/Loading/sceneLoader";
 import { AssetContainer } from "babylonjs/assetContainer";
 import { Scene, IDisposable } from "babylonjs/scene";
 import { WebRequest } from "babylonjs/Misc/webRequest";
 import { IFileRequest } from "babylonjs/Misc/fileRequest";
 import { IDataBuffer } from "babylonjs/Misc/dataReader";
+import { GLTFFileLoaderMetadata } from "babylonjs-loaders/glTF/glTFFileLoader.metadata";
 import { LoadFileError } from "babylonjs/Misc/fileTools";
 import { TransformNode } from "babylonjs/Meshes/transformNode";
-const PLUGIN_GLTF = "gltf";
 /**
  * Defines options for glTF loader extensions. This interface is extended by specific extensions.
  */
@@ -74,7 +97,7 @@ module "babylonjs/Loading/sceneLoader" {
         /**
          * Defines options for the glTF loader.
          */
-        [PLUGIN_GLTF]: Partial<GLTFLoaderOptions>;
+        [GLTFFileLoaderMetadata.name]: Partial<GLTFLoaderOptions>;
     }
 }
 /**
@@ -452,11 +475,10 @@ export class GLTFFileLoader extends GLTFLoaderOptions implements IDisposable, IS
     private _state;
     private _progressCallback?;
     private _requests;
-    private static readonly _MagicBase64Encoded;
     /**
      * Name of the loader ("gltf")
      */
-    readonly name: string;
+    readonly name: "gltf";
     /** @internal */
     readonly extensions: {
         readonly ".gltf": {
@@ -820,6 +842,34 @@ export interface IKHRLightsPunctual_Light extends GLTF2.IKHRLightsPunctual_Light
     _babylonLight?: Light;
 }
 
+}
+declare module "babylonjs-loaders/glTF/2.0/glTFLoaderExtensionRegistry" {
+import { GLTFLoader } from "babylonjs-loaders/glTF/2.0/glTFLoader";
+import { IGLTFLoaderExtension } from "babylonjs-loaders/glTF/2.0/glTFLoaderExtension";
+interface IRegisteredGLTFExtension {
+    isGLTFExtension: boolean;
+    factory: GLTFExtensionFactory;
+}
+export type GLTFExtensionFactory = (loader: GLTFLoader) => IGLTFLoaderExtension | Promise<IGLTFLoaderExtension>;
+/**
+ * All currently registered glTF 2.0 loader extensions.
+ */
+export const registeredGLTFExtensions: ReadonlyMap<string, Readonly<IRegisteredGLTFExtension>>;
+/**
+ * Registers a loader extension.
+ * @param name The name of the loader extension.
+ * @param isGLTFExtension If the loader extension is a glTF extension, then it will only be used for glTF files that use the corresponding glTF extension. Otherwise, it will be used for all loaded glTF files.
+ * @param factory The factory function that creates the loader extension.
+ */
+export function registerGLTFExtension(name: string, isGLTFExtension: boolean, factory: GLTFExtensionFactory): void;
+/**
+ * Unregisters a loader extension.
+ * @param name The name of the loader extension.
+ * @returns A boolean indicating whether the extension has been unregistered
+ */
+export function unregisterGLTFExtension(name: string): boolean;
+export {};
+
 }
 declare module "babylonjs-loaders/glTF/2.0/glTFLoaderExtension" {
 import { Nullable } from "babylonjs/types";
@@ -1048,7 +1098,6 @@ import { ISceneLoaderAsyncResult, ISceneLoaderProgressEvent } from "babylonjs/Lo
 import { Scene } from "babylonjs/scene";
 import { IProperty } from "babylonjs-gltf2interface";
 import { IGLTF, ISampler, INode, IScene, IMesh, IAccessor, ICamera, IAnimation, IBuffer, IBufferView, IMaterial, ITextureInfo, ITexture, IImage, IMeshPrimitive, IArrayItem, IAnimationChannel } from "babylonjs-loaders/glTF/2.0/glTFLoaderInterfaces";
-import { IGLTFLoaderExtension } from "babylonjs-loaders/glTF/2.0/glTFLoaderExtension";
 import { IGLTFLoader, IGLTFLoaderData } from "babylonjs-loaders/glTF/glTFFileLoader";
 import { GLTFFileLoader } from "babylonjs-loaders/glTF/glTFFileLoader";
 import { IDataBuffer } from "babylonjs/Misc/dataReader";
@@ -1056,6 +1105,8 @@ import { Light } from "babylonjs/Lights/light";
 import { AssetContainer } from "babylonjs/assetContainer";
 import { AnimationPropertyInfo } from "babylonjs-loaders/glTF/2.0/glTFLoaderAnimation";
 import { IObjectInfo } from "babylonjs/ObjectModel/objectModelInterfaces";
+import { GLTFExtensionFactory } from "babylonjs-loaders/glTF/2.0/glTFLoaderExtensionRegistry";
+export { GLTFFileLoader };
 interface IWithMetadata {
     metadata: any;
     _internalMetadata: any;
@@ -1118,7 +1169,6 @@ export class GLTFLoader implements IGLTFLoader {
     private _rootBabylonMesh;
     private _defaultBabylonMaterialData;
     private readonly _postSceneLoadActions;
-    private static _RegisteredExtensions;
     /**
      * The default glTF sampler.
      */
@@ -1127,12 +1177,14 @@ export class GLTFLoader implements IGLTFLoader {
      * Registers a loader extension.
      * @param name The name of the loader extension.
      * @param factory The factory function that creates the loader extension.
+     * @deprecated Please use registerGLTFExtension instead.
      */
-    static RegisterExtension(name: string, factory: (loader: GLTFLoader) => IGLTFLoaderExtension): void;
+    static RegisterExtension(name: string, factory: GLTFExtensionFactory): void;
     /**
      * Unregisters a loader extension.
      * @param name The name of the loader extension.
      * @returns A boolean indicating whether the extension has been unregistered
+     * @deprecated Please use unregisterGLTFExtension instead.
      */
     static UnregisterExtension(name: string): boolean;
     /**
@@ -1176,8 +1228,7 @@ export class GLTFLoader implements IGLTFLoader {
     private _loadAsync;
     private _loadData;
     private _setupData;
-    private _loadExtensions;
-    private _checkExtensions;
+    private _loadExtensionsAsync;
     private _createRootNode;
     /**
      * Loads a glTF scene.
@@ -1455,7 +1506,6 @@ export class GLTFLoader implements IGLTFLoader {
      */
     endPerformanceCounter(counterName: string): void;
 }
-export {};
 
 }
 declare module "babylonjs-loaders/glTF/2.0/Extensions/interactivityUtils" {
@@ -1560,6 +1610,13 @@ export class GLTFPathToObjectConverter<T> implements IPathToObjectConverter<T> {
     convert(path: string): IObjectInfo<T>;
 }
 
+}
+declare module "babylonjs-loaders/glTF/2.0/Extensions/dynamic" {
+/**
+ * Registers the built-in glTF 2.0 extension async factories, which dynamically imports and loads each glTF extension on demand (e.g. only when a glTF model uses the extension).
+ */
+export function registerBuiltInGLTFExtensions(): void;
+
 }
 declare module "babylonjs-loaders/glTF/2.0/Extensions/MSFT_sRGBFactors" {
 import { Nullable } from "babylonjs/types";
@@ -4030,6 +4087,17 @@ export class GLTFBinaryExtension extends GLTFLoaderExtension {
     loadShaderStringAsync(gltfRuntime: IGLTFRuntime, id: string, onSuccess: (shaderString: string) => void): boolean;
 }
 
+}
+declare module "babylonjs-loaders/STL/stlFileLoader.metadata" {
+export const STLFileLoaderMetadata: {
+    readonly name: "stl";
+    readonly extensions: {
+        readonly ".stl": {
+            readonly isBinary: true;
+        };
+    };
+};
+
 }
 declare module "babylonjs-loaders/STL/stlFileLoader" {
 import { Nullable } from "babylonjs/types";
@@ -4037,13 +4105,13 @@ import { AbstractMesh } from "babylonjs/Meshes/abstractMesh";
 import { ISceneLoaderPlugin } from "babylonjs/Loading/sceneLoader";
 import { AssetContainer } from "babylonjs/assetContainer";
 import { Scene } from "babylonjs/scene";
-const PLUGIN_STL = "stl";
+import { STLFileLoaderMetadata } from "babylonjs-loaders/STL/stlFileLoader.metadata";
 module "babylonjs/Loading/sceneLoader" {
     interface SceneLoaderPluginOptions {
         /**
          * Defines options for the stl loader.
          */
-        [PLUGIN_STL]: {};
+        [STLFileLoaderMetadata.name]: {};
     }
 }
 /**
@@ -4062,7 +4130,7 @@ export class STLFileLoader implements ISceneLoaderPlugin {
     /**
      * Defines the name of the plugin.
      */
-    readonly name: string;
+    readonly name: "stl";
     /**
      * Defines the extensions the stl loader is able to load.
      * force data to come in as an ArrayBuffer
@@ -4109,24 +4177,50 @@ export class STLFileLoader implements ISceneLoaderPlugin {
     private _parseBinary;
     private _parseASCII;
 }
-export {};
 
 }
 declare module "babylonjs-loaders/STL/index" {
 export * from "babylonjs-loaders/STL/stlFileLoader";
 
+}
+declare module "babylonjs-loaders/SPLAT/splatLoadingOptions" {
+/**
+ * Options for loading Gaussian Splatting and PLY files
+ */
+export type SPLATLoadingOptions = {
+    /**
+     * Defines if buffers should be kept in memory for editing purposes
+     */
+    keepInRam?: boolean;
+};
+
+}
+declare module "babylonjs-loaders/SPLAT/splatFileLoader.metadata" {
+export const SPLATFileLoaderMetadata: {
+    readonly name: "splat";
+    readonly extensions: {
+        readonly ".splat": {
+            readonly isBinary: true;
+        };
+        readonly ".ply": {
+            readonly isBinary: true;
+        };
+    };
+};
+
 }
 declare module "babylonjs-loaders/SPLAT/splatFileLoader" {
-import { ISceneLoaderPluginAsync, ISceneLoaderPluginFactory, ISceneLoaderPlugin, ISceneLoaderAsyncResult, ISceneLoaderProgressEvent } from "babylonjs/Loading/sceneLoader";
+import { ISceneLoaderPluginAsync, ISceneLoaderPluginFactory, ISceneLoaderAsyncResult, ISceneLoaderProgressEvent, SceneLoaderPluginOptions } from "babylonjs/Loading/sceneLoader";
+import { SPLATFileLoaderMetadata } from "babylonjs-loaders/SPLAT/splatFileLoader.metadata";
 import { AssetContainer } from "babylonjs/assetContainer";
 import { Scene } from "babylonjs/scene";
-const PLUGIN_SPLAT = "splat";
+import { SPLATLoadingOptions } from "babylonjs-loaders/SPLAT/splatLoadingOptions";
 module "babylonjs/Loading/sceneLoader" {
     interface SceneLoaderPluginOptions {
         /**
          * Defines options for the splat loader.
          */
-        [PLUGIN_SPLAT]: {};
+        [SPLATFileLoaderMetadata.name]: Partial<SPLATLoadingOptions>;
     }
 }
 /**
@@ -4138,7 +4232,9 @@ export class SPLATFileLoader implements ISceneLoaderPluginAsync, ISceneLoaderPlu
     /**
      * Defines the name of the plugin.
      */
-    readonly name: string;
+    readonly name: "splat";
+    private _assetContainer;
+    private readonly _loadingOptions;
     /**
      * Defines the extensions the splat loader is able to load.
      * force data to come in as an ArrayBuffer
@@ -4153,21 +4249,15 @@ export class SPLATFileLoader implements ISceneLoaderPluginAsync, ISceneLoaderPlu
     };
     /**
      * Creates loader for gaussian splatting files
+     * @param loadingOptions options for loading and parsing splat and PLY files.
      */
-    constructor();
-    /**
-     * Instantiates a gaussian splatting file loader plugin.
-     * @returns the created plugin
-     */
-    createPlugin(): ISceneLoaderPluginAsync | ISceneLoaderPlugin;
-    /**
-     * If the data string can be loaded directly.
-     * @returns if the data can be loaded directly
-     */
-    canDirectLoad(): boolean;
+    constructor(loadingOptions?: Partial<Readonly<SPLATLoadingOptions>>);
+    private static readonly _DefaultLoadingOptions;
+    /** @internal */
+    createPlugin(options: SceneLoaderPluginOptions): ISceneLoaderPluginAsync;
     /**
      * Imports  from the loaded gaussian splatting data and adds them to the scene
-     * @param _meshesNames a string or array of strings of the mesh names that should be loaded from the file
+     * @param meshesNames a string or array of strings of the mesh names that should be loaded from the file
      * @param scene the scene the meshes should be added to
      * @param data the gaussian splatting data to load
      * @param rootUrl root url to load from
@@ -4175,28 +4265,39 @@ export class SPLATFileLoader implements ISceneLoaderPluginAsync, ISceneLoaderPlu
      * @param fileName Defines the name of the file to load
      * @returns a promise containing the loaded meshes, particles, skeletons and animations
      */
-    importMeshAsync(_meshesNames: any, scene: Scene, data: any, rootUrl: string, onProgress?: (event: ISceneLoaderProgressEvent) => void, fileName?: string): Promise<ISceneLoaderAsyncResult>;
+    importMeshAsync(meshesNames: any, scene: Scene, data: any, rootUrl: string, onProgress?: (event: ISceneLoaderProgressEvent) => void, fileName?: string): Promise<ISceneLoaderAsyncResult>;
+    private static _BuildPointCloud;
+    private static _BuildMesh;
+    private _parse;
     /**
-     * Imports all objects from the loaded gaussian splatting data and adds them to the scene
+     * Load into an asset container.
+     * @param scene The scene to load into
+     * @param data The data to import
+     * @param rootUrl The root url for scene and resources
+     * @returns The loaded asset container
+     */
+    loadAssetContainerAsync(scene: Scene, data: string, rootUrl: string): Promise<AssetContainer>;
+    /**
+     * Imports all objects from the loaded OBJ data and adds them to the scene
      * @param scene the scene the objects should be added to
-     * @param data the gaussian splatting data to load
-     * @param _rootUrl root url to load from
+     * @param data the OBJ data to load
+     * @param rootUrl root url to load from
      * @returns a promise which completes when objects have been loaded to the scene
      */
-    loadAsync(scene: Scene, data: any, _rootUrl: string): Promise<void>;
+    loadAsync(scene: Scene, data: string, rootUrl: string): Promise<void>;
     /**
-     * Load into an asset container.
-     * @param _scene The scene to load into
-     * @param _data The data to import
-     * @param _rootUrl The root url for scene and resources
-     * @returns The loaded asset container
+     * Code from https://github.com/dylanebert/gsplat.js/blob/main/src/loaders/PLYLoader.ts Under MIT license
+     * Converts a .ply data array buffer to splat
+     * if data array buffer is not ply, returns the original buffer
+     * @param data the .ply data to load
+     * @returns the loaded splat buffer
      */
-    loadAssetContainerAsync(_scene: Scene, _data: string, _rootUrl: string): Promise<AssetContainer>;
+    private static _ConvertPLYToSplat;
 }
-export {};
 
 }
 declare module "babylonjs-loaders/SPLAT/index" {
+export * from "babylonjs-loaders/SPLAT/splatLoadingOptions";
 export * from "babylonjs-loaders/SPLAT/splatFileLoader";
 
 }
@@ -4418,20 +4519,27 @@ export type OBJLoadingOptions = {
     useLegacyBehavior: boolean;
 };
 
+}
+declare module "babylonjs-loaders/OBJ/objFileLoader.metadata" {
+export const OBJFileLoaderMetadata: {
+    readonly name: "obj";
+    readonly extensions: ".obj";
+};
+
 }
 declare module "babylonjs-loaders/OBJ/objFileLoader" {
 import { Vector2 } from "babylonjs/Maths/math.vector";
 import { ISceneLoaderPluginAsync, ISceneLoaderPluginFactory, ISceneLoaderPlugin, ISceneLoaderAsyncResult } from "babylonjs/Loading/sceneLoader";
 import { AssetContainer } from "babylonjs/assetContainer";
 import { Scene } from "babylonjs/scene";
+import { OBJFileLoaderMetadata } from "babylonjs-loaders/OBJ/objFileLoader.metadata";
 import { OBJLoadingOptions } from "babylonjs-loaders/OBJ/objLoadingOptions";
-const PLUGIN_OBJ = "obj";
 module "babylonjs/Loading/sceneLoader" {
     interface SceneLoaderPluginOptions {
         /**
          * Defines options for the obj loader.
          */
-        [PLUGIN_OBJ]: {};
+        [OBJFileLoaderMetadata.name]: {};
     }
 }
 /**
@@ -4486,11 +4594,11 @@ export class OBJFileLoader implements ISceneLoaderPluginAsync, ISceneLoaderPlugi
     /**
      * Defines the name of the plugin.
      */
-    readonly name: string;
+    readonly name: "obj";
     /**
      * Defines the extension the plugin is able to load.
      */
-    readonly extensions: string;
+    readonly extensions: ".obj";
     private _assetContainer;
     private _loadingOptions;
     /**
@@ -4559,7 +4667,6 @@ export class OBJFileLoader implements ISceneLoaderPluginAsync, ISceneLoaderPlugi
      */
     private _parseSolid;
 }
-export {};
 
 }
 declare module "babylonjs-loaders/OBJ/mtlFileLoader" {
@@ -4670,6 +4777,13 @@ declare module "babylonjs-loaders" {
 declare module BABYLON {
 
 
+    /**
+     * Registers the async plugin factories for all built-in loaders.
+     * Loaders will be dynamically imported on demand, only when a SceneLoader load operation needs each respective loader.
+     */
+    export function registerBuiltInLoaders(): void;
+
+
 
 
     /**
@@ -4702,7 +4816,21 @@ declare module BABYLON {
     }
 
 
-    const PLUGIN_GLTF = "gltf";
+    export const GLTFMagicBase64Encoded = "Z2xURg";
+    export var GLTFFileLoaderMetadata: {
+        readonly name: "gltf";
+        readonly extensions: {
+            readonly ".gltf": {
+                readonly isBinary: false;
+            };
+            readonly ".glb": {
+                readonly isBinary: true;
+            };
+        };
+        readonly canDirectLoad: (data: string) => boolean;
+    };
+
+
     /**
      * Defines options for glTF loader extensions. This interface is extended by specific extensions.
      */
@@ -4712,7 +4840,7 @@ declare module BABYLON {
             /**
              * Defines options for the glTF loader.
              */
-            [PLUGIN_GLTF]: Partial<GLTFLoaderOptions>;
+            [GLTFFileLoaderMetadata.name]: Partial<GLTFLoaderOptions>;
         }
     /**
      * Mode that determines the coordinate system to use.
@@ -5089,11 +5217,10 @@ declare module BABYLON {
         private _state;
         private _progressCallback?;
         private _requests;
-        private static readonly _MagicBase64Encoded;
         /**
          * Name of the loader ("gltf")
          */
-        readonly name = "gltf";
+        readonly name: "gltf";
         /** @internal */
         readonly extensions: {
             readonly ".gltf": {
@@ -5452,6 +5579,37 @@ declare module BABYLON.GLTF2.Loader {
 
 
 
+}
+declare module BABYLON {
+
+
+}
+declare module BABYLON.GLTF2 {
+        interface IRegisteredGLTFExtension {
+        isGLTFExtension: boolean;
+        factory: GLTFExtensionFactory;
+    }
+    export type GLTFExtensionFactory = (loader: BABYLON.GLTF2.GLTFLoader) => BABYLON.GLTF2.IGLTFLoaderExtension | Promise<BABYLON.GLTF2.IGLTFLoaderExtension>;
+    /**
+     * All currently registered glTF 2.0 loader extensions.
+     */
+    export var registeredGLTFExtensions: ReadonlyMap<string, Readonly<IRegisteredGLTFExtension>>;
+    /**
+     * Registers a loader extension.
+     * @param name The name of the loader extension.
+     * @param isGLTFExtension If the loader extension is a glTF extension, then it will only be used for glTF files that use the corresponding glTF extension. Otherwise, it will be used for all loaded glTF files.
+     * @param factory The factory function that creates the loader extension.
+     */
+    export function registerGLTFExtension(name: string, isGLTFExtension: boolean, factory: GLTFExtensionFactory): void;
+    /**
+     * Unregisters a loader extension.
+     * @param name The name of the loader extension.
+     * @returns A boolean indicating whether the extension has been unregistered
+     */
+    export function unregisterGLTFExtension(name: string): boolean;
+
+
+
 }
 declare module BABYLON {
 
@@ -5724,7 +5882,6 @@ declare module BABYLON.GLTF2 {
         private _rootBabylonMesh;
         private _defaultBabylonMaterialData;
         private readonly _postSceneLoadActions;
-        private static _RegisteredExtensions;
         /**
          * The default glTF sampler.
          */
@@ -5733,12 +5890,14 @@ declare module BABYLON.GLTF2 {
          * Registers a loader extension.
          * @param name The name of the loader extension.
          * @param factory The factory function that creates the loader extension.
+         * @deprecated Please use registerGLTFExtension instead.
          */
-        static RegisterExtension(name: string, factory: (loader: GLTFLoader) => BABYLON.GLTF2.IGLTFLoaderExtension): void;
+        static RegisterExtension(name: string, factory: BABYLON.GLTF2.GLTFExtensionFactory): void;
         /**
          * Unregisters a loader extension.
          * @param name The name of the loader extension.
          * @returns A boolean indicating whether the extension has been unregistered
+         * @deprecated Please use unregisterGLTFExtension instead.
          */
         static UnregisterExtension(name: string): boolean;
         /**
@@ -5782,8 +5941,7 @@ declare module BABYLON.GLTF2 {
         private _loadAsync;
         private _loadData;
         private _setupData;
-        private _loadExtensions;
-        private _checkExtensions;
+        private _loadExtensionsAsync;
         private _createRootNode;
         /**
          * Loads a glTF scene.
@@ -6158,6 +6316,19 @@ declare module BABYLON.GLTF2.Loader.Extensions {
 
 
 
+}
+declare module BABYLON {
+
+
+}
+declare module BABYLON.GLTF2.Loader.Extensions {
+        /**
+     * Registers the built-in glTF 2.0 extension async factories, which dynamically imports and loads each glTF extension on demand (e.g. only when a glTF model uses the extension).
+     */
+    export function registerBuiltInGLTFExtensions(): void;
+
+
+
 }
 declare module BABYLON {
 
@@ -8567,12 +8738,21 @@ declare module BABYLON.GLTF1 {
 }
 declare module BABYLON {
 
-    const PLUGIN_STL = "stl";
+    export var STLFileLoaderMetadata: {
+        readonly name: "stl";
+        readonly extensions: {
+            readonly ".stl": {
+                readonly isBinary: true;
+            };
+        };
+    };
+
+
         interface SceneLoaderPluginOptions {
             /**
              * Defines options for the stl loader.
              */
-            [PLUGIN_STL]: {};
+            [STLFileLoaderMetadata.name]: {};
         }
     /**
      * STL file type loader.
@@ -8590,7 +8770,7 @@ declare module BABYLON {
         /**
          * Defines the name of the plugin.
          */
-        readonly name = "stl";
+        readonly name: "stl";
         /**
          * Defines the extensions the stl loader is able to load.
          * force data to come in as an ArrayBuffer
@@ -8641,12 +8821,35 @@ declare module BABYLON {
 
 
 
-    const PLUGIN_SPLAT = "splat";
+    /**
+     * Options for loading Gaussian Splatting and PLY files
+     */
+    export type SPLATLoadingOptions = {
+        /**
+         * Defines if buffers should be kept in memory for editing purposes
+         */
+        keepInRam?: boolean;
+    };
+
+
+    export var SPLATFileLoaderMetadata: {
+        readonly name: "splat";
+        readonly extensions: {
+            readonly ".splat": {
+                readonly isBinary: true;
+            };
+            readonly ".ply": {
+                readonly isBinary: true;
+            };
+        };
+    };
+
+
         interface SceneLoaderPluginOptions {
             /**
              * Defines options for the splat loader.
              */
-            [PLUGIN_SPLAT]: {};
+            [SPLATFileLoaderMetadata.name]: Partial<SPLATLoadingOptions>;
         }
     /**
      * @experimental
@@ -8657,7 +8860,9 @@ declare module BABYLON {
         /**
          * Defines the name of the plugin.
          */
-        readonly name = "splat";
+        readonly name: "splat";
+        private _assetContainer;
+        private readonly _loadingOptions;
         /**
          * Defines the extensions the splat loader is able to load.
          * force data to come in as an ArrayBuffer
@@ -8672,21 +8877,15 @@ declare module BABYLON {
         };
         /**
          * Creates loader for gaussian splatting files
+         * @param loadingOptions options for loading and parsing splat and PLY files.
          */
-        constructor();
-        /**
-         * Instantiates a gaussian splatting file loader plugin.
-         * @returns the created plugin
-         */
-        createPlugin(): ISceneLoaderPluginAsync | ISceneLoaderPlugin;
-        /**
-         * If the data string can be loaded directly.
-         * @returns if the data can be loaded directly
-         */
-        canDirectLoad(): boolean;
+        constructor(loadingOptions?: Partial<Readonly<SPLATLoadingOptions>>);
+        private static readonly _DefaultLoadingOptions;
+        /** @internal */
+        createPlugin(options: SceneLoaderPluginOptions): ISceneLoaderPluginAsync;
         /**
          * Imports  from the loaded gaussian splatting data and adds them to the scene
-         * @param _meshesNames a string or array of strings of the mesh names that should be loaded from the file
+         * @param meshesNames a string or array of strings of the mesh names that should be loaded from the file
          * @param scene the scene the meshes should be added to
          * @param data the gaussian splatting data to load
          * @param rootUrl root url to load from
@@ -8694,23 +8893,34 @@ declare module BABYLON {
          * @param fileName Defines the name of the file to load
          * @returns a promise containing the loaded meshes, particles, skeletons and animations
          */
-        importMeshAsync(_meshesNames: any, scene: Scene, data: any, rootUrl: string, onProgress?: (event: ISceneLoaderProgressEvent) => void, fileName?: string): Promise<ISceneLoaderAsyncResult>;
+        importMeshAsync(meshesNames: any, scene: Scene, data: any, rootUrl: string, onProgress?: (event: ISceneLoaderProgressEvent) => void, fileName?: string): Promise<ISceneLoaderAsyncResult>;
+        private static _BuildPointCloud;
+        private static _BuildMesh;
+        private _parse;
         /**
-         * Imports all objects from the loaded gaussian splatting data and adds them to the scene
+         * Load into an asset container.
+         * @param scene The scene to load into
+         * @param data The data to import
+         * @param rootUrl The root url for scene and resources
+         * @returns The loaded asset container
+         */
+        loadAssetContainerAsync(scene: Scene, data: string, rootUrl: string): Promise<AssetContainer>;
+        /**
+         * Imports all objects from the loaded OBJ data and adds them to the scene
          * @param scene the scene the objects should be added to
-         * @param data the gaussian splatting data to load
-         * @param _rootUrl root url to load from
+         * @param data the OBJ data to load
+         * @param rootUrl root url to load from
          * @returns a promise which completes when objects have been loaded to the scene
          */
-        loadAsync(scene: Scene, data: any, _rootUrl: string): Promise<void>;
+        loadAsync(scene: Scene, data: string, rootUrl: string): Promise<void>;
         /**
-         * Load into an asset container.
-         * @param _scene The scene to load into
-         * @param _data The data to import
-         * @param _rootUrl The root url for scene and resources
-         * @returns The loaded asset container
+         * Code from https://github.com/dylanebert/gsplat.js/blob/main/src/loaders/PLYLoader.ts Under MIT license
+         * Converts a .ply data array buffer to splat
+         * if data array buffer is not ply, returns the original buffer
+         * @param data the .ply data to load
+         * @returns the loaded splat buffer
          */
-        loadAssetContainerAsync(_scene: Scene, _data: string, _rootUrl: string): Promise<AssetContainer>;
+        private static _ConvertPLYToSplat;
     }
 
 
@@ -8927,12 +9137,17 @@ declare module BABYLON {
     };
 
 
-    const PLUGIN_OBJ = "obj";
+    export var OBJFileLoaderMetadata: {
+        readonly name: "obj";
+        readonly extensions: ".obj";
+    };
+
+
         interface SceneLoaderPluginOptions {
             /**
              * Defines options for the obj loader.
              */
-            [PLUGIN_OBJ]: {};
+            [OBJFileLoaderMetadata.name]: {};
         }
     /**
      * OBJ file type loader.
@@ -8986,11 +9201,11 @@ declare module BABYLON {
         /**
          * Defines the name of the plugin.
          */
-        readonly name = "obj";
+        readonly name: "obj";
         /**
          * Defines the extension the plugin is able to load.
          */
-        readonly extensions = ".obj";
+        readonly extensions: ".obj";
         private _assetContainer;
         private _loadingOptions;
         /**