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

package/dist/plugins/interact/click-handler.d.ts

@@ -3,6 +3,7 @@ import { Vector2 } from '@galacean/effects-math/es/core/vector2';
 import type * as spec from '@galacean/effects-specification';
 import type { VFXItem } from '../../vfx-item';
 import type { Composition } from '../../composition';
+import type { Maskable } from '../../material';
 export declare enum HitTestType {
     triangle = 1,
     box = 2,
@@ -28,23 +29,27 @@ export interface HitTestTriangleParams {
     type: HitTestType.triangle;
     triangles: TriangleLike[];
     backfaceCulling?: boolean;
+    clipMasks: Maskable[];
     behavior?: spec.InteractBehavior;
 }
 export interface HitTestBoxParams {
     type: HitTestType.box;
     center: Vector3;
     size: Vector3;
+    clipMasks: Maskable[];
     behavior?: spec.InteractBehavior;
 }
 export interface HitTestSphereParams {
     type: HitTestType.sphere;
     center: Vector3;
     radius: number;
+    clipMasks: Maskable[];
     behavior?: spec.InteractBehavior;
 }
 export interface HitTestCustomParams {
     type: HitTestType.custom;
     collect(ray: Ray, pointInCanvas: Vector2): Vector3[] | void;
+    clipMasks: Maskable[];
     behavior?: spec.InteractBehavior;
 }
 export type Region = {

package/dist/plugins/interact/interact-item.d.ts

@@ -88,7 +88,7 @@ export declare class InteractComponent extends RendererComponent {
     beginDragTarget(options: spec.DragInteractOption, eventSystem: EventSystem): void;
     getHitTestParams: (force?: boolean) => HitTestTriangleParams | void;
     getBoundingBox(): BoundingBoxTriangle | void;
-    fromData(data: spec.InteractContent): void;
+    fromData(data: spec.InteractComponentData): void;
     /**
      * 是否可以交互
      * @returns

package/dist/plugins/particle/particle-mesh.d.ts

@@ -28,7 +28,6 @@ export interface ParticleMeshData {
         y?: ValueGetter<number>;
         separateAxes?: boolean;
     };
-    meshSlots?: number[];
     forceTarget?: {
         curve: ValueGetter<number>;
         target: spec.vec3;

package/dist/plugins/particle/particle-system-renderer.d.ts

@@ -1,8 +1,8 @@
 import type { Matrix4 } from '@galacean/effects-math/es/core/matrix4';
 import type { Vector3 } from '@galacean/effects-math/es/core/vector3';
 import type { Texture } from '../../texture';
-import type { TrailMeshProps, TrailPointOptions } from './trail-mesh';
-import type { ParticleMeshProps, Point } from './particle-mesh';
+import type { TrailPointOptions } from './trail-mesh';
+import type { Point } from './particle-mesh';
 import { ParticleMesh } from './particle-mesh';
 import type { Mesh, Renderer } from '../../render';
 import type { Engine } from '../../engine';
@@ -14,7 +14,7 @@ export declare class ParticleSystemRenderer extends RendererComponent {
     meshes: Mesh[];
     particleMesh: ParticleMesh;
     private trailMesh?;
-    constructor(engine: Engine, particleMeshProps?: ParticleMeshProps, trailMeshProps?: TrailMeshProps);
+    constructor(engine: Engine);
     onStart(): void;
     onUpdate(dt: number): void;
     render(renderer: Renderer): void;

package/dist/plugins/particle/particle-system.d.ts

@@ -1,6 +1,6 @@
 import type { Ray } from '@galacean/effects-math/es/core/index';
 import { Vector3 } from '@galacean/effects-math/es/core/index';
-import type { vec2, vec3, vec4 } from '@galacean/effects-specification';
+import type { vec3 } from '@galacean/effects-specification';
 import * as spec from '@galacean/effects-specification';
 import { Component } from '../../components';
 import type { Engine } from '../../engine';
@@ -94,7 +94,6 @@ type TrailOptions = {
     blending: number;
     occlusion: boolean;
     transparentOcclusion: boolean;
-    textureMap?: vec4;
 };
 interface ParticleTextureSheetAnimation {
     col: number;
@@ -112,24 +111,7 @@ type ParticleInteraction = {
     multiple?: boolean;
     radius: number;
 };
-export interface ParticleSystemOptions extends spec.ParticleOptions {
-    meshSlots?: number[];
-}
-export interface ParticleSystemProps extends Omit<spec.ParticleContent, 'options' | 'renderer' | 'trails' | 'mask'> {
-    options: ParticleSystemOptions;
-    renderer: ParticleSystemRendererOptions;
-    trails?: ParticleTrailProps;
-    mask?: spec.MaskOptions;
-}
-export interface ParticleSystemRendererOptions extends Required<Omit<spec.RendererOptions, 'texture' | 'anchor' | 'particleOrigin'>> {
-    texture: Texture;
-    anchor?: vec2;
-    particleOrigin?: spec.ParticleOrigin;
-}
-export interface ParticleTrailProps extends Omit<spec.ParticleTrail, 'texture' | 'mask'> {
-    texture: Texture;
-    textureMap: vec4;
-    mask?: spec.MaskOptions;
+export interface ParticleSystemProps extends spec.ParticleContent {
 }
 export type ParticleContent = [number, number, number, Point];
 export declare class ParticleSystem extends Component implements Maskable {
@@ -142,7 +124,6 @@ export declare class ParticleSystem extends Component implements Maskable {
     textureSheetAnimation?: ParticleTextureSheetAnimation;
     interaction?: ParticleInteraction;
     emissionStopped: boolean;
-    destroyed: boolean;
     props: ParticleSystemProps;
     time: number;
     readonly maskManager: MaskProcessor;
@@ -157,7 +138,9 @@ export declare class ParticleSystem extends Component implements Maskable {
     private uvs;
     private basicTransform;
     private clickedPoint;
-    constructor(engine: Engine, props?: ParticleSystemProps);
+    private particleMeshProps;
+    private trailMeshProps;
+    constructor(engine: Engine, props?: spec.ParticleSystemData);
     get timePassed(): number;
     get lifetime(): number;
     get particleCount(): number;
@@ -212,6 +195,6 @@ export declare class ParticleSystem extends Component implements Maskable {
     resumeParticleEmission(): void;
     getBoundingBox(): void | BoundingBoxSphere;
     getHitTestParams: (force?: boolean) => void | HitTestCustomParams;
-    fromData(data: unknown): void;
+    fromData(data: spec.ParticleSystemData): void;
 }
 export {};

package/dist/plugins/particle/trail-mesh.d.ts

@@ -1,7 +1,7 @@
 import type { Matrix4 } from '@galacean/effects-math/es/core/index';
 import { Vector3 } from '@galacean/effects-math/es/core/index';
 import type * as spec from '@galacean/effects-specification';
-import type { GradientStop, vec4 } from '@galacean/effects-specification';
+import type { GradientStop } from '@galacean/effects-specification';
 import type { Engine } from '../../engine';
 import { ValueGetter } from '../../math';
 import type { GPUCapability, ShaderWithSource } from '../../render';
@@ -24,7 +24,6 @@ export type TrailMeshProps = {
     mask: number;
     shaderCachePrefix: string;
     maskMode: number;
-    textureMap: vec4;
     name: string;
 };
 export type TrailPointOptions = {

package/dist/plugins/plugin.d.ts

@@ -32,7 +32,7 @@ export declare abstract class Plugin {
      * @param composition - 合成对象
      * @param scene - 场景对象
      */
-    onCompositionCreated(composition: Composition, scene: Scene): void;
+    onCompositionCreated(composition: Composition, scene?: Scene): void;
     /**
      * 合成销毁时触发。
      * @param composition - 合成对象

package/dist/plugins/text/text-component-base.d.ts

@@ -89,7 +89,7 @@ export declare class TextComponentBase {
      */
     setOverflow(overflow: spec.TextOverflow): void;
     protected getFontDesc(size?: number): string;
-    protected setupOutline(): void;
+    protected setupOutline(fontScale?: number): void;
     protected setupShadow(): void;
     protected disposeTextTexture(): void;
     /**

package/dist/plugins/text/text-item.d.ts

@@ -133,7 +133,7 @@ export declare class TextComponent extends MaskableGraphic {
      *
      * 说明：
      * - 使用 Canvas 2D 的 measureText，并按当前实现的逐字符排版规则累加宽度（与 updateTexture 保持一致）。
-     * - 结果为"逻辑宽度"（已除去 fontScale，并扣除 fontOffset），可直接写回 options.textWidth。
+     * - 结果为"逻辑宽度"（扣除 fontOffset），可直接写回 options.textWidth。，可直接写回 options.textWidth。
      * - 通过 padding 追加少量冗余像素，用于降低边缘裁切风险。
      *
      * @returns 文本宽度（>= 0）

package/dist/plugins/text/text-layout.d.ts

@@ -16,6 +16,13 @@ export declare class TextLayout implements BaseLayout {
      * 自动宽高模式
      */
     autoResize: spec.TextSizeMode;
+    /**
+     * 是否启用单词完整换行（不从单词中间断开）
+     * - true: 优先在空格处换行，保持单词完整性
+     * - false: 允许在任意字符处换行（逐字符换行）
+     * @default true
+     */
+    keepWordIntact: boolean;
     constructor(options: spec.TextContentOptions);
     update(options: spec.TextContentOptions): void;
     /**

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

@@ -45,7 +45,7 @@ export declare class TrackAsset extends PlayableAsset {
     findClip(name: string): TimelineClip | undefined;
     addClip(clip: TimelineClip): void;
     private createClipPlayable;
-    fromData(data: spec.EffectsObjectData): void;
+    fromData(data: spec.TrackAssetData): void;
 }
 export declare enum TrackType {
     MasterTrack = 0,

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

@@ -1,7 +1,7 @@
-import type { EffectsObjectData } from '@galacean/effects-specification';
+import type { TrackAssetData } from '@galacean/effects-specification';
 import { TrackAsset } from '../track';
 export declare abstract class PropertyTrack extends TrackAsset {
     protected propertyNames: string[];
     protected path: string;
-    fromData(data: EffectsObjectData): void;
+    fromData(data: TrackAssetData): void;
 }

package/dist/render/renderer.d.ts

@@ -1,53 +1,44 @@
 import type { Matrix4, Vector3, Vector4 } from '@galacean/effects-math/es/core/index';
 import type { RendererComponent } from '../components';
 import type { Engine } from '../engine';
-import type { Material } from '../material';
-import type { LostHandler, RestoreHandler } from '../utils';
+import { Material } from '../material';
 import type { FilterMode, Framebuffer, RenderTextureFormat } from './framebuffer';
-import type { Geometry } from './geometry';
-import type { RenderFrame, RenderingData } from './render-frame';
-import type { RenderPassClearAction } from './render-pass';
+import { Geometry } from './geometry';
+import type { RenderFrame } from './render-frame';
+import type { RenderPass, RenderPassClearAction } from './render-pass';
 import type { ShaderLibrary } from './shader';
-import { RenderTargetPool } from './render-target-pool';
 import type { Texture } from '../texture';
-export declare class Renderer implements LostHandler, RestoreHandler {
+export declare class Renderer {
     engine: Engine;
-    static create: (engine: Engine) => Renderer;
+    static create(engine: Engine): Renderer;
     /**
     * 存放渲染需要用到的数据
     */
-    renderingData: RenderingData;
-    renderTargetPool: RenderTargetPool;
     protected currentFramebuffer: Framebuffer | null;
+    protected disposed: boolean;
+    private blitGeometry;
+    private blitMaterial;
     constructor(engine: Engine);
+    get renderingData(): import("./render-frame").RenderingData;
     setGlobalFloat(name: string, value: number): void;
-    setGlobalInt(name: string, value: number): void;
     setGlobalVector4(name: string, value: Vector4): void;
-    setGlobalVector3(name: string, value: Vector3): void;
+    setGlobalInt(name: string, value: number): void;
     setGlobalMatrix(name: string, value: Matrix4): void;
+    setGlobalVector3(name: string, value: Vector3): void;
     getFramebuffer(): Framebuffer;
     setFramebuffer(framebuffer: Framebuffer | null): void;
     setViewport(x: number, y: number, width: number, height: number): void;
-    resize(canvasWidth: number, canvasHeight: number): void;
     clear(action: RenderPassClearAction): void;
     getWidth(): number;
     getHeight(): number;
-    /**
-     * @override
-     * @param e
-     */
-    lost(e: Event): void;
-    /**
-     * @override
-     */
-    restore(): void;
     /**
      *
      * @override
      * @returns
      */
-    getShaderLibrary(): ShaderLibrary | undefined;
+    getShaderLibrary(): ShaderLibrary | null;
     renderRenderFrame(renderFrame: RenderFrame): void;
+    renderRenderPass(pass: RenderPass): void;
     renderMeshes(meshes: RendererComponent[]): void;
     drawGeometry(geometry: Geometry, matrix: Matrix4, material: Material, subMeshIndex?: number): void;
     getTemporaryRT(name: string, width: number, height: number, depthBuffer: number, filter: FilterMode, format: RenderTextureFormat): Framebuffer;
@@ -60,4 +51,5 @@ export declare class Renderer implements LostHandler, RestoreHandler {
      */
     blit(source: Texture, destination: Framebuffer | null, material?: Material): void;
     dispose(): void;
+    private checkGlobalUniform;
 }

package/dist/render/shader.d.ts

@@ -1,6 +1,8 @@
 import * as spec from '@galacean/effects-specification';
+import type { Color, Matrix3, Matrix4, Quaternion, Vector2, Vector3, Vector4 } from '@galacean/effects-math/es/core/index';
 import { EffectsObject } from '../effects-object';
 import type { Engine } from '../engine';
+import type { Texture } from '../texture';
 export type ShaderMacros = [key: string, value: string | number | boolean][];
 export declare enum ShaderCompileResultStatus {
     noShader = 0,
@@ -57,6 +59,23 @@ export declare abstract class ShaderVariant extends EffectsObject {
     readonly source: ShaderWithSource;
     shader: Shader;
     constructor(engine: Engine, source: ShaderWithSource);
+    initialize(): void;
+    abstract setFloat(name: string, value: number): void;
+    abstract setInt(name: string, value: number): void;
+    abstract setFloats(name: string, value: number[]): void;
+    abstract setTexture(name: string, texture: Texture): void;
+    abstract setVector2(name: string, value: Vector2): void;
+    abstract setVector3(name: string, value: Vector3): void;
+    abstract setVector4(name: string, value: Vector4): void;
+    abstract setColor(name: string, value: Color): void;
+    abstract setQuaternion(name: string, value: Quaternion): void;
+    abstract setMatrix(name: string, value: Matrix4): void;
+    abstract setMatrix3(name: string, value: Matrix3): void;
+    abstract setVector4Array(name: string, array: number[]): void;
+    abstract setMatrixArray(name: string, array: number[]): void;
+    abstract fillShaderInformation(uniformNames: string[], samplers: string[]): void;
+    abstract bind(): void;
+    abstract isReady(): boolean;
 }
 export declare class Shader extends EffectsObject {
     shaderData: spec.ShaderData;

package/dist/scene-loader.d.ts

@@ -3,6 +3,8 @@ import type { Engine } from './engine';
 import type { Scene, SceneLoadOptions } from './scene';
 /**
  * @hidden
+ * Internal utility.
+ * Not part of the public API — do not rely on this in your code.
  */
 export declare class SceneLoader {
     static load(scene: Scene.LoadType, engine: Engine, options?: SceneLoadOptions): Promise<Composition>;

package/dist/scene.d.ts

@@ -79,7 +79,6 @@ export interface SceneLoadOptions {
     /**
      * 渲染分级。
      * 分级之后，只会加载当前渲染等级的资源。
-     * 当渲染等级被设置为 B 后，player 的 fps 会降到 30 帧
      * @default 'S'
      */
     renderLevel?: SceneRenderLevel;

package/dist/texture/texture.d.ts

@@ -88,4 +88,4 @@ export declare abstract class Texture extends EffectsObject {
 }
 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;
+export declare function generateEmptyTexture(engine: Engine): Texture;

package/dist/vfx-item.d.ts

@@ -1,11 +1,12 @@
+import type { Ray } from '@galacean/effects-math/es/core/ray';
 import { Vector3 } from '@galacean/effects-math/es/core/vector3';
 import * as spec from '@galacean/effects-specification';
 import type { Component } from './components';
-import type { Composition } from './composition';
+import type { Composition, CompositionHitTestOptions } from './composition';
 import { EffectsObject } from './effects-object';
 import type { Engine } from './engine';
 import type { EventEmitterListener, EventEmitterOptions, ItemEvent } from './events';
-import type { BoundingBoxData, HitTestBoxParams, HitTestCustomParams, HitTestSphereParams, HitTestTriangleParams } from './plugins';
+import type { BoundingBoxData, HitTestBoxParams, HitTestCustomParams, HitTestSphereParams, HitTestTriangleParams, Region } from './plugins';
 import { Transform } from './transform';
 import type { Constructor, Disposable } from './utils';
 /**
@@ -54,7 +55,7 @@ export declare class VFXItem extends EffectsObject implements Disposable {
      */
     type: spec.ItemType;
     /**
-     * @deprecated 2.9.0 Please use `defination` instead
+     * @deprecated 2.9.0 Please use `definition` instead
      */
     props: spec.VFXItemData;
     /**
@@ -275,6 +276,19 @@ export declare class VFXItem extends EffectsObject implements Disposable {
      * @param force - 元素没有开启交互也返回参数
      */
     getHitTestParams(force?: boolean): void | HitTestBoxParams | HitTestTriangleParams | HitTestSphereParams | HitTestCustomParams;
+    /**
+     * 对当前元素及其子节点进行射线命中测试
+     *
+     * @param ray - 射线
+     * @param x - 归一化屏幕坐标 x
+     * @param y - 归一化屏幕坐标 y
+     * @param regions - 命中结果收集数组
+     * @param hitPositions - 共享的命中位置数组，所有 region 共享同一引用
+     * @param force - 是否强制测试无交互信息的元素
+     * @param options - 额外选项（maxCount、stop、skip）
+     * @returns 是否有任何命中
+     */
+    hitTest(ray: Ray, x: number, y: number, regions: Region[], hitPositions: Vector3[], force?: boolean, options?: CompositionHitTestOptions): boolean;
     /**
      * 获取元素当前世界坐标
      */
@@ -286,6 +300,7 @@ export declare class VFXItem extends EffectsObject implements Disposable {
      * @returns 复制的新 VFXItem
      */
     duplicate(): VFXItem;
+    private onParentChanged;
     fromData(data: spec.VFXItemData): void;
     toData(): void;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/effects-core",
-  "version": "2.9.0-alpha.1",
+  "version": "2.9.0",
   "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.8.0-alpha.0",
+    "@galacean/effects-specification": "^2.8.1",
     "@galacean/effects-math": "1.1.0",
     "flatbuffers": "24.3.25",
     "uuid": "9.0.1",