{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "wave-minimap",
  "title": "Wave Minimap",
  "description": "Wave player with a smaller overview minimap.",
  "dependencies": [
    "wavesurfer.js",
    "lucide-react"
  ],
  "registryDependencies": [
    "@waves-cn/wave-cn",
    "button",
    "card",
    "slider"
  ],
  "files": [
    {
      "path": "src/registry/components/wave-minimap.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\nimport MinimapPlugin from \"wavesurfer.js/dist/plugins/minimap.esm.js\";\nimport { cn } from \"@/lib/utils\";\nimport { Card, CardContent } from \"@/components/ui/card\";\nimport { Button } from \"@/components/ui/button\";\nimport { Slider } from \"@/components/ui/slider\";\nimport {\n  Play,\n  Pause,\n  Volume2,\n  VolumeX,\n  RotateCcw,\n  ZoomIn,\n  ZoomOut,\n} from \"lucide-react\";\nimport WavesurferPlayer, {\n  formatTime,\n  useCssVar,\n  useWavePlayer,\n} from \"@/lib/wave-cn\";\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\nexport interface WaveMinimapProps {\n  /** Audio source URL */\n  src: string;\n  /** Optional title shown above the waveform */\n  title?: string;\n  /** Initial volume (0–1) */\n  defaultVolume?: number;\n  /** Minimap height in px @default 30 */\n  minimapHeight?: number;\n  /** Minimap wave color @default \"var(--muted-foreground)\" */\n  minimapWaveColor?: string;\n  /** Minimap progress color @default \"var(--primary)\" */\n  minimapProgressColor?: string;\n  /** Minimap overlay (viewport indicator) color @default \"color-mix(in oklab, var(--primary) 15%, transparent)\" */\n  overlayColor?: string;\n  /** Default zoom level in px/s @default 100 */\n  defaultZoom?: number;\n  /** Minimum zoom level @default 10 */\n  minZoom?: number;\n  /** Maximum zoom level @default 500 */\n  maxZoom?: number;\n  /** Audio bar color. Accepts any CSS value including var(--*) tokens @default \"var(--muted-foreground)\" */\n  waveColor?: string;\n  /** Progress bar color. Accepts any CSS value including var(--*) tokens @default \"var(--primary)\" */\n  progressColor?: string;\n  /** Waveform bar width in px @default 3 */\n  barWidth?: number;\n  /** Waveform bar gap in px @default 2 */\n  barGap?: number;\n  /** Rounded borders for bars @default 2 */\n  barRadius?: number;\n  /** Waveform height in px @default 80 */\n  waveHeight?: number;\n  /** Called when playback starts */\n  onPlay?: () => void;\n  /** Called when playback pauses */\n  onPause?: () => void;\n  /** Called when playback finishes */\n  onFinish?: () => void;\n  /** Called with current time on every audio process tick */\n  onTimeUpdate?: (currentTime: number, duration: number) => void;\n  className?: string;\n}\n\n// ─── Component ───────────────────────────────────────────────────────────────\n\nexport function WaveMinimap({\n  src,\n  title,\n  defaultVolume = 0.8,\n  minimapHeight = 30,\n  minimapWaveColor = \"var(--muted-foreground)\",\n  minimapProgressColor = \"var(--primary)\",\n  overlayColor = \"color-mix(in oklab, var(--primary) 15%, transparent)\",\n  defaultZoom = 100,\n  minZoom = 10,\n  maxZoom = 500,\n  waveColor,\n  progressColor,\n  barWidth = 2,\n  barGap = 1,\n  barRadius = 2,\n  waveHeight = 80,\n  onPlay,\n  onPause,\n  onFinish,\n  onTimeUpdate,\n  className,\n}: WaveMinimapProps) {\n  const player = useWavePlayer({\n    defaultVolume,\n    onPlay,\n    onPause,\n    onFinish,\n    onTimeUpdate,\n  });\n  const {\n    isReady,\n    isPlaying,\n    currentTime,\n    duration,\n    progress,\n    volume,\n    isMuted,\n  } = player;\n\n  const [zoom, setZoom] = React.useState(defaultZoom);\n\n  // The minimap draws on a <canvas>, so `var()` tokens must be resolved first.\n  // `overlayColor` is applied to a DOM element and can stay a CSS expression.\n  const resolvedMinimapWave = useCssVar(minimapWaveColor);\n  const resolvedMinimapProgress = useCssVar(minimapProgressColor);\n\n  // ── Memoized plugins ──────────────────────────────────────────────────────\n  const plugins = React.useMemo(\n    () =>\n      typeof document === \"undefined\"\n        ? []\n        : [\n            MinimapPlugin.create({\n              height: minimapHeight,\n              waveColor: resolvedMinimapWave,\n              progressColor: resolvedMinimapProgress,\n              overlayColor: overlayColor,\n              insertPosition: \"afterend\",\n            }),\n          ],\n    [minimapHeight, resolvedMinimapWave, resolvedMinimapProgress, overlayColor],\n  );\n\n  // ── Controls ──────────────────────────────────────────────────────────────\n\n  const handleSeek = ([v]: number[]) => player.seek(v);\n  const handleVolume = ([v]: number[]) => player.setVolume(v);\n\n  // ── Zoom ──────────────────────────────────────────────────────────────────\n  // Slider changes are coalesced to one `ws.zoom()` call per animation frame;\n  // the slider position (`zoom` state) updates immediately.\n  const zoomFrame = React.useRef<number | null>(null);\n  const pendingZoom = React.useRef(defaultZoom);\n\n  const applyZoom = (value: number) => {\n    pendingZoom.current = value;\n    if (zoomFrame.current !== null) return;\n    zoomFrame.current = requestAnimationFrame(() => {\n      zoomFrame.current = null;\n      player.wavesurfer.current?.zoom(pendingZoom.current);\n    });\n  };\n\n  React.useEffect(\n    () => () => {\n      if (zoomFrame.current !== null) cancelAnimationFrame(zoomFrame.current);\n    },\n    [],\n  );\n\n  const handleZoom = ([value]: number[]) => {\n    setZoom(value);\n    applyZoom(value);\n  };\n\n  const zoomIn = () => {\n    const next = Math.min(zoom * 1.5, maxZoom);\n    setZoom(next);\n    player.wavesurfer.current?.zoom(next);\n  };\n\n  const zoomOut = () => {\n    const next = Math.max(zoom / 1.5, minZoom);\n    setZoom(next);\n    player.wavesurfer.current?.zoom(next);\n  };\n\n  // ── Render ────────────────────────────────────────────────────────────────\n  return (\n    <Card\n      className={cn(\n        \"w-full px-0 border-0 rounded-none bg-transparent\",\n        className,\n      )}\n    >\n      <CardContent className=\"border-0 px-0 space-y-3\">\n        {title && (\n          <p className=\"text-sm font-medium text-foreground truncate\">\n            {title}\n          </p>\n        )}\n\n        {/* Waveform + minimap */}\n        <div className=\"relative w-full rounded-sm overflow-hidden border border-border\">\n          <WavesurferPlayer\n            url={src}\n            waveColor={waveColor}\n            progressColor={progressColor}\n            height={waveHeight}\n            barWidth={barWidth}\n            barGap={barGap}\n            barRadius={barRadius}\n            minPxPerSec={defaultZoom}\n            fillParent\n            dragToSeek\n            hideScrollbar={false}\n            plugins={plugins}\n            {...player.handlers}\n          />\n        </div>\n\n        {/* Seek bar */}\n        <div className=\"flex items-center gap-2\">\n          <span className=\"text-[11px] tabular-nums text-muted-foreground w-10 text-right shrink-0\">\n            {formatTime(currentTime)}\n          </span>\n          <Slider\n            className=\"flex-1\"\n            value={[progress]}\n            min={0}\n            max={1}\n            step={0.001}\n            disabled={!isReady}\n            onValueChange={handleSeek}\n            aria-label=\"Seek\"\n          />\n          <span className=\"text-[11px] tabular-nums text-muted-foreground w-10 shrink-0\">\n            {formatTime(duration)}\n          </span>\n        </div>\n\n        {/* Controls */}\n        <div className=\"flex items-center justify-between gap-3 flex-wrap\">\n          {/* Playback */}\n          <div className=\"flex items-center gap-1.5\">\n            <Button\n              size=\"icon\"\n              variant=\"ghost\"\n              className=\"h-8 w-8 text-muted-foreground hover:text-foreground\"\n              disabled={!isReady}\n              onClick={player.restart}\n              aria-label=\"Restart\"\n            >\n              <RotateCcw size={15} />\n            </Button>\n            <Button\n              size=\"icon\"\n              variant=\"secondary\"\n              className=\"h-9 w-9\"\n              disabled={!isReady}\n              onClick={player.togglePlay}\n              aria-label={isPlaying ? \"Pause\" : \"Play\"}\n            >\n              {isPlaying ? <Pause size={17} /> : <Play size={17} />}\n            </Button>\n          </div>\n\n          {/* Zoom */}\n          <div className=\"flex items-center gap-2 flex-1 max-w-50\">\n            <Button\n              size=\"icon\"\n              variant=\"ghost\"\n              className=\"h-7 w-7 shrink-0 text-muted-foreground hover:text-foreground\"\n              disabled={!isReady || zoom <= minZoom}\n              onClick={zoomOut}\n              aria-label=\"Zoom out\"\n            >\n              <ZoomOut size={15} />\n            </Button>\n            <Slider\n              value={[zoom]}\n              min={minZoom}\n              max={maxZoom}\n              step={1}\n              disabled={!isReady}\n              onValueChange={handleZoom}\n              aria-label=\"Zoom\"\n            />\n            <Button\n              size=\"icon\"\n              variant=\"ghost\"\n              className=\"h-7 w-7 shrink-0 text-muted-foreground hover:text-foreground\"\n              disabled={!isReady || zoom >= maxZoom}\n              onClick={zoomIn}\n              aria-label=\"Zoom in\"\n            >\n              <ZoomIn size={15} />\n            </Button>\n          </div>\n\n          {/* Volume */}\n          <div className=\"flex items-center gap-2 w-32\">\n            <Button\n              size=\"icon\"\n              variant=\"ghost\"\n              className=\"h-7 w-7 shrink-0 text-muted-foreground hover:text-foreground\"\n              onClick={player.toggleMute}\n              aria-label={isMuted ? \"Unmute\" : \"Mute\"}\n            >\n              {isMuted ? <VolumeX size={15} /> : <Volume2 size={15} />}\n            </Button>\n            <Slider\n              value={[isMuted ? 0 : volume]}\n              min={0}\n              max={1}\n              step={0.01}\n              onValueChange={handleVolume}\n              aria-label=\"Volume\"\n            />\n          </div>\n        </div>\n      </CardContent>\n    </Card>\n  );\n}\n\nexport default WaveMinimap;\n",
      "type": "registry:component",
      "target": "components/waves-cn/wave-minimap.tsx"
    }
  ],
  "type": "registry:component"
}