{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "audio-player",
  "title": "Audio Player",
  "description": "A composable audio player: transport, seek bar with buffering, time, volume, playback rate, loop and keyboard shortcuts.",
  "dependencies": [
    "@base-ui/react"
  ],
  "registryDependencies": [
    "@audiocn/core",
    "@audiocn/use-audio-player",
    "@audiocn/use-frame-source",
    "@audiocn/volume-control"
  ],
  "files": [
    {
      "path": "components/ui/audio-player.tsx",
      "content": "\"use client\";\n\nimport { mergeProps } from \"@base-ui/react/merge-props\";\nimport { Slider as SliderPrimitive } from \"@base-ui/react/slider\";\nimport { useRender } from \"@base-ui/react/use-render\";\nimport {\n  createContext,\n  useContext,\n  useEffect,\n  useEffectEvent,\n  useMemo,\n  useState,\n} from \"react\";\nimport type {\n  ComponentProps,\n  CSSProperties,\n  KeyboardEvent,\n  ReactNode,\n} from \"react\";\n\nimport {\n  VolumeControl,\n  VolumeControlMute,\n  VolumeControlSlider,\n} from \"@/components/ui/volume-control\";\nimport type { VolumeControlProps } from \"@/components/ui/volume-control\";\nimport { useAudioPlayer } from \"@/hooks/use-audio-player\";\nimport type {\n  AudioPlayerController,\n  UseAudioPlayerOptions,\n} from \"@/hooks/use-audio-player\";\nimport { useFrameSource } from \"@/hooks/use-frame-source\";\nimport { clamp } from \"@/lib/audio/decibels\";\nimport { formatTime } from \"@/lib/audio/time\";\nimport { cn } from \"@/lib/utils\";\n\nconst DEFAULT_RATES = [0.5, 0.75, 1, 1.25, 1.5, 2];\nconst SEEK_STEP = 5;\nconst SEEK_LARGE_STEP = 15;\nconst VOLUME_STEP = 0.05;\n\ninterface AudioPlayerContextValue {\n  player: AudioPlayerController;\n  onPrevious?: () => void;\n  onNext?: () => void;\n}\n\nconst AudioPlayerContext = createContext<AudioPlayerContextValue | null>(null);\n\nconst useAudioPlayerPart = (part: string) => {\n  const context = useContext(AudioPlayerContext);\n  if (!context) {\n    throw new Error(`${part} must be used inside AudioPlayer.`);\n  }\n  return context;\n};\n\n/** The player controller of the surrounding `AudioPlayer`. */\nexport const useAudioPlayerContext = (): AudioPlayerController =>\n  useAudioPlayerPart(\"useAudioPlayerContext\").player;\n\nexport interface AudioPlayerProps\n  extends\n    Omit<\n      ComponentProps<\"div\">,\n      \"onPlay\" | \"onPause\" | \"onEnded\" | \"onError\" | \"onTimeUpdate\"\n    >,\n    Omit<UseAudioPlayerOptions, \"onPlay\" | \"onPause\" | \"onEnded\" | \"onError\"> {\n  /** Use an existing player from `useAudioPlayer` instead of an internal one. */\n  player?: AudioPlayerController;\n  onPlay?: () => void;\n  onPause?: () => void;\n  onEnded?: () => void;\n  onError?: (error: MediaError | null) => void;\n  onTimeUpdate?: (time: number) => void;\n  /** Enables the previous button. */\n  onPrevious?: () => void;\n  /** Enables the next button. */\n  onNext?: () => void;\n  /** Keyboard shortcuts while focus is inside. Default true. */\n  shortcuts?: boolean;\n}\n\nconst InternalPlayer = ({\n  options,\n  children,\n}: {\n  options: UseAudioPlayerOptions;\n  children: (player: AudioPlayerController) => ReactNode;\n}) => {\n  const player = useAudioPlayer(options);\n  return <>{children(player)}</>;\n};\n\nconst isEditable = (target: EventTarget | null) =>\n  target instanceof HTMLElement &&\n  (target.isContentEditable ||\n    [\"INPUT\", \"SELECT\", \"TEXTAREA\"].includes(target.tagName));\n\ntype ShortcutEvent = Pick<\n  KeyboardEvent<HTMLElement>,\n  \"key\" | \"shiftKey\" | \"target\"\n>;\n\nconst inSliderTarget = (target: HTMLElement) =>\n  target.getAttribute(\"type\") === \"range\" ||\n  target.getAttribute(\"role\") === \"slider\";\n\n/** The player action for a key, or null to let the key through. */\nconst shortcutFor = (\n  event: ShortcutEvent,\n  player: AudioPlayerController\n): (() => void) | null => {\n  const target = event.target as HTMLElement;\n  const seekAmount = event.shiftKey ? SEEK_LARGE_STEP : SEEK_STEP;\n  const togglesPlayback = !(target.tagName === \"BUTTON\" || isEditable(target));\n  const sliderKeys = !inSliderTarget(target);\n  const actions: Record<string, (() => void) | null> = {\n    \" \": togglesPlayback ? () => player.toggle() : null,\n    ArrowDown: sliderKeys\n      ? () => player.setVolume(clamp(player.volume - VOLUME_STEP, 0, 1))\n      : null,\n    ArrowLeft: sliderKeys\n      ? () => player.seek(player.currentTime - seekAmount)\n      : null,\n    ArrowRight: sliderKeys\n      ? () => player.seek(player.currentTime + seekAmount)\n      : null,\n    ArrowUp: sliderKeys\n      ? () => player.setVolume(clamp(player.volume + VOLUME_STEP, 0, 1))\n      : null,\n    End: () => player.seek(player.duration),\n    Home: () => player.seek(0),\n    k: togglesPlayback ? () => player.toggle() : null,\n    m: () => player.setMuted(!player.muted),\n  };\n  return actions[event.key] ?? null;\n};\n\nconst PlayerRoot = ({\n  player,\n  onPrevious,\n  onNext,\n  onTimeUpdate,\n  shortcuts,\n  className,\n  children,\n  onKeyDown,\n  ...props\n}: Omit<AudioPlayerProps, keyof UseAudioPlayerOptions | \"player\"> & {\n  player: AudioPlayerController;\n}) => {\n  const { currentTime } = player;\n  const contextValue = useMemo<AudioPlayerContextValue>(\n    () => ({ onNext, onPrevious, player }),\n    [onNext, onPrevious, player]\n  );\n\n  // Reports time changes, not every render of a parent with an inline\n  // callback.\n  const reportTime = useEffectEvent((time: number) => {\n    onTimeUpdate?.(time);\n  });\n\n  useEffect(() => {\n    reportTime(currentTime);\n  }, [currentTime]);\n\n  const handleKeyDown = (event: KeyboardEvent<HTMLDivElement>) => {\n    onKeyDown?.(event);\n    if (\n      !shortcuts ||\n      event.defaultPrevented ||\n      event.metaKey ||\n      event.ctrlKey\n    ) {\n      return;\n    }\n    const action = shortcutFor(event, player);\n    if (action) {\n      event.preventDefault();\n      action();\n    }\n  };\n\n  return (\n    <AudioPlayerContext.Provider value={contextValue}>\n      <div\n        className={cn(\n          \"group/audio-player flex flex-wrap items-center gap-x-3 gap-y-2 outline-none\",\n          className\n        )}\n        data-ended={player.status === \"ended\" ? \"\" : undefined}\n        data-error={player.status === \"error\" ? \"\" : undefined}\n        data-loading={player.status === \"loading\" ? \"\" : undefined}\n        data-muted={player.muted ? \"\" : undefined}\n        data-paused={player.playing ? undefined : \"\"}\n        data-playing={player.playing ? \"\" : undefined}\n        data-slot=\"audio-player\"\n        onKeyDown={handleKeyDown}\n        role=\"group\"\n        {...props}\n      >\n        {children}\n      </div>\n    </AudioPlayerContext.Provider>\n  );\n};\n\nexport const AudioPlayer = ({\n  player,\n  src,\n  autoPlay,\n  loop,\n  volume,\n  muted,\n  playbackRate,\n  preload,\n  crossOrigin,\n  onPlay,\n  onPause,\n  onEnded,\n  onError,\n  shortcuts = true,\n  ...props\n}: AudioPlayerProps) => {\n  if (player) {\n    return <PlayerRoot player={player} shortcuts={shortcuts} {...props} />;\n  }\n  return (\n    <InternalPlayer\n      options={{\n        autoPlay,\n        crossOrigin,\n        loop,\n        muted,\n        onEnded,\n        onError,\n        onPause,\n        onPlay,\n        playbackRate,\n        preload,\n        src,\n        volume,\n      }}\n    >\n      {(internal) => (\n        <PlayerRoot player={internal} shortcuts={shortcuts} {...props} />\n      )}\n    </InternalPlayer>\n  );\n};\n\nexport const AudioPlayerArtwork = ({\n  className,\n  alt = \"\",\n  ...props\n}: ComponentProps<\"img\">) => (\n  <img\n    alt={alt}\n    className={cn(\n      \"bg-muted size-12 shrink-0 rounded-lg object-cover\",\n      className\n    )}\n    data-slot=\"audio-player-artwork\"\n    {...props}\n  />\n);\n\nexport const AudioPlayerTitle = ({\n  className,\n  ...props\n}: ComponentProps<\"span\">) => (\n  <span\n    className={cn(\"truncate text-sm font-medium\", className)}\n    data-slot=\"audio-player-title\"\n    {...props}\n  />\n);\n\nexport const AudioPlayerDescription = ({\n  className,\n  ...props\n}: ComponentProps<\"span\">) => (\n  <span\n    className={cn(\"text-muted-foreground truncate text-xs\", className)}\n    data-slot=\"audio-player-description\"\n    {...props}\n  />\n);\n\nexport const AudioPlayerControls = ({\n  className,\n  ...props\n}: ComponentProps<\"div\">) => (\n  <div\n    className={cn(\"flex items-center gap-1\", className)}\n    data-slot=\"audio-player-controls\"\n    {...props}\n  />\n);\n\nconst buttonClass =\n  \"inline-flex size-8 shrink-0 items-center justify-center rounded-full text-foreground outline-none transition-colors hover:bg-muted focus-visible:ring-3 focus-visible:ring-ring/30 disabled:pointer-events-none disabled:opacity-40 [&_svg:not([class*='size-'])]:size-4\";\n\ntype PlayerButtonProps = Omit<\n  useRender.ComponentProps<\"button\">,\n  \"children\"\n> & {\n  children?: ReactNode;\n};\n\nconst usePlayerButton = (\n  slot: string,\n  label: string,\n  onClick: () => void,\n  { render, className, children, ...props }: PlayerButtonProps,\n  options: { disabled?: boolean; state?: Record<string, boolean> } = {}\n) =>\n  useRender({\n    defaultTagName: \"button\",\n    props: mergeProps<\"button\">(\n      {\n        \"aria-label\": label,\n        children: children ?? <span className=\"text-xs\">{label}</span>,\n        className: cn(buttonClass, !children && \"w-auto px-2.5\", className),\n        disabled: options.disabled,\n        onClick,\n        type: \"button\",\n      },\n      props\n    ),\n    render,\n    state: { slot, ...options.state },\n  });\n\nexport interface AudioPlayerPlayProps extends Omit<\n  useRender.ComponentProps<\"button\">,\n  \"children\"\n> {\n  children?:\n    | ReactNode\n    | ((state: { playing: boolean; loading: boolean }) => ReactNode);\n}\n\nexport const AudioPlayerPlay = ({\n  children,\n  className,\n  ...props\n}: AudioPlayerPlayProps) => {\n  const { player } = useAudioPlayerPart(\"AudioPlayerPlay\");\n  const loading = player.status === \"loading\";\n  const content =\n    typeof children === \"function\"\n      ? children({ loading, playing: player.playing })\n      : children;\n  return usePlayerButton(\n    \"audio-player-play\",\n    player.playing ? \"Pause\" : \"Play\",\n    () => {\n      player.toggle();\n    },\n    {\n      children: content,\n      className: cn(\n        \"bg-primary text-primary-foreground hover:bg-primary/85 size-10\",\n        className\n      ),\n      ...props,\n    },\n    {\n      disabled: player.status === \"idle\" || player.status === \"error\",\n      state: { loading, playing: player.playing },\n    }\n  );\n};\n\nexport const AudioPlayerPrevious = (props: PlayerButtonProps) => {\n  const { onPrevious } = useAudioPlayerPart(\"AudioPlayerPrevious\");\n  return usePlayerButton(\n    \"audio-player-previous\",\n    \"Previous\",\n    () => onPrevious?.(),\n    props,\n    {\n      disabled: !onPrevious,\n    }\n  );\n};\n\nexport const AudioPlayerNext = (props: PlayerButtonProps) => {\n  const { onNext } = useAudioPlayerPart(\"AudioPlayerNext\");\n  return usePlayerButton(\"audio-player-next\", \"Next\", () => onNext?.(), props, {\n    disabled: !onNext,\n  });\n};\n\nexport interface AudioPlayerSkipProps extends PlayerButtonProps {\n  /** Default 10. */\n  seconds?: number;\n}\n\nexport const AudioPlayerSkipBack = ({\n  seconds = 10,\n  ...props\n}: AudioPlayerSkipProps) => {\n  const { player } = useAudioPlayerPart(\"AudioPlayerSkipBack\");\n  return usePlayerButton(\n    \"audio-player-skip-back\",\n    `Back ${seconds} seconds`,\n    () => player.seek(player.currentTime - seconds),\n    props\n  );\n};\n\nexport const AudioPlayerSkipForward = ({\n  seconds = 10,\n  ...props\n}: AudioPlayerSkipProps) => {\n  const { player } = useAudioPlayerPart(\"AudioPlayerSkipForward\");\n  return usePlayerButton(\n    \"audio-player-skip-forward\",\n    `Forward ${seconds} seconds`,\n    () => player.seek(player.currentTime + seconds),\n    props\n  );\n};\n\nexport interface AudioPlayerSeekProps extends Omit<\n  SliderPrimitive.Root.Props<number>,\n  | \"value\"\n  | \"defaultValue\"\n  | \"onValueChange\"\n  | \"onValueCommitted\"\n  | \"min\"\n  | \"max\"\n  | \"step\"\n> {\n  /** Seconds per arrow key. Default 5. */\n  step?: number;\n  /** Seconds per Shift+arrow. Default 15. */\n  largeStep?: number;\n}\n\nexport const AudioPlayerSeek = ({\n  step = SEEK_STEP,\n  largeStep = SEEK_LARGE_STEP,\n  className,\n  ...props\n}: AudioPlayerSeekProps) => {\n  const { player } = useAudioPlayerPart(\"AudioPlayerSeek\");\n  const [time, setTime] = useState(player.currentTime);\n  const [dragValue, setDragValue] = useState<number | null>(null);\n  const duration = player.duration || 0;\n\n  useFrameSource(player.time, (next) => {\n    if (dragValue === null) {\n      setTime(next);\n    }\n  });\n\n  const value = dragValue ?? time;\n  const bufferedPercent =\n    duration > 0 ? clamp(player.buffered / duration, 0, 1) * 100 : 0;\n\n  return (\n    <SliderPrimitive.Root\n      className={cn(\n        \"relative flex min-w-24 flex-1 touch-none items-center select-none\",\n        className\n      )}\n      data-slot=\"audio-player-seek\"\n      disabled={duration === 0}\n      largeStep={largeStep}\n      max={Math.max(duration, 0.001)}\n      min={0}\n      onValueChange={(next) => setDragValue(next)}\n      onValueCommitted={(next) => {\n        player.seek(next);\n        setTime(next);\n        setDragValue(null);\n      }}\n      step={0.01}\n      value={clamp(value, 0, Math.max(duration, 0.001))}\n      {...props}\n    >\n      <SliderPrimitive.Control className=\"relative flex h-4 w-full items-center px-1.5 before:absolute before:inset-x-0 before:-inset-y-1.5 pointer-coarse:before:-inset-y-3\">\n        <SliderPrimitive.Track\n          className=\"bg-input/90 relative h-1 w-full grow rounded-full\"\n          data-slot=\"audio-player-seek-track\"\n        >\n          <div\n            className=\"bg-muted-foreground/25 absolute inset-y-0 left-0 w-(--buffered) rounded-full\"\n            data-slot=\"audio-player-seek-buffered\"\n            style={{ \"--buffered\": `${bufferedPercent}%` } as CSSProperties}\n          />\n          <SliderPrimitive.Indicator\n            className=\"bg-primary rounded-full\"\n            data-slot=\"audio-player-seek-range\"\n          />\n          <SliderPrimitive.Thumb\n            aria-label=\"Seek\"\n            className=\"bg-background ring-foreground/15 hover:ring-ring/30 focus-visible:ring-ring/40 block size-3 shrink-0 rounded-full shadow-sm ring-1 outline-hidden transition-[box-shadow] hover:ring-4 focus-visible:ring-4\"\n            data-slot=\"audio-player-seek-thumb\"\n            getAriaValueText={() =>\n              `${formatTime(value)} of ${formatTime(duration)}`\n            }\n            onKeyDown={(event) => {\n              const amount = event.shiftKey ? largeStep : step;\n              if (event.key === \"ArrowRight\" || event.key === \"ArrowLeft\") {\n                event.preventDefault();\n                player.seek(\n                  value + (event.key === \"ArrowRight\" ? amount : -amount)\n                );\n              }\n            }}\n          />\n        </SliderPrimitive.Track>\n      </SliderPrimitive.Control>\n    </SliderPrimitive.Root>\n  );\n};\n\nexport interface AudioPlayerTimeProps extends ComponentProps<\"span\"> {\n  /** Default `current`. */\n  type?: \"current\" | \"remaining\" | \"duration\";\n  format?: (\n    seconds: number,\n    type: \"current\" | \"remaining\" | \"duration\"\n  ) => string;\n}\n\nconst defaultTimeFormat = (\n  seconds: number,\n  type: \"current\" | \"remaining\" | \"duration\"\n) => formatTime(seconds, { remaining: type === \"remaining\" });\n\nexport const AudioPlayerTime = ({\n  type = \"current\",\n  format = defaultTimeFormat,\n  className,\n  style,\n  ...props\n}: AudioPlayerTimeProps) => {\n  const { player } = useAudioPlayerPart(\"AudioPlayerTime\");\n  // As wide as the longest time this track can show, so it never shifts.\n  const timeWidth = Math.max(\n    format(0, type).length,\n    format(player.duration, type).length\n  );\n  let seconds = player.currentTime;\n  if (type === \"duration\") {\n    seconds = player.duration;\n  } else if (type === \"remaining\") {\n    seconds = Math.max(0, player.duration - player.currentTime);\n  }\n  return (\n    <span\n      className={cn(\n        \"text-muted-foreground inline-block min-w-(--audio-player-time-width) text-end font-mono text-xs whitespace-nowrap tabular-nums\",\n        className\n      )}\n      data-slot=\"audio-player-time\"\n      data-type={type}\n      style={\n        {\n          \"--audio-player-time-width\": `${timeWidth}ch`,\n          ...style,\n        } as CSSProperties\n      }\n      {...props}\n    >\n      {format(seconds, type)}\n    </span>\n  );\n};\n\nexport type AudioPlayerVolumeProps = Omit<\n  VolumeControlProps,\n  | \"value\"\n  | \"defaultValue\"\n  | \"onValueChange\"\n  | \"muted\"\n  | \"defaultMuted\"\n  | \"onMutedChange\"\n>;\n\nexport const AudioPlayerVolume = ({\n  children,\n  className,\n  ...props\n}: AudioPlayerVolumeProps) => {\n  const { player } = useAudioPlayerPart(\"AudioPlayerVolume\");\n  return (\n    <VolumeControl\n      className={cn(\"w-32\", className)}\n      data-slot=\"audio-player-volume\"\n      muted={player.muted}\n      onMutedChange={(value) => player.setMuted(value)}\n      onValueChange={(value) => player.setVolume(value)}\n      value={player.volume}\n      {...props}\n    >\n      {children ?? (\n        <>\n          <VolumeControlMute />\n          <VolumeControlSlider />\n        </>\n      )}\n    </VolumeControl>\n  );\n};\n\nexport interface AudioPlayerRateProps extends PlayerButtonProps {\n  rates?: number[];\n}\n\nexport const AudioPlayerRate = ({\n  rates = DEFAULT_RATES,\n  children,\n  ...props\n}: AudioPlayerRateProps) => {\n  const { player } = useAudioPlayerPart(\"AudioPlayerRate\");\n  const index = rates.indexOf(player.playbackRate);\n  const next = rates[(index + 1) % rates.length] ?? 1;\n  return usePlayerButton(\n    \"audio-player-rate\",\n    `Playback speed ${player.playbackRate}×`,\n    () => player.setPlaybackRate(next),\n    {\n      children: children ?? (\n        <span\n          className=\"inline-block min-w-(--rate-width) text-center font-mono text-xs tabular-nums\"\n          style={\n            {\n              \"--rate-width\": `${Math.max(...rates.map((rate) => `${rate}×`.length))}ch`,\n            } as CSSProperties\n          }\n        >\n          {player.playbackRate}×\n        </span>\n      ),\n      ...props,\n      className: cn(\"w-auto px-2\", props.className),\n    }\n  );\n};\n\nexport const AudioPlayerLoop = (props: PlayerButtonProps) => {\n  const { player } = useAudioPlayerPart(\"AudioPlayerLoop\");\n  return usePlayerButton(\n    \"audio-player-loop\",\n    player.loop ? \"Loop on\" : \"Loop off\",\n    () => player.setLoop(!player.loop),\n    {\n      \"aria-pressed\": player.loop,\n      ...props,\n      className: cn(\n        \"aria-pressed:bg-muted aria-pressed:text-primary\",\n        props.className\n      ),\n    },\n    { state: { looping: player.loop } }\n  );\n};\n",
      "type": "registry:ui"
    }
  ],
  "type": "registry:ui"
}