add Clip utilities dosc

Author: bea4dev

docs/docs/lib/components.md

@@ -65,6 +65,43 @@ Chains multiple `<Clip>` on a single lane. Start positions are calculated automa
 </ClipSequence>
 ```
 
+### Clip utilities
+
+#### `useClipStart()`
+Returns the start frame of the current clip.
+
+```tsx
+const start = useClipStart()
+```
+
+#### `useClipRange()`
+Returns the frame range of the current clip.
+
+```tsx
+const range = useClipRange()
+const start = range.start
+const end   = range.end
+```
+
+#### `useClipId()`
+Returns the current clip ID.
+
+```tsx
+const id = useClipId()
+```
+
+#### `useClipDepth()`
+Returns the nesting depth of the current clip.
+```tsx
+const depth = useClipDepth()
+```
+
+#### `useClipActive()`
+Returns true when the current clip is active and visible.
+```tsx
+const active = useClipActive()
+```
+
 ### `<ClipStatic>`
 
 Explicit start/end clip. Useful when you need strict boundaries.

docs/i18n/ja/docusaurus-plugin-content-docs/current/lib/components.md

@@ -65,6 +65,43 @@ export const PROJECT = () => (
 </ClipSequence>
 ```
 
+### Clip utilities
+
+#### `useClipStart()`
+現在のクリップの開始フレームを返します。
+
+```tsx
+const start = useClipStart()
+```
+
+#### `useClipRange()`
+現在のクリップの範囲を返します
+
+```tsx
+const range = useClipRange()
+const start = range.start
+const end   = range.end
+```
+
+#### `useClipId()`
+現在のクリップ ID を返します。
+
+```tsx
+const id = useClipId()
+```
+
+#### `useClipDepth()`
+現在のクリップのネスト深度を返します。
+```tsx
+const depth = useClipDepth()
+```
+
+#### `useClipActive()`
+現在のクリップがアクティブかつ表示中なら true を返します。
+```tsx
+const active = useClipActive()
+```
+
 ### `<ClipStatic>`
 
 表示する期間を明示できる静的クリップ。境界を厳密に制御したい場合に使います。