@galacean/engine-loader 0.9.0 → 1.0.0-beta.0

package/package.json

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

package/types/AnimationClipLoader.d.ts

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

package/types/GLTFContentRestorer.d.ts

@@ -0,0 +1,85 @@
+import { AssetPromise, BlendShape, Buffer, ContentRestorer, ModelMesh, Texture2D } from "@galacean/engine-core";
+import { RequestConfig } from "@galacean/engine-core/types/asset/request";
+import { Vector2 } from "@galacean/engine-math";
+import { GLTFResource } from "./gltf/GLTFResource";
+import { IBufferView } from "./gltf/GLTFSchema";
+/**
+ * @internal
+ */
+export declare class GLTFContentRestorer extends ContentRestorer<GLTFResource> {
+    isGLB: boolean;
+    bufferRequests: BufferRequestInfo[];
+    glbBufferSlices: Vector2[];
+    bufferTextures: BufferTextureRestoreInfo[];
+    meshes: ModelMeshRestoreInfo[];
+    /**
+     * @override
+     */
+    restoreContent(): AssetPromise<GLTFResource>;
+    private _getBufferData;
+}
+/**
+ * @internal
+ */
+export declare class BufferRequestInfo {
+    url: string;
+    config: RequestConfig;
+    constructor(url: string, config: RequestConfig);
+}
+/**
+ * @internal
+ */
+export declare class BufferTextureRestoreInfo {
+    texture: Texture2D;
+    bufferView: IBufferView;
+    mimeType: string;
+    constructor(texture: Texture2D, bufferView: IBufferView, mimeType: string);
+}
+/**
+ * @internal
+ */
+export declare class ModelMeshRestoreInfo {
+    mesh: ModelMesh;
+    vertexBuffers: BufferRestoreInfo[];
+    indexBuffer: BufferDataRestoreInfo;
+    blendShapes: BlendShapeRestoreInfo[];
+}
+/**
+ * @internal
+ */
+export declare class BufferRestoreInfo {
+    buffer: Buffer;
+    data: BufferDataRestoreInfo;
+    constructor(buffer: Buffer, data: BufferDataRestoreInfo);
+}
+/**
+ * @internal
+ */
+export declare class BufferDataRestoreInfo {
+    main: RestoreDataAccessor;
+    typeSize?: number;
+    sparseCount?: number;
+    sparseIndices?: RestoreDataAccessor;
+    sparseValues?: RestoreDataAccessor;
+    constructor(main: RestoreDataAccessor, typeSize?: number, sparseCount?: number, sparseIndices?: RestoreDataAccessor, sparseValues?: RestoreDataAccessor);
+}
+/**
+ * @internal
+ */
+export declare class RestoreDataAccessor {
+    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) => ArrayBufferView, 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);
+}

package/types/GLTFLoader.d.ts

@@ -1,6 +1,10 @@
 import { AssetPromise, Loader, LoadItem, ResourceManager } from "@galacean/engine-core";
+import { GLTFPipeline } from "./gltf/GLTFPipeline";
 import { GLTFResource } from "./gltf/GLTFResource";
 export declare class GLTFLoader extends Loader<GLTFResource> {
+    /**
+     * @override
+     */
     load(item: LoadItem, resourceManager: ResourceManager): Record<string, AssetPromise<any>>;
 }
 /**
@@ -12,4 +16,6 @@ export interface GLTFParams {
      * Keep raw mesh data for glTF parser, default is false.
      */
     keepMeshData: boolean;
+    /** Custom glTF pipeline. */
+    pipeline: GLTFPipeline;
 }

package/types/Texture2DContentRestorer.d.ts

@@ -0,0 +1,14 @@
+import { AssetPromise, ContentRestorer, Texture2D } from "@galacean/engine-core";
+import { RequestConfig } from "@galacean/engine-core/types/asset/request";
+/**
+ * @internal
+ */
+export declare class Texture2DContentRestorer extends ContentRestorer<Texture2D> {
+    url: string;
+    requestConfig: RequestConfig;
+    constructor(resource: Texture2D, url: string, requestConfig: RequestConfig);
+    /**
+     * @override
+     */
+    restoreContent(): AssetPromise<Texture2D>;
+}

