@galacean/engine-core 1.0.0-beta.0 → 1.0.0-beta.1

package/package.json

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

package/types/2d/atlas/SpriteAtlas.d.ts

@@ -29,4 +29,5 @@ export declare class SpriteAtlas extends ReferResource {
      * @param engine - Engine to which the SpriteAtlas belongs
      */
     constructor(engine: Engine);
+    protected _onDestroy(): void;
 }

package/types/2d/data/RenderData2D.d.ts

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

package/types/2d/sprite/Sprite.d.ts

@@ -1,6 +1,6 @@
 import { Rect, Vector2, Vector4 } from "@galacean/engine-math";
-import { ReferResource } from "../../asset/ReferResource";
 import { Engine } from "../../Engine";
+import { ReferResource } from "../../asset/ReferResource";
 import { Texture2D } from "../../texture/Texture2D";
 /**
  * 2D sprite.
@@ -86,6 +86,7 @@ export declare class Sprite extends ReferResource {
      * @returns Cloned sprite
      */
     clone(): Sprite;
+    protected _onDestroy(): void;
     private _calDefaultSize;
     private _updatePositions;
     private _updateUVs;

package/types/2d/sprite/SpriteMask.d.ts

@@ -1,7 +1,7 @@
 import { BoundingBox } from "@galacean/engine-math";
-import { ICustomClone } from "../../clone/ComponentCloner";
-import { Renderer } from "../../Renderer";
 import { RenderContext } from "../../RenderPipeline/RenderContext";
+import { Renderer } from "../../Renderer";
+import { ICustomClone } from "../../clone/ComponentCloner";
 import { Sprite } from "./Sprite";
 /**
  * A component for masking Sprites.
@@ -45,17 +45,12 @@ export declare class SpriteMask extends Renderer implements ICustomClone {
      */
     get alphaCutoff(): number;
     set alphaCutoff(value: number);
-    /**
-     * @override
-     */
     protected _updateBounds(worldBounds: BoundingBox): void;
     /**
-     * @override
      * @inheritdoc
      */
     protected _render(context: RenderContext): void;
     /**
-     * @override
      * @inheritdoc
      */
     protected _onDestroy(): void;

package/types/2d/sprite/SpriteRenderer.d.ts

@@ -1,7 +1,7 @@
 import { BoundingBox, Color } from "@galacean/engine-math";
-import { ICustomClone } from "../../clone/ComponentCloner";
-import { Renderer } from "../../Renderer";
 import { RenderContext } from "../../RenderPipeline/RenderContext";
+import { Renderer } from "../../Renderer";
+import { ICustomClone } from "../../clone/ComponentCloner";
 import { SpriteDrawMode } from "../enums/SpriteDrawMode";
 import { SpriteMaskInteraction } from "../enums/SpriteMaskInteraction";
 import { SpriteTileMode } from "../enums/SpriteTileMode";
