@galacean/effects-core 2.7.0-alpha.1 → 2.7.0-beta.0

package/dist/material/material.d.ts

@@ -354,10 +354,6 @@ export declare abstract class Material extends EffectsObject implements Disposab
      */
     abstract clone(props?: MaterialProps): Material;
     abstract cloneUniforms(sourceMaterial: Material): void;
-    /**
-     * 销毁当前 Material
-     */
-    abstract dispose(): void;
     /**
      * 创建 Material
      */

package/dist/plugin-system.d.ts

@@ -3,7 +3,8 @@ import type { Composition } from './composition';
 import type { Plugin, PluginConstructor } from './plugins';
 import type { RenderFrame, Renderer } from './render';
 import type { Scene, SceneLoadOptions } from './scene';
-import type { VFXItemConstructor } from './vfx-item';
+import type { Constructor } from './utils';
+import type { VFXItem } from './vfx-item';
 export declare const pluginLoaderMap: Record<string, PluginConstructor>;
 export declare const defaultPlugins: string[];
 /**
@@ -13,7 +14,7 @@ export declare const defaultPlugins: string[];
  * @param itemClass class of item
  * @param isDefault load
  */
-export declare function registerPlugin(name: string, pluginClass: PluginConstructor, itemClass: VFXItemConstructor): void;
+export declare function registerPlugin(name: string, pluginClass: PluginConstructor, itemClass: Constructor<VFXItem>): void;
 export declare function unregisterPlugin(name: string): void;
 export declare class PluginSystem {
     readonly plugins: Plugin[];

package/dist/plugins/animation-graph/pose.d.ts

@@ -1,6 +1,6 @@
 import { Quaternion } from '@galacean/effects-math/es/core/quaternion';
 import { Vector3 } from '@galacean/effects-math/es/core/vector3';
-import type { Color } from '@galacean/effects-math/es/core/color';
+import { Color } from '@galacean/effects-math/es/core/color';
 import type { Skeleton } from './skeleton';
 import type { Transform } from '../../transform';
 export declare class NodeTransform {

package/dist/plugins/animation-graph/skeleton.d.ts

@@ -1,4 +1,4 @@
-import type { Color } from '@galacean/effects-math/es/core/color';
+import { Color } from '@galacean/effects-math/es/core/color';
 import type { VFXItem } from '../../vfx-item';
 import type { Transform } from '../../transform';
 import { NodeTransform } from './pose';

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

@@ -50,11 +50,32 @@ export declare class InteractComponent extends RendererComponent {
     /** 是否响应点击和拖拽交互事件 */
     private _interactive;
     private lastTime;
+    /**
+     * 是否响应点击和拖拽交互事件
+     */
     set interactive(enable: boolean);
     get interactive(): boolean;
+    /**
+     * 获取拖拽范围 X 轴
+     * @returns 拖拽范围 [min, max]
+     */
     getDragRangeX(): [min: number, max: number];
+    /**
+     * 设置拖拽范围 X 轴
+     * @param min 最小值
+     * @param max 最大值
+     */
     setDragRangeX(min: number, max: number): void;
+    /**
+     * 获取拖拽范围 Y 轴
+     * @returns 拖拽范围 [min, max]
+     */
     getDragRangeY(): [min: number, max: number];
+    /**
+     * 设置拖拽范围 Y 轴
+     * @param min 最小值
+     * @param max 最大值
+     */
     setDragRangeY(min: number, max: number): void;
     onStart(): void;
     onDisable(): void;
@@ -68,6 +89,10 @@ export declare class InteractComponent extends RendererComponent {
     getHitTestParams: (force?: boolean) => HitTestTriangleParams | void;
     getBoundingBox(): BoundingBoxTriangle | void;
     fromData(data: spec.InteractContent): void;
+    /**
+     * 是否可以交互
+     * @returns
+     */
     canInteract(): boolean;
     /**
      * 检查滑动手势边界

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

@@ -1,6 +1,5 @@
 import type * as spec from '@galacean/effects-specification';
 import type { Engine } from '../../engine';
-import type { MeshRendererOptions } from '../../render';
 import { Mesh } from '../../render';
 import type { Transform } from '../../transform';
 export declare class InteractMesh {
@@ -8,7 +7,7 @@ export declare class InteractMesh {
     private readonly engine;
     mesh: Mesh;
     private readonly color;
-    constructor(props: spec.InteractContent, rendererOptions: MeshRendererOptions, transform: Transform, engine: Engine);
+    constructor(props: spec.InteractContent, transform: Transform, engine: Engine);
     updateMesh(): void;
     private createMaterial;
     private createGeometry;

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

@@ -41,7 +41,7 @@ export declare class ComponentTimePlayable extends Playable {
 export declare class SpriteComponent extends MaskableGraphic {
     time: number;
     duration: number;
-    frameAnimationLoop: boolean;
+    loop: boolean;
     protected textureSheetAnimation?: spec.TextureSheetAnimation;
     constructor(engine: Engine, props?: spec.SpriteComponentData);
     onUpdate(dt: number): void;

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

@@ -26,6 +26,7 @@ export declare class TextComponent extends MaskableGraphic {
     protected readonly ALPHA_FIX_VALUE: number;
     constructor(engine: Engine, props?: spec.TextComponentData);
     onUpdate(dt: number): void;
+    onDestroy(): void;
     fromData(data: spec.TextComponentData): void;
     updateWithOptions(options: spec.TextContentOptions): void;
     updateTexture(flipY?: boolean): void;
@@ -161,6 +162,7 @@ export declare class TextComponentBase {
      * @returns
      */
     updateTexture(flipY?: boolean): void;
+    protected disposeTextTexture(): void;
     private getFontDesc;
     private setupOutline;
     private setupShadow;

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

@@ -6,6 +6,10 @@ export declare class TextLayout {
     letterSpace: number;
     lineGap: number;
     overflow: spec.TextOverflow;
+    /**
+     * 兼容旧版富文本的排版方式
+     */
+    useLegacyRichText: boolean;
     width: number;
     height: number;
     /**
@@ -28,6 +32,14 @@ export declare class TextLayout {
      */
     getOffsetY(style: TextStyle, lineCount: number, lineHeight: number, fontSize: number): number;
     getOffsetX(style: TextStyle, maxWidth: number): number;
+    /**
+     * 富文本垂直对齐计算
+     * @param style - 字体样式
+     * @param lineHeights - 每行高度数组
+     * @param fontSize - 字体大小
+     * @returns 第一行基线的 Y 坐标
+     */
+    getOffsetYRich(style: TextStyle, lineHeights: number[], fontSize: number): number;
     /**
      * 设置文本框的宽度和高度
      * @param width 文本框宽度

package/dist/render/index.d.ts

@@ -5,7 +5,6 @@ export * from './render-pass';
 export * from './shader';
 export * from './gpu-capability';
 export * from './mesh';
-export * from './types';
 export * from './geometry';
 export * from './framebuffer';
 export * from './renderer';

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

@@ -185,14 +185,6 @@ export declare class RenderFrame implements Disposable {
      */
     readonly semantics: SemanticMap;
     readonly globalUniforms: GlobalUniforms;
-    /**
-     * 空纹理，大小1x1，白色
-     */
-    readonly emptyTexture: Texture;
-    /**
-     * 空纹理，大小1x1，透明
-     */
-    readonly transparentTexture: Texture;
     protected destroyed: boolean;
     protected renderPassInfoMap: WeakMap<RenderPass, RenderPassInfo>;
     private drawObjectPass;

package/dist/texture/texture.d.ts

@@ -79,10 +79,6 @@ export declare abstract class Texture extends EffectsObject {
      * @param options - 创建 Texture 选项
      */
     abstract updateSource(options: TextureSourceOptions): void;
-    /**
-     * 销毁当前资源。
-     */
-    abstract dispose(): void;
     /**
      * 初始化 GPU 资源
      * @override

package/dist/vfx-item.d.ts

@@ -5,22 +5,20 @@ import { Composition } from './composition';
 import { EffectsObject } from './effects-object';
 import type { Engine } from './engine';
 import type { EventEmitterListener, EventEmitterOptions, ItemEvent } from './events';
-import type { BoundingBoxData, CameraController, HitTestBoxParams, HitTestCustomParams, HitTestSphereParams, HitTestTriangleParams, InteractComponent, SpriteComponent } from './plugins';
-import { ParticleSystem } from './plugins';
+import type { BoundingBoxData, HitTestBoxParams, HitTestCustomParams, HitTestSphereParams, HitTestTriangleParams } from './plugins';
 import { Transform } from './transform';
 import type { Constructor, Disposable } from './utils';
-export type VFXItemContent = ParticleSystem | SpriteComponent | CameraController | InteractComponent | undefined | {};
-export type VFXItemConstructor = new (engine: Engine, props: spec.Item, composition: Composition) => VFXItem;
 /**
- * 所有元素的继承的抽象类
+ * VFX 元素，包含元素的变换、组件、子元素等信息。
  */
 export declare class VFXItem extends EffectsObject implements Disposable {
     /**
-     * 元素绑定的父元素，
-     * 1. 当元素没有绑定任何父元素时，parent为空，transform.parentTransform 为 composition.transform
-     * 2. 当元素绑定 nullItem 时，parent 为 nullItem, transform.parentTransform 为 nullItem.transform
+     * 元素绑定的父元素
      */
     parent?: VFXItem;
+    /**
+     * 元素的子元素列表
+     */
     children: VFXItem[];
     /**
      * 元素的变换包含位置、旋转、缩放。
@@ -38,10 +36,6 @@ export declare class VFXItem extends EffectsObject implements Disposable {
      * 父元素的 id
      */
     parentId?: string;
-    /**
-     * 元素动画的开始时间
-     */
-    start: number;
     /**
      * 元素动画结束时行为（如何处理元素）
      */
@@ -52,12 +46,9 @@ export declare class VFXItem extends EffectsObject implements Disposable {
     name: string;
     /**
      * 元素 id 唯一
+     * @deprecated 2.7.0 Please use `getInstanceId` instead
      */
     id: string;
-    /**
-     * 元素创建的数据图层/粒子/模型等
-     */
-    _content?: VFXItemContent;
     type: spec.ItemType;
     props: spec.VFXItemData;
     components: Component[];
@@ -126,10 +117,6 @@ export declare class VFXItem extends EffectsObject implements Disposable {
      * @param props
      */
     constructor(engine: Engine, props?: spec.Item);
-    /**
-     * 返回元素创建的数据
-     */
-    get content(): VFXItemContent;
     /**
      * 获取元素的合成
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/effects-core",
-  "version": "2.7.0-alpha.1",
+  "version": "2.7.0-beta.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.6.0-alpha.1",
+    "@galacean/effects-specification": "2.6.0",
     "@galacean/effects-math": "1.1.0",
     "flatbuffers": "24.3.25",
     "uuid": "9.0.1",

package/dist/render/types.d.ts

@@ -1,5 +0,0 @@
-import type { Texture } from '../texture';
-export interface MeshRendererOptions {
-    emptyTexture: Texture;
-    cachePrefix: string;
-}