package/types/TextureCubeContentRestorer.d.ts

@@ -0,0 +1,14 @@
+import { AssetPromise, ContentRestorer, TextureCube } from "@galacean/engine-core";
+import { RequestConfig } from "@galacean/engine-core/types/asset/request";
+/**
+ * @internal
+ */
+export declare class TextureCubeContentRestorer extends ContentRestorer<TextureCube> {
+    urls: string[];
+    requestConfig: RequestConfig;
+    constructor(resource: TextureCube, urls: string[], requestConfig: RequestConfig);
+    /**
+     * @override
+     */
+    restoreContent(): AssetPromise<TextureCube>;
+}

package/types/gltf/GLTFPipeline.d.ts

@@ -0,0 +1,23 @@
+import { AssetPromise } from "@galacean/engine-core";
+import { GLTFResource } from "./GLTFResource";
+import { GLTFParser } from "./parser/GLTFParser";
+import { GLTFParserContext } from "./parser/GLTFParserContext";
+/**
+ * GLTF pipeline.
+ */
+export declare class GLTFPipeline {
+    /**
+     * Default pipeline.
+     */
+    static defaultPipeline: GLTFPipeline;
+    private _parsers;
+    /**
+     * Constructor of GLTFPipeline.
+     * @param parsers - Parsers to be executed in order
+     */
+    constructor(...parsers: (new () => GLTFParser)[]);
+    /**
+     * @internal
+     */
+    _parse(context: GLTFParserContext): AssetPromise<GLTFResource>;
+}

package/types/gltf/GLTFResource.d.ts

