@galacean/engine-core 1.6.13 → 2.0.0-alpha.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/engine-core",
-  "version": "1.6.13",
+  "version": "2.0.0-alpha.1",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
@@ -18,10 +18,10 @@
     "types/**/*"
   ],
   "dependencies": {
-    "@galacean/engine-math": "1.6.13"
+    "@galacean/engine-math": "2.0.0-alpha.1"
   },
   "devDependencies": {
-    "@galacean/engine-design": "1.6.13"
+    "@galacean/engine-design": "2.0.0-alpha.1"
   },
   "scripts": {
     "b:types": "tsc"

package/types/animation/Animator.d.ts

@@ -134,6 +134,8 @@ export declare class Animator extends Component {
     private _preparePlayOwner;
     private _applyStateTransitions;
     private _checkNoExitTimeTransition;
+    private _checkCrossFadeInterrupt;
+    private _checkNoExitTimeTransitions;
     private _checkSubTransition;
     private _checkBackwardsSubTransition;
     private _applyTransitionsByCondition;

package/types/audio/AudioManager.d.ts

@@ -5,10 +5,13 @@ export declare class AudioManager {
     private static _context;
     private static _gainNode;
     private static _resumePromise;
+    private static _needsUserGestureResume;
     /**
      * Resume the audio context.
      * @remarks On iOS Safari, calling this within a user gesture (e.g., click/touch event handler) can pre-unlock audio and reduce playback delay.
      * @returns A promise that resolves when the audio context is resumed
      */
     static resume(): Promise<void>;
+    private static _onVisibilityChange;
+    private static _resumeAfterInterruption;
 }

package/types/material/EffectMaterial.d.ts

@@ -0,0 +1,36 @@
+import { Color } from "@galacean/engine-math";
+import { Engine } from "../Engine";
+import { Shader } from "../shader";
+import { Texture2D } from "../texture";
+import { BaseMaterial } from "./BaseMaterial";
+/**
+ * Base material for visual effects like particles and trails.
+ */
+export declare class EffectMaterial extends BaseMaterial {
+    /**
+     * Base color.
+     */
+    get baseColor(): Color;
+    set baseColor(value: Color);
+    /**
+     * Base texture.
+     */
+    get baseTexture(): Texture2D;
+    set baseTexture(value: Texture2D);
+    /**
+     * Emissive color.
+     */
+    get emissiveColor(): Color;
+    set emissiveColor(value: Color);
+    /**
+     * Emissive texture.
+     */
+    get emissiveTexture(): Texture2D;
+    set emissiveTexture(value: Texture2D);
+    /**
+     * Create an effect material instance.
+     * @param engine - Engine to which the material belongs
+     * @param shader - Shader used by the material
+     */
+    constructor(engine: Engine, shader: Shader);
+}

package/types/particle/ParticleMaterial.d.ts

@@ -1,33 +1,11 @@
-import { Color } from "@galacean/engine-math";
 import { Engine } from "../Engine";
-import { BaseMaterial } from "../material/BaseMaterial";
-import { Texture2D } from "../texture/Texture2D";
+import { EffectMaterial } from "../material/EffectMaterial";
 /**
  * Particle Material.
  */
-export declare class ParticleMaterial extends BaseMaterial {
+export declare class ParticleMaterial extends EffectMaterial {
     /**
-     * Base color.
-     */
-    get baseColor(): Color;
-    set baseColor(value: Color);
-    /**
-     * Base texture.
-     */
-    get baseTexture(): Texture2D;
-    set baseTexture(value: Texture2D);
-    /**
-     * Emissive color.
-     */
-    get emissiveColor(): Color;
-    set emissiveColor(value: Color);
-    /**
-     * Emissive texture.
-     */
-    get emissiveTexture(): Texture2D;
-    set emissiveTexture(value: Texture2D);
-    /**
-     * Create a unlit material instance.
+     * Create a particle material instance.
      * @param engine - Engine to which the material belongs
      */
     constructor(engine: Engine);

package/types/physics/DynamicCollider.d.ts

@@ -1,5 +1,6 @@
 import { Quaternion, Vector3 } from "@galacean/engine-math";
 import { Collider } from "./Collider";
+import { ColliderShape } from "./shape/ColliderShape";
 /**
  * A dynamic collider can act with self-defined movement or physical force.
  */
@@ -151,6 +152,10 @@ export declare class DynamicCollider extends Collider {
      * Forces a collider to wake up.
      */
     wakeUp(): void;
+    /**
+     * @inheritdoc
+     */
+    addShape(shape: ColliderShape): void;
     protected _syncNative(): void;
     private _setMassAndUpdateInertia;
     private _setLinearVelocity;

package/types/physics/shape/MeshColliderShape.d.ts

@@ -0,0 +1,59 @@
+import { Mesh } from "../../graphic/Mesh";
+import { ColliderShape } from "./ColliderShape";
+/**
+ * Physical collider shape for mesh.
+ * @remarks
+ * - Triangle mesh (isConvex=false) works with StaticCollider or kinematic DynamicCollider
+ * - Convex mesh (isConvex=true) works with both StaticCollider and DynamicCollider
+ * @see https://nvidia-omniverse.github.io/PhysX/physx/5.4.1/docs/Geometry.html#triangle-meshes
+ */
+export declare class MeshColliderShape extends ColliderShape {
+    private _isConvex;
+    private _vertices;
+    private _indices;
+    private _doubleSided;
+    private _tightBounds;
+    private _indicesU16Cache;
+    /**
+     * Whether to use convex mesh mode.
+     * @remarks
+     * - Convex mesh: Works with all collider types, PhysX auto-computes convex hull
+     * - Triangle mesh: Works with StaticCollider or kinematic DynamicCollider, requires indices
+     * - After changing this property, you must call {@link setMesh} or {@link setMeshData} again to apply the change
+     */
+    get isConvex(): boolean;
+    set isConvex(value: boolean);
+    /**
+     * Whether the triangle mesh should be double-sided for collision detection.
+     * @remarks Only applies to triangle mesh (non-convex).
+     */
+    get doubleSided(): boolean;
+    set doubleSided(value: boolean);
+    /**
+     * Whether to use tight bounds for convex mesh.
+     * @remarks Only applies to convex mesh.
+     */
+    get tightBounds(): boolean;
+    set tightBounds(value: boolean);
+    /**
+     * Create a MeshColliderShape.
+     * @param isConvex - Whether to use convex mesh mode (default: false)
+     */
+    constructor(isConvex?: boolean);
+    /**
+     * Set mesh data directly from arrays.
+     * @param vertices - Vertex positions as Float32Array (x, y, z per vertex)
+     * @param indices - Triangle indices (required for triangle mesh, optional for convex)
+     */
+    setMeshData(vertices: Float32Array, indices?: Uint16Array | Uint32Array): void;
+    /**
+     * Set mesh data from a Mesh object.
+     * @param mesh - The mesh to extract vertex and index data from
+     * @remarks The mesh must have accessible data (not released after upload)
+     */
+    setMesh(mesh: Mesh): void;
+    protected _syncNative(): void;
+    private _extractMeshData;
+    private _extractIndices;
+    private _updateNativeMesh;
+}

package/types/physics/shape/index.d.ts

@@ -3,3 +3,4 @@ export { BoxColliderShape } from "./BoxColliderShape";
 export { SphereColliderShape } from "./SphereColliderShape";
 export { PlaneColliderShape } from "./PlaneColliderShape";
 export { CapsuleColliderShape } from "./CapsuleColliderShape";
+export { MeshColliderShape } from "./MeshColliderShape";

package/types/trail/TrailMaterial.d.ts

@@ -1,5 +1,16 @@
 import { Engine } from "../Engine";
-import { Material } from "../material/Material";
-export declare class TrailMaterial extends Material {
+import { EffectMaterial } from "../material/EffectMaterial";
+/**
+ * Trail material.
+ */
+export declare class TrailMaterial extends EffectMaterial {
+    /**
+     * Create a trail material instance.
+     * @param engine - Engine to which the material belongs
+     */
     constructor(engine: Engine);
+    /**
+     * @inheritdoc
+     */
+    clone(): TrailMaterial;
 }

package/types/trail/TrailRenderer.d.ts

@@ -1,35 +1,92 @@
-import { Entity } from "../Entity";
-import { MeshRenderer } from "../mesh/MeshRenderer";
-import { Texture2D } from "../texture";
+import { BoundingBox } from "@galacean/engine-math";
+import { RenderContext } from "../RenderPipeline/RenderContext";
+import { Renderer } from "../Renderer";
+import { ParticleCurve } from "../particle/modules/ParticleCurve";
+import { ParticleGradient } from "../particle/modules/ParticleGradient";
+import { TrailTextureMode } from "./enums/TrailTextureMode";
 /**
- * @deprecated
+ * Trail Renderer Component.
+ * Renders a trail behind a moving object.
  */
-export declare class TrailRenderer extends MeshRenderer {
-    private _vertexStride;
-    private _vertices;
+export declare class TrailRenderer extends Renderer {
+    private static readonly VERTEX_STRIDE;
+    private static readonly VERTEX_FLOAT_STRIDE;
+    private static readonly DISTANCE_OFFSET;
+    private static readonly POINT_FLOAT_STRIDE;
+    private static readonly POINT_BYTE_STRIDE;
+    private static readonly POINT_INCREASE_COUNT;
+    private static _trailParamsProp;
+    private static _distanceParamsProp;
+    private static _widthCurveProp;
+    private static _colorKeysProp;
+    private static _alphaKeysProp;
+    private static _curveMaxTimeProp;
+    private static _tempVector3;
+    /** Whether the trail is being created as the object moves. */
+    emitting: boolean;
+    /** The minimum distance the object must move before a new trail segment is added, in world units. */
+    minVertexDistance: number;
+    /** The curve describing the trail width from start to end. */
+    widthCurve: ParticleCurve;
+    /** The gradient describing the trail color from start to end. */
+    colorGradient: ParticleGradient;
+    private _trailParams;
+    private _distanceParams;
+    private _curveMaxTime;
+    private _time;
+    private _primitive;
+    private _mainSubPrimitive;
+    private _wrapSubPrimitive;
     private _vertexBuffer;
-    private _stroke;
-    private _minSeg;
-    private _lifetime;
-    private _maxPointNum;
-    private _points;
-    private _pointStates;
-    private _strapPoints;
-    private _curPointNum;
-    private _prePointsNum;
+    private _vertices;
+    private _firstActiveElement;
+    private _firstNewElement;
+    private _firstFreeElement;
+    private _firstRetiredElement;
+    private _currentPointCapacity;
+    private _bufferResized;
+    private _lastPosition;
+    private _hasLastPosition;
+    private _cumulativeDistance;
+    private _playTime;
+    private _lastPlayTimeUpdateFrameCount;
+    /**
+     * How long the trail takes to fade out, in seconds.
+     */
+    get time(): number;
+    set time(value: number);
+    /**
+     * The width of the trail.
+     */
+    get width(): number;
+    set width(value: number);
+    /**
+     * The texture mapping mode for the trail.
+     */
+    get textureMode(): TrailTextureMode;
+    set textureMode(value: TrailTextureMode);
     /**
-     * @deprecated
+     * The texture scale when using Tile texture mode.
      */
-    constructor(entity: Entity, props: any);
+    get textureScale(): number;
+    set textureScale(value: number);
     /**
-     * @deprecated
-     * Set trail texture.
-     * @param texture
+     * Clear all trail points.
      */
-    setTexture(texture: Texture2D): void;
+    clear(): void;
+    protected _update(context: RenderContext): void;
+    protected _render(context: RenderContext): void;
+    protected _updateBounds(worldBounds: BoundingBox): void;
+    private _mergePointPosition;
+    protected _onDestroy(): void;
+    private _updateAndGetPlayTime;
     private _initGeometry;
-    private _updateStrapVertices;
-    private _updateStrapCoords;
-    private _projectOnVector;
-    private _projectOnPlane;
+    private _resizeBuffer;
+    private _retireActivePoints;
+    private _freeRetiredPoints;
+    private _emitNewPoint;
+    private _addPoint;
+    private _getActivePointCount;
+    private _addActivePointsToVertexBuffer;
+    private _addSubRenderElement;
 }

package/types/trail/enums/TrailTextureMode.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Texture mapping mode for trails.
+ */
+export declare enum TrailTextureMode {
+    /** Map the texture once along the entire length of the trail. */
+    Stretch = 0,
+    /** Repeat the texture along the trail based on its length in world units. */
+    Tile = 1
+}

package/types/trail/index.d.ts

@@ -1,2 +1,3 @@
 export { TrailRenderer } from "./TrailRenderer";
 export { TrailMaterial } from "./TrailMaterial";
+export { TrailTextureMode } from "./enums/TrailTextureMode";