@galacean/effects-core 2.0.0-alpha.11 → 2.0.0-alpha.13

package/dist/plugins/timeline/track.d.ts

@@ -0,0 +1,73 @@
+import { ItemEndBehavior } from '@galacean/effects-specification';
+import type { Engine } from '../../engine';
+import { VFXItem } from '../../vfx-item';
+import type { PlayableGraph } from '../cal/playable-graph';
+import { Playable, PlayableAsset, PlayableOutput } from '../cal/playable-graph';
+/**
+ * @since 2.0.0
+ * @internal
+ */
+export declare class TrackAsset extends PlayableAsset {
+    id: string;
+    name: string;
+    binding: VFXItem;
+    trackType: TrackType;
+    private clipSeed;
+    private clips;
+    protected children: TrackAsset[];
+    initializeBinding(parentBinding: object): void;
+    /**
+     * @internal
+     */
+    initializeBindingRecursive(parentBinding: object): void;
+    createOutput(): PlayableOutput;
+    createPlayableGraph(graph: PlayableGraph, runtimeClips: RuntimeClip[]): Playable;
+    createMixerPlayableGraph(graph: PlayableGraph, runtimeClips: RuntimeClip[]): Playable;
+    compileClips(graph: PlayableGraph, timelineClips: TimelineClip[], runtimeClips: RuntimeClip[]): Playable;
+    /**
+     * 重写该方法以创建自定义混合器
+     */
+    createTrackMixer(graph: PlayableGraph): Playable;
+    createPlayable(graph: PlayableGraph): Playable;
+    getChildTracks(): TrackAsset[];
+    createClip<T extends PlayableAsset>(classConstructor: new (engine: Engine) => T, name?: string): TimelineClip;
+    getClips(): TimelineClip[];
+    findClip(name: string): TimelineClip | undefined;
+    addClip(clip: TimelineClip): void;
+    private createClipPlayable;
+}
+export declare enum TrackType {
+    MasterTrack = 0,
+    ObjectTrack = 1
+}
+/**
+ * @since 2.0.0
+ * @internal
+ */
+export declare class TimelineClip {
+    id: string;
+    name: string;
+    start: number;
+    duration: number;
+    asset: PlayableAsset;
+    endBehaviour: ItemEndBehavior;
+    constructor();
+    toLocalTime(time: number): number;
+}
+export declare class RuntimeClip {
+    clip: TimelineClip;
+    playable: Playable;
+    parentMixer: Playable;
+    track: TrackAsset;
+    constructor(clip: TimelineClip, clipPlayable: Playable, parentMixer: Playable, track: TrackAsset);
+    set enable(value: boolean);
+    evaluateAt(localTime: number): void;
+    private onClipEnd;
+}
+/**
+ * @since 2.0.0
+ * @internal
+ */
+export interface TimelineClipData {
+    asset: PlayableAsset;
+}

package/dist/plugins/timeline/tracks/activation-track.d.ts

@@ -0,0 +1,5 @@
+import type { PlayableGraph, Playable } from '../../cal/playable-graph';
+import { TrackAsset } from '../track';
+export declare class ActivationTrack extends TrackAsset {
+    createTrackMixer(graph: PlayableGraph): Playable;
+}

package/dist/plugins/timeline/tracks/sprite-color-track.d.ts

@@ -0,0 +1,3 @@
+import { TrackAsset } from '../track';
+export declare class SpriteColorTrack extends TrackAsset {
+}

package/dist/plugins/timeline/tracks/transform-track.d.ts

@@ -0,0 +1,3 @@
+import { TrackAsset } from '../track';
+export declare class TransformTrack extends TrackAsset {
+}

package/dist/render/{frame-buffer.d.ts → framebuffer.d.ts}

@@ -1,9 +1,9 @@
 import type { Texture } from '../texture';
-import type { RenderBuffer } from './render-buffer';
+import type { Renderbuffer } from './renderbuffer';
 import type { RenderPassAttachmentStorageType, RenderPassDepthStencilAttachmentOptions } from './render-pass';
 import type { RenderPassDestroyAttachmentType, RenderPassStoreAction } from './render-pass';
 import type { Renderer } from './renderer';