@@ -1,9 +1,9 @@
-import { AnimationClip, Camera, Engine, EngineObject, Entity, Light, Material, ModelMesh, Renderer, Skin, Texture2D } from "@galacean/engine-core";
+import { AnimationClip, Camera, Engine, EngineObject, Entity, Light, Material, ModelMesh, Skin, Texture2D } from "@galacean/engine-core";
 /**
- * Product after GLTF parser, usually, `defaultSceneRoot` is only needed to use.
+ * Product after glTF parser, usually, `defaultSceneRoot` is only needed to use.
  */
 export declare class GLTFResource extends EngineObject {
-    /** GLTF file url. */
+    /** glTF file url. */
     url: string;
     /** Texture2D after TextureParser. */
     textures?: Texture2D[];
@@ -19,21 +19,17 @@ export declare class GLTFResource extends EngineObject {
     entities: Entity[];
     /** Camera after SceneParser. */
     cameras?: Camera[];
-    /** Export lights in extension KHR_lights_punctual */
+    /** Export lights in extension KHR_lights_punctual. */
     lights?: Light[];
     /** RootEntities after SceneParser. */
     sceneRoots: Entity[];
     /** RootEntity after SceneParser. */
     defaultSceneRoot: Entity;
-    /** Renderer can replace material by `renderer.setMaterial` if gltf use plugin-in KHR_materials_variants. */
-    variants?: {
-        renderer: Renderer;
-        material: Material;
-        variants: string[];
-    }[];
+    /** Extensions data. */
+    extensionsData: Record<string, any>;
     constructor(engine: Engine, url: string);
     /**
      * @override
      */
-    destroy(): void;
+    protected _onDestroy(): void;
 }

package/types/gltf/{Schema.d.ts → GLTFSchema.d.ts}

@@ -812,3 +812,5 @@ export interface IGLTF extends IProperty {
      */
     textures?: ITexture[];
 }
+/** glTF extensible owner schema. */
+export type GLTFExtensionOwnerSchema = IMeshPrimitive | IMaterial | ITextureInfo | INode;

package/types/gltf/{GLTFUtil.d.ts → GLTFUtils.d.ts}

@@ -1,19 +1,15 @@
 import { IndexFormat, TypedArray, VertexElementFormat } from "@galacean/engine-core";
 import { Color, Vector2, Vector3, Vector4 } from "@galacean/engine-math";
-import { BufferInfo, ParserContext } from "./parser/ParserContext";
-import { AccessorComponentType, AccessorType, IAccessor, IBufferView, IGLTF } from "./Schema";
+import { AccessorComponentType, AccessorType, IAccessor, IBufferView, IGLTF } from "./GLTFSchema";
+import { BufferInfo, GLTFParserContext } from "./parser/GLTFParserContext";
 /**
  * @internal
  */
-export declare class GLTFUtil {
+export declare class GLTFUtils {
     static floatBufferToVector2Array(buffer: Float32Array): Vector2[];
     static floatBufferToVector3Array(buffer: Float32Array): Vector3[];
     static floatBufferToVector4Array(buffer: Float32Array): Vector4[];
     static floatBufferToColorArray(buffer: Float32Array, isColor3: boolean): Color[];
-    /**
-     * Parse binary text for glb loader.
-     */
-    static decodeText(array: Uint8Array): string;
     /**
      * Get the number of bytes occupied by accessor type.
      */
@@ -21,32 +17,30 @@ export declare class GLTFUtil {
     /**
      * Get the TypedArray corresponding to the component type.
      */
-    static getComponentType(componentType: AccessorComponentType): Uint8ArrayConstructor | Float32ArrayConstructor | Uint16ArrayConstructor | Int8ArrayConstructor | Int16ArrayConstructor | Uint32ArrayConstructor;
+    static getComponentType(componentType: AccessorComponentType): Uint8ArrayConstructor | Int8ArrayConstructor | Int16ArrayConstructor | Uint16ArrayConstructor | Uint32ArrayConstructor | Float32ArrayConstructor;
     static getNormalizedComponentScale(componentType: AccessorComponentType): number;
-    static getAccessorBuffer(context: ParserContext, gltf: IGLTF, accessor: IAccessor): BufferInfo;
+    static getAccessorBuffer(context: GLTFParserContext, bufferViews: IBufferView[], accessor: IAccessor): BufferInfo;
     /**
      * @deprecated
      * Get accessor data.
      */
-    static getAccessorData(gltf: IGLTF, accessor: IAccessor, buffers: ArrayBuffer[]): TypedArray;
+    static getAccessorData(glTF: IGLTF, accessor: IAccessor, buffers: ArrayBuffer[]): TypedArray;
     static getBufferViewData(bufferView: IBufferView, buffers: ArrayBuffer[]): ArrayBuffer;
     /**
      * Get accessor data.
      */
-    static processingSparseData(gltf: IGLTF, accessor: IAccessor, buffers: ArrayBuffer[], originData: TypedArray): TypedArray;
+    static processingSparseData(bufferViews: IBufferView[], accessor: IAccessor, buffers: ArrayBuffer[], bufferInfo: BufferInfo): void;
     static getIndexFormat(type: AccessorComponentType): IndexFormat;
     static getElementFormat(type: AccessorComponentType, size: number, normalized?: boolean): VertexElementFormat;
     /**
      * Load image buffer
      */
     static loadImageBuffer(imageBuffer: ArrayBuffer, type: string): Promise<HTMLImageElement>;
-    static isAbsoluteUrl(url: string): boolean;
-    static parseRelativeUrl(baseUrl: string, relativeUrl: string): string;
     /**
      * Parse the glb format.
      */
-    static parseGLB(glb: ArrayBuffer): {
-        gltf: IGLTF;
+    static parseGLB(context: GLTFParserContext, glb: ArrayBuffer): {
+        glTF: IGLTF;
         buffers: ArrayBuffer[];
     };
     private static _formatRelativePath;

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

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

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

@@ -0,0 +1,52 @@
+import { EngineObject } from "@galacean/engine-core";
+import { GLTFExtensionOwnerSchema } from "../GLTFSchema";
+import { GLTFParserContext } from "../parser/GLTFParserContext";
+import { GLTFExtensionSchema } from "./GLTFExtensionSchema";
+/**
+ * Base class of glTF extension parser.
+ */
+export declare abstract class GLTFExtensionParser {
+    /**
+     * @internal
+     * 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.
+     * @param context - The parser context
+     * @param extensionSchema - The extension schema
+     * @param extensionOwnerSchema - The extension owner schema
+     * @returns The resource or promise
+     */
+    createAndParse(context: GLTFParserContext, extensionSchema: GLTFExtensionSchema, extensionOwnerSchema: GLTFExtensionOwnerSchema, ...extra: any[]): EngineObject | Promise<EngineObject>;
+    /**
+     * Additive parse to the resource.
+     * @param context - The parser context
+     * @param parseResource - The parsed resource
+     * @param extensionSchema - The extension schema
+     * @param extensionOwnerSchema - The extension owner schema
+     * @returns The void or promise
+     */
+    additiveParse(context: GLTFParserContext, parseResource: EngineObject, extensionSchema: GLTFExtensionSchema, extensionOwnerSchema: GLTFExtensionOwnerSchema, ...extra: any[]): void | Promise<void>;
+}
+/**
+ * glTF Extension mode.
+ */
+export declare enum GLTFExtensionMode {
+    /**
+     * Cerate instance and parse mode.
+     * @remarks
+     * If the glTF property has multiple extensions of `CreateAndParse` mode, only execute the last one.
+     * If this method is registered, the default pipeline processing will be ignored.
+     */
+    CreateAndParse = 0,
+    /** Additive parse mode. */
+    AdditiveParse = 1
+}

package/types/gltf/extensions/{Schema.d.ts → GLTFExtensionSchema.d.ts}

@@ -1,4 +1,4 @@
-import { IMaterialNormalTextureInfo, ITextureInfo } from "../Schema";
+import { IMaterialNormalTextureInfo, ITextureInfo } from "../GLTFSchema";
 /**
  * Interfaces from the KHR_lights_punctual extension
  */
@@ -139,4 +139,11 @@ export interface IGalaceanMaterialRemap {
     key?: string;
     isClone?: boolean;
 }
-export type ExtensionSchema = IKHRLightsPunctual_Light | IKHRDracoMeshCompression | IKHRMaterialsClearcoat | IKHRMaterialsIor | IKHRMaterialsUnlit | IKHRMaterialsPbrSpecularGlossiness | IKHRMaterialsSheen | IKHRMaterialsSpecular | IKHRMaterialsTransmission | IKHRMaterialsTranslucency | IKHRMaterialVariants_Mapping | IKHRMaterialVariants_Variants | IKHRTextureBasisU | IKHRTextureTransform | IKHRXmp | IKHRXmp_Node;
+export interface IGalaceanAnimation {
+    events: {
+        time: number;
+        functionName: string;
+        parameter: any;
+    }[];
+}
+export type GLTFExtensionSchema = IKHRLightsPunctual_Light | IKHRDracoMeshCompression | IKHRMaterialsClearcoat | IKHRMaterialsIor | IKHRMaterialsUnlit | IKHRMaterialsPbrSpecularGlossiness | IKHRMaterialsSheen | IKHRMaterialsSpecular | IKHRMaterialsTransmission | IKHRMaterialsTranslucency | IKHRMaterialVariants_Mapping | IKHRMaterialVariants_Variants | IKHRTextureBasisU | IKHRTextureTransform | IKHRXmp | IKHRXmp_Node | IGalaceanAnimation | Object;

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

@@ -1 +1,6 @@
-export {};
+import { Material, Renderer } from "@galacean/engine-core";
+export type IGLTFExtensionVariants = Array<{
+    renderer: Renderer;
+    material: Material;
+    variants: string[];
+}>;

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

@@ -6,9 +6,12 @@ import "./KHR_materials_pbrSpecularGlossiness";
 import "./KHR_materials_sheen";
 import "./KHR_materials_transmission";
 import "./KHR_materials_unlit";
-import "./KHR_materials_variants";
+export type { IGLTFExtensionVariants } from "./KHR_materials_variants";
 import "./KHR_materials_volume";
 import "./KHR_mesh_quantization";
 import "./KHR_texture_basisu";
 import "./KHR_texture_transform";
 import "./GALACEAN_materials_remap";
+import "./GALACEAN_animation_event";
+export { GLTFExtensionParser, GLTFExtensionMode } from "./GLTFExtensionParser";
+export * from "./GLTFExtensionSchema";

package/types/gltf/index.d.ts

@@ -0,0 +1,6 @@
+export { GLTFPipeline } from "./GLTFPipeline";
+export { GLTFResource } from "./GLTFResource";
+export { GLTFUtils } from "./GLTFUtils";
+export * from "./parser";
+export * from "./extensions/index";
+export type { IMaterial, IMeshPrimitive, ITextureInfo, INode, GLTFExtensionOwnerSchema } from "./GLTFSchema";

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

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

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

@@ -0,0 +1,7 @@
+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;
+}

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

@@ -0,0 +1,9 @@
+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;
+}

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

@@ -0,0 +1,15 @@
+import { AssetPromise, 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 _checkOtherTextureTransform(texture: ITextureInfo, textureName: string): void;
+    /**
+     * @internal
+     */
+    static _parseStandardProperty(context: GLTFParserContext, material: UnlitMaterial | PBRMaterial | PBRSpecularMaterial, materialInfo: IMaterial): void;
+    parse(context: GLTFParserContext): AssetPromise<Material[]>;
+}

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

@@ -0,0 +1,19 @@
+import { AssetPromise, ModelMesh, TypedArray } from "@galacean/engine-core";
+import { ModelMeshRestoreInfo } from "../../GLTFContentRestorer";
+import { IGLTF, IMesh, IMeshPrimitive } from "../GLTFSchema";
+import { GLTFParser } from "./GLTFParser";
+import { BufferInfo, GLTFParserContext } from "./GLTFParserContext";
+export declare class GLTFMeshParser extends GLTFParser {
+    private static _tempVector3;
+    /**
+     * @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>;
+    /**
+     * @internal
+     */
+    static _createBlendShape(mesh: ModelMesh, meshRestoreInfo: ModelMeshRestoreInfo, glTFMesh: IMesh, glTFTargets: {
+        [name: string]: number;
+    }[], getBlendShapeData: (semantic: string, shapeIndex: number) => BufferInfo): void;
+    parse(context: GLTFParserContext): AssetPromise<ModelMesh[][]>;
+}

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

@@ -0,0 +1,63 @@
+import { AnimationClip, AssetPromise, EngineObject, Material, Mesh } from "@galacean/engine-core";
+import { GLTFExtensionMode, GLTFExtensionParser } from "../extensions/GLTFExtensionParser";
+import { GLTFExtensionOwnerSchema } from "../GLTFSchema";
+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
+     * @param context - The parser context
+     * @param ownerSchema - The extension owner schema
+     * @param extra - Extra params
+     * @returns
+     */
+    static executeExtensionsCreateAndParse(extensions: {
+        [key: string]: any;
+    }, context: GLTFParserContext, ownerSchema: GLTFExtensionOwnerSchema, ...extra: any[]): EngineObject | void | Promise<EngineObject | void>;
+    /**
+     * Execute all parses of extension to parse resource.
+     * @param extensions - Related extensions field
+     * @param context - The parser context
+     * @param parseResource -  The parsed resource
+     * @param ownerSchema - The extension owner schema
+     * @param extra - Extra params
+     */
+    static executeExtensionsAdditiveAndParse(extensions: {
+        [key: string]: any;
+    }, context: GLTFParserContext, parseResource: EngineObject, ownerSchema: GLTFExtensionOwnerSchema, ...extra: any[]): void;
+    /**
+     * Whether the plugin is registered.
+     * @param extensionName - Extension name
+     * @returns Boolean
+     */
+    static hasExtensionParser(extensionName: string): boolean;
+    /**
+     * Get the last plugin by glTF extension mode.
+     * @param extensionName - Extension name
+     * @param mode - GLTF extension mode
+     * @returns GLTF extension parser
+     */
+    static getExtensionParser(extensionName: string, mode: GLTFExtensionMode): GLTFExtensionParser | undefined;
+    /**
+     * @internal
+     */
+    static _addExtensionParser(extensionName: string, extensionParser: GLTFExtensionParser): void;
+    private static _createAndParse;
+    private static _additiveParse;
+    abstract parse(context: GLTFParserContext): AssetPromise<any> | void | Material | AnimationClip | Mesh;
+}
+/**
+ * Declare ExtensionParser's decorator.
+ * @param extensionName - Extension name
+ */
+export declare function registerGLTFExtension(extensionName: string, mode: GLTFExtensionMode): (parser: new () => GLTFExtensionParser) => void;

package/types/gltf/parser/{ParserContext.d.ts → GLTFParserContext.d.ts}

@@ -1,16 +1,16 @@
 import { AnimationClip, AssetPromise, Buffer, Entity, Material, ModelMesh, Texture2D, TypedArray } from "@galacean/engine-core";
+import { BufferDataRestoreInfo, GLTFContentRestorer } from "../../GLTFContentRestorer";
 import { GLTFResource } from "../GLTFResource";
-import { IGLTF } from "../Schema";
+import { IGLTF } from "../GLTFSchema";
 /**
  * @internal
  */
-export declare class ParserContext {
-    gltf: IGLTF;
+export declare class GLTFParserContext {
+    glTF: IGLTF;
     buffers: ArrayBuffer[];
     glTFResource: GLTFResource;
     keepMeshData: boolean;
     hasSkinned: boolean;
-    /** chain asset promise */
     chainPromises: AssetPromise<any>[];
     accessorBufferCache: Record<string, BufferInfo>;
     texturesPromiseInfo: PromiseInfo<Texture2D[]>;
@@ -20,6 +20,7 @@ export declare class ParserContext {
     defaultSceneRootPromiseInfo: PromiseInfo<Entity>;
     masterPromiseInfo: PromiseInfo<GLTFResource>;
     promiseMap: Record<string, AssetPromise<any>>;
+    contentRestorer: GLTFContentRestorer;
     constructor(url: string);
     private _initPromiseInfo;
 }
@@ -32,6 +33,7 @@ export declare class BufferInfo {
     stride: number;
     vertexBuffer: Buffer;
     vertexBindingInfos: Record<number, number>;
+    restoreInfo: BufferDataRestoreInfo;
     constructor(data: TypedArray, interleaved: boolean, stride: number);
 }
 /**

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

@@ -0,0 +1,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>;
+    private _createCamera;
+    private _createRenderer;
+    private _createAnimator;
+}

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

@@ -0,0 +1,6 @@
+import { GLTFParserContext } from ".";
+import { GLTFParser } from "./GLTFParser";
+export declare class GLTFSkinParser extends GLTFParser {
+    parse(context: GLTFParserContext): void;
+    private _findSkeletonRootBone;
+}

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

@@ -0,0 +1,8 @@
+import { AssetPromise, Texture2D } from "@galacean/engine-core";
+import { GLTFParser } from "./GLTFParser";
+import { GLTFParserContext } from ".";
+export declare class GLTFTextureParser extends GLTFParser {
+    private static _wrapMap;
+    parse(context: GLTFParserContext): AssetPromise<Texture2D[]>;
+    private _parseSampler;
+}

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

@@ -0,0 +1,6 @@
+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>;
+}

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

@@ -0,0 +1,11 @@
+export { GLTFAnimationParser } from "./GLTFAnimationParser";
+export { GLTFBufferParser } from "./GLTFBufferParser";
+export { GLTFEntityParser } from "./GLTFEntityParser";
+export { GLTFMaterialParser } from "./GLTFMaterialParser";
+export { GLTFMeshParser } from "./GLTFMeshParser";
+export { GLTFParser, registerGLTFExtension } from "./GLTFParser";
+export { GLTFSceneParser } from "./GLTFSceneParser";
+export { GLTFSkinParser } from "./GLTFSkinParser";
+export { GLTFTextureParser } from "./GLTFTextureParser";
+export { GLTFValidator } from "./GLTFValidator";
+export { GLTFParserContext } from "./GLTFParserContext";

package/types/index.d.ts

@@ -2,7 +2,6 @@ import "./AnimatorControllerLoader";
 import "./BufferLoader";
 import "./EnvLoader";
 import "./FontLoader";
-import "./gltf/extensions/index";
 import "./GLTFLoader";
 import "./HDRLoader";
 import "./JSONLoader";
@@ -15,9 +14,10 @@ import "./SpriteAtlasLoader";
 import "./SpriteLoader";
 import "./Texture2DLoader";
 import "./TextureCubeLoader";
+import "./AnimationClipLoader";
 export { parseSingleKTX } from "./compressed-texture";
-export { GLTFResource } from "./gltf/GLTFResource";
 export type { GLTFParams } from "./GLTFLoader";
 export * from "./resource-deserialize";
 export * from "./SceneLoader";
 export type { Texture2DParams } from "./Texture2DLoader";
+export * from "./gltf";