@zephyr3d/device 0.2.5 → 0.2.7

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { TypedArray, IDisposable, CubeFace, VectorBase, MaybeArray, IEventTarget, Vector4, Observable } 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,7 +302,7 @@ 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;
 }
@@ -342,22 +342,22 @@ 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 */
@@ -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,9 @@ declare class VertexData {
      */
     clone(): VertexData;
     /** Vertex buffer information list */
-    get vertexBuffers(): VertexBufferInfo[];
+    get vertexBuffers(): Nullable<VertexBufferInfo>[];
     /** Index buffer */
-    get indexBuffer(): IndexBuffer;
+    get indexBuffer(): Nullable<IndexBuffer<unknown>>;
     /** Number of vertices */
     get numVertices(): number;
     /** Draw offset */
@@ -559,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
@@ -589,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>>;
 }
 
 /**
@@ -656,7 +658,7 @@ type VertexLayoutOptions = {
     /**
      * optional index buffer in this vertex layout
      */
-    indexBuffer?: IndexBuffer;
+    indexBuffer?: Nullable<IndexBuffer>;
 };
 /**
  * Supported colorspace types for texture
@@ -684,9 +686,9 @@ interface BaseCreationOptions {
  */
 interface TextureCreationOptions extends BaseCreationOptions {
     writable?: boolean;
-    texture?: BaseTexture;
+    texture?: Nullable<BaseTexture>;
     mipmapping?: boolean;
-    samplerOptions?: SamplerOptions;
+    samplerOptions?: Nullable<SamplerOptions>;
 }
 /**
  * Options for creating gpu buffer
@@ -724,7 +726,7 @@ declare enum GPUResourceUsageFlags {
  * 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
@@ -754,19 +756,19 @@ declare function getVertexAttributeFormat(fmt: VertexAttribFormat): "f32" | "i32
  *
  * @public
  */
-declare function getVertexAttributeIndex(fmt: VertexAttribFormat): number;
+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
@@ -776,7 +778,7 @@ declare function getVertexFormatComponentCount(fmt: VertexAttribFormat): number;
  *
  * @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
@@ -792,7 +794,7 @@ declare function getVertexBufferLength(vertexBufferType: PBStructTypeInfo): numb
  *
  * @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
@@ -801,7 +803,7 @@ declare function getVertexBufferStride(vertexBufferType: PBStructTypeInfo): numb
  *
  * @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