-export interface FrameBufferProps {
+export interface FramebufferProps {
     attachments: Texture[];
     depthStencilAttachment?: RenderPassDepthStencilAttachmentOptions;
     isCustomViewport?: boolean;
@@ -23,7 +23,7 @@ export declare enum RenderTextureFormat {
 /**
  *
  */
-export declare class FrameBuffer {
+export declare class Framebuffer {
     depthStencilStorageType: RenderPassAttachmentStorageType;
     name: string;
     viewportScale: number;
@@ -32,17 +32,17 @@ export declare class FrameBuffer {
     externalStorage: boolean;
     storeAction: RenderPassStoreAction;
     isCustomViewport: boolean;
-    static create: (props: FrameBufferProps, renderer: Renderer) => FrameBuffer;
+    static create: (props: FramebufferProps, renderer: Renderer) => Framebuffer;
     resize(x: number, y: number, width: number, height: number): void;
     resetColorTextures(textures: Texture[]): void;
     unbind(): void;
     bind(): void;
-    get stencilStorage(): RenderBuffer | undefined;
-    get depthStorage(): RenderBuffer | undefined;
+    get stencilStorage(): Renderbuffer | undefined;
+    get depthStorage(): Renderbuffer | undefined;
     getDepthTexture(): Texture | undefined;
     getStencilTexture(): Texture | undefined;
     getColorTextures(): Texture[];
-    dispose(opt?: {
+    dispose(options?: {
         depthStencilAttachment?: RenderPassDestroyAttachmentType;
     }): void;
 }

package/dist/render/geometry.d.ts

@@ -24,6 +24,11 @@ export interface GeometryProps {
      */
     maxVertex?: number;
 }
+export interface SkinProps {
+    boneNames?: string[];
+    rootBoneName?: string;
+    inverseBindMatrices?: number[];
+}
 /**
  * Geometry 抽象类
  */
@@ -32,6 +37,10 @@ export declare abstract class Geometry extends EffectsObject {
      * Geometry 的名称
      */
     name: string;
+    /**
+     * 子网格数据
+     */
+    subMeshes: spec.SubMesh[];
     /**
      * Geometry 创建函数
      */
@@ -96,6 +105,10 @@ export declare abstract class Geometry extends EffectsObject {
      * 获取当前 Geometry 的 drawcount
      */
     abstract getDrawCount(): number;
+    /**
+     * 获取当前 Geometry 关联的蒙皮数据
+     */
+    abstract getSkinProps(): SkinProps;
     /**
      * 初始化 GPU 资源
      * @override
@@ -106,4 +119,4 @@ export declare abstract class Geometry extends EffectsObject {
      */
     flush(): void;
 }
-export declare function generateEmptyTypedArray(type: number): Float32Array | Int32Array | Int16Array;
+export declare function generateEmptyTypedArray(type: number): Float32Array | Int16Array | Int32Array;

package/dist/render/gpu-capability.d.ts

@@ -1,5 +1,5 @@
+import type { GLType } from '../gl';
 import type { Immutable } from '../utils';
-export type GLType = 'webgl' | 'webgl2';
 export interface GPUCapabilityDetail {
     floatTexture: number;
     halfFloatTexture: number;
@@ -42,8 +42,8 @@ export declare class GPUCapability {
     drawBuffers(gl: WebGLRenderingContext | WebGL2RenderingContext, bufferStates: boolean[]): void;
     setTextureAnisotropic(gl: WebGLRenderingContext | WebGL2RenderingContext, target: GLenum, level: number): void;
 }
-export declare const COMPRESSED_TEXTURE: {
-    NONE: number;
-    PVRTC: number;
-    ASTC: number;
-};
+export declare enum COMPRESSED_TEXTURE {
+    NONE = 0,
+    PVRTC = 1,
+    ASTC = 2
+}

package/dist/render/index.d.ts

@@ -1,13 +1,13 @@
 export * from './create-copy-shader';
 export * from './render-frame';
-export * from './render-buffer';
+export * from './renderbuffer';
 export * from './render-pass';
 export * from './shader';
 export * from './gpu-capability';
 export * from './mesh';
 export * from './types';
 export * from './geometry';
-export * from './frame-buffer';
+export * from './framebuffer';
 export * from './renderer';
 export * from './global-volume';
 export * from './semantic-map';

package/dist/render/render-frame.d.ts

@@ -69,11 +69,11 @@ export interface RenderPassInfo {
  */
 export interface RenderFrameResource {
     /**
-     * 纹理对象，用于 FrameBuffer 的颜色 Attachment
+     * 纹理对象，用于 Framebuffer 的颜色 Attachment
      */
     color_a: Texture;
     /**
-     * 纹理对象，用于 FrameBuffer 的颜色 Attachment
+     * 纹理对象，用于 Framebuffer 的颜色 Attachment
      */
     color_b: Texture;
     /**
@@ -210,7 +210,7 @@ export declare class RenderFrame implements Disposable {
      */
     dispose(options?: RenderFrameDestroyOptions): void;
     /**
-     * 重置 RenderPass ColorAttachment，解决 FrameBuffer 即读又写的问题
+     * 重置 RenderPass ColorAttachment，解决 Framebuffer 即读又写的问题
      * @param renderPasses - RenderPass 对象数组
      * @param startIndex - 开始重置的索引
      */
@@ -239,7 +239,7 @@ export declare class RenderFrame implements Disposable {
     createResource(): void;
     /**
      * 创建拷贝 RenderPass 用到的 Mesh 对象
-     * @param semantics - RenderPass 渲染时 FrameBuffer 的颜色和深度纹理、大小和是否混合
+     * @param semantics - RenderPass 渲染时 Framebuffer 的颜色和深度纹理、大小和是否混合
      */
     createCopyMesh(semantics?: {
         tex?: string;

package/dist/render/render-pass.d.ts

@@ -4,14 +4,14 @@ import type { Camera } from '../camera';
 import type { RendererComponent } from '../components';
 import type { Engine } from '../engine';
 import type { MeshDestroyOptions, Renderer } from '../render';
-import { FrameBuffer } from '../render';
+import { Framebuffer } from '../render';
 import type { SemanticGetter } from './semantic-map';
 import { SemanticMap } from './semantic-map';
 import type { TextureConfigOptions, TextureLoadAction } from '../texture';
 import { Texture } from '../texture';
 import type { Disposable, Sortable } from '../utils';
 import { DestroyOptions, OrderType } from '../utils';
-import type { RenderBuffer } from './render-buffer';
+import type { Renderbuffer } from './renderbuffer';
 import type { RenderingData } from './render-frame';
 export declare const RenderPassPriorityPrepare = 0;
 export declare const RenderPassPriorityNormal = 1000;
@@ -76,9 +76,9 @@ export interface RenderPassColorAttachmentOptions {
     /**
      * ColorAttachment 的 Buffer 参数
      */
-    buffer?: RenderBuffer;
+    buffer?: Renderbuffer;
     /**
-     * WebGL2 下 RenderBuffer 超采数目。默认是0，即不启用超采。
+     * WebGL2 下 Renderbuffer 超采数目。默认是0，即不启用超采。
      * @default 0
      */
     multiSample?: number;
@@ -102,12 +102,12 @@ export declare class RenderTargetHandle implements Disposable {
 }
 export interface RenderPassDepthStencilAttachment {
     readonly storageType: RenderPassAttachmentStorageType;
-    readonly storage?: RenderBuffer;
+    readonly storage?: Renderbuffer;
     readonly texture?: Texture;
 }
 export interface RenderPassDepthStencilAttachmentOptions {
     storageType: RenderPassAttachmentStorageType;
-    storage?: RenderBuffer;
+    storage?: Renderbuffer;
     texture?: Texture;
 }
 /**
@@ -209,7 +209,7 @@ export declare class RenderPass implements Disposable, Sortable {
      * ColorAttachment 数组
      */
     attachments: RenderTargetHandle[];
-    frameBuffer?: FrameBuffer;
+    framebuffer: Framebuffer | null;
     /**
      * 名称
      */
@@ -227,7 +227,7 @@ export declare class RenderPass implements Disposable, Sortable {
      */
     readonly camera?: Camera;
     /**
-     * 深度和蒙版 Attachment 类型，注意区分纹理和 RenderBuffer
+     * 深度和蒙版 Attachment 类型，注意区分纹理和 Renderbuffer
      */
     readonly depthStencilType: RenderPassAttachmentStorageType;
     /**

package/dist/render/{render-buffer.d.ts → renderbuffer.d.ts}

@@ -1,19 +1,19 @@
 import type { Disposable } from '../utils';
 import type { RenderPassAttachmentStorageType } from './render-pass';
-export interface RenderBufferProps {
+export interface RenderbufferProps {
     storageType: RenderPassAttachmentStorageType;
     format: GLenum;
     attachment: GLenum;
 }
-export declare abstract class RenderBuffer implements Disposable {
+export declare abstract class Renderbuffer implements Disposable {
     readonly size: [x: number, y: number];
     readonly multiSample = 1;
     readonly storageType: RenderPassAttachmentStorageType;
     readonly format: GLenum;
     readonly attachment: GLenum;
     protected destroyed: boolean;
-    static create: (props: RenderBufferProps) => RenderBuffer;
-    constructor(props: RenderBufferProps);
+    static create: (props: RenderbufferProps) => Renderbuffer;
+    constructor(props: RenderbufferProps);
     get isDestroyed(): boolean;
     abstract setSize(width: number, height: number): void;
     abstract dispose(): void;

package/dist/render/renderer.d.ts

@@ -3,13 +3,14 @@ import type { RendererComponent } from '../components/renderer-component';
 import type { Engine } from '../engine';
 import type { Material } from '../material';
 import type { LostHandler, RestoreHandler } from '../utils';
-import type { FilterMode, FrameBuffer, RenderTextureFormat } from './frame-buffer';
+import type { FilterMode, Framebuffer, RenderTextureFormat } from './framebuffer';
 import type { Geometry } from './geometry';
 import type { RenderFrame, RenderingData } from './render-frame';
 import type { RenderPassClearAction, RenderPassStoreAction } from './render-pass';
 import type { ShaderLibrary } from './shader';
+import type { GLType } from '../gl';
 export declare class Renderer implements LostHandler, RestoreHandler {
-    static create: (canvas: HTMLCanvasElement | OffscreenCanvas, framework: 'webgl' | 'webgl2', renderOptions?: WebGLContextAttributes) => Renderer;
+    static create: (canvas: HTMLCanvasElement | OffscreenCanvas, framework: GLType, renderOptions?: WebGLContextAttributes) => Renderer;
     engine: Engine;
     env: string;
     /**
@@ -20,8 +21,8 @@ export declare class Renderer implements LostHandler, RestoreHandler {
     setGlobalFloat(name: string, value: number): void;
     setGlobalInt(name: string, value: number): void;
     setGlobalMatrix(name: string, value: Matrix4): void;
-    getFrameBuffer(): FrameBuffer | null;
-    setFrameBuffer(frameBuffer: FrameBuffer | null): void;
+    getFramebuffer(): Framebuffer | null;
+    setFramebuffer(framebuffer: Framebuffer | null): void;
     setViewport(x: number, y: number, width: number, height: number): void;
     resize(canvasWidth: number, canvasHeight: number): void;
     clear(action: RenderPassClearAction | RenderPassStoreAction): void;
@@ -56,7 +57,7 @@ export declare class Renderer implements LostHandler, RestoreHandler {
     getShaderLibrary(): ShaderLibrary | undefined;
     renderRenderFrame(renderFrame: RenderFrame): void;
     renderMeshes(meshes: RendererComponent[]): void;
-    drawGeometry(geometry: Geometry, material: Material): void;
-    getTemporaryRT(name: string, width: number, height: number, depthBuffer: number, filter: FilterMode, format: RenderTextureFormat): FrameBuffer | null;
+    drawGeometry(geometry: Geometry, material: Material, subMeshIndex?: number): void;
+    getTemporaryRT(name: string, width: number, height: number, depthBuffer: number, filter: FilterMode, format: RenderTextureFormat): Framebuffer | null;
     dispose(haltGL?: boolean): void;
 }

package/dist/render/semantic-map.d.ts

@@ -8,7 +8,7 @@ export declare class SemanticMap implements Disposable {
     constructor(semantics?: Record<string, SemanticGetter>);
     toObject(): Record<string, SemanticGetter>;
     setSemantic(name: string, value?: SemanticGetter): void;
-    getSemanticValue(name: string, state: RenderingData): number | Float32Array | Int32Array | Float64Array | Uint8Array | Uint32Array | Uint16Array | Int8Array | Int16Array | number[] | number[][] | import("@galacean/effects-core").Texture | import("@galacean/effects-math/es/core").Vector2 | import("@galacean/effects-math/es/core").Vector3 | import("@galacean/effects-math/es/core").Vector4 | import("@galacean/effects-math/es/core").Matrix3 | import("@galacean/effects-math/es/core").Matrix4 | import("@galacean/effects-core").Texture[] | import("packages/effects-core/src/material/types").UniformStruct | import("packages/effects-core/src/material/types").UniformStruct[] | SemanticFunc | undefined;
+    getSemanticValue(name: string, state: RenderingData): number | Float32Array | Float64Array | Uint8Array | Uint32Array | Uint16Array | Int8Array | Int16Array | Int32Array | number[] | number[][] | import("@galacean/effects-core").Texture | import("@galacean/effects-math/es/core").Vector2 | import("@galacean/effects-math/es/core").Vector3 | import("@galacean/effects-math/es/core").Vector4 | import("@galacean/effects-math/es/core").Matrix3 | import("@galacean/effects-math/es/core").Matrix4 | import("@galacean/effects-core").Texture[] | import("packages/effects-core/src/material/types").UniformStruct | import("packages/effects-core/src/material/types").UniformStruct[] | SemanticFunc | undefined;
     hasSemanticValue(name: string): boolean;
     dispose(): void;
 }

package/dist/texture/texture.d.ts

@@ -82,3 +82,5 @@ export declare abstract class Texture extends EffectsObject {
     protected assembleOptions(options: TextureSourceOptions): TextureSourceOptions;
 }
 export declare function generateHalfFloatTexture(engine: Engine, data: Uint16Array, width: number, height: number): Texture;
+export declare function generateWhiteTexture(engine: Engine): Texture;
+export declare function generateTransparentTexture(engine: Engine): Texture;

package/dist/texture/types.d.ts

@@ -148,7 +148,7 @@ export interface Texture2DSourceOptionsCompressed extends TextureOptionsBase {
     mipmaps: TextureDataType[];
     target?: WebGLRenderingContext['TEXTURE_2D'] | WebGLRenderingContext['TEXTURE_CUBE_MAP'];
 }
-export interface Texture2DSourceOptionsFrameBuffer extends TextureOptionsBase {
+export interface Texture2DSourceOptionsFramebuffer extends TextureOptionsBase {
     sourceType: TextureSourceType.framebuffer;
     data?: {
         width: number;
@@ -160,6 +160,6 @@ export interface Texture2DSourceOptionsNone extends TextureOptionsBase {
     sourceType?: TextureSourceType.none;
     target?: GLenum;
 }
-export type Texture2DSourceOptions = Texture2DSourceOptionsImage | Texture2DSourceOptionsData | Texture2DSourceOptionsVideo | Texture2DSourceOptionsImageMipmaps | Texture2DSourceOptionsCompressed | Texture2DSourceOptionsFrameBuffer | Texture2DSourceOptionsNone;
+export type Texture2DSourceOptions = Texture2DSourceOptionsImage | Texture2DSourceOptionsData | Texture2DSourceOptionsVideo | Texture2DSourceOptionsImageMipmaps | Texture2DSourceOptionsCompressed | Texture2DSourceOptionsFramebuffer | Texture2DSourceOptionsNone;
 export type TextureSourceOptions = Texture2DSourceOptions | TextureCubeSourceOptions;
 export {};

package/dist/ticker.d.ts

@@ -9,7 +9,7 @@ export declare class Ticker {
     private interval;
     private intervalId;
     private resetTickers;
-    private _deltaTime;
+    private dt;
     constructor(fps?: number);
     /**
      * 获取定时器当前帧更新的时间
@@ -22,7 +22,7 @@ export declare class Ticker {
     setFPS(fps: number): void;
     /**
      * 获取定时器暂停标志位
-     * @returns 暂停标志位
+     * @returns
      */
     getPaused(): boolean;
     /**

package/dist/utils/device.d.ts

@@ -2,3 +2,4 @@ export declare function getPixelRatio(): number;
 export declare function isIOS(): boolean;
 export declare function isAndroid(): boolean;
 export declare function isSimulatorCellPhone(): boolean;
+export declare function isAlipayMiniApp(): boolean;

package/dist/utils/index.d.ts

@@ -4,7 +4,7 @@ export * from './device';
 export * from './image-data';
 export * from './sortable';
 export * from './asserts';
-export * from './timeline-component';
+export * from './text';
 export * from './logger';
 export type Immutable<O> = O extends Record<any, any> ? {
     readonly [key in keyof O]: Immutable<O[key]>;

package/dist/utils/text.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 判断是否为可解析的字体
+ * - 首字母不能为数字或 `.`
+ * - 不能包含特殊字符，`_-` 是被允许的
+ * @param fontFamily - 字体名称
+ * @returns
+ */
+export declare function isValidFontFamily(fontFamily: string): boolean;

package/dist/vfx-item.d.ts

@@ -8,11 +8,10 @@ import type { Composition } from './composition';
 import { EffectsObject } from './effects-object';
 import type { Engine } from './engine';
 import type { BoundingBoxData, CameraController, HitTestBoxParams, HitTestCustomParams, HitTestSphereParams, HitTestTriangleParams, InteractComponent, ParticleSystem, SpriteComponent } from './plugins';
-import { TimelineComponent } from './plugins';
 import { Transform } from './transform';
 import { type Disposable } from './utils';
-export type VFXItemContent = ParticleSystem | SpriteComponent | TimelineComponent | CameraController | InteractComponent | void | {};
-export type VFXItemConstructor = new (enigne: Engine, props: VFXItemProps, composition: Composition) => VFXItem<VFXItemContent>;
+export type VFXItemContent = ParticleSystem | SpriteComponent | CameraController | InteractComponent | void | {};
+export type VFXItemConstructor = new (engine: Engine, props: VFXItemProps, composition: Composition) => VFXItem;
 export type VFXItemProps = spec.Item & {
     items: VFXItemProps[];
     startTime: number;
@@ -23,7 +22,7 @@ export type VFXItemProps = spec.Item & {
 /**
  * 所有元素的继承的抽象类
  */
-export declare class VFXItem<T extends VFXItemContent> extends EffectsObject implements Disposable {
+export declare class VFXItem extends EffectsObject implements Disposable {
     /**
      * 元素绑定的父元素，
      * 1. 当元素没有绑定任何父元素时，parent为空，transform.parentTransform 为 composition.transform
@@ -31,8 +30,8 @@ export declare class VFXItem<T extends VFXItemContent> extends EffectsObject imp
      * 3. 当元素绑定 TreeItem 的node时，parent为treeItem, transform.parentTransform 为 tree.nodes[i].transform(绑定的node节点上的transform)
      * 4. 当元素绑定 TreeItem 本身时，行为表现和绑定 nullItem 相同
      */
-    parent?: VFXItem<VFXItemContent>;
-    children: VFXItem<VFXItemContent>[];
+    parent?: VFXItem;
+    children: VFXItem[];
     /**
      * 元素的变换包含位置、旋转、缩放。
      */
@@ -45,10 +44,6 @@ export declare class VFXItem<T extends VFXItemContent> extends EffectsObject imp
      * 元素动画的持续时间
      */
     duration: number;
-    /**
-     * 元素当前更新归一化时间，开始时为 0，结束时为 1
-     */
-    lifetime: number;
     /**
      * 父元素的 id
      */
@@ -81,16 +76,9 @@ export declare class VFXItem<T extends VFXItemContent> extends EffectsObject imp
     /**
      * 元素创建的数据图层/粒子/模型等
      */
-    _content?: T;
-    /**
-     * 元素动画是否延迟播放
-     */
-    delaying: boolean;
-    /**
-     * 元素动画的速度
-     */
+    _content?: VFXItemContent;
+    reusable: boolean;
     type: spec.ItemType;
-    stopped: boolean;
     props: VFXItemProps;
     components: Component[];
     itemBehaviours: ItemBehaviour[];
@@ -101,31 +89,25 @@ export declare class VFXItem<T extends VFXItemContent> extends EffectsObject imp
      */
     protected visible: boolean;
     /**
-     * 是否允许渲染，元素生命周期开始后为 true，结束时为 false
-     * @protected
+     * 元素动画的速度
      */
-    protected _contentVisible: boolean;
     private speed;
-    static isComposition(item: VFXItem<VFXItemContent>): item is VFXItem<void>;
-    static isSprite(item: VFXItem<VFXItemContent>): item is VFXItem<SpriteComponent>;
-    static isParticle(item: VFXItem<VFXItemContent>): item is VFXItem<ParticleSystem>;
-    static isNull(item: VFXItem<VFXItemContent>): item is VFXItem<void>;
-    static isTree(item: VFXItem<VFXItemContent>): item is VFXItem<void>;
-    static isCamera(item: VFXItem<VFXItemContent>): item is VFXItem<void>;
-    static isExtraCamera(item: VFXItem<VFXItemContent>): item is VFXItem<CameraController>;
+    static isComposition(item: VFXItem): boolean;
+    static isSprite(item: VFXItem): boolean;
+    static isParticle(item: VFXItem): boolean;
+    static isNull(item: VFXItem): boolean;
+    static isTree(item: VFXItem): boolean;
+    static isCamera(item: VFXItem): boolean;
+    static isExtraCamera(item: VFXItem): boolean;
     constructor(engine: Engine, props?: VFXItemProps);
     /**
      * 返回元素创建的数据
      */
-    get content(): T;
+    get content(): VFXItemContent;
     /**
      * 播放完成后是否需要再使用，是的话生命周期结束后不会 dispose
      */
-    get reusable(): boolean;
-    /**
-     * 获取元素生命周期是否开始
-     */
-    get lifetimeStarted(): boolean;
+    get compositionReusable(): boolean;
     /**
      * 设置元素的动画速度
      * @param speed - 速度
@@ -146,18 +128,14 @@ export declare class VFXItem<T extends VFXItemContent> extends EffectsObject imp
      * @param classConstructor - 要获取的组件类型
      * @returns 查询结果中符合类型的第一个组件
      */
-    getComponent<T extends Component>(classConstructor: new (engine: Engine) => T): T | undefined;
+    getComponent<T extends Component>(classConstructor: new (engine: Engine) => T): T;
     /**
      * 获取某一类型的所有组件
      * @param classConstructor - 要获取的组件
      * @returns 一个组件列表，包含所有符合类型的组件
      */
     getComponents<T extends Component>(classConstructor: new (engine: Engine) => T): T[];
-    setParent(vfxItem: VFXItem<VFXItemContent>): void;
-    /**
-     * 停止播放元素动画
-     */
-    stop(): void;
+    setParent(vfxItem: VFXItem): void;
     /**
      * 元素动画结束播放时回调函数
      * @override
@@ -210,7 +188,12 @@ export declare class VFXItem<T extends VFXItemContent> extends EffectsObject imp
      */
     scale(x: number, y: number, z: number): void;
     /**
-     * 设置元素的在画布上的像素位置, 坐标原点在 canvas 中心，x 正方向水平向右， y 正方向垂直向下
+     * 设置元素在画布上的像素位置
+     * Tips:
+     *  - 坐标原点在 canvas 左上角，x 正方向水平向右， y 正方向垂直向下
+     *  - 设置后会覆盖原有的位置信息
+     * @param x - x 坐标
+     * @param y - y 坐标
      */
     setPositionByPixel(x: number, y: number): void;
     /**
@@ -246,7 +229,7 @@ export declare class VFXItem<T extends VFXItemContent> extends EffectsObject imp
      * @returns
      */
     isEnded(now: number): boolean;
-    find(name: string): VFXItem<VFXItemContent> | undefined;
+    find(name: string): VFXItem | undefined;
     fromData(data: VFXItemData): void;
     toData(): void;
     translateByPixel(x: number, y: number): void;
@@ -267,4 +250,4 @@ export declare namespace Item {
  * @param props
  * @param composition
  */
-export declare function createVFXItem(props: VFXItemProps, composition: Composition): VFXItem<any>;
+export declare function createVFXItem(props: VFXItemProps, composition: Composition): VFXItem;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/effects-core",
-  "version": "2.0.0-alpha.11",
+  "version": "2.0.0-alpha.13",
   "description": "Galacean Effects runtime core for the web",
   "module": "./dist/index.mjs",
   "main": "./dist/index.js",
@@ -42,7 +42,7 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@galacean/effects-specification": "2.0.0-alpha.10",
+    "@galacean/effects-specification": "2.0.0-alpha.16",
     "@galacean/effects-math": "1.1.0",
     "uuid": "9.0.1"
   },
@@ -51,6 +51,6 @@
     "build": "pnpm build:declaration && pnpm build:module",
     "build:module": "rollup -c",
     "build:declaration": "tsc -d --emitDeclarationOnly",
-    "clean": "rimraf dist && rimraf '*+(.tsbuildinfo)'"
+    "clean": "rimraf dist && rimraf \"*+(.tsbuildinfo)\""
   }
 }