@zephyr3d/device 0.2.3 → 0.2.5

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { TypedArray, IEventTarget, CubeFace, VectorBase, Vector4 } from '@zephyr3d/base';
+import { TypedArray, IDisposable, CubeFace, VectorBase, MaybeArray, IEventTarget, Vector4, Observable } from '@zephyr3d/base';
 
 /**
  * Struct layout types
@@ -291,7 +291,7 @@ declare class PBVoidTypeInfo extends PBTypeInfo<null> {
     /** {@inheritDoc PBTypeInfo.isVoidType} */
     isVoidType(): this is PBVoidTypeInfo;
     /** {@inheritDoc PBTypeInfo.toBufferLayout} */
-    toBufferLayout(offset: number): UniformBufferLayout;
+    toBufferLayout(_offset: number): UniformBufferLayout;
 }
 /**
  * The void type info
@@ -302,9 +302,9 @@ declare class PBAnyTypeInfo extends PBTypeInfo<null> {
     /** {@inheritDoc PBTypeInfo.isAnyType} */
     isAnyType(): this is PBAnyTypeInfo;
     /** {@inheritDoc PBTypeInfo.toBufferLayout} */
-    toBufferLayout(offset: number): UniformBufferLayout;
+    toBufferLayout(_offset: number): UniformBufferLayout;
     /** {@inheritDoc PBTypeInfo.isCompatibleType} */
-    isCompatibleType(other: PBTypeInfo<TypeDetailInfo>): boolean;
+    isCompatibleType(_other: PBTypeInfo<TypeDetailInfo>): boolean;
 }
 /**
  * The primitive type info
@@ -342,7 +342,7 @@ declare class PBPrimitiveTypeInfo extends PBTypeInfo<PrimitiveTypeDetail> {
     /** {@inheritDoc PBTypeInfo.isPrimitiveType} */
     isPrimitiveType(): this is PBPrimitiveTypeInfo;
     /** {@inheritDoc PBTypeInfo.toBufferLayout} */
-    toBufferLayout(offset: number): UniformBufferLayout;
+    toBufferLayout(_offset: number): UniformBufferLayout;
 }
 /**
  * The struct type info
@@ -363,7 +363,7 @@ declare class PBStructTypeInfo extends PBTypeInfo<StructTypeDetail> {
         /** Name of the struct member */
         name: string;
         /** Type of the struct member */
-        type: PBPrimitiveTypeInfo | PBArrayTypeInfo | PBStructTypeInfo | PBAtomicI32TypeInfo | PBAtomicU32TypeInfo;
+        type: PBPrimitiveTypeInfo | PBArrayTypeInfo | PBAtomicI32TypeInfo | PBAtomicU32TypeInfo | PBStructTypeInfo;
         /** Alignment of the struct member */
         alignment: number;
         /** Byte size of the struct member */
@@ -405,7 +405,7 @@ declare class PBArrayTypeInfo extends PBTypeInfo<ArrayTypeDetail> {
     /** {@inheritDoc PBTypeInfo.isArrayType} */
     isArrayType(): this is PBArrayTypeInfo;
     /** {@inheritDoc PBTypeInfo.toBufferLayout} */
-    toBufferLayout(offset: number): UniformBufferLayout;
+    toBufferLayout(_offset: number): UniformBufferLayout;
     isCompatibleType(other: PBTypeInfo<TypeDetailInfo>): boolean;
 }
 /**
@@ -424,7 +424,7 @@ declare class PBPointerTypeInfo extends PBTypeInfo<PointerTypeDetail> {
     /** {@inheritDoc PBTypeInfo.isPointerType} */
     isPointerType(): this is PBPointerTypeInfo;
     /** {@inheritDoc PBTypeInfo.toBufferLayout} */
-    toBufferLayout(offset: number): UniformBufferLayout;
+    toBufferLayout(_offset: number): UniformBufferLayout;
 }
 /**
  * The atomic int type info
@@ -435,7 +435,7 @@ declare class PBAtomicI32TypeInfo extends PBTypeInfo<null> {
     /** {@inheritDoc PBTypeInfo.isPointerType} */
     haveAtomicMembers(): boolean;
     /** {@inheritDoc PBTypeInfo.toBufferLayout} */
-    toBufferLayout(offset: number): UniformBufferLayout;
+    toBufferLayout(_offset: number): UniformBufferLayout;
 }
 /**
  * The atomic int type info
@@ -446,7 +446,7 @@ declare class PBAtomicU32TypeInfo extends PBTypeInfo<null> {
     /** {@inheritDoc PBTypeInfo.isPointerType} */
     haveAtomicMembers(): boolean;
     /** {@inheritDoc PBTypeInfo.toBufferLayout} */
-    toBufferLayout(offset: number): UniformBufferLayout;
+    toBufferLayout(_offset: number): UniformBufferLayout;
 }
 /**
  * The sampler type info
@@ -457,7 +457,7 @@ declare class PBSamplerTypeInfo extends PBTypeInfo<SamplerTypeDetail> {
     /** Get the access mode */
     get accessMode(): PBSamplerAccessMode;
     /** {@inheritDoc PBTypeInfo.toBufferLayout} */
-    toBufferLayout(offset: number): UniformBufferLayout;
+    toBufferLayout(_offset: number): UniformBufferLayout;
 }
 /**
  * The texture type info
@@ -496,7 +496,7 @@ declare class PBTextureTypeInfo extends PBTypeInfo<TextureTypeDetail> {
     /** Returns true if the texture format is of type unsigned integer  */
     isUIntTexture(): boolean;
     /** {@inheritDoc PBTypeInfo.toBufferLayout} */
-    toBufferLayout(offset: number): UniformBufferLayout;
+    toBufferLayout(_offset: number): UniformBufferLayout;
 }
 /**
  * The function type info
@@ -519,7 +519,7 @@ declare class PBFunctionTypeInfo extends PBTypeInfo<FunctionTypeDetail> {
     /** Get hash for parameter types */
     get argHash(): string;
     /** {@inheritDoc PBTypeInfo.toBufferLayout} */
-    toBufferLayout(offset: number): UniformBufferLayout;
+    toBufferLayout(_offset: number): UniformBufferLayout;
 }
 
 /**
@@ -548,7 +548,9 @@ declare class VertexData {
     /** Vertex buffer information list */
     get vertexBuffers(): VertexBufferInfo[];
     /** Index buffer */
-    get indexBuffer(): IndexBuffer<unknown>;
+    get indexBuffer(): IndexBuffer;
+    /** Number of vertices */
+    get numVertices(): number;
     /** Draw offset */
     getDrawOffset(): number;
     setDrawOffset(offset: number): void;