@@ -77,17 +77,8 @@ export declare class SpriteRenderer extends Renderer implements ICustomClone {
      */
     get maskInteraction(): SpriteMaskInteraction;
     set maskInteraction(value: SpriteMaskInteraction);
-    /**
-     * @override
-     */
     protected _updateShaderData(context: RenderContext): void;
-    /**
-     * @override
-     */
     protected _updateBounds(worldBounds: BoundingBox): void;
-    /**
-     * @override
-     */
     protected _render(context: RenderContext): void;
     private _updateStencilState;
     private _onSpriteChange;

package/types/2d/text/Font.d.ts

@@ -18,4 +18,5 @@ export declare class Font extends ReferResource {
      */
     get name(): string;
     constructor(engine: Engine, name?: string);
+    protected _onDestroy(): void;
 }

package/types/2d/text/TextRenderer.d.ts

@@ -1,9 +1,9 @@
 import { BoundingBox, Color } from "@galacean/engine-math";
-import { ICustomClone } from "../../clone/ComponentCloner";
 import { Entity } from "../../Entity";
-import { Renderer } from "../../Renderer";
 import { RenderContext } from "../../RenderPipeline/RenderContext";
+import { Renderer } from "../../Renderer";
 import { TransformModifyFlags } from "../../Transform";
+import { ICustomClone } from "../../clone/ComponentCloner";
 import { FontStyle } from "../enums/FontStyle";
 import { SpriteMaskInteraction } from "../enums/SpriteMaskInteraction";
 import { TextHorizontalAlignment, TextVerticalAlignment } from "../enums/TextAlignment";
@@ -107,17 +107,9 @@ export declare class TextRenderer extends Renderer implements ICustomClone {
      */
     get bounds(): BoundingBox;
     constructor(entity: Entity);
-    /**
-     * @override
-     */
+    protected _onDestroy(): void;
     protected _updateShaderData(context: RenderContext): void;
-    /**
-     * @override
-     */
     protected _updateBounds(worldBounds: BoundingBox): void;
-    /**
-     * @override
-     */
     protected _render(context: RenderContext): void;
     private _updateStencilState;
     private _resetSubFont;

package/types/Camera.d.ts

@@ -204,17 +204,14 @@ export declare class Camera extends Component {
      */
     resetReplacementShader(): void;
     /**
-     * @override
      * @inheritdoc
      */
     _onEnable(): void;
     /**
-     * @override
      * @inheritdoc
      */
     _onDisable(): void;
     /**
-     * @override
      * @inheritdoc
      */
     protected _onDestroy(): void;

package/types/Component.d.ts

@@ -21,4 +21,5 @@ export declare class Component extends EngineObject {
      */
     get scene(): Scene;
     constructor(entity: Entity);
+    protected _onDestroy(): void;
 }

package/types/Entity.d.ts

@@ -1,10 +1,10 @@
 import { Matrix } from "@galacean/engine-math";
-import { EngineObject } from "./base";
 import { Component } from "./Component";
 import { Engine } from "./Engine";
 import { Layer } from "./Layer";
 import { Scene } from "./Scene";
 import { Transform } from "./Transform";
+import { EngineObject } from "./base";
 /**
  * Entity, be used as components container.
  */

package/types/RenderPipeline/MeshRenderElement.d.ts

@@ -0,0 +1,17 @@
+import { Mesh } from "../graphic/Mesh";
+import { SubMesh } from "../graphic/SubMesh";
+import { Material } from "../material/Material";
+import { Renderer } from "../Renderer";
+import { ShaderPass } from "../shader/ShaderPass";
+import { RenderState } from "../shader/state/RenderState";
+import { RenderElement } from "./RenderElement";
+/**
+ * Render element.
+ */
+export declare class MeshRenderElement extends RenderElement {
+    /** Mesh. */
+    mesh: Mesh;
+    /** Sub mesh. */
+    subMesh: SubMesh;
+    setValue(component: Renderer, mesh: Mesh, subMesh: SubMesh, material: Material, renderState: RenderState, shaderPass: ShaderPass): void;
+}

package/types/RenderPipeline/SpriteElement.d.ts

@@ -0,0 +1,13 @@
+import { RenderData2D } from "../2d/data/RenderData2D";
+import { Material } from "../material/Material";
+import { Renderer } from "../Renderer";
+import { ShaderPass } from "../shader";
+import { RenderState } from "../shader/state/RenderState";
+import { Texture2D } from "../texture";
+import { RenderElement } from "./RenderElement";
+export declare class SpriteElement extends RenderElement {
+    renderData: RenderData2D;
+    texture: Texture2D;
+    constructor();
+    setValue(component: Renderer, renderDate: RenderData2D, material: Material, texture: Texture2D, renderState: RenderState, shaderPass: ShaderPass): void;
+}

package/types/RenderPipeline/SpriteMaskElement.d.ts

@@ -0,0 +1,10 @@
+import { RenderData2D } from "../2d/data/RenderData2D";
+import { Material } from "../material/Material";
+import { Renderer } from "../Renderer";
+import { RenderElement } from "./RenderElement";
+export declare class SpriteMaskElement extends RenderElement {
+    renderData: RenderData2D;
+    isAdd: boolean;
+    constructor();
+    setValue(component: Renderer, renderData: RenderData2D, material: Material): void;
+}

package/types/RenderPipeline/TextRenderElement.d.ts

@@ -0,0 +1,6 @@
+import { RenderElement } from "./RenderElement";
+import { SpriteElement } from "./SpriteElement";
+export declare class TextRenderElement extends RenderElement {
+    charElements: SpriteElement[];
+    constructor();
+}

package/types/Renderer.d.ts

@@ -2,8 +2,8 @@ import { BoundingBox, Matrix, Vector4 } from "@galacean/engine-math";
 import { Component } from "./Component";
 import { RenderContext } from "./RenderPipeline/RenderContext";
 import { TransformModifyFlags } from "./Transform";
-import { ShaderData } from "./shader/ShaderData";
 import { Material } from "./material";
+import { ShaderData } from "./shader/ShaderData";
 /**
  * Basis for all renderers.
  * @decorator `@dependentComponents(Transform, DependentMode.CheckOnly)`

package/types/Scene.d.ts

@@ -1,8 +1,8 @@
 import { Color, Vector3 } from "@galacean/engine-math";
 import { Background } from "./Background";
-import { EngineObject } from "./base";
 import { Engine } from "./Engine";
 import { Entity } from "./Entity";
+import { EngineObject } from "./base";
 import { FogMode } from "./enums/FogMode";
 import { AmbientLight } from "./lighting/AmbientLight";
 import { ShaderData } from "./shader/ShaderData";

package/types/Script.d.ts

@@ -118,4 +118,5 @@ export declare class Script extends Component {
      * Called at the end of the destroyed frame.
      */
     onDestroy(): void;
+    protected _onDestroy(): void;
 }

package/types/animation/animationCurve/AnimationFloatArrayCurve.d.ts

@@ -6,7 +6,6 @@ import { AnimationCurve } from "./AnimationCurve";
 export declare class AnimationFloatArrayCurve extends AnimationCurve<Float32Array> {
     /**
      * @inheritdoc
-     * @override
      */
     addKey(key: Keyframe<Float32Array>): void;
 }

package/types/asset/GraphicsResource.d.ts

@@ -2,8 +2,5 @@ import { Engine } from "../Engine";
 import { ReferResource } from "./ReferResource";
 export declare abstract class GraphicsResource extends ReferResource {
     protected constructor(engine: Engine);
-    /**
-     * @override
-     */
     protected _onDestroy(): void;
 }

package/types/asset/IRefObject.d.ts

@@ -0,0 +1,2 @@
+export interface IRefObject {
+}

package/types/asset/RefObject.d.ts

@@ -0,0 +1,27 @@
+import { EngineObject } from "../base/EngineObject";
+import { Engine } from "../Engine";
+import { IRefObject } from "./IRefObject";
+/**
+ * The base class of assets, with reference counting capability.
+ */
+export declare abstract class RefObject extends EngineObject implements IRefObject {
+    /** Whether to ignore the garbage collection check, if it is true, it will not be affected by ResourceManager.gc(). */
+    isGCIgnored: boolean;
+    private _refCount;
+    /**
+     * Counted by valid references.
+     */
+    get refCount(): number;
+    protected constructor(engine: Engine);
+    /**
+     * Destroy self.
+     * @param force - Whether to force the destruction, if it is false, refCount = 0 can be released successfully.
+     * @returns Whether the release was successful.
+     */
+    destroy(force?: boolean): boolean;
+    /**
+     * Called when the resource is destroyed.
+     * Subclasses can override this function.
+     */
+    protected abstract _onDestroy(): void;
+}

package/types/asset/ReferResource.d.ts

@@ -14,14 +14,10 @@ export declare abstract class ReferResource extends EngineObject implements IRef
     get refCount(): number;
     protected constructor(engine: Engine);
     /**
-     * @override
      * Destroy self.
      * @param force - Whether to force the destruction, if it is false, refCount = 0 can be released successfully.
      * @returns Whether the release was successful.
      */
     destroy(force?: boolean): boolean;
-    /**
-     * @override
-     */
     protected _onDestroy(): void;
 }

package/types/base/Event.d.ts

@@ -0,0 +1,24 @@
+import { EventDispatcher } from "./EventDispatcher";
+export type Listener = ((e: Event) => any) & {
+    once?: boolean;
+};
+/** Event Object. * @class */
+export declare class Event {
+    get propagationStopped(): boolean;
+    get target(): EventDispatcher;
+    set target(t: EventDispatcher);
+    get timeStamp(): number;
+    get currentTarget(): EventDispatcher;
+    set currentTarget(t: EventDispatcher);
+    get bubbles(): boolean;
+    get type(): string | number;
+    data: any;
+    private _timeStamp;
+    private _target;
+    private _currentTarget;
+    private _bubbles;
+    private _propagationStopped;
+    private _type;
+    constructor(type: string | number, target?: EventDispatcher, data?: any, bubbles?: boolean);
+    stopPropagation(): void;
+}

package/types/base/Util.d.ts

@@ -0,0 +1,14 @@
+export declare const Util: {
+    isArray: (value: any) => boolean;
+    isArrayLike(x: any): boolean;
+    clone<T>(obj: T): T;
+    downloadBlob(blob: Blob, fileName?: string): void;
+};
+export declare const isArrayLike: <T>(x: any) => x is ArrayLike<T>;
+/**
+ * Fastly remove an element from array.
+ * @param array - Array
+ * @param item - Element
+ */
+export declare function removeFromArray(array: any[], item: any): boolean;
+export declare function ObjectValues(obj: any): any[];

package/types/env-probe/CubeProbe.d.ts

@@ -9,15 +9,9 @@ export declare class CubeProbe extends Probe {
      * The position of the probe can be set, the default is the origin [0,0,0].
      */
     position: Vector3;
-    /**
-     * @override
-     */
     protected readonly _isCube: boolean;
     private oriViewMatrix;
     private _oriFieldOfView;
-    /**
-     * @override
-     */
     onBeginRender(camera: Camera): void;
     /**
      * Store original camera parameters.

package/types/env-probe/Probe.d.ts

@@ -46,13 +46,7 @@ export declare abstract class Probe extends Script {
      * @remarks Prevent issue: Feedback Loops Between Textures and the Framebuffer.
      */
     onTextureChange(renderColorTexture: Texture): void;
-    /**
-     * @override
-     */
     onBeginRender(camera: Camera): void;
-    /**
-     * @override
-     */
     onEndRender(camera: Camera): void;
     protected _reset(): void;
 }

package/types/graphic/Buffer.d.ts

@@ -90,10 +90,8 @@ export declare class Buffer extends GraphicsResource {
      * @param dataLength - Output data length
      */
     getData(data: ArrayBufferView, bufferByteOffset: number, dataOffset: number, dataLength: number): void;
-    /**
-     * @override
-     */
     _rebuild(): void;
+    protected _onDestroy(): void;
     /**
      * @deprecated
      */

package/types/graphic/Mesh.d.ts

@@ -55,13 +55,7 @@ export declare abstract class Mesh extends GraphicsResource {
      * Clear all sub-mesh.
      */
     clearSubMesh(): void;
-    /**
-     * @override
-     */
     _addReferCount(value: number): void;
-    /**
-     * @override
-     */
     _rebuild(): void;
     protected _setVertexElements(elements: VertexElement[]): void;
     protected _setIndexBufferBinding(binding: IndexBufferBinding | null): void;

package/types/material/BaseMaterial.d.ts

@@ -75,12 +75,10 @@ export declare class BaseMaterial extends Material {
      */
     setRenderFace(passIndex: number, renderFace: RenderFace): void;
     /**
-     * @override
      * Clone and return the instance.
      */
     clone(): BaseMaterial;
     /**
-     * @override
      * Clone to the target material.
      * @param target - target material
      */

package/types/material/BlinnPhongMaterial.d.ts

@@ -64,8 +64,5 @@ export declare class BlinnPhongMaterial extends BaseMaterial {
      * @param engine - Engine to which the material belongs
      */
     constructor(engine: Engine);
-    /**
-     * @override
-     */
     clone(): BlinnPhongMaterial;
 }

package/types/material/Material.d.ts

@@ -1,6 +1,6 @@
 import { IClone } from "@galacean/engine-design";
-import { ReferResource } from "../asset/ReferResource";
 import { Engine } from "../Engine";
+import { ReferResource } from "../asset/ReferResource";
 import { Shader } from "../shader/Shader";
 import { ShaderData } from "../shader/ShaderData";
 import { RenderState } from "../shader/state/RenderState";
@@ -40,8 +40,5 @@ export declare class Material extends ReferResource implements IClone {
      * @param target - target material
      */
     cloneTo(target: Material): void;
-    /**
-     * @override
-     */
     _addReferCount(value: number): void;
 }

package/types/material/PBRMaterial.d.ts

@@ -30,7 +30,7 @@ export declare class PBRMaterial extends PBRBaseMaterial {
      */
     constructor(engine: Engine);
     /**
-     * @override
+     * @inheritdoc
      */
     clone(): PBRMaterial;
 }

package/types/material/PBRSpecularMaterial.d.ts

@@ -32,7 +32,7 @@ export declare class PBRSpecularMaterial extends PBRBaseMaterial {
      */
     constructor(engine: Engine);
     /**
-     * @override
+     * @inheritdoc
      */
     clone(): PBRSpecularMaterial;
 }

package/types/material/UnlitMaterial.d.ts

@@ -27,7 +27,7 @@ export declare class UnlitMaterial extends BaseMaterial {
      */
     constructor(engine: Engine);
     /**
-     * @override
+     * @inheritdoc
      */
     clone(): UnlitMaterial;
 }

package/types/mesh/MeshRenderer.d.ts

@@ -1,8 +1,8 @@
 import { BoundingBox } from "@galacean/engine-math";
+import { RenderContext } from "../RenderPipeline/RenderContext";
+import { Renderer } from "../Renderer";
 import { ICustomClone } from "../clone/ComponentCloner";
 import { Mesh } from "../graphic/Mesh";
-import { Renderer } from "../Renderer";
-import { RenderContext } from "../RenderPipeline/RenderContext";
 /**
  * MeshRenderer Component.
  */
@@ -17,13 +17,8 @@ export declare class MeshRenderer extends Renderer implements ICustomClone {
      */
     get mesh(): Mesh;
     set mesh(value: Mesh);
-    /**
-     * @override
-     */
+    protected _onDestroy(): void;
     protected _updateBounds(worldBounds: BoundingBox): void;
-    /**
-     * @override
-     */
     protected _render(context: RenderContext): void;
     private _setMesh;
     private _onMeshChanged;

package/types/mesh/ModelMesh.d.ts

@@ -216,6 +216,7 @@ export declare class ModelMesh extends Mesh {
      * @remark based on http://foundationsofgameenginedev.com/FGED2-sample.pdf
      */
     calculateTangents(): void;
+    protected _onDestroy(): void;
     private _supplementaryVertexElements;
     private _updateVertexElements;
     private _updateVertices;

package/types/mesh/SkinnedMeshRenderer.d.ts

@@ -41,17 +41,8 @@ export declare class SkinnedMeshRenderer extends MeshRenderer {
      */
     get rootBone(): Entity;
     set rootBone(value: Entity);
-    /**
-     * @override
-     */
     protected _updateShaderData(context: RenderContext): void;
-    /**
-     * @override
-     */
     protected _registerEntityTransformListener(): void;
-    /**
-     * @override
-     */
     protected _updateBounds(worldBounds: BoundingBox): void;
     private _initSkin;
     private _computeApproximateBindMatrix;

package/types/physics/CharacterController.d.ts

@@ -41,12 +41,10 @@ export declare class CharacterController extends Collider {
     /**
      * Add collider shape on this controller.
      * @param shape - Collider shape
-     * @override
      */
     addShape(shape: ColliderShape): void;
     /**
      * Remove all shape attached.
-     * @override
      */
     clearShapes(): void;
     private _setUpDirection;

package/types/physics/Collider.d.ts

@@ -26,4 +26,5 @@ export declare class Collider extends Component {
      * Remove all shape attached.
      */
     clearShapes(): void;
+    protected _onDestroy(): void;
 }

package/types/physics/joint/HingeJoint.d.ts

@@ -1,7 +1,7 @@
-import { Joint } from "./Joint";
 import { Vector3 } from "@galacean/engine-math";
-import { JointMotor } from "./JointMotor";
+import { Joint } from "./Joint";
 import { JointLimits } from "./JointLimits";
+import { JointMotor } from "./JointMotor";
 /**
  * A joint which behaves in a similar way to a hinge or axle.
  */

package/types/physics/joint/SpringJoint.d.ts

@@ -1,5 +1,5 @@
-import { Joint } from "./Joint";
 import { Vector3 } from "@galacean/engine-math";
+import { Joint } from "./Joint";
 /**
  * A joint that maintains an upper or lower bound (or both) on the distance between two points on different objects.
  */

package/types/sky/SkyBoxMaterial.d.ts

@@ -39,8 +39,5 @@ export declare class SkyBoxMaterial extends Material {
     get tintColor(): Color;
     set tintColor(value: Color);
     constructor(engine: Engine);
-    /**
-     * @override
-     */
     clone(): SkyBoxMaterial;
 }

package/types/sky/SkyProceduralMaterial.d.ts

@@ -66,7 +66,7 @@ export declare class SkyProceduralMaterial extends Material {
      */
     constructor(engine: Engine);
     /**
-     * @override
+     * @inheritDoc
      */
     clone(): SkyProceduralMaterial;
 }

package/types/texture/RenderTarget.d.ts

@@ -88,8 +88,5 @@ export declare class RenderTarget extends GraphicsResource {
      * Generate the mipmap of each attachment texture of the renderTarget according to the configuration.
      */
     generateMipmaps(): void;
-    /**
-     * @override
-     */
     protected _onDestroy(): void;
 }

package/types/texture/Texture.d.ts

@@ -64,6 +64,7 @@ export declare abstract class Texture extends GraphicsResource {
      * Generate multi-level textures based on the 0th level data.
      */
     generateMipmaps(): void;
+    protected _onDestroy(): void;
     /**
      * Get the maximum mip level of the corresponding size:rounding down.
      * @remarks http://download.nvidia.com/developer/Papers/2005/NP2_Mipmapping/NP2_Mipmap_Creation.pdf

package/types/texture/Texture2DArray.d.ts

@@ -78,8 +78,4 @@ export declare class Texture2DArray extends Texture {
      * @param out - Color buffer
      */
     getPixelBuffer(elementIndex: number, x: number, y: number, width: number, height: number, mipLevel: number, out: ArrayBufferView): void;
-    /**
-     * @override
-     */
-    _rebuild(): void;
 }