@galacean/engine-core 2.0.0-alpha.41 → 2.0.0-alpha.44

package/package.json

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

package/types/Entity.d.ts

@@ -136,8 +136,8 @@ export declare class Entity extends EngineObject {
      */
     clearChildren(): void;
     /**
-     * Clone this entity include children and components.
-     * @returns Cloned entity
+     * Clone this Entity, including children and components.
+     * @returns A detached clone that must be added to a parent Entity or Scene to update and render
      */
     clone(): Entity;
     /**

package/types/Script.d.ts

@@ -130,6 +130,7 @@ export declare class Script extends Component {
      * Called at the end of the destroyed frame.
      */
     onDestroy(): void;
+    private _hasCollisionEventCallbacks;
 }
 export declare enum PointerMethods {
     onPointerDown = "onPointerDown",

package/types/asset/LoadItem.d.ts

@@ -29,7 +29,7 @@ export type LoadItem = {
     params?: Record<string, any>;
 } & PickOnlyOne<{
     /**
-     * Loading url.
+     * URL of the resource to load.
      */
     url: string;
     /**

package/types/asset/ResourceManager.d.ts

@@ -60,7 +60,7 @@ export declare class ResourceManager {
     load<T extends EngineObject>(path: string): AssetPromise<T>;
     /**
      * Get the resource from cache by asset url, return the resource object if it loaded, otherwise return null.
-     * @param url - Resource url
+     * @param url - Resource URL
      * @returns Resource object
      */
     getFromCache<T>(url: string): T;
@@ -82,12 +82,12 @@ export declare class ResourceManager {
     cancelNotLoaded(): void;
     /**
      * Cancel assets whose url has not finished loading.
-     * @param url - Resource url
+     * @param url - Resource URL
      */
     cancelNotLoaded(url: string): void;
     /**
      * Cancel the incompletely loaded assets in urls.
-     * @param urls - Resource urls
+     * @param urls - Resource URLs
      */
     cancelNotLoaded(urls: string[]): void;
     /**
@@ -107,6 +107,8 @@ export declare class ResourceManager {
     private _createSubAssetPromiseCallback;
     private _gc;
     private _getResolveResource;
+    private _getLoadingKey;
+    private _getRemoteAssetURL;
     private _parseURL;
     private _parseQueryPath;
     private _releaseSubAssetPromiseCallback;

package/types/mesh/PrimitiveMesh.d.ts

@@ -40,10 +40,10 @@ export declare class PrimitiveMesh {
      */
     static createCuboid(engine: Engine, width?: number, height?: number, depth?: number, noLongerAccessible?: boolean): ModelMesh;
     /**
-     * Create a plane mesh.
+     * Create a plane mesh with U mapped along local +X and V along local +Z.
      * @param engine - Engine
-     * @param width - Plane width
-     * @param height - Plane height
+     * @param width - Plane width along the local X axis
+     * @param height - Plane height along the local Z axis
      * @param horizontalSegments - Plane horizontal segments
      * @param verticalSegments - Plane vertical segments
      * @param noLongerAccessible - No longer access the vertices of the mesh after creation

package/types/particle/modules/CustomDataModule.d.ts

@@ -73,6 +73,10 @@ export declare class CustomDataModule extends ParticleGeneratorModule {
      * @param name - The name passed to {@link addGradient}
      */
     removeGradient(name: string): void;
+    /**
+     * Remove all custom data streams.
+     */
+    clear(): void;
     private _uploadCurveStream;
     private _uploadGradientStream;
     private _zeroCurveUniforms;

package/types/particle/modules/SubEmittersModule.d.ts

@@ -31,6 +31,10 @@ export declare class SubEmittersModule extends ParticleGeneratorModule {
      * @param index - Index of the sub-emitter to remove
      */
     removeSubEmitterByIndex(index: number): void;
+    /**
+     * Remove all sub-emitter slots.
+     */
+    clear(): void;
     get enabled(): boolean;
     set enabled(value: boolean);
 }

package/types/physics/Collider.d.ts

@@ -24,6 +24,7 @@ export declare class Collider extends Component implements ICloneHook<Collider>
     set collisionLayer(value: Layer);
     /**
      * Add collider shape on this collider.
+     * @remarks If the shape belongs to another Collider, it is moved to this Collider.
      * @param shape - Collider shape
      */
     addShape(shape: ColliderShape): void;

package/types/physics/DynamicCollider.d.ts

@@ -109,7 +109,9 @@ export declare class DynamicCollider extends Collider {
     get constraints(): DynamicColliderConstraints;
     set constraints(value: DynamicColliderConstraints);
     /**
-     * The colliders' collision detection mode.
+     * The collision detection mode.
+     * @remarks With the PhysX backend, Continuous and ContinuousDynamic are mapped to speculative CCD while the collider
+     * is kinematic.
      */
     get collisionDetectionMode(): CollisionDetectionMode;
     set collisionDetectionMode(value: CollisionDetectionMode);

package/types/physics/PhysicsScene.d.ts

@@ -16,6 +16,7 @@ export declare class PhysicsScene {
     private _colliders;
     private _gravity;
     private _nativePhysicsScene;
+    private _contactEventConsumerCount;
     /**
      * The gravity of physics scene.
      */