@feng3d/reactivity 1.0.7 → 1.0.9

package/dist/index.js

@@ -65,8 +65,14 @@ function noTrack(fn) {
 let _shouldTrack = true;
 function batch(dep, isRunning) {
   if (isRunning) {
+    if (_isRunedDeps.indexOf(dep) !== -1) {
+      return;
+    }
     _isRunedDeps.push(dep);
   } else {
+    if (_needEffectDeps.indexOf(dep) !== -1) {
+      return;
+    }
     _needEffectDeps.push(dep);
   }
 }
@@ -1620,8 +1626,89 @@ const toReactive = (value) => {
 function isProxy(value) {
   return value ? !!value[ReactiveFlags.RAW] : false;
 }
+class ReactiveObject {
+  constructor() {
+    this._effectScope = new EffectScope();
+    this._destroyCallbacks = [];
+  }
+  /**
+   * 创建并运行副作用
+   *
+   * 功能：
+   * 1. 将传入的函数包装为副作用
+   * 2. 自动收集副作用中访问的响应式属性作为依赖
+   * 3. 当依赖变化时自动重新执行副作用
+   * 4. 在类销毁时自动停止副作用
+   *
+   * 使用场景：
+   * - 监听属性变化并执行相应操作
+   * - 自动更新UI或重新计算派生状态
+   * - 执行清理或初始化逻辑
+   *
+   * @param fn 副作用函数，会在依赖变化时自动执行
+   *
+   * 使用示例：
+   * ```typescript
+   * this.effect(() => {
+   *   // 访问响应式属性，建立依赖关系
+   *   const value = reactive(this).someProperty;
+   *
+   *   // 执行相应的逻辑
+   *   this.updateUI(value);
+   * });
+   * ```
+   */
+  effect(fn) {
+    let eff;
+    this._effectScope.run(() => {
+      eff = effect(fn);
+    });
+    return eff;
+  }
+  /**
+   * 销毁时执行的函数
+   * @param callback 销毁时执行的函数
+   */
+  destroyCall(callback) {
+    this._destroyCallbacks.push(callback);
+  }
+  /**
+   * 销毁响应式类实例
+   *
+   * 执行清理操作：
+   * 1. 执行所有注册的清理函数
+   * 2. 停止所有副作用作用域，防止副作用继续执行
+   * 3. 清理引用，帮助垃圾回收，防止内存泄漏
+   *
+   * 重要：
+   * - 子类重写此方法时必须调用 super.destroy()
+   * - 确保在类实例不再使用时调用此方法
+   * - 调用后实例将无法再使用 effect() 方法
+   *
+   * 使用示例：
+   * ```typescript
+   * class MyClass extends ReactiveObject {
+   *   destroy() {
+   *     // 执行子类特定的清理逻辑
+   *     this.cleanup();
+   *
+   *     // 必须调用父类的destroy方法
+   *     super.destroy();
+   *   }
+   * }
+   * ```
+   */
+  destroy() {
+    var _a2, _b2;
+    (_a2 = this._destroyCallbacks) == null ? void 0 : _a2.forEach((item) => item());
+    this._destroyCallbacks = null;
+    (_b2 = this._effectScope) == null ? void 0 : _b2.stop();
+    this._effectScope = null;
+  }
+}
 export {
   EffectScope,
+  ReactiveObject,
   batchRun,
   computed,
   effect,