@zephyr3d/device 0.2.4 → 0.2.6

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { TypedArray, IEventTarget, CubeFace, VectorBase, MaybeArray, Vector4 } from '@zephyr3d/base';
+import { Nullable, Immutable, TypedArray, IDisposable, CubeFace, VectorBase, MaybeArray, IEventTarget, Vector4, Observable } from '@zephyr3d/base';
 
 /**
  * Struct layout types
@@ -149,7 +149,7 @@ type TypeDetailInfo = PrimitiveTypeDetail | StructTypeDetail | ArrayTypeDetail |
  * @public
  */
 interface PrimitiveTypeDetail {
-    primitiveType?: PBPrimitiveType;
+    primitiveType: PBPrimitiveType;
 }
 /**
  * Detail informations for struct type
@@ -159,9 +159,9 @@ interface StructTypeDetail {
     /** Layout of the struct type */
     layout: PBStructLayout;
     /** Name of the struct type */
-    structName?: string;
+    structName: Nullable<string>;
     /** Members of the struct type */
-    structMembers?: {
+    structMembers: {
         /** Name of the struct member */
         name: string;
         /** Type of the struct member */
@@ -216,7 +216,7 @@ interface TextureTypeDetail {
     /** type of the texture */
     textureType: PBTextureType;
     /** texture format if this is a storage texture */
-    storageTexelFormat: TextureFormat;
+    storageTexelFormat: Nullable<TextureFormat>;
     /** true if this is a readable storage texture type */
     readable: boolean;
     /** true if this is a writable storage texture type */
@@ -280,7 +280,7 @@ declare abstract class PBTypeInfo<DetailType extends TypeDetailInfo = TypeDetail
      * @param layout - Type of the layout
      * @returns The created buffer layout
      */
-    abstract toBufferLayout(offset: number, layout: PBStructLayout): UniformBufferLayout;
+    abstract toBufferLayout(offset: number, layout: PBStructLayout): Nullable<UniformBufferLayout>;
 }
 /**
  * The void type info
@@ -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): null;
 }
 /**
  * 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): null;
     /** {@inheritDoc PBTypeInfo.isCompatibleType} */
-    isCompatibleType(other: PBTypeInfo<TypeDetailInfo>): boolean;
+    isCompatibleType(_other: PBTypeInfo<TypeDetailInfo>): boolean;
 }
 /**
  * The primitive type info
@@ -342,28 +342,28 @@ declare class PBPrimitiveTypeInfo extends PBTypeInfo<PrimitiveTypeDetail> {
     /** {@inheritDoc PBTypeInfo.isPrimitiveType} */
     isPrimitiveType(): this is PBPrimitiveTypeInfo;
     /** {@inheritDoc PBTypeInfo.toBufferLayout} */
-    toBufferLayout(offset: number): UniformBufferLayout;
+    toBufferLayout(_offset: number): null;
 }
 /**
  * The struct type info
  * @public
  */
 declare class PBStructTypeInfo extends PBTypeInfo<StructTypeDetail> {
-    constructor(name: string, layout: PBStructLayout, members: {
+    constructor(name: Nullable<string>, layout: PBStructLayout, members: {
         name: string;
         type: PBPrimitiveTypeInfo | PBArrayTypeInfo | PBAtomicI32TypeInfo | PBAtomicU32TypeInfo | PBStructTypeInfo;
     }[]);
     /** Get the layout type */
     get layout(): PBStructLayout;
     /** Get name of the struct type */
-    get structName(): string;
-    set structName(val: string);
+    get structName(): Nullable<string>;
+    set structName(val: Nullable<string>);
     /** Get member types of the struct type */
     get structMembers(): {
         /** 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 */
@@ -397,7 +397,7 @@ declare class PBStructTypeInfo extends PBTypeInfo<StructTypeDetail> {
 declare class PBArrayTypeInfo extends PBTypeInfo<ArrayTypeDetail> {
     constructor(elementType: PBPrimitiveTypeInfo | PBArrayTypeInfo | PBStructTypeInfo | PBAnyTypeInfo | PBAtomicI32TypeInfo | PBAtomicU32TypeInfo, dimension?: number);
     /** Get the element type */
-    get elementType(): PBPrimitiveTypeInfo | PBArrayTypeInfo | PBStructTypeInfo | PBAnyTypeInfo | PBAtomicI32TypeInfo | PBAtomicU32TypeInfo;
+    get elementType(): PBPrimitiveTypeInfo | PBArrayTypeInfo | PBStructTypeInfo | PBAtomicI32TypeInfo | PBAtomicU32TypeInfo | PBAnyTypeInfo;
     /** Get dimension of the array type */
     get dimension(): number;
     /** Wether array have atomic members */
@@ -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): null;
     isCompatibleType(other: PBTypeInfo<TypeDetailInfo>): boolean;
 }
 /**
@@ -415,7 +415,7 @@ declare class PBArrayTypeInfo extends PBTypeInfo<ArrayTypeDetail> {
 declare class PBPointerTypeInfo extends PBTypeInfo<PointerTypeDetail> {
     constructor(pointerType: PBTypeInfo, addressSpace: PBAddressSpace);
     /** Get type of the pointer */
-    get pointerType(): PBTypeInfo;
+    get pointerType(): PBTypeInfo<TypeDetailInfo>;
     /** Get address space of the pointer */
     get addressSpace(): PBAddressSpace;
     set addressSpace(val: PBAddressSpace);
@@ -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): null;
 }
 /**
  * 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): null;
 }
 /**
  * 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): null;
 }
 /**
  * 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): null;
 }
 /**
  * The texture type info
@@ -468,7 +468,7 @@ declare class PBTextureTypeInfo extends PBTypeInfo<TextureTypeDetail> {
     /** Get the texture type */
     get textureType(): PBTextureType;
     /** Get texture format if this is a storage texture */
-    get storageTexelFormat(): TextureFormat;
+    get storageTexelFormat(): Nullable<TextureFormat>;
     /** Returns true if this is a readable storage texture type */
     get readable(): boolean;
     set readable(val: boolean);
@@ -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): null;
 }
 /**
  * The function type info
@@ -510,16 +510,18 @@ declare class PBFunctionTypeInfo extends PBTypeInfo<FunctionTypeDetail> {
     /** Get name of the function */
     get name(): string;
     /** Get return type of the function */
-    get returnType(): PBTypeInfo;
+    get returnType(): PBTypeInfo<TypeDetailInfo>;
     /** Get all the argument types for this function */
     get argTypes(): {
+        /** Type of the argument */
         type: PBTypeInfo;
+        /** true if this argument will be passed by reference */
         byRef?: boolean;
     }[];
     /** Get hash for parameter types */
     get argHash(): string;
     /** {@inheritDoc PBTypeInfo.toBufferLayout} */
-    toBufferLayout(offset: number): UniformBufferLayout;
+    toBufferLayout(_offset: number): null;
 }
 
 /**
@@ -546,9 +548,11 @@ declare class VertexData {
      */
     clone(): VertexData;
     /** Vertex buffer information list */
-    get vertexBuffers(): VertexBufferInfo[];
+    get vertexBuffers(): Nullable<VertexBufferInfo>[];
     /** Index buffer */
-    get indexBuffer(): IndexBuffer<unknown>;
+    get indexBuffer(): Nullable<IndexBuffer<unknown>>;
+    /** Number of vertices */
+    get numVertices(): number;
     /** Draw offset */
     getDrawOffset(): number;
     setDrawOffset(offset: number): void;
@@ -557,25 +561,25 @@ declare class VertexData {
      * @param semantic - The vertex semantic
      * @returns Vertex buffer of the given semantic
      */
-    getVertexBuffer(semantic: VertexSemantic): StructuredBuffer;
+    getVertexBuffer(semantic: VertexSemantic): StructuredBuffer<unknown> | null;
     /**
      * Gets the vertex buffer information by specific vertex semantic
      * @param semantic - The vertex semantic
      * @returns Vertex buffer information of the given semantic
      */
-    getVertexBufferInfo(semantic: VertexSemantic): VertexBufferInfo;
+    getVertexBufferInfo(semantic: VertexSemantic): VertexBufferInfo | null;
     /**
      * Gets the index buffer
      * @returns The index buffer
      */
-    getIndexBuffer(): IndexBuffer;
+    getIndexBuffer(): Nullable<IndexBuffer<unknown>>;
     /**
      * Sets a vertex buffer
      * @param buffer - The vertex buffer object
      * @param stepMode - Step mode of the buffer
      * @returns The buffer that was set
      */
-    setVertexBuffer(buffer: StructuredBuffer, stepMode?: VertexStepMode): StructuredBuffer;
+    setVertexBuffer(buffer: StructuredBuffer, stepMode?: VertexStepMode): StructuredBuffer<unknown> | null;
     /**
      * Removes a vertex buffer
      * @param buffer - Vertex buffer to be removed
@@ -587,7 +591,7 @@ declare class VertexData {
      * @param buffer - Index buffer to be set
      * @returns The index buffer that was set
      */
-    setIndexBuffer(buffer: IndexBuffer): IndexBuffer;
+    setIndexBuffer(buffer: Nullable<IndexBuffer>): Nullable<IndexBuffer<unknown>>;
 }
 
 /**
@@ -595,6 +599,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,20 +652,13 @@ 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;
     }[];
     /**
      * optional index buffer in this vertex layout
      */
