{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "music-player",
  "title": "Music Player",
  "description": "A playlist player with a waveform seek bar, shuffle, repeat, volume and optional ducking under the microphone.",
  "dependencies": [
    "@phosphor-icons/react"
  ],
  "registryDependencies": [
    "card",
    "empty",
    "label",
    "switch",
    "toggle",
    "@audiocn/audio-player",
    "@audiocn/parameter-slider",
    "@audiocn/track-list",
    "@audiocn/volume-control",
    "@audiocn/waveform",
    "@audiocn/use-audio-analyser",
    "@audiocn/use-audio-context",
    "@audiocn/use-audio-player",
    "@audiocn/use-frame-source",
    "@audiocn/use-waveform-data"
  ],
  "files": [
    {
      "path": "components/blocks/music-player/music-player.tsx",
      "content": "\"use client\";\n\nimport {\n  MusicNotesIcon,\n  PauseIcon,\n  PlayIcon,\n  RepeatIcon,\n  RepeatOnceIcon,\n  ShuffleIcon,\n  SkipBackIcon,\n  SkipForwardIcon,\n  SpeakerHighIcon,\n  SpeakerXIcon,\n} from \"@phosphor-icons/react\";\nimport { useEffect, useId, useMemo, useState } from \"react\";\n\nimport {\n  AudioPlayer,\n  AudioPlayerArtwork,\n  AudioPlayerControls,\n  AudioPlayerDescription,\n  AudioPlayerNext,\n  AudioPlayerPlay,\n  AudioPlayerPrevious,\n  AudioPlayerTime,\n  AudioPlayerTitle,\n  AudioPlayerVolume,\n} from \"@/components/ui/audio-player\";\nimport { Card, CardContent } from \"@/components/ui/card\";\nimport {\n  Empty,\n  EmptyDescription,\n  EmptyHeader,\n  EmptyMedia,\n  EmptyTitle,\n} from \"@/components/ui/empty\";\nimport { Label } from \"@/components/ui/label\";\nimport {\n  ParameterSlider,\n  ParameterSliderControl,\n  ParameterSliderHeader,\n  ParameterSliderLabel,\n  ParameterSliderValue,\n} from \"@/components/ui/parameter-slider\";\nimport { Switch } from \"@/components/ui/switch\";\nimport { Toggle } from \"@/components/ui/toggle\";\nimport {\n  TrackList,\n  TrackListItem,\n  TrackListItemContent,\n  TrackListItemDescription,\n  TrackListItemDuration,\n  TrackListItemIndex,\n  TrackListItemTitle,\n} from \"@/components/ui/track-list\";\nimport {\n  VolumeControlMute,\n  VolumeControlSlider,\n} from \"@/components/ui/volume-control\";\nimport {\n  Waveform,\n  WaveformCanvas,\n  WaveformCursor,\n  WaveformHover,\n} from \"@/components/ui/waveform\";\nimport { getMediaElementSource } from \"@/hooks/use-audio-analyser\";\nimport { useAudioContext } from \"@/hooks/use-audio-context\";\nimport { useAudioPlayer } from \"@/hooks/use-audio-player\";\nimport { useFrameSource } from \"@/hooks/use-frame-source\";\nimport { useWaveformData } from \"@/hooks/use-waveform-data\";\nimport { dbToGain } from \"@/lib/audio/decibels\";\nimport { formatTime } from \"@/lib/audio/time\";\nimport type { FrameSource, MeterFrame } from \"@/lib/audio/types\";\n\nexport interface MusicTrack {\n  id: string;\n  title: string;\n  artist?: string;\n  src: string;\n  artwork?: string;\n  /** Seconds, shown before the file loads. */\n  duration?: number;\n}\n\nexport interface MusicPlayerProps {\n  tracks?: MusicTrack[];\n  defaultTracks?: MusicTrack[];\n  onTrackChange?: (track: MusicTrack) => void;\n  /** A level source, usually the microphone, that ducks the music. */\n  duckingSource?: FrameSource<MeterFrame> | null;\n  /** Route the music into a mixer instead of the speakers. */\n  output?: AudioNode | null;\n  className?: string;\n}\n\ntype Repeat = \"off\" | \"all\" | \"one\";\n\nconst NO_TRACKS: MusicTrack[] = [];\nconst DUCK_THRESHOLD_DB = -35;\nconst DUCK_ATTACK = 0.02;\nconst DUCK_RELEASE = 0.15;\n/** How long a duck holds after the last loud frame before it lets go. */\nconst DUCK_HOLD = 0.2;\n\nconst nextRepeat: Record<Repeat, Repeat> = {\n  all: \"one\",\n  off: \"all\",\n  one: \"off\",\n};\n\nexport const MusicPlayer = ({\n  tracks: tracksProp,\n  defaultTracks = NO_TRACKS,\n  onTrackChange,\n  duckingSource,\n  output,\n  className,\n}: MusicPlayerProps) => {\n  const tracks = tracksProp ?? defaultTracks;\n  const duckingId = useId();\n  const [index, setIndex] = useState(0);\n  const [shuffle, setShuffle] = useState(false);\n  const [repeat, setRepeat] = useState<Repeat>(\"all\");\n  const [ducking, setDucking] = useState(true);\n  // Once the listener has played or picked a track, later tracks play on\n  // their own, including after repeat-all wraps back to the first.\n  const [autoAdvance, setAutoAdvance] = useState(false);\n  const [duckAmountDb, setDuckAmountDb] = useState(-12);\n  const track = tracks[index];\n\n  const go = (direction: number) => {\n    if (tracks.length === 0) {\n      return;\n    }\n    let next = (index + direction + tracks.length) % tracks.length;\n    if (shuffle && tracks.length > 1) {\n      next =\n        (index + 1 + Math.floor(Math.random() * (tracks.length - 1))) %\n        tracks.length;\n    }\n    setIndex(next);\n    setAutoAdvance(true);\n    const nextTrack = tracks[next];\n    if (nextTrack) {\n      onTrackChange?.(nextTrack);\n    }\n  };\n\n  const player = useAudioPlayer({\n    autoPlay: autoAdvance,\n    loop: repeat === \"one\",\n    onEnded: () => {\n      if (repeat === \"all\" || index < tracks.length - 1) {\n        go(1);\n      }\n    },\n    src: track?.src,\n  });\n  const waveform = useWaveformData(track?.src ?? null, { samples: 400 });\n\n  const { context } = useAudioContext();\n  const duckGain = useMemo(() => context?.createGain() ?? null, [context]);\n  const routed = output !== undefined || duckingSource !== undefined;\n\n  useEffect(() => {\n    if (!(context && duckGain && player.element && routed)) {\n      return;\n    }\n    const source = getMediaElementSource(context, player.element);\n    try {\n      source.disconnect(context.destination);\n    } catch {\n      // Not connected to the speakers.\n    }\n    source.connect(duckGain);\n    const target = output === undefined ? context.destination : output;\n    if (target) {\n      duckGain.connect(target);\n    }\n    return () => {\n      source.disconnect(duckGain);\n      if (target) {\n        duckGain.disconnect(target);\n      }\n      source.connect(context.destination);\n    };\n  }, [context, duckGain, output, player.element, routed]);\n\n  useFrameSource(\n    duckingSource,\n    (frame) => {\n      if (!(duckGain && context)) {\n        return;\n      }\n      let loudest = Number.NEGATIVE_INFINITY;\n      for (const level of frame.channels) {\n        loudest = Math.max(loudest, level.peakDb);\n      }\n      if (!(ducking && loudest >= DUCK_THRESHOLD_DB)) {\n        return;\n      }\n      // Each loud frame ducks and schedules its own release, so the music\n      // comes back when the voice goes quiet or its frames stop arriving\n      // (the mic is turned off, ducking is switched off).\n      const now = context.currentTime;\n      const { gain } = duckGain;\n      gain.cancelScheduledValues(now);\n      gain.setTargetAtTime(dbToGain(duckAmountDb), now, DUCK_ATTACK);\n      gain.setTargetAtTime(1, now + DUCK_HOLD, DUCK_RELEASE);\n    },\n    { enabled: routed && Boolean(duckGain) }\n  );\n\n  if (tracks.length === 0) {\n    return (\n      <Empty className={className}>\n        <EmptyHeader>\n          <EmptyMedia variant=\"icon\">\n            <MusicNotesIcon />\n          </EmptyMedia>\n          <EmptyTitle>No music</EmptyTitle>\n          <EmptyDescription>Add tracks to start playing.</EmptyDescription>\n        </EmptyHeader>\n      </Empty>\n    );\n  }\n\n  return (\n    <Card className={className}>\n      <CardContent>\n        <div className=\"flex flex-col gap-4\">\n          <AudioPlayer\n            className=\"flex-col items-stretch gap-3\"\n            onNext={() => go(1)}\n            onPrevious={() => go(-1)}\n            player={player}\n          >\n            <div className=\"flex items-center gap-3\">\n              {track?.artwork ? (\n                <AudioPlayerArtwork src={track.artwork} />\n              ) : (\n                <span className=\"bg-muted text-muted-foreground flex size-12 items-center justify-center rounded-lg\">\n                  <MusicNotesIcon className=\"size-5\" />\n                </span>\n              )}\n              <div className=\"flex min-w-0 flex-1 flex-col\">\n                <AudioPlayerTitle>{track?.title}</AudioPlayerTitle>\n                <AudioPlayerDescription>{track?.artist}</AudioPlayerDescription>\n              </div>\n            </div>\n            <Waveform\n              className=\"h-14\"\n              currentTime={player.currentTime}\n              duration={waveform.duration || player.duration}\n              loading={waveform.status === \"loading\"}\n              onSeekCommitted={(value) => player.seek(value)}\n              peaks={waveform.peaks}\n              time={player.time}\n            >\n              <WaveformCanvas />\n              <WaveformCursor />\n              <WaveformHover />\n            </Waveform>\n            <div className=\"flex items-center justify-between\">\n              <AudioPlayerTime />\n              <AudioPlayerTime type=\"remaining\" />\n            </div>\n            <div className=\"flex items-center justify-between gap-2\">\n              <Toggle\n                aria-label=\"Shuffle\"\n                onPressedChange={setShuffle}\n                pressed={shuffle}\n                size=\"sm\"\n              >\n                <ShuffleIcon />\n              </Toggle>\n              <AudioPlayerControls>\n                <AudioPlayerPrevious>\n                  <SkipBackIcon />\n                </AudioPlayerPrevious>\n                <AudioPlayerPlay>\n                  {({ playing }) =>\n                    playing ? (\n                      <PauseIcon weight=\"fill\" />\n                    ) : (\n                      <PlayIcon weight=\"fill\" />\n                    )\n                  }\n                </AudioPlayerPlay>\n                <AudioPlayerNext>\n                  <SkipForwardIcon />\n                </AudioPlayerNext>\n              </AudioPlayerControls>\n              <Toggle\n                aria-label={`Repeat: ${repeat}`}\n                onPressedChange={() => setRepeat(nextRepeat[repeat])}\n                pressed={repeat !== \"off\"}\n                size=\"sm\"\n              >\n                {repeat === \"one\" ? <RepeatOnceIcon /> : <RepeatIcon />}\n              </Toggle>\n            </div>\n            <AudioPlayerVolume>\n              <VolumeControlMute>\n                {player.muted ? <SpeakerXIcon /> : <SpeakerHighIcon />}\n              </VolumeControlMute>\n              <VolumeControlSlider />\n            </AudioPlayerVolume>\n          </AudioPlayer>\n          <TrackList variant=\"outline\">\n            {tracks.map((item, position) => (\n              <TrackListItem\n                active={position === index}\n                key={item.id}\n                onSelect={() => {\n                  setIndex(position);\n                  onTrackChange?.(item);\n                  if (position === index) {\n                    player.toggle();\n                  } else {\n                    setAutoAdvance(true);\n                  }\n                }}\n                playing={position === index && player.playing}\n              >\n                <TrackListItemIndex>{position + 1}</TrackListItemIndex>\n                <TrackListItemContent>\n                  <TrackListItemTitle>{item.title}</TrackListItemTitle>\n                  {item.artist ? (\n                    <TrackListItemDescription>\n                      {item.artist}\n                    </TrackListItemDescription>\n                  ) : null}\n                </TrackListItemContent>\n                <TrackListItemDuration>\n                  {item.duration ? formatTime(item.duration) : null}\n                </TrackListItemDuration>\n              </TrackListItem>\n            ))}\n          </TrackList>\n          {duckingSource === undefined ? null : (\n            <div className=\"flex flex-col gap-3 rounded-xl border p-3\">\n              <div className=\"flex items-center justify-between\">\n                <Label htmlFor={duckingId}>Lower music while you talk</Label>\n                <Switch\n                  checked={ducking}\n                  id={duckingId}\n                  onCheckedChange={setDucking}\n                  size=\"sm\"\n                />\n              </div>\n              <ParameterSlider\n                disabled={!ducking}\n                max={0}\n                min={-30}\n                onValueChange={setDuckAmountDb}\n                unit=\"dB\"\n                value={duckAmountDb}\n              >\n                <ParameterSliderHeader>\n                  <ParameterSliderLabel>Amount</ParameterSliderLabel>\n                  <ParameterSliderValue />\n                </ParameterSliderHeader>\n                <ParameterSliderControl />\n              </ParameterSlider>\n            </div>\n          )}\n        </div>\n      </CardContent>\n    </Card>\n  );\n};\n",
      "type": "registry:block"
    }
  ],
  "categories": [
    "music"
  ],
  "type": "registry:block"
}