feat(effectScope): add onDispose method

packages/reactivity/__tests__/effectScope.spec.ts

@@ -322,4 +322,15 @@ describe('reactivity/effect/scope', () => {
     scope.resume()
     expect(fnSpy).toHaveBeenCalledTimes(3)
   })
+
+  it('should register a cleanup function to be called when the effect scope is stopped', () => {
+    const spy = vi.fn()
+
+    const scope = effectScope()
+    scope.onDispose(spy)
+
+    expect(spy).toHaveBeenCalledTimes(0)
+    scope.stop()
+    expect(spy).toHaveBeenCalledTimes(1)
+  })
 })

packages/reactivity/src/effectScope.ts

@@ -140,6 +140,15 @@
       this._active = false
     }
   }
+
+  /**
+   * Registers a cleanup function to be called when the effect scope is stopped.
+   *
+   * @param {() => void} fn - The cleanup function to be registered.
+   */
+  onDispose(fn: () => void) {
+    this.cleanups.push(fn)
+  }
 }
 
 /**
@@ -173,7 +182,7 @@
  */
 export function onScopeDispose(fn: () => void, failSilently = false): void {
   if (activeEffectScope) {
-    activeEffectScope.cleanups.push(fn)
+    activeEffectScope.onDispose(fn)
   } else if (__DEV__ && !failSilently) {
     warn(
       `onScopeDispose() is called when there is no active effect scope` +