@galacean/effects-core 2.9.0-alpha.0 → 2.9.0-alpha.1

package/dist/asset-manager.d.ts

@@ -4,6 +4,7 @@ import type { ImageLike, SceneLoadOptions } from './scene';
 import { Scene } from './scene';
 import type { Disposable } from './utils';
 import type { Renderer } from './render';
+import { Precomposition } from './precompositions/precomposition';
 /**
  * 资源管理器
  * 用于加载和动效中所有的资源文件，包括图片、插件、图层粒子数据等
@@ -44,6 +45,7 @@ export declare class AssetManager implements Disposable {
      * @returns
      */
     static loadFontFamily(fonts: spec.FontDefine[], baseUrl?: string): Promise<void[] | undefined>;
+    static loadPrecomposition(jsonScene: spec.JSONScene | string, options?: SceneLoadOptions): Promise<Precomposition>;
     /**
      * 构造函数
      * @param options - 场景加载参数

package/dist/asset-service.d.ts

@@ -29,7 +29,6 @@ export declare class AssetService implements Disposable {
      * @param options
      */
     updateTextVariables(scene: Scene, variables?: spec.TemplateVariables): void;
-    initializeTexture(scene: Scene): void;
     prepareAssets(scene: Scene, assets: Record<string, ImageLike>): void;
     createShaderVariant(): void;
     private destroyBuiltinObjects;

package/dist/camera.d.ts

@@ -62,8 +62,8 @@ export interface CameraOptionsEx extends CameraOptionsBase {
  * 合成的相机对象，采用透视投影
  */
 export declare class Camera {
-    engine: Engine;
     name: string;
+    engine: Engine;
     /**
      * 编辑器用于缩放画布
      */
@@ -81,7 +81,7 @@ export declare class Camera {
      * @param name - 相机名称
      * @param options
      */
-    constructor(engine: Engine, name: string, options?: Partial<CameraOptions>);
+    constructor(name: string, options?: Partial<CameraOptions>);
     /**
      * 设置相机近平面
      * @param near

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

@@ -12,26 +12,45 @@ export interface SceneBindingData {
     key: spec.DataPath;
     value: spec.DataPath;
 }
+export declare enum UpdateModes {
+    EveryUpdate = 0,
+    Manual = 1
+}
 /**
  * @since 2.0.0
  */
 export declare class CompositionComponent extends Component {
-    time: number;
     items: VFXItem[];
-    private reusable;
+    /**
+     * 更新模式，决定了组件更新时间的方式
+     * - EveryUpdate：每帧自动更新，适用于大多数情况
+     * - Manual：需要手动调用 tick 接口更新，适用于需要精确控制更新时间的情况
+     */
+    updateMode: UpdateModes;
+    playOnStart: boolean;
+    endBehavior: spec.EndBehavior;
+    private time;
+    private lastTime;
     private sceneBindings;
     private timelineAsset;
     private _timelineInstance;
+    private nestedCompositions;
     private get timelineInstance();
     onStart(): void;
-    getReusable(): boolean;
     pause(): void;
-    resume(): void;
+    play(): void;
+    stop(): void;
+    getTime(): number;
+    setTime(time: number): void;
     onUpdate(dt: number): void;
+    tick(deltaTime: number): void;
     onEnable(): void;
     onDisable(): void;
     onDestroy(): void;
     hitTest(ray: Ray, x: number, y: number, regions: Region[], force?: boolean, options?: CompositionHitTestOptions): boolean;
-    private hitTestRecursive;
+    /**
+     * 递归收集场景树中的直接子元素（DFS 前序）
+     */
+    private collectChildren;
     fromData(data: any): void;
 }

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

@@ -7,10 +7,13 @@ export declare class FrameComponent extends RendererComponent implements Maskabl
     private clipGeometry;
     private worldMatrix;
     onAwake(): void;
+    onStart(): void;
     onPreRender(): void;
     render(renderer: Renderer): void;
     onDestroy(): void;
     drawStencilMask(maskRef: number): void;
+    fromData(data: any): void;
+    private getHitTestParams;
     private setClipRectangle;
     private setClipRectangleRecursive;
 }

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

@@ -1,4 +1,5 @@
 import type { Material } from '../material';
+import { MaskProcessor } from '../material';
 import { BoundingBoxInfo } from '../plugins/interact/mesh-collider';
 import { Component } from './component';
 import type { Renderer } from '../render/renderer';
@@ -8,6 +9,12 @@ import type { Renderer } from '../render/renderer';
  */
 export declare class RendererComponent extends Component {
     materials: Material[];
+    /**
+     * @hidden
+     * Internal utility.
+     * Not part of the public API — do not rely on this in your code.
+     */
+    maskManager: MaskProcessor;
     protected _priority: number;
     /**
      * 用于点击测试的碰撞器

package/dist/composition.d.ts

@@ -143,6 +143,7 @@ export declare class Composition extends EventEmitter<CompositionEvent<Compositi
     renderOrder: number;
     /**
      * 播放完成后是否需要再使用，是的话生命周期结束后不会自动 dispose
+     * @deprecated
      */
     reusable: boolean;
     /**
@@ -190,10 +191,6 @@ export declare class Composition extends EventEmitter<CompositionEvent<Compositi
      * 合成根元素
      */
     readonly rootItem: VFXItem;
-    /**
-     * 预合成数组
-     */
-    readonly refContent: VFXItem[];
     /**
      * 合成的相机对象
      */
@@ -202,6 +199,10 @@ export declare class Composition extends EventEmitter<CompositionEvent<Compositi
      * 合成开始渲染的时间
      */
     readonly startTime: number;
+    /**
+     * 场景中视频列表
+     */
+    videos: HTMLVideoElement[];
     /**
      * 后处理渲染配置
      */
@@ -225,13 +226,13 @@ export declare class Composition extends EventEmitter<CompositionEvent<Compositi
     private paused;
     private isEndCalled;
     private _textures;
-    private videos;
     /**
      * Composition 构造函数
      * @param props - composition 的创建参数
      * @param scene
      */
     constructor(props: CompositionProps, scene: Scene);
+    get engine(): import("@galacean/effects-core").Engine;
     /**
      * 所有合成 Item 的根变换
      */

package/dist/index.d.ts

@@ -39,4 +39,5 @@ export * from './effects-object';
 export * from './effects-package';
 export * from './events';
 export * from './pass-render-level';
+export * from './precompositions';
 export declare const version: string;