Skip to content

mxyhi/ok-skills / ai-elements

ai-elements

Verified

Build AI chat interfaces using ai-elements components — conversations, messages, tool displays, prompt inputs, and more. Use when the user wants to build a chatbot, AI assistant UI, or any AI-powered chat interface.

FileKindSize
SKILL.mdskill md7.1 KB
references/agent.mdmarkdown4.1 KB
references/artifact.mdmarkdown2.9 KB
references/attachments.mdmarkdown5.6 KB
references/audio-player.mdmarkdown5.2 KB
references/canvas.mdmarkdown1.1 KB
references/chain-of-thought.mdmarkdown3.3 KB
references/checkpoint.mdmarkdown5.5 KB
references/code-block.mdmarkdown5.4 KB
references/commit.mdmarkdown5.8 KB
references/confirmation.mdmarkdown8.6 KB
references/connection.mdmarkdown1.1 KB
references/context.mdmarkdown5.6 KB
references/controls.mdmarkdown971 B
references/conversation.mdmarkdown7.4 KB
references/edge.mdmarkdown2.1 KB
references/environment-variables.mdmarkdown3.7 KB
references/file-tree.mdmarkdown2.0 KB
references/image.mdmarkdown4.0 KB
references/inline-citation.mdmarkdown10.8 KB
references/jsx-preview.mdmarkdown3.2 KB
references/message.mdmarkdown9.4 KB
references/mic-selector.mdmarkdown7.7 KB
references/model-selector.mdmarkdown4.3 KB
references/node.mdmarkdown2.8 KB
references/open-in-chat.mdmarkdown2.7 KB
references/package-info.mdmarkdown3.2 KB
references/panel.mdmarkdown1.0 KB
references/persona.mdmarkdown5.4 KB
references/plan.mdmarkdown3.2 KB
references/prompt-input.mdmarkdown19.8 KB
references/queue.mdmarkdown5.4 KB
references/reasoning.mdmarkdown7.8 KB
references/sandbox.mdmarkdown4.3 KB
references/schema-display.mdmarkdown2.5 KB
references/shimmer.mdmarkdown1.6 KB
references/snippet.mdmarkdown2.2 KB
references/sources.mdmarkdown6.2 KB
references/speech-input.mdmarkdown6.5 KB
references/stack-trace.mdmarkdown7.9 KB
references/suggestion.mdmarkdown3.6 KB
references/task.mdmarkdown6.7 KB
references/terminal.mdmarkdown3.1 KB
references/test-results.mdmarkdown5.0 KB
references/tool.mdmarkdown8.5 KB
references/toolbar.mdmarkdown983 B
references/transcription.mdmarkdown4.9 KB
references/voice-selector.mdmarkdown10.3 KB
references/web-preview.mdmarkdown6.1 KB
scripts/agent.tsxother1.6 KB
scripts/artifact.tsxother2.9 KB
scripts/attachments-inline.tsxother3.5 KB
scripts/attachments-list.tsxother2.2 KB
scripts/attachments.tsxother2.0 KB
scripts/audio-player-remote.tsxother1.0 KB
scripts/audio-player.tsxother1.8 KB
scripts/chain-of-thought.tsxother138.6 KB
scripts/checkpoint.tsxother2.8 KB
scripts/code-block-dark.tsxother1.0 KB
scripts/code-block.tsxother2.9 KB
scripts/commit.tsxother2.1 KB
scripts/confirmation-accepted.tsxother1.2 KB
scripts/confirmation-rejected.tsxother1.1 KB
scripts/confirmation-request.tsxother1.7 KB
scripts/confirmation.tsxother1.7 KB
scripts/context.tsxother1005 B
scripts/conversation.tsxother4.1 KB
scripts/environment-variables.tsxother1.7 KB
scripts/file-tree-basic.tsxother380 B
scripts/file-tree-expanded.tsxother609 B
scripts/file-tree-selection.tsxother619 B
scripts/file-tree.tsxother1.5 KB
scripts/image.tsxother136.5 KB
scripts/inline-citation.tsxother3.2 KB
scripts/jsx-preview.tsxother3.2 KB
scripts/message.tsxother10.1 KB
scripts/mic-selector.tsxother1.2 KB
scripts/model-selector.tsxother8.5 KB
scripts/open-in-chat.tsxother704 B
scripts/package-info.tsxother1.3 KB
scripts/persona-command.tsxother2.5 KB
scripts/persona-glint.tsxother2.5 KB
scripts/persona-halo.tsxother2.5 KB
scripts/persona-mana.tsxother2.5 KB
scripts/persona-obsidian.tsxother2.5 KB
scripts/persona-opal.tsxother2.5 KB
scripts/plan.tsxother1.9 KB
scripts/prompt-input-cursor.tsxother15.1 KB
scripts/prompt-input-tooltip.tsxother1.1 KB
scripts/prompt-input.tsxother7.4 KB
scripts/queue-prompt-input.tsxother10.5 KB
scripts/queue.tsxother8.0 KB
scripts/reasoning.tsxother2.2 KB
scripts/sandbox.tsxother5.4 KB
scripts/schema-display-basic.tsxother221 B
scripts/schema-display-body.tsxother487 B
scripts/schema-display-nested.tsxother470 B
scripts/schema-display-params.tsxother374 B
scripts/schema-display.tsxother2.7 KB
scripts/shimmer-duration.tsxother934 B
scripts/shimmer-elements.tsxother1.1 KB
scripts/shimmer.tsxother443 B
scripts/snippet-plain.tsxother362 B
scripts/snippet.tsxother589 B
scripts/sources-custom.tsxother1.0 KB
scripts/sources.tsxother752 B
scripts/speech-input.tsxother2.3 KB
scripts/stack-trace-collapsed.tsxother1.1 KB
scripts/stack-trace-no-internal.tsxother1.2 KB
scripts/stack-trace.tsxother1.9 KB
scripts/suggestion-input.tsxother4.4 KB
scripts/suggestion.tsxother802 B
scripts/task.tsxother1.5 KB
scripts/terminal-basic.tsxother169 B
scripts/terminal-clear.tsxother523 B
scripts/terminal-streaming.tsxother1007 B
scripts/terminal.tsxother2.3 KB
scripts/test-results-basic.tsxother464 B
scripts/test-results-errors.tsxother1.3 KB
scripts/test-results-suites.tsxother901 B
scripts/test-results.tsxother2.7 KB
scripts/tool-input-available.tsxother738 B
scripts/tool-input-streaming.tsxother683 B
scripts/tool-output-available.tsxother1.7 KB
scripts/tool-output-error.tsxother1.1 KB
scripts/tool.tsxother6.7 KB
scripts/transcription.tsxother4.9 KB
scripts/voice-selector.tsxother7.1 KB
scripts/web-preview.tsxother2.8 KB

