@galacean/engine-loader 0.9.19 → 0.9.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/engine-loader",
-  "version": "0.9.19",
+  "version": "0.9.21",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
@@ -15,10 +15,10 @@
     "types/**/*"
   ],
   "dependencies": {
-    "@galacean/engine-core": "0.9.19",
-    "@galacean/engine-draco": "0.9.19",
-    "@galacean/engine-math": "0.9.19",
-    "@galacean/engine-rhi-webgl": "0.9.19"
+    "@galacean/engine-core": "0.9.21",
+    "@galacean/engine-draco": "0.9.21",
+    "@galacean/engine-math": "0.9.21",
+    "@galacean/engine-rhi-webgl": "0.9.21"
   },
   "scripts": {
     "b:types": "tsc"

package/types/GLTFContentRestorer.d.ts

@@ -1,4 +1,4 @@
-import { AssetPromise, BlendShape, Buffer, ContentRestorer, ModelMesh, Texture2D } from "@galacean/engine-core";
+import { AssetPromise, BlendShape, Buffer, ContentRestorer, ModelMesh, Texture2D, TypedArray } from "@galacean/engine-core";
 import { RequestConfig } from "@galacean/engine-core/types/asset/request";
 import { Vector2 } from "@galacean/engine-math";
 import { GLTFResource } from "./gltf/GLTFResource";
@@ -65,18 +65,28 @@ export declare class BufferDataRestoreInfo {
  */
 export declare class RestoreDataAccessor {
     bufferIndex: number;
-    TypedArray: new (buffer: ArrayBuffer, byteOffset: number, length?: number) => ArrayBufferView;
+    TypedArray: new (buffer: ArrayBuffer, byteOffset: number, length?: number) => TypedArray;
     byteOffset: number;
     length: number;
-    constructor(bufferIndex: number, TypedArray: new (buffer: ArrayBuffer, byteOffset: number, length?: number) => ArrayBufferView, byteOffset: number, length: number);
+    constructor(bufferIndex: number, TypedArray: new (buffer: ArrayBuffer, byteOffset: number, length?: number) => TypedArray, byteOffset: number, length: number);
 }
 /**
  * @internal
  */
 export declare class BlendShapeRestoreInfo {
     blendShape: BlendShape;
-    position: BufferDataRestoreInfo;
-    normal?: BufferDataRestoreInfo;
-    tangent?: BufferDataRestoreInfo;
-    constructor(blendShape: BlendShape, position: BufferDataRestoreInfo, normal?: BufferDataRestoreInfo, tangent?: BufferDataRestoreInfo);
+    position: BlendShapeDataRestoreInfo;
+    normal?: BlendShapeDataRestoreInfo;
+    tangent?: BlendShapeDataRestoreInfo;
+    constructor(blendShape: BlendShape, position: BlendShapeDataRestoreInfo, normal?: BlendShapeDataRestoreInfo, tangent?: BlendShapeDataRestoreInfo);
+}
+/**
+ * @internal
+ */
+export declare class BlendShapeDataRestoreInfo {
+    buffer: BufferDataRestoreInfo;
+    stride: number;
+    byteOffset: number;
+    count: number;
+    constructor(buffer: BufferDataRestoreInfo, stride: number, byteOffset: number, count: number);
 }

package/types/ProjectLoader.d.ts

@@ -0,0 +1 @@
+export {};

package/types/gltf/GLTFSchema.d.ts

@@ -1,7 +1,7 @@
 /**
  * Module for glTF 2.0 Interface
  */
-import { MeshTopology } from "@galacean/engine-core";
+import type { MeshTopology, TextureFilterMode, TextureWrapMode as EngineTextureWrapMode } from "@galacean/engine-core";
 /**
  * The datatype of the components in the attribute
  */
@@ -814,3 +814,9 @@ export interface IGLTF extends IProperty {
 }
 /** glTF extensible owner schema. */
 export type GLTFExtensionOwnerSchema = IMeshPrimitive | IMaterial | ITextureInfo | INode;
+export interface ISamplerInfo {
+    filterMode?: TextureFilterMode;
+    wrapModeU?: EngineTextureWrapMode;
+    wrapModeV?: EngineTextureWrapMode;
+    mipmap?: boolean;
+}

package/types/gltf/GLTFUtils.d.ts

@@ -1,6 +1,6 @@
-import { IndexFormat, TypedArray, VertexElementFormat } from "@galacean/engine-core";
+import { IndexFormat, Texture2D, TypedArray, VertexElementFormat } from "@galacean/engine-core";
 import { Color, Vector2, Vector3, Vector4 } from "@galacean/engine-math";
-import { AccessorComponentType, AccessorType, IAccessor, IBufferView, IGLTF } from "./GLTFSchema";
+import { AccessorComponentType, AccessorType, IAccessor, IBufferView, IGLTF, ISampler, ISamplerInfo } from "./GLTFSchema";
 import { BufferInfo, GLTFParserContext } from "./parser/GLTFParserContext";
 /**
  * @internal
@@ -19,7 +19,8 @@ export declare class GLTFUtils {
      */
     static getComponentType(componentType: AccessorComponentType): Float32ArrayConstructor | Uint32ArrayConstructor | Uint8ArrayConstructor | Uint16ArrayConstructor | Int8ArrayConstructor | Int16ArrayConstructor;
     static getNormalizedComponentScale(componentType: AccessorComponentType): number;
-    static getAccessorBuffer(context: GLTFParserContext, bufferViews: IBufferView[], accessor: IAccessor): BufferInfo;
+    static getAccessorBuffer(context: GLTFParserContext, bufferViews: IBufferView[], accessor: IAccessor): Promise<BufferInfo>;
+    static bufferToVector3Array(data: TypedArray, byteStride: number, accessorByteOffset: number, count: number): Vector3[];
     /**
      * @deprecated
      * Get accessor data.
@@ -43,5 +44,6 @@ export declare class GLTFUtils {
         glTF: IGLTF;
         buffers: ArrayBuffer[];
     };
-    private static _formatRelativePath;
+    static parseSampler(texture: Texture2D, samplerInfo: ISamplerInfo): void;
+    static getSamplerInfo(sampler: ISampler): ISamplerInfo;
 }

package/types/gltf/extensions/GLTFExtensionParser.d.ts

@@ -11,12 +11,6 @@ export declare abstract class GLTFExtensionParser {
      * The extension mode.
      */
     _mode: GLTFExtensionMode;
-    /**
-     * Initialize the parser.
-     * @remarks Some plugins require initialization.
-     * @returns The void or promise
-     */
-    initialize(): void | Promise<void>;
     /**
      * Create and parse the resource.
      * @remarks This method overrides the default resource creation.

package/types/gltf/index.d.ts

@@ -1,4 +1,3 @@
-export { GLTFPipeline } from "./GLTFPipeline";
 export { GLTFResource } from "./GLTFResource";
 export { GLTFUtils } from "./GLTFUtils";
 export * from "./parser";

package/types/gltf/parser/GLTFAnimationParser.d.ts

@@ -1,4 +1,4 @@
-import { AnimationClip, AssetPromise } from "@galacean/engine-core";
+import { AnimationClip } from "@galacean/engine-core";
 import { IAnimation } from "../GLTFSchema";
 import { GLTFParser } from "./GLTFParser";
 import { GLTFParserContext } from "./GLTFParserContext";
@@ -6,7 +6,7 @@ export declare class GLTFAnimationParser extends GLTFParser {
     /**
      * @internal
      */
-    static _parseStandardProperty(context: GLTFParserContext, animationClip: AnimationClip, animationInfo: IAnimation): void;
+    static _parseStandardProperty(context: GLTFParserContext, animationClip: AnimationClip, animationInfo: IAnimation): Promise<AnimationClip>;
     private static _addCurve;
-    parse(context: GLTFParserContext): AssetPromise<AnimationClip[]>;
+    parse(context: GLTFParserContext, index: number): Promise<AnimationClip>;
 }

package/types/gltf/parser/GLTFBufferParser.d.ts

@@ -1,7 +1,6 @@
-import { AssetPromise } from "@galacean/engine-core";
 import { GLTFParser } from "./GLTFParser";
 import { GLTFParserContext } from "./GLTFParserContext";
 export declare class GLTFBufferParser extends GLTFParser {
-    parse(context: GLTFParserContext): AssetPromise<void>;
-    private _isGLB;
+    parse(context: GLTFParserContext, index: number): Promise<ArrayBuffer>;
+    private _parseSingleBuffer;
 }

package/types/gltf/parser/GLTFEntityParser.d.ts

@@ -1,9 +1,6 @@
+import { Entity } from "@galacean/engine-core";
 import { GLTFParser } from "./GLTFParser";
 import { GLTFParserContext } from "./GLTFParserContext";
 export declare class GLTFEntityParser extends GLTFParser {
-    /** @internal */
-    static _defaultName: String;
-    parse(context: GLTFParserContext): void;
-    private _buildEntityTree;
-    private _createSceneRoots;
+    parse(context: GLTFParserContext, index: number): Entity;
 }

package/types/gltf/parser/GLTFMaterialParser.d.ts

@@ -1,8 +1,11 @@
-import { AssetPromise, Material, PBRMaterial, PBRSpecularMaterial, UnlitMaterial } from "@galacean/engine-core";
+import { BlinnPhongMaterial, Engine, Material, PBRMaterial, PBRSpecularMaterial, UnlitMaterial } from "@galacean/engine-core";
 import { IMaterial, ITextureInfo } from "../GLTFSchema";
 import { GLTFParser } from "./GLTFParser";
 import { GLTFParserContext } from "./GLTFParserContext";
 export declare class GLTFMaterialParser extends GLTFParser {
+    /** @internal */
+    static _getDefaultMaterial(engine: Engine): BlinnPhongMaterial;
+    private static _defaultMaterial;
     /**
      * @internal
      */
@@ -11,5 +14,5 @@ export declare class GLTFMaterialParser extends GLTFParser {
      * @internal
      */
     static _parseStandardProperty(context: GLTFParserContext, material: UnlitMaterial | PBRMaterial | PBRSpecularMaterial, materialInfo: IMaterial): void;
-    parse(context: GLTFParserContext): AssetPromise<Material[]>;
+    parse(context: GLTFParserContext, index: number): Promise<Material>;
 }

package/types/gltf/parser/GLTFMeshParser.d.ts

@@ -1,6 +1,6 @@
-import { AssetPromise, ModelMesh, TypedArray } from "@galacean/engine-core";
+import { ModelMesh, TypedArray } from "@galacean/engine-core";
 import { ModelMeshRestoreInfo } from "../../GLTFContentRestorer";
-import type { IGLTF, IMesh, IMeshPrimitive } from "../GLTFSchema";
+import type { IAccessor, IGLTF, IMesh, IMeshPrimitive } from "../GLTFSchema";
 import { GLTFParser } from "./GLTFParser";
 import { BufferInfo, GLTFParserContext } from "./GLTFParserContext";
 export declare class GLTFMeshParser extends GLTFParser {
@@ -8,12 +8,12 @@ export declare class GLTFMeshParser extends GLTFParser {
     /**
      * @internal
      */
-    static _parseMeshFromGLTFPrimitive(context: GLTFParserContext, mesh: ModelMesh, meshRestoreInfo: ModelMeshRestoreInfo, gltfMesh: IMesh, gltfPrimitive: IMeshPrimitive, gltf: IGLTF, getVertexBufferData: (semantic: string) => TypedArray, getBlendShapeData: (semantic: string, shapeIndex: number) => BufferInfo, getIndexBufferData: () => TypedArray, keepMeshData: boolean): Promise<ModelMesh>;
+    static _parseMeshFromGLTFPrimitive(context: GLTFParserContext, mesh: ModelMesh, meshRestoreInfo: ModelMeshRestoreInfo, gltfMesh: IMesh, gltfPrimitive: IMeshPrimitive, gltf: IGLTF, getVertexBufferData: (semantic: string) => TypedArray, getBlendShapeData: (semantic: string, shapeIndex: number) => Promise<BufferInfo>, getIndexBufferData: () => Promise<TypedArray>, keepMeshData: boolean): Promise<ModelMesh>;
     /**
      * @internal
      */
-    static _createBlendShape(mesh: ModelMesh, meshRestoreInfo: ModelMeshRestoreInfo, glTFMesh: IMesh, glTFTargets: {
+    static _createBlendShape(mesh: ModelMesh, meshRestoreInfo: ModelMeshRestoreInfo, glTFMesh: IMesh, accessors: IAccessor[], glTFTargets: {
         [name: string]: number;
-    }[], getBlendShapeData: (semantic: string, shapeIndex: number) => BufferInfo): void;
-    parse(context: GLTFParserContext): AssetPromise<ModelMesh[][]>;
+    }[], getBlendShapeData: (semantic: string, shapeIndex: number) => Promise<BufferInfo>): Promise<void[]>;
+    parse(context: GLTFParserContext, index: number): Promise<ModelMesh[]>;
 }

package/types/gltf/parser/GLTFParser.d.ts

@@ -1,18 +1,12 @@
-import { AnimationClip, AssetPromise, EngineObject, Material, Mesh } from "@galacean/engine-core";
-import { GLTFExtensionMode, GLTFExtensionParser } from "../extensions/GLTFExtensionParser";
+import { EngineObject } from "@galacean/engine-core";
 import type { GLTFExtensionOwnerSchema } from "../GLTFSchema";
+import { GLTFExtensionMode, GLTFExtensionParser } from "../extensions/GLTFExtensionParser";
 import { GLTFParserContext } from "./GLTFParserContext";
 /**
  * Base class of glTF parser.
  */
 export declare abstract class GLTFParser {
     private static readonly _extensionParsers;
-    /**
-     * Execute all parses of extension to initialize plugin.
-     * @remarks Some plugins require initialization.
-     * @returns The void or promise
-     */
-    static executeExtensionsInitialize(extensionName: string): void | Promise<void>;
     /**
      * Execute all parses of extension to create resource.
      * @param extensions - Related extensions field
@@ -54,7 +48,7 @@ export declare abstract class GLTFParser {
     static _addExtensionParser(extensionName: string, extensionParser: GLTFExtensionParser): void;
     private static _createAndParse;
     private static _additiveParse;
-    abstract parse(context: GLTFParserContext): AssetPromise<any> | void | Material | AnimationClip | Mesh;
+    abstract parse(context: GLTFParserContext, index?: number): any;
 }
 /**
  * Declare ExtensionParser's decorator.

package/types/gltf/parser/GLTFParserContext.d.ts

@@ -1,28 +1,31 @@
-import { AnimationClip, AssetPromise, Buffer, Entity, Material, ModelMesh, Texture2D, TypedArray } from "@galacean/engine-core";
+import { Buffer, Entity, ResourceManager, TypedArray } from "@galacean/engine-core";
 import { BufferDataRestoreInfo, GLTFContentRestorer } from "../../GLTFContentRestorer";
 import { GLTFResource } from "../GLTFResource";
 import type { IGLTF } from "../GLTFSchema";
+import { GLTFParser } from "./GLTFParser";
 /**
  * @internal
  */
 export declare class GLTFParserContext {
-    glTF: IGLTF;
-    buffers: ArrayBuffer[];
     glTFResource: GLTFResource;
+    resourceManager: ResourceManager;
     keepMeshData: boolean;
-    hasSkinned: boolean;
-    chainPromises: AssetPromise<any>[];
+    private static readonly _parsers;
+    static addParser(parserType: GLTFParserType, parser: GLTFParser): void;
+    glTF: IGLTF;
     accessorBufferCache: Record<string, BufferInfo>;
-    texturesPromiseInfo: PromiseInfo<Texture2D[]>;
-    materialsPromiseInfo: PromiseInfo<Material[]>;
-    meshesPromiseInfo: PromiseInfo<ModelMesh[][]>;
-    animationClipsPromiseInfo: PromiseInfo<AnimationClip[]>;
-    defaultSceneRootPromiseInfo: PromiseInfo<Entity>;
-    masterPromiseInfo: PromiseInfo<GLTFResource>;
-    promiseMap: Record<string, AssetPromise<any>>;
     contentRestorer: GLTFContentRestorer;
-    constructor(url: string);
-    private _initPromiseInfo;
+    buffers?: ArrayBuffer[];
+    private _resourceCache;
+    constructor(glTFResource: GLTFResource, resourceManager: ResourceManager, keepMeshData: boolean);
+    get<T>(type: GLTFParserType.Entity, index: number): Entity;
+    get<T>(type: GLTFParserType.Entity): Entity[];
+    get<T>(type: GLTFParserType.Schema): Promise<T>;
+    get<T>(type: GLTFParserType.Validator): Promise<T>;
+    get<T>(type: GLTFParserType, index: number): Promise<T>;
+    get<T>(type: GLTFParserType): Promise<T[]>;
+    parse(): Promise<GLTFResource>;
+    private _handleSubAsset;
 }
 /**
  * @internal
@@ -36,13 +39,16 @@ export declare class BufferInfo {
     restoreInfo: BufferDataRestoreInfo;
     constructor(data: TypedArray, interleaved: boolean, stride: number);
 }
-/**
- * @internal
- */
-export declare class PromiseInfo<T> {
-    promise: AssetPromise<T>;
-    resolve: (value?: T | PromiseLike<T>) => void;
-    reject: (reason?: any) => void;
-    setProgress: (progress: number) => void;
-    onCancel: (callback: () => void) => void;
+export declare enum GLTFParserType {
+    Schema = 0,
+    Validator = 1,
+    Scene = 2,
+    Buffer = 3,
+    Texture = 4,
+    Material = 5,
+    Mesh = 6,
+    Entity = 7,
+    Skin = 8,
+    Animation = 9
 }
+export declare function registerGLTFParser(pipeline: GLTFParserType): (Parser: new () => GLTFParser) => void;

package/types/gltf/parser/GLTFSceneParser.d.ts

@@ -2,10 +2,11 @@ import { Entity } from "@galacean/engine-core";
 import { GLTFParser } from "./GLTFParser";
 import { GLTFParserContext } from "./GLTFParserContext";
 export declare class GLTFSceneParser extends GLTFParser {
-    private static _defaultMaterial;
-    private static _getDefaultMaterial;
-    parse(context: GLTFParserContext): import("@galacean/engine-core").AssetPromise<Entity>;
+    parse(context: GLTFParserContext, index: number): Promise<Entity>;
+    private _parseEntityComponent;
     private _createCamera;
     private _createRenderer;
     private _createAnimator;
+    private _computeLocalBounds;
+    private _computeApproximateBindMatrix;
 }

package/types/gltf/parser/GLTFSchemaParser.d.ts

@@ -0,0 +1,7 @@
+import { IGLTF } from "../GLTFSchema";
+import { GLTFParser } from "./GLTFParser";
+import { GLTFParserContext } from "./GLTFParserContext";
+export declare class GLTFSchemaParser extends GLTFParser {
+    parse(context: GLTFParserContext): Promise<IGLTF>;
+    private _isGLB;
+}

package/types/gltf/parser/GLTFSkinParser.d.ts

@@ -1,6 +1,7 @@
-import { GLTFParserContext } from ".";
+import { Skin } from "@galacean/engine-core";
 import { GLTFParser } from "./GLTFParser";
+import { GLTFParserContext } from "./GLTFParserContext";
 export declare class GLTFSkinParser extends GLTFParser {
-    parse(context: GLTFParserContext): void;
+    parse(context: GLTFParserContext, index: number): Promise<Skin>;
     private _findSkeletonRootBone;
 }

package/types/gltf/parser/GLTFTextureParser.d.ts

@@ -1,8 +1,12 @@
-import { AssetPromise, Texture2D } from "@galacean/engine-core";
+import { Texture, TextureWrapMode } from "@galacean/engine-core";
 import { GLTFParser } from "./GLTFParser";
-import { GLTFParserContext } from ".";
+import { GLTFParserContext } from "./GLTFParserContext";
 export declare class GLTFTextureParser extends GLTFParser {
-    private static _wrapMap;
-    parse(context: GLTFParserContext): AssetPromise<Texture2D[]>;
-    private _parseSampler;
+    /** @internal */
+    static _wrapMap: {
+        33071: TextureWrapMode;
+        33648: TextureWrapMode;
+        10497: TextureWrapMode;
+    };
+    parse(context: GLTFParserContext, index: number): Promise<Texture>;
 }

package/types/gltf/parser/GLTFValidator.d.ts

@@ -1,6 +1,5 @@
-import { AssetPromise } from "@galacean/engine-core";
 import { GLTFParser } from "./GLTFParser";
 import { GLTFParserContext } from "./GLTFParserContext";
 export declare class GLTFValidator extends GLTFParser {
-    parse(context: GLTFParserContext): AssetPromise<void>;
+    parse(context: GLTFParserContext): Promise<void>;
 }

package/types/gltf/parser/index.d.ts

@@ -1,3 +1,4 @@
+export { GLTFSchemaParser } from "./GLTFSchemaParser";
 export { GLTFAnimationParser } from "./GLTFAnimationParser";
 export { GLTFBufferParser } from "./GLTFBufferParser";
 export { GLTFEntityParser } from "./GLTFEntityParser";
@@ -8,4 +9,4 @@ export { GLTFSceneParser } from "./GLTFSceneParser";
 export { GLTFSkinParser } from "./GLTFSkinParser";
 export { GLTFTextureParser } from "./GLTFTextureParser";
 export { GLTFValidator } from "./GLTFValidator";
-export { GLTFParserContext } from "./GLTFParserContext";
+export { GLTFParserContext, GLTFParserType, registerGLTFParser } from "./GLTFParserContext";

package/types/ktx2/BinomialLLCTranscoder/BinomialLLCTranscoder.d.ts

@@ -0,0 +1,13 @@
+import { KTX2TargetFormat } from "../KTX2TargetFormat";
+import { TranscodeResult } from "../TranscodeResult";
+/** @internal */
+export declare class BinomialLLCTranscoder {
+    readonly workerLimit: number;
+    static MessageId: number;
+    private _transcodeWorkerPool;
+    private _initPromise;
+    constructor(workerLimit: number);
+    init(): Promise<any>;
+    transcode(buffer: ArrayBuffer, format: KTX2TargetFormat): Promise<TranscodeResult>;
+    destroy(): void;
+}

package/types/ktx2/BinomialLLCTranscoder/TranscodeWorkerCode.d.ts

@@ -0,0 +1,33 @@
+type MessageType = "init" | "transcode";
+export interface IBaseMessage {
+    type: MessageType;
+}
+export interface IInitMessage extends IBaseMessage {
+    type: "init";
+    transcoderWasm: ArrayBuffer;
+}
+export interface ITranscodeMessage extends IBaseMessage {
+    type: "transcode";
+    format: number;
+    buffer: ArrayBuffer;
+}
+export type IMessage = IInitMessage | ITranscodeMessage;
+export type TranscodeResult = {
+    width: number;
+    height: number;
+    hasAlpha: boolean;
+    format: number;
+    faces: Array<{
+        data: Uint8Array;
+        width: number;
+        height: number;
+    }>[];
+    faceCount: number;
+};
+export type TranscodeResponse = {
+    id: number;
+    type: "transcoded";
+} & TranscodeResult;
+/** @internal */
+export declare function TranscodeWorkerCode(): void;
+export {};

package/types/ktx2/KTX2Container.d.ts

@@ -0,0 +1,72 @@
+export declare enum SupercompressionScheme {
+    None = 0,
+    BasisLZ = 1,
+    Zstd = 2,
+    ZLib = 3
+}
+/** @internal */
+export declare class KTX2Container {
+    vkFormat: number;
+    typeSize: number;
+    pixelWidth: number;
+    pixelHeight: number;
+    pixelDepth: number;
+    layerCount: number;
+    faceCount: number;
+    supercompressionScheme: SupercompressionScheme;
+    levels: KTX2Level[];
+    dataFormatDescriptor: KTX2DataFormatDescriptorBasicFormat;
+    keyValue: {
+        [key: string]: string | Uint8Array;
+    };
+    globalData: KTX2GlobalDataBasisLZ | null;
+    constructor(buffer: Uint8Array);
+    get isSRGB(): boolean;
+    get isUASTC(): boolean;
+    private parse;
+}
+interface KTX2Level {
+    levelData: Uint8Array;
+    uncompressedByteLength: number;
+}
+interface KTX2DataFormatDescriptorBasicFormat {
+    vendorId: number;
+    descriptorType: number;
+    versionNumber: number;
+    /** @deprecated Inferred. */
+    descriptorBlockSize: number;
+    colorModel: number;
+    colorPrimaries: number;
+    transferFunction: number;
+    flags: number;
+    texelBlockDimension: [number, number, number, number];
+    bytesPlane: [number, number, number, number, number, number, number, number];
+    samples: KTX2BasicFormatSample[];
+}
+interface KTX2BasicFormatSample {
+    bitOffset: number;
+    bitLength: number;
+    /** @deprecated Renamed to 'channelType'. */
+    channelID?: number;
+    channelType: number;
+    samplePosition: number[];
+    sampleLower: number;
+    sampleUpper: number;
+}
+interface KTX2GlobalDataBasisLZ {
+    endpointCount: number;
+    selectorCount: number;
+    imageDescs: KTX2GlobalDataBasisLZImageDesc[];
+    endpointsData: Uint8Array;
+    selectorsData: Uint8Array;
+    tablesData: Uint8Array;
+    extendedData: Uint8Array;
+}
+interface KTX2GlobalDataBasisLZImageDesc {
+    imageFlags: number;
+    rgbSliceByteOffset: number;
+    rgbSliceByteLength: number;
+    alphaSliceByteOffset: number;
+    alphaSliceByteLength: number;
+}
+export {};

package/types/ktx2/KTX2Loader.d.ts

@@ -0,0 +1,53 @@
+import { AssetPromise, Engine, EngineConfiguration, LoadItem, Loader, ResourceManager, Texture2D, TextureCube } from "@galacean/engine-core";
+import { KTX2TargetFormat } from "./KTX2TargetFormat";
+import { TranscodeResult } from "./transcoder/AbstractTranscoder";
+export declare class KTX2Loader extends Loader<Texture2D | TextureCube> {
+    private static _isBinomialInit;
+    private static _binomialLLCTranscoder;
+    private static _khronosTranscoder;
+    private static _supportedMap;
+    /**
+     * Destroy ktx2 transcoder worker.
+     */
+    static destroy(): void;
+    /** @internal */
+    static _parseBuffer(buffer: Uint8Array, engine: Engine, params?: KTX2Params): Promise<{
+        engine: Engine;
+        result: TranscodeResult;
+        targetFormat: KTX2TargetFormat;
+        params: Uint8Array;
+    }>;
+    /** @internal */
+    static _createTextureByBuffer(engine: Engine, transcodeResult: TranscodeResult, targetFormat: KTX2TargetFormat, params?: Uint8Array): Texture2D | TextureCube;
+    private static _decideTargetFormat;
+    private static _detectSupportedFormat;
+    private static _getBinomialLLCTranscoder;
+    private static _getKhronosTranscoder;
+    private static _getEngineTextureFormat;
+    initialize(engine: Engine, configuration: EngineConfiguration): Promise<void>;
+    /**
+     * @internal
+     */
+    load(item: LoadItem & {
+        params?: KTX2Params;
+    }, resourceManager: ResourceManager): AssetPromise<Texture2D | TextureCube>;
+    private _isKhronosSupported;
+}
+/**
+ * KTX2 loader params interface.
+ */
+export interface KTX2Params {
+    /** Priority transcoding format queue, default is ASTC/ETC/DXT/PVRTC/RGBA8. */
+    priorityFormats: KTX2TargetFormat[];
+}
+declare module "@galacean/engine-core" {
+    interface EngineConfiguration {
+        /** KTX2 loader options. */
+        ktx2Loader?: {
+            /** Worker count for transcoder, default is 4. */
+            workerCount?: number;
+            /** Pre-initialization according to the priority transcoding format queue, default is ASTC/ETC/DXT/PVRTC/RGBA8. */
+            priorityFormats?: KTX2TargetFormat[] | KTX2TargetFormat[][];
+        };
+    }
+}

package/types/ktx2/KTX2TargetFormat.d.ts

@@ -0,0 +1,21 @@
+/**
+ * KTX2 transcode target format.
+ */
+export declare enum KTX2TargetFormat {
+    /** RGB(A) compressed format, 128 bits per 4x4 pixel block. */
+    ASTC = 0,
+    /** RGB(A) compressed format, 128 bits per 4x4 pixel block. */
+    BC7 = 1,
+    /** RGB(A) compressed format, 4 bits per pixel if no alpha channel, 8 bits per pixel if has alpha channel. */
+    BC1_BC3 = 2,
+    /** RGB(A) compressed format, 4 bits per pixel. */
+    PVRTC = 3,
+    /** RGB(A) compressed format, 4 bits per pixel if no alpha channel, 8 bits per pixel if has alpha channel. */
+    ETC = 4,
+    /** R format, 8 bits per pixel. */
+    R8 = 5,
+    /** RG format, 16 bits per pixel. */
+    R8G8 = 6,
+    /** RGBA format, 32 bits per pixel. */
+    R8G8B8A8 = 7
+}

package/types/ktx2/KhronosTranscoder/KhronosTranscoder.d.ts

@@ -0,0 +1,17 @@
+import { KTX2Container } from "../KTX2Container";
+import { KTX2TargetFormat } from "../KTX2TargetFormat";
+import { TranscodeResult } from "./TranscoderWorkerCode";
+/** @internal */
+export declare class KhronosTranscoder {
+    readonly workerLimit: number;
+    readonly type: KTX2TargetFormat;
+    static transcoderMap: {
+        0: string;
+    };
+    private _transcodeWorkerPool;
+    private _initPromise;
+    constructor(workerLimit: number, type: KTX2TargetFormat);
+    init(): Promise<any>;
+    transcode(ktx2Container: KTX2Container): Promise<TranscodeResult>;
+    destroy(): void;
+}

package/types/ktx2/KhronosTranscoder/TranscoderWorkerCode.d.ts

@@ -0,0 +1,34 @@
+export interface EncodedData {
+    buffer: Uint8Array;
+    levelWidth: number;
+    levelHeight: number;
+    uncompressedByteLength: number;
+}
+type MessageType = "init" | "transcode";
+export interface IBaseMessage {
+    type: MessageType;
+}
+export interface IInitMessage extends IBaseMessage {
+    type: "init";
+    transcoderWasm: ArrayBuffer;
+}
+export interface ITranscodeMessage extends IBaseMessage {
+    type: "transcode";
+    format: number;
+    needZstd: boolean;
+    data: EncodedData[][];
+}
+export type IMessage = IInitMessage | ITranscodeMessage;
+export type TranscodeResult = {
+    data: Array<{
+        data: Uint8Array;
+        width: number;
+        height: number;
+    }>;
+};
+export type TranscodeResponse = {
+    id: number;
+    type: "transcoded";
+} & TranscodeResult;
+export declare function TranscodeWorkerCode(): void;
+export {};