{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "mic-setup",
  "title": "Microphone Setup",
  "description": "Choose and check a microphone: device select with a live preview, a level meter, gain, mute and a level check that says whether you sound right.",
  "dependencies": [
    "@phosphor-icons/react"
  ],
  "registryDependencies": [
    "alert",
    "button",
    "card",
    "field",
    "switch",
    "@audiocn/audio-device-select",
    "@audiocn/db-readout",
    "@audiocn/level-meter",
    "@audiocn/live-waveform",
    "@audiocn/parameter-slider",
    "@audiocn/use-audio-analyser",
    "@audiocn/use-audio-context",
    "@audiocn/use-audio-devices",
    "@audiocn/use-microphone",
    "@audiocn/use-gain-node"
  ],
  "files": [
    {
      "path": "components/blocks/mic-setup/mic-setup.tsx",
      "content": "\"use client\";\n\nimport {\n  CheckCircleIcon,\n  MicrophoneIcon,\n  WarningCircleIcon,\n} from \"@phosphor-icons/react\";\nimport { useEffect, useId, useRef, useState } from \"react\";\n\nimport { Alert, AlertDescription, AlertTitle } from \"@/components/ui/alert\";\nimport {\n  AudioDeviceSelect,\n  AudioDeviceSelectContent,\n  AudioDeviceSelectPreview,\n  AudioDeviceSelectTrigger,\n  AudioDeviceSelectValue,\n} from \"@/components/ui/audio-device-select\";\nimport { Button } from \"@/components/ui/button\";\nimport {\n  Card,\n  CardContent,\n  CardDescription,\n  CardHeader,\n  CardTitle,\n} from \"@/components/ui/card\";\nimport { DbReadout } from \"@/components/ui/db-readout\";\nimport { Field, FieldGroup, FieldLabel } from \"@/components/ui/field\";\nimport {\n  LevelMeter,\n  LevelMeterBar,\n  LevelMeterChannel,\n  LevelMeterChannels,\n  LevelMeterClip,\n  LevelMeterHold,\n  LevelMeterScale,\n  LevelMeterTrack,\n} from \"@/components/ui/level-meter\";\nimport { LiveWaveform } from \"@/components/ui/live-waveform\";\nimport {\n  ParameterSlider,\n  ParameterSliderControl,\n  ParameterSliderHeader,\n  ParameterSliderInput,\n  ParameterSliderLabel,\n  ParameterSliderReset,\n} from \"@/components/ui/parameter-slider\";\nimport { Switch } from \"@/components/ui/switch\";\nimport { useAudioAnalyser } from \"@/hooks/use-audio-analyser\";\nimport { useAudioDevices } from \"@/hooks/use-audio-devices\";\nimport { useGainNode } from \"@/hooks/use-gain-node\";\nimport { useMicrophone } from \"@/hooks/use-microphone\";\nimport { dbToGain } from \"@/lib/audio/decibels\";\nimport type { FrameSource, MeterFrame } from \"@/lib/audio/types\";\n\nconst CHECK_DURATION_MS = 3000;\n\ntype CheckResult = \"good\" | \"quiet\" | \"loud\" | \"silent\";\n\nconst RESULTS: Record<\n  CheckResult,\n  { title: string; description: string; ok: boolean }\n> = {\n  good: {\n    description: \"Your level sits in the right range.\",\n    ok: true,\n    title: \"Sounds good\",\n  },\n  loud: {\n    description: \"Your voice clipped. Lower the gain.\",\n    ok: false,\n    title: \"Too loud\",\n  },\n  quiet: {\n    description: \"Raise the gain or move closer.\",\n    ok: false,\n    title: \"Too quiet\",\n  },\n  silent: {\n    description: \"Check the device and that it is not muted.\",\n    ok: false,\n    title: \"No signal\",\n  },\n};\n\nconst judge = (peakDb: number): CheckResult => {\n  if (peakDb < -55) {\n    return \"silent\";\n  }\n  if (peakDb >= -1) {\n    return \"loud\";\n  }\n  if (peakDb < -30) {\n    return \"quiet\";\n  }\n  return \"good\";\n};\n\n/** Runs the microphone through a gain stage and analyses the result. */\nconst useMicInput = (\n  stream: MediaStream | null,\n  gainDb: number,\n  muted: boolean\n) => {\n  // Not routed to the speakers: the analyser taps it, and nothing else.\n  const gainNode = useGainNode({\n    destination: null,\n    gain: muted ? 0 : dbToGain(gainDb),\n    input: stream,\n  });\n  return useAudioAnalyser(stream ? gainNode : null, { historySize: 120 });\n};\n\n/** Listens for a few seconds, then judges the loudest peak. */\nconst useLevelCheck = (meter: FrameSource<MeterFrame>) => {\n  const [checking, setChecking] = useState(false);\n  const [result, setResult] = useState<CheckResult | null>(null);\n  const peakRef = useRef(Number.NEGATIVE_INFINITY);\n\n  useEffect(() => {\n    if (!checking) {\n      return;\n    }\n    peakRef.current = Number.NEGATIVE_INFINITY;\n    const unsubscribe = meter.subscribe((frame) => {\n      for (const level of frame.channels) {\n        peakRef.current = Math.max(peakRef.current, level.peakDb);\n      }\n    });\n    const timer = setTimeout(() => {\n      setChecking(false);\n      setResult(judge(peakRef.current));\n    }, CHECK_DURATION_MS);\n    return () => {\n      unsubscribe();\n      clearTimeout(timer);\n    };\n  }, [checking, meter]);\n\n  const start = () => {\n    setResult(null);\n    setChecking(true);\n  };\n\n  return { checking, result, start };\n};\n\nexport interface MicSetupProps {\n  deviceId?: string | null;\n  onDeviceChange?: (deviceId: string | null) => void;\n  gainDb?: number;\n  onGainChange?: (gainDb: number) => void;\n  muted?: boolean;\n  onMutedChange?: (muted: boolean) => void;\n  /** Open the microphone on mount instead of waiting for a click. Default false. */\n  autoStart?: boolean;\n  className?: string;\n}\n\nexport const MicSetup = ({\n  deviceId: deviceIdProp,\n  onDeviceChange,\n  gainDb: gainDbProp,\n  onGainChange,\n  muted: mutedProp,\n  onMutedChange,\n  autoStart = false,\n  className,\n}: MicSetupProps) => {\n  const muteId = useId();\n  const [started, setStarted] = useState(autoStart);\n  const [deviceIdState, setDeviceIdState] = useState<string | null>(null);\n  const [gainState, setGainState] = useState(0);\n  const [mutedState, setMutedState] = useState(false);\n  const deviceId = deviceIdProp === undefined ? deviceIdState : deviceIdProp;\n  const gainDb = gainDbProp ?? gainState;\n  const muted = mutedProp ?? mutedState;\n\n  const devices = useAudioDevices();\n  const microphone = useMicrophone({ deviceId, enabled: started });\n  const analyser = useMicInput(microphone.stream, gainDb, muted);\n  const { checking, result, start: startCheck } = useLevelCheck(analyser.meter);\n\n  const setDeviceId = (next: string | null) => {\n    setDeviceIdState(next);\n    onDeviceChange?.(next);\n  };\n  const setGain = (next: number) => {\n    setGainState(next);\n    onGainChange?.(next);\n  };\n  const setMuted = (next: boolean) => {\n    setMutedState(next);\n    onMutedChange?.(next);\n  };\n\n  const active = microphone.status === \"active\";\n  const verdict = result ? RESULTS[result] : null;\n\n  return (\n    <Card className={className}>\n      <CardHeader>\n        <CardTitle>Microphone</CardTitle>\n        <CardDescription>\n          Pick a microphone and check your level.\n        </CardDescription>\n      </CardHeader>\n      <CardContent>\n        <FieldGroup>\n          <Field>\n            <FieldLabel>Device</FieldLabel>\n            <AudioDeviceSelect\n              devices={devices.devices}\n              loading={devices.isLoading}\n              onRequestPermission={() => devices.requestPermission()}\n              onValueChange={setDeviceId}\n              permission={\n                devices.permission === \"unsupported\"\n                  ? \"denied\"\n                  : devices.permission\n              }\n              value={deviceId}\n            >\n              <AudioDeviceSelectTrigger>\n                <MicrophoneIcon className=\"text-muted-foreground\" />\n                <AudioDeviceSelectValue placeholder=\"Default microphone\" />\n              </AudioDeviceSelectTrigger>\n              <AudioDeviceSelectContent />\n            </AudioDeviceSelect>\n            <AudioDeviceSelectPreview className=\"relative\">\n              {active ? null : (\n                <Button\n                  className=\"absolute inset-0 z-10 m-auto w-fit\"\n                  onClick={() => setStarted(true)}\n                  size=\"xs\"\n                  variant=\"outline\"\n                >\n                  Turn on microphone\n                </Button>\n              )}\n              <LiveWaveform\n                active={active && !muted}\n                aria-label=\"Microphone preview\"\n                barWidth={2}\n                className=\"h-10\"\n                mode=\"scrolling\"\n                source={analyser.visual}\n              />\n            </AudioDeviceSelectPreview>\n          </Field>\n          <Field>\n            <div className=\"flex items-center justify-between\">\n              <FieldLabel>Level</FieldLabel>\n              <DbReadout\n                className=\"text-muted-foreground text-xs\"\n                holdMs={500}\n                source={analyser.meter}\n              />\n            </div>\n            <LevelMeter aria-label=\"Microphone level\" source={analyser.meter}>\n              <LevelMeterChannels>\n                <LevelMeterChannel>\n                  <LevelMeterTrack>\n                    <LevelMeterBar />\n                    <LevelMeterHold />\n                  </LevelMeterTrack>\n                </LevelMeterChannel>\n                <LevelMeterScale />\n              </LevelMeterChannels>\n              <LevelMeterClip />\n            </LevelMeter>\n          </Field>\n          <ParameterSlider\n            max={24}\n            min={-24}\n            onValueChange={setGain}\n            origin={0}\n            resetValue={0}\n            unit=\"dB\"\n            value={gainDb}\n          >\n            <ParameterSliderHeader>\n              <ParameterSliderLabel>Gain</ParameterSliderLabel>\n              <ParameterSliderReset />\n              <ParameterSliderInput />\n            </ParameterSliderHeader>\n            <ParameterSliderControl />\n          </ParameterSlider>\n          <Field orientation=\"horizontal\">\n            <Switch checked={muted} id={muteId} onCheckedChange={setMuted} />\n            <FieldLabel htmlFor={muteId}>Mute microphone</FieldLabel>\n          </Field>\n          <div className=\"flex flex-col gap-3\">\n            <Button\n              className=\"self-start\"\n              disabled={!active || checking}\n              onClick={startCheck}\n              variant=\"outline\"\n            >\n              {checking ? \"Listening… say a few words\" : \"Check level\"}\n            </Button>\n            {verdict ? (\n              <Alert variant={verdict.ok ? \"default\" : \"destructive\"}>\n                {verdict.ok ? <CheckCircleIcon /> : <WarningCircleIcon />}\n                <AlertTitle>{verdict.title}</AlertTitle>\n                <AlertDescription>{verdict.description}</AlertDescription>\n              </Alert>\n            ) : null}\n            {microphone.status === \"denied\" ? (\n              <Alert variant=\"destructive\">\n                <WarningCircleIcon />\n                <AlertTitle>Microphone blocked</AlertTitle>\n                <AlertDescription>\n                  Allow microphone access in your browser&apos;s site settings.\n                </AlertDescription>\n              </Alert>\n            ) : null}\n          </div>\n        </FieldGroup>\n      </CardContent>\n    </Card>\n  );\n};\n",
      "type": "registry:block"
    }
  ],
  "categories": [
    "microphone"
  ],
  "type": "registry:block"
}