-    indexBuffer?: IndexBuffer;
+    indexBuffer?: Nullable<IndexBuffer>;
 };
 /**
  * Supported colorspace types for texture
@@ -638,7 +669,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
@@ -655,8 +686,9 @@ interface BaseCreationOptions {
  */
 interface TextureCreationOptions extends BaseCreationOptions {
     writable?: boolean;
-    texture?: BaseTexture;
-    samplerOptions?: SamplerOptions;
+    texture?: Nullable<BaseTexture>;
+    mipmapping?: boolean;
+    samplerOptions?: Nullable<SamplerOptions>;
 }
 /**
  * Options for creating gpu buffer
@@ -685,42 +717,73 @@ 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
  * @public
  */
-declare function getVertexAttribByName(name: VertexSemantic): number;
+declare function getVertexAttribByName(name: Nullable<VertexSemantic>): 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 13 | 12 | undefined;
 /**
  * Get vertex semantic by attribute index
  * @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): 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 13 | 12;
 /**
  * Get byte size of specified vertex format
+ *
  * @public
  */
-declare function getVertexFormatSize(fmt: VertexAttribFormat): number;
+declare function getVertexFormatSize(fmt: VertexAttribFormat): 2 | 4 | 6 | 8 | 16 | 12;
 /**
  * Get number of components of specified vertex format
+ *
  * @public
  */
-declare function getVertexFormatComponentCount(fmt: VertexAttribFormat): number;
+declare function getVertexFormatComponentCount(fmt: VertexAttribFormat): 1 | 2 | 3 | 4;
 /**
  * Get vertex format by semantic and component type and component count
  * @param semantic - The vertex semantic
  * @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;
+declare function getVertexAttribFormat(semantic: VertexSemantic, type: DataType, count: number): VertexAttribFormat | null;
 /**
  * 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,40 +791,46 @@ 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;
+declare function getVertexBufferStride(vertexBufferType: Immutable<PBStructTypeInfo>): number;
 /**
  * Get primitive type of a vertex attribute by specified vertex semantic
  * @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;
+declare function getVertexBufferAttribTypeBySemantic(vertexBufferType: Immutable<PBStructTypeInfo>, semantic: VertexSemantic): PBPrimitiveTypeInfo | null;
 /**
  * Get primitive type of a vertex attribute by specified vertex attribute index
  * @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;
+declare function getVertexBufferAttribType(vertexBufferType: Immutable<PBStructTypeInfo>, attrib: number): PBPrimitiveTypeInfo | null;
 /**
  * Get the structure type of a vertex buffer by specified vertex attribute formats and the length of the vertex buffer
  * @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;
+declare function makeVertexBufferType(length: number, ...attributes: Immutable<VertexAttribFormat[]>): PBStructTypeInfo | null;
 /**
  * Vertex step mode.
+ *
  * @public
  */
 type VertexStepMode = 'vertex' | 'instance';
 /**
  * Vertex semantic list
+ *
  * @public
  */
 declare const semanticList: string[];
@@ -857,7 +926,7 @@ interface UniformLayout {
     /** The primitive type of the uniform */
     type: PBPrimitiveType;
     /** Layout of the members if the uniform is struct type */
-    subLayout: UniformBufferLayout;
+    subLayout: Nullable<UniformBufferLayout>;
 }
 /**
  * Binding layout of a uniform buffer or storage buffer
@@ -895,9 +964,9 @@ interface TextureBindingLayout {
     /** Whether the textur is a multisampled texture */
     multisampled: boolean;
     /** name of the default sampler uniform when using WebGPU device */
-    autoBindSampler: string;
+    autoBindSampler: Nullable<string>;
     /** name of the default comparison sampler uniform when using WebGPU device */
-    autoBindSamplerComparison: string;
+    autoBindSamplerComparison: Nullable<string>;
 }
 /**
  * Binding layout of a storage texture
@@ -917,7 +986,7 @@ interface StorageTextureBindingLayout {
  */
 interface ExternalTextureBindingLayout {
     /** name of the default sampler uniform when using WebGPU device */
-    autoBindSampler: string;
+    autoBindSampler: Nullable<string>;
 }
 /**
  * Information of bind group entries
@@ -977,26 +1046,24 @@ interface SamplerOptions {
     mipFilter?: TextureFilterMode;
     lodMin?: number;
     lodMax?: number;
-    compare?: CompareFunc;
+    compare?: Nullable<CompareFunc>;
     maxAnisotropy?: number;
 }
 /**
  * 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  */
-    readonly object: T;
+    readonly object: Nullable<T>;
     /** unique id */
     readonly uid: number;
     readonly cid: number;
     readonly disposed: boolean;
     name: string;
-    restoreHandler: (tex: GPUObject) => Promise<void>;
+    restoreHandler: Nullable<(tex: GPUObject) => void>;
     isVertexLayout(): this is VertexLayout;
     isFramebuffer(): this is FrameBuffer;
     isSampler(): this is TextureSampler;
@@ -1010,9 +1077,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
@@ -1027,7 +1094,7 @@ interface TextureSampler<T = unknown> extends GPUObject<T> {
     readonly mipFilter: TextureFilterMode;
     readonly lodMin: number;
     readonly lodMax: number;
-    readonly compare: CompareFunc;
+    readonly compare: Nullable<CompareFunc>;
     readonly maxAnisotropy: number;
 }
 /**
@@ -1042,7 +1109,7 @@ interface BaseTexture<T = unknown> extends GPUObject<T> {
     readonly format: TextureFormat;
     readonly mipLevelCount: number;
     readonly memCost: number;
-    samplerOptions: SamplerOptions;
+    samplerOptions: Nullable<Immutable<SamplerOptions>>;
     init(): void;
     generateMipmaps(): void;
     isSRGBFormat(): boolean;
@@ -1108,7 +1175,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?: Nullable<Uint8Array<ArrayBuffer>>, offsetInBytes?: number, sizeInBytes?: number): Promise<Uint8Array<ArrayBuffer>>;
 }
 /**
  * Abstract interface for index buffer
@@ -1123,8 +1190,8 @@ interface IndexBuffer<T = unknown> extends GPUDataBuffer<T> {
  * @public
  */
 interface StructuredBuffer<T = unknown> extends GPUDataBuffer<T> {
-    structure: PBStructTypeInfo;
-    set(name: string, value: StructuredValue): any;
+    structure: Immutable<PBStructTypeInfo>;
+    set(name: string, value: StructuredValue): void;
 }
 /**
  * Abstract interface for vertex layout
@@ -1132,19 +1199,19 @@ interface StructuredBuffer<T = unknown> extends GPUDataBuffer<T> {
  */
 interface VertexLayout<T = unknown> extends GPUObject<T> {
     readonly vertexBuffers: {
-        [semantic: number]: {
+        [semantic: number]: Nullable<{
             buffer: StructuredBuffer;
             offset: number;
-        };
+        }>;
     };
-    readonly indexBuffer: IndexBuffer;
+    readonly indexBuffer: Nullable<IndexBuffer>;
     setDrawOffset(buffer: StructuredBuffer, byteOffset: number): void;
-    getVertexBuffer(semantic: VertexSemantic): StructuredBuffer;
-    getVertexBufferInfo(semantic: VertexSemantic): VertexBufferInfo;
-    getIndexBuffer(): IndexBuffer;
+    getVertexBuffer(semantic: VertexSemantic): Nullable<StructuredBuffer>;
+    getVertexBufferInfo(semantic: VertexSemantic): Nullable<VertexBufferInfo>;
+    getIndexBuffer(): Nullable<IndexBuffer>;
     bind(): void;
     draw(primitiveType: PrimitiveType, first: number, count: number): void;
-    drawInstanced(primitiveType: PrimitiveType, first: number, count: number, numInstances: number): any;
+    drawInstanced(primitiveType: PrimitiveType, first: number, count: number, numInstances: number): void;
 }
 /**
  * Abstract interface for frame buffer
@@ -1168,7 +1235,8 @@ interface FrameBuffer<T = unknown> extends GPUObject<T> {
     setDepthAttachmentLayer(layer: number): void;
     getDepthAttachmentLayer(): number;
     getColorAttachments(): BaseTexture[];
-    getDepthAttachment(): BaseTexture;
+    getDepthAttachment(): Nullable<BaseTexture>;
+    getColorAttachment<T extends BaseTexture = BaseTexture>(index: number): T;
     bind(): boolean;
     unbind(): void;
 }
@@ -1177,12 +1245,12 @@ interface FrameBuffer<T = unknown> extends GPUObject<T> {
  * @public
  */
 interface GPUProgram<T = unknown> extends GPUObject<T> {
-    readonly bindGroupLayouts: BindGroupLayout[];
+    readonly bindGroupLayouts: Immutable<BindGroupLayout[]>;
     readonly type: 'render' | 'compute';
-    getShaderSource(kind: ShaderKind): string;
-    getCompileError(): string;
-    getBindingInfo(name: string): BindPointInfo;
-    createUniformBuffer(uniform: string): StructuredBuffer;
+    getShaderSource(kind: ShaderKind): Nullable<string>;
+    getCompileError(): Nullable<string>;
+    getBindingInfo(name: string): Nullable<BindPointInfo>;
+    createUniformBuffer(uniform: string): Nullable<StructuredBuffer>;
     use(): void;
 }
 /**
@@ -1197,17 +1265,17 @@ type StructuredValue = number | TypedArray | VectorBase | {
  * @public
  */
 interface BindGroup extends GPUObject<unknown> {
-    getLayout(): BindGroupLayout;
-    getDynamicOffsets(): number[];
+    getLayout(): Immutable<BindGroupLayout>;
+    getDynamicOffsets(): Nullable<Immutable<number[]>>;
     getGPUId(): string;
-    getBuffer(name: string): GPUDataBuffer;
-    getTexture(name: string): BaseTexture;
+    getBuffer(name: string, nocreate?: boolean): Nullable<GPUDataBuffer>;
+    getTexture(name: string): Nullable<BaseTexture>;
     setBuffer(name: string, buffer: GPUDataBuffer, offset?: number, bindOffset?: number, bindSize?: number): void;
-    setValue(name: string, value: StructuredValue): any;
-    setRawData(name: string, byteOffset: number, data: TypedArray, srcPos?: number, srcLength?: number): any;
-    setTexture(name: string, texture: BaseTexture, sampler?: TextureSampler): any;
-    setTextureView(name: string, value: BaseTexture, level?: number, face?: number, mipCount?: number, sampler?: TextureSampler): any;
-    setSampler(name: string, sampler: TextureSampler): any;
+    setValue(name: string, value: StructuredValue): void;
+    setRawData(name: string, byteOffset: number, data: TypedArray, srcPos?: number, srcLength?: number): void;
+    setTexture(name: string, texture: BaseTexture, sampler?: Nullable<TextureSampler>): void;
+    setTextureView(name: string, value: BaseTexture, level?: number, face?: number, mipCount?: number, sampler?: Nullable<TextureSampler>): void;
+    setSampler(name: string, sampler: TextureSampler): void;
 }
 /**
  * Render bundle
@@ -1251,20 +1319,20 @@ declare abstract class Proxiable<T> {
  */
 declare class PBShaderExp extends Proxiable<PBShaderExp> {
     [name: string]: any;
-    get $group(): number;
-    set $group(val: number);
+    get $group(): Nullable<number>;
+    set $group(val: Nullable<number>);
     /**
      * Point out that the variable should be in uniform address space
      * @param group - The bind group index
      * @returns self
      */
-    uniform(group: number): PBShaderExp;
+    uniform(group: number): this;
     /**
      * Point out that the variable should be an uniform buffer
      * @param group - The bind group index
      * @returns self
      */
-    uniformBuffer(group: number, bindingSize?: number): PBShaderExp;
+    uniformBuffer(group: number, bindingSize?: number): this;
     /**
      * Point out that the variable should be in workgroup address space
      *
@@ -1273,51 +1341,51 @@ declare class PBShaderExp extends Proxiable<PBShaderExp> {
      *
      * @returns self
      */
-    workgroup(): PBShaderExp;
+    workgroup(): this;
     /**
      * Point out that the variable should be in storage address space
      * @param group - The bind group index
      * @returns self
      */
-    storage(group: number): PBShaderExp;
+    storage(group: number): this;
     /**
      * Point out that the variable is read-only and should be in storage address space
      * @param group - The bind group index
      * @returns self
      */
-    storageReadonly(group: number): PBShaderExp;
+    storageReadonly(group: number): this;
     /**
      * Point out that the variable should be a storage buffer
      * @param group - The bind group index
      * @returns self
      */
-    storageBuffer(group: number, bindingSize?: number): PBShaderExp;
+    storageBuffer(group: number, bindingSize?: number): this;
     /**
      * Point out that the variable is read-only and should be a storage buffer
      * @param group - The bind group index
      * @returns self
      */
-    storageBufferReadonly(group: number, bindingSize?: number): PBShaderExp;
-    inout(): PBShaderExp;
-    out(): PBShaderExp;
+    storageBufferReadonly(group: number, bindingSize?: number): this;
+    inout(): this;
+    out(): this;
     /**
      * Point out that the variable is a input vertex attribute
      * @param attr - The vertex semantic
      * @returns self
      */
-    attrib(attr: VertexSemantic): PBShaderExp;
+    attrib(attr: VertexSemantic): this;
     /**
      * Create tags for the variable
      * @param args - tags
      * @returns self
      */
-    tag(...args: ShaderExpTagValue[]): PBShaderExp;
+    tag(...args: ShaderExpTagValue[]): this;
     /**
      * Set sample type for the variable if the variable is of type texture
      * @param type - sample type
      * @returns self
      */
-    sampleType(type: 'float' | 'unfilterable-float' | 'sint' | 'uint' | 'depth'): PBShaderExp;
+    sampleType(type: 'float' | 'unfilterable-float' | 'sint' | 'uint' | 'depth'): this;
     /**
      * Get element in the array by index
      * @param index - index of the element
@@ -1334,17 +1402,17 @@ declare class PBShaderExp extends Proxiable<PBShaderExp> {
      * Point out that the variable should be in high precision
      * @returns self
      */
-    highp(): PBShaderExp;
+    highp(): this;
     /**
      * Points out that the variable should be in medium precision
      * @returns self
      */
-    mediump(): PBShaderExp;
+    mediump(): this;
     /**
      * Points out that the variable should be in low precision
      * @returns self
      */
-    lowp(): PBShaderExp;
+    lowp(): this;
     /**
      * Whether this is a constructor
      * @returns true if this is a constructor
@@ -1409,7 +1477,7 @@ declare class PBReflection {
      * Gets the variable which is the vertex attribute of specified semantic
      * @param attrib - The vertex semantic
      */
-    attribute(attrib: VertexSemantic): PBShaderExp;
+    attribute(attrib: VertexSemantic): PBShaderExp | null;
 }
 
 declare const StorageTextureFormatMap: {
@@ -1456,13 +1524,13 @@ interface PBRenderOptions {
      * @param this - Global scope object of the vertex shader
      * @param pb - The program builder instance
      */
-    vertex(this: PBGlobalScope, pb: ProgramBuilder): any;
+    vertex(this: PBGlobalScope, pb: ProgramBuilder): void;
     /**
      * Fragment shader generator.
      * @param this - Global scope object of the fragment shader
      * @param pb - The program builder instance
      */
-    fragment(this: PBGlobalScope, pb: ProgramBuilder): any;
+    fragment(this: PBGlobalScope, pb: ProgramBuilder): void;
 }
 /**
  * Compute program build options
@@ -1474,7 +1542,7 @@ interface PBComputeOptions {
     /** workgroup size */
     workgroupSize: [number, number, number];
     /** compute shader */
-    compute(this: PBGlobalScope, pb: ProgramBuilder): any;
+    compute(this: PBGlobalScope, pb: ProgramBuilder): void;
 }
 /**
  * The program builder interface
@@ -1486,7 +1554,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
@@ -1957,6 +2025,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 */
@@ -1968,17 +2038,17 @@ interface ProgramBuilder {
     /** Same as isinf builtin function in GLSL, only valid for WebGL2 device */
     isinf(x: number | PBShaderExp): PBShaderExp;
     /** add two values */
-    add_2(x: number | PBShaderExp, y: number | PBShaderExp): any;
+    add_2(x: number | PBShaderExp, y: number | PBShaderExp): PBShaderExp;
     /** add a couple of values togeter */
-    add(x: number | PBShaderExp, ...rest: (number | PBShaderExp)[]): any;
+    add(x: number | PBShaderExp, y: number | PBShaderExp, ...rest: (number | PBShaderExp)[]): PBShaderExp;
     /** subtract two values */
-    sub(x: number | PBShaderExp, y: number | PBShaderExp): any;
+    sub(x: number | PBShaderExp, y: number | PBShaderExp): PBShaderExp;
     /** multiply two values */
-    mul_2(x: number | PBShaderExp, y: number | PBShaderExp): any;
+    mul_2(x: number | PBShaderExp, y: number | PBShaderExp): PBShaderExp;
     /** multiply a couple of values togeter */
-    mul(x: number | PBShaderExp, ...rest: (number | PBShaderExp)[]): any;
+    mul(x: number | PBShaderExp, y: number | PBShaderExp, ...rest: (number | PBShaderExp)[]): PBShaderExp;
     /** divide the first number by the second number */
-    div(x: number | PBShaderExp, y: number | PBShaderExp): any;
+    div(x: number | PBShaderExp, y: number | PBShaderExp): PBShaderExp;
     /** Same as length builtin function in GLSL and WGSL */
     length(x: number | PBShaderExp): PBShaderExp;
     /** Same as distance builtin function in GLSL and WGSL */
@@ -2024,7 +2094,7 @@ interface ProgramBuilder {
     /** return x && y */
     and_2(x: PBShaderExp | number | boolean, y: PBShaderExp | number | boolean): PBShaderExp;
     /** return x && y && ... */
-    and(x: PBShaderExp | number | boolean, y: PBShaderExp | number | boolean, ...rest: (PBShaderExp | number | boolean)[]): any;
+    and(x: PBShaderExp | number | boolean, y: PBShaderExp | number | boolean, ...rest: (PBShaderExp | number | boolean)[]): PBShaderExp;
     /** return x & y, per component */
     compAnd(x: PBShaderExp | number, y: PBShaderExp | number): PBShaderExp;
     /** return x ^ y, per component */
@@ -2044,9 +2114,9 @@ interface ProgramBuilder {
     /** return the negate of the given value */
     neg(x: number | PBShaderExp): PBShaderExp;
     /** shift arithmetic left, not valid for WebGL1 device */
-    sal(a: number | PBShaderExp, b: number | PBShaderExp): any;
+    sal(a: number | PBShaderExp, b: number | PBShaderExp): PBShaderExp;
     /** shift arithmetic right, not valid for WebGL1 device */
-    sar(a: number | PBShaderExp, b: number | PBShaderExp): any;
+    sar(a: number | PBShaderExp, b: number | PBShaderExp): PBShaderExp;
     /** Same as the arrayLength builtin function in WGSL, only valid for WebGPU device */
     arrayLength(x: PBShaderExp): PBShaderExp;
     /** Same as the select builtin function in WGSL, only valid for WebGPU device */
@@ -2154,9 +2224,9 @@ interface ProgramBuilder {
     /** Same as workgroupBarrier builtin function in WebGPU, only valid for WebGPU device */
     workgroupBarrier(): void;
     /** atomicLoad, only valid for WebGPU device */
-    atomicLoad(ptr: PBShaderExp): any;
+    atomicLoad(ptr: PBShaderExp): PBShaderExp;
     /** atomicStore, only valid for WebGPU device */
-    atomicStore(ptr: PBShaderExp, value: number | PBShaderExp): any;
+    atomicStore(ptr: PBShaderExp, value: number | PBShaderExp): void;
     /** atomicAdd, only valid for WebGPU device */
     atomicAdd(ptr: PBShaderExp, value: number | PBShaderExp): PBShaderExp;
     /** atomicSub, only valid for WebGPU device */
@@ -2185,9 +2255,9 @@ declare class ProgramBuilder {
      */
     constructor(device: AbstractDevice);
     /** Get last error */
-    get lastError(): string;
+    get lastError(): Nullable<string>;
     /** Current shader kind */
-    get shaderKind(): ShaderKind;
+    get shaderKind(): Nullable<ShaderKind>;
     get emulateDepthClamp(): boolean;
     set emulateDepthClamp(val: boolean);
     /** Get the shader code reflection interface */
@@ -2218,7 +2288,7 @@ declare class PBScope extends Proxiable<PBScope> {
      * @param semantic - The vertex semantic
      * @returns The input vertex attribute or null if not exists
      */
-    $getVertexAttrib(semantic: VertexSemantic): PBShaderExp;
+    $getVertexAttrib(semantic: VertexSemantic): Nullable<PBShaderExp>;
     /** Get the current local scope */
     get $l(): PBLocalScope;
     /** Get the global scope */
@@ -2245,7 +2315,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;
@@ -2327,7 +2397,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
@@ -2340,6 +2410,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(): Nullable<PBFunctionScope>;
 }
 /**
  * Scope that insides a function
@@ -2536,6 +2608,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
@@ -2554,6 +2630,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
@@ -2654,15 +2740,15 @@ interface RenderStateSet {
     /** Shallow copy existing RenderStateSet object to this */
     copyFrom(stateSet: RenderStateSet): void;
     /** Fragment output related render statements or null if the default values should be used */
-    readonly colorState: ColorState;
+    readonly colorState: Nullable<ColorState>;
     /** Alpha blending related render statements or null if the default values should be used */
-    readonly blendingState: BlendingState;
+    readonly blendingState: Nullable<BlendingState>;
     /** Rasterization related render statements or null if the default values should be used */
-    readonly rasterizerState: RasterizerState;
+    readonly rasterizerState: Nullable<RasterizerState>;
     /** Depth buffer related render statements or null if the default values should be used */
-    readonly depthState: DepthState;
+    readonly depthState: Nullable<DepthState>;
     /** Stencil buffer related render statements or null if the default values should be used */
-    readonly stencilState: StencilState;
+    readonly stencilState: Nullable<StencilState>;
     /**
      * Allocates a ColorState
      * @returns The created ColorState
@@ -2724,7 +2810,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.
@@ -2771,7 +2861,7 @@ declare class Pool {
      * @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: MaybeArray<TextureFormat | T>, depthTexOrFormat?: TextureFormat | T, mipmapping?: boolean, sampleCount?: number, ignoreDepthStencil?: boolean, attachmentMipLevel?: number, attachmentCubeface?: number, attachmentLayer?: number): FrameBuffer;
+    fetchTemporalFramebuffer<T extends BaseTexture<unknown>>(autoRelease: boolean, width: number, height: number, colorTexOrFormat: MaybeArray<TextureFormat | T>, depthTexOrFormat?: Nullable<TextureFormat | T>, mipmapping?: boolean, sampleCount?: number, ignoreDepthStencil?: boolean, attachmentMipLevel?: number, attachmentCubeface?: number, attachmentLayer?: number): FrameBuffer<unknown>;
     /**
      * Creates a temporal framebuffer from the object pool.
      * @param autoRelease - Whether the framebuffer should be automatically released at the next frame.
@@ -2784,7 +2874,7 @@ declare class Pool {
      * @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, attachmentMipLevel?: number, attachmentCubeface?: number, attachmentLayer?: number): FrameBuffer<unknown>;
+    createTemporalFramebuffer(autoRelease: boolean, colorAttachments: BaseTexture[], depthAttachment?: Nullable<BaseTexture>, sampleCount?: number, ignoreDepthStencil?: boolean, attachmentMipLevel?: number, attachmentCubeface?: number, attachmentLayer?: number): FrameBuffer<unknown>;
     /**
      * Dispose a texture that is allocated from the object pool.
      * @param texture - The texture to dispose.
@@ -2795,6 +2885,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.
@@ -2805,12 +2900,40 @@ 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.
      */
     purge(): void;
 }
 
+/**
+ * Abstract timer interface
+ * @public
+ */
+interface ITimer {
+    begin(): void;
+    end(): void;
+    ended(): boolean;
+    elapsed(): number;
+}
+/**
+ * CPU timer class
+ * @public
+ */
+declare class CPUTimer implements ITimer {
+    constructor();
+    now(): number;
+    begin(): void;
+    end(): void;
+    ended(): boolean;
+    elapsed(): number;
+}
+
 /**
  * The webgl context type
  * @public
@@ -2845,14 +2968,14 @@ type DataType = 'u8' | 'u8norm' | 'i8' | 'i8norm' | 'u16' | 'u16norm' | 'i16' |
  * Texture format type
  * @public
  */
-type TextureFormat = 'unknown' | 'r8unorm' | 'r8snorm' | 'r16f' | 'r32f' | 'r8ui' | 'r8i' | 'r16ui' | 'r16i' | 'r32ui' | 'r32i' | 'rg8unorm' | 'rg8snorm' | 'rg16f' | 'rg32f' | 'rg8ui' | 'rg8i' | 'rg16ui' | 'rg16i' | 'rg32ui' | 'rg32i' | 'rgba8unorm' | 'rgba8unorm-srgb' | 'rgba8snorm' | 'bgra8unorm' | 'bgra8unorm-srgb' | 'rgba16f' | 'rgba32f' | 'rgba8ui' | 'rgba8i' | 'rgba16ui' | 'rgba16i' | 'rgba32ui' | 'rgba32i' | 'rg11b10uf' | 'd16' | 'd24' | 'd32f' | 'd24s8' | 'd32fs8' | 'dxt1' | 'dxt1-srgb' | 'dxt3' | 'dxt3-srgb' | 'dxt5' | 'dxt5-srgb' | 'bc4' | 'bc4-signed' | 'bc5' | 'bc5-signed' | 'bc7' | 'bc7-srgb' | 'bc6h' | 'bc6h-signed' | 'astc-4x4' | 'astc-4x4-srgb' | 'astc-5x4' | 'astc-5x4-srgb' | 'astc-5x5' | 'astc-5x5-srgb' | 'astc-6x5' | 'astc-6x5-srgb' | 'astc-6x6' | 'astc-6x6-srgb' | 'astc-8x5' | 'astc-8x5-srgb' | 'astc-8x6' | 'astc-8x6-srgb' | 'astc-8x8' | 'astc-8x8-srgb' | 'astc-10x5' | 'astc-10x5-srgb' | 'astc-10x6' | 'astc-10x6-srgb' | 'astc-10x8' | 'astc-10x8-srgb' | 'astc-10x10' | 'astc-10x10-srgb' | 'astc-12x10' | 'astc-12x10-srgb' | 'astc-12x12' | 'astc-12x12-srgb';
+type TextureFormat = 'r8unorm' | 'r8snorm' | 'r16f' | 'r32f' | 'r8ui' | 'r8i' | 'r16ui' | 'r16i' | 'r32ui' | 'r32i' | 'rg8unorm' | 'rg8snorm' | 'rg16f' | 'rg32f' | 'rg8ui' | 'rg8i' | 'rg16ui' | 'rg16i' | 'rg32ui' | 'rg32i' | 'rgba8unorm' | 'rgba8unorm-srgb' | 'rgba8snorm' | 'bgra8unorm' | 'bgra8unorm-srgb' | 'rgba16f' | 'rgba32f' | 'rgba8ui' | 'rgba8i' | 'rgba16ui' | 'rgba16i' | 'rgba32ui' | 'rgba32i' | 'rg11b10uf' | 'd16' | 'd24' | 'd32f' | 'd24s8' | 'd32fs8' | 'dxt1' | 'dxt1-srgb' | 'dxt3' | 'dxt3-srgb' | 'dxt5' | 'dxt5-srgb' | 'bc4' | 'bc4-signed' | 'bc5' | 'bc5-signed' | 'bc7' | 'bc7-srgb' | 'bc6h' | 'bc6h-signed' | 'astc-4x4' | 'astc-4x4-srgb' | 'astc-5x4' | 'astc-5x4-srgb' | 'astc-5x5' | 'astc-5x5-srgb' | 'astc-6x5' | 'astc-6x5-srgb' | 'astc-6x6' | 'astc-6x6-srgb' | 'astc-8x5' | 'astc-8x5-srgb' | 'astc-8x6' | 'astc-8x6-srgb' | 'astc-8x8' | 'astc-8x8-srgb' | 'astc-10x5' | 'astc-10x5-srgb' | 'astc-10x6' | 'astc-10x6-srgb' | 'astc-10x8' | 'astc-10x8-srgb' | 'astc-10x10' | 'astc-10x10-srgb' | 'astc-12x10' | 'astc-12x10-srgb' | 'astc-12x12' | 'astc-12x12-srgb';
 /**
  * Converts a non-sRGB texture format to the corresponding sRGB texture format
  * @param format - The texture format to be converted
  * @returns The sRGB texture format
  * @public
  */
-declare function linearTextureFormatToSRGB(format: TextureFormat): TextureFormat;
+declare function linearTextureFormatToSRGB(format: TextureFormat): "rgba8snorm" | "r8unorm" | "r8snorm" | "r16f" | "r32f" | "r8ui" | "r8i" | "r16ui" | "r16i" | "r32ui" | "r32i" | "rg8unorm" | "rg8snorm" | "rg16f" | "rg32f" | "rg8ui" | "rg8i" | "rg16ui" | "rg16i" | "rg32ui" | "rg32i" | "rgba8unorm-srgb" | "bgra8unorm-srgb" | "rgba16f" | "rgba32f" | "rgba8ui" | "rgba8i" | "rgba16ui" | "rgba16i" | "rgba32ui" | "rgba32i" | "rg11b10uf" | "d16" | "d24" | "d32f" | "d24s8" | "d32fs8" | "dxt1-srgb" | "dxt3-srgb" | "dxt5-srgb" | "bc4" | "bc4-signed" | "bc5" | "bc5-signed" | "bc7-srgb" | "bc6h" | "bc6h-signed" | "astc-4x4-srgb" | "astc-5x4-srgb" | "astc-5x5-srgb" | "astc-6x5-srgb" | "astc-6x6-srgb" | "astc-8x5-srgb" | "astc-8x6-srgb" | "astc-8x8-srgb" | "astc-10x5-srgb" | "astc-10x6-srgb" | "astc-10x8-srgb" | "astc-10x10-srgb" | "astc-12x10-srgb" | "astc-12x12-srgb";
 /**
  * Check if a given texture format contains an alpha channel.
  * @param format - The texture format to be checked.
@@ -3035,6 +3158,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 */
@@ -3075,8 +3200,6 @@ interface ShaderCaps {
     supportShaderTextureLod: boolean;
     /** True if the device supports high precison float number for shader programs */
     supportHighPrecisionFloat: boolean;
-    /** True if the device supports high precison integer number for shader programs */
-    supportHighPrecisionInt: boolean;
     /** The maximum number of bytes of uniform buffer */
     maxUniformBufferSize: number;
     /** The uniform buffer offset alignment */
@@ -3097,6 +3220,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'
@@ -3148,7 +3277,7 @@ interface TextureCaps {
      * @param format - The texture format
      * @returns the texture format infomation
      */
-    getTextureFormatInfo(format: TextureFormat): TextureFormatInfo;
+    getTextureFormatInfo(format: TextureFormat): Immutable<TextureFormatInfo>;
 }
 /**
  * Creation options of rendering shader program
@@ -3186,70 +3315,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
@@ -3265,12 +3330,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: [cssWidth: number, cssHeight: number, deviceWidth: number, deviceHeight: number];
+    devicelost: [];
+    devicerestored: [];
+    gpuobject_added: [obj: GPUObject];
+    gpuobject_removed: [obj: GPUObject];
+    gpuobject_rename: [obj: GPUObject, lastName: string];
 };
 /**
  * Structure that contains the device viewport information
@@ -3301,14 +3366,20 @@ 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 */
     getFrameBufferSampleCount(): number;
     /** Returns true if device context is lost. */
     isContextLost(): boolean;
-    /** Get the value of device pixel ratio */
-    getScale(): number;
+    /** Get the value of device pixel ratio in X axis */
+    getScaleX(): number;
+    /** Get the value of device pixel ratio in Y axis */
+    getScaleY(): number;
     /** Get the width of current frame buffer */
     getDrawingBufferWidth(): number;
     /** Get the height of current frame buffer */
@@ -3318,13 +3389,13 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
     /** Get the height of back buffer */
     getBackBufferHeight(): number;
     /** Get the device capabilities */
-    getDeviceCaps(): DeviceCaps;
+    getDeviceCaps(): Immutable<DeviceCaps>;
     /** Schedule next frame */
     nextFrame(callback: () => void): number;
     /** Cancel schedule next frame */
-    cancelNextFrame(handle: number): any;
+    cancelNextFrame(handle: number): void;
     /** Set font for drawText function */
-    setFont(fontName: string): any;
+    setFont(fontName: string): void;
     /**
      * Draw a string
      * @param text - The string that will be drawn
@@ -3332,14 +3403,16 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * @param y - y coordinate in pixels related to the viewport origin
      * @param color - A CSS color value
      */
-    drawText(text: string, x: number, y: number, color: string): any;
+    drawText(text: string, x: number, y: number, color: string, viewport?: Immutable<number[]>): void;
     /**
      * Clears the current frame buffer
      * @param clearColor - If not null, the color buffer will be cleared to this value.
      * @param clearDepth - If not null, the depth buffer will be cleared to this value.
      * @param clearStencil - If not null, the stencil buffer will be cleared to this value.
      */
-    clearFrameBuffer(clearColor: Vector4, clearDepth: number, clearStencil: number): any;
+    clearFrameBuffer(clearColor: Nullable<Vector4>, clearDepth: Nullable<number>, clearStencil: Nullable<number>): void;
+    /** Creates a GPU timer */
+    createGPUTimer(): Nullable<ITimer>;
     /** Creates a render state set object */
     createRenderStateSet(): RenderStateSet;
     /** Creates a blending state object */
@@ -3355,6 +3428,7 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
     /**
      * Creates a texture sampler object
      * @param options - The creation options
+     * @returns The created texture sampler
      */
     createSampler(options: SamplerOptions): TextureSampler;
     /**
@@ -3363,27 +3437,23 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * @param options - Texture creation options
      * @returns The created texture
      */
-    createTextureFromMipmapData<T extends BaseTexture = BaseTexture>(data: TextureMipmapData, sRGB: boolean, options?: TextureCreationOptions): T;
+    createTextureFromMipmapData<T extends BaseTexture = BaseTexture>(data: TextureMipmapData, sRGB: boolean, options?: TextureCreationOptions): Nullable<T>;
     /**
      * Creates a 2d texture
      * @param format - The texture format
      * @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;
+    createTexture2D(format: TextureFormat, width: number, height: number, options?: TextureCreationOptions): Nullable<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;
+    createTexture2DFromImage(element: TextureImageElement, sRGB: boolean, options?: TextureCreationOptions): Nullable<Texture2D>;
     /**
      * Creates a 2d array texture
      * @param format - The texture format
@@ -3391,47 +3461,39 @@ 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;
+    createTexture2DArray(format: TextureFormat, width: number, height: number, depth: number, options?: TextureCreationOptions): Nullable<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;
+    createTexture2DArrayFromImages(elements: TextureImageElement[], sRGB: boolean, options?: TextureCreationOptions): Nullable<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;
+    createTexture3D(format: TextureFormat, width: number, height: number, depth: number, options?: TextureCreationOptions): Nullable<Texture3D>;
     /**
      * Creates a cube texture
      * @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;
+    createCubeTexture(format: TextureFormat, size: number, options?: TextureCreationOptions): Nullable<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;
     /**
@@ -3445,7 +3507,7 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * @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;
+    copyTexture2D(src: Texture2D, srcLevel: number, dst: Texture2D, dstLevel: number): void;
     /**
      * Copies a color attachment of a framebuffer to a mipmap level of a texture.
      *
@@ -3457,7 +3519,7 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * @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;
+    copyFramebufferToTexture2D(src: FrameBuffer, index: number, dst: Texture2D, level: number): void;
     /**
      * Set wether to reverse the winding order
      *
@@ -3474,17 +3536,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;
+    createBindGroup(layout: Immutable<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;
     /**
@@ -3495,78 +3560,82 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * @param dstOffset - Destination offset in bytes
      * @param bytes - How many bytes to be copy
      */
-    copyBuffer(sourceBuffer: GPUDataBuffer, destBuffer: GPUDataBuffer, srcOffset: number, dstOffset: number, bytes: number): any;
+    copyBuffer(sourceBuffer: GPUDataBuffer, destBuffer: GPUDataBuffer, srcOffset: number, dstOffset: number, bytes: number): void;
     /**
      * 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;
+    createFrameBuffer(colorAttachments: BaseTexture[], depthAttachment: Nullable<BaseTexture>, options?: Nullable<FrameBufferOptions>): FrameBuffer;
     /**
      * Set viewport from an array that contains the position and size
      *
      * @param vp - The viewport position and size, if not specified, the viewport will be set to [0, 0, drawingBufferWidth, drawingBufferHeight]
      */
-    setViewport(vp?: DeviceViewport | number[]): void;
+    setViewport(vp: Nullable<Immutable<DeviceViewport | number[]>>): void;
     /** Get current viewport as [x, y, width, height] */
-    getViewport(): DeviceViewport;
+    getViewport(): Immutable<DeviceViewport>;
     /**
      * Set scissor rectangle from an array that contains the position and size
      * @param scissor - The scissor rectangle position and size, if not specified, the scissor rectangle will be set to [0, 0, drawingBufferWidth,drawingBufferHeight]
      */
-    setScissor(scissor?: DeviceViewport | number[]): void;
+    setScissor(scissor: Nullable<Immutable<DeviceViewport | number[]>>): void;
     /**
      * Get current scissor rectangle
      */
-    getScissor(): DeviceViewport;
+    getScissor(): Immutable<DeviceViewport>;
     /**
      * Set current GPU program
      * @param program - The GPU program to be set
      */
-    setProgram(program: GPUProgram): void;
+    setProgram(program: Nullable<GPUProgram>): void;
     /**
      * Get current GPU program
      */
-    getProgram(): GPUProgram;
+    getProgram(): Nullable<GPUProgram>;
     /**
      * Set current vertex layout
      *
      * @param vertexData - The vertex layout to be set
      */
-    setVertexLayout(vertexData: VertexLayout): void;
+    setVertexLayout(vertexData: Nullable<VertexLayout>): void;
     /** Get current vertex layout */
-    getVertexLayout(): VertexLayout;
+    getVertexLayout(): Nullable<VertexLayout>;
     /**
      * Set current render states
      *
      * @param renderStates - The render state set
      */
-    setRenderStates(renderStates: RenderStateSet): void;
+    setRenderStates(renderStates: Nullable<RenderStateSet>): void;
     /** Get current render states */
-    getRenderStates(): RenderStateSet;
+    getRenderStates(): Nullable<RenderStateSet>;
     /**
      * Sets the current framebuffer to the specified FrameBuffer object.
      *
      * @param rt - The FrameBuffer object to set as the current framebuffer.
      */
-    setFramebuffer(rt: FrameBuffer): any;
+    setFramebuffer(rt: Nullable<FrameBuffer>): void;
     /**
      * Sets the current framebuffer specifying complex color attachments, an optional depth attachment, MIP level, face, and sample count.
      *
@@ -3579,14 +3648,10 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * @param depth - Optional BaseTexture to serve as the depth attachment.
      * @param sampleCount - Optional sample count defining the number of samples for multisampling.
      */
-    setFramebuffer(color: (BaseTexture | {
-        texture: BaseTexture;
-        miplevel?: number;
-        face?: number;
-        layer?: number;
-    })[], depth?: BaseTexture, miplevel?: number, face?: number, sampleCount?: number): any;
+    setFramebuffer(color: BaseTexture[], depth?: BaseTexture, sampleCount?: number): void;
+    setFramebuffer(colorOrRT: BaseTexture[] | Nullable<FrameBuffer>, depth?: BaseTexture, sampleCount?: number): void;
     /** Get current frame buffer */
-    getFramebuffer(): FrameBuffer;
+    getFramebuffer(): Nullable<FrameBuffer>;
     /**
      * Set current bind group
      *
@@ -3594,12 +3659,12 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * @param bindGroup - The bind group to be set
      * @param dynamicOffsets - dynamic uniform buffer offsets of the bind group or null
      */
-    setBindGroup(index: number, bindGroup: BindGroup, dynamicOffsets?: Iterable<number>): any;
+    setBindGroup(index: number, bindGroup: BindGroup, dynamicOffsets?: Nullable<Iterable<number>>): void;
     /**
      * Get current bind group
      * @param index - index of the bind group to get
      */
-    getBindGroup(index: number): [BindGroup, Iterable<number>];
+    getBindGroup(index: number): [BindGroup, Nullable<Iterable<number>>];
     /** Flush the gpu command buffer */
     flush(): void;
     /**
@@ -3639,7 +3704,7 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * Executes render bundle
      * @param renderBundle - RenderBundle to be execute
      */
-    executeRenderBundle(renderBundle: RenderBundle): any;
+    executeRenderBundle(renderBundle: RenderBundle): void;
     /**
      * End capture draw commands
      * @returns A RenderBundle that holds the captured draw commands
@@ -3658,19 +3723,19 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
     /** Get the program builder */
     programBuilder: ProgramBuilder;
     /** Get the run loop callback function */
-    runLoopFunction: (device: AbstractDevice) => void;
+    runLoopFunction: Nullable<(device: AbstractDevice) => void>;
     /**
      * 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;
     /**
@@ -3680,23 +3745,25 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * @param dataType - The data type
      * @param componentCount - The component count
      */
-    getVertexAttribFormat(semantic: VertexSemantic, dataType: DataType, componentCount: number): VertexAttribFormat;
+    getVertexAttribFormat(semantic: VertexSemantic, dataType: DataType, componentCount: number): Nullable<VertexAttribFormat>;
     /**
      * Creates an interleaved vertex buffer
      *
      * @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;
+    createInterleavedVertexBuffer(attribFormats: VertexAttribFormat[], data: TypedArray, options?: BufferCreationOptions): Nullable<StructuredBuffer>;
     /**
      * Creates a non-interleaved vertex buffer
      *
      * @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;
+    createVertexBuffer(attribFormat: VertexAttribFormat, data: TypedArray, options?: BufferCreationOptions): Nullable<StructuredBuffer>;
     /**
      * Draw primitives
      *
@@ -3728,6 +3795,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;
     /**
@@ -3743,56 +3816,51 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      *
      * @param uid - id of the GPU object
      */
-    getGPUObjectById(uid: number): GPUObject;
+    getGPUObjectById(uid: number): Nullable<GPUObject>;
     /**
-     * Calculates the actual position of current frame buffer from screen position.
+     * Calculates the actual position of current frame buffer from screen position in X axis.
      *
      * @remarks
      * If current frame buffer is the back buffer, the value will be scaled by the device pixel ratio.
      *
      * @param val - The screen position in pixels
      */
-    screenToDevice(val: number): number;
+    screenXToDevice(val: number): number;
     /**
-     * Calculates the screen position from position of current frame buffer.
+     * Calculates the screen position from position of current frame buffer in X axis.
      *
      * @remarks
      * If current frame buffer is the back buffer, the value will be divided by the device pixel ratio.
      *
      * @param val - The position of current frame buffer in pixels
      */
-    deviceToScreen(val: number): number;
+    deviceXToScreen(val: number): number;
+    /**
+     * Calculates the actual position of current frame buffer from screen position in Y axis.
+     *
+     * @remarks
+     * If current frame buffer is the back buffer, the value will be scaled by the device pixel ratio.
+     *
+     * @param val - The screen position in pixels
+     */
+    screenYToDevice(val: number): number;
+    /**
+     * Calculates the screen position from position of current frame buffer in Y axis.
+     *
+     * @remarks
+     * If current frame buffer is the back buffer, the value will be divided by the device pixel ratio.
+     *
+     * @param val - The position of current frame buffer in pixels
+     */
+    deviceYToScreen(val: number): number;
     /** Builds render program */
-    buildRenderProgram(options: PBRenderOptions): GPUProgram;
+    buildRenderProgram(options: PBRenderOptions): Nullable<GPUProgram>;
     /** Builds compute program */
-    buildComputeProgram(options: PBComputeOptions): GPUProgram;
+    buildComputeProgram(options: PBComputeOptions): Nullable<GPUProgram>;
     /** Pushes current FrameBuffer state */
-    pushDeviceStates(): any;
+    pushDeviceStates(): void;
     /** Pops last FrameBuffer state */
-    popDeviceStates(): any;
-}
-
-/**
- * Abstract timer interface
- * @public
- */
-interface ITimer {
-    begin(): void;
-    end(): void;
-    ended(): boolean;
-    elapsed(): number;
-}
-/**
- * CPU timer class
- * @public
- */
-declare class CPUTimer implements ITimer {
-    constructor();
-    now(): number;
-    begin(): void;
-    end(): void;
-    ended(): boolean;
-    elapsed(): number;
+    popDeviceStates(): void;
 }
 
 /**
@@ -3801,14 +3869,15 @@ declare class CPUTimer implements ITimer {
  */
 interface DeviceBackend {
     typeName(): string;
-    supported(): boolean;
-    createDevice(cvs: HTMLCanvasElement, options?: DeviceOptions): Promise<AbstractDevice>;
+    supported(): Promise<boolean>;
+    createDevice(cvs: HTMLCanvasElement, options?: DeviceOptions): Promise<Nullable<AbstractDevice>>;
 }
 /**
  * Base class for rendering device
  * @public
  */
-declare abstract class BaseDevice {
+declare abstract class BaseDevice extends Observable<DeviceEventMap> {
+    protected _dpr: number;
     protected _canvas: HTMLCanvasElement;
     protected _canvasClientWidth: number;
     protected _canvasClientHeight: number;
@@ -3819,33 +3888,36 @@ declare abstract class BaseDevice {
     protected _endFrameTime: number;
     protected _frameInfo: FrameInfo;
     protected _cpuTimer: CPUTimer;
-    protected _gpuTimer: ITimer;
-    protected _runningLoop: number;
+    protected _gpuTimer: Nullable<ITimer>;
+    protected _runningLoop: Nullable<number>;
     protected _fpsCounter: {
         time: number;
         frame: number;
     };
-    protected _runLoopFunc: (device: AbstractDevice) => void;
+    protected _runLoopFunc: Nullable<(device: AbstractDevice) => void>;
     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;
-    constructor(cvs: HTMLCanvasElement, backend: DeviceBackend);
+    private readonly _resizer;
+    private readonly _stateStack;
+    constructor(cvs: HTMLCanvasElement, backend: DeviceBackend, dpr?: number);
+    getScaleX(): number;
+    getScaleY(): number;
     abstract getAdapterInfo(): any;
     abstract getFrameBufferSampleCount(): number;
     abstract isContextLost(): boolean;
-    abstract getScale(): number;
     abstract getDrawingBufferWidth(): number;
     abstract getDrawingBufferHeight(): number;
     abstract getBackBufferWidth(): number;
     abstract getBackBufferHeight(): number;
-    abstract getDeviceCaps(): DeviceCaps;
+    abstract getDeviceCaps(): Immutable<DeviceCaps>;
     abstract initContext(): Promise<void>;
-    abstract clearFrameBuffer(clearColor: Vector4, clearDepth: number, clearStencil: number): any;
-    abstract createGPUTimer(): ITimer;
+    abstract clearFrameBuffer(clearColor: Nullable<Vector4>, clearDepth: Nullable<number>, clearStencil: Nullable<number>): void;
+    abstract createGPUTimer(): Nullable<ITimer>;
     abstract createRenderStateSet(): RenderStateSet;
     abstract createBlendingState(): BlendingState;
     abstract createColorState(): ColorState;
@@ -3853,52 +3925,49 @@ declare abstract class BaseDevice {
     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 createTextureFromMipmapData<T extends BaseTexture>(data: TextureMipmapData, sRGB: boolean, options?: TextureCreationOptions): Nullable<T>;
+    abstract createTexture2D(format: TextureFormat, width: number, height: number, options?: TextureCreationOptions): Nullable<Texture2D>;
+    abstract createTexture2DFromImage(element: TextureImageElement, sRGB: boolean, options?: TextureCreationOptions): Nullable<Texture2D>;
+    abstract createTexture2DArray(format: TextureFormat, width: number, height: number, depth: number, options?: TextureCreationOptions): Nullable<Texture2DArray>;
+    abstract createTexture2DArrayFromImages(elements: TextureImageElement[], sRGB: boolean, options?: TextureCreationOptions): Nullable<Texture2DArray>;
+    abstract createTexture3D(format: TextureFormat, width: number, height: number, depth: number, options?: TextureCreationOptions): Nullable<Texture3D>;
+    abstract createCubeTexture(format: TextureFormat, size: number, options?: TextureCreationOptions): Nullable<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 copyTexture2D(src: Texture2D, srcLevel: number, dst: Texture2D, dstLevel: number): void;
+    abstract copyFramebufferToTexture2D(src: FrameBuffer, index: number, dst: Texture2D, level: number): void;
     abstract createGPUProgram(params: GPUProgramConstructParams): GPUProgram;
-    abstract createBindGroup(layout: BindGroupLayout): BindGroup;
+    abstract createBindGroup(layout: Immutable<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 copyBuffer(sourceBuffer: GPUDataBuffer, destBuffer: GPUDataBuffer, srcOffset: number, dstOffset: number, bytes: number): void;
+    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;
-    abstract setViewport(vp?: number[] | DeviceViewport): void;
-    abstract getViewport(): DeviceViewport;
-    abstract setScissor(scissor?: number[] | DeviceViewport): void;
-    abstract getScissor(): DeviceViewport;
-    abstract setProgram(program: GPUProgram): void;
-    abstract getProgram(): GPUProgram;
-    abstract setVertexLayout(vertexData: VertexLayout): void;
-    abstract getVertexLayout(): VertexLayout;
-    abstract setRenderStates(renderStates: RenderStateSet): void;
-    abstract getRenderStates(): RenderStateSet;
-    abstract getFramebuffer(): FrameBuffer;
-    abstract setBindGroup(index: number, bindGroup: BindGroup, dynamicOffsets?: Iterable<number>): any;
-    abstract getBindGroup(index: number): [BindGroup, Iterable<number>];
+    abstract createFrameBuffer(colorAttachments: BaseTexture[], depthAttachment: Nullable<BaseTexture>, options?: Nullable<FrameBufferOptions>): FrameBuffer;
+    abstract setViewport(vp: Nullable<Immutable<number[] | DeviceViewport>>): void;
+    abstract getViewport(): Immutable<DeviceViewport>;
+    abstract setScissor(scissor: Nullable<Immutable<number[] | DeviceViewport>>): void;
+    abstract getScissor(): Immutable<DeviceViewport>;
+    abstract setProgram(program: Nullable<GPUProgram>): void;
+    abstract getProgram(): Nullable<GPUProgram>;
+    abstract setVertexLayout(vertexData: Nullable<VertexLayout>): void;
+    abstract getVertexLayout(): Nullable<VertexLayout>;
+    abstract setRenderStates(renderStates: Nullable<RenderStateSet>): void;
+    abstract getRenderStates(): Nullable<RenderStateSet>;
+    abstract getFramebuffer(): Nullable<FrameBuffer>;
+    abstract setBindGroup(index: number, bindGroup: BindGroup, dynamicOffsets?: Nullable<Iterable<number>>): void;
+    abstract getBindGroup(index: number): [BindGroup, Nullable<Iterable<number>>];
     abstract flush(): void;
     abstract nextFrame(callback: () => void): number;
-    abstract cancelNextFrame(handle: number): any;
+    abstract cancelNextFrame(handle: number): void;
     abstract readPixels(index: number, x: number, y: number, w: number, h: number, buffer: TypedArray): Promise<void>;
     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;
@@ -3911,53 +3980,54 @@ declare abstract class BaseDevice {
     get vSync(): boolean;
     set vSync(val: boolean);
     get pool(): Pool;
-    get runLoopFunction(): (device: AbstractDevice) => void;
+    get runLoopFunction(): Nullable<(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;
+    drawText(text: string, x: number, y: number, color: string, viewport?: Immutable<number[]>): void;
+    setFramebuffer(rt: Nullable<FrameBuffer>): void;
+    setFramebuffer(color: BaseTexture[], depth?: BaseTexture, sampleCount?: number): void;
     disposeObject(obj: GPUObject, remove?: boolean): void;
-    restoreObject(obj: GPUObject): Promise<void>;
+    restoreObject(obj: GPUObject): void;
     enableGPUTimeRecording(enable: boolean): void;
     beginFrame(): boolean;
     endFrame(): void;
-    getVertexAttribFormat(semantic: VertexSemantic, dataType: DataType, componentCount: number): VertexAttribFormat;
-    createInterleavedVertexBuffer(attribFormats: VertexAttribFormat[], data: TypedArray, options?: BufferCreationOptions): StructuredBuffer;
-    createVertexBuffer(attribFormat: VertexAttribFormat, data: TypedArray, options?: BufferCreationOptions): StructuredBuffer;
+    getVertexAttribFormat(semantic: VertexSemantic, dataType: DataType, componentCount: number): VertexAttribFormat | null;
+    createInterleavedVertexBuffer(attribFormats: VertexAttribFormat[], data: TypedArray, options?: BufferCreationOptions): StructuredBuffer<unknown> | null;
+    createVertexBuffer(attribFormat: VertexAttribFormat, data: TypedArray, options?: BufferCreationOptions): StructuredBuffer<unknown> | null;
     draw(primitiveType: PrimitiveType, first: number, count: number): void;
     drawInstanced(primitiveType: PrimitiveType, first: number, count: number, numInstances: number): void;
-    compute(workgroupCountX: any, workgroupCountY: any, workgroupCountZ: any): void;
+    executeRenderBundle(renderBundle: RenderBundle): void;
+    compute(workgroupCountX: number, workgroupCountY: number, workgroupCountZ: number): void;
     runNextFrame(f: () => void): void;
+    runNextFrameAsync(f: () => void | Promise<void>): Promise<void>;
     exitLoop(): void;
     runLoop(func: (device: AbstractDevice) => void): void;
     pushDeviceStates(): void;
     popDeviceStates(): void;
     getGPUObjects(): GPUObjectList;
-    getGPUObjectById(uid: number): GPUObject;
-    screenToDevice(val: number): number;
-    deviceToScreen(val: number): number;
-    buildRenderProgram(options: PBRenderOptions): GPUProgram;
-    buildComputeProgram(options: PBComputeOptions): GPUProgram;
+    getGPUObjectById(uid: number): GPUDataBuffer<unknown> | BaseTexture<unknown> | VertexLayout<unknown> | FrameBuffer<unknown> | TextureSampler<unknown> | GPUProgram<unknown> | null;
+    screenXToDevice(val: number): number;
+    deviceXToScreen(val: number): number;
+    screenYToDevice(val: number): number;
+    deviceYToScreen(val: number): number;
+    buildRenderProgram(options: PBRenderOptions): Nullable<GPUProgram<unknown>>;
+    buildComputeProgram(options: PBComputeOptions): Nullable<GPUProgram<unknown>>;
     addGPUObject(obj: GPUObject): void;
     removeGPUObject(obj: GPUObject): void;
     updateVideoMemoryCost(delta: number): void;
     protected abstract onBeginFrame(): boolean;
     protected abstract onEndFrame(): void;
-    protected abstract _setFramebuffer(fb: FrameBuffer): any;
-    private _onresize;
-    private _registerEventHandlers;
+    protected abstract _setFramebuffer(fb: Nullable<FrameBuffer>): void;
+    protected abstract _handleResize(cssWidth: number, cssHeight: number, deviceWidth: number, deviceHeight: number): void;
+    protected initResizer(): Promise<void>;
     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;
+    protected parseBufferOptions(options?: BufferCreationOptions, defaultUsage?: BufferUsage): number;
 }
 /**
  * Merge event target interface
@@ -3997,20 +4067,20 @@ 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(): Nullable<(tex: BaseTexture) => void>;
+    set atlasTextureRestoreHandler(f: Nullable<(tex: BaseTexture) => void>);
     /**
      * Gets the atlas texture of a given index
      * @param index - Index of the atlas bin
      * @returns Atlas texture for given index
      */
-    getAtlasTexture(index: number): Texture2D;
+    getAtlasTexture(index: number): Texture2D<unknown> | undefined;
     /**
      * Gets the information about specified atlas
      * @param key - Key of the atlas
      * @returns Information of the atlas
      */
-    getAtlasInfo(key: string): AtlasInfo;
+    getAtlasInfo(key: string): AtlasInfo | null;
     /**
      * Check if no atlas has been created
      * @returns true if no atlas has been created
@@ -4030,14 +4100,14 @@ declare class TextureAtlasManager {
      * @param h - height of the rectangle
      * @returns The atals info or null if insert failed
      */
-    pushCanvas(key: string, ctx: CanvasRenderingContext2D, x: number, y: number, w: number, h: number): AtlasInfo;
+    pushCanvas(key: string, ctx: CanvasRenderingContext2D, x: number, y: number, w: number, h: number): AtlasInfo | null;
     /**
      * Inserts a bitmap to the atlas texture
      * @param key - Key of the atlas
      * @param bitmap - The bitmap object
      * @returns The atals info or null if insert failed
      */
-    pushBitmap(key: string, bitmap: ImageData | ImageBitmap): AtlasInfo;
+    pushBitmap(key: string, bitmap: ImageData | ImageBitmap): AtlasInfo | null;
 }
 
 /**
@@ -4097,12 +4167,13 @@ declare class GlyphManager extends TextureAtlasManager {
      */
     constructor(device: AbstractDevice, binWidth: number, binHeight: number, border: number);
     /**
-     * Gets the atlas information for given character
+     * Gets the size for given character
      * @param char - The character
      * @param font - Font of the character
-     * @returns Atlas information for the glyph
+     * @returns [width, height]
      */
-    getGlyphInfo(char: string, font: Font): AtlasInfo;
+    getGlyphSize(char: string, font: Font): number[] | null;
+    getGlyphInfo(char: string, font: Font): AtlasInfo | null;
     /**
      * Measuring the width of a string
      * @param str - The string to be measured
@@ -4149,7 +4220,7 @@ declare class DrawText {
      * @param x - X coordinate of the text
      * @param y - Y coordinate of the text
      */
-    static drawText(device: AbstractDevice, text: string, color: string, x: number, y: number): void;
+    static drawText(device: AbstractDevice, text: string, color: string, x: number, y: number, viewport?: Immutable<number[]>): void;
 }
 
 /**
@@ -4162,11 +4233,11 @@ declare class StructuredBufferData {
      * @param layout - Layout of the structure
      * @param buffer - Buffer that holds the data
      */
-    constructor(layout: UniformBufferLayout, buffer?: StructuredBuffer | ArrayBuffer);
+    constructor(layout: UniformBufferLayout, buffer?: Nullable<StructuredBuffer | ArrayBuffer>);
     /** The buffer size in bytes */
     get byteLength(): number;
     /** Get the data cache buffer */
-    get buffer(): ArrayBuffer;
+    get buffer(): Nullable<ArrayBuffer>;
     /** Get all the uniform datas */
     get uniforms(): Record<string, TypedArray>;
     /**
@@ -4177,4 +4248,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 };