# Radio

Radio button component with label, tooltip support, and reactive group selection. All radios in the same group share a common `name` attribute for proper HTML semantics.

## Tag

`Radio`

## Props

| Prop | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| `label` | `string` | `-` | Label text for the radio button |
| `value` | `string \| Signal<string>` | `-` | Selected value signal for the group |
| `inputValue` | `string` | `-` | Value of this radio button |
| `name` | `string` | `-` | Group name (all radios in group should share this) |
| `tooltip` | `string` | `-` | Tooltip text on hover |
| `disabled` | `boolean \| Signal<boolean>` | `false` | Disabled state |
| `class` | `string` | `''` | Additional CSS classes (DaisyUI + Tailwind) |
| `onclick` | `function` | `-` | Click event handler |

## Styling

Radio supports all **daisyUI Radio classes**:

| Category | Keywords | Description |
| :--- | :--- | :--- |
| Color | `radio-primary`, `radio-secondary`, `radio-accent`, `radio-info`, `radio-success`, `radio-warning`, `radio-error` | Radio color variants |
| Size | `radio-xs`, `radio-sm`, `radio-md`, `radio-lg` | Radio scale |

> For further details, check the [daisyUI Radio Documentation](https://daisyui.com/components/radio) – Full reference for CSS classes.

## Live Examples

### Basic Radio Group

<div class="card bg-base-200 border border-base-300 shadow-sm my-6">
  <div class="card-body">
    <h3 class="card-title text-sm uppercase opacity-50 mb-4">Live Demo</h3>
    <div id="demo-basic" class="bg-base-100 p-6 rounded-xl border border-base-300 flex flex-col gap-3"></div>
  </div>
</div>

```javascript
const BasicDemo = () => {
  const selected = $('option1');
  
  return Div({ class: 'flex flex-col gap-3' }, [
    Radio({
      label: 'Option 1',
      name: 'basic-group',
      value: selected,
      inputValue: 'option1',
      onclick: () => selected('option1')
    }),
    Radio({
      label: 'Option 2',
      name: 'basic-group',
      value: selected,
      inputValue: 'option2',
      onclick: () => selected('option2')
    }),
    Radio({
      label: 'Option 3',
      name: 'basic-group',
      value: selected,
      inputValue: 'option3',
      onclick: () => selected('option3')
    }),
    Div({ class: 'mt-2 text-sm opacity-70' }, () => `Selected: ${selected()}`)
  ]);
};
Mount(BasicDemo, '#demo-basic');
```

### With Tooltip

<div class="card bg-base-200 border border-base-300 shadow-sm my-6">
  <div class="card-body">
    <h3 class="card-title text-sm uppercase opacity-50 mb-4">Live Demo</h3>
    <div id="demo-tooltip" class="bg-base-100 p-6 rounded-xl border border-base-300 flex flex-col gap-3"></div>
  </div>
</div>

```javascript
const TooltipDemo = () => {
  const selected = $('light');
  
  return Div({ class: 'flex flex-col gap-3' }, [
    Radio({
      label: 'Light mode',
      name: 'theme-group',
      value: selected,
      inputValue: 'light',
      tooltip: 'Light theme with white background',
      onclick: () => selected('light')
    }),
    Radio({
      label: 'Dark mode',
      name: 'theme-group',
      value: selected,
      inputValue: 'dark',
      tooltip: 'Dark theme with black background',
      onclick: () => selected('dark')
    })
  ]);
};
Mount(TooltipDemo, '#demo-tooltip');
```

### Disabled State

<div class="card bg-base-200 border border-base-300 shadow-sm my-6">
  <div class="card-body">
    <h3 class="card-title text-sm uppercase opacity-50 mb-4">Live Demo</h3>
    <div id="demo-disabled" class="bg-base-100 p-6 rounded-xl border border-base-300 flex flex-col gap-3"></div>
  </div>
</div>

```javascript
const DisabledDemo = () => {
  const selected = $('enabled');
  
  return Div({ class: 'flex flex-col gap-3' }, [
    Radio({
      label: 'Enabled option',
      name: 'disabled-group',
      value: selected,
      inputValue: 'enabled',
      onclick: () => selected('enabled')
    }),
    Radio({
      label: 'Disabled option (cannot select)',
      name: 'disabled-group',
      value: selected,
      inputValue: 'disabled',
      disabled: true,
      onclick: () => selected('disabled')
    })
  ]);
};
Mount(DisabledDemo, '#demo-disabled');
```

### Reactive Preview

<div class="card bg-base-200 border border-base-300 shadow-sm my-6">
  <div class="card-body">
    <h3 class="card-title text-sm uppercase opacity-50 mb-4">Live Demo</h3>
    <div id="demo-reactive" class="bg-base-100 p-6 rounded-xl border border-base-300"></div>
  </div>
</div>

```javascript
const ReactiveDemo = () => {
  const size = $('medium');
  const color = $('blue');
  
  const sizes = [
    { value: 'small', label: 'Small' },
    { value: 'medium', label: 'Medium' },
    { value: 'large', label: 'Large' }
  ];
  
  const colors = [
    { value: 'blue', label: 'Blue' },
    { value: 'green', label: 'Green' },
    { value: 'red', label: 'Red' }
  ];
  
  return Div({ class: 'flex flex-col gap-4' }, [
    Div({ class: 'text-sm font-bold' }, 'Select size'),
    Div({ class: 'flex gap-4' }, sizes.map(s => 
      Radio({
        label: s.label,
        name: 'size-group',
        value: size,
        inputValue: s.value,
        onclick: () => size(s.value)
      })
    )),
    Div({ class: 'text-sm font-bold mt-2' }, 'Select color'),
    Div({ class: 'flex gap-4' }, colors.map(c => 
      Radio({
        label: c.label,
        name: 'color-group',
        value: color,
        inputValue: c.value,
        onclick: () => color(c.value)
      })
    )),
    Div({ 
      class: 'mt-4 p-4 rounded-lg text-center transition-all',
      style: () => {
        const sizeMap = { small: 'text-sm', medium: 'text-base', large: 'text-lg' };
        const colorMap = { blue: '#3b82f6', green: '#10b981', red: '#ef4444' };
        return `background-color: ${colorMap[color()]}; color: white; ${sizeMap[size()]}`;
      }
    }, () => `${size()} ${color()} preview`)
  ]);
};
Mount(ReactiveDemo, '#demo-reactive');
```

### Payment Method Selection

<div class="card bg-base-200 border border-base-300 shadow-sm my-6">
  <div class="card-body">
    <h3 class="card-title text-sm uppercase opacity-50 mb-4">Live Demo</h3>
    <div id="demo-payment" class="bg-base-100 p-6 rounded-xl border border-base-300"></div>
  </div>
</div>

```javascript
const PaymentDemo = () => {
  const method = $('credit');
  
  return Div({ class: 'flex flex-col gap-4' }, [
    Div({ class: 'text-sm font-bold' }, 'Payment method'),
    Div({ class: 'flex flex-col gap-3' }, [
      Radio({
        label: '💳 Credit Card',
        name: 'payment-group',
        value: method,
        inputValue: 'credit',
        onclick: () => method('credit')
      }),
      Radio({
        label: '🏦 Bank Transfer',
        name: 'payment-group',
        value: method,
        inputValue: 'bank',
        onclick: () => method('bank')
      }),
      Radio({
        label: '📱 Digital Wallet',
        name: 'payment-group',
        value: method,
        inputValue: 'wallet',
        onclick: () => method('wallet')
      })
    ]),
    Div({ class: 'alert alert-info mt-2' }, () => {
      const messages = {
        credit: 'You selected Credit Card. Enter your card details.',
        bank: 'You selected Bank Transfer. Use the provided account number.',
        wallet: 'You selected Digital Wallet. Scan the QR code to pay.'
      };
      return messages[method()];
    })
  ]);
};
Mount(PaymentDemo, '#demo-payment');
```

### All Variants

<div class="card bg-base-200 border border-base-300 shadow-sm my-6">
  <div class="card-body">
    <h3 class="card-title text-sm uppercase opacity-50 mb-4">Live Demo</h3>
    <div id="demo-variants" class="bg-base-100 p-6 rounded-xl border border-base-300 flex flex-col gap-4"></div>
  </div>
</div>

```javascript
const VariantsDemo = () => {
  const primary = $('primary1');
  const secondary = $('secondary1');
  const accent = $('accent1');
  
  return Div({ class: 'flex flex-col gap-4' }, [
    Div({ class: 'card bg-base-200 p-4' }, [
      Div({ class: 'text-sm font-bold mb-2' }, 'Primary variant'),
      Div({ class: 'flex gap-4' }, [
        Radio({
          label: 'Option A',
          name: 'primary-group',
          value: primary,
          inputValue: 'primary1',
          class: 'radio-primary',
          onclick: () => primary('primary1')
        }),
        Radio({
          label: 'Option B',
          name: 'primary-group',
          value: primary,
          inputValue: 'primary2',
          class: 'radio-primary',
          onclick: () => primary('primary2')
        })
      ])
    ]),
    Div({ class: 'card bg-base-200 p-4' }, [
      Div({ class: 'text-sm font-bold mb-2' }, 'Secondary variant'),
      Div({ class: 'flex gap-4' }, [
        Radio({
          label: 'Option A',
          name: 'secondary-group',
          value: secondary,
          inputValue: 'secondary1',
          class: 'radio-secondary',
          onclick: () => secondary('secondary1')
        }),
        Radio({
          label: 'Option B',
          name: 'secondary-group',
          value: secondary,
          inputValue: 'secondary2',
          class: 'radio-secondary',
          onclick: () => secondary('secondary2')
        })
      ])
    ]),
    Div({ class: 'card bg-base-200 p-4' }, [
      Div({ class: 'text-sm font-bold mb-2' }, 'Accent variant'),
      Div({ class: 'flex gap-4' }, [
        Radio({
          label: 'Option A',
          name: 'accent-group',
          value: accent,
          inputValue: 'accent1',
          class: 'radio-accent',
          onclick: () => accent('accent1')
        }),
        Radio({
          label: 'Option B',
          name: 'accent-group',
          value: accent,
          inputValue: 'accent2',
          class: 'radio-accent',
          onclick: () => accent('accent2')
        })
      ])
    ])
  ]);
};
Mount(VariantsDemo, '#demo-variants');
```

### Dynamic Options

<div class="card bg-base-200 border border-base-300 shadow-sm my-6">
  <div class="card-body">
    <h3 class="card-title text-sm uppercase opacity-50 mb-4">Live Demo</h3>
    <div id="demo-dynamic" class="bg-base-100 p-6 rounded-xl border border-base-300"></div>
  </div>
</div>

```javascript
const DynamicDemo = () => {
  const category = $('cars');
  const selected = $('');
  
  const options = {
    cars: [
      { value: 'sedan', label: 'Sedan' },
      { value: 'suv', label: 'SUV' },
      { value: 'sports', label: 'Sports' }
    ],
    colors: [
      { value: 'red', label: 'Red' },
      { value: 'blue', label: 'Blue' },
      { value: 'black', label: 'Black' }
    ]
  };
  
  return Div({ class: 'flex flex-col gap-4' }, [
    Div({ class: 'flex gap-4' }, [
      Radio({
        label: 'Cars',
        name: 'category-group',
        value: category,
        inputValue: 'cars',
        onclick: () => {
          category('cars');
          selected('');
        }
      }),
      Radio({
        label: 'Colors',
        name: 'category-group',
        value: category,
        inputValue: 'colors',
        onclick: () => {
          category('colors');
          selected('');
        }
      })
    ]),
    Div({ class: 'divider my-1' }),
    Div({ class: 'text-sm font-bold' }, () => `Select ${category()}`),
    Div({ class: 'flex flex-col gap-2' }, () => 
      options[category()].map(opt => 
        Radio({
          label: opt.label,
          name: 'dynamic-option-group',
          value: selected,
          inputValue: opt.value,
          onclick: () => selected(opt.value)
        })
      )
    ),
    () => selected() 
      ? Div({ class: 'alert alert-success mt-2' }, () => `Selected ${category()}: ${selected()}`)
      : null
  ]);
};
Mount(DynamicDemo, '#demo-dynamic');
```