# `m-toaster`

A toaster is a temporary notification that appears briefly on the screen to provide feedback or updates without interrupting the user’s workflow. It is commonly used for success messages, warnings, errors, or informational updates. Toasters can disappear automatically after a few seconds, be dismissed manually via a close button, or be removed when the user performs a relevant action. They typically include an icon, a short message, and an optional close button for better usability.

## Props

| Name | Description | Type | Default |
|------|-------------|------|---------|
| `open` | If `true`, display the Toaster. | `boolean` |   |
| `position` | Position of the toaster. | `'top'` `'bottom'` `'top-center'` `'bottom-center'` | `top` |
| `description*` | Description of the toaster. | `string` |   |
| `status` | Allows to define the toaster style. | `'info'` `'success'` `'warning'` `'error'` | `info` |
| `closable` | If `true`, display the close button. | `boolean` | `true` |
| `progress` | If `true`, display the progress bar of the duration. | `boolean` |   |
| `timeout` | Duration of the toaster | `number` |   |
| `onUpdateOpen` | Callback fired when the toaster open state changes. | `(open: boolean) => void` |   |

## Slots

| Name | Description |
|------|-------------|
| `action` | Use this slot to insert a button or a link in the toaster |

## Events

| Name | Description | Type |
|------|------|-------------|
| `update:open` | Fired when the open state changes. | `CustomEvent<boolean>` |

