# Deprecations

<!-- AUTO-GENERATED from the @riverty/web-components custom elements manifest. Do not edit by hand. -->

Deprecated props, events, and methods are still functional but will be removed in a future major release.
Always use the replacement described in the **Notice** column — never add new usage of deprecated API.

## `r-alert`

| Kind | Property | Attribute (HTML) | Notice |
|---|---|---|---|
| field | `delay` | `delay` | Use `delayMs` instead. This property uses seconds and will be removed in a future version. Provide an amount of seconds before alert collapses when `dismissMode="auto"`. |
| field | `delayBeforeRemoval` | `delay-before-removal` | Alert shall be dismissed by user action. Will be removed within next major version. Defines amount of time im miliseconds before alert is removed from DOM. |
| field | `delayMs` | `delay-ms` | Alert shall be dismissed by user action. Will be removed within next major version. Defines the amount of time in milliseconds before the alert is automatically dismissed. Only applies when `dismissMode="auto"`. If both `delay` and `delayMs` are set, `delayMs` takes precedence. |
| event | `rClickAlertTrailingIcon` | — | Use `rAlertDismiss` instead. Emit click on trigger |

## `r-checkbox-group`

| Kind | Property | Attribute (HTML) | Notice |
|---|---|---|---|
| field | `indetermitate` | `indetermitate` | – use `indeterminate` instead; will be removed during next major release. Specifies if select-all checkbox is initially in indetermitate state |

## `r-float`

| Kind | Property | Attribute (HTML) | Notice |
|---|---|---|---|
| field | `anchorEl` | — | Use `setAnchorRef()` for imperative element references. Backward-compatible usage (property assignment, not HTML attribute): `const float = document.querySelector('r-float');` `float.anchorEl = triggerElement;` For new code, prefer: `float.setAnchorRef(triggerElement)`. Direct HTMLElement reference to use as the anchor. Takes precedence over `trigger`. Use this when the trigger lives inside a shadow root that `document.querySelector` cannot pierce. |

## `r-icon-button`

| Kind | Property | Attribute (HTML) | Notice |
|---|---|---|---|
| field | `tooltipPosition` | `tooltip-position` | Use the `<r-tooltip>` component as a wrapper instead. Sets position for the tooltip. - `top`: Tooltip appears above the button. - `bottom`: Tooltip appears below the button. - `left`: Tooltip appears to the left of the button. - `right`: Tooltip appears to the right of the button. |
| field | `tooltipText` | `tooltip-text` | Use the `<r-tooltip>` component as a wrapper instead. Text to display within the tooltip when the button is hovered or focused. |

## `r-illustration`

| Kind | Property | Attribute (HTML) | Notice |
|---|---|---|---|
| field | `emptyImageTitle` | `empty-image-title` | Use `errorAlt` instead. Retained as a fallback when `errorAlt` is unset. |
| field | `emptyMarkerTitle` | `empty-marker-title` | No longer rendered: the error state is a single SVG labelled by `errorAlt`. Accepted and ignored for backwards compatibility; will be removed in the next major. |

## `r-input`

| Kind | Property | Attribute (HTML) | Notice |
|---|---|---|---|
| field | `validityMarker` | `validity-marker` | Will be removed in the next major version. Use 'marker' prop instead. |

## `r-pagination`

| Kind | Property | Attribute (HTML) | Notice |
|---|---|---|---|
| field | `itemsPerPageOptions` | — | Use setItemsPerPageOptions(...) instead. This prop will be removed in the next major release. |

## `r-stepper`

| Kind | Property | Attribute (HTML) | Notice |
|---|---|---|---|
| field | `completeSteps` | `complete-steps` | (use `completed` instead) Completed steps. Default value 0 |

## `r-stepper-item`

| Kind | Property | Attribute (HTML) | Notice |
|---|---|---|---|
| field | `stepNumber` | `step-number` | (use `number` instead) Index of the progress step |

## `r-toast`

| Kind | Property | Attribute (HTML) | Notice |
|---|---|---|---|
| field | `delayBeforeRemoval` | `delay-before-removal` | - will be removed within next major release Defines amount of time im miliseconds before toast is removed from DOM. |

## General Rules

1. **Prefer the replacement now** — deprecated members still work but will break on the next major version bump.
2. **Never add new usage of deprecated API** — if you are generating new markup or code, only use current (non-deprecated) API.
3. **When both old and new props exist together**, the new one takes precedence (e.g. `delayMs` over `delay`).