docs(site): complete menu radio group references with demos and options hooks (#1807)

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>

packages/react/src/ui/audio-track/use-audio-track-options.ts

@@ -24,6 +24,12 @@ export interface AudioTrackOptionsResult {
   setValue: (value: string) => void;
 }
 
+/**
+ * Create audio track menu options from the player audio track state. Returns
+ * `null` when the audio track feature is not configured.
+ *
+ * @param props - Optional `label`, `formatTrack`, and `disabled` overrides.
+ */
 export function useAudioTrackOptions(props?: AudioTrackOptionsProps): AudioTrackOptionsResult | null {
   'use no memo';
 

packages/react/src/ui/captions-radio-group/use-captions-options.ts

@@ -25,6 +25,13 @@ export interface CaptionsOptionsResult {
   setValue: (value: string) => void;
 }
 
+/**
+ * Create captions menu options (including an `Off` option) from the player
+ * text track state. Returns `null` when the text tracks feature is not
+ * configured.
+ *
+ * @param props - Optional `label`, `formatTrack`, and `disabled` overrides.
+ */
 export function useCaptionsOptions(props?: CaptionsOptionsProps): CaptionsOptionsResult | null {
   'use no memo';
 

packages/react/src/ui/playback-rate/use-playback-rate-options.ts

@@ -28,6 +28,12 @@ export interface PlaybackRateOptionsResult {
   setValue: (value: string) => void;
 }
 
+/**
+ * Create playback rate menu options from the player playback rate state.
+ * Returns `null` when the playback rate feature is not configured.
+ *
+ * @param props - Optional `label`, `formatRate`, and `disabled` overrides.
+ */
 export function usePlaybackRateOptions(props?: PlaybackRateOptionsProps): PlaybackRateOptionsResult | null {
   const media = usePlayer(selectPlaybackRate);
   const [core] = useState(() => new PlaybackRateRadioGroupCoreClass());

packages/react/src/ui/quality/use-quality-options.ts

@@ -36,6 +36,13 @@ function resolveAutoLabel(t: Translator, label: string): string {
   return resolveTranslation(t, label);
 }
 
+/**
+ * Create quality menu options (including an `Auto` option) from the player
+ * video rendition state. Returns `null` when the quality feature is not
+ * configured.
+ *
+ * @param props - Optional `label`, `formatRendition`, and `disabled` overrides.
+ */
 export function useQualityOptions(props?: QualityOptionsProps): QualityOptionsResult | null {
   'use no memo';