@galacean/effects-core 2.0.0-alpha.2 → 2.0.0-alpha.20

package/dist/asset-loader.d.ts

@@ -1,4 +1,4 @@
-import type * as spec from '@galacean/effects-specification';
+import * as spec from '@galacean/effects-specification';
 import type { EffectsObject } from './effects-object';
 import type { Engine } from './engine';
 import type { VFXItemProps } from './vfx-item';
@@ -17,96 +17,14 @@ export declare class AssetLoader {
 export declare class Database {
     loadGUID(guid: string): Promise<EffectsObject | undefined>;
 }
-export declare enum DataType {
-    VFXItemData = 0,
-    EffectComponent = 1,
-    Material = 2,
-    Shader = 3,
-    SpriteComponent = 4,
-    ParticleSystem = 5,
-    InteractComponent = 6,
-    CameraController = 7,
-    Geometry = 8,
-    Texture = 9,
-    TextComponent = 10,
-    MeshComponent = 10000,
-    SkyboxComponent = 10001,
-    LightComponent = 10002,
-    CameraComponent = 10003,
-    ModelPluginComponent = 10004,
-    TreeComponent = 10005
-}
-export interface DataPath {
-    id: string;
-}
-export interface EffectsObjectData {
-    id: string;
-    name?: string;
-    dataType: number;
-}
-export interface MaterialData extends EffectsObjectData {
-    shader: DataPath;
-    blending?: boolean;
-    zWrite?: boolean;
-    zTest?: boolean;
-    floats: Record<string, number>;
-    ints: Record<string, number>;
-    vector2s?: Record<string, spec.vec2>;
-    vector3s?: Record<string, spec.vec3>;
-    vector4s: Record<string, {
-        x: number;
-        y: number;
-        z: number;
-        w: number;
-    }>;
-    colors: Record<string, {
-        r: number;
-        g: number;
-        b: number;
-        a: number;
-    }>;
-    matrices?: Record<string, spec.mat4>;
-    matrice3s?: Record<string, spec.mat3>;
-    textures?: Record<string, DataPath>;
-    floatArrays?: Record<string, number[]>;
-    vector4Arrays?: Record<string, number[]>;
-    matrixArrays?: Record<string, number[]>;
-}
-export interface GeometryData extends EffectsObjectData {
-    vertexData: VertexData;
-    indexFormat: number;
-    indexOffset: number;
-    buffer: string;
-}
-export interface VertexData {
-    vertexCount: number;
-    channels: VertexChannel[];
-}
-export interface VertexChannel {
-    offset: number;
-    format: number;
-    dimension: number;
-}
-export interface ShaderData extends EffectsObjectData {
-    vertex: string;
-    fragment: string;
-    properties?: string;
-}
-export interface EffectComponentData extends EffectsObjectData {
+export interface EffectComponentData extends spec.EffectsObjectData {
     _priority: number;
-    item: DataPath;
-    materials: DataPath[];
-    geometry: DataPath;
+    item: spec.DataPath;
+    materials: spec.DataPath[];
+    geometry: spec.DataPath;
 }
 export type VFXItemData = VFXItemProps & {
-    dataType: DataType;
-    components: DataPath[];
+    dataType: spec.DataType;
+    components: spec.DataPath[];
 };
-export type SceneData = Record<string, EffectsObjectData>;
-export interface EffectsPackageData {
-    fileSummary: {
-        guid: string;
-        assetType: string;
-    };
-    exportObjects: EffectsObjectData[];
-}
+export type SceneData = Record<string, spec.EffectsObjectData>;

package/dist/asset-manager.d.ts

@@ -1,86 +1,7 @@
-import * as spec from '@galacean/effects-specification';
 import { Downloader } from './downloader';
-import type { Scene } from './scene';
+import type { Scene, SceneLoadOptions, SceneType } from './scene';
 import type { Disposable } from './utils';
 import type { Renderer } from './render';
-/**
- * 场景加载参数
- */
-export interface SceneLoadOptions {
-    /**
-     * 动态数据的参数
-     * key 是 JSON 中配置的字段名
-     * value 是要使用的值，图片使用 url 链接
-     * 图片链接可以使用数组传递，如果第一个加载失败，将尝试使用第二个地址
-     *
-     * @example
-     * ``` ts
-     * {
-     *   variables: {
-     *     bg: ['url','fallback_url'], // 如果两个图片都失败，将会触发加载失败
-     *     fg: 'url' // 如果图片加载失败，将会触发加载失败,
-     *     amount: 88.8,
-     *     name: 'abc'
-     *   }
-     * }
-     * ```
-     */
-    variables?: Record<string, number | string | string[]>;
-    /**
-     * 模板图片缩放倍数
-     * @default 1 如果图片比较糊，可以用 2（但会增大图片内存）
-     */
-    templateScale?: number;
-    /**
-     * 是否使用压缩纹理
-     */
-    useCompressedTexture?: boolean;
-    /**
-     * 渲染分级。
-     * 分级之后，只会加载当前渲染等级的资源。
-     * 当渲染等级被设置为 B 后，player 的 fps 会降到 30 帧
-     * @default 's'
-     */
-    renderLevel?: spec.RenderLevel;
-    /**
-     * 资源加载超时，时间单位秒
-     * @default 10s
-     */
-    timeout?: number;
-    /***
-     * 用于给 plugin 的加载数据
-     * key/value 的内容由 plugin 自己实现
-     */
-    pluginData?: Record<string, any>;
-    /**
-     * 场景加载时的环境（加载后把 env 结果写入 scene）
-     * @default '' - 编辑器中为 'editor'
-     */
-    env?: string;
-    /**
-     * 加载后是否自动播放
-     * @default true
-     */
-    autoplay?: boolean;
-    /**
-     * 合成播放完成后是否需要再使用，是的话生命周期结束后不会 `dispose`
-     * @default false
-     */
-    reusable?: boolean;
-    /**
-     * 播放速度，当速度为负数时，合成倒播
-     */
-    speed?: number;
-}
-/**
- * 接受用于加载的数据类型
- */
-export type SceneType = string | Scene | Record<string, unknown>;
-export type SceneWithOptionsType = {
-    scene: SceneType;
-    options: SceneLoadOptions;
-};
-export type SceneLoadType = SceneType | SceneWithOptionsType;
 /**
  * 资源管理器
  * 用于加载和动效中所有的资源文件，包括图片、插件、图层粒子数据等

package/dist/asset-migrations.d.ts

@@ -1,6 +1,4 @@
-import * as spec from '@galacean/effects-specification';
-import type { Scene } from './scene';
-export declare function version3Migration(scene: Record<string, any>): Scene;
+import type * as spec from '@galacean/effects-specification';
 /**
  * 提取并转换 JSON 数据中的 anchor 值
  */

package/dist/binary-asset.d.ts

@@ -0,0 +1,6 @@
+import type { EffectsObjectData } from '@galacean/effects-specification';
+import { EffectsObject } from './effects-object';
+export declare class BinaryAsset extends EffectsObject {
+    buffer: ArrayBuffer;
+    fromData(data: EffectsObjectData): void;
+}

package/dist/canvas-pool.d.ts

@@ -0,0 +1,10 @@
+declare class CanvasPool {
+    readonly elements: HTMLCanvasElement[];
+    constructor();
+    dispose(): void;
+    getCanvas(): HTMLCanvasElement;
+    saveCanvas(canvas: HTMLCanvasElement): void;
+}
+export declare const canvasPool: CanvasPool;
+export declare function getDefaultTemplateCanvasPool(): CanvasPool;
+export {};

package/dist/comp-vfx-item.d.ts

@@ -1,27 +1,41 @@
 import type { Ray } from '@galacean/effects-math/es/core/ray';
+import * as spec from '@galacean/effects-specification';
 import { ItemBehaviour } from './components';
 import type { CompositionHitTestOptions } from './composition';
-import type { Region } from './plugins';
-import { TimelineComponent } from './plugins';
-import type { VFXItemContent } from './vfx-item';
+import type { ContentOptions } from './composition-source-manager';
+import type { Region, TrackAsset } from './plugins';
 import { VFXItem } from './vfx-item';
+export interface SceneBinding {
+    key: TrackAsset;
+    value: VFXItem;
+}
+export interface SceneBindingData {
+    key: spec.DataPath;
+    value: spec.DataPath;
+}
 /**
  * @since 2.0.0
  * @internal
  */
 export declare class CompositionComponent extends ItemBehaviour {
+    time: number;
     startTime: number;
     refId: string;
-    items: VFXItem<VFXItemContent>[];
-    timelineComponents: TimelineComponent[];
-    timelineComponent: TimelineComponent;
+    items: VFXItem[];
+    data: ContentOptions;
+    private reusable;
+    private sceneBindings;
+    private timelineAsset;
+    private timelinePlayable;
+    private graph;
     start(): void;
+    setReusable(value: boolean): void;
+    getReusable(): boolean;
     update(dt: number): void;
-    /**
-     * 重置元素状态属性
-     */
-    resetStatus(): void;
     createContent(): void;
     onDestroy(): void;
     hitTest(ray: Ray, x: number, y: number, regions: Region[], force?: boolean, options?: CompositionHitTestOptions): Region[];
+    fromData(data: unknown): void;
+    private resolveBindings;
+    private resolveTrackBindingsWithRoot;
 }

package/dist/components/component.d.ts

@@ -1,5 +1,5 @@
 import { EffectsObject } from '../effects-object';
-import type { VFXItem, VFXItemContent } from '../vfx-item';
+import type { VFXItem } from '../vfx-item';
 /**
  * @since 2.0.0
  * @internal
@@ -9,11 +9,11 @@ export declare abstract class Component extends EffectsObject {
     /**
      * 附加到的 VFXItem 对象
      */
-    item: VFXItem<VFXItemContent>;
+    item: VFXItem;
     /**
      * 附加到的 VFXItem 对象 Transform 组件
      */
-    get transform(): import("..").Transform;
+    get transform(): import("@galacean/effects-core").Transform;
     onAttached(): void;
     onDestroy(): void;
     fromData(data: any): void;
@@ -24,7 +24,7 @@ export declare abstract class Component extends EffectsObject {
  * @internal
  */
 export declare abstract class Behaviour extends Component {
-    _enabled: boolean;
+    private _enabled;
     /**
      * 组件是否可以更新，true 更新，false 不更新
      */
@@ -32,7 +32,7 @@ export declare abstract class Behaviour extends Component {
     get enabled(): boolean;
     set enabled(value: boolean);
     protected onBehaviourEnable(): void;
-    fromData(data: any): void;
+    fromData(data: unknown): void;
     toData(): void;
 }
 /**

package/dist/components/effect-component.d.ts

@@ -53,7 +53,7 @@ export declare class EffectComponent extends RendererComponent {
     setMaterial(material: Material, destroy?: MaterialDestroyOptions | DestroyOptions.keep): void;
     getHitTestParams: (force?: boolean) => HitTestTriangleParams | void;
     getBoundingBox(): BoundingBoxTriangle | void;
-    fromData(data: any): void;
+    fromData(data: unknown): void;
     toData(): void;
     /**
      * 销毁当前资源

package/dist/components/renderer-component.d.ts

@@ -26,7 +26,7 @@ export declare class RendererComponent extends Component {
     lateUpdate(dt: number): void;
     render(renderer: Renderer): void;
     onAttached(): void;
-    fromData(data: any): void;
+    fromData(data: unknown): void;
     toData(): void;
     dispose(): void;
 }

package/dist/composition-source-manager.d.ts

@@ -1,8 +1,9 @@
 import * as spec from '@galacean/effects-specification';
+import type { SceneBindingData } from './comp-vfx-item';
 import type { Engine } from './engine';
 import type { PluginSystem } from './plugin-system';
 import type { GlobalVolume } from './render';
-import type { Scene } from './scene';
+import type { Scene, SceneRenderLevel } from './scene';
 import type { Texture } from './texture';
 import type { Disposable } from './utils';
 import type { VFXItemProps } from './vfx-item';
@@ -15,16 +16,18 @@ export interface ContentOptions {
     camera: spec.CameraOptions;
     startTime: number;
     globalVolume: GlobalVolume;
+    timelineAsset: spec.DataPath;
+    sceneBindings: SceneBindingData[];
 }
 /**
  * 合成资源管理
  */
 export declare class CompositionSourceManager implements Disposable {
-    composition?: spec.Composition;
-    refCompositions: Map<string, spec.Composition>;
+    composition?: spec.CompositionData;
+    refCompositions: Map<string, spec.CompositionData>;
     sourceContent?: ContentOptions;
     refCompositionProps: Map<string, VFXItemProps>;
-    renderLevel?: spec.RenderLevel;
+    renderLevel?: SceneRenderLevel;
     pluginSystem?: PluginSystem;
     totalTime: number;
     imgUsage: Record<string, number[]>;

package/dist/composition.d.ts

@@ -2,18 +2,16 @@ import type { Ray } from '@galacean/effects-math/es/core/index';
 import * as spec from '@galacean/effects-specification';
 import { Camera } from './camera';
 import { CompositionComponent } from './comp-vfx-item';
-import type { CompositionSourceManager } from './composition-source-manager';
+import { CompositionSourceManager } from './composition-source-manager';
 import type { PluginSystem } from './plugin-system';
-import type { EventSystem, Region } from './plugins';
+import type { EventSystem, Plugin, Region } from './plugins';
 import type { MeshRendererOptions, Renderer } from './render';
 import { RenderFrame } from './render';
-import type { Scene } from './scene';
+import type { Scene, SceneType } from './scene';
 import type { Texture } from './texture';
-import { Transform } from './transform';
 import type { Disposable, LostHandler } from './utils';
-import type { VFXItemContent, VFXItemProps } from './vfx-item';
+import type { VFXItemProps } from './vfx-item';
 import { VFXItem } from './vfx-item';
-import type { SceneType } from './asset-manager';
 export interface CompositionStatistic {
     loadTime: number;
     loadStart: number;
@@ -31,13 +29,13 @@ export interface MessageItem {
 export interface CompositionHitTestOptions {
     maxCount?: number;
     stop?: (region: Region) => boolean;
-    skip?: (item: VFXItem<VFXItemContent>) => boolean;
+    skip?: (item: VFXItem) => boolean;
 }
 export interface CompositionProps {
     reusable?: boolean;
     baseRenderOrder?: number;
     renderer: Renderer;
-    onPlayerPause?: (item: VFXItem<any>) => void;
+    onPlayerPause?: (item: VFXItem) => void;
     onMessageItem?: (item: MessageItem) => void;
     onEnd?: (composition: Composition) => void;
     event?: EventSystem;
@@ -51,7 +49,6 @@ export interface CompositionProps {
  * 也负责 Item 相关的动画播放控制，和持有渲染帧数据。
  */
 export declare class Composition implements Disposable, LostHandler {
-    compositionSourceManager: CompositionSourceManager;
     renderer: Renderer;
     /**
      * 当前帧的渲染数据对象
@@ -70,10 +67,6 @@ export declare class Composition implements Disposable, LostHandler {
      * 合成渲染顺序，默认按升序渲染
      */
     renderOrder: number;
-    /**
-     * 所有合成 Item 的根变换
-     */
-    transform: Transform;
     /**
      * 播放完成后是否需要再使用，是的话生命周期结束后不会自动 dispose
      */
@@ -82,12 +75,12 @@ export declare class Composition implements Disposable, LostHandler {
      * 是否播放完成后销毁 texture 对象
      */
     keepResource: boolean;
-    extraCamera: VFXItem<VFXItemContent>;
+    extraCamera: VFXItem;
     /**
      * 合成结束行为是 spec.END_BEHAVIOR_PAUSE 或 spec.END_BEHAVIOR_PAUSE_AND_DESTROY 时执行的回调
      * @internal
      */
-    onPlayerPause?: (item: VFXItem<any>) => void;
+    onPlayerPause?: (item: VFXItem) => void;
     /**
      * 单个合成结束时的回调
      */
@@ -128,10 +121,6 @@ export declare class Composition implements Disposable, LostHandler {
      * 用于保存与当前合成相关的插件数据
      */
     readonly loaderData: Record<string, any>;
-    /**
-     * 渲染等级：S，A+，A，B+，B
-     */
-    readonly renderLevel?: spec.RenderLevel;
     /**
      * 场景加载和首帧渲染时间
      */
@@ -143,11 +132,11 @@ export declare class Composition implements Disposable, LostHandler {
     /**
      * 合成根元素
      */
-    rootItem: VFXItem<VFXItemContent>;
+    readonly rootItem: VFXItem;
     /**
      * 预合成数组
      */
-    readonly refContent: VFXItem<VFXItemContent>[];
+    readonly refContent: VFXItem[];
     /**
      * 预合成的合成属性，在 content 中会被其元素属性覆盖
      */
@@ -160,6 +149,7 @@ export declare class Composition implements Disposable, LostHandler {
      * 合成全局时间
      */
     globalTime: number;
+    editorScaleRatio: number;
     protected rendererOptions: MeshRendererOptions | null;
     protected assigned: boolean;
     /**
@@ -171,6 +161,8 @@ export declare class Composition implements Disposable, LostHandler {
      */
     protected readonly keepColorBuffer: boolean;
     protected rootComposition: CompositionComponent;
+    protected readonly postLoaders: Plugin[];
+    protected compositionSourceManager: CompositionSourceManager;
     /**
      * 合成暂停/播放 标识
      */
@@ -181,21 +173,17 @@ export declare class Composition implements Disposable, LostHandler {
      */
     private readonly globalVolume;
     private readonly texInfo;
-    private readonly postLoaders;
-    private rootTimeline;
     /**
      * Composition 构造函数
      * @param props - composition 的创建参数
      * @param scene
      * @param compositionSourceManager
      */
-    constructor(props: CompositionProps, scene: Scene, compositionSourceManager: CompositionSourceManager);
+    constructor(props: CompositionProps, scene: Scene);
     /**
-     * 合成结束回调
-     * @param {(composition: Composition) => void} func
-     * @deprecated since 2.0 - use `onEnd` instead
+     * 所有合成 Item 的根变换
      */
-    set handleEnd(func: (composition: Composition) => void);
+    get transform(): import("@galacean/effects-core").Transform;
     /**
      * 获取场景中的纹理数组
      */
@@ -203,7 +191,7 @@ export declare class Composition implements Disposable, LostHandler {
     /**
      * 获取合成中所有元素
      */
-    get items(): VFXItem<VFXItemContent>[];
+    get items(): VFXItem[];
     /**
      * 获取合成开始渲染的时间
      */
@@ -239,6 +227,12 @@ export declare class Composition implements Disposable, LostHandler {
      * @param speed - 速度
      */
     setSpeed(speed: number): void;
+    /**
+     * 设置合成的可见性
+     * @since 2.0.0
+     * @param visible - 是否可见
+     */
+    setVisible(visible: boolean): void;
     /**
      * 获取合成的动画速度
      * @returns
@@ -273,7 +267,7 @@ export declare class Composition implements Disposable, LostHandler {
      * @param time - 相对 startTime 的时间
      */
     setTime(time: number): void;
-    addItem(item: VFXItem<VFXItemContent>): void;
+    addItem(item: VFXItem): void;
     /**
      * 前进合成到指定时间
      * @param time - 相对0时刻的时间
@@ -285,6 +279,7 @@ export declare class Composition implements Disposable, LostHandler {
      */
     protected reset(): void;
     prepareRender(): void;
+    protected gatherRendererComponent(vfxItem: VFXItem, renderFrame: RenderFrame): void;
     /**
      * 是否合成需要重新播放
      * @returns 重新播放合成标志位
@@ -301,6 +296,7 @@ export declare class Composition implements Disposable, LostHandler {
      * @param skipRender - 是否需要渲染
      */
     update(deltaTime: number, skipRender?: boolean): void;
+    private toLocalTime;
     private getUpdateTime;
     private callStart;
     private callUpdate;
@@ -330,7 +326,7 @@ export declare class Composition implements Disposable, LostHandler {
      * @param name - 元素名称
      * @returns 元素对象
      */
-    getItemByName(name: string): VFXItem<VFXItemContent> | undefined;
+    getItemByName(name: string): VFXItem | undefined;
     /**
      * 获取指定位置和相机连成的射线
      * @param x
@@ -342,7 +338,7 @@ export declare class Composition implements Disposable, LostHandler {
      * 获取 engine 对象
      * @returns
      */
-    getEngine(): import("./engine").Engine;
+    getEngine(): import("@galacean/effects-core").Engine;
     /**
      * Item 求交测试，返回求交结果列表，x 和 y 是归一化到[-1, 1]区间的值，原点在左上角
      * @param x - 鼠标或触点的 x，已经归一化到[-1, 1]
@@ -356,13 +352,13 @@ export declare class Composition implements Disposable, LostHandler {
      * @param item - 交互元素
      * @param type - 交互类型
      */
-    addInteractiveItem(item: VFXItem<VFXItemContent>, type: spec.InteractType): string | undefined;
+    addInteractiveItem(item: VFXItem, type: spec.InteractType): string | undefined;
     /**
      * InteractItem 生命周期结束时的调用
      * @param item - 交互元素
      * @param type - 交互类型
      */
-    removeInteractiveItem(item: VFXItem<VFXItemContent>, type: spec.InteractType): void;
+    removeInteractiveItem(item: VFXItem, type: spec.InteractType): void;
     /**
      * 销毁插件 Item 中保存的纹理数组
      * @internal
@@ -374,7 +370,7 @@ export declare class Composition implements Disposable, LostHandler {
      * @internal
      * @param item - 需要销毁的 item
      */
-    destroyItem(item: VFXItem<VFXItemContent>): void;
+    destroyItem(item: VFXItem): void;
     lost(e: Event): void;
     /**
      * 合成对象销毁
@@ -392,6 +388,15 @@ export declare class Composition implements Disposable, LostHandler {
      * 合成整体在水平方向移动 x 像素，垂直方向移动 y 像素
      */
     translateByPixel(x: number, y: number): void;
+    /**
+     * 设置合成在画布上的像素位置
+     * Tips:
+     *  - 坐标原点在 canvas 左上角，x 正方向水平向右， y 正方向垂直向下
+     *  - 设置后会覆盖原有的位置信息
+     * @param x - x 坐标
+     * @param y - y 坐标
+     */
+    setPositionByPixel(x: number, y: number): void;
     /**
      * 设置合成在 3D 坐标轴上相对当前的位移
      */

package/dist/constants.d.ts

@@ -4,8 +4,7 @@ export declare const SEMANTIC_PRE_COLOR_ATTACHMENT_SIZE_0 = "PRE_COLOR_SIZE_0";
 export declare const SEMANTIC_MAIN_PRE_COLOR_ATTACHMENT_0 = "PRE_MAIN_COLOR_0";
 export declare const SEMANTIC_MAIN_PRE_COLOR_ATTACHMENT_SIZE_0 = "PRE_MAIN_COLOR_SIZE_0";
 export declare const PLAYER_OPTIONS_ENV_EDITOR = "editor";
-export declare const FILTER_NAME_NONE = "none";
 export declare const HELP_LINK: {
-    'Filter not imported': string;
     'Item duration can\'t be less than 0': string;
+    'ValueType: 21/22 is not supported': string;
 };

package/dist/decorators.d.ts

@@ -1,4 +1,5 @@
-export declare const effectsClassStore: Record<number, any>;
-export declare function getMergedStore(target: any): any;
-export declare function serialize(sourceName?: string): (target: any, propertyKey: any) => void;
-export declare function effectsClass(className: any): (target: any, context?: any) => void;
+import type { Constructor } from './utils';
+export declare const effectsClassStore: Record<string, any>;
+export declare function effectsClass(className: string): (target: Object, context?: unknown) => void;
+export declare function serialize(type?: Constructor, sourceName?: string): (target: Object, propertyKey: string | symbol) => void;
+export declare function getMergedStore(target: Object): Record<string, any>;

package/dist/downloader.d.ts

@@ -3,12 +3,6 @@ type ErrorHandler = (status: number, responseText: string) => void;
 /**
  *
  */
-type VideoLoadOptions = {
-    /**
-     * 视频是否循环播放
-     */
-    loop?: boolean;
-};
 /**
  * JSON 值，它可以是字符串、数字、布尔值、对象或者 JSON 值的数组。
  *
@@ -77,7 +71,7 @@ export declare function loadBlob(url: string): Promise<Blob>;
 /**
  * 异步加载一个视频文件
  * @param url - 视频文件的 URL 或 MediaProvider 对象
- * @param options - 加载参数
  */
-export declare function loadVideo(url: string | MediaProvider, options?: VideoLoadOptions): Promise<HTMLVideoElement>;
+export declare function loadVideo(url: string | MediaProvider): Promise<HTMLVideoElement>;
+export declare function loadMedia(url: string | string[], loadFn: (url: string) => Promise<HTMLImageElement | HTMLVideoElement>): Promise<HTMLImageElement | HTMLVideoElement>;
 export {};

package/dist/effects-object.d.ts

@@ -1,4 +1,4 @@
-import type { EffectsObjectData } from './asset-loader';
+import type * as spec from '@galacean/effects-specification';
 import type { Engine } from './engine';
 /**
  * @since 2.0.0
@@ -6,6 +6,7 @@ import type { Engine } from './engine';
  */
 export declare abstract class EffectsObject {
     engine: Engine;
+    static is(obj: unknown): obj is EffectsObject;
     protected guid: string;
     /**
      * 存储需要序列化的数据
@@ -20,6 +21,6 @@ export declare abstract class EffectsObject {
      *
      * @param data - 对象的序列化的数据
      */
-    fromData(data: EffectsObjectData): void;
+    fromData(data: spec.EffectsObjectData): void;
     dispose(): void;
 }