fix: 修复 useWatch 回调参数类型推导 & v1.1.1 发版

- 新增 UnwrapRefSimple 工具类型，自动解包 Ref/ComputedRef
- useWatch 回调参数类型由 T 改为 UnwrapRefSimple<T>
  - 当 source 为 useVRef(1) 时，回调参数自动推导为 number
- 升级 runtime-core 版本 v1.1.0 -> v1.1.1
- 更新 CHANGELOG

Author: smirk9581

packages/runtime-core/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.1] - 2026-04-26
+
+### Fixed
+
+- **修复 `useWatch` 回调参数类型推导**：当 `source` 为未解包的 `Ref` 时，回调参数能自动推导为解包后的类型
+
+---
+
+[1.1.1]: https://github.com/vureact-js/core/compare/v1.1.0...v1.1.1
+
+---
+
 ## [1.1.0] - 2026-04-17
 
 ### Added
@@ -229,7 +241,8 @@ When releasing a new version:
 ---
 
 ```
-[Unreleased]: https://github.com/vureact-js/core/compare/v1.1.0...HEAD
+[Unreleased]: https://github.com/vureact-js/core/compare/v1.1.1...HEAD
+[1.1.1]: https://github.com/vureact-js/core/compare/v1.1.0...v1.1.1
 [1.1.0]: https://github.com/vureact-js/core/compare/v1.0.1...v1.1.0
 [1.0.1]: https://github.com/vureact-js/core/compare/v1.0.0...v1.0.1
 [1.0.0]: https://github.com/vureact-js/core/compare/v1.0.0...HEAD

packages/runtime-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vureact/runtime-core",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "type": "module",
   "main": "./dist/cjs/runtime-core.js",
   "module": "./dist/esm/runtime-core.esm.js",
@@ -93,4 +93,4 @@
     "react": ">=18.2.0",
     "react-dom": ">=18.2.0"
   }
-}
+}

packages/runtime-core/src/adapter-hooks/effect/useWatch.ts

@@ -2,6 +2,8 @@ import { type DependencyList, RefObject, useCallback, useRef } from 'react';
 import isEqual from 'react-fast-compare';
 import { executeEffect } from '../shared/executeEffect';
 import type { Destructor, FlushTiming, OnCleanup } from '../shared/types';
+import type { ComputedRef } from '../state/useComputed';
+import type { WrapRef } from '../state/useVRef';
 import { unwrapRef } from '../state/useVRef';
 import { useFlushEffect } from './shared';
 
@@ -28,13 +30,34 @@ type ResolvedWatchSource<T> = {
   isMultiSource: boolean;
 };
 
+/**
+ * 解包 ref/computed 类型，提取其内部值类型。
+ * 如果 T 不是 ref/computed 类型，则返回 T 自身。
+ *
+ * - RefState<T> / WrapRef<T> → T
+ * - ComputedRef<T> → T
+ * - 其他类型 → T (原样)
+ */
+type UnwrapRefSimple<T> = T extends ComputedRef<infer U> ? U : T extends WrapRef<infer U> ? U : T;
+
 /**
  * React adapter for Vue's watch API (manual dependencies mode).
+ *
+ * 当 source 传入一个 ref（如 useVRef 或 useComputed 的返回值）且
+ * 没有手动通过 `.value` 解包时，回调参数会自动推导为解包后的值类型。
+ *
+ * @example
+ *
+ * const countRef = useVRef(1);  // RefState<number>
+ * useWatch(countRef, (newVal) => {
+ *   // newVal 被推导为 number（而非 RefState<number>）
+ * });
+ *
  * @see https://runtime.vureact.top/guide/hooks/watch.html
  */
 export function useWatch<T>(
   source: WatchSource<T>,
-  fn: WatchCallback<T, T>,
+  fn: WatchCallback<UnwrapRefSimple<T>, UnwrapRefSimple<T>>,
   options?: WatchOptions,
 ): WatchStopHandle {
   const callbackRef = useRef(fn);
@@ -90,7 +113,13 @@ export function useWatch<T>(
         initializedRef.current = true;
 
         if (options?.immediate) {
-          runAndRegisterCleanup(callbackRef.current, nextValue, undefined, cleanupRef, runCleanup);
+          runAndRegisterCleanup(
+            callbackRef.current,
+            nextValue as any,
+            undefined,
+            cleanupRef,
+            runCleanup,
+          );
 
           if (options?.once) {
             onceTriggeredRef.current = true;
@@ -119,7 +148,13 @@ export function useWatch<T>(
         return;
       }
 
-      runAndRegisterCleanup(callbackRef.current, nextValue, previousValue, cleanupRef, runCleanup);
+      runAndRegisterCleanup(
+        callbackRef.current,
+        nextValue as any,
+        previousValue as any,
+        cleanupRef,
+        runCleanup,
+      );
 
       currentValueRef.current = nextValue;