references/mic-selector.md

View on GitHub
# Mic Selector

A composable dropdown component for selecting audio input devices with permission handling and device change detection.

The `MicSelector` component provides a flexible and composable interface for selecting microphone input devices. Built on shadcn/ui's Command and Popover components, it features automatic device detection, permission handling, dynamic device list updates, and intelligent device name parsing.

See `scripts/mic-selector.tsx` for this example.

## Installation

```bash
npx ai-elements@latest add mic-selector
```

## Features

- Fully composable architecture with granular control components
- Automatic audio input device enumeration
- Permission-based device name display
- Real-time device change detection via devicechange events
- Intelligent device label parsing with ID extraction
- Controlled and uncontrolled component patterns
- Responsive width matching between trigger and content
- Built on shadcn/ui Command and Popover components
- Full TypeScript support with proper types for all components

## Props

### `<MicSelector />`

Root Popover component that provides context for all child components.

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `defaultValue` | `string` | - | The default selected device ID (uncontrolled). |
| `value` | `string` | - | The selected device ID (controlled). |
| `onValueChange` | `(deviceId: string) => void` | - | Callback fired when the selected device changes. |
| `defaultOpen` | `boolean` | `false` | The default open state (uncontrolled). |
| `open` | `boolean` | - | The open state (controlled). |
| `onOpenChange` | `(open: boolean) => void` | - | Callback fired when the open state changes. Automatically requests microphone permission when opened without permission. |
| `...props` | `React.ComponentProps<typeof Popover>` | - | Any other props are spread to the Popover component. |

### `<MicSelectorTrigger />`

Button that opens the microphone selector popover. Automatically tracks its width to match the popover content.

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `...props` | `React.ComponentProps<typeof Button>` | - | Any other props are spread to the Button component. |

### `<MicSelectorValue />`

Displays the currently selected microphone name or a placeholder.

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `...props` | `React.ComponentProps<` | - | Any other props are spread to the span element. |