@@ -810,7 +812,7 @@ declare function getVertexBufferAttribTypeBySemantic(vertexBufferType: PBStructT
  *
  * @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
@@ -819,7 +821,7 @@ declare function getVertexBufferAttribType(vertexBufferType: PBStructTypeInfo, a
  *
  * @public
  */
-declare function makeVertexBufferType(length: number, ...attributes: VertexAttribFormat[]): PBStructTypeInfo;
+declare function makeVertexBufferType(length: number, ...attributes: Immutable<VertexAttribFormat[]>): PBStructTypeInfo | null;
 /**
  * Vertex step mode.
  *
@@ -924,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
@@ -962,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
@@ -984,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
@@ -1044,7 +1046,7 @@ interface SamplerOptions {
     mipFilter?: TextureFilterMode;
     lodMin?: number;
     lodMax?: number;
-    compare?: CompareFunc;
+    compare?: Nullable<CompareFunc>;
     maxAnisotropy?: number;
 }
 /**
@@ -1055,13 +1057,13 @@ 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) => void;
+    restoreHandler: Nullable<(tex: GPUObject) => void>;
     isVertexLayout(): this is VertexLayout;
     isFramebuffer(): this is FrameBuffer;
     isSampler(): this is TextureSampler;
@@ -1092,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;
 }
 /**
@@ -1107,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;
@@ -1173,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<ArrayBuffer>, offsetInBytes?: number, sizeInBytes?: number): Promise<Uint8Array<ArrayBuffer>>;
+    getBufferSubData(dstBuffer?: Nullable<Uint8Array<ArrayBuffer>>, offsetInBytes?: number, sizeInBytes?: number): Promise<Uint8Array<ArrayBuffer>>;
 }
 /**
  * Abstract interface for index buffer
@@ -1188,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
@@ -1197,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
@@ -1233,7 +1235,7 @@ 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;
@@ -1243,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;
 }
 /**
@@ -1263,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, nocreate?: boolean): 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
@@ -1317,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
      *
@@ -1339,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
@@ -1400,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
@@ -1475,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: {
@@ -1522,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
@@ -1540,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
@@ -2036,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, y: 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, y: 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 */
@@ -2092,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 */
@@ -2112,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 */
@@ -2222,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 */
@@ -2253,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 */
@@ -2286,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 */
@@ -2409,7 +2411,7 @@ declare class PBInsideFunctionScope extends PBScope {
      */
     $while(condition: ExpValueNonArrayType, body: (this: PBWhileScope) => void): void;
     /** Gets main function scope */
-    $getMainScope(): PBFunctionScope;
+    $getMainScope(): Nullable<PBFunctionScope>;
 }
 /**
  * Scope that insides a function
@@ -2738,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
@@ -2859,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.
@@ -2872,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;
+    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.
@@ -2909,6 +2911,29 @@ declare class Pool {
     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
@@ -2943,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.
@@ -3175,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 */
@@ -3254,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
@@ -3307,7 +3330,7 @@ interface DeviceOptions {
  * @public
  */
 type DeviceEventMap = {
-    resize: [width: number, height: number];
+    resize: [cssWidth: number, cssHeight: number, deviceWidth: number, deviceHeight: number];
     devicelost: [];
     devicerestored: [];
     gpuobject_added: [obj: GPUObject];
@@ -3353,8 +3376,10 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
     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 */
@@ -3364,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
@@ -3378,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 */
@@ -3410,7 +3437,7 @@ 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
@@ -3419,14 +3446,14 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * @param options - The creation options
      * @returns The created 2D texture
      */
-    createTexture2D(format: TextureFormat, width: number, height: number, 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
@@ -3436,7 +3463,7 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * @param options - The creation options
      * @returns The created 2D array texture.
      */
-    createTexture2DArray(format: TextureFormat, width: number, height: number, depth: number, 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.
@@ -3444,7 +3471,7 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * @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
      * @param format - The texture format
@@ -3454,7 +3481,7 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * @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
@@ -3462,7 +3489,7 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * @param options - The creation options
      * @returns The created cube texture.
      */
-    createCubeTexture(format: TextureFormat, size: number, 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
@@ -3480,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.
      *
@@ -3492,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
      *
@@ -3517,7 +3544,7 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * @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
@@ -3533,7 +3560,7 @@ 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
@@ -3560,55 +3587,55 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * @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.
      *
@@ -3621,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
      *
@@ -3636,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;
     /**
@@ -3681,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
@@ -3700,7 +3723,7 @@ 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
      *
@@ -3722,7 +3745,7 @@ 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
      *
@@ -3731,7 +3754,7 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * @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
      *
@@ -3740,7 +3763,7 @@ interface AbstractDevice extends IEventTarget<DeviceEventMap> {
      * @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
      *
@@ -3793,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 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
+     */
+    screenXToDevice(val: number): number;
     /**
-     * Calculates the actual position of current frame buffer from screen position.
+     * 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
+     */
+    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
      */
-    screenToDevice(val: number): number;
+    screenYToDevice(val: number): number;
     /**
-     * Calculates the screen position from position of current frame buffer.
+     * 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
      */
-    deviceToScreen(val: number): number;
+    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;
 }
 
 /**
@@ -3851,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 extends Observable<DeviceEventMap> {
+    protected _dpr: number;
     protected _canvas: HTMLCanvasElement;
     protected _canvasClientWidth: number;
     protected _canvasClientHeight: number;
@@ -3869,13 +3888,13 @@ declare abstract class BaseDevice extends Observable<DeviceEventMap> {
     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;
@@ -3883,20 +3902,22 @@ declare abstract class BaseDevice extends Observable<DeviceEventMap> {
     protected _defaultPoolKey: symbol;
     protected _temporalFramebuffer: boolean;
     protected _vSync: boolean;
+    private readonly _resizer;
     private readonly _stateStack;
-    constructor(cvs: HTMLCanvasElement, backend: DeviceBackend);
+    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;
@@ -3904,42 +3925,42 @@ declare abstract class BaseDevice extends Observable<DeviceEventMap> {
     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 createTexture2DFromImage(element: TextureImageElement, sRGB: boolean, options?: TextureCreationOptions): Texture2D;
-    abstract createTexture2DArray(format: TextureFormat, width: number, height: number, depth: number, 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 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 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;
@@ -3959,26 +3980,26 @@ declare abstract class BaseDevice extends Observable<DeviceEventMap> {
     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[], 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): 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;
     executeRenderBundle(renderBundle: RenderBundle): void;
-    compute(workgroupCountX: any, workgroupCountY: any, workgroupCountZ: any): void;
+    compute(workgroupCountX: number, workgroupCountY: number, workgroupCountZ: number): void;
     runNextFrame(f: () => void): void;
     runNextFrameAsync(f: () => void | Promise<void>): Promise<void>;
     exitLoop(): void;
@@ -3986,25 +4007,27 @@ declare abstract class BaseDevice extends Observable<DeviceEventMap> {
     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(): void;
     protected parseTextureOptions(options?: TextureCreationOptions): number;
-    protected parseBufferOptions(options: BufferCreationOptions, defaultUsage?: BufferUsage): number;
+    protected parseBufferOptions(options?: BufferCreationOptions, defaultUsage?: BufferUsage): number;
 }
 /**
  * Merge event target interface
@@ -4044,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) => void;
-    set atlasTextureRestoreHandler(f: (tex: BaseTexture) => 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
@@ -4077,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;
 }
 
 /**
@@ -4144,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
@@ -4196,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;
 }
 
 /**
@@ -4209,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>;
     /**