{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "volume-control",
  "title": "Volume Control",
  "description": "A 0..1 volume slider with a mute button and a perceptual curve, for players.",
  "dependencies": [
    "@base-ui/react"
  ],
  "registryDependencies": [
    "@audiocn/core",
    "@audiocn/use-audio-config"
  ],
  "files": [
    {
      "path": "components/ui/volume-control.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  useCallback,\n  useContext,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport type { ComponentProps } from \"react\";\n\nimport { useAudioConfig } from \"@/hooks/use-audio-config\";\nimport type { AudioSize } from \"@/hooks/use-audio-config\";\nimport { clamp } from \"@/lib/audio/decibels\";\nimport type { Orientation } from \"@/lib/audio/types\";\nimport { cn } from \"@/lib/utils\";\n\nconst PERCENT = 100;\nconst LOW_LEVEL = 0.34;\nconst MEDIUM_LEVEL = 0.67;\nconst PERCEPTUAL_EXPONENT = 2;\n\nexport type VolumeLevel = \"muted\" | \"low\" | \"medium\" | \"high\";\n\n/** Maps a volume (0..1 gain) to a slider position and back. */\nconst curves = {\n  linear: {\n    toPosition: (volume: number) => volume,\n    toVolume: (position: number) => position,\n  },\n  perceptual: {\n    toPosition: (volume: number) => volume ** (1 / PERCEPTUAL_EXPONENT),\n    toVolume: (position: number) => position ** PERCEPTUAL_EXPONENT,\n  },\n} as const;\n\ninterface VolumeControlContextValue {\n  volume: number;\n  muted: boolean;\n  level: VolumeLevel;\n  position: number;\n  step: number;\n  orientation: Orientation;\n  disabled: boolean;\n  setPosition: (position: number) => void;\n  commit: () => void;\n  toggleMuted: () => void;\n}\n\nconst VolumeControlContext = createContext<VolumeControlContextValue | null>(\n  null\n);\n\nconst useVolumeControl = (part: string) => {\n  const context = useContext(VolumeControlContext);\n  if (!context) {\n    throw new Error(`${part} must be used inside VolumeControl.`);\n  }\n  return context;\n};\n\nconst levelFor = (volume: number, muted: boolean): VolumeLevel => {\n  if (muted || volume <= 0) {\n    return \"muted\";\n  }\n  if (volume < LOW_LEVEL) {\n    return \"low\";\n  }\n  if (volume < MEDIUM_LEVEL) {\n    return \"medium\";\n  }\n  return \"high\";\n};\n\nexport type VolumeControlMuteProps = useRender.ComponentProps<\"button\">;\n\nexport const VolumeControlMute = ({\n  render,\n  className,\n  children,\n  ...props\n}: VolumeControlMuteProps) => {\n  const { disabled, level, muted, toggleMuted } =\n    useVolumeControl(\"VolumeControlMute\");\n  const label = muted ? \"Unmute\" : \"Mute\";\n\n  return useRender({\n    defaultTagName: \"button\",\n    props: mergeProps<\"button\">(\n      {\n        \"aria-label\": label,\n        \"aria-pressed\": muted,\n        children: children ?? <span className=\"text-xs\">{label}</span>,\n        className: cn(\n          \"text-muted-foreground hover:bg-muted hover:text-foreground focus-visible:ring-ring/30 inline-flex size-7 shrink-0 items-center justify-center rounded-lg transition-colors outline-none focus-visible:ring-3 disabled:pointer-events-none [&_svg:not([class*='size-'])]:size-4\",\n          !children && \"w-auto px-2\",\n          className\n        ),\n        disabled,\n        onClick: toggleMuted,\n        type: \"button\",\n      },\n      props\n    ),\n    render,\n    state: { level, muted, slot: \"volume-control-mute\" },\n  });\n};\n\nexport type VolumeControlSliderProps = Omit<\n  SliderPrimitive.Root.Props<number>,\n  | \"value\"\n  | \"defaultValue\"\n  | \"onValueChange\"\n  | \"onValueCommitted\"\n  | \"min\"\n  | \"max\"\n  | \"step\"\n  | \"orientation\"\n>;\n\nexport const VolumeControlSlider = ({\n  className,\n  ...props\n}: VolumeControlSliderProps) => {\n  const {\n    commit,\n    disabled,\n    muted,\n    orientation,\n    position,\n    setPosition,\n    step,\n    volume,\n  } = useVolumeControl(\"VolumeControlSlider\");\n  const horizontal = orientation === \"horizontal\";\n  const shown = muted ? 0 : position;\n\n  return (\n    <SliderPrimitive.Root\n      className={cn(\n        \"relative flex touch-none items-center select-none\",\n        horizontal ? \"w-full min-w-20\" : \"h-24 flex-col\",\n        className\n      )}\n      data-slot=\"volume-control-slider\"\n      disabled={disabled}\n      max={1}\n      min={0}\n      onValueChange={(next) => setPosition(next)}\n      onValueCommitted={commit}\n      orientation={orientation}\n      step={step}\n      value={shown}\n      {...props}\n    >\n      <SliderPrimitive.Control\n        className={cn(\n          \"relative flex items-center\",\n          horizontal\n            ? \"h-(--volume-thumb-size) w-full px-[calc(var(--volume-thumb-size)/2)] before:absolute before:inset-x-0 before:-inset-y-1.5 pointer-coarse:before:-inset-y-3\"\n            : \"h-full w-(--volume-thumb-size) flex-col py-[calc(var(--volume-thumb-size)/2)] before:absolute before:-inset-x-1.5 before:inset-y-0 pointer-coarse:before:-inset-x-3\"\n        )}\n      >\n        <SliderPrimitive.Track\n          className={cn(\n            \"bg-input/90 relative grow rounded-full\",\n            horizontal\n              ? \"h-(--volume-track-size) w-full\"\n              : \"h-full w-(--volume-track-size)\"\n          )}\n          data-slot=\"volume-control-track\"\n        >\n          <SliderPrimitive.Indicator\n            className={cn(\n              \"bg-primary rounded-full\",\n              horizontal ? \"h-full\" : \"w-full\"\n            )}\n            data-slot=\"volume-control-range\"\n          />\n          <SliderPrimitive.Thumb\n            aria-label=\"Volume\"\n            className=\"bg-background ring-foreground/15 hover:ring-ring/30 focus-visible:ring-ring/40 block size-(--volume-thumb-size) shrink-0 rounded-full shadow-sm ring-1 outline-hidden transition-[box-shadow] hover:ring-4 focus-visible:ring-4\"\n            data-slot=\"volume-control-thumb\"\n            getAriaValueText={() =>\n              muted ? \"Muted\" : `${Math.round(volume * PERCENT)}%`\n            }\n          />\n        </SliderPrimitive.Track>\n      </SliderPrimitive.Control>\n    </SliderPrimitive.Root>\n  );\n};\n\nexport const VolumeControlValue = ({\n  className,\n  ...props\n}: ComponentProps<\"span\">) => {\n  const { muted, position } = useVolumeControl(\"VolumeControlValue\");\n  return (\n    <span\n      className={cn(\n        \"text-muted-foreground w-9 shrink-0 text-end font-mono text-xs tabular-nums\",\n        className\n      )}\n      data-slot=\"volume-control-value\"\n      {...props}\n    >\n      {muted ? \"0%\" : `${Math.round(position * PERCENT)}%`}\n    </span>\n  );\n};\n\nexport interface VolumeControlProps extends Omit<\n  ComponentProps<\"div\">,\n  \"defaultValue\" | \"onChange\"\n> {\n  /** Volume, 0..1, like `HTMLMediaElement.volume`. */\n  value?: number;\n  /** Default 1. */\n  defaultValue?: number;\n  onValueChange?: (value: number) => void;\n  onValueCommitted?: (value: number) => void;\n  muted?: boolean;\n  defaultMuted?: boolean;\n  onMutedChange?: (muted: boolean) => void;\n  /** Slider step, in position. Default 0.05. */\n  step?: number;\n  /** How slider position maps to volume. Default `perceptual`. */\n  curve?: \"linear\" | \"perceptual\";\n  orientation?: Orientation;\n  size?: AudioSize;\n  disabled?: boolean;\n}\n\nexport const VolumeControl = ({\n  value: valueProp,\n  defaultValue = 1,\n  onValueChange,\n  onValueCommitted,\n  muted: mutedProp,\n  defaultMuted = false,\n  onMutedChange,\n  step = 0.05,\n  curve = \"perceptual\",\n  orientation = \"horizontal\",\n  size: sizeProp,\n  disabled: disabledProp,\n  className,\n  children,\n  ...props\n}: VolumeControlProps) => {\n  const config = useAudioConfig();\n  const size = sizeProp ?? config.size ?? \"default\";\n  const disabled = disabledProp ?? config.disabled ?? false;\n  const [uncontrolledVolume, setUncontrolledVolume] = useState(() =>\n    clamp(defaultValue, 0, 1)\n  );\n  const [uncontrolledMuted, setUncontrolledMuted] = useState(defaultMuted);\n  const volume = valueProp ?? uncontrolledVolume;\n  const muted = mutedProp ?? uncontrolledMuted;\n  const lastAudibleRef = useRef(volume > 0 ? volume : 1);\n  const mapping = curves[curve];\n\n  const setVolume = useCallback(\n    (next: number) => {\n      if (next > 0) {\n        lastAudibleRef.current = next;\n      }\n      if (valueProp === undefined) {\n        setUncontrolledVolume(next);\n      }\n      onValueChange?.(next);\n    },\n    [onValueChange, valueProp]\n  );\n\n  const setMuted = useCallback(\n    (next: boolean) => {\n      if (mutedProp === undefined) {\n        setUncontrolledMuted(next);\n      }\n      onMutedChange?.(next);\n    },\n    [mutedProp, onMutedChange]\n  );\n\n  const contextValue = useMemo<VolumeControlContextValue>(\n    () => ({\n      commit: () => onValueCommitted?.(volume),\n      disabled,\n      level: levelFor(volume, muted),\n      muted,\n      orientation,\n      position: mapping.toPosition(volume),\n      setPosition: (position: number) => {\n        const next = clamp(mapping.toVolume(position), 0, 1);\n        setVolume(next);\n        if (muted && next > 0) {\n          setMuted(false);\n        }\n      },\n      step,\n      toggleMuted: () => {\n        if (muted && volume <= 0) {\n          setVolume(lastAudibleRef.current);\n        }\n        setMuted(!muted);\n      },\n      volume,\n    }),\n    [\n      disabled,\n      mapping,\n      muted,\n      onValueCommitted,\n      orientation,\n      setMuted,\n      setVolume,\n      step,\n      volume,\n    ]\n  );\n\n  return (\n    <VolumeControlContext.Provider value={contextValue}>\n      <div\n        className={cn(\n          \"group/volume-control flex items-center gap-2 data-disabled:opacity-50\",\n          orientation === \"vertical\" && \"flex-col-reverse\",\n          size === \"sm\" &&\n            \"[--volume-thumb-size:0.75rem] [--volume-track-size:0.1875rem]\",\n          size === \"default\" &&\n            \"[--volume-thumb-size:0.875rem] [--volume-track-size:0.25rem]\",\n          size === \"lg\" &&\n            \"[--volume-thumb-size:1rem] [--volume-track-size:0.375rem]\",\n          className\n        )}\n        data-disabled={disabled ? \"\" : undefined}\n        data-level={levelFor(volume, muted)}\n        data-muted={muted ? \"\" : undefined}\n        data-orientation={orientation}\n        data-slot=\"volume-control\"\n        role=\"group\"\n        aria-label=\"Volume\"\n        {...props}\n      >\n        {children ?? (\n          <>\n            <VolumeControlMute />\n            <VolumeControlSlider />\n          </>\n        )}\n      </div>\n    </VolumeControlContext.Provider>\n  );\n};\n",
      "type": "registry:ui"
    }
  ],
  "type": "registry:ui"
}