first commit

claude-code源码-中文注释/src/hooks/useVirtualScroll.ts

@@ -0,0 +1,34 @@
+import { type DOMElement, useAnimationFrame, useTerminalFocus } from '../ink.js'
+
+const BLINK_INTERVAL_MS = 600
+
+/**
+ * 用于同步闪烁动画的 Hook，在屏幕外时暂停。
+ *
+ * 返回要附加到动画元素的 ref 和当前闪烁状态。
+ * 所有实例一起闪烁，因为它们从相同的动画时钟派生状态。
+ * 时钟仅在至少一个订阅者可见时运行。
+ * 终端模糊时暂停。
+ *
+ * @param enabled - 闪烁是否激活
+ * @returns [ref, isVisible] - 附加到元素的 ref，在闪烁周期中可见时为 true
+ *
+ * @example
+ * function BlinkingDot({ shouldAnimate }) {
+ *   const [ref, isVisible] = useBlink(shouldAnimate)
+ *   return <Box ref={ref}>{isVisible ? '●' : ' '}</Box>
+ * }
+ */
+export function useBlink(
+  enabled: boolean,
+  intervalMs: number = BLINK_INTERVAL_MS,
+): [ref: (element: DOMElement | null) => void, isVisible: boolean] {
+  const focused = useTerminalFocus()
+  const [ref, time] = useAnimationFrame(enabled && focused ? intervalMs : null)
+
+  if (!enabled || !focused) return [ref, true]
+
+  // 从时间派生闪烁状态 - 所有实例看到相同的时间所以它们同步
+  const isVisible = Math.floor(time / intervalMs) % 2 === 0
+  return [ref, isVisible]
+}