{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "use-pointer-position",
  "title": "usePointerPosition",
  "author": "VenusUI",
  "description": "Expose the pointer position over an element as CSS variables, without re-rendering.",
  "files": [
    {
      "path": "registry/default/hooks/use-pointer-position.ts",
      "content": "\"use client\"\n\nimport * as React from \"react\"\n\n/**\n * Tracks the pointer relative to an element and exposes it as CSS custom\n * properties, without causing React re-renders:\n *\n * - `--pointer-x` / `--pointer-y`: position in px from the element's top-left\n * - `--pointer-active`: `1` while the pointer is over the element, else `0`\n *\n * Updates are batched to at most one per animation frame.\n *\n * @returns a callback ref to attach to the element you want to track.\n */\nexport function usePointerPosition<T extends HTMLElement>(): React.RefCallback<T> {\n  return React.useCallback((node: T | null) => {\n    if (!node) return\n\n    let frame = 0\n    let clientX = 0\n    let clientY = 0\n\n    const write = () => {\n      frame = 0\n      const rect = node.getBoundingClientRect()\n      node.style.setProperty(\"--pointer-x\", `${clientX - rect.left}px`)\n      node.style.setProperty(\"--pointer-y\", `${clientY - rect.top}px`)\n    }\n\n    const onMove = (event: PointerEvent) => {\n      clientX = event.clientX\n      clientY = event.clientY\n      if (!frame) frame = requestAnimationFrame(write)\n    }\n\n    const onEnter = (event: PointerEvent) => {\n      onMove(event)\n      node.style.setProperty(\"--pointer-active\", \"1\")\n    }\n\n    const onLeave = () => {\n      node.style.setProperty(\"--pointer-active\", \"0\")\n    }\n\n    node.addEventListener(\"pointermove\", onMove, { passive: true })\n    node.addEventListener(\"pointerenter\", onEnter)\n    node.addEventListener(\"pointerleave\", onLeave)\n\n    return () => {\n      cancelAnimationFrame(frame)\n      node.removeEventListener(\"pointermove\", onMove)\n      node.removeEventListener(\"pointerenter\", onEnter)\n      node.removeEventListener(\"pointerleave\", onLeave)\n    }\n  }, [])\n}\n",
      "type": "registry:hook"
    }
  ],
  "meta": {
    "version": "0.1.0"
  },
  "categories": [
    "hooks",
    "interactive"
  ],
  "type": "registry:hook"
}