@@ -595,6 +597,40 @@ declare class VertexData {
  * @public
  */
 type TextureImageElement = ImageBitmap | HTMLCanvasElement;
+/** @public */
+declare const MAX_VERTEX_ATTRIBUTES = 16;
+/** @public */
+declare const MAX_BINDING_GROUPS = 4;
+/** @public */
+declare const MAX_TEXCOORD_INDEX_COUNT = 8;
+/** @public */
+declare const VERTEX_ATTRIB_POSITION = 0;
+/** @public */
+declare const VERTEX_ATTRIB_NORMAL = 1;
+/** @public */
+declare const VERTEX_ATTRIB_DIFFUSE = 2;
+/** @public */
+declare const VERTEX_ATTRIB_TANGENT = 3;
+/** @public */
+declare const VERTEX_ATTRIB_TEXCOORD0 = 4;
+/** @public */
+declare const VERTEX_ATTRIB_TEXCOORD1 = 5;
+/** @public */
+declare const VERTEX_ATTRIB_TEXCOORD2 = 6;
+/** @public */
+declare const VERTEX_ATTRIB_TEXCOORD3 = 7;
+/** @public */
+declare const VERTEX_ATTRIB_TEXCOORD4 = 8;
+/** @public */
+declare const VERTEX_ATTRIB_TEXCOORD5 = 9;
+/** @public */
+declare const VERTEX_ATTRIB_TEXCOORD6 = 10;
+/** @public */
+declare const VERTEX_ATTRIB_TEXCOORD7 = 11;
+/** @public */
+declare const VERTEX_ATTRIB_BLEND_WEIGHT = 12;
+/** @public */
+declare const VERTEX_ATTRIB_BLEND_INDICES = 13;
 /**
  * The vertex format types
  * @public
@@ -614,14 +650,7 @@ type VertexLayoutOptions = {
      * vertex buffers in this vertex layout
      */
     vertexBuffers: {
-        /**
-         * vertex buffer object created by device
-         */
         buffer: StructuredBuffer;
-        /**
-         * the vertex buffer step mode,
-         * value can be 'vertex' or 'instance', default is 'vertex'
-         */
         stepMode?: VertexStepMode;
     }[];
     /**
@@ -638,7 +667,7 @@ type TextureColorSpace = 'srgb' | 'linear';
  * Buffer usage type
  * @public
  */
-type BufferUsage = 'vertex' | 'index' | 'uniform' | 'read' | 'write';
+type BufferUsage = 'vertex' | 'index' | 'uniform' | 'read' | 'write' | 'pack-pixel' | 'unpack-pixel';
 /**
  * Common options for createing texture or buffer
  * @public
@@ -656,6 +685,7 @@ interface BaseCreationOptions {
 interface TextureCreationOptions extends BaseCreationOptions {
     writable?: boolean;
     texture?: BaseTexture;
+    mipmapping?: boolean;
     samplerOptions?: SamplerOptions;
 }
 /**
@@ -685,8 +715,10 @@ declare enum GPUResourceUsageFlags {
     BF_WRITE = 256,
     BF_UNIFORM = 512,
     BF_STORAGE = 1024,
-    DYNAMIC = 2048,
-    MANAGED = 4096
+    BF_PACK_PIXEL = 2048,
+    BF_UNPACK_PIXEL = 4096,
+    DYNAMIC = 8192,
+    MANAGED = 16384
 }
 /**
  * Get vertex attribute index by semantic
@@ -698,13 +730,40 @@ declare function getVertexAttribByName(name: VertexSemantic): number;
  * @public
  */
 declare function getVertexAttribName(attrib: number): VertexSemantic;
+/**
+ * Test whether a vertex buffer matches given semantic
+ * @param buffer - Vertex buffer
+ * @param name - Semantic to test
+ * @returns true if the vertex buffer matches given semantic, otherwise false
+ *
+ * @public
+ */
+declare function matchVertexBuffer(buffer: StructuredBuffer, name: VertexSemantic): boolean;
+/**
+ * Get vertex attribute type of specified vertex format
+ * @param fmt - The vertex format
+ * @returns Vertex attribute type, possible values are 'f32', 'f16', 'i32', 'u32', 'i16', 'u16', 'i8norm', 'u8norm', 'i16norm', 'u16norm'
+ *
+ * @public
+ */
+declare function getVertexAttributeFormat(fmt: VertexAttribFormat): "f32" | "i32" | "u32" | "u8norm" | "i8norm" | "u16" | "i16" | "u16norm" | "i16norm" | "f16";
+/**
+ * Get vertex attribute index of specified vertex format
+ * @param fmt - The vertex format
+ * @returns Vertex attribute index
+ *
+ * @public
+ */
+declare function getVertexAttributeIndex(fmt: VertexAttribFormat): number;
 /**
  * Get byte size of specified vertex format
+ *
  * @public
  */
 declare function getVertexFormatSize(fmt: VertexAttribFormat): number;
 /**
  * Get number of components of specified vertex format
+ *
  * @public
  */
 declare function getVertexFormatComponentCount(fmt: VertexAttribFormat): number;
@@ -714,6 +773,7 @@ declare function getVertexFormatComponentCount(fmt: VertexAttribFormat): number;
  * @param type - Data type of vertex component
  * @param count - The count of vertex components
  * @returns Vertex format
+ *
  * @public
  */
 declare function getVertexAttribFormat(semantic: VertexSemantic, type: DataType, count: number): VertexAttribFormat;
@@ -721,6 +781,7 @@ declare function getVertexAttribFormat(semantic: VertexSemantic, type: DataType,
  * Get the length of a vertex buffer by specified structure type of the vertex buffer
  * @param vertexBufferType - The structure type of the vertex buffer
  * @returns The length of the vertex buffer
+ *
  * @public
  */
 declare function getVertexBufferLength(vertexBufferType: PBStructTypeInfo): number;
@@ -728,6 +789,7 @@ declare function getVertexBufferLength(vertexBufferType: PBStructTypeInfo): numb
  * Get byte stride of a vertex buffer by specified structure type of the vertex buffer
  * @param vertexBufferType - The structure type of the vertex buffer
  * @returns The byte stride of the vertex buffer
+ *
  * @public
  */
 declare function getVertexBufferStride(vertexBufferType: PBStructTypeInfo): number;
@@ -736,6 +798,7 @@ declare function getVertexBufferStride(vertexBufferType: PBStructTypeInfo): numb
  * @param vertexBufferType - The structure type of the vertex buffer
  * @param semantic - The vertex semantic
  * @returns - The primitive type of the vertex attribute
+ *
  * @public
  */
 declare function getVertexBufferAttribTypeBySemantic(vertexBufferType: PBStructTypeInfo, semantic: VertexSemantic): PBPrimitiveTypeInfo;
@@ -744,6 +807,7 @@ declare function getVertexBufferAttribTypeBySemantic(vertexBufferType: PBStructT
  * @param vertexBufferType - The structure type of the vertex buffer
  * @param semantic - The vertex attribute index
  * @returns - The primitive type of the vertex attribute
+ *
  * @public
  */
 declare function getVertexBufferAttribType(vertexBufferType: PBStructTypeInfo, attrib: number): PBPrimitiveTypeInfo;
@@ -752,16 +816,19 @@ declare function getVertexBufferAttribType(vertexBufferType: PBStructTypeInfo, a
  * @param length - The length of the vertex buffer
  * @param attributes - The vertex attributes
  * @returns The structure type of the vertex buffer
+ *
  * @public
  */
 declare function makeVertexBufferType(length: number, ...attributes: VertexAttribFormat[]): PBStructTypeInfo;
 /**
  * Vertex step mode.
+ *
  * @public
  */
 type VertexStepMode = 'vertex' | 'instance';
 /**
  * Vertex semantic list
+ *
  * @public
  */
 declare const semanticList: string[];
@@ -909,7 +976,7 @@ interface StorageTextureBindingLayout {
     /** The texture format */
     format: TextureFormat;
     /** View dimension */
-    viewDimension: '1d' | '2d';
+    viewDimension: '1d' | '2d' | '2d-array' | 'cube' | 'cube-array' | '3d';
 }
 /**
  * Binding layout of an external texture
@@ -984,9 +1051,7 @@ interface SamplerOptions {
  * Base class for a GPU object
  * @public
  */
-interface GPUObject<T = unknown> extends IEventTarget<{
-    disposed: null;
-}> {
+interface GPUObject<T = unknown> extends IDisposable {
     /** The object was created by which device */
     readonly device: AbstractDevice;
     /** The internal GPU object  */
@@ -996,7 +1061,7 @@ interface GPUObject<T = unknown> extends IEventTarget<{
     readonly cid: number;
     readonly disposed: boolean;
     name: string;
-    restoreHandler: (tex: GPUObject) => Promise<void>;
+    restoreHandler: (tex: GPUObject) => void;
     isVertexLayout(): this is VertexLayout;
     isFramebuffer(): this is FrameBuffer;
     isSampler(): this is TextureSampler;
@@ -1010,9 +1075,9 @@ interface GPUObject<T = unknown> extends IEventTarget<{
     isBuffer(): this is GPUDataBuffer;
     isBindGroup(): this is BindGroup;
     dispose(): void;
-    reload(): Promise<void>;
+    reload(): void;
     destroy(): void;
-    restore(): Promise<void>;
+    restore(): void;
 }
 /**
  * Abstract interface for texture sampler
@@ -1108,7 +1173,7 @@ interface GPUDataBuffer<T = unknown> extends GPUObject<T> {
     readonly byteLength: number;
     readonly usage: number;
     bufferSubData(dstByteOffset: number, data: TypedArray, srcOffset?: number, srcLength?: number): void;
-    getBufferSubData(dstBuffer?: Uint8Array, offsetInBytes?: number, sizeInBytes?: number): Promise<Uint8Array>;
+    getBufferSubData(dstBuffer?: Uint8Array<ArrayBuffer>, offsetInBytes?: number, sizeInBytes?: number): Promise<Uint8Array<ArrayBuffer>>;
 }
 /**
  * Abstract interface for index buffer
@@ -1156,13 +1221,20 @@ interface FrameBuffer<T = unknown> extends GPUObject<T> {
     getSampleCount(): number;
     getHash(): string;
     setColorAttachmentCubeFace(index: number, face: CubeFace): void;
+    getColorAttachmentCubeFace(index: number): CubeFace;
     setColorAttachmentMipLevel(index: number, level: number): void;
+    getColorAttachmentMipLevel(index: number): number;
     setColorAttachmentLayer(index: number, layer: number): void;
+    getColorAttachmentLayer(index: number): number;
     setColorAttachmentGenerateMipmaps(index: number, generateMipmaps: boolean): void;
+    getColorAttachmentGenerateMipmaps(index: number): boolean;
     setDepthAttachmentCubeFace(face: CubeFace): void;
+    getDepthAttachmentCubeFace(): CubeFace;
     setDepthAttachmentLayer(layer: number): void;
+    getDepthAttachmentLayer(): number;
     getColorAttachments(): BaseTexture[];
     getDepthAttachment(): BaseTexture;
+    getColorAttachment<T extends BaseTexture = BaseTexture>(index: number): T;
     bind(): boolean;
     unbind(): void;
 }
@@ -1194,7 +1266,7 @@ interface BindGroup extends GPUObject<unknown> {
     getLayout(): BindGroupLayout;
     getDynamicOffsets(): number[];
     getGPUId(): string;
-    getBuffer(name: string): GPUDataBuffer;
+    getBuffer(name: string, nocreate?: boolean): GPUDataBuffer;
     getTexture(name: string): BaseTexture;
     setBuffer(name: string, buffer: GPUDataBuffer, offset?: number, bindOffset?: number, bindSize?: number): void;
     setValue(name: string, value: StructuredValue): any;
@@ -1480,7 +1552,7 @@ interface ProgramBuilder {
     /** Gets the global scope */
     getGlobalScope(): PBGlobalScope;
     /** Gets the current scope */
-    getCurrentScope(): PBScope;
+    getCurrentScope<T extends PBScope = PBScope>(): T;
     /**
      * Query the global variable by the name
      * @param name - Name of the variable
@@ -1951,6 +2023,8 @@ interface ProgramBuilder {
     max(x: number | PBShaderExp, y: number | PBShaderExp): PBShaderExp;
     /** Same as clamp builtin function in GLSL and WGSL */
     clamp(x: number | PBShaderExp, y: number | PBShaderExp, z: number | PBShaderExp): PBShaderExp;
+    /** Clamp to [0, 1] */
+    saturate(x: PBShaderExp): PBShaderExp;
     /** Same as mix builtin function in GLSL and WGSL */
     mix(x: number | PBShaderExp, y: number | PBShaderExp, z: number | PBShaderExp): PBShaderExp;
     /** Same as step builtin function in GLSL and WGSL */
@@ -1964,13 +2038,13 @@ interface ProgramBuilder {
     /** add two values */
     add_2(x: number | PBShaderExp, y: number | PBShaderExp): any;
     /** add a couple of values togeter */
-    add(x: number | PBShaderExp, ...rest: (number | PBShaderExp)[]): any;
+    add(x: number | PBShaderExp, y: number | PBShaderExp, ...rest: (number | PBShaderExp)[]): any;
     /** subtract two values */
     sub(x: number | PBShaderExp, y: number | PBShaderExp): any;
     /** multiply two values */
     mul_2(x: number | PBShaderExp, y: number | PBShaderExp): any;
     /** multiply a couple of values togeter */
-    mul(x: number | PBShaderExp, ...rest: (number | PBShaderExp)[]): any;
+    mul(x: number | PBShaderExp, y: number | PBShaderExp, ...rest: (number | PBShaderExp)[]): any;
     /** divide the first number by the second number */
     div(x: number | PBShaderExp, y: number | PBShaderExp): any;
     /** Same as length builtin function in GLSL and WGSL */
@@ -2239,7 +2313,7 @@ declare class PBLocalScope extends PBScope {
 interface PBBuiltinScope {
     position: PBShaderExp;
     pointSize: PBShaderExp | number;
-    fragDepth: PBShaderExp;
+    fragDepth: PBShaderExp | number;
     readonly fragCoord: PBShaderExp;
     readonly frontFacing: PBShaderExp;
     readonly vertexIndex: PBShaderExp;
@@ -2321,7 +2395,7 @@ declare class PBInsideFunctionScope extends PBScope {
      * @param end - end value of the counter exclusive
      * @param body - Generator function for the scope that inside the for statement
      */
-    $for(counter: PBShaderExp, init: number | PBShaderExp, end: number | PBShaderExp, body: (this: PBForScope) => void): void;
+    $for(counter: PBShaderExp, init: number | PBShaderExp, end: number | PBShaderExp, open?: boolean | ((this: PBForScope) => void), reverse?: boolean | ((this: PBForScope) => void), body?: (this: PBForScope) => void): void;
     /**
      * Creates a 'do..while' statement
      * @param body - Generator function for the scope that inside the do..while statment
@@ -2334,6 +2408,8 @@ declare class PBInsideFunctionScope extends PBScope {
      * @param body - Generator function for the scope that inside the while statement
      */
     $while(condition: ExpValueNonArrayType, body: (this: PBWhileScope) => void): void;
+    /** Gets main function scope */
+    $getMainScope(): PBFunctionScope;
 }
 /**
  * Scope that insides a function
@@ -2530,6 +2606,10 @@ interface DepthState {
     writeEnabled: boolean;
     /** The comparison function for depth testing */
     compareFunc: CompareFunc;
+    /** Depth bias */
+    depthBias: number;
+    /** Slope scaled depth bias */
+    depthBiasSlopeScale: number;
     /**
      * Enable or disable depth testing
      * @param b - true if enable
@@ -2548,6 +2628,16 @@ interface DepthState {
      * @returns self
      */
     setCompareFunc(func: CompareFunc): this;
+    /**
+     * Sets the depth bias
+     * @param value - Value of the depth bias
+     */
+    setDepthBias(value: number): this;
+    /**
+     * Sets the slope scaled depth bias
+     * @param value - Value of the slope scaled depth bias
+     */
+    setDepthBiasSlopeScale(value: number): this;
 }
 /**
  * Stencil operations
@@ -2718,7 +2808,11 @@ declare class Pool {
      * Creates an instance of Pool class
      * @param device - Rendering device
      */
-    constructor(device: AbstractDevice, memCostThreshold?: number);
+    constructor(device: AbstractDevice, id: string | symbol, memCostThreshold?: number);
+    /**
+     * Id for this pool
+     */
+    get id(): string | symbol;
     autoRelease(): void;
     /**
      * Fetch a temporal 2D texture from the object pool.
@@ -2729,7 +2823,7 @@ declare class Pool {
      * @param mipmapping - Whether this texture support mipmapping
      * @returns The fetched Texture2D object.
      */
-    fetchTemporalTexture2D(autoRelease: boolean, format: TextureFormat, width: number, height: number, mipmapping: boolean): Texture2D;
+    fetchTemporalTexture2D(autoRelease: boolean, format: TextureFormat, width: number, height: number, mipmapping?: boolean): Texture2D;
     /**
      * Fetch a temporal 2D array texture from the object pool.
      * @param autoRelease - Whether the texture should be automatically released at the next frame.
@@ -2740,7 +2834,7 @@ declare class Pool {
      * @param mipmapping - Whether this texture support mipmapping
      * @returns The fetched Texture2DArray object.
      */
-    fetchTemporalTexture2DArray(autoRelease: boolean, format: TextureFormat, width: number, height: number, numLayers: number, mipmapping: boolean): Texture2DArray;
+    fetchTemporalTexture2DArray(autoRelease: boolean, format: TextureFormat, width: number, height: number, numLayers: number, mipmapping?: boolean): Texture2DArray;
     /**
      * Fetch a temporal Cube texture from the object pool.
      * @param autoRelease - Whether the texture should be automatically released at the next frame.
@@ -2749,67 +2843,36 @@ declare class Pool {
      * @param mipmapping - Whether this texture support mipmapping
      * @returns The fetched TextureCube object.
      */
-    fetchTemporalTextureCube(autoRelease: boolean, format: TextureFormat, size: number, mipmapping: boolean): TextureCube;
+    fetchTemporalTextureCube(autoRelease: boolean, format: TextureFormat, size: number, mipmapping?: boolean): TextureCube;
     /**
-     * Fetch a temporal framebuffer from the object pool.
-     * @param autoRelease - Whether the framebuffer should be automatically released at the next frame.
-     * @param colorFormat - Texture format for color attachment.
-     * @param depthFormat - Texture format for depth attachment.
-     * @param sampleCount - The sample count for the framebuffer.
-     * @param ignoreDepthStencil - Whether to ignore depth stencil.
-     * @returns The fetched FrameBuffer object.
-     */
-    fetchTemporalFramebuffer(autoRelease: boolean, width: number, height: number, colorFormat: TextureFormat, depthFormat?: TextureFormat, mipmapping?: boolean, sampleCount?: number, ignoreDepthStencil?: boolean): FrameBuffer;
-    /**
-     * Fetch a temporal framebuffer from the object pool.
-     * @param autoRelease - Whether the framebuffer should be automatically released at the next frame.
-     * @param colorFormat - Texture format for color attachment.
-     * @param depthTex - depth attachment.
-     * @param sampleCount - The sample count for the framebuffer.
-     * @param ignoreDepthStencil - Whether to ignore depth stencil.
-     * @returns The fetched FrameBuffer object.
-     */
-    fetchTemporalFramebuffer<T extends BaseTexture<unknown>>(autoRelease: boolean, width: number, height: number, colorFormat: TextureFormat, depthTex?: T, mipmapping?: boolean, sampleCount?: number, ignoreDepthStencil?: boolean): FrameBuffer;
-    /**
-     * Fetch a temporal framebuffer from the object pool.
-     * @param autoRelease - Whether the framebuffer should be automatically released at the next frame.
-     * @param colorTex - color attachment.
-     * @param depthFormat - Texture format for depth attachment.
-     * @param sampleCount - The sample count for the framebuffer.
-     * @param ignoreDepthStencil - Whether to ignore depth stencil.
-     * @returns The fetched FrameBuffer object.
-     */
-    fetchTemporalFramebuffer<T extends BaseTexture<unknown>>(autoRelease: boolean, width: number, height: number, colorTex: T, depthFormat?: TextureFormat, mipmapping?: boolean, sampleCount?: number, ignoreDepthStencil?: boolean): FrameBuffer;
-    /**
-     * Fetch a temporal framebuffer from the object pool.
-     * @param autoRelease - Whether the framebuffer should be automatically released at the next frame.
-     * @param colorTex - color attachment.
-     * @param depthTex - depth attachment.
-     * @param sampleCount - The sample count for the framebuffer.
-     * @param ignoreDepthStencil - Whether to ignore depth stencil.
-     * @returns The fetched FrameBuffer object.
-     */
-    fetchTemporalFramebuffer<T extends BaseTexture<unknown>>(autoRelease: boolean, width: number, height: number, colorTex: T, depthTex?: T, mipmapping?: boolean, sampleCount?: number, ignoreDepthStencil?: boolean): FrameBuffer;
-    /**
-     * Fetch a temporal framebuffer from the object pool.
+     * Creates a temporal framebuffer from the object pool.
      * @param autoRelease - Whether the framebuffer should be automatically released at the next frame.
-     * @param colorTexOrFormat - color attachment or texture format.
-     * @param depthTexOrFormat - depth attachment or texture format.
-     * @param sampleCount - The sample count for the framebuffer.
-     * @param ignoreDepthStencil - Whether to ignore depth stencil.
+     * @param width - Width of the framebuffer
+     * @param height - Height of the framebuffer
+     * @param colorAttachments - Array of color attachments or texture format of the framebuffer.
+     * @param depthAttachment - Depth attachment or texture format of the framebuffer.
+     * @param mipmapping - Whether mipmapping should be enabled when creating color attachment textures, default is false.
+     * @param sampleCount - The sample count for the framebuffer, default is 1.
+     * @param ignoreDepthStencil - Whether to ignore depth stencil when resolving msaa framebuffer, default is true.
+     * @param attachmentMipLevel - The mipmap level to which the color attachment will render, default is 0
+     * @param attachmentCubeface - The cubemap face to which the color attachment will render, default is 0
+     * @param attachmentLayer - The texture layer to which the color attachment will render, default is 0
      * @returns The fetched FrameBuffer object.
      */
-    fetchTemporalFramebuffer<T extends BaseTexture<unknown>>(autoRelease: boolean, width: number, height: number, colorTexOrFormat: TextureFormat | T, depthTexOrFormat?: TextureFormat | T, mipmapping?: boolean, sampleCount?: number, ignoreDepthStencil?: boolean): FrameBuffer;
+    fetchTemporalFramebuffer<T extends BaseTexture<unknown>>(autoRelease: boolean, width: number, height: number, colorTexOrFormat: MaybeArray<TextureFormat | T>, depthTexOrFormat?: TextureFormat | T, mipmapping?: boolean, sampleCount?: number, ignoreDepthStencil?: boolean, attachmentMipLevel?: number, attachmentCubeface?: number, attachmentLayer?: number): FrameBuffer;
     /**
      * Creates a temporal framebuffer from the object pool.
      * @param autoRelease - Whether the framebuffer should be automatically released at the next frame.
      * @param colorAttachments - Array of color attachments for the framebuffer.
      * @param depthAttachment - Depth attachment for the framebuffer.
-     * @param sampleCount - The sample count for the framebuffer.
-     * @param ignoreDepthStencil - Whether to ignore depth stencil.
+     * @param sampleCount - The sample count for the framebuffer, default is 1.
+     * @param ignoreDepthStencil - Whether to ignore depth stencil when resolving msaa framebuffer, default is true.
+     * @param attachmentMipLevel - The mipmap level to which the color attachment will render, default is 0.
+     * @param attachmentCubeface - The cubemap face to which the color attachment will render, default is 0.
+     * @param attachmentLayer - The texture layer to which the color attachment will render, default is 0.
      * @returns The fetched FrameBuffer object.
      */
-    createTemporalFramebuffer(autoRelease: boolean, colorAttachments: BaseTexture[], depthAttachment?: BaseTexture, sampleCount?: number, ignoreDepthStencil?: boolean): FrameBuffer<unknown>;
+    createTemporalFramebuffer(autoRelease: boolean, colorAttachments: BaseTexture[], depthAttachment?: BaseTexture, sampleCount?: number, ignoreDepthStencil?: boolean, attachmentMipLevel?: number, attachmentCubeface?: number, attachmentLayer?: number): FrameBuffer;
     /**
      * Dispose a texture that is allocated from the object pool.
      * @param texture - The texture to dispose.
@@ -2820,6 +2883,11 @@ declare class Pool {
      * @param texture - The texture to release.
      */
     releaseTexture(texture: BaseTexture): void;
+    /**
+     * Increment reference counter for given texture
+     * @param texture - The texture to retain
+     */
+    retainTexture(texture: BaseTexture): void;
     /**
      * Dispose a framebuffer that is allocated from the object pool.
      * @param fb - The framebuffer to dispose.
@@ -2830,6 +2898,11 @@ declare class Pool {
      * @param fb - The framebuffer to release.
      */
     releaseFrameBuffer(fb: FrameBuffer): void;
+    /**
+     * Increment reference counter for given framebuffer
+     * @param fb - The framebuffer to retain
+     */
+    retainFrameBuffer(fb: FrameBuffer): void;
     /**
      * Purge the object pool by disposing all free framebuffers and textures.
      */
@@ -3060,6 +3133,8 @@ interface DeviceCaps {
 interface FramebufferCaps {
     /** The maximum number of framebuffer color attachment points */
     maxDrawBuffers: number;
+    /** True if device supports rendering to mipmap */
+    supportRenderMipmap: boolean;
     /** True if device supports multisampled frame buffer */
     supportMultisampledFramebuffer: boolean;
     /** True if device supports blending on float point frame buffer */
@@ -3122,6 +3197,12 @@ interface TextureFormatInfo {
     renderable: boolean;
     /** True if the texture format is a compressed format */
     compressed: boolean;
+    /** Number of bytes per-block */
+    size: number;
+    /** Block width */
+    blockWidth: number;
+    /** Block height */
+    blockHeight: number;
 }
 /**
  * Texture related capabilities of the device'
@@ -3211,70 +3292,6 @@ interface GPUProgramConstructParams {
     /** The creation options */
     params: RenderProgramConstructParams | ComputeProgramConstructParams;
 }
-/**
- * Event that will be fired when device is lost
- * @public
- */
-declare class DeviceLostEvent {
-    /** The event name */
-    static readonly NAME: "devicelost";
-    type: "devicelost";
-}
-/**
- * Event that will be fired when device has just been restored
- * @public
- */
-declare class DeviceRestoreEvent {
-    /** The event name */
-    static readonly NAME: "devicerestored";
-    type: "devicerestored";
-}
-/**
- * Event that will be fired when size of back buffer has changed
- * @public
- */
-declare class DeviceResizeEvent {
-    /** The event name */
-    static readonly NAME: "resize";
-    width: number;
-    height: number;
-    type: "resize";
-    constructor(width: number, height: number);
-}
-/**
- * Event that will be fired when any gpu object is created
- * @public
- */
-declare class DeviceGPUObjectAddedEvent {
-    /** the event name */
-    static readonly NAME: "gpuobject_added";
-    object: GPUObject;
-    type: "gpuobject_added";
-    constructor(obj: GPUObject);
-}
-/**
- * Event that will be fired when any gpu object is disposed
- * @public
- */
-declare class DeviceGPUObjectRemovedEvent {
-    /** The event name */
-    static readonly NAME: 'gpuobject_removed';
-    object: GPUObject;
-    type: "gpuobject_removed";
-    constructor(obj: GPUObject);
-}
-/**
- * Event that will be fired when any gpu object name is changed
- * @public
- */
-declare class DeviceGPUObjectRenameEvent {
-    /** The event name */
-    static readonly NAME: 'gpuobject_rename';
-    object: GPUObject;
-    lastName: string;
-    type: "gpuobject_rename";
-    constructor(obj: GPUObject, lastName: string);
-}
 /**
  * Creation options for device
  * @public
@@ -3290,12 +3307,12 @@ interface DeviceOptions {
  * @public
  */
 type DeviceEventMap = {
-    [DeviceResizeEvent.NAME]: DeviceResizeEvent;
-    [DeviceLostEvent.NAME]: DeviceLostEvent;
-    [DeviceRestoreEvent.NAME]: DeviceRestoreEvent;
-    [DeviceGPUObjectAddedEvent.NAME]: DeviceGPUObjectAddedEvent;
-    [DeviceGPUObjectRemovedEvent.NAME]: DeviceGPUObjectRemovedEvent;
-    [DeviceGPUObjectRenameEvent.NAME]: DeviceGPUObjectRenameEvent;
+    resize: [width: number, height: number];
+    devicelost: [];
+    devicerestored: [];
+    gpuobject_added: [obj: GPUObject];
+    gpuobject_removed: [obj: GPUObject];
+    gpuobject_rename: [obj: GPUObject, lastName: string];
 };
 /**
  * Structure that contains the device viewport information
@@ -3326,6 +3343,10 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
     pool: Pool;
     /** vSync */
     vSync: boolean;
+    /** Check if a pool with given key exists */
+    poolExists(key: string | symbol): boolean;
+    /** Get the pool with given key, or create a new one if not exists */
+    getPool(key: string | symbol): Pool;
     /** Get adapter information */
     getAdapterInfo(): any;
     /** Get sample count of current frame buffer */
@@ -3367,9 +3388,20 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
     clearFrameBuffer(clearColor: Vector4, clearDepth: number, clearStencil: number): any;
     /** Creates a render state set object */
     createRenderStateSet(): RenderStateSet;
+    /** Creates a blending state object */
+    createBlendingState(): BlendingState;
+    /** Creates a color state object */
+    createColorState(): ColorState;
+    /** Creates a rasterizer state object */
+    createRasterizerState(): RasterizerState;
+    /** Creates a depth state object */
+    createDepthState(): DepthState;
+    /** Creates a stencil state object */
+    createStencilState(): StencilState;
     /**
      * Creates a texture sampler object
      * @param options - The creation options
+     * @returns The created texture sampler
      */
     createSampler(options: SamplerOptions): TextureSampler;
     /**
@@ -3385,18 +3417,14 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * @param width - Pixel width of the texture
      * @param height - Pixel height of the texture
      * @param options - The creation options
+     * @returns The created 2D texture
      */
     createTexture2D(format: TextureFormat, width: number, height: number, options?: TextureCreationOptions): Texture2D;
-    /**
-     * Creates a 2d texture from given mipmap data
-     * @param data - The mipmap data
-     * @param options - The creation options
-     */
-    createTexture2DFromMipmapData(data: TextureMipmapData, sRGB: boolean, options?: TextureCreationOptions): Texture2D;
     /**
      * Creates a 2d texture from a image element
      * @param element - The image element
      * @param options - The creation options
+     * @returns The created 2D texture.
      */
     createTexture2DFromImage(element: TextureImageElement, sRGB: boolean, options?: TextureCreationOptions): Texture2D;
     /**
@@ -3406,29 +3434,25 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * @param height - Pixel height of the texture
      * @param depth - Array length of the texture
      * @param options - The creation options
+     * @returns The created 2D array texture.
      */
     createTexture2DArray(format: TextureFormat, width: number, height: number, depth: number, options?: TextureCreationOptions): Texture2DArray;
-    /**
-     * Creates a 2d array texture from mipmap data
-     * @param data - mipmap data
-     * @param sRGB - whether texture should have sRGB texture format
-     * @param options - The creation options
-     */
-    createTexture2DArrayFromMipmapData(data: TextureMipmapData, options?: TextureCreationOptions): Texture2DArray;
     /**
      * Creates a 2d array texture from a seris of image elements
      * @remarks image elements must have the same size.
      * @param elements - image elements
      * @param options - The creation options
+     * @returns The created 2D array texture.
      */
     createTexture2DArrayFromImages(elements: TextureImageElement[], sRGB: boolean, options?: TextureCreationOptions): Texture2DArray;
     /**
-     * Creates a 3d texture
+     * Creates a 3D texture
      * @param format - The texture format
      * @param width - Pixel width of the texture
      * @param height - Pixel height of the texture
      * @param depth - Pixel depth of the texture
      * @param options - The creation options
+     * @returns The created 3D texture.
      */
     createTexture3D(format: TextureFormat, width: number, height: number, depth: number, options?: TextureCreationOptions): Texture3D;
     /**
@@ -3436,19 +3460,39 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * @param format - The texture format
      * @param size - Pixel width of the texture
      * @param options - The creation options
+     * @returns The created cube texture.
      */
     createCubeTexture(format: TextureFormat, size: number, options?: TextureCreationOptions): TextureCube;
-    /**
-     * Creates a cube texture from given mipmap data
-     * @param data - The mipmap data
-     * @param options - The creation options
-     */
-    createCubeTextureFromMipmapData(data: TextureMipmapData, sRGB: boolean, options?: TextureCreationOptions): TextureCube;
     /**
      * Creates a video texture from a video element
      * @param el - The video element
+     * @returns The created video texture.
      */
     createTextureVideo(el: HTMLVideoElement, samplerOptions?: SamplerOptions): TextureVideo;
+    /**
+     * Copies a 2d texture to another texture.
+     *
+     * @remarks
+     * The two textures must have the same size and format
+     *
+     * @param src - Texture that will be copied from.
+     * @param srcLevel - Which mipmap level to be copied from.
+     * @param dst - Texture that will be copied to.
+     * @param dstLevel - Which mipmap level to be copied to.
+     */
+    copyTexture2D(src: Texture2D, srcLevel: number, dst: Texture2D, dstLevel: number): any;
+    /**
+     * Copies a color attachment of a framebuffer to a mipmap level of a texture.
+     *
+     * @remarks
+     * The color attachment and the mipmap level must have the same size and format
+     *
+     * @param src - Framebuffer that will be copied from.
+     * @param index - Color attachment index of the framebuffer.
+     * @param dst - Texture that will be copied to.
+     * @param level - Which mipmap level should be copied to.
+     */
+    copyFramebufferToTexture2D(src: FrameBuffer, index: number, dst: Texture2D, level: number): any;
     /**
      * Set wether to reverse the winding order
      *
@@ -3465,17 +3509,20 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
     /**
      * Creates a gpu program
      * @param params - The creation options
+     * @returns The created program.
      */
     createGPUProgram(params: GPUProgramConstructParams): GPUProgram;
     /**
      * Creates a bind group
      * @param layout - Layout of the bind group
+     * @returns The created bind group.
      */
     createBindGroup(layout: BindGroupLayout): BindGroup;
     /**
      * Creates a gpu buffer
      * @param sizeInBytes - Size of the buffer in bytes
      * @param options - The creation options
+     * @returns The created buffer.
      */
     createBuffer(sizeInBytes: number, options: BufferCreationOptions): GPUDataBuffer;
     /**
@@ -3491,23 +3538,27 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * Creates an index buffer
      * @param data - Data of the index buffer
      * @param options - The creation options
+     * @returns The created index buffer.
      */
-    createIndexBuffer(data: Uint16Array | Uint32Array, options?: BufferCreationOptions): IndexBuffer;
+    createIndexBuffer(data: Uint16Array<ArrayBuffer> | Uint32Array<ArrayBuffer>, options?: BufferCreationOptions): IndexBuffer;
     /**
      * Creates a structured buffer
      * @param structureType - The structure type
      * @param options - The creation options
      * @param data - Data to be filled with
+     * @returns The created structured buffer.
      */
     createStructuredBuffer(structureType: PBStructTypeInfo, options: BufferCreationOptions, data?: TypedArray): StructuredBuffer;
     /**
-     * Creates a vertex layout
+     * Creates a vertex layout object.
      * @param options - The creation options
+     * @returns The created vertex layout object.
      */
     createVertexLayout(options: VertexLayoutOptions): VertexLayout;
     /**
      * Creates a frame buffer
      * @param options - The creation options
+     * @returns The created framebuffer.
      */
     createFrameBuffer(colorAttachments: BaseTexture[], depthAttachment: BaseTexture, options?: FrameBufferOptions): FrameBuffer;
     /**
@@ -3654,14 +3705,14 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * Begins a frame for rendering
      *
      * @remarks
-     * All rendering call must occur between the {@link AbstractDevice.beginFrame} and {@link AbstractDevice.endFrame} methods
+     * All rendering call must occur between the @see AbstractDevice.beginFrame and @see AbstractDevice.endFrame methods
      */
     beginFrame(): boolean;
     /**
      * Ends a frame for rendering
      *
      * @remarks
-     * All rendering call must occur between the {@link AbstractDevice.beginFrame} and {@link AbstractDevice.endFrame} methods
+     * All rendering call must occur between the @see AbstractDevice.beginFrame and @see AbstractDevice.endFrame methods
      */
     endFrame(): void;
     /**
@@ -3678,6 +3729,7 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * @param attribFormats - The vertex attribute formats for each vertex stream in the vertex buffer
      * @param data - Data to be filled with
      * @param options - The creation options
+     * @returns The created vertex buffer.
      */
     createInterleavedVertexBuffer(attribFormats: VertexAttribFormat[], data: TypedArray, options?: BufferCreationOptions): StructuredBuffer;
     /**
@@ -3686,6 +3738,7 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * @param attribFormat - The vertex attribute format
      * @param data - Data to be filled with
      * @param options - The creation options
+     * @returns The created vertex buffer
      */
     createVertexBuffer(attribFormat: VertexAttribFormat, data: TypedArray, options?: BufferCreationOptions): StructuredBuffer;
     /**
@@ -3719,6 +3772,12 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * @param f - The function to be scheduled
      */
     runNextFrame(f: () => void): void;
+    /**
+     * Asyncronized version of scheduling a function to be executed at the beginning of the next frame
+     *
+     * @param f - The function to be scheduled
+     */
+    runNextFrameAsync(f: () => void): Promise<void>;
     /** Exits from current rendering loop */
     exitLoop(): void;
     /**
@@ -3799,7 +3858,7 @@ interface DeviceBackend {
  * Base class for rendering device
  * @public
  */
-declare abstract class BaseDevice {
+declare abstract class BaseDevice extends Observable<DeviceEventMap> {
     protected _canvas: HTMLCanvasElement;
     protected _canvasClientWidth: number;
     protected _canvasClientHeight: number;
@@ -3820,10 +3879,11 @@ declare abstract class BaseDevice {
     protected _backend: DeviceBackend;
     protected _beginFrameCounter: number;
     protected _programBuilder: ProgramBuilder;
-    protected _pool: Pool;
+    protected _poolMap: Map<string | symbol, Pool>;
+    protected _defaultPoolKey: symbol;
     protected _temporalFramebuffer: boolean;
     protected _vSync: boolean;
-    private _stateStack;
+    private readonly _stateStack;
     constructor(cvs: HTMLCanvasElement, backend: DeviceBackend);
     abstract getAdapterInfo(): any;
     abstract getFrameBufferSampleCount(): number;
@@ -3838,25 +3898,29 @@ declare abstract class BaseDevice {
     abstract clearFrameBuffer(clearColor: Vector4, clearDepth: number, clearStencil: number): any;
     abstract createGPUTimer(): ITimer;
     abstract createRenderStateSet(): RenderStateSet;
+    abstract createBlendingState(): BlendingState;
+    abstract createColorState(): ColorState;
+    abstract createRasterizerState(): RasterizerState;
+    abstract createDepthState(): DepthState;
+    abstract createStencilState(): StencilState;
     abstract createSampler(options: SamplerOptions): TextureSampler;
     abstract createTextureFromMipmapData<T extends BaseTexture>(data: TextureMipmapData, sRGB: boolean, options?: TextureCreationOptions): T;
     abstract createTexture2D(format: TextureFormat, width: number, height: number, options?: TextureCreationOptions): Texture2D;
-    abstract createTexture2DFromMipmapData(data: TextureMipmapData, sRGB: boolean, options?: TextureCreationOptions): Texture2D;
     abstract createTexture2DFromImage(element: TextureImageElement, sRGB: boolean, options?: TextureCreationOptions): Texture2D;
     abstract createTexture2DArray(format: TextureFormat, width: number, height: number, depth: number, options?: TextureCreationOptions): Texture2DArray;
-    abstract createTexture2DArrayFromMipmapData(data: TextureMipmapData, options?: TextureCreationOptions): Texture2DArray;
     abstract createTexture2DArrayFromImages(elements: TextureImageElement[], sRGB: boolean, options?: TextureCreationOptions): Texture2DArray;
     abstract createTexture3D(format: TextureFormat, width: number, height: number, depth: number, options?: TextureCreationOptions): Texture3D;
     abstract createCubeTexture(format: TextureFormat, size: number, options?: TextureCreationOptions): TextureCube;
-    abstract createCubeTextureFromMipmapData(data: TextureMipmapData, sRGB: boolean, options?: TextureCreationOptions): TextureCube;
     abstract createTextureVideo(el: HTMLVideoElement, samplerOptions?: SamplerOptions): TextureVideo;
     abstract reverseVertexWindingOrder(reverse: boolean): void;
     abstract isWindingOrderReversed(): boolean;
+    abstract copyTexture2D(src: Texture2D, srcLevel: number, dst: Texture2D, dstLevel: number): any;
+    abstract copyFramebufferToTexture2D(src: FrameBuffer, index: number, dst: Texture2D, level: number): any;
     abstract createGPUProgram(params: GPUProgramConstructParams): GPUProgram;
     abstract createBindGroup(layout: BindGroupLayout): BindGroup;
     abstract createBuffer(sizeInBytes: number, options: BufferCreationOptions): GPUDataBuffer;
     abstract copyBuffer(sourceBuffer: GPUDataBuffer, destBuffer: GPUDataBuffer, srcOffset: number, dstOffset: number, bytes: number): any;
-    abstract createIndexBuffer(data: Uint16Array | Uint32Array, options?: BufferCreationOptions): IndexBuffer;
+    abstract createIndexBuffer(data: Uint16Array<ArrayBuffer> | Uint32Array<ArrayBuffer>, options?: BufferCreationOptions): IndexBuffer;
     abstract createStructuredBuffer(structureType: PBStructTypeInfo, options: BufferCreationOptions, data?: TypedArray): StructuredBuffer;
     abstract createVertexLayout(options: VertexLayoutOptions): VertexLayout;
     abstract createFrameBuffer(colorAttachments: BaseTexture[], depthAttachment: BaseTexture, options?: FrameBufferOptions): FrameBuffer;
@@ -3880,9 +3944,9 @@ declare abstract class BaseDevice {
     abstract readPixelsToBuffer(index: number, x: number, y: number, w: number, h: number, buffer: GPUDataBuffer): void;
     abstract beginCapture(): void;
     abstract endCapture(): RenderBundle;
-    abstract executeRenderBundle(renderBundle: RenderBundle): any;
     abstract looseContext(): void;
     abstract restoreContext(): void;
+    protected abstract _executeRenderBundle(renderBundle: RenderBundle): number;
     protected abstract _draw(primitiveType: PrimitiveType, first: number, count: number): void;
     protected abstract _drawInstanced(primitiveType: PrimitiveType, first: number, count: number, numInstances: number): void;
     protected abstract _compute(workgroupCountX: number, workgroupCountY: number, workgroupCountZ: number): void;
@@ -3897,17 +3961,14 @@ declare abstract class BaseDevice {
     get pool(): Pool;
     get runLoopFunction(): (device: AbstractDevice) => void;
     get programBuilder(): ProgramBuilder;
+    poolExists(key: string | symbol): boolean;
+    getPool(key: string | symbol): Pool;
     setFont(fontName: string): void;
     drawText(text: string, x: number, y: number, color: string): void;
     setFramebuffer(rt: FrameBuffer): any;
-    setFramebuffer(color: (BaseTexture | {
-        texture: BaseTexture;
-        miplevel?: number;
-        face?: number;
-        layer?: number;
-    })[], depth?: BaseTexture, sampleCount?: number): any;
+    setFramebuffer(color: BaseTexture[], depth?: BaseTexture, sampleCount?: number): any;
     disposeObject(obj: GPUObject, remove?: boolean): void;
-    restoreObject(obj: GPUObject): Promise<void>;
+    restoreObject(obj: GPUObject): void;
     enableGPUTimeRecording(enable: boolean): void;
     beginFrame(): boolean;
     endFrame(): void;
@@ -3916,8 +3977,10 @@ declare abstract class BaseDevice {
     createVertexBuffer(attribFormat: VertexAttribFormat, data: TypedArray, options?: BufferCreationOptions): StructuredBuffer;
     draw(primitiveType: PrimitiveType, first: number, count: number): void;
     drawInstanced(primitiveType: PrimitiveType, first: number, count: number, numInstances: number): void;
+    executeRenderBundle(renderBundle: RenderBundle): void;
     compute(workgroupCountX: any, workgroupCountY: any, workgroupCountZ: any): void;
     runNextFrame(f: () => void): void;
+    runNextFrameAsync(f: () => void | Promise<void>): Promise<void>;
     exitLoop(): void;
     runLoop(func: (device: AbstractDevice) => void): void;
     pushDeviceStates(): void;
@@ -3939,7 +4002,7 @@ declare abstract class BaseDevice {
     private updateFrameInfo;
     private getGPUObjectList;
     protected invalidateAll(): void;
-    protected reloadAll(): Promise<void>;
+    protected reloadAll(): void;
     protected parseTextureOptions(options?: TextureCreationOptions): number;
     protected parseBufferOptions(options: BufferCreationOptions, defaultUsage?: BufferUsage): number;
 }
@@ -3981,8 +4044,8 @@ declare class TextureAtlasManager {
      * The texture restore handler callback function
      * This callback function will be called whenever the device has been restored
      */
-    get atlasTextureRestoreHandler(): (tex: BaseTexture) => Promise<void>;
-    set atlasTextureRestoreHandler(f: (tex: BaseTexture) => Promise<void>);
+    get atlasTextureRestoreHandler(): (tex: BaseTexture) => void;
+    set atlasTextureRestoreHandler(f: (tex: BaseTexture) => void);
     /**
      * Gets the atlas texture of a given index
      * @param index - Index of the atlas bin
@@ -4161,4 +4224,4 @@ declare class StructuredBufferData {
     set(name: string, value: StructuredValue): void;
 }
 
-export { AbstractDevice, ArrayTypeDetail, AtlasInfo, AtomicTypeInfoDetail, BaseCreationOptions, BaseDevice, BaseTexture, BindGroup, BindGroupLayout, BindGroupLayoutEntry, BindPointInfo, BlendEquation, BlendFunc, BlendingState, BufferBindingLayout, BufferCreationOptions, BufferUsage, CPUTimer, ColorState, CompareFunc, ComputeProgramConstructParams, DataType, DepthState, DeviceBackend, DeviceCaps, DeviceEventMap, DeviceGPUObjectAddedEvent, DeviceGPUObjectRemovedEvent, DeviceGPUObjectRenameEvent, DeviceLostEvent, DeviceOptions, DeviceResizeEvent, DeviceRestoreEvent, DeviceViewport, DrawText, ExpValueNonArrayType, ExpValueType, ExternalTextureBindingLayout, FaceMode, FaceWinding, Font, FrameBuffer, FrameBufferOptions, FrameBufferTextureAttachment, FrameInfo, FramebufferCaps, FunctionTypeDetail, GPUDataBuffer, GPUObject, GPUObjectList, GPUProgram, GPUProgramConstructParams, GPUResourceUsageFlags, GlyphManager, ITimer, IndexBuffer, MiscCaps, PBAddressSpace, PBAnyTypeInfo, PBArrayTypeInfo, PBAtomicI32TypeInfo, PBAtomicU32TypeInfo, PBBuiltinScope, PBComputeOptions, PBDoWhileScope, PBForScope, PBFunctionScope, PBFunctionTypeInfo, PBGlobalScope, PBIfScope, PBInputScope, PBInsideFunctionScope, PBLocalScope, PBNakedScope, PBOutputScope, PBPointerTypeInfo, PBPrimitiveType, PBPrimitiveTypeInfo, PBReflection, PBReflectionTagGetter, PBRenderOptions, PBSamplerAccessMode, PBSamplerTypeInfo, PBScope, PBShaderExp, PBStructLayout, PBStructTypeInfo, PBTextureType, PBTextureTypeInfo, PBTypeInfo, PBVoidTypeInfo, PBWhileScope, PointerTypeDetail, PrimitiveType, PrimitiveTypeDetail, ProgramBuilder, Proxiable, RasterizerState, RenderBundle, RenderProgramConstructParams, RenderStateSet, SamplerBindingLayout, SamplerOptions, SamplerTypeDetail, ShaderCaps, ShaderExpTagRecord, ShaderExpTagValue, ShaderKind, ShaderType, ShaderTypeFunc, StencilOp, StencilState, StorageTextureBindingLayout, StructTypeDetail, StructuredBuffer, StructuredBufferData, StructuredValue, Texture2D, Texture2DArray, Texture3D, TextureAddressMode, TextureAtlasManager, TextureBindingLayout, TextureCaps, TextureColorSpace, TextureCreationOptions, TextureCube, TextureFilterMode, TextureFormat, TextureFormatInfo, TextureImageElement, TextureMipmapData, TextureMipmapLevelData, TextureSampler, TextureType, TextureTypeDetail, TextureVideo, TypeDetailInfo, UniformBufferLayout, UniformLayout, VertexAttribFormat, VertexBufferInfo, VertexData, VertexLayout, VertexLayoutOptions, VertexSemantic, VertexStepMode, WebGLContext, genDefaultName, getTextureFormatBlockHeight, getTextureFormatBlockSize, getTextureFormatBlockWidth, getVertexAttribByName, getVertexAttribFormat, getVertexAttribName, getVertexBufferAttribType, getVertexBufferAttribTypeBySemantic, getVertexBufferLength, getVertexBufferStride, getVertexFormatComponentCount, getVertexFormatSize, hasAlphaChannel, hasBlueChannel, hasDepthChannel, hasGreenChannel, hasRedChannel, hasStencilChannel, isCompressedTextureFormat, isFloatTextureFormat, isIntegerTextureFormat, isSRGBTextureFormat, isSignedTextureFormat, linearTextureFormatToSRGB, makeVertexBufferType, semanticList };
+export { type AbstractDevice, type ArrayTypeDetail, type AtlasInfo, type AtomicTypeInfoDetail, type BaseCreationOptions, BaseDevice, type BaseTexture, type BindGroup, type BindGroupLayout, type BindGroupLayoutEntry, type BindPointInfo, type BlendEquation, type BlendFunc, type BlendingState, type BufferBindingLayout, type BufferCreationOptions, type BufferUsage, CPUTimer, type ColorState, type CompareFunc, type ComputeProgramConstructParams, type DataType, type DepthState, type DeviceBackend, type DeviceCaps, type DeviceEventMap, type DeviceOptions, type DeviceViewport, DrawText, type ExpValueNonArrayType, type ExpValueType, type ExternalTextureBindingLayout, type FaceMode, type FaceWinding, Font, type FrameBuffer, type FrameBufferOptions, type FrameBufferTextureAttachment, type FrameInfo, type FramebufferCaps, type FunctionTypeDetail, type GPUDataBuffer, type GPUObject, type GPUObjectList, type GPUProgram, type GPUProgramConstructParams, GPUResourceUsageFlags, GlyphManager, type ITimer, type IndexBuffer, MAX_BINDING_GROUPS, MAX_TEXCOORD_INDEX_COUNT, MAX_VERTEX_ATTRIBUTES, type MiscCaps, PBAddressSpace, PBAnyTypeInfo, PBArrayTypeInfo, PBAtomicI32TypeInfo, PBAtomicU32TypeInfo, PBBuiltinScope, type PBComputeOptions, PBDoWhileScope, PBForScope, PBFunctionScope, PBFunctionTypeInfo, PBGlobalScope, PBIfScope, PBInputScope, PBInsideFunctionScope, PBLocalScope, PBNakedScope, PBOutputScope, PBPointerTypeInfo, PBPrimitiveType, PBPrimitiveTypeInfo, PBReflection, type PBReflectionTagGetter, type PBRenderOptions, PBSamplerAccessMode, PBSamplerTypeInfo, PBScope, PBShaderExp, type PBStructLayout, PBStructTypeInfo, PBTextureType, PBTextureTypeInfo, PBTypeInfo, PBVoidTypeInfo, PBWhileScope, type PointerTypeDetail, Pool, type PrimitiveType, type PrimitiveTypeDetail, ProgramBuilder, Proxiable, type RasterizerState, type RenderBundle, type RenderProgramConstructParams, type RenderStateSet, type SamplerBindingLayout, type SamplerOptions, type SamplerTypeDetail, type ShaderCaps, type ShaderExpTagRecord, type ShaderExpTagValue, type ShaderKind, ShaderType, type ShaderTypeFunc, type StencilOp, type StencilState, type StorageTextureBindingLayout, type StructTypeDetail, type StructuredBuffer, StructuredBufferData, type StructuredValue, type Texture2D, type Texture2DArray, type Texture3D, type TextureAddressMode, TextureAtlasManager, type TextureBindingLayout, type TextureCaps, type TextureColorSpace, type TextureCreationOptions, type TextureCube, type TextureFilterMode, type TextureFormat, type TextureFormatInfo, type TextureImageElement, type TextureMipmapData, type TextureMipmapLevelData, type TextureSampler, type TextureType, type TextureTypeDetail, type TextureVideo, type TypeDetailInfo, type UniformBufferLayout, type UniformLayout, VERTEX_ATTRIB_BLEND_INDICES, VERTEX_ATTRIB_BLEND_WEIGHT, VERTEX_ATTRIB_DIFFUSE, VERTEX_ATTRIB_NORMAL, VERTEX_ATTRIB_POSITION, VERTEX_ATTRIB_TANGENT, VERTEX_ATTRIB_TEXCOORD0, VERTEX_ATTRIB_TEXCOORD1, VERTEX_ATTRIB_TEXCOORD2, VERTEX_ATTRIB_TEXCOORD3, VERTEX_ATTRIB_TEXCOORD4, VERTEX_ATTRIB_TEXCOORD5, VERTEX_ATTRIB_TEXCOORD6, VERTEX_ATTRIB_TEXCOORD7, type VertexAttribFormat, type VertexBufferInfo, VertexData, type VertexLayout, type VertexLayoutOptions, type VertexSemantic, type VertexStepMode, type WebGLContext, genDefaultName, getTextureFormatBlockHeight, getTextureFormatBlockSize, getTextureFormatBlockWidth, getVertexAttribByName, getVertexAttribFormat, getVertexAttribName, getVertexAttributeFormat, getVertexAttributeIndex, getVertexBufferAttribType, getVertexBufferAttribTypeBySemantic, getVertexBufferLength, getVertexBufferStride, getVertexFormatComponentCount, getVertexFormatSize, hasAlphaChannel, hasBlueChannel, hasDepthChannel, hasGreenChannel, hasRedChannel, hasStencilChannel, isCompressedTextureFormat, isFloatTextureFormat, isIntegerTextureFormat, isSRGBTextureFormat, isSignedTextureFormat, linearTextureFormatToSRGB, makeVertexBufferType, matchVertexBuffer, semanticList };