@mantine/core 8.1.2 → 8.2.0

package/lib/components/PasswordInput/PasswordInput.d.ts

@@ -5,15 +5,15 @@ export type PasswordInputCssVariables = {
     root: '--psi-icon-size' | '--psi-button-size';
 };
 export interface PasswordInputProps extends BoxProps, __BaseInputProps, StylesApiProps<PasswordInputFactory>, ElementProps<'input', 'size'> {
-    /** A component to replace visibility toggle icon */
+    /** A component to replace the visibility toggle icon */
     visibilityToggleIcon?: React.FC<{
         reveal: boolean;
     }>;
     /** Props passed down to the visibility toggle button */
     visibilityToggleButtonProps?: Record<string, any>;
-    /** Determines whether input content should be visible */
+    /** If set, the input value is visible visible */
     visible?: boolean;
-    /** Determines whether input content should be visible by default */
+    /** If set, the input value is visible by default */
     defaultVisible?: boolean;
     /** Called when visibility changes */
     onVisibilityChange?: (visible: boolean) => void;

package/lib/components/Pill/Pill.d.ts

@@ -7,17 +7,17 @@ export type PillCssVariables = {
     root: '--pill-fz' | '--pill-radius' | '--pill-height';
 };
 export interface PillProps extends BoxProps, StylesApiProps<PillFactory>, ElementProps<'div'> {
-    /** Controls pill `font-size` and `padding`, `'sm'` by default */
+    /** Controls pill `font-size` and `padding` @default `'sm'` */
     size?: MantineSize;
-    /** Determines whether the remove button should be displayed, `false` by default */
+    /** Controls visibility of the remove button @default `false` */
     withRemoveButton?: boolean;
     /** Called when the remove button is clicked */
     onRemove?: () => void;
     /** Props passed down to the remove button */
     removeButtonProps?: CloseButtonProps & React.ComponentPropsWithoutRef<'button'>;
-    /** Key of `theme.radius` or any valid CSS value to set border-radius. Numbers are converted to rem. `'xl'` by default. */
+    /** Key of `theme.radius` or any valid CSS value to set border-radius. Numbers are converted to rem.  @default `'xl'` */
     radius?: MantineRadius;
-    /** If pill is disabled it has higher contrast to be visible on the disabled input background and the remove button is hidden */
+    /** Adds disabled attribute, applies disabled styles */
     disabled?: boolean;
 }
 export type PillFactory = Factory<{

package/lib/components/Pill/PillGroup/PillGroup.d.ts

@@ -6,9 +6,9 @@ export type PillGroupCssVariables = {
 export interface PillGroupProps extends BoxProps, StylesApiProps<PillGroupFactory>, ElementProps<'div'> {
     /** Controls spacing between pills, by default controlled by `size` */
     gap?: MantineSize | (string & {}) | number;
-    /** Controls size of the child `Pill` components and gap between them, `'sm'` by default */
+    /** Controls size of the child `Pill` components and gap between them @default `'sm'` */
     size?: MantineSize | (string & {});
-    /** Determines whether child `Pill` components should be disabled */
+    /** If set, adds disabled to all child `Pill` components */
     disabled?: boolean;
 }
 export type PillGroupFactory = Factory<{

package/lib/components/PillsInput/PillsInputField/PillsInputField.d.ts

@@ -1,7 +1,7 @@
 import { BoxProps, ElementProps, Factory, StylesApiProps } from '../../../core';
 export type PillsInputFieldStylesNames = 'field';
 export interface PillsInputFieldProps extends BoxProps, StylesApiProps<PillsInputFieldFactory>, ElementProps<'input', 'type'> {
-    /** Controls input styles when focused. If `auto` the input is hidden when not focused. If `visible` the input will always remain visible. `'visible'` by default  */
+    /** Controls input styles when focused. If `auto` the input is hidden when not focused. If `visible` the input will always remain visible. @default `'visible'` */
     type?: 'auto' | 'visible' | 'hidden';
     /** If set, cursor is changed to pointer */
     pointer?: boolean;

package/lib/components/PinInput/PinInput.d.ts

@@ -9,13 +9,13 @@ export interface PinInputProps extends BoxProps, StylesApiProps<PinInputFactory>
     name?: string;
     /** Hidden input `form` attribute */
     form?: string;
-    /** Key of `theme.spacing` or any valid CSS value to set `gap` between inputs, numbers are converted to rem, `'md'` by default */
+    /** Key of `theme.spacing` or any valid CSS value to set `gap` between inputs, numbers are converted to rem @default `'md'` */
     gap?: MantineSpacing;
-    /** Key of `theme.radius` or any valid CSS value to set `border-radius`, numbers are converted to rem, `theme.defaultRadius` by default */
+    /** Key of `theme.radius` or any valid CSS value to set `border-radius`, numbers are converted to rem @default `theme.defaultRadius` */
     radius?: MantineRadius;
-    /** Controls inputs `width` and `height`, `'sm'` by default */
+    /** Controls inputs `width` and `height` @default `'sm'` */
     size?: MantineSize;
-    /** If set, the first input is focused when component is mounted, `false` by default */
+    /** If set, the first input is focused when component is mounted @default `false` */
     autoFocus?: boolean;
     /** Controlled component value */
     value?: string;
@@ -25,23 +25,23 @@ export interface PinInputProps extends BoxProps, StylesApiProps<PinInputFactory>
     onChange?: (value: string) => void;
     /** Called when all inputs have value */
     onComplete?: (value: string) => void;
-    /** Inputs placeholder, `'○'` by default */
+    /** Inputs placeholder @default `'○'` */
     placeholder?: string;
-    /** Determines whether focus should be moved automatically to the next input once filled, `true` by default */
+    /** Determines whether focus should be moved automatically to the next input once filled @default `true` */
     manageFocus?: boolean;
-    /** Determines whether `autocomplete="one-time-code"` attribute should be set on all inputs, `true` by default */
+    /** Determines whether `autocomplete="one-time-code"` attribute should be set on all inputs @default `true` */
     oneTimeCode?: boolean;
-    /** Base id used for all inputs. By default, inputs' ids are generated randomly. */
+    /** Base id used to generate unique ids for inputs */
     id?: string;
-    /** If set, `disabled` attribute is added to all inputs */
+    /** Adds disabled attribute to all inputs */
     disabled?: boolean;
-    /** If set, adds error styles and `aria-invalid` attribute to all inputs */
+    /** Sets `aria-invalid` attribute and applies error styles to all inputs */
     error?: boolean;
-    /** Determines which values can be entered, `'alphanumeric'` by default */
+    /** Determines which values can be entered @default `'alphanumeric'` */
     type?: 'alphanumeric' | 'number' | RegExp;
-    /** Changes input type to `"password"`, `false` by default */
+    /** Changes input type to `"password"` @default `false` */
     mask?: boolean;
-    /** Number of inputs, `4` by default */
+    /** Number of inputs @default `4` */
     length?: number;
     /** If set, the user cannot edit the value */
     readOnly?: boolean;
@@ -49,7 +49,7 @@ export interface PinInputProps extends BoxProps, StylesApiProps<PinInputFactory>
     inputType?: React.HTMLInputTypeAttribute;
     /** `inputmode` attribute, inferred from the `type` prop if not specified */
     inputMode?: 'none' | 'text' | 'tel' | 'url' | 'email' | 'numeric' | 'decimal' | 'search' | undefined;
-    /** `aria-label` for the inputs */
+    /** `aria-label` attribute */
     ariaLabel?: string;
     /** Props passed down to the hidden input */
     hiddenInputProps?: React.ComponentPropsWithoutRef<'input'>;

package/lib/components/Popover/Popover.context.d.ts

@@ -1,5 +1,5 @@
 import { ClassNames, GetStylesApi, MantineRadius, MantineShadow, Styles } from '../../core';
-import { ArrowPosition, FloatingPosition, FloatingStrategy } from '../Floating';
+import { ArrowPosition, FloatingPosition, FloatingStrategy } from '../../utils/Floating';
 import { BasePortalProps } from '../Portal';
 import { TransitionOverride } from '../Transition';
 import type { PopoverFactory } from './Popover';

package/lib/components/Popover/Popover.d.ts

@@ -1,5 +1,5 @@
 import { ElementProps, ExtendComponent, Factory, MantineRadius, MantineShadow, StylesApiProps } from '../../core';
-import { ArrowPosition, FloatingAxesOffsets, FloatingPosition, FloatingStrategy } from '../Floating';
+import { ArrowPosition, FloatingAxesOffsets, FloatingPosition, FloatingStrategy } from '../../utils/Floating';
 import { OverlayProps } from '../Overlay';
 import { BasePortalProps } from '../Portal';
 import { TransitionOverride } from '../Transition';
@@ -9,9 +9,9 @@ export type PopoverCssVariables = {
     dropdown: '--popover-radius' | '--popover-shadow';
 };
 export interface __PopoverProps {
-    /** Dropdown position relative to the target element, `'bottom'` by default */
+    /** Dropdown position relative to the target element @default `'bottom'` */
     position?: FloatingPosition;
-    /** Offset of the dropdown element, `8` by default */
+    /** Offset of the dropdown element @default `8` */
     offset?: number | FloatingAxesOffsets;
     /** Called when dropdown position changes */
     onPositionChange?: (position: FloatingPosition) => void;
@@ -23,49 +23,49 @@ export interface __PopoverProps {
     onDismiss?: () => void;
     /** Called when dropdown opens */
     onOpen?: () => void;
-    /** If set dropdown will not be unmounted from the DOM when it is hidden, `display: none` styles will be added instead */
+    /** If set, the dropdown is not unmounted from the DOM when hidden. `display: none` styles are added instead. */
     keepMounted?: boolean;
-    /** Props passed down to the `Transition` component that used to animate dropdown presence, use to configure duration and animation type, `{ duration: 150, transition: 'fade' }` by default */
+    /** Props passed down to the `Transition` component. Use to configure duration and animation type. @default `{ duration: 150, transition: 'fade' }` */
     transitionProps?: TransitionOverride;
     /** Called when exit transition ends */
     onExitTransitionEnd?: () => void;
     /** Called when enter transition ends */
     onEnterTransitionEnd?: () => void;
-    /** Dropdown width, or `'target'` to make dropdown width the same as target element, `'max-content'` by default */
+    /** Dropdown width, or `'target'` to make dropdown width the same as target element @default `'max-content'` */
     width?: PopoverWidth;
-    /** Floating ui middlewares to configure position handling, `{ flip: true, shift: true, inline: false }` by default */
+    /** Floating ui middlewares to configure position handling @default `{ flip: true, shift: true, inline: false }` */
     middlewares?: PopoverMiddlewares;
-    /** Determines whether component should have an arrow, `false` by default */
+    /** Determines whether component should have an arrow @default `false` */
     withArrow?: boolean;
-    /** Determines whether the overlay should be displayed when the dropdown is opened, `false` by default */
+    /** Determines whether the overlay should be displayed when the dropdown is opened @default `false` */
     withOverlay?: boolean;
     /** Props passed down to `Overlay` component */
     overlayProps?: OverlayProps & ElementProps<'div'>;
-    /** Arrow size in px, `7` by default */
+    /** Arrow size in px @default `7` */
     arrowSize?: number;
-    /** Arrow offset in px, `5` by default */
+    /** Arrow offset in px @default `5` */
     arrowOffset?: number;
-    /** Arrow `border-radius` in px, `0` by default */
+    /** Arrow `border-radius` in px @default `0` */
     arrowRadius?: number;
     /** Arrow position */
     arrowPosition?: ArrowPosition;
-    /** Determines whether dropdown should be rendered within the `Portal`, `true` by default */
+    /** Determines whether dropdown should be rendered within the `Portal` @default `true` */
     withinPortal?: boolean;
     /** Props to pass down to the `Portal` when `withinPortal` is true */
     portalProps?: BasePortalProps;
-    /** Dropdown `z-index`, `300` by default */
+    /** Dropdown `z-index` @default `300` */
     zIndex?: string | number;
-    /** Key of `theme.radius` or any valid CSS value to set border-radius, `theme.defaultRadius` by default */
+    /** Key of `theme.radius` or any valid CSS value to set border-radius @default `theme.defaultRadius` */
     radius?: MantineRadius;
     /** Key of `theme.shadows` or any other valid CSS `box-shadow` value */
     shadow?: MantineShadow;
     /** If set, popover dropdown will not be rendered */
     disabled?: boolean;
-    /** Determines whether focus should be automatically returned to control when dropdown closes, `false` by default */
+    /** Determines whether focus should be automatically returned to control when dropdown closes @default `false` */
     returnFocus?: boolean;
-    /** Changes floating ui [position strategy](https://floating-ui.com/docs/usefloating#strategy), `'absolute'` by default */
+    /** Changes floating ui [position strategy](https://floating-ui.com/docs/usefloating#strategy) @default `'absolute'` */
     floatingStrategy?: FloatingStrategy;
-    /** If set, the dropdown is hidden when the element is hidden with styles or not visible on the screen, `true` by default */
+    /** If set, the dropdown is hidden when the element is hidden with styles or not visible on the screen @default `true` */
     hideDetached?: boolean;
     /** Prevents popover from flipping/shifting when it the dropdown is visible */
     preventPositionChangeWhenVisible?: boolean;
@@ -80,17 +80,17 @@ export interface PopoverProps extends __PopoverProps, StylesApiProps<PopoverFact
     opened?: boolean;
     /** Called with current state when dropdown opens or closes */
     onChange?: (opened: boolean) => void;
-    /** Determines whether dropdown should be closed on outside clicks, `true` by default */
+    /** Determines whether dropdown should be closed on outside clicks @default `true` */
     closeOnClickOutside?: boolean;
     /** Events that trigger outside clicks */
     clickOutsideEvents?: string[];
-    /** Determines whether focus should be trapped within dropdown, `false` by default */
+    /** Determines whether focus should be trapped within dropdown @default `false` */
     trapFocus?: boolean;
-    /** Determines whether dropdown should be closed when `Escape` key is pressed, `true` by default */
+    /** Determines whether dropdown should be closed when `Escape` key is pressed @default `true` */
     closeOnEscape?: boolean;
     /** Id base to create accessibility connections */
     id?: string;
-    /** Determines whether dropdown and target elements should have accessible roles, `true` by default */
+    /** Determines whether dropdown and target elements should have accessible roles @default `true` */
     withRoles?: boolean;
 }
 export type PopoverFactory = Factory<{

package/lib/components/Popover/PopoverTarget/PopoverTarget.d.ts

@@ -4,7 +4,7 @@ export interface PopoverTargetProps {
     children: React.ReactNode;
     /** Key of the prop that should be used to access element ref */
     refProp?: string;
-    /** Popup accessible type, `'dialog'` by default */
+    /** Popup accessible type @default `'dialog'` */
     popupType?: string;
 }
 export type PopoverTargetFactory = Factory<{

package/lib/components/Popover/use-popover.d.ts

@@ -1,4 +1,4 @@
-import { FloatingAxesOffsets, FloatingPosition, FloatingStrategy } from '../Floating';
+import { FloatingAxesOffsets, FloatingPosition, FloatingStrategy } from '../../utils/Floating';
 import { PopoverMiddlewares, PopoverWidth } from './Popover.types';
 interface UsePopoverOptions {
     offset: number | FloatingAxesOffsets;

package/lib/components/Portal/Portal.d.ts

@@ -2,7 +2,7 @@ import { Factory } from '../../core';
 export interface BasePortalProps extends React.ComponentPropsWithoutRef<'div'> {
     /** Element inside which portal should be created, by default a new div element is created and appended to the `document.body` */
     target?: HTMLElement | string;
-    /** If set, all portals are rendered in the same DOM node, `true` by default */
+    /** If set, all portals are rendered in the same DOM node @default `true` */
     reuseTargetNode?: boolean;
 }
 export interface PortalProps extends BasePortalProps {

package/lib/components/Progress/Progress.d.ts

@@ -6,11 +6,11 @@ export type ProgressStylesNames = ProgressRootStylesNames;
 export interface ProgressProps extends __ProgressRootProps, StylesApiProps<ProgressFactory> {
     /** Value of the progress */
     value: number;
-    /** Key of `theme.colors` or any valid CSS value, `theme.primaryColor` by default */
+    /** Key of `theme.colors` or any valid CSS value @default `theme.primaryColor` */
     color?: MantineColor;
-    /** Determines whether the section should have stripes, `false` by default */
+    /** If set, the section has stripes @default `false` */
     striped?: boolean;
-    /** Determines whether the sections stripes should be animated, if set, `striped` prop is ignored, `false` by default */
+    /** If set, the sections stripes are animated, `striped` prop is ignored @default `false` */
     animated?: boolean;
 }
 export type ProgressFactory = Factory<{

package/lib/components/Progress/ProgressRoot/ProgressRoot.d.ts

@@ -4,13 +4,13 @@ export type ProgressRootCssVariables = {
     root: '--progress-size' | '--progress-radius' | '--progress-transition-duration';
 };
 export interface __ProgressRootProps extends BoxProps, ElementProps<'div'> {
-    /** Controls track height, `'md'` by default */
+    /** Controls track height @default `'md'` */
     size?: MantineSize | (string & {}) | number;
-    /** Key of `theme.radius` or any valid CSS value to set `border-radius`, `theme.defaultRadius` by default */
+    /** Key of `theme.radius` or any valid CSS value to set `border-radius` @default `theme.defaultRadius` */
     radius?: MantineRadius;
-    /** Determines whether label text color should depend on `background-color`. If luminosity of the `color` prop is less than `theme.luminosityThreshold`, then `theme.white` will be used for text color, otherwise `theme.black`. Overrides `theme.autoContrast`. */
+    /** If set, adjusts text color based on background color for `filled` variant */
     autoContrast?: boolean;
-    /** Controls sections width transition duration, value is specified in ms, `100` by default */
+    /** Controls sections width transition duration, value is specified in ms @default `100` */
     transitionDuration?: number;
 }
 export interface ProgressRootProps extends __ProgressRootProps, StylesApiProps<ProgressRootFactory> {

package/lib/components/Progress/ProgressSection/ProgressSection.d.ts

@@ -1,15 +1,15 @@
 import { BoxProps, CompoundStylesApiProps, ElementProps, Factory, MantineColor } from '../../../core';
 export type ProgressSectionStylesNames = 'section';
 export interface ProgressSectionProps extends BoxProps, CompoundStylesApiProps<ProgressSectionFactory>, ElementProps<'div'> {
-    /** Value of the section in 0–100 range  */
+    /** Value of the section in 0–100 range */
     value: number;
-    /** Determines whether `aria-*` props should be added to the root element, `true` by default */
+    /** Determines whether `aria-*` props should be added to the root element @default `true` */
     withAria?: boolean;
-    /** Key of `theme.colors` or any valid CSS value, `theme.primaryColor` by default */
+    /** Key of `theme.colors` or any valid CSS value @default `theme.primaryColor` */
     color?: MantineColor;
-    /** Determines whether the section should have stripes, `false` by default */
+    /** If set, the section has stripes @default `false` */
     striped?: boolean;
-    /** Determines whether the sections stripes should be animated, if set, `striped` prop is ignored, `false` by default */
+    /** If set, the sections stripes are animated, `striped` prop is ignored @default `false` */
     animated?: boolean;
 }
 export type ProgressSectionFactory = Factory<{

package/lib/components/Radio/Radio.d.ts

@@ -1,5 +1,5 @@
 import { BoxProps, DataAttributes, ElementProps, Factory, MantineColor, MantineRadius, MantineSize, StylesApiProps } from '../../core';
-import { InlineInputStylesNames } from '../InlineInput';
+import { InlineInputStylesNames } from '../../utils/InlineInput';
 import { RadioCard } from './RadioCard/RadioCard';
 import { RadioGroup } from './RadioGroup/RadioGroup';
 import { RadioIconProps } from './RadioIcon';
@@ -12,27 +12,27 @@ export type RadioCssVariables = {
 export interface RadioProps extends BoxProps, StylesApiProps<RadioFactory>, ElementProps<'input', 'size' | 'children'> {
     /** Content of the `label` associated with the radio */
     label?: React.ReactNode;
-    /** Key of `theme.colors` or any valid CSS color to set input color in checked state, `theme.primaryColor` by default */
+    /** Key of `theme.colors` or any valid CSS color to set input color in checked state @default `theme.primaryColor` */
     color?: MantineColor;
-    /** Controls size of the component, `'sm'` by default */
+    /** Controls size of the component @default `'sm'` */
     size?: MantineSize | (string & {});
     /** A component that replaces default check icon */
     icon?: React.FC<RadioIconProps>;
     /** Props passed down to the root element */
     wrapperProps?: React.ComponentPropsWithoutRef<'div'> & DataAttributes;
-    /** Position of the label relative to the input, `'right'` by default */
+    /** Position of the label relative to the input @default `'right'` */
     labelPosition?: 'left' | 'right';
     /** Description displayed below the label */
     description?: React.ReactNode;
     /** Error displayed below the label */
     error?: React.ReactNode;
-    /** Key of `theme.radius` or any valid CSS value to set `border-radius,` "xl" by default */
+    /** Key of `theme.radius` or any valid CSS value to set `border-radius,` @default `'xl'` */
     radius?: MantineRadius;
     /** Assigns ref of the root element */
     rootRef?: React.ForwardedRef<HTMLDivElement>;
     /** Key of `theme.colors` or any valid CSS color to set icon color, by default value depends on `theme.autoContrast` */
     iconColor?: MantineColor;
-    /** Determines whether icon color with filled variant should depend on `background-color`. If luminosity of the `color` prop is less than `theme.luminosityThreshold`, then `theme.white` will be used for text color, otherwise `theme.black`. Overrides `theme.autoContrast`. */
+    /** If set, adjusts text color based on background color for `filled` variant */
     autoContrast?: boolean;
 }
 export type RadioFactory = Factory<{

package/lib/components/Radio/RadioCard/RadioCard.d.ts

@@ -6,9 +6,9 @@ export type RadioCardCssVariables = {
 export interface RadioCardProps extends BoxProps, StylesApiProps<RadioCardFactory>, ElementProps<'button', 'onChange'> {
     /** Checked state */
     checked?: boolean;
-    /** Determines whether the card should have border, `true` by default */
+    /** Adds border to the root element */
     withBorder?: boolean;
-    /** Key of `theme.radius` or any valid CSS value to set `border-radius`, numbers are converted to rem, `theme.defaultRadius` by default */
+    /** Key of `theme.radius` or any valid CSS value to set `border-radius`, numbers are converted to rem @default `theme.defaultRadius` */
     radius?: MantineRadius;
     /** Value of the checkbox, used with `Radio.Group` */
     value?: string;

package/lib/components/Radio/RadioGroup/RadioGroup.d.ts

@@ -6,13 +6,13 @@ export interface RadioGroupProps extends Omit<InputWrapperProps, 'onChange' | 'v
     children: React.ReactNode;
     /** Controlled component value */
     value?: string | null;
-    /** Default value for uncontrolled component */
+    /** Uncontrolled component default value */
     defaultValue?: string | null;
     /** Called when value changes */
     onChange?: (value: string) => void;
     /** Props passed down to the `Input.Wrapper` */
     wrapperProps?: React.ComponentPropsWithoutRef<'div'> & DataAttributes;
-    /** Controls size of the `Input.Wrapper`, `'sm'` by default */
+    /** Controls size of the `Input.Wrapper` @default `'sm'` */
     size?: MantineSize;
     /** `name` attribute of child radio inputs. By default, `name` is generated randomly. */
     name?: string;

package/lib/components/Radio/RadioIndicator/RadioIndicator.d.ts

@@ -6,21 +6,21 @@ export type RadioIndicatorCssVariables = {
     indicator: '--radio-size' | '--radio-radius' | '--radio-color' | '--radio-icon-color' | '--radio-icon-size';
 };
 export interface RadioIndicatorProps extends BoxProps, StylesApiProps<RadioIndicatorFactory>, ElementProps<'div'> {
-    /** Key of `theme.colors` or any valid CSS color to set input background color in checked state, `theme.primaryColor` by default */
+    /** Key of `theme.colors` or any valid CSS color to set input background color in checked state @default `theme.primaryColor` */
     color?: MantineColor;
-    /** Controls size of the component, `'sm'` by default */
+    /** Controls size of the component @default `'sm'` */
     size?: MantineSize | (string & {});
-    /** Key of `theme.radius` or any valid CSS value to set `border-radius,` `theme.defaultRadius` by default */
+    /** Key of `theme.radius` or any valid CSS value to set `border-radius,` @default `theme.defaultRadius` */
     radius?: MantineRadius;
     /** Key of `theme.colors` or any valid CSS color to set icon color, by default value depends on `theme.autoContrast` */
     iconColor?: MantineColor;
-    /** Determines whether icon color with filled variant should depend on `background-color`. If luminosity of the `color` prop is less than `theme.luminosityThreshold`, then `theme.white` will be used for text color, otherwise `theme.black`. Overrides `theme.autoContrast`. */
+    /** If set, adjusts text color based on background color for `filled` variant */
     autoContrast?: boolean;
     /** A component that replaces default check icon */
     icon?: React.FC<RadioIconProps>;
-    /** Determines whether the component should have checked styles */
+    /** Checked state */
     checked?: boolean;
-    /** Determines whether the component should have disabled styles */
+    /** Disabled state */
     disabled?: boolean;
 }
 export type RadioIndicatorFactory = Factory<{

package/lib/components/Rating/Rating.d.ts

@@ -4,9 +4,9 @@ export type RatingCssVariables = {
     root: '--rating-size' | '--rating-color';
 };
 export interface RatingProps extends BoxProps, StylesApiProps<RatingFactory>, ElementProps<'div', 'onChange'> {
-    /** Default value for uncontrolled component */
+    /** Uncontrolled component default value */
     defaultValue?: number;
-    /** Value for controlled component */
+    /** Controlled component value */
     value?: number;
     /** Called when value changes */
     onChange?: (value: number) => void;
@@ -14,11 +14,11 @@ export interface RatingProps extends BoxProps, StylesApiProps<RatingFactory>, El
     emptySymbol?: React.ReactNode | ((value: number) => React.ReactNode);
     /** Icon displayed when the symbol is full */
     fullSymbol?: React.ReactNode | ((value: number) => React.ReactNode);
-    /** Number of fractions each item can be divided into, `1` by default */
+    /** Number of fractions each item can be divided into @default `1` */
     fractions?: number;
-    /** Controls component size, `'sm'` by default */
+    /** Controls component size @default `'sm'` */
     size?: MantineSize | number | (string & {});
-    /** Number of controls, `5` by default */
+    /** Number of controls @default `5` */
     count?: number;
     /** Called when one of the controls is hovered */
     onHover?: (value: number) => void;
@@ -26,11 +26,11 @@ export interface RatingProps extends BoxProps, StylesApiProps<RatingFactory>, El
     getSymbolLabel?: (index: number) => string;
     /** `name` attribute passed down to all inputs. By default, `name` is generated randomly. */
     name?: string;
-    /** If set, the user cannot interact with the component, `false` by default */
+    /** If set, the user cannot interact with the component @default `false` */
     readOnly?: boolean;
-    /** If set, only the selected symbol changes to full symbol when selected, `false` by default */
+    /** If set, only the selected symbol changes to full symbol when selected @default `false` */
     highlightSelectedOnly?: boolean;
-    /** Key of `theme.colors` or any CSS color value, `'yellow'` by default */
+    /** Key of `theme.colors` or any CSS color value @default `'yellow'` */
     color?: MantineColor;
 }
 export type RatingFactory = Factory<{

package/lib/components/RingProgress/RingProgress.d.ts

@@ -11,9 +11,9 @@ export type RingProgressCssVariables = {
 export interface RingProgressProps extends BoxProps, StylesApiProps<RingProgressFactory>, ElementProps<'div'> {
     /** Label displayed in the center of the ring */
     label?: React.ReactNode;
-    /** Ring thickness */
+    /** Ring thickness @default 12 */
     thickness?: number;
-    /** Width and height of the progress ring */
+    /** Width and height of the progress ring @default 120 */
     size?: number;
     /** Sets whether the edges of the progress circle are rounded */
     roundCaps?: boolean;
@@ -21,7 +21,7 @@ export interface RingProgressProps extends BoxProps, StylesApiProps<RingProgress
     sections: RingProgressSection[];
     /** Color of the root section, key of theme.colors or CSS color value */
     rootColor?: MantineColor;
-    /** Transition duration of filled section styles changes in ms, `0` by default */
+    /** Transition duration of filled section styles changes in ms @default `0` */
     transitionDuration?: number;
 }
 export type RingProgressFactory = Factory<{

package/lib/components/ScrollArea/ScrollArea.d.ts

@@ -15,11 +15,11 @@ export interface ScrollAreaProps extends BoxProps, StylesApiProps<ScrollAreaFact
      * - `auto` – similar to `overflow: auto` – scrollbars are always visible when the content is overflowing
      * */
     type?: 'auto' | 'always' | 'scroll' | 'hover' | 'never';
-    /** Scroll hide delay in ms, applicable only when type is set to `hover` or `scroll`, `1000` by default */
+    /** Scroll hide delay in ms, applicable only when type is set to `hover` or `scroll` @default `1000` */
     scrollHideDelay?: number;
-    /** Axis at which scrollbars must be rendered, `'xy'` by default */
+    /** Axis at which scrollbars must be rendered @default `'xy'` */
     scrollbars?: 'x' | 'y' | 'xy' | false;
-    /** Determines whether scrollbars should be offset with padding on given axis, `false` by default */
+    /** Determines whether scrollbars should be offset with padding on given axis @default `false` */
     offsetScrollbars?: boolean | 'x' | 'y' | 'present';
     /** Assigns viewport element (scrollable container) ref */
     viewportRef?: React.ForwardedRef<HTMLDivElement>;

package/lib/components/SegmentedControl/SegmentedControl.d.ts

@@ -21,25 +21,25 @@ export interface SegmentedControlProps extends BoxProps, StylesApiProps<Segmente
     disabled?: boolean;
     /** Name of the radio group, by default random name is generated */
     name?: string;
-    /** Determines whether the component should take 100% width of its parent, `false` by default */
+    /** Determines whether the component should take 100% width of its parent @default `false` */
     fullWidth?: boolean;
     /** Key of `theme.colors` or any valid CSS color, changes color of indicator, by default color is based on current color scheme */
     color?: MantineColor;
-    /** Controls `font-size`, `padding` and `height` properties, `'sm'` by default */
+    /** Controls `font-size`, `padding` and `height` properties @default `'sm'` */
     size?: MantineSize | (string & {});
-    /** Key of `theme.radius` or any valid CSS value to set `border-radius`, numbers are converted to rem, `theme.defaultRadius` by default */
+    /** Key of `theme.radius` or any valid CSS value to set `border-radius`, numbers are converted to rem @default `theme.defaultRadius` */
     radius?: MantineRadius;
-    /** Indicator `transition-duration` in ms, set `0` to turn off transitions, `200` by default */
+    /** Indicator `transition-duration` in ms, set `0` to turn off transitions @default `200` */
     transitionDuration?: number;
-    /** Indicator `transition-timing-function` property, `ease` by default */
+    /** Indicator `transition-timing-function` property @default `ease` */
     transitionTimingFunction?: string;
-    /** Determines in which orientation component id displayed, `'horizontal'` by default */
+    /** Component orientation @default `'horizontal'` */
     orientation?: 'vertical' | 'horizontal';
-    /** Determines whether the value can be changed */
+    /** If set to `false`, prevents changing the value */
     readOnly?: boolean;
-    /** Determines whether text color should depend on `background-color` of the indicator. If luminosity of the `color` prop is less than `theme.luminosityThreshold`, then `theme.white` will be used for text color, otherwise `theme.black`. Overrides `theme.autoContrast`. */
+    /** If set, adjusts text color based on background color for `filled` variant */
     autoContrast?: boolean;
-    /** Determines whether there should be borders between items, `true` by default */
+    /** Determines whether there should be borders between items @default `true` */
     withItemsBorders?: boolean;
 }
 export type SegmentedControlFactory = Factory<{

package/lib/components/Select/Select.d.ts

@@ -12,13 +12,13 @@ export interface SelectProps extends BoxProps, __BaseInputProps, ComboboxLikePro
     onChange?: (value: string | null, option: ComboboxItem) => void;
     /** Called when the clear button is clicked */
     onClear?: () => void;
-    /** Determines whether the select should be searchable, `false` by default */
+    /** Determines whether the select should be searchable @default `false` */
     searchable?: boolean;
-    /** Determines whether check icon should be displayed near the selected option label, `true` by default */
+    /** If set, the check icon is displayed near the selected option label @default `true` */
     withCheckIcon?: boolean;
-    /** Position of the check icon relative to the option label, `'left'` by default */
+    /** Position of the check icon relative to the option label @default `'left'` */
     checkIconPosition?: 'left' | 'right';
-    /** Message displayed when no option matches the current search query while the `searchable` prop is set or there is no data */
+    /** Message displayed when no option matches the current search query when the `searchable` prop is set or there is no data */
     nothingFoundMessage?: React.ReactNode;
     /** Controlled search value */
     searchValue?: string;
@@ -26,12 +26,12 @@ export interface SelectProps extends BoxProps, __BaseInputProps, ComboboxLikePro
     defaultSearchValue?: string;
     /** Called when search changes */
     onSearchChange?: (value: string) => void;
-    /** Determines whether it should be possible to deselect value by clicking on the selected option, `true` by default */
+    /** If set, it becomes possible to deselect value by clicking on the selected option @default `true` */
     allowDeselect?: boolean;
-    /** Determines whether the clear button should be displayed in the right section when the component has value, `false` by default */
+    /** If set, the clear button is displayed in the right section when the component has value @default `false` */
     clearable?: boolean;
     /** Props passed down to the clear button */
-    clearButtonProps?: InputClearButtonProps & ElementProps<'button'>;
+    clearButtonProps?: InputClearButtonProps;
     /** Props passed down to the hidden input */
     hiddenInputProps?: Omit<React.ComponentPropsWithoutRef<'input'>, 'value'>;
     /** A function to render content of the option, replaces the default content of the option */
@@ -40,6 +40,8 @@ export interface SelectProps extends BoxProps, __BaseInputProps, ComboboxLikePro
     scrollAreaProps?: ScrollAreaProps;
     /** Controls color of the default chevron, by default depends on the color scheme */
     chevronColor?: MantineColor;
+    /** If set, the highlighted option is selected when the input loses focus @default `false` */
+    autoSelectOnBlur?: boolean;
 }
 export type SelectFactory = Factory<{
     props: SelectProps;