{"$schema":"https://ui.shadcn.com/schema/registry-item.json","name":"lock-on","type":"registry:ui","title":"Lock On","description":"A spinning reticle cursor whose corner brackets snap around any element you mark as a target.","dependencies":[],"registryDependencies":["utils"],"files":[{"path":"registry/ui/lock-on.tsx","type":"registry:ui","content":"\"use client\";\n\nimport { useEffect, useRef, type ReactNode } from \"react\";\nimport { cn } from \"@/lib/utils\";\n\nexport interface LockOnProps {\n  children: ReactNode;\n  /** Elements matching this selector get wrapped by the brackets. */\n  targetSelector?: string;\n  color?: string;\n  /** Degrees per second the idle reticle spins. */\n  spinSpeed?: number;\n  /** Idle reticle size in px. */\n  size?: number;\n  /** Px between a target and the brackets. */\n  padding?: number;\n  /** Hide the system cursor inside the container (mouse only). */\n  hideCursor?: boolean;\n  className?: string;\n}\n\nconst CSS = `@media (pointer: fine){.tc-hide,.tc-hide *{cursor:none!important}}`;\n// Idle offsets for the four brackets: top-left, top-right, bottom-right, bottom-left.\nconst DIRS = [\n  [-1, -1],\n  [1, -1],\n  [1, 1],\n  [-1, 1],\n];\n\nexport function LockOn({\n  children,\n  targetSelector = \"[data-cursor-target]\",\n  color = \"#ffffff\",\n  spinSpeed = 120,\n  size = 34,\n  padding = 8,\n  hideCursor = true,\n  className,\n}: LockOnProps) {\n  const root = useRef<HTMLDivElement>(null);\n  const layer = useRef<HTMLDivElement>(null);\n\n  useEffect(() => {\n    const el = root.current!;\n    const [dot, ...brackets] = Array.from(layer.current!.children) as HTMLElement[];\n    const reduced = window.matchMedia(\"(prefers-reduced-motion: reduce)\").matches;\n    const mouse = { x: 0, y: 0, inside: false, down: false };\n    const corners = DIRS.map(() => ({ x: 0, y: 0 }));\n    let target: Element | null = null;\n    let angle = 0;\n    let raf = 0;\n    let last = performance.now();\n    let fresh = true;\n\n    const frame = (now: number) => {\n      const dt = Math.min((now - last) / 1000, 0.05);\n      last = now;\n      const box = el.getBoundingClientRect();\n      let goals: { x: number; y: number }[];\n      if (target) {\n        // Settle on the nearest quarter turn, then hand each bracket the rect corner its rotation now faces.\n        const snap = Math.round(angle / 90) * 90;\n        angle += (snap - angle) * (reduced ? 1 : 0.2);\n        const q = (((snap / 90) % 4) + 4) % 4;\n        const r = target.getBoundingClientRect();\n        const pad = padding - (mouse.down ? 3 : 0);\n        const rect = [\n          { x: r.left - pad, y: r.top - pad },\n          { x: r.right + pad, y: r.top - pad },\n          { x: r.right + pad, y: r.bottom + pad },\n          { x: r.left - pad, y: r.bottom + pad },\n        ];\n        goals = DIRS.map((_, i) => ({ x: rect[(i + q) % 4].x - box.left, y: rect[(i + q) % 4].y - box.top }));\n      } else {\n        if (!reduced) angle += spinSpeed * dt;\n        const half = (size / 2) * (mouse.down ? 0.75 : 1);\n        const a = (angle * Math.PI) / 180;\n        const cos = Math.cos(a);\n        const sin = Math.sin(a);\n        goals = DIRS.map(([dx, dy]) => ({\n          x: mouse.x + (dx * cos - dy * sin) * half,\n          y: mouse.y + (dx * sin + dy * cos) * half,\n        }));\n      }\n      const ease = fresh || reduced ? 1 : target ? 0.22 : 0.35;\n      fresh = false;\n      corners.forEach((c, i) => {\n        c.x += (goals[i].x - c.x) * ease;\n        c.y += (goals[i].y - c.y) * ease;\n        brackets[i].style.transform = `translate(${c.x}px,${c.y}px) rotate(${angle + i * 90}deg)`;\n      });\n      dot.style.transform = `translate(${mouse.x}px,${mouse.y}px) translate(-50%,-50%) scale(${mouse.down ? 0.6 : 1})`;\n      raf = mouse.inside || target ? requestAnimationFrame(frame) : 0;\n    };\n    const start = () => {\n      if (!raf) {\n        last = performance.now();\n        raf = requestAnimationFrame(frame);\n      }\n    };\n    const show = (on: boolean) => {\n      layer.current!.style.opacity = on ? \"1\" : \"0\";\n    };\n    const find = (node: EventTarget | null) => {\n      const t = node instanceof Element ? node.closest(targetSelector) : null;\n      return t && el.contains(t) ? t : null;\n    };\n\n    const onMove = (e: PointerEvent) => {\n      if (e.pointerType !== \"mouse\") return;\n      const box = el.getBoundingClientRect();\n      mouse.x = e.clientX - box.left;\n      mouse.y = e.clientY - box.top;\n      if (!mouse.inside) fresh = true;\n      mouse.inside = true;\n      target = find(e.target);\n      show(true);\n      start();\n    };\n    const onLeave = () => {\n      mouse.inside = false;\n      target = null;\n      show(false);\n    };\n    const onDown = () => (mouse.down = true);\n    const onUp = () => (mouse.down = false);\n    // Keyboard users get the brackets on whatever target holds focus.\n    const onFocus = (e: FocusEvent) => {\n      const t = find(e.target);\n      if (!t || mouse.inside) return;\n      target = t;\n      fresh = !layer.current!.style.opacity || layer.current!.style.opacity === \"0\";\n      dot.style.opacity = \"0\";\n      show(true);\n      start();\n    };\n    const onBlur = () => {\n      if (mouse.inside) return;\n      target = null;\n      show(false);\n    };\n\n    el.addEventListener(\"pointermove\", onMove, { passive: true });\n    el.addEventListener(\"pointerleave\", onLeave);\n    el.addEventListener(\"pointerdown\", onDown);\n    el.addEventListener(\"pointerup\", onUp);\n    el.addEventListener(\"focusin\", onFocus);\n    el.addEventListener(\"focusout\", onBlur);\n    const restoreDot = () => (dot.style.opacity = \"\");\n    el.addEventListener(\"pointerenter\", restoreDot);\n    return () => {\n      cancelAnimationFrame(raf);\n      el.removeEventListener(\"pointermove\", onMove);\n      el.removeEventListener(\"pointerleave\", onLeave);\n      el.removeEventListener(\"pointerdown\", onDown);\n      el.removeEventListener(\"pointerup\", onUp);\n      el.removeEventListener(\"focusin\", onFocus);\n      el.removeEventListener(\"focusout\", onBlur);\n      el.removeEventListener(\"pointerenter\", restoreDot);\n    };\n  }, [targetSelector, spinSpeed, size, padding]);\n\n  const arm = Math.max(8, size * 0.32);\n  return (\n    <div ref={root} className={cn(\"relative\", hideCursor && \"tc-hide\", className)}>\n      {hideCursor && (\n        <style href=\"lock-on\" precedence=\"default\">\n          {CSS}\n        </style>\n      )}\n      {children}\n      <div\n        ref={layer}\n        aria-hidden\n        className=\"pointer-events-none absolute inset-0 z-50 overflow-visible\"\n        style={{ opacity: 0, transition: \"opacity .2s\" }}\n      >\n        <span\n          className=\"absolute left-0 top-0 size-1.5 rounded-full\"\n          style={{ background: color, boxShadow: `0 0 10px ${color}` }}\n        />\n        {DIRS.map((_, i) => (\n          <span\n            key={i}\n            className=\"absolute left-0 top-0\"\n            style={{\n              width: arm,\n              height: arm,\n              borderTop: `2px solid ${color}`,\n              borderLeft: `2px solid ${color}`,\n              transformOrigin: \"0 0\",\n              filter: `drop-shadow(0 0 4px ${color}66)`,\n            }}\n          />\n        ))}\n      </div>\n    </div>\n  );\n}\n"}]}