babylonjs-addons 9.14.0 → 9.16.0

package/babylonjs.addons.module.d.ts

@@ -2711,8 +2711,6 @@ import { MaterialPluginBase } from "babylonjs/Materials/materialPluginBase.pure"
 import { Nullable } from "babylonjs/types";
 import { UniformBuffer } from "babylonjs/Materials/uniformBuffer";
 import { ShaderLanguage } from "babylonjs/Materials/shaderLanguage";
-import "babylonjs-addons/atmosphere/ShadersWGSL/ShadersInclude/atmosphereFunctions";
-import "babylonjs-addons/atmosphere/ShadersWGSL/ShadersInclude/atmosphereUboDeclaration";
 class AtmospherePBRMaterialDefines extends MaterialDefines {
     USE_CUSTOM_REFLECTION: boolean;
     USE_AERIAL_PERSPECTIVE_LUT: boolean;
@@ -2763,6 +2761,33 @@ export class AtmospherePBRMaterialPlugin extends MaterialPluginBase {
      * @override
      */
     isReadyForSubMesh(): boolean;
+    /**
+     * Ensures the shader includes for this material's shader language are registered, kicking off a lazy
+     * load if needed. Registration from a previously created material (or an explicit preload) is detected
+     * synchronously via the ShaderStore, so only the very first atmosphere material can incur a load delay.
+     * @returns True when the includes are registered and the plugin can proceed.
+     */
+    private _ensureShaderIncludesLoaded;
+    /**
+     * Fire-and-forget load of the shader includes used from isReadyForSubMesh. Backs off after a failure and
+     * logs so a missing registration doesn't silently stall rendering forever; a retry still recovers from
+     * transient failures such as a dropped network request.
+     * @param shaderLanguage - The shader language whose includes to load.
+     * @param state - The shared load state for that language.
+     */
+    private _tryLoadShaderIncludesAsync;
+    /**
+     * Preloads (and registers into the ShaderStore) the atmosphere shader includes for the given shader
+     * language, ahead of creating any atmosphere-enabled material. Await this before creating meshes when
+     * they must render in their creation frame with zero delay. Safe to call multiple times; concurrent
+     * calls coalesce onto a single load.
+     *
+     * As an alternative, `Material.forceCompilationAsync(mesh)` (or `Scene.whenReadyAsync`) also awaits the
+     * includes, because readiness is gated through `isReadyForSubMesh`.
+     * @param shaderLanguage - The shader language to preload includes for (defaults to GLSL). Pass `ShaderLanguage.WGSL` for WebGPU.
+     * @returns A promise that resolves once the includes are registered.
+     */
+    static PreloadShaderIncludesAsync(shaderLanguage?: ShaderLanguage): Promise<void>;
     /**
      * @override
      */
@@ -3215,6 +3240,22 @@ export class Atmosphere implements IDisposable {
      * @param options - The options used to create the atmosphere.
      */
     constructor(name: string, scene: Scene, lights: DirectionalLight[], options?: IAtmosphereOptions);
+    /**
+     * Fire-and-forget wrapper around {@link preloadMaterialPluginShaderIncludesAsync} used during construction.
+     * Swallows failures so a rejected preload does not surface as an unhandled promise rejection; the plugin's
+     * `isReadyForSubMesh` already retries and logs on failure.
+     * @returns A promise that always resolves.
+     */
+    private _eagerlyPreloadMaterialPluginShaderIncludesAsync;
+    /**
+     * Preloads the shader includes used by the atmosphere PBR material plugin so that atmosphere-enabled
+     * materials can render in their creation frame with no delay. The plugin registers these includes lazily
+     * (to keep the module tree-shakeable), so without a preload the very first atmosphere material may skip a
+     * frame while they load. Await this before creating meshes that must render immediately. Safe to call
+     * multiple times.
+     * @returns A promise that resolves once the includes are registered.
+     */
+    preloadMaterialPluginShaderIncludesAsync(): Promise<void>;
     /**
      * @override
      */
@@ -6084,6 +6125,33 @@ declare namespace ADDONS {
          * @override
          */
         isReadyForSubMesh(): boolean;
+        /**
+         * Ensures the shader includes for this material's shader language are registered, kicking off a lazy
+         * load if needed. Registration from a previously created material (or an explicit preload) is detected
+         * synchronously via the ShaderStore, so only the very first atmosphere material can incur a load delay.
+         * @returns True when the includes are registered and the plugin can proceed.
+         */
+        private _ensureShaderIncludesLoaded;
+        /**
+         * Fire-and-forget load of the shader includes used from isReadyForSubMesh. Backs off after a failure and
+         * logs so a missing registration doesn't silently stall rendering forever; a retry still recovers from
+         * transient failures such as a dropped network request.
+         * @param shaderLanguage - The shader language whose includes to load.
+         * @param state - The shared load state for that language.
+         */
+        private _tryLoadShaderIncludesAsync;
+        /**
+         * Preloads (and registers into the ShaderStore) the atmosphere shader includes for the given shader
+         * language, ahead of creating any atmosphere-enabled material. Await this before creating meshes when
+         * they must render in their creation frame with zero delay. Safe to call multiple times; concurrent
+         * calls coalesce onto a single load.
+         *
+         * As an alternative, `Material.forceCompilationAsync(mesh)` (or `Scene.whenReadyAsync`) also awaits the
+         * includes, because readiness is gated through `isReadyForSubMesh`.
+         * @param shaderLanguage - The shader language to preload includes for (defaults to GLSL). Pass `ShaderLanguage.WGSL` for WebGPU.
+         * @returns A promise that resolves once the includes are registered.
+         */
+        static PreloadShaderIncludesAsync(shaderLanguage?: BABYLON.ShaderLanguage): Promise<void>;
         /**
          * @override
          */
@@ -6514,6 +6582,22 @@ declare namespace ADDONS {
          * @param options - The options used to create the atmosphere.
          */
         constructor(name: string, scene: BABYLON.Scene, lights: BABYLON.DirectionalLight[], options?: IAtmosphereOptions);
+        /**
+         * Fire-and-forget wrapper around {@link preloadMaterialPluginShaderIncludesAsync} used during construction.
+         * Swallows failures so a rejected preload does not surface as an unhandled promise rejection; the plugin's
+         * `isReadyForSubMesh` already retries and logs on failure.
+         * @returns A promise that always resolves.
+         */
+        private _eagerlyPreloadMaterialPluginShaderIncludesAsync;
+        /**
+         * Preloads the shader includes used by the atmosphere PBR material plugin so that atmosphere-enabled
+         * materials can render in their creation frame with no delay. The plugin registers these includes lazily
+         * (to keep the module tree-shakeable), so without a preload the very first atmosphere material may skip a
+         * frame while they load. Await this before creating meshes that must render immediately. Safe to call
+         * multiple times.
+         * @returns A promise that resolves once the includes are registered.
+         */
+        preloadMaterialPluginShaderIncludesAsync(): Promise<void>;
         /**
          * @override
          */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "babylonjs-addons",
-    "version": "9.14.0",
+    "version": "9.16.0",
     "main": "babylonjs.addons.min.js",
     "types": "babylonjs.addons.module.d.ts",
     "files": [
@@ -16,7 +16,7 @@
         "test:escheck": "es-check es6 ./babylonjs.addons.js"
     },
     "dependencies": {
-        "babylonjs": "9.14.0"
+        "babylonjs": "9.16.0"
     },
     "devDependencies": {
         "@dev/addons": "1.0.0",

package/tsconfig.build.json

@@ -3,8 +3,7 @@
 
     "compilerOptions": {
         "outDir": "./dist",
-        "target": "ES5",
-        "ignoreDeprecations": "6.0",
+        "target": "es2015",
         "rootDir": "../../../",
         "declaration": false,
         "importHelpers": true,