@onerjs/core 8.46.1 → 8.46.3

package/Engines/engine.d.ts

@@ -1808,7 +1808,11 @@ interface GPUSupportedLimits {
     readonly maxSampledTexturesPerShaderStage: number;
     readonly maxSamplersPerShaderStage: number;
     readonly maxStorageBuffersPerShaderStage: number;
+    readonly maxStorageBuffersInVertexStage: number;
+    readonly maxStorageBuffersInFragmentStage: number;
     readonly maxStorageTexturesPerShaderStage: number;
+    readonly maxStorageTexturesInVertexStage: number;
+    readonly maxStorageTexturesInFragmentStage: number;
     readonly maxUniformBuffersPerShaderStage: number;
     readonly maxUniformBufferBindingSize: number;
     readonly maxStorageBufferBindingSize: number;
@@ -1852,7 +1856,7 @@ interface WorkerNavigator {
 }
 
 class GPU {
-    requestAdapter(options?: GPURequestAdapterOptions): Promise<GPUAdapter | undefined>;
+    requestAdapter(options?: GPURequestAdapterOptions): Promise<GPUAdapter | null>;
     getPreferredCanvasFormat(): GPUTextureFormat;
 
     readonly wgslLanguageFeatures: WGSLLanguageFeatures;
@@ -1868,8 +1872,6 @@ interface GPURequestAdapterOptions {
 type GPUPowerPreference = "low-power" | "high-performance";
 
 class GPUAdapter {
-    // https://michalzalecki.com/nominal-typing-in-typescript/#approach-1-class-with-a-private-property
-    readonly name: string;
     readonly features: GPUSupportedFeatures;
     readonly limits: GPUSupportedLimits;
     readonly info: GPUAdapterInfo;
@@ -1903,7 +1905,9 @@ type GPUFeatureName =
     | "dual-source-blending"
     | "subgroups"
     | "texture-formats-tier1"
-    | "texture-formats-tier2";
+    | "texture-formats-tier2"
+    | "primitive-index"
+    | "texture-component-swizzle";
 
 class GPUDevice extends EventTarget implements GPUObjectBase {
     label: string | undefined;
@@ -1941,8 +1945,8 @@ class GPUDevice extends EventTarget implements GPUObjectBase {
 
     readonly lost: Promise<GPUDeviceLostInfo>;
     pushErrorScope(filter: GPUErrorFilter): void;
-    popErrorScope(): Promise<GPUError | undefined>;
-    onuncapturederror: Event | undefined;
+    popErrorScope(): Promise<GPUError | null>;
+    onuncapturederror: ((this: GPUDevice, ev: GPUUncapturedErrorEvent) => any) | null;
 }
 
 class GPUBuffer implements GPUObjectBase {
@@ -1965,7 +1969,7 @@ type GPUBufferMapState = "unmapped" | "pending" | "mapped";
 interface GPUBufferDescriptor extends GPUObjectDescriptorBase {
     size: GPUSize64;
     usage: GPUBufferUsageFlags;
-    mappedAtCreation: boolean /* default=false */;
+    mappedAtCreation?: boolean /* default=false */;
 }
 
 type GPUBufferUsageFlags = number;
@@ -1997,6 +2001,7 @@ interface GPUTextureDescriptor extends GPUObjectDescriptorBase {
     format: GPUTextureFormat;
     usage: GPUTextureUsageFlags;
     viewFormats?: GPUTextureFormat[] /* default=[] */;
+    textureBindingViewDimension?: GPUTextureViewDimension;
 }
 
 type GPUTextureDimension = "1d" | "2d" | "3d";
@@ -2008,14 +2013,15 @@ class GPUTextureView implements GPUObjectBase {
 }
 
 interface GPUTextureViewDescriptor extends GPUObjectDescriptorBase {
-    format: GPUTextureFormat;
-    dimension: GPUTextureViewDimension;
+    format?: GPUTextureFormat;
+    dimension?: GPUTextureViewDimension;
     usage?: GPUTextureUsageFlags /* default=0 */;
     aspect?: GPUTextureAspect /* default="all" */;
     baseMipLevel?: GPUIntegerCoordinate /* default=0 */;
-    mipLevelCount: GPUIntegerCoordinate;
+    mipLevelCount?: GPUIntegerCoordinate;
     baseArrayLayer?: GPUIntegerCoordinate /* default=0*/;
-    arrayLayerCount: GPUIntegerCoordinate;
+    arrayLayerCount?: GPUIntegerCoordinate;
+    swizzle?: string /* default="rgba" */;
 }
 
 type GPUTextureViewDimension = "1d" | "2d" | "2d-array" | "cube" | "cube-array" | "3d";
@@ -2272,13 +2278,13 @@ class GPUShaderModule implements GPUObjectBase {
 }
 
 interface GPUShaderModuleDescriptor extends GPUObjectDescriptorBase {
-    code: string | Uint32Array;
+    code: string;
     compilationHints?: GPUShaderModuleCompilationHint[] /* default=[] */;
 }
 
 interface GPUShaderModuleCompilationHint {
-    entryPoint: string | Uint32Array;
-    layout: GPUPipelineLayout | GPUAutoLayoutMode;
+    entryPoint: string;
+    layout?: GPUPipelineLayout | GPUAutoLayoutMode;
 }
 
 type GPUCompilationMessageType = "error" | "warning" | "info";
@@ -2319,7 +2325,7 @@ interface GPUPipelineBase {
 
 interface GPUProgrammableStage {
     module: GPUShaderModule;
-    entryPoint: string | Uint32Array;
+    entryPoint?: string;
     constants?: { [name: string]: GPUPipelineConstantValue } /* default={} */;
 }
 
@@ -2507,7 +2513,7 @@ interface GPUVertexAttribute {
 
 interface GPUTexelCopyBufferLayout {
     offset?: GPUSize64 /* default=0 */;
-    bytesPerRow: GPUSize32;
+    bytesPerRow?: GPUSize32;
     rowsPerImage?: GPUSize32;
 }
 
@@ -2549,22 +2555,20 @@ class GPUCommandEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebugComm
     beginRenderPass(descriptor: GPURenderPassDescriptor): GPURenderPassEncoder;
     beginComputePass(descriptor?: GPUComputePassDescriptor): GPUComputePassEncoder;
 
-    copyBufferToBuffer(source: GPUBuffer, destination: GPUBuffer, size: GPUSize64): void;
-    copyBufferToBuffer(source: GPUBuffer, sourceOffset: GPUSize64, destination: GPUBuffer, destinationOffset: GPUSize64, size: GPUSize64): void;
+    copyBufferToBuffer(source: GPUBuffer, destination: GPUBuffer, size?: GPUSize64): void;
+    copyBufferToBuffer(source: GPUBuffer, sourceOffset: GPUSize64, destination: GPUBuffer, destinationOffset: GPUSize64, size?: GPUSize64): void;
     copyBufferToTexture(source: GPUTexelCopyBufferInfo, destination: GPUTexelCopyTextureInfo, copySize: GPUExtent3D): void;
     copyTextureToBuffer(source: GPUTexelCopyTextureInfo, destination: GPUTexelCopyBufferInfo, copySize: GPUExtent3D): void;
     copyTextureToTexture(source: GPUTexelCopyTextureInfo, destination: GPUTexelCopyTextureInfo, copySize: GPUExtent3D): void;
     clearBuffer(buffer: GPUBuffer, offset?: GPUSize64 /* default=0 */, size?: GPUSize64): void;
 
-    writeTimestamp?(querySet: GPUQuerySet, queryIndex: GPUSize32): void; // not in the spec anymore, but may come back later, so keep it here for now
-
     resolveQuerySet(querySet: GPUQuerySet, firstQuery: GPUSize32, queryCount: GPUSize32, destination: GPUBuffer, destinationOffset: GPUSize64): void;
 
     finish(descriptor?: GPUCommandBufferDescriptor): GPUCommandBuffer;
 
-    pushDebugGroup(groupLabel: string): void;
+    pushDebugGroup(grouplabel: string | undefined): void;
     popDebugGroup(): void;
-    insertDebugMarker(markerLabel: string): void;
+    insertDebugMarker(markerlabel: string | undefined): void;
 }
 
 interface GPUCommandEncoderDescriptor extends GPUObjectDescriptorBase {}
@@ -2575,9 +2579,9 @@ interface GPUBindingCommandsMixin {
 }
 
 interface GPUDebugCommandsMixin {
-    pushDebugGroup(groupLabel: string): void;
+    pushDebugGroup(grouplabel: string | undefined): void;
     popDebugGroup(): void;
-    insertDebugMarker(markerLabel: string): void;
+    insertDebugMarker(markerlabel: string | undefined): void;
 }
 
 class GPUComputePassEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebugCommandsMixin, GPUBindingCommandsMixin {
@@ -2586,9 +2590,9 @@ class GPUComputePassEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebug
     setBindGroup(index: number, bindGroup: GPUBindGroup | null, dynamicOffsets?: GPUBufferDynamicOffset[]): void;
     setBindGroup(index: GPUIndex32, bindGroup: GPUBindGroup | null, dynamicOffsetData: Uint32Array, dynamicOffsetsDataStart: GPUSize64, dynamicOffsetsDataLength: GPUSize32): void;
 
-    pushDebugGroup(groupLabel: string): void;
+    pushDebugGroup(grouplabel: string | undefined): void;
     popDebugGroup(): void;
-    insertDebugMarker(markerLabel: string): void;
+    insertDebugMarker(markerlabel: string | undefined): void;
 
     setPipeline(pipeline: GPUComputePipeline): void;
     dispatchWorkgroups(workgroupCountX: GPUSize32, workgroupCountY?: GPUSize32 /* default=1 */, workgroupCountZ?: GPUSize32 /* default=1 */): void;
@@ -2599,8 +2603,8 @@ class GPUComputePassEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebug
 
 interface GPUComputePassTimestampWrites {
     querySet: GPUQuerySet;
-    beginningOfPassWriteIndex: GPUSize32;
-    endOfPassWriteIndex: GPUSize32;
+    beginningOfPassWriteIndex?: GPUSize32;
+    endOfPassWriteIndex?: GPUSize32;
 }
 
 interface GPUComputePassDescriptor extends GPUObjectDescriptorBase {
@@ -2613,14 +2617,14 @@ class GPURenderPassEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebugC
     setBindGroup(index: GPUIndex32, bindGroup: GPUBindGroup | null, dynamicOffsets?: GPUBufferDynamicOffset[]): void;
     setBindGroup(index: GPUIndex32, bindGroup: GPUBindGroup | null, dynamicOffsetData: Uint32Array, dynamicOffsetsDataStart: GPUSize64, dynamicOffsetsDataLength: GPUSize32): void;
 
-    pushDebugGroup(groupLabel: string): void;
+    pushDebugGroup(grouplabel: string | undefined): void;
     popDebugGroup(): void;
-    insertDebugMarker(markerLabel: string): void;
+    insertDebugMarker(markerlabel: string | undefined): void;
 
     setPipeline(pipeline: GPURenderPipeline): void;
 
     setIndexBuffer(buffer: GPUBuffer, indexFormat: GPUIndexFormat, offset?: GPUSize64 /* default=0 */, size?: GPUSize64 /* default=0 */): void;
-    setVertexBuffer(slot: GPUIndex32, buffer?: GPUBuffer, offset?: GPUSize64 /* default=0 */, size?: GPUSize64 /* default=0 */): void;
+    setVertexBuffer(slot: GPUIndex32, buffer: GPUBuffer | null, offset?: GPUSize64 /* default=0 */, size?: GPUSize64 /* default=0 */): void;
 
     draw(vertexCount: GPUSize32, instanceCount?: GPUSize32 /* default=1 */, firstVertex?: GPUSize32 /* default=0 */, firstInstance?: GPUSize32 /* default=0 */): void;
     drawIndexed(
@@ -2650,8 +2654,8 @@ class GPURenderPassEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebugC
 
 interface GPURenderPassTimestampWrites {
     querySet: GPUQuerySet;
-    beginningOfPassWriteIndex: GPUSize32;
-    endOfPassWriteIndex: GPUSize32;
+    beginningOfPassWriteIndex?: GPUSize32;
+    endOfPassWriteIndex?: GPUSize32;
 }
 
 interface GPURenderPassDescriptor extends GPUObjectDescriptorBase {
@@ -2700,7 +2704,7 @@ interface GPURenderCommandsMixin {
     setPipeline(pipeline: GPURenderPipeline): void;
 
     setIndexBuffer(buffer: GPUBuffer, indexFormat: GPUIndexFormat, offset?: GPUSize64 /* default=0 */, size?: GPUSize64 /* default=0 */): void;
-    setVertexBuffer(slot: GPUIndex32, buffer?: GPUBuffer, offset?: GPUSize64 /* default=0 */, size?: GPUSize64): void;
+    setVertexBuffer(slot: GPUIndex32, buffer: GPUBuffer | null, offset?: GPUSize64 /* default=0 */, size?: GPUSize64): void;
 
     draw(vertexCount: GPUSize32, instanceCount?: GPUSize32 /* default=1 */, firstVertex?: GPUSize32 /* default=0 */, firstInstance?: GPUSize32 /* default=0 */): void;
     drawIndexed(
@@ -2727,14 +2731,14 @@ class GPURenderBundleEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebu
     setBindGroup(index: GPUIndex32, bindGroup: GPUBindGroup | null, dynamicOffsets?: GPUBufferDynamicOffset[]): void;
     setBindGroup(index: GPUIndex32, bindGroup: GPUBindGroup | null, dynamicOffsetData: Uint32Array, dynamicOffsetsDataStart: GPUSize64, dynamicOffsetsDataLength: GPUSize32): void;
 
-    pushDebugGroup(groupLabel: string): void;
+    pushDebugGroup(grouplabel: string | undefined): void;
     popDebugGroup(): void;
-    insertDebugMarker(markerLabel: string): void;
+    insertDebugMarker(markerlabel: string | undefined): void;
 
     setPipeline(pipeline: GPURenderPipeline): void;
 
     setIndexBuffer(buffer: GPUBuffer, indexFormat: GPUIndexFormat, offset?: GPUSize64 /* default=0 */, size?: GPUSize64 /* default=0 */): void;
-    setVertexBuffer(slot: GPUIndex32, buffer?: GPUBuffer, offset?: GPUSize64 /* default=0 */, size?: GPUSize64 /* default=0 */): void;
+    setVertexBuffer(slot: GPUIndex32, buffer: GPUBuffer | null, offset?: GPUSize64 /* default=0 */, size?: GPUSize64 /* default=0 */): void;
 
     draw(vertexCount: GPUSize32, instanceCount?: GPUSize32 /* default=1 */, firstVertex?: GPUSize32 /* default=0 */, firstInstance?: GPUSize32 /* default=0 */): void;
     drawIndexed(
@@ -2791,10 +2795,10 @@ type GPUQueryType = "occlusion" | "timestamp";
 class GPUCanvasContext {
     readonly canvas: HTMLCanvasElement | OffscreenCanvas;
 
-    configure(configuration?: GPUCanvasConfiguration): void;
+    configure(configuration: GPUCanvasConfiguration): void;
     unconfigure(): void;
 
-    getConfiguration(): GPUCanvasConfiguration | undefined;
+    getConfiguration(): GPUCanvasConfiguration | null;
     getCurrentTexture(): GPUTexture;
 }
 
@@ -2803,7 +2807,7 @@ type GPUCanvasAlphaMode = "opaque" | "premultiplied";
 type GPUCanvasToneMappingMode = "standard" | "extended";
 
 interface GPUCanvasToneMapping {
-    mode?: GPUCanvasToneMappingMode /* dfault="standard" */;
+    mode?: GPUCanvasToneMappingMode /* default="standard" */;
 }
 
 interface GPUCanvasConfiguration extends GPUObjectDescriptorBase {
@@ -2819,7 +2823,7 @@ interface GPUCanvasConfiguration extends GPUObjectDescriptorBase {
 type GPUDeviceLostReason = "unknown" | "destroyed";
 
 class GPUDeviceLostInfo {
-    readonly reason?: GPUDeviceLostReason;
+    readonly reason: GPUDeviceLostReason;
     readonly message: string;
 }
 

package/Engines/shaderStore.js

@@ -30,7 +30,7 @@ export class ShaderStore {
 /**
  * Gets or sets the relative url used to load shaders if using the engine in non-minified mode
  */
-ShaderStore.ShadersRepository = "../Shaders/";
+ShaderStore.ShadersRepository = "src/Shaders/";
 /**
  * Store of each shader (The can be looked up using effect.key)
  */
@@ -42,7 +42,7 @@ ShaderStore.IncludesShadersStore = {};
 /**
  * Gets or sets the relative url used to load shaders (WGSL) if using the engine in non-minified mode
  */
-ShaderStore.ShadersRepositoryWGSL = "../ShadersWGSL/";
+ShaderStore.ShadersRepositoryWGSL = "src/ShadersWGSL/";
 /**
  * Store of each shader  (WGSL)
  */

package/Engines/shaderStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"shaderStore.js","sourceRoot":"","sources":["../../../../dev/core/src/Engines/shaderStore.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,WAAW;IA2BpB;;;;OAIG;IACI,MAAM,CAAC,oBAAoB,CAAC,cAAc,8BAAsB;QACnE,OAAO,cAAc,gCAAwB,CAAC,CAAC,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC,WAAW,CAAC,qBAAqB,CAAC;IACtH,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,eAAe,CAAC,cAAc,8BAAsB;QAC9D,OAAO,cAAc,gCAAwB,CAAC,CAAC,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC;IAC5G,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,uBAAuB,CAAC,cAAc,8BAAsB;QACtE,OAAO,cAAc,gCAAwB,CAAC,CAAC,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAAC,WAAW,CAAC,wBAAwB,CAAC;IAC5H,CAAC;;AAnDD;;GAEG;AACW,6BAAiB,GAAG,aAAa,CAAC;AAChD;;GAEG;AACW,wBAAY,GAA8B,EAAE,CAAC;AAC3D;;GAEG;AACW,gCAAoB,GAA8B,EAAE,CAAC;AAEnE;;GAEG;AACW,iCAAqB,GAAG,iBAAiB,CAAC;AACxD;;GAEG;AACW,4BAAgB,GAA8B,EAAE,CAAC;AAC/D;;GAEG;AACW,oCAAwB,GAA8B,EAAE,CAAC","sourcesContent":["import { ShaderLanguage } from \"../Materials/shaderLanguage\";\r\n\r\n/**\r\n * Defines the shader related stores and directory\r\n */\r\nexport class ShaderStore {\r\n    /**\r\n     * Gets or sets the relative url used to load shaders if using the engine in non-minified mode\r\n     */\r\n    public static ShadersRepository = \"../Shaders/\";\r\n    /**\r\n     * Store of each shader (The can be looked up using effect.key)\r\n     */\r\n    public static ShadersStore: { [key: string]: string } = {};\r\n    /**\r\n     * Store of each included file for a shader (The can be looked up using effect.key)\r\n     */\r\n    public static IncludesShadersStore: { [key: string]: string } = {};\r\n\r\n    /**\r\n     * Gets or sets the relative url used to load shaders (WGSL) if using the engine in non-minified mode\r\n     */\r\n    public static ShadersRepositoryWGSL = \"../ShadersWGSL/\";\r\n    /**\r\n     * Store of each shader  (WGSL)\r\n     */\r\n    public static ShadersStoreWGSL: { [key: string]: string } = {};\r\n    /**\r\n     * Store of each included file for a shader (WGSL)\r\n     */\r\n    public static IncludesShadersStoreWGSL: { [key: string]: string } = {};\r\n\r\n    /**\r\n     * Gets the shaders repository path for a given shader language\r\n     * @param shaderLanguage the shader language\r\n     * @returns the path to the shaders repository\r\n     */\r\n    public static GetShadersRepository(shaderLanguage = ShaderLanguage.GLSL): string {\r\n        return shaderLanguage === ShaderLanguage.GLSL ? ShaderStore.ShadersRepository : ShaderStore.ShadersRepositoryWGSL;\r\n    }\r\n\r\n    /**\r\n     * Gets the shaders store of a given shader language\r\n     * @param shaderLanguage the shader language\r\n     * @returns the shaders store\r\n     */\r\n    public static GetShadersStore(shaderLanguage = ShaderLanguage.GLSL): { [key: string]: string } {\r\n        return shaderLanguage === ShaderLanguage.GLSL ? ShaderStore.ShadersStore : ShaderStore.ShadersStoreWGSL;\r\n    }\r\n\r\n    /**\r\n     * Gets the include shaders store of a given shader language\r\n     * @param shaderLanguage the shader language\r\n     * @returns the include shaders store\r\n     */\r\n    public static GetIncludesShadersStore(shaderLanguage = ShaderLanguage.GLSL): { [key: string]: string } {\r\n        return shaderLanguage === ShaderLanguage.GLSL ? ShaderStore.IncludesShadersStore : ShaderStore.IncludesShadersStoreWGSL;\r\n    }\r\n}\r\n"]}
+{"version":3,"file":"shaderStore.js","sourceRoot":"","sources":["../../../../dev/core/src/Engines/shaderStore.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,WAAW;IA2BpB;;;;OAIG;IACI,MAAM,CAAC,oBAAoB,CAAC,cAAc,8BAAsB;QACnE,OAAO,cAAc,gCAAwB,CAAC,CAAC,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC,WAAW,CAAC,qBAAqB,CAAC;IACtH,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,eAAe,CAAC,cAAc,8BAAsB;QAC9D,OAAO,cAAc,gCAAwB,CAAC,CAAC,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC;IAC5G,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,uBAAuB,CAAC,cAAc,8BAAsB;QACtE,OAAO,cAAc,gCAAwB,CAAC,CAAC,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAAC,WAAW,CAAC,wBAAwB,CAAC;IAC5H,CAAC;;AAnDD;;GAEG;AACW,6BAAiB,GAAG,cAAc,CAAC;AACjD;;GAEG;AACW,wBAAY,GAA8B,EAAE,CAAC;AAC3D;;GAEG;AACW,gCAAoB,GAA8B,EAAE,CAAC;AAEnE;;GAEG;AACW,iCAAqB,GAAG,kBAAkB,CAAC;AACzD;;GAEG;AACW,4BAAgB,GAA8B,EAAE,CAAC;AAC/D;;GAEG;AACW,oCAAwB,GAA8B,EAAE,CAAC","sourcesContent":["import { ShaderLanguage } from \"../Materials/shaderLanguage\";\r\n\r\n/**\r\n * Defines the shader related stores and directory\r\n */\r\nexport class ShaderStore {\r\n    /**\r\n     * Gets or sets the relative url used to load shaders if using the engine in non-minified mode\r\n     */\r\n    public static ShadersRepository = \"src/Shaders/\";\r\n    /**\r\n     * Store of each shader (The can be looked up using effect.key)\r\n     */\r\n    public static ShadersStore: { [key: string]: string } = {};\r\n    /**\r\n     * Store of each included file for a shader (The can be looked up using effect.key)\r\n     */\r\n    public static IncludesShadersStore: { [key: string]: string } = {};\r\n\r\n    /**\r\n     * Gets or sets the relative url used to load shaders (WGSL) if using the engine in non-minified mode\r\n     */\r\n    public static ShadersRepositoryWGSL = \"src/ShadersWGSL/\";\r\n    /**\r\n     * Store of each shader  (WGSL)\r\n     */\r\n    public static ShadersStoreWGSL: { [key: string]: string } = {};\r\n    /**\r\n     * Store of each included file for a shader (WGSL)\r\n     */\r\n    public static IncludesShadersStoreWGSL: { [key: string]: string } = {};\r\n\r\n    /**\r\n     * Gets the shaders repository path for a given shader language\r\n     * @param shaderLanguage the shader language\r\n     * @returns the path to the shaders repository\r\n     */\r\n    public static GetShadersRepository(shaderLanguage = ShaderLanguage.GLSL): string {\r\n        return shaderLanguage === ShaderLanguage.GLSL ? ShaderStore.ShadersRepository : ShaderStore.ShadersRepositoryWGSL;\r\n    }\r\n\r\n    /**\r\n     * Gets the shaders store of a given shader language\r\n     * @param shaderLanguage the shader language\r\n     * @returns the shaders store\r\n     */\r\n    public static GetShadersStore(shaderLanguage = ShaderLanguage.GLSL): { [key: string]: string } {\r\n        return shaderLanguage === ShaderLanguage.GLSL ? ShaderStore.ShadersStore : ShaderStore.ShadersStoreWGSL;\r\n    }\r\n\r\n    /**\r\n     * Gets the include shaders store of a given shader language\r\n     * @param shaderLanguage the shader language\r\n     * @returns the include shaders store\r\n     */\r\n    public static GetIncludesShadersStore(shaderLanguage = ShaderLanguage.GLSL): { [key: string]: string } {\r\n        return shaderLanguage === ShaderLanguage.GLSL ? ShaderStore.IncludesShadersStore : ShaderStore.IncludesShadersStoreWGSL;\r\n    }\r\n}\r\n"]}

package/Engines/webgpuEngine.d.ts

@@ -28,6 +28,7 @@ import { type WebGPUDataBuffer } from "../Meshes/WebGPU/webgpuDataBuffer.js";
 import "../Buffers/buffer.align.js";
 import { type RenderTargetWrapper } from "./renderTargetWrapper.js";
 import { type Scene } from "../scene.js";
+import { type AbstractMesh } from "../Meshes/abstractMesh.js";
 import { PerformanceMonitor } from "../Misc/performanceMonitor.js";
 import "./AbstractEngine/abstractEngine.loadingScreen.js";
 import "./AbstractEngine/abstractEngine.dom.js";
@@ -122,6 +123,73 @@ export interface WebGPUEngineOptions extends AbstractEngineOptions, GPURequestAd
      */
     twgslOptions?: TwgslOptions;
 }
+/**
+ * Options for pre-warming a render pipeline asynchronously.
+ * All render state properties are optional and default to the most common opaque rendering state.
+ */
+export interface IWebGPURenderPipelineAsyncCreationOptions {
+    /**
+     * The compiled effect (shader stages) for the pipeline.
+     */
+    effect: Effect;
+    /**
+     * The mesh whose vertex buffer layout to use.
+     */
+    mesh: AbstractMesh;
+    /**
+     * The fill mode / primitive topology. Defaults to Constants.MATERIAL_TriangleFillMode.
+     */
+    fillMode?: number;
+    /**
+     * The MSAA sample count. Defaults to the engine's current sample count.
+     */
+    sampleCount?: number;
+    /**
+     * The color render target format. Defaults to the engine's current canvas color format.
+     */
+    colorFormat?: GPUTextureFormat;
+    /**
+     * The depth-stencil render target format. Defaults to the engine's current depth format.
+     */
+    depthStencilFormat?: GPUTextureFormat;
+    /**
+     * The alpha blending mode (e.g. Constants.ALPHA_DISABLE, Constants.ALPHA_COMBINE).
+     * Defaults to Constants.ALPHA_DISABLE.
+     */
+    alphaMode?: number;
+    /**
+     * Whether depth writing is enabled. Defaults to true.
+     */
+    depthWrite?: boolean;
+    /**
+     * Whether depth testing is enabled. Defaults to true.
+     */
+    depthTest?: boolean;
+    /**
+     * The depth comparison function (e.g. Constants.LEQUAL). Defaults to Constants.LEQUAL.
+     */
+    depthCompare?: number;
+    /**
+     * Whether back-face culling is enabled. Defaults to true.
+     */
+    cullEnabled?: boolean;
+    /**
+     * Which face to cull (1 = back, 2 = front). Defaults to 1 (back).
+     */
+    cullFace?: number;
+    /**
+     * Front face winding order (1 = CCW, 2 = CW). Defaults to 2 (CW).
+     */
+    frontFace?: number;
+    /**
+     * Color channel write mask (bitmask of RGBA channels). Defaults to 0xF (all channels).
+     */
+    writeMask?: number;
+    /**
+     * Whether stencil testing is enabled. Defaults to false.
+     */
+    stencilEnabled?: boolean;
+}
 /**
  * The web GPU engine class provides support for WebGPU version of babylon.js.
  * @since 5.0.0
@@ -952,6 +1020,22 @@ export declare class WebGPUEngine extends ThinWebGPUEngine {
      * @param instancesCount defines the number of instances to draw (if instantiation is enabled)
      */
     drawArraysType(fillMode: number, verticesStart: number, verticesCount: number, instancesCount?: number): void;
+    /**
+     * Asynchronously pre-creates one or more render pipelines so they are cached and ready
+     * to use without any compilation hitch when first rendered.
+     *
+     * Call this for effects and meshes that are not yet rendering but will be soon
+     * (e.g. streaming content, predicted material changes, pre-loading the next level).
+     *
+     * When passing an array, cache state is set once per entry and restored only at the end,
+     * making batch pre-warming efficient.
+     *
+     * @param options - a single options object, an array of options objects,
+     *                  or a raw GPURenderPipelineDescriptor for complete control
+     * @returns an array of Promises for the pipelines that had cache misses (empty if all were cached).
+     *          When a raw GPURenderPipelineDescriptor is provided, always returns a single-element array.
+     */
+    createRenderPipelineAsync(options: IWebGPURenderPipelineAsyncCreationOptions | IWebGPURenderPipelineAsyncCreationOptions[] | GPURenderPipelineDescriptor): Promise<GPURenderPipeline>[];
     /**
      * Dispose and release all associated resources
      */

package/Engines/webgpuEngine.js

@@ -412,7 +412,7 @@ export class WebGPUEngine extends ThinWebGPUEngine {
             .then(async (adapter) => {
             if (!adapter) {
                 // eslint-disable-next-line no-throw-literal
-                throw "Could not retrieve a WebGPU adapter (adapter is null).";
+                throw "Could not retrieve a WebGPU adapter (adapter is null or undefined).";
             }
             else {
                 this._adapter = adapter;
@@ -2874,6 +2874,85 @@ export class WebGPUEngine extends ThinWebGPUEngine {
         this._draw(1, fillMode, verticesStart, verticesCount, instancesCount);
     }
     //------------------------------------------------------------------------------
+    //                        Async Pipeline Pre-Warming
+    //------------------------------------------------------------------------------
+    /**
+     * Asynchronously pre-creates one or more render pipelines so they are cached and ready
+     * to use without any compilation hitch when first rendered.
+     *
+     * Call this for effects and meshes that are not yet rendering but will be soon
+     * (e.g. streaming content, predicted material changes, pre-loading the next level).
+     *
+     * When passing an array, cache state is set once per entry and restored only at the end,
+     * making batch pre-warming efficient.
+     *
+     * @param options - a single options object, an array of options objects,
+     *                  or a raw GPURenderPipelineDescriptor for complete control
+     * @returns an array of Promises for the pipelines that had cache misses (empty if all were cached).
+     *          When a raw GPURenderPipelineDescriptor is provided, always returns a single-element array.
+     */
+    // eslint-disable-next-line no-restricted-syntax
+    createRenderPipelineAsync(options) {
+        // Raw GPURenderPipelineDescriptor: bypass the cache and create directly
+        if ("vertex" in options) {
+            return [this._device.createRenderPipelineAsync(options)];
+        }
+        const entries = Array.isArray(options) ? options : [options];
+        const promises = [];
+        const cache = this._cacheRenderPipeline;
+        for (const entry of entries) {
+            // Render target formats
+            cache.setColorFormat(entry.colorFormat ?? this._colorFormat);
+            cache.setDepthStencilFormat(entry.depthStencilFormat ?? this._depthTextureFormat);
+            // Vertex / index buffers from mesh
+            const geometry = entry.mesh.geometry;
+            if (!geometry) {
+                throw new Error("WebGPUEngine.createRenderPipelineAsync: mesh has no geometry to derive vertex/index buffers from.");
+            }
+            cache.setBuffers(geometry.getVertexBuffers(), geometry.getIndexBuffer(), null);
+            // Alpha / blend state
+            const alphaMode = entry.alphaMode ?? 0;
+            if (alphaMode === 0) {
+                cache.setAlphaBlendEnabled([false], 0);
+            }
+            else {
+                const prevAlphaMode = this._alphaMode[0];
+                this.setAlphaMode(alphaMode);
+                cache.setAlphaBlendEnabled(this._alphaState._alphaBlend, this._alphaState._numTargetEnabled);
+                cache.setAlphaBlendFactors(this._alphaState._blendFunctionParameters, this._alphaState._blendEquationParameters);
+                this.setAlphaMode(prevAlphaMode);
+            }
+            // Depth / stencil state
+            cache.setDepthWriteEnabled(entry.depthWrite ?? true);
+            cache.setDepthTestEnabled(entry.depthTest ?? true);
+            cache.setDepthCompare(entry.depthCompare ?? 515);
+            // Rasterization state
+            cache.setCullEnabled(entry.cullEnabled ?? true);
+            cache.setCullFace(entry.cullFace ?? 1);
+            cache.setFrontFace(entry.frontFace ?? 2);
+            // Write mask
+            cache.setWriteMask(entry.writeMask ?? 0xf);
+            // Stencil
+            cache.setStencilEnabled(entry.stencilEnabled ?? false);
+            const fillMode = entry.fillMode ?? 0;
+            const sampleCount = entry.sampleCount ?? this.currentSampleCount;
+            const promise = cache.preWarmPipeline(fillMode, entry.effect, sampleCount, 0);
+            if (promise) {
+                promises.push(promise);
+            }
+        }
+        // Restore the cache state to the engine's current tracked state once after the entire batch
+        cache.setColorFormat(this._colorFormat);
+        cache.setDepthStencilFormat(this._depthTextureFormat);
+        cache.setBuffers(this._currentVertexBuffers ?? null, this._currentIndexBuffer, this._currentOverrideVertexBuffers ?? null);
+        cache.setDepthCullingState(this._depthCullingState.cull ?? false, this._depthCullingState.frontFace ?? 2, this._depthCullingState.cullFace ?? 1, this._depthCullingState.zOffset, this._depthCullingState.zOffsetUnits, this._depthCullingState.depthTest ?? true, this._depthCullingState.depthMask ?? true, this._depthCullingState.depthFunc);
+        cache.setAlphaBlendEnabled(this._alphaState._alphaBlend, this._alphaState._numTargetEnabled);
+        cache.setAlphaBlendFactors(this._alphaState._blendFunctionParameters, this._alphaState._blendEquationParameters);
+        cache.setStencilEnabled(this._stencilStateComposer.enabled ?? false);
+        cache.setWriteMask(this._colorWrite ? 0xf : 0);
+        return promises;
+    }
+    //------------------------------------------------------------------------------
     //                              Dispose
     //------------------------------------------------------------------------------
     /**