### `<MicSelectorContent />`

Container for the Command component, rendered inside the popover.

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `popoverOptions` | `React.ComponentProps<typeof PopoverContent>` | - | Props to pass to the underlying PopoverContent component. |
| `...props` | `React.ComponentProps<typeof Command>` | - | Any other props are spread to the Command component. |

### `<MicSelectorInput />`

Search input for filtering microphones.

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `...props` | `React.ComponentProps<typeof CommandInput>` | - | Any other props are spread to the CommandInput component. |

### `<MicSelectorList />`

Wrapper for the list of microphone items. Uses render props pattern to provide access to device data.

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `children` | `(devices: MediaDeviceInfo[]) => ReactNode` | - | Render function that receives the array of available devices. |
| `...props` | `Omit<React.ComponentProps<typeof CommandList>, ` | - | Any other props are spread to the CommandList component. |

### `<MicSelectorEmpty />`

Message shown when no microphones match the search.

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `children` | `ReactNode` | - | The message to display. |
| `...props` | `React.ComponentProps<typeof CommandEmpty>` | - | Any other props are spread to the CommandEmpty component. |

### `<MicSelectorItem />`

Selectable item representing a microphone.

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `value` | `string` | - | The device ID for this item. |
| `...props` | `React.ComponentProps<typeof CommandItem>` | - | Any other props are spread to the CommandItem component. |

### `<MicSelectorLabel />`

Displays a formatted microphone label with intelligent device ID parsing. Automatically extracts and styles device IDs in the format (XXXX:XXXX).

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `device` | `MediaDeviceInfo` | - | The MediaDeviceInfo object for the device. |
| `...props` | `React.ComponentProps<` | - | Any other props are spread to the span element. |

## Hooks

### `useAudioDevices()`

A custom hook for managing audio input devices. This hook is used internally by the `MicSelector` component but can also be used independently.

```tsx
import { useAudioDevices } from "@repo/elements/mic-selector";

export default function Example() {
  const { devices, loading, error, hasPermission, loadDevices } =
    useAudioDevices();

  return (
    <div>
      {loading && <p>Loading devices...</p>}
      {error && <p>Error: {error}</p>}
      {devices.map((device) => (
        <div key={device.deviceId}>{device.label}</div>
      ))}
      {!hasPermission && (
        <button onClick={loadDevices}>Grant Permission</button>
      )}
    </div>
  );
}
```

#### Return Value

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `devices` | `MediaDeviceInfo[]` | - | Array of available audio input devices. |
| `loading` | `boolean` | - | Whether devices are currently being loaded. |
| `error` | `string | null` | - | Error message if device loading failed. |
| `hasPermission` | `boolean` | - | Whether microphone permission has been granted. |
| `loadDevices` | `() => Promise<void>` | - | Function to request microphone permission and load device names. |

## Behavior

### Permission Handling

The component implements a two-stage permission approach:

1. **Without Permission**: Initially loads devices without requesting permission. Device labels may show as generic names (e.g., "Microphone 1").
2. **With Permission**: When the popover is opened and permission hasn't been granted, automatically requests microphone access and displays actual device names.

### Device Label Parsing

The `MicSelectorLabel` component intelligently parses device names that include hardware IDs in the format `(XXXX:XXXX)`. It splits the label into the device name and ID, styling the ID with muted text for better readability.

For example: `"MacBook Pro Microphone (1a2b:3c4d)"` becomes:

- Device name: `"MacBook Pro Microphone"`
- Device ID: `"(1a2b:3c4d)"` (styled with muted color)

### Width Synchronization

The `MicSelectorTrigger` uses a ResizeObserver to track its width and automatically synchronizes it with the `MicSelectorContent` popover width for a cohesive appearance.

### Device Change Detection

The component listens for `devicechange` events (e.g., plugging/unplugging microphones) and automatically updates the device list in real-time.

## Accessibility

- Uses semantic HTML with proper ARIA attributes via shadcn/ui components
- Full keyboard navigation support through Command component
- Screen reader friendly with proper labels and roles
- Searchable device list for quick selection

## Notes

- Requires a secure context (HTTPS or localhost) for microphone access
- Browser may prompt user for microphone permission on first open
- Device labels are only fully descriptive after permission is granted
- Component handles cleanup of temporary media streams during permission requests
- Uses Radix UI's `useControllableState` for flexible controlled/uncontrolled patterns
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall