feat(site): add TimeSlider, VolumeSlider, Popover API references (#685)

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

packages/react/src/ui/popover/index.parts.ts

@@ -1,5 +1,4 @@
 export { PopoverArrow as Arrow, type PopoverArrowProps as ArrowProps } from './popover-arrow';
-export { type PopoverContextValue, usePopoverContext } from './popover-context';
 export { PopoverPopup as Popup, type PopoverPopupProps as PopupProps } from './popover-popup';
 export { PopoverRoot as Root, type PopoverRootProps as RootProps } from './popover-root';
 export { PopoverTrigger as Trigger, type PopoverTriggerProps as TriggerProps } from './popover-trigger';

packages/react/src/ui/popover/index.ts

@@ -1 +1,2 @@
 export * as Popover from './index.parts';
+export { type PopoverContextValue, usePopoverContext } from './popover-context';

packages/react/src/ui/popover/popover-arrow.tsx

@@ -9,6 +9,7 @@ import { usePopoverContext } from './popover-context';
 
 export interface PopoverArrowProps extends UIComponentProps<'div', PopoverState> {}
 
+/** Decorative arrow pointing from the popup toward the trigger. Hidden from assistive technology. */
 export const PopoverArrow = forwardRef<HTMLDivElement, PopoverArrowProps>(function PopoverArrow(
   { render, className, style, ...elementProps },
   forwardedRef

packages/react/src/ui/popover/popover-popup.tsx

@@ -15,6 +15,7 @@ export interface PopoverPopupProps extends UIComponentProps<'div', PopoverState>
 
 const POPOVER_RESET: CSSProperties = { position: 'fixed', inset: 'auto', margin: 0 };
 
+/** Container for the popover content. Positioned relative to the trigger using CSS anchor positioning with a JavaScript fallback. */
 export const PopoverPopup = forwardRef<HTMLDivElement, PopoverPopupProps>(function PopoverPopup(
   { render, className, style, ...elementProps },
   forwardedRef

packages/react/src/ui/popover/popover-trigger.tsx

@@ -10,6 +10,7 @@ import { usePopoverContext } from './popover-context';
 
 export interface PopoverTriggerProps extends UIComponentProps<'button', PopoverState> {}
 
+/** Button that toggles the popover visibility. Renders a `<button>` element. */
 export const PopoverTrigger = forwardRef<HTMLButtonElement, PopoverTriggerProps>(function PopoverTrigger(
   { render, className, style, ...elementProps },
   forwardedRef

packages/react/src/ui/slider/slider-buffer.tsx

@@ -10,6 +10,7 @@ import { useSliderContext } from './slider-context';
 
 export interface SliderBufferProps extends UIComponentProps<'div', SliderState> {}
 
+/** Displays the buffered range on the slider track. */
 export const SliderBuffer = forwardRef(function SliderBuffer(
   componentProps: SliderBufferProps,
   forwardedRef: ForwardedRef<HTMLDivElement>

packages/react/src/ui/slider/slider-fill.tsx

@@ -10,6 +10,7 @@ import { useSliderContext } from './slider-context';
 
 export interface SliderFillProps extends UIComponentProps<'div', SliderState> {}
 
+/** Displays the filled portion from start to the current value. */
 export const SliderFill = forwardRef(function SliderFill(
   componentProps: SliderFillProps,
   forwardedRef: ForwardedRef<HTMLDivElement>

packages/react/src/ui/slider/slider-thumb.tsx

@@ -10,6 +10,7 @@ import { useSliderContext } from './slider-context';
 
 export interface SliderThumbProps extends UIComponentProps<'div', SliderState> {}
 
+/** Draggable handle for setting the slider value. Receives focus and handles keyboard interaction. */
 export const SliderThumb = forwardRef(function SliderThumb(
   componentProps: SliderThumbProps,
   forwardedRef: ForwardedRef<HTMLDivElement>

packages/react/src/ui/slider/slider-track.tsx

@@ -10,6 +10,7 @@ import { useSliderContext } from './slider-context';
 
 export interface SliderTrackProps extends UIComponentProps<'div', SliderState> {}
 
+/** Contains the slider's visual track and interactive hit zone. */
 export const SliderTrack = forwardRef(function SliderTrack(
   componentProps: SliderTrackProps,
   forwardedRef: ForwardedRef<HTMLDivElement>

packages/react/src/ui/slider/slider-value.tsx

@@ -9,10 +9,13 @@ import { renderElement } from '../../utils/use-render';
 import { useSliderContext } from './slider-context';
 
 export interface SliderValueProps extends UIComponentProps<'output', SliderState> {
+  /** Which slider value to display: the current position or the pointer position. */
   type?: 'current' | 'pointer' | undefined;
+  /** Custom formatter for the displayed value. Overrides the root's `formatValue`. */
   format?: ((value: number) => string) | undefined;
 }
 
+/** Displays a formatted text representation of the slider value. Renders an `<output>` element. */
 export const SliderValue = forwardRef(function SliderValue(
   componentProps: SliderValueProps,
   forwardedRef: ForwardedRef<HTMLOutputElement>