{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "scroll-progress",
  "title": "Scroll Progress",
  "author": "VenusUI",
  "description": "A thin bar that fills as the reader scrolls through a page or container.",
  "files": [
    {
      "path": "registry/default/ui/scroll-progress.tsx",
      "content": "\"use client\"\n\nimport * as React from \"react\"\n\nimport { cn } from \"@/lib/utils\"\n\ninterface ScrollProgressProps {\n  /** Element whose scroll to track. Defaults to the page. */\n  target?: React.RefObject<HTMLElement | null>\n  /** Accessible name. */\n  label?: string\n  className?: string\n}\n\n/**\n * A thin bar that fills as the reader scrolls through the page (or through\n * a scrollable element passed as `target`). Exposed as a labelled progress\n * bar. Updates at most once per frame and never re-renders on scroll.\n */\nfunction ScrollProgress({ target, label = \"Reading progress\", className }: ScrollProgressProps) {\n  const bar = React.useRef<HTMLDivElement>(null)\n\n  React.useEffect(() => {\n    const element = target?.current ?? null\n    const source: HTMLElement | Window = element ?? window\n    let frame = 0\n\n    const update = () => {\n      frame = 0\n      const node = bar.current\n      if (!node) return\n      const scrollTop = element ? element.scrollTop : window.scrollY\n      const max = element ? element.scrollHeight - element.clientHeight : document.documentElement.scrollHeight - window.innerHeight\n      const progress = max > 0 ? Math.min(Math.max(scrollTop / max, 0), 1) : 0\n      node.style.transform = `scaleX(${progress})`\n      node.parentElement?.setAttribute(\"aria-valuenow\", String(Math.round(progress * 100)))\n    }\n    const onScroll = () => {\n      if (!frame) frame = requestAnimationFrame(update)\n    }\n\n    update()\n    source.addEventListener(\"scroll\", onScroll, { passive: true })\n    window.addEventListener(\"resize\", onScroll)\n    return () => {\n      cancelAnimationFrame(frame)\n      source.removeEventListener(\"scroll\", onScroll)\n      window.removeEventListener(\"resize\", onScroll)\n    }\n  }, [target])\n\n  return (\n    <div\n      role=\"progressbar\"\n      aria-label={label}\n      aria-valuemin={0}\n      aria-valuemax={100}\n      aria-valuenow={0}\n      data-slot=\"scroll-progress\"\n      className={cn(\"h-1 w-full overflow-hidden bg-transparent\", className)}\n    >\n      <div ref={bar} className=\"h-full w-full origin-left scale-x-0 bg-primary\" />\n    </div>\n  )\n}\n\nexport { ScrollProgress, type ScrollProgressProps }\n",
      "type": "registry:ui"
    }
  ],
  "meta": {
    "version": "0.1.1"
  },
  "categories": [
    "navigation",
    "loaders"
  ],
  "type": "registry:ui"
}