@mantine/core 8.1.2 → 8.2.0

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<{

package/lib/components/Stepper/Stepper.d.ts

@@ -9,37 +9,37 @@ export type StepperCssVariables = {
     root: '--stepper-color' | '--stepper-icon-color' | '--stepper-icon-size' | '--stepper-content-padding' | '--stepper-radius' | '--stepper-fz' | '--stepper-spacing';
 };
 export interface StepperProps extends BoxProps, StylesApiProps<StepperFactory>, ElementProps<'div'> {
-    /** <Stepper.Step /> components */
+    /** `Stepper.Step` components */
     children: React.ReactNode;
     /** Called when step is clicked */
     onStepClick?: (stepIndex: number) => void;
     /** Index of the active step */
     active: number;
-    /** Step icon, default value is step index + 1 */
+    /** Step icon, default value is `step index + 1` */
     icon?: React.ReactNode | StepFragmentComponent;
     /** Step icon displayed when step is completed, check icon by default */
     completedIcon?: React.ReactNode | StepFragmentComponent;
-    /** Step icon displayed when step is in progress, default value is step index + 1 */
+    /** Step icon displayed when step is in progress, default value is `step index + 1` */
     progressIcon?: React.ReactNode | StepFragmentComponent;
-    /** Key of `theme.colors` or any valid CSS color, controls colors of active and progress steps, `theme.primaryColor` by default */
+    /** Key of `theme.colors` or any valid CSS color, controls colors of active and progress steps @default `theme.primaryColor` */
     color?: MantineColor;
     /** Controls size of the step icon, by default icon size is inferred from `size` prop */
     iconSize?: number | string;
     /** Key of `theme.spacing` or any valid CSS value to set `padding-top` of the content */
     contentPadding?: MantineSpacing;
-    /** Stepper orientation, `'horizontal'` by default */
+    /** Stepper orientation @default `'horizontal'` */
     orientation?: 'vertical' | 'horizontal';
-    /** Icon position relative to the step body, `'left'` by default */
+    /** Icon position relative to the step body @default `'left'` */
     iconPosition?: 'right' | 'left';
     /** Controls size of various Stepper elements */
     size?: MantineSize;
-    /** Key of `theme.radius` or any valid CSS value to set steps border-radius, `"xl"` by default */
+    /** Key of `theme.radius` or any valid CSS value to set steps border-radius @default `"xl"` */
     radius?: MantineRadius;
-    /** Determines whether next steps can be selected, `true` by default **/
+    /** If set, next steps can be selected @default `true` */
     allowNextStepsSelect?: boolean;
-    /** Determines whether steps should wrap to the next line if no space is available, `true` by default */
+    /** Determines whether steps should wrap to the next line if no space is available @default `true` */
     wrap?: boolean;
-    /** 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 StepperFactory = Factory<{

package/lib/components/Stepper/StepperStep/StepperStep.d.ts

@@ -2,7 +2,7 @@ import { BoxProps, CompoundStylesApiProps, ElementProps, Factory, MantineColor }
 import type { StepFragmentComponent } from '../Stepper';
 export type StepperStepStylesNames = 'step' | 'stepLoader' | 'verticalSeparator' | 'stepWrapper' | 'stepIcon' | 'stepCompletedIcon' | 'stepBody' | 'stepLabel' | 'stepDescription';
 export interface StepperStepProps extends BoxProps, CompoundStylesApiProps<StepperStepFactory>, ElementProps<'button'> {
-    /** Step index, controlled by Stepper component **/
+    /** Step index, controlled by Stepper component */
     step?: number;
     /** Step state, controlled by Stepper component */
     state?: 'stepInactive' | 'stepProgress' | 'stepCompleted';
@@ -10,7 +10,7 @@ export interface StepperStepProps extends BoxProps, CompoundStylesApiProps<Stepp
     color?: MantineColor;
     /** Determines whether the icon should be displayed */
     withIcon?: boolean;
-    /** Step icon, defaults to step index + 1 when rendered within Stepper */
+    /** Step icon, defaults to `step index + 1` when rendered within Stepper */
     icon?: React.ReactNode | StepFragmentComponent;
     /** Step icon displayed when step is completed */
     completedIcon?: React.ReactNode | StepFragmentComponent;

package/lib/components/Switch/Switch.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 { SwitchGroup } from './SwitchGroup/SwitchGroup';
 export type SwitchStylesNames = 'root' | 'track' | 'trackLabel' | 'thumb' | 'input' | InlineInputStylesNames;
 export type SwitchCssVariables = {
@@ -14,17 +14,17 @@ export interface SwitchProps extends BoxProps, StylesApiProps<SwitchFactory>, El
     offLabel?: React.ReactNode;
     /** Inner label when the `Switch` is in checked state */
     onLabel?: 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 all elements */
     size?: MantineSize | (string & {});
-    /** 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;
     /** Props passed down to the root element */
     wrapperProps?: React.ComponentPropsWithoutRef<'div'> & DataAttributes;
     /** Icon inside the thumb of the switch */
     thumbIcon?: React.ReactNode;
-    /** 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;
@@ -32,7 +32,7 @@ export interface SwitchProps extends BoxProps, StylesApiProps<SwitchFactory>, El
     error?: React.ReactNode;
     /** Assigns ref of the root element */
     rootRef?: React.ForwardedRef<HTMLDivElement>;
-    /** If set, the indicator will be displayed inside thumb, `true` by default */
+    /** If set, the indicator will be displayed inside thumb @default `true` */
     withThumbIndicator?: boolean;
 }
 export type SwitchFactory = Factory<{

package/lib/components/Switch/SwitchGroup/SwitchGroup.d.ts

@@ -12,7 +12,7 @@ export interface SwitchGroupProps extends Omit<InputWrapperProps, 'onChange'> {
     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 | (string & {});
     /** If set, value cannot be changed */
     readOnly?: boolean;

package/lib/components/Table/Table.d.ts

@@ -14,37 +14,37 @@ export interface TableData {
     caption?: string;
 }
 export interface TableProps extends BoxProps, StylesApiProps<TableFactory>, ElementProps<'table'> {
-    /** Value of `table-layout` style, `auto` by default */
+    /** Value of `table-layout` style @default `auto` */
     layout?: React.CSSProperties['tableLayout'];
-    /** Determines on which side `Table.Caption` is displayed, `bottom` by default */
+    /** Side of the `Table.Caption` @default `bottom` */
     captionSide?: 'top' | 'bottom';
     /** Color of table borders, key of `theme.colors` or any valid CSS color */
     borderColor?: MantineColor;
-    /** Determines whether the table should have outer border, `false` by default */
+    /** If set, the table has the outer border @default `false` */
     withTableBorder?: boolean;
-    /** Determines whether the table should have borders between columns, `false` by default */
+    /** If set, the table has borders between columns @default `false` */
     withColumnBorders?: boolean;
-    /** Determines whether the table should have borders between rows, `true` by default */
+    /** If set, the table has borders between rows @default `true` */
     withRowBorders?: boolean;
-    /** Horizontal cells spacing, key of `theme.spacing` or any valid CSS value for padding, numbers are converted to rem, default value is `xs` */
+    /** Horizontal cells spacing, key of `theme.spacing` or any valid CSS value for padding, numbers are converted to rem @default `xs` */
     horizontalSpacing?: MantineSpacing;
-    /** Vertical cells spacing, key of `theme.spacing` or any valid CSS value for padding, numbers are converted to rem, default value is `xs` */
+    /** Vertical cells spacing, key of `theme.spacing` or any valid CSS value for padding, numbers are converted to rem @default `xs` */
     verticalSpacing?: MantineSpacing;
-    /** Determines whether every odd/even row background should be changed to `strippedColor`, if set to `true`, then `odd` value will be used, `false` by default  */
+    /** If set, every odd/even row background changes to `strippedColor`, if set to `true`, then `odd` value will be used @default `false`  */
     striped?: boolean | 'odd' | 'even';
     /** Background color of striped rows, key of `theme.colors` or any valid CSS color */
     stripedColor?: MantineColor;
-    /** Determines whether table rows background should change to `highlightOnHoverColor` when hovered, `false` by default */
+    /** If set, table rows background changes to `highlightOnHoverColor` when hovered @default `false` */
     highlightOnHover?: boolean;
     /** Background color of table rows when hovered, key of `theme.colors` or any valid CSS color */
     highlightOnHoverColor?: MantineColor;
-    /** Data that should be used to generate table, ignored if `children` prop is set */
+    /** Data used to generate table, ignored if `children` prop is set */
     data?: TableData;
-    /** Determines whether `Table.Thead` should be sticky, `false` by default */
+    /** If set, `Table.Thead` is sticky @default `false` */
     stickyHeader?: boolean;
-    /** Offset from top at which `Table.Thead` should become sticky, `0` by default */
+    /** Offset from top at which `Table.Thead` should become sticky @default `0` */
     stickyHeaderOffset?: number | string;
-    /** Determines whether `font-variant-numeric: tabular-nums` style should be set, `false` by default */
+    /** If set, `font-variant-numeric: tabular-nums` style is applied @default `false` */
     tabularNums?: boolean;
 }
 export type TableFactory = Factory<{

package/lib/components/Table/TableScrollContainer.d.ts

@@ -9,7 +9,7 @@ export interface TableScrollContainerProps extends BoxProps, StylesApiProps<Tabl
     minWidth: React.CSSProperties['minWidth'];
     /** `max-height` of the `Table` at which it should become scrollable */
     maxHeight?: React.CSSProperties['maxHeight'];
-    /** Type of the scroll container, `native` to use native scrollbars, `scrollarea` to use `ScrollArea` component, `scrollarea` by default */
+    /** Type of the scroll container, `native` to use native scrollbars, `scrollarea` to use `ScrollArea` component @default `'scrollarea'` */
     type?: 'native' | 'scrollarea';
     /** Props passed down to `ScrollArea` component, not applicable with `type="native"` */
     scrollAreaProps?: ScrollAreaProps;

package/lib/components/TableOfContents/TableOfContents.d.ts

@@ -21,15 +21,15 @@ export interface TableOfContentsGetControlPropsPayload {
     data: UseScrollSpyHeadingData;
 }
 export interface TableOfContentsProps extends BoxProps, StylesApiProps<TableOfContentsFactory>, ElementProps<'div'> {
-    /** 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` */
     color?: MantineColor;
-    /** Controls font-size and padding of all elements, `'md'` by default */
+    /** Controls font-size and padding of all elements @default `'md'` */
     size?: MantineSize | (string & {}) | number;
-    /** Determines whether text 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;
     /** Options passed down to `use-scroll-spy` hook */
     scrollSpyOptions?: UseScrollSpyOptions;
-    /** Data used to render content until actual values are retrieved from the DOM, empty array by default */
+    /** Data used to render content until actual values are retrieved from the DOM */
     initialData?: InitialTableOfContentsData[];
     /** A function to pass props down to controls, accepts values from `use-scroll-spy` hook as an argument and active state. */
     getControlProps?: (payload: TableOfContentsGetControlPropsPayload) => UnstyledButtonProps & ElementProps<'button'> & Record<`data-${string}`, any>;
@@ -37,7 +37,7 @@ export interface TableOfContentsProps extends BoxProps, StylesApiProps<TableOfCo
     minDepthToOffset?: number;
     /** Controls padding on the left side of control, multiplied by (`depth` - `minDepthToOffset`), `20px` by default  */
     depthOffset?: number | 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;
     /** A function to reinitialize headings from `use-scroll-spy` hook */
     reinitializeRef?: React.RefObject<() => void>;

package/lib/components/Tabs/Tabs.d.ts

@@ -8,35 +8,35 @@ export type TabsCssVariables = {
     root: '--tabs-color' | '--tabs-radius';
 };
 export interface TabsProps extends BoxProps, StylesApiProps<TabsFactory>, ElementProps<'div', 'defaultValue' | 'value' | 'onChange'> {
-    /** Default value for uncontrolled component */
+    /** Uncontrolled component default value */
     defaultValue?: string | null;
-    /** Value for controlled component */
+    /** Controlled component value */
     value?: string | null;
     /** Called when value changes */
     onChange?: (value: string | null) => void;
-    /** Tabs orientation, `'horizontal'` by default */
+    /** Tabs orientation @default `'horizontal'` */
     orientation?: 'vertical' | 'horizontal';
-    /** `Tabs.List` placement relative to `Tabs.Panel`, applicable only when `orientation="vertical"`, `'left'` by default */
+    /** `Tabs.List` placement relative to `Tabs.Panel`, applicable only when `orientation="vertical"` @default `'left'` */
     placement?: 'left' | 'right';
     /** Base id, used to generate ids to connect labels with controls, generated randomly by default */
     id?: string;
-    /** Determines whether arrow key presses should loop though items (first to last and last to first), `true` by default */
+    /** If set, arrow key presses loop though items (first to last and last to first) @default `true` */
     loop?: boolean;
-    /** Determines whether tab should be activated with arrow key press, `true` by default */
+    /** If set, tab is activated with arrow key press @default `true` */
     activateTabWithKeyboard?: boolean;
-    /** Determines whether tab can be deactivated, `false` by default */
+    /** If set, tab can be deactivated @default `false` */
     allowTabDeactivation?: boolean;
     /** Tabs content */
     children?: React.ReactNode;
     /** Changes colors of `Tabs.Tab` components when variant is `pills` or `default`, does nothing for other variants */
     color?: MantineColor;
-    /** 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 tabs should have inverted styles, `false` by default */
+    /** Determines whether tabs should have inverted styles @default `false` */
     inverted?: boolean;
-    /** If set to `false`, `Tabs.Panel` content will be unmounted when the associated tab is not active, `true` by default */
+    /** If set to `false`, `Tabs.Panel` content will be unmounted when the associated tab is not active @default `true` */
     keepMounted?: boolean;
-    /** Determines whether active item 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`. Only applicable when `variant="pills"` */
+    /** If set, adjusts text color based on background color for `pills` variant */
     autoContrast?: boolean;
 }
 export type TabsFactory = Factory<{

package/lib/components/Tabs/TabsList/TabsList.d.ts

@@ -3,9 +3,9 @@ export type TabsListStylesNames = 'list';
 export interface TabsListProps extends BoxProps, CompoundStylesApiProps<TabsListFactory>, ElementProps<'div'> {
     /** `Tabs.Tab` components */
     children: React.ReactNode;
-    /** Determines whether tabs should take all available space, `false` by default */
+    /** Determines whether tabs should take all available space @default `false` */
     grow?: boolean;
-    /** Tabs alignment, `flex-start` by default */
+    /** Tabs alignment @default `flex-start` */
     justify?: React.CSSProperties['justifyContent'];
 }
 export type TabsListFactory = Factory<{

package/lib/components/Tabs/TabsPanel/TabsPanel.d.ts

@@ -3,7 +3,7 @@ export type TabsPanelStylesNames = 'panel';
 export interface TabsPanelProps extends BoxProps, CompoundStylesApiProps<TabsPanelFactory>, ElementProps<'div'> {
     /** Panel content */
     children: React.ReactNode;
-    /** If set to `true`, the content will be kept mounted, even if `keepMounted` is set `false` in the parent `Tabs` component */
+    /** If set, the content is kept mounted, even if `keepMounted` is set `false` in the parent `Tabs` component */
     keepMounted?: boolean;
     /** Value of associated control */
     value: string;

package/lib/components/Tabs/TabsTab/TabsTab.d.ts

@@ -6,9 +6,9 @@ export interface TabsTabProps extends Omit<UnstyledButtonProps, 'classNames' | '
     value: string;
     /** Tab label */
     children?: React.ReactNode;
-    /** Content displayed on the right side of the label, for example, icon */
+    /** Content displayed on the right side of the label */
     rightSection?: React.ReactNode;
-    /** Content displayed on the left side of the label, for example, icon */
+    /** Content displayed on the left side of the label */
     leftSection?: React.ReactNode;
     /** Key of `theme.colors` or any valid CSS color, controls control color based on `variant` */
     color?: MantineColor;

package/lib/components/TagsInput/TagsInput.d.ts

@@ -4,11 +4,11 @@ import { __BaseInputProps, __InputStylesNames, InputClearButtonProps } from '../
 import { ScrollAreaProps } from '../ScrollArea';
 export type TagsInputStylesNames = __InputStylesNames | ComboboxLikeStylesNames | 'pill' | 'pillsList' | 'inputField';
 export interface TagsInputProps extends BoxProps, __BaseInputProps, Omit<ComboboxLikeProps, 'data'>, StylesApiProps<TagsInputFactory>, ElementProps<'input', 'size' | 'value' | 'defaultValue' | 'onChange'> {
-    /** Data displayed in the dropdown. Values must be unique, otherwise an error will be thrown and component will not render. */
+    /** Data displayed in the dropdown. Values must be unique. */
     data?: ComboboxStringData;
     /** Controlled component value */
     value?: string[];
-    /** Default value for uncontrolled component */
+    /** Uncontrolled component default value */
     defaultValue?: string[];
     /** Called when value changes */
     onChange?: (value: string[]) => void;
@@ -22,27 +22,27 @@ export interface TagsInputProps extends BoxProps, __BaseInputProps, Omit<Combobo
     defaultSearchValue?: string;
     /** Called when search changes */
     onSearchChange?: (value: string) => void;
-    /** Maximum number of tags, `Infinity` by default */
+    /** Maximum number of tags @default `Infinity` */
     maxTags?: number;
-    /** Determines whether duplicate tags are allowed, `false` by default */
+    /** If set, duplicate tags are allowed @default `false` */
     allowDuplicates?: boolean;
     /** Called when user tries to submit a duplicated tag */
     onDuplicate?: (value: string) => void;
     /** Characters that should trigger tags split, `[',']` by default */
     splitChars?: string[];
-    /** 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'>;
-    /** Divider used to separate values in the hidden input `value` attribute, `','` by default */
+    /** Divider used to separate values in the hidden input `value` attribute @default `','` */
     hiddenInputValuesDivider?: string;
     /** A function to render content of the option, replaces the default content of the option */
     renderOption?: (input: ComboboxLikeRenderOptionInput<ComboboxStringItem>) => React.ReactNode;
     /** Props passed down to the underlying `ScrollArea` component in the dropdown */
     scrollAreaProps?: ScrollAreaProps;
-    /** Determines whether the value typed in by the user but not submitted should be accepted when the input is blurred, `true` by default */
+    /** If set, the value typed in by the user but not submitted is accepted when the input is blurred @default `true` */
     acceptValueOnBlur?: boolean;
     /** Custom function to determine if a tag is duplicate. Accepts tag value and array of current values. By default, checks if the tag exists case-insensitively. */
     isDuplicate?: (value: string, currentValues: string[]) => boolean;