babylonjs-loaders 9.7.0 → 9.8.0

package/babylonjs.loaders.d.ts

@@ -638,6 +638,11 @@ declare namespace BABYLON.GLTF2 {
          * Gets the underlying material
          */
         get material(): PBRMaterial;
+        /**
+         * No-op: PBRMaterial has no deferred finalization.
+         * @param _loader Unused.
+         */
+        finalizeAsync(_loader: BABYLON.GLTF2.GLTFLoader): Promise<void>;
         /**
          * Whether the material should be treated as unlit
          */
@@ -2053,10 +2058,9 @@ declare namespace BABYLON.GLTF2 {
         set geometryCoatNormalTextureScale(value: number);
         /**
          * Finalizes material properties after all loading is complete.
-         * @param signal An AbortSignal that fires when the loader is disposed. Intermediate
-         *   textures are disposed and the method returns early when aborted.
+         * @param loader The glTF loader; `loader._disposed` is polled between texture passes to bail early on dispose.
          */
-        finalizeAsync(signal: AbortSignal): Promise<void>;
+        finalizeAsync(loader: BABYLON.GLTF2.GLTFLoader): Promise<void>;
         private copySurfaceToCoatAsync;
     }
 
@@ -2077,20 +2081,17 @@ declare namespace BABYLON.GLTF2 {
          * Gets the underlying material
          */
         readonly material: Material;
-        /** @deprecated Use finalizeAsync instead. */
-        finalize?(): void;
         /**
          * Finalizes material properties after all loading is complete.
-         * May return a Promise for async work (e.g. GPU texture processing). Any returned
-         * Promise is tracked by the loader and awaited before the COMPLETE state is reached,
-         * so callers can rely on onCompleteObservable for fully processed materials.
+         * May do async work (e.g. GPU texture processing); the returned Promise is tracked
+         * by the loader and awaited before the COMPLETE state is reached, so callers can rely
+         * on onCompleteObservable for fully processed materials.
          *
-         * The loader passes an AbortSignal that is aborted when the loader is disposed.
-         * Implementations should check `signal.aborted` after each await point and, if
-         * aborted, release any intermediate resources and return early.
-         * @param signal An AbortSignal that fires when the loader is disposed mid-flight.
+         * Implementations should check `loader._disposed` between awaits to bail out early
+         * when the loader is disposed mid-flight.
+         * @param loader The glTF loader driving the finalize step.
          */
-        finalizeAsync?(signal: AbortSignal): Promise<void> | void;
+        finalizeAsync(loader: BABYLON.GLTF2.GLTFLoader): Promise<void>;
         /**
          * Whether the material should be treated as unlit
          */
@@ -3025,8 +3026,6 @@ declare namespace BABYLON.GLTF2 {
     export class GLTFLoader implements IGLTFLoader {
         /** @internal */
         readonly _completePromises: Promise<unknown>[];
-        /** AbortController used to cancel in-flight finalizeAsync() calls when dispose() is called. */
-        private _finalizeController;
         /** @internal */
         _assetContainer: Nullable<AssetContainer>;
         /** Storage */
@@ -3039,7 +3038,8 @@ declare namespace BABYLON.GLTF2 {
         _skipStartAnimationStep: boolean;
         private readonly _parent;
         private readonly _extensions;
-        private _disposed;
+        /** @internal */
+        _disposed: boolean;
         private _rootUrl;
         private _fileName;
         private _uniqueRootUrl;