@mantine/core 8.1.3 → 8.2.1

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;

package/lib/components/SemiCircleProgress/SemiCircleProgress.d.ts

@@ -6,23 +6,23 @@ export type SemiCircleProgressCssVariables = {
 export interface SemiCircleProgressProps extends BoxProps, StylesApiProps<SemiCircleProgressFactory>, ElementProps<'div'> {
     /** Progress value from `0` to `100` */
     value: number;
-    /** Diameter of the svg in px, `200` by default */
+    /** Diameter of the svg in px @default `200` */
     size?: number;
-    /** Circle thickness in px, `12` by default */
+    /** Circle thickness in px @default `12` */
     thickness?: number;
-    /** Orientation of the circle, `'up'` by default */
+    /** Orientation of the circle @default `'up'` */
     orientation?: 'up' | 'down';
-    /** Direction from which the circle is filled, `'left-to-right'` by default */
+    /** Direction from which the circle is filled @default `'left-to-right'` */
     fillDirection?: 'right-to-left' | 'left-to-right';
-    /** Key of `theme.colors` or any valid CSS color value, `theme.primaryColor` by default */
+    /** Key of `theme.colors` or any valid CSS color value @default `theme.primaryColor` */
     filledSegmentColor?: MantineColor;
     /** Key of `theme.colors` or any valid CSS color value, by default the value is determined based on the color scheme value */
     emptySegmentColor?: 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;
     /** Label rendered inside the circle */
     label?: React.ReactNode;
-    /** Label position relative to the circle center, `'bottom'` by default */
+    /** Label position relative to the circle center @default `'bottom'` */
     labelPosition?: 'center' | 'bottom';
 }
 export type SemiCircleProgressFactory = Factory<{

package/lib/components/SimpleGrid/SimpleGrid.d.ts

@@ -1,13 +1,13 @@
 import { BoxProps, ElementProps, Factory, MantineSpacing, StyleProp, StylesApiProps } from '../../core';
 export type SimpleGridStylesNames = 'root' | 'container';
 export interface SimpleGridProps extends BoxProps, StylesApiProps<SimpleGridFactory>, ElementProps<'div'> {
-    /** Number of columns, `1` by default */
+    /** Number of columns @default `1` */
     cols?: StyleProp<number>;
-    /** Spacing between columns, `'md'` by default */
+    /** Spacing between columns @default `'md'` */
     spacing?: StyleProp<MantineSpacing>;
-    /** Spacing between rows, `'md'` by default */
+    /** Spacing between rows @default `'md'` */
     verticalSpacing?: StyleProp<MantineSpacing>;
-    /** Determines typeof of queries that are used for responsive styles, `'media'` by default */
+    /** Determines typeof of queries that are used for responsive styles @default `'media'` */
     type?: 'media' | 'container';
 }
 export type SimpleGridFactory = Factory<{

package/lib/components/Skeleton/Skeleton.d.ts

@@ -4,17 +4,17 @@ export type SkeletonCssVariables = {
     root: '--skeleton-width' | '--skeleton-height' | '--skeleton-radius';
 };
 export interface SkeletonProps extends BoxProps, StylesApiProps<SkeletonFactory>, ElementProps<'div'> {
-    /** Determines whether Skeleton overlay should be displayed, `true` by default */
+    /** Determines whether Skeleton overlay should be displayed @default `true` */
     visible?: boolean;
-    /** Skeleton `height`, numbers are converted to rem, `auto` by default */
+    /** Skeleton `height`, numbers are converted to rem @default `auto` */
     height?: React.CSSProperties['height'];
-    /** Skeleton `width`, numbers are converted to rem, `100%` by default, ignored when `circle` prop is set */
+    /** Skeleton `width`, numbers are converted to rem, ignored when `circle` prop is set. @default `100%` */
     width?: React.CSSProperties['width'];
-    /** If set, Skeleton `width` and `border-radius` are equal to its `height`, `false` by default */
+    /** If set, Skeleton `width` and `border-radius` are equal to its `height` @default `false` */
     circle?: 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?: React.CSSProperties['borderRadius'];
-    /** Determines whether Skeleton should be animated, `true` by default */
+    /** Enables animation @default `true` */
     animate?: boolean;
 }
 export type SkeletonFactory = Factory<{

package/lib/components/Slider/RangeSlider/RangeSlider.d.ts

@@ -3,19 +3,19 @@ import { TransitionOverride } from '../../Transition';
 import { SliderCssVariables, SliderStylesNames } from '../Slider.context';
 export type RangeSliderValue = [number, number];
 export interface RangeSliderProps extends BoxProps, StylesApiProps<RangeSliderFactory>, ElementProps<'div', 'onChange' | 'value' | 'defaultValue'> {
-    /** Key of `theme.colors` or any valid CSS color, controls color of track and thumb, `theme.primaryColor` by default */
+    /** Key of `theme.colors` or any valid CSS color, controls color of track and thumb @default `theme.primaryColor` */
     color?: MantineColor;
-    /** 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;
-    /** Controls size of the track, `'md'` by default */
+    /** Controls size of the track @default `'md'` */
     size?: MantineSize | (string & {}) | number;
-    /** Minimal possible value, `0` by default */
+    /** Minimal possible value @default `0` */
     min?: number;
-    /** Maximum possible value, `100` by default */
+    /** Maximum possible value @default `100` */
     max?: number;
-    /** Domain of the slider, defines the full range of possible values, `[min, max]` by default */
+    /** Domain of the slider, defines the full range of possible values @default `[min, max]` */
     domain?: [number, number];
-    /** Number by which value will be incremented/decremented with thumb drag and arrows, `1` by default */
+    /** Number by which value will be incremented/decremented with thumb drag and arrows @default `1` */
     step?: number;
     /** Number of significant digits after the decimal point */
     precision?: number;
@@ -36,11 +36,11 @@ export interface RangeSliderProps extends BoxProps, StylesApiProps<RangeSliderFa
     }[];
     /** Function to generate label or any react node to render instead, set to null to disable label */
     label?: React.ReactNode | ((value: number) => React.ReactNode);
-    /** Props passed down to the `Transition` component, `{ transition: 'fade', duration: 0 }` by default */
+    /** Props passed down to the `Transition` component @default `{ transition: 'fade', duration: 0 }` */
     labelTransitionProps?: TransitionOverride;
-    /** Determines whether the label should be visible when the slider is not being dragged or hovered, `false` by default */
+    /** Determines whether the label should be visible when the slider is not being dragged or hovered @default `false` */
     labelAlwaysOn?: boolean;
-    /** Determines whether the label should be displayed when the slider is hovered, `true` by default */
+    /** Determines whether the label should be displayed when the slider is hovered @default `true` */
     showLabelOnHover?: boolean;
     /** Content rendered inside thumb */
     thumbChildren?: React.ReactNode;
@@ -50,11 +50,11 @@ export interface RangeSliderProps extends BoxProps, StylesApiProps<RangeSliderFa
     thumbSize?: number | string;
     /** A transformation function to change the scale of the slider */
     scale?: (value: number) => number;
-    /** Determines whether track values representation should be inverted, `false` by default */
+    /** Determines whether track values representation should be inverted @default `false` */
     inverted?: boolean;
-    /** Minimal range interval, `10` by default */
+    /** Minimal range interval @default `10` */
     minRange?: number;
-    /** Maximum range interval, `Infinity` by default */
+    /** Maximum range interval @default `Infinity` */
     maxRange?: number;
     /** First thumb `aria-label` */
     thumbFromLabel?: string;
@@ -62,11 +62,11 @@ export interface RangeSliderProps extends BoxProps, StylesApiProps<RangeSliderFa
     thumbToLabel?: string;
     /** Props passed down to the hidden input */
     hiddenInputProps?: React.ComponentPropsWithoutRef<'input'>;
-    /** Determines whether the selection should be only allowed from the given marks array, `false` by default */
+    /** Determines whether the selection should be only allowed from the given marks array @default `false` */
     restrictToMarks?: boolean;
     /** Props passed down to thumb element based on the thumb index */
     thumbProps?: (index: 0 | 1) => React.ComponentPropsWithoutRef<'div'>;
-    /** Determines whether the other thumb should be pushed by the current thumb dragging when `minRange`/`maxRange` is reached, `true` by default */
+    /** Determines whether the other thumb should be pushed by the current thumb dragging when `minRange`/`maxRange` is reached @default `true` */
     pushOnOverlap?: boolean;
 }
 export type RangeSliderFactory = Factory<{

package/lib/components/Slider/Slider/Slider.d.ts

@@ -2,19 +2,19 @@ import { BoxProps, ElementProps, Factory, MantineColor, MantineRadius, MantineSi
 import { TransitionOverride } from '../../Transition';
 import { SliderCssVariables, SliderStylesNames } from '../Slider.context';
 export interface SliderProps extends BoxProps, StylesApiProps<SliderFactory>, ElementProps<'div', 'onChange'> {
-    /** Key of `theme.colors` or any valid CSS color, controls color of track and thumb, `theme.primaryColor` by default */
+    /** Key of `theme.colors` or any valid CSS color, controls color of track and thumb @default `theme.primaryColor` */
     color?: MantineColor;
-    /** 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;
-    /** Controls size of the track, `'md'` by default */
+    /** Controls size of the track @default `'md'` */
     size?: MantineSize | (string & {}) | number;
-    /** Minimal possible value, `0` by default */
+    /** Minimal possible value @default `0` */
     min?: number;
-    /** Maximum possible value, `100` by default */
+    /** Maximum possible value @default `100` */
     max?: number;
-    /** Domain of the slider, defines the full range of possible values, `[min, max]` by default */
+    /** Domain of the slider, defines the full range of possible values @default `[min, max]` */
     domain?: [number, number];
-    /** Number by which value will be incremented/decremented with thumb drag and arrows, `1` by default */
+    /** Number by which value will be incremented/decremented with thumb drag and arrows @default `1` */
     step?: number;
     /** Number of significant digits after the decimal point */
     precision?: number;
@@ -35,13 +35,13 @@ export interface SliderProps extends BoxProps, StylesApiProps<SliderFactory>, El
     }[];
     /** Function to generate label or any react node to render instead, set to null to disable label */
     label?: React.ReactNode | ((value: number) => React.ReactNode);
-    /** Props passed down to the `Transition` component, `{ transition: 'fade', duration: 0 }` by default */
+    /** Props passed down to the `Transition` component @default `{ transition: 'fade', duration: 0 }` */
     labelTransitionProps?: TransitionOverride;
-    /** Determines whether the label should be visible when the slider is not being dragged or hovered, `false` by default */
+    /** Determines whether the label should be visible when the slider is not being dragged or hovered @default `false` */
     labelAlwaysOn?: boolean;
     /** Thumb `aria-label` */
     thumbLabel?: string;
-    /** Determines whether the label should be displayed when the slider is hovered, `true` by default */
+    /** Determines whether the label should be displayed when the slider is hovered @default `true` */
     showLabelOnHover?: boolean;
     /** Content rendered inside thumb */
     thumbChildren?: React.ReactNode;
@@ -51,11 +51,11 @@ export interface SliderProps extends BoxProps, StylesApiProps<SliderFactory>, El
     thumbSize?: number | string;
     /** A transformation function to change the scale of the slider */
     scale?: (value: number) => number;
-    /** Determines whether track value representation should be inverted, `false` by default */
+    /** Determines whether track value representation should be inverted @default `false` */
     inverted?: boolean;
     /** Props passed down to the hidden input */
     hiddenInputProps?: React.ComponentPropsWithoutRef<'input'>;
-    /** Determines whether the selection should be only allowed from the given marks array, `false` by default */
+    /** Determines whether the selection should be only allowed from the given marks array @default `false` */
     restrictToMarks?: boolean;
     /** Props passed down to thumb element */
     thumbProps?: React.ComponentPropsWithoutRef<'div'>;

package/lib/components/Spoiler/Spoiler.d.ts

@@ -4,7 +4,7 @@ export type SpoilerCssVariables = {
     root: '--spoiler-transition-duration';
 };
 export interface SpoilerProps extends BoxProps, StylesApiProps<SpoilerFactory>, ElementProps<'div'> {
-    /** Maximum height of the visible content, when this point is reached spoiler appears, `100` by default */
+    /** Maximum height of the visible content, when this point is reached spoiler appears @default `100` */
     maxHeight?: number;
     /** Label for close spoiler action */
     hideLabel: React.ReactNode;
@@ -12,13 +12,13 @@ export interface SpoilerProps extends BoxProps, StylesApiProps<SpoilerFactory>,
     showLabel: React.ReactNode;
     /** Get ref of spoiler toggle button */
     controlRef?: React.ForwardedRef<HTMLButtonElement>;
-    /** Initial spoiler state, true to wrap content in spoiler, false to show content without spoiler, opened state is updated on mount */
+    /** Initial spoiler state, `true` to wrap content in spoiler, `false` to show content without spoiler, opened state is updated on mount */
     initialState?: boolean;
     /** Controlled expanded state value */
     expanded?: boolean;
     /** Called when expanded state changes (when spoiler visibility is toggled by the user) */
     onExpandedChange?: (expanded: boolean) => void;
-    /** Spoiler reveal transition duration in ms, set 0 or null to turn off animation, `200` by default */
+    /** Spoiler reveal transition duration in ms, set 0 or null to turn off animation @default `200` */
     transitionDuration?: number;
 }
 export type SpoilerFactory = Factory<{

package/lib/components/Stack/Stack.d.ts

@@ -4,11 +4,11 @@ export type StackCssVariables = {
     root: '--stack-gap' | '--stack-align' | '--stack-justify';
 };
 export interface StackProps extends BoxProps, StylesApiProps<StackFactory>, ElementProps<'div'> {
-    /** Key of `theme.spacing` or any valid CSS value to set `gap` property, numbers are converted to rem, `'md'` by default */
+    /** Key of `theme.spacing` or any valid CSS value to set `gap` property, numbers are converted to rem @default `'md'` */
     gap?: MantineSpacing;
-    /** Controls `align-items` CSS property, `'stretch'` by default */
+    /** Controls `align-items` CSS property @default `'stretch'` */
     align?: React.CSSProperties['alignItems'];
-    /** Controls `justify-content` CSS property, `'flex-start'` by default */
+    /** Controls `justify-content` CSS property @default `'flex-start'` */
     justify?: React.CSSProperties['justifyContent'];
 }
 export type StackFactory = Factory<{