@galacean/engine-core 2.0.0-alpha.14 → 2.0.0-alpha.16

package/package.json

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

package/types/Renderer.d.ts

@@ -3,7 +3,6 @@ import { Component } from "./Component";
 import { Entity } from "./Entity";
 import { RenderContext } from "./RenderPipeline/RenderContext";
 import { TransformModifyFlags } from "./Transform";
-import { IComponentCustomClone } from "./clone/ComponentCloner";
 import { SpriteMaskLayer } from "./enums/SpriteMaskLayer";
 import { Material } from "./material";
 import { ShaderData } from "./shader/ShaderData";
@@ -11,7 +10,7 @@ import { ShaderData } from "./shader/ShaderData";
  * Basis for all renderers.
  * @decorator `@dependentComponents(Transform, DependentMode.CheckOnly)`
  */
-export declare class Renderer extends Component implements IComponentCustomClone {
+export declare class Renderer extends Component {
     private static _tempVector0;
     private static _receiveShadowMacro;
     private static _localMatrixProperty;

package/types/Signal.d.ts

@@ -0,0 +1,58 @@
+import { Component } from "./Component";
+/**
+ * Signal is a typed event mechanism for Galacean Engine.
+ * @typeParam T - Tuple type of the signal arguments
+ */
+export declare class Signal<T extends any[] = []> {
+    private _listeners;
+    /**
+     * Add a listener for this signal.
+     * @param fn - The callback function
+     * @param target - The `this` context for the callback
+     */
+    on(fn: (...args: T) => void, target?: any): void;
+    /**
+     * Add a structured binding listener. Structured bindings support clone remapping.
+     * @param target - The target component
+     * @param methodName - The method name to invoke on the target
+     * @param args - Pre-resolved arguments
+     */
+    on(target: Component, methodName: string, ...args: any[]): void;
+    /**
+     * Add a one-time listener that is automatically removed after first invocation.
+     * @param fn - The callback function
+     * @param target - The `this` context for the callback
+     */
+    once(fn: (...args: T) => void, target?: any): void;
+    /**
+     * Add a one-time structured binding listener.
+     * @param target - The target component
+     * @param methodName - The method name to invoke on the target
+     * @param args - Pre-resolved arguments
+     */
+    once(target: Component, methodName: string, ...args: any[]): void;
+    /**
+     * Remove a listener. Both `fn` and `target` must match the values passed to `on`/`once`.
+     * @param fn - The callback function to remove
+     * @param target - The `this` context that was used when adding the listener
+     */
+    off(fn: (...args: T) => void, target?: any): void;
+    /**
+     * Remove a structured binding listener by target and method name.
+     * @param target - The target component
+     * @param methodName - The method name
+     */
+    off(target: Component, methodName: string): void;
+    /**
+     * Remove all listeners, or all listeners for a specific target.
+     * @param target - If provided, only remove listeners bound to this target
+     */
+    removeAll(target?: any): void;
+    /**
+     * Invoke the signal, calling all listeners in order.
+     * @param args - Arguments to pass to each listener
+     */
+    invoke(...args: T): void;
+    private _cloneArguments;
+    private _addListener;
+}

package/types/clone/CloneUtils.d.ts

@@ -0,0 +1 @@
+export {};

package/types/clone/ComponentCloner.d.ts

@@ -5,8 +5,6 @@ import { Entity } from "../Entity";
  */
 export interface ICustomClone {
 }
-export interface IComponentCustomClone {
-}
 export declare class ComponentCloner {
     /**
      * Clone component.

package/types/index.d.ts

@@ -8,6 +8,7 @@ export { SceneManager } from "./SceneManager";
 export { Entity } from "./Entity";
 export { Component } from "./Component";
 export { Script } from "./Script";
+export { Signal } from "./Signal";
 export { Renderer, RendererUpdateFlags } from "./Renderer";
 export { dependentComponents, DependentMode } from "./ComponentsDependencies";
 export { Camera } from "./Camera";
@@ -63,6 +64,7 @@ export * from "./env-probe/index";
 export * from "./shader/index";
 export * from "./Layer";
 export * from "./clone/CloneManager";
+export { CloneUtils } from "./clone/CloneUtils";
 export * from "./renderingHardwareInterface/index";
 export * from "./physics/index";
 export * from "./Utils";

package/types/mesh/Skin.d.ts

@@ -1,11 +1,10 @@
 import { Matrix } from "@galacean/engine-math";
 import { Entity } from "../Entity";
 import { EngineObject } from "../base/EngineObject";
-import { IComponentCustomClone } from "../clone/ComponentCloner";
 /**
  * Skin used for skinned mesh renderer.
  */
-export declare class Skin extends EngineObject implements IComponentCustomClone {
+export declare class Skin extends EngineObject {
     name: string;
     /** Inverse bind matrices. */
     inverseBindMatrices: Matrix[];