docs: 3.5: watch deep support number (#2276)

* doc: update WatchOptions deep property to accept a number value

* feat: Add support for deep option in watchers

* feat: Improve Japanese translation for deep option in watchers

* feat: Update deep option in watchers to support specifying the maximum search depth

* Update src/guide/essentials/watchers.md

Co-authored-by: Jun Shindo <[email protected]>

---------

Co-authored-by: Jun Shindo <[email protected]>

Author: naokihaba

src/api/reactivity-core.md

@@ -403,7 +403,7 @@
 
   interface WatchOptions extends WatchEffectOptions {
     immediate?: boolean // 初期値: false
-    deep?: boolean // 初期値: false
+    deep?: boolean | number // 初期値: false
     flush?: 'pre' | 'post' | 'sync' // 初期値: 'pre'
     onTrack?: (event: DebuggerEvent) => void
     onTrigger?: (event: DebuggerEvent) => void
@@ -438,7 +438,7 @@
   省略可能な第 3 引数は、以下のオプションをサポートするオプションオブジェクトです:
 
   - **`immediate`**: ウォッチャーが作成されたら、すぐにコールバックを起動します。最初の呼び出しでは、古い値は `undefined` になります。
-  - **`deep`**: オブジェクトの場合、深い変更の際にコールバックが発生するように、ソースの深い探索を強制します。詳しくは[ディープ・ウォッチャー](/guide/essentials/watchers#deep-watchers)をご参照ください。
+  - **`deep`**: オブジェクトの場合、深い変更の際にコールバックが発生するように、ソースの深い探索を強制します。3.5+ では、どこまで深くオブジェクトを監視するかを数値で指定することもできます。詳しくは[ディープ・ウォッチャー](/guide/essentials/watchers#deep-watchers)をご参照ください。
   - **`flush`**: コールバックのフラッシュタイミングを調整します。詳しくは[コールバックが実行されるタイミング](/guide/essentials/watchers#callback-flush-timing)や [`watchEffect()`](/api/reactivity-core#watcheffect) をご参照ください。
   - **`onTrack / onTrigger`**: ウォッチャーの依存関係をデバッグします。詳しくは[ウォッチャーのデバッグ](/guide/extras/reactivity-in-depth#watcher-debugging)をご参照ください。
   - **`once`**: コールバックを一度だけ実行します。最初のコールバックが実行されると、ウォッチャーは自動的に停止します。<sup class="vt-badge" data-text="3.4+" />

src/guide/essentials/watchers.md

@@ -224,6 +224,8 @@ watch(
 
 </div>
 
+Vue 3.5+ では、`deep` オプションは、最大探索深度を示す数値、つまり、Vue がオブジェクトのネストしたプロパティを何階層まで探索するかを示す数値も指定可能です。
+
 :::warning  使用上の注意
 deep watch は、監視対象のオブジェクトのネストされた全てのプロパティをトラバースする必要があるため、大きなデータ構造で使用するときにはコストが高くなります。使用するときは、どうしても必要なときにだけ使用し、パフォーマンスへの影響に注意しましょう。
 :::