@mantine/core 8.1.2 → 8.2.0

package/lib/components/AngleSlider/AngleSlider.d.ts

@@ -4,36 +4,36 @@ export type AngleSliderCssVariables = {
     root: '--slider-size' | '--thumb-size';
 };
 export interface AngleSliderProps extends BoxProps, StylesApiProps<AngleSliderFactory>, ElementProps<'div', 'onChange'> {
-    /** Step between values, used when the component is controlled with keyboard, `1` by default */
+    /** Step between values @default `1` */
     step?: number;
-    /** Value of the controlled component */
+    /** Controlled component value */
     value?: number;
-    /** Default value for uncontrolled component */
+    /** Uncontrolled component default value */
     defaultValue?: number;
     /** Called on value change */
     onChange?: (value: number) => void;
     /** Called after the selection is finished */
     onChangeEnd?: (value: number) => void;
-    /** Called in `onMouseDown` and `onTouchStart` events */
+    /** Called in `onMouseDown` and `onTouchStart` */
     onScrubStart?: () => void;
-    /** Called in `onMouseUp` and `onTouchEnd` events */
+    /** Called in `onMouseUp` and `onTouchEnd` */
     onScrubEnd?: () => void;
-    /** Determines whether the label should be displayed inside the slider, `true` by default */
+    /** If set, the label is displayed inside the slider @default `true` */
     withLabel?: boolean;
-    /** Array of marks that are displayed on the slider */
+    /** Array of marks displayed on the slider */
     marks?: {
         value: number;
         label?: string;
     }[];
-    /** Slider size in px, `60px` */
+    /** Slider size in px @default `60px` */
     size?: number;
-    /** Size of the thumb in px, by default is calculated based on the `size` value */
+    /** Size of the thumb in px. Calculated based on the `size` value by default. */
     thumbSize?: number;
-    /** Formats label based on the current value */
+    /** A function to format label based on the current value */
     formatLabel?: (value: number) => React.ReactNode;
-    /** Disables interactions */
+    /** Sets `data-disabled` attribute, disables interactions */
     disabled?: boolean;
-    /** Determines whether the selection should be only allowed from the given marks array, `false` by default */
+    /** If set, the selection is allowed only from the given marks array @default `false` */
     restrictToMarks?: boolean;
     /** Props passed down to the hidden input */
     hiddenInputProps?: React.ComponentPropsWithoutRef<'input'>;

package/lib/components/AppShell/AppShell.d.ts

@@ -11,29 +11,29 @@ export type AppShellCssVariables = {
     root: '--app-shell-transition-duration' | '--app-shell-transition-timing-function';
 };
 export interface AppShellProps extends BoxProps, StylesApiProps<AppShellFactory>, ElementProps<'div'> {
-    /** Determines whether associated components should have a border, `true` by default */
+    /** If set, the associated components have a border @default `true` */
     withBorder?: boolean;
-    /** Controls padding of the main section, `0` by default. !important: use `padding` prop instead of `p`. */
+    /** Padding of the main section. Important: use `padding` prop instead of `p`. @default `0` */
     padding?: MantineSpacing | AppShellResponsiveSize;
-    /** AppShell.Navbar configuration, controls width, breakpoints and collapsed state. Required if you use AppShell.Navbar component. */
+    /** `Navbar` configuration, controls width, breakpoints and collapsed state. Required if you use `Navbar` component. */
     navbar?: AppShellNavbarConfiguration;
-    /** AppShell.Aside configuration, controls width, breakpoints and collapsed state. Required if you use AppShell.Aside component. */
+    /** `Aside` configuration, controls width, breakpoints and collapsed state. Required if you use `Aside` component. */
     aside?: AppShellAsideConfiguration;
-    /** AppShell.Header configuration, controls height, offset and collapsed state. Required if you use AppShell.Header component. */
+    /** `Header` configuration, controls height, offset and collapsed state. Required if you use `Header` component. */
     header?: AppShellHeaderConfiguration;
-    /** AppShell.Footer configuration, controls height, offset and collapsed state. Required if you use AppShell.Footer component. */
+    /** `Footer` configuration, controls height, offset and collapsed state. Required if you use `Footer` component. */
     footer?: AppShellFooterConfiguration;
-    /** Duration of all transitions in ms, `200` by default */
+    /** Duration of all transitions in ms @default `200` */
     transitionDuration?: number;
-    /** Timing function of all transitions, `ease` by default */
+    /** Timing function of all transitions @default `ease` */
     transitionTimingFunction?: React.CSSProperties['transitionTimingFunction'];
-    /** `z-index` of all associated elements, `100` by default */
+    /** `z-index` of all associated elements @default `100` */
     zIndex?: string | number;
-    /** Determines how Navbar/Aside are arranged relative to Header/Footer, `default` by default */
+    /** Determines how `Navbar`/`Aside` are arranged relative to `Header`/`Footer` */
     layout?: 'default' | 'alt';
-    /** If set, Navbar, Aside, Header and Footer components be hidden */
+    /** If set, `Navbar`, `Aside`, `Header` and `Footer` components are hidden */
     disabled?: boolean;
-    /** Determines whether Header and Footer components should include styles to offset scrollbars. Based on `react-remove-scroll`. `true` by default for `layout="default"`, `false` for `layout="alt"` */
+    /** If set, `Header` and `Footer` components include styles to offset scrollbars. Based on `react-remove-scroll`. @default `true` for `layout="default"`, `false` for `layout="alt"` */
     offsetScrollbars?: boolean;
 }
 export type AppShellFactory = Factory<{

package/lib/components/AppShell/AppShell.types.d.ts

@@ -1,4 +1,10 @@
 import type { MantineBreakpoint } from '../../core';
+export interface AppShellCompoundProps {
+    /** If set, component haves a border, overrides `withBorder` prop on `AppShell` component */
+    withBorder?: boolean;
+    /** Sets `z-index`. Inherited from the `AppShell` by default. */
+    zIndex?: React.CSSProperties['zIndex'];
+}
 export type AppShellSize = number | (string & {});
 export interface AppShellResponsiveSize {
     base?: AppShellSize;

package/lib/components/AppShell/AppShellAside/AppShellAside.d.ts

@@ -1,10 +1,7 @@
 import { BoxProps, ElementProps, Factory, StylesApiProps } from '../../../core';
+import { AppShellCompoundProps } from '../AppShell.types';
 export type AppShellAsideStylesNames = 'aside';
-export interface AppShellAsideProps extends BoxProps, StylesApiProps<AppShellAsideFactory>, ElementProps<'aside'> {
-    /** Determines whether component should have a border, overrides `withBorder` prop on `AppShell` component */
-    withBorder?: boolean;
-    /** Component `z-index`, by default inherited from the `AppShell` */
-    zIndex?: string | number;
+export interface AppShellAsideProps extends BoxProps, AppShellCompoundProps, StylesApiProps<AppShellAsideFactory>, ElementProps<'aside'> {
 }
 export type AppShellAsideFactory = Factory<{
     props: AppShellAsideProps;

package/lib/components/AppShell/AppShellFooter/AppShellFooter.d.ts

@@ -1,10 +1,7 @@
 import { BoxProps, ElementProps, Factory, StylesApiProps } from '../../../core';
+import { AppShellCompoundProps } from '../AppShell.types';
 export type AppShellFooterStylesNames = 'footer';
-export interface AppShellFooterProps extends BoxProps, StylesApiProps<AppShellFooterFactory>, ElementProps<'footer'> {
-    /** Determines whether component should have a border, overrides `withBorder` prop on `AppShell` component */
-    withBorder?: boolean;
-    /** Component `z-index`, by default inherited from the `AppShell` */
-    zIndex?: string | number;
+export interface AppShellFooterProps extends BoxProps, AppShellCompoundProps, StylesApiProps<AppShellFooterFactory>, ElementProps<'footer'> {
 }
 export type AppShellFooterFactory = Factory<{
     props: AppShellFooterProps;

package/lib/components/AppShell/AppShellHeader/AppShellHeader.d.ts

@@ -1,10 +1,7 @@
 import { BoxProps, ElementProps, Factory, StylesApiProps } from '../../../core';
+import type { AppShellCompoundProps } from '../AppShell.types';
 export type AppShellHeaderStylesNames = 'header';
-export interface AppShellHeaderProps extends BoxProps, StylesApiProps<AppShellHeaderFactory>, ElementProps<'header'> {
-    /** Determines whether component should have a border, overrides `withBorder` prop on `AppShell` component */
-    withBorder?: boolean;
-    /** Component `z-index`, by default inherited from the `AppShell` */
-    zIndex?: string | number;
+export interface AppShellHeaderProps extends BoxProps, AppShellCompoundProps, StylesApiProps<AppShellHeaderFactory>, ElementProps<'header'> {
 }
 export type AppShellHeaderFactory = Factory<{
     props: AppShellHeaderProps;

package/lib/components/AppShell/AppShellNavbar/AppShellNavbar.d.ts

@@ -1,10 +1,7 @@
 import { BoxProps, ElementProps, Factory, StylesApiProps } from '../../../core';
+import type { AppShellCompoundProps } from '../AppShell.types';
 export type AppShellNavbarStylesNames = 'navbar';
-export interface AppShellNavbarProps extends BoxProps, StylesApiProps<AppShellNavbarFactory>, ElementProps<'div'> {
-    /** Determines whether component should have a border, overrides `withBorder` prop on `AppShell` component */
-    withBorder?: boolean;
-    /** Component `z-index`, by default inherited from the `AppShell` */
-    zIndex?: string | number;
+export interface AppShellNavbarProps extends BoxProps, AppShellCompoundProps, StylesApiProps<AppShellNavbarFactory>, ElementProps<'div'> {
 }
 export type AppShellNavbarFactory = Factory<{
     props: AppShellNavbarProps;

package/lib/components/AppShell/AppShellSection/AppShellSection.d.ts

@@ -1,7 +1,7 @@
 import { BoxProps, CompoundStylesApiProps, PolymorphicFactory } from '../../../core';
 export type AppShellSectionStylesNames = 'section';
 export interface AppShellSectionProps extends BoxProps, CompoundStylesApiProps<AppShellSectionFactory> {
-    /** Determines whether the section should take all available space, `false` by default */
+    /** If set, the section expands to take all available space */
     grow?: boolean;
 }
 export type AppShellSectionFactory = PolymorphicFactory<{

package/lib/components/AppShell/index.d.ts

@@ -5,7 +5,7 @@ export { AppShellHeader } from './AppShellHeader/AppShellHeader';
 export { AppShellNavbar } from './AppShellNavbar/AppShellNavbar';
 export { AppShellSection } from './AppShellSection/AppShellSection';
 export { AppShellMain } from './AppShellMain/AppShellMain';
-export type { AppShellAsideConfiguration, AppShellHeaderConfiguration, AppShellNavbarConfiguration, AppShellFooterConfiguration, AppShellResponsiveSize, } from './AppShell.types';
+export type { AppShellAsideConfiguration, AppShellHeaderConfiguration, AppShellNavbarConfiguration, AppShellFooterConfiguration, AppShellResponsiveSize, AppShellCompoundProps, } from './AppShell.types';
 export type { AppShellProps, AppShellCssVariables, AppShellFactory, AppShellStylesNames, } from './AppShell';
 export type { AppShellAsideProps } from './AppShellAside/AppShellAside';
 export type { AppShellFooterProps } from './AppShellFooter/AppShellFooter';

package/lib/components/AspectRatio/AspectRatio.d.ts

@@ -4,7 +4,7 @@ export type AspectRatioCssVariables = {
     root: '--ar-ratio';
 };
 export interface AspectRatioProps extends BoxProps, StylesApiProps<AspectRatioFactory>, ElementProps<'div'> {
-    /** Aspect ratio, e.g. `16 / 9`, `4 / 3`, `1920 / 1080`, `1` by default */
+    /** Aspect ratio, for example, `16 / 9`, `4 / 3`, `1920 / 1080` @default `1` */
     ratio?: number;
 }
 export type AspectRatioFactory = Factory<{

package/lib/components/Autocomplete/Autocomplete.d.ts

@@ -2,26 +2,29 @@ import { BoxProps, ElementProps, Factory, StylesApiProps } from '../../core';
 import { ComboboxLikeProps, ComboboxLikeRenderOptionInput, ComboboxLikeStylesNames, ComboboxStringData, ComboboxStringItem } from '../Combobox';
 import { __BaseInputProps, __InputStylesNames, InputClearButtonProps, InputVariant } from '../Input';
 import { ScrollAreaProps } from '../ScrollArea';
+export type RenderAutocompleteOption = (input: ComboboxLikeRenderOptionInput<ComboboxStringItem>) => React.ReactNode;
 export type AutocompleteStylesNames = __InputStylesNames | ComboboxLikeStylesNames;
-export interface AutocompleteProps extends BoxProps, __BaseInputProps, Omit<ComboboxLikeProps, 'data'>, StylesApiProps<AutocompleteFactory>, ElementProps<'input', 'onChange' | 'size'> {
-    /** Data displayed in the dropdown. Values must be unique, otherwise an error will be thrown and component will not render. */
+export interface AutocompleteProps extends BoxProps, Omit<__BaseInputProps, 'pointer'>, Omit<ComboboxLikeProps, 'data'>, StylesApiProps<AutocompleteFactory>, ElementProps<'input', 'onChange' | 'size'> {
+    /** Data used to display options. Values must be unique. */
     data?: ComboboxStringData;
     /** Controlled component value */
     value?: string;
-    /** Uncontrolled component default value */
+    /** Default value for uncontrolled component */
     defaultValue?: string;
     /** Called when value changes */
     onChange?: (value: string) => void;
-    /** 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 */
+    /** Function to render custom option content */
+    renderOption?: RenderAutocompleteOption;
+    /** Props passed to the underlying `ScrollArea` component in the dropdown */
     scrollAreaProps?: ScrollAreaProps;
     /** Called when the clear button is clicked */
     onClear?: () => void;
-    /** Props passed down to the clear button */
-    clearButtonProps?: InputClearButtonProps & ElementProps<'button'>;
-    /** Determines whether the clear button should be displayed in the right section when the component has value, `false` by default */
+    /** Props passed to the clear button */
+    clearButtonProps?: InputClearButtonProps;
+    /** If set, the clear button is displayed when the component has a value @default `false` */
     clearable?: boolean;
+    /** If set, the highlighted option is selected when the input loses focus @default `false` */
+    autoSelectOnBlur?: boolean;
 }
 export type AutocompleteFactory = Factory<{
     props: AutocompleteProps;

package/lib/components/Autocomplete/index.d.ts

@@ -1,2 +1,2 @@
 export { Autocomplete } from './Autocomplete';
-export type { AutocompleteFactory, AutocompleteProps, AutocompleteStylesNames, } from './Autocomplete';
+export type { AutocompleteFactory, AutocompleteProps, AutocompleteStylesNames, RenderAutocompleteOption, } from './Autocomplete';

package/lib/components/Avatar/Avatar.d.ts

@@ -6,27 +6,27 @@ export type AvatarCssVariables = {
     root: '--avatar-size' | '--avatar-radius' | '--avatar-bg' | '--avatar-color' | '--avatar-bd';
 };
 export interface AvatarProps extends BoxProps, StylesApiProps<AvatarFactory> {
-    /** Width and height of the avatar, numbers are converted to rem, `'md'` by default */
+    /** Width and height of the avatar, numbers are converted to rem @default `'md'` */
     size?: MantineSize | (string & {}) | number;
-    /** Key of `theme.radius` or any valid CSS value to set border-radius, `'100%'` by default */
+    /** Key of `theme.radius` or any valid CSS value to set border-radius @default `'100%'` */
     radius?: MantineRadius;
-    /** Key of `theme.colors` or any valid CSS color, default value is `'gray'`  */
+    /** Key of `theme.colors` or any valid CSS color @default `'gray'` */
     color?: MantineColor | 'initials';
-    /** Gradient configuration used when `variant="gradient"`, default value is `theme.defaultGradient` */
+    /** Gradient configuration for `variant="gradient"` @default `theme.defaultGradient` */
     gradient?: MantineGradient;
     /** Image url, if the image cannot be loaded or `src={null}`, then placeholder is displayed instead */
     src?: string | null;
     /** Image `alt` attribute, also used as `title` attribute for placeholder */
     alt?: string;
-    /** `img` tag attributes */
+    /** Attributes passed down to `img` element */
     imageProps?: React.ComponentPropsWithoutRef<'img'>;
     /** Avatar placeholder, displayed when `src={null}` or when the image cannot be loaded */
     children?: React.ReactNode;
-    /** 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;
     /** Name of the user. When `src` is not set, used to display initials and to generate color when `color="initials"` is set. */
     name?: string;
-    /** An array of colors that can be used for autogenerated initials. By default, all default Mantine colors can be used except gray and dark. */
+    /** A list of colors that is used for autogenerated initials. By default, all default Mantine colors can be used except gray and dark. */
     allowedInitialsColors?: MantineColor[];
 }
 export type AvatarFactory = PolymorphicFactory<{

package/lib/components/Avatar/AvatarGroup/AvatarGroup.d.ts

@@ -4,7 +4,7 @@ export type AvatarGroupCssVariables = {
     group: '--ag-spacing';
 };
 export interface AvatarGroupProps extends BoxProps, StylesApiProps<AvatarGroupFactory>, ElementProps<'div'> {
-    /** Negative space between Avatar components, `'sm'` by default */
+    /** Negative space between Avatar components @default `'sm'` */
     spacing?: MantineSpacing;
 }
 export type AvatarGroupFactory = Factory<{

package/lib/components/BackgroundImage/BackgroundImage.d.ts

@@ -4,7 +4,7 @@ export type BackgroundImageCssVariables = {
     root: '--bi-radius';
 };
 export interface BackgroundImageProps extends BoxProps, StylesApiProps<BackgroundImageFactory> {
-    /** Key of `theme.radius` or any valid CSS value to set border-radius, numbers are converted to rem, `0` by default */
+    /** Key of `theme.radius` or any valid CSS value to set border-radius, numbers are converted to rem @default `0` */
     radius?: MantineRadius;
     /** Image url */
     src: string;

package/lib/components/Badge/Badge.d.ts

@@ -5,25 +5,25 @@ export type BadgeCssVariables = {
     root: '--badge-height' | '--badge-padding-x' | '--badge-fz' | '--badge-radius' | '--badge-bg' | '--badge-color' | '--badge-bd' | '--badge-dot-color';
 };
 export interface BadgeProps extends BoxProps, StylesApiProps<BadgeFactory> {
-    /** Controls `font-size`, `height` and horizontal `padding`, `'md'` by default */
+    /** Controls `font-size`, `height` and horizontal `padding` @default `'md'` */
     size?: MantineSize | (string & {});
     /** If set, badge `min-width` becomes equal to its `height` and horizontal padding is removed */
     circle?: boolean;
-    /** 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;
-    /** Key of `theme.colors` or any valid CSS color, `theme.primaryColor` by default */
+    /** Key of `theme.colors` or any valid CSS color @default `theme.primaryColor` */
     color?: MantineColor;
-    /** Gradient configuration used when `variant="gradient"`, default value is `theme.defaultGradient` */
+    /** Gradient configuration used when `variant=\"gradient\"` @default `theme.defaultGradient` */
     gradient?: MantineGradient;
     /** Content displayed on the left side of the badge label */
     leftSection?: React.ReactNode;
     /** Content displayed on the right side of the badge label */
     rightSection?: React.ReactNode;
-    /** Determines whether Badge should take 100% of its parent width, `false` by default */
+    /** Determines whether Badge should take 100% of its parent width @default `false` */
     fullWidth?: boolean;
     /** Main badge content */
     children?: React.ReactNode;
-    /** 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;
 }
 export type BadgeFactory = PolymorphicFactory<{

package/lib/components/Blockquote/Blockquote.d.ts

@@ -4,13 +4,13 @@ export type BlockquoteCssVariables = {
     root: '--bq-bg-light' | '--bq-bg-dark' | '--bq-bd' | '--bq-icon-size' | '--bq-radius';
 };
 export interface BlockquoteProps extends BoxProps, StylesApiProps<BlockquoteFactory>, ElementProps<'blockquote', 'cite'> {
-    /** Blockquote icon, displayed on the top left */
+    /** Blockquote icon, displayed at the top left side */
     icon?: React.ReactNode;
-    /** Controls icon `width` and `height`, numbers are converted to rem, `40` by default */
+    /** Controls icon `width` and `height`, numbers are converted to rem @default `40` */
     iconSize?: number | string;
-    /** Key of `theme.colors` or any valid CSS color, `theme.primaryColor` by default */
+    /** Key of `theme.colors` or any valid CSS color @default `theme.primaryColor` */
     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;
     /** Reference to a cited quote */
     cite?: React.ReactNode;

package/lib/components/Breadcrumbs/Breadcrumbs.d.ts

@@ -4,9 +4,9 @@ export type BreadcrumbsCssVariables = {
     root: '--bc-separator-margin';
 };
 export interface BreadcrumbsProps extends BoxProps, StylesApiProps<BreadcrumbsFactory>, ElementProps<'div'> {
-    /** Separator between children, `'/'` by default */
+    /** Separator between children @default `'/'` */
     separator?: React.ReactNode;
-    /** Controls spacing between separator and breadcrumb, `'xs'` by default */
+    /** Controls spacing between separator and breadcrumb @default `'xs'` */
     separatorMargin?: MantineSpacing;
     /** React nodes that should be separated with `separator` */
     children: React.ReactNode;

package/lib/components/Burger/Burger.d.ts

@@ -4,17 +4,17 @@ export type BurgerCssVariables = {
     root: '--burger-color' | '--burger-size' | '--burger-line-size' | '--burger-transition-duration' | '--burger-transition-timing-function';
 };
 export interface BurgerProps extends BoxProps, StylesApiProps<BurgerFactory>, ElementProps<'button'> {
-    /** Controls burger `width` and `height`, numbers are converted to rem, `'md'` by default */
+    /** Controls burger `width` and `height`, numbers are converted to rem @default `'md'` */
     size?: MantineSize | (string & {}) | number;
     /** Controls height of lines, by default calculated based on `size` prop */
     lineSize?: string | number;
     /** Key of `theme.colors` of any valid CSS value, by default `theme.white` in dark color scheme and `theme.black` in light */
     color?: MantineColor;
-    /** State of the burger, when `true` burger is transformed into X, `false` by default */
+    /** State of the burger, when `true` burger is transformed into X @default `false` */
     opened?: boolean;
-    /** `transition-duration` property value in ms, `300` by default */
+    /** `transition-duration` property value in ms @default `300` */
     transitionDuration?: number;
-    /** `transition-timing-function` property value, `'ease'` by default  */
+    /** `transition-timing-function` property value @default `'ease'` */
     transitionTimingFunction?: string;
 }
 export type BurgerFactory = Factory<{

package/lib/components/Button/Button.d.ts

@@ -9,31 +9,31 @@ export type ButtonCssVariables = {
 };
 export interface ButtonProps extends BoxProps, StylesApiProps<ButtonFactory> {
     'data-disabled'?: boolean;
-    /** Controls button `height`, `font-size` and horizontal `padding`, `'sm'` by default */
+    /** Controls button `height`, `font-size` and horizontal `padding` @default `'sm'` */
     size?: MantineSize | `compact-${MantineSize}` | (string & {});
-    /** Key of `theme.colors` or any valid CSS color, `theme.primaryColor` by default */
+    /** Key of `theme.colors` or any valid CSS color @default `theme.primaryColor` */
     color?: MantineColor;
-    /** Sets `justify-content` of `inner` element, can be used to change distribution of sections and label, `'center'` by default */
+    /** Sets `justify-content` of `inner` element, can be used to change distribution of sections and label @default `'center'` */
     justify?: React.CSSProperties['justifyContent'];
     /** Content displayed on the left side of the button label */
     leftSection?: React.ReactNode;
     /** Content displayed on the right side of the button label */
     rightSection?: React.ReactNode;
-    /** Determines whether button should take 100% width of its parent container, `false` by default */
+    /** If set, the button takes 100% width of its parent container @default `false` */
     fullWidth?: boolean;
-    /** 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;
-    /** Gradient configuration used when `variant="gradient"`, default value is `theme.defaultGradient` */
+    /** Gradient configuration used when `variant="gradient"` @default `theme.defaultGradient` */
     gradient?: MantineGradient;
-    /** Indicates disabled state */
+    /** Sets `disabled` attribute, applies disabled styles */
     disabled?: boolean;
     /** Button content */
     children?: React.ReactNode;
-    /** Determines whether the `Loader` component should be displayed over the button */
+    /** If set, the `Loader` component is displayed over the button */
     loading?: boolean;
     /** Props added to the `Loader` component (only visible when `loading` prop is set) */
     loaderProps?: LoaderProps;
-    /** Determines whether button 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;
 }
 export type ButtonFactory = PolymorphicFactory<{

package/lib/components/Button/ButtonGroup/ButtonGroup.d.ts

@@ -6,9 +6,9 @@ export type ButtonGroupCssVariables = {
 export interface ButtonGroupProps extends BoxProps, StylesApiProps<ButtonGroupFactory> {
     /** `Button` components */
     children?: React.ReactNode;
-    /** Orientation of the group, `horizontal` by default */
+    /** Orientation of the group @default `horizontal` */
     orientation?: 'horizontal' | 'vertical';
-    /** `border-width` of the child `Button` components. Numbers are converted to rem. Default value in `1`. */
+    /** `border-width` of the child `Button` components. Numbers are converted to rem. @default `1` */
     borderWidth?: number | string;
 }
 export type ButtonGroupFactory = Factory<{

package/lib/components/Button/ButtonGroupSection/ButtonGroupSection.d.ts

@@ -5,13 +5,13 @@ export type ButtonGroupSectionCssVariables = {
     groupSection: '--section-radius' | '--section-bg' | '--section-color' | '--section-bd' | '--section-height' | '--section-padding-x' | '--section-fz';
 };
 export interface ButtonGroupSectionProps extends BoxProps, StylesApiProps<ButtonGroupSectionFactory>, ElementProps<'div'> {
-    /** 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;
-    /** Gradient configuration used when `variant="gradient"`, default value is `theme.defaultGradient` */
+    /** Gradient configuration used when `variant="gradient"` @default `theme.defaultGradient` */
     gradient?: MantineGradient;
-    /** Determines whether section 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;
-    /** Controls section `height`, `font-size` and horizontal `padding`, `'sm'` by default */
+    /** Controls section `height`, `font-size` and horizontal `padding` @default `'sm'` */
     size?: MantineSize | `compact-${MantineSize}` | (string & {});
 }
 export type ButtonGroupSectionFactory = Factory<{

package/lib/components/Card/Card.d.ts

@@ -5,13 +5,13 @@ export type CardCssVariables = {
     root: '--card-padding';
 };
 export interface CardProps extends BoxProps, StylesApiProps<CardFactory> {
-    /** Key of `theme.shadows` or any valid CSS value to set `box-shadow`, `none` by default */
+    /** Key of `theme.shadows` or any valid CSS value to set `box-shadow` */
     shadow?: MantineShadow;
-    /** 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;
-    /** Determines whether the card should have border, border color depends on color scheme, `false` by default */
+    /** Adds border to the card */
     withBorder?: boolean;
-    /** Controls `padding`, key of `theme.spacing` or any valid CSS value, `'md'` by default */
+    /** Key of `theme.spacing` or any valid CSS value to set padding @default `'md'` */
     padding?: MantineSpacing;
     /** Card content */
     children?: React.ReactNode;

package/lib/components/Card/CardSection/CardSection.d.ts

@@ -1,9 +1,9 @@
 import { BoxProps, CompoundStylesApiProps, PolymorphicFactory } from '../../../core';
 export type CardSectionStylesNames = 'section';
 export interface CardSectionProps extends BoxProps, CompoundStylesApiProps<CardSectionFactory> {
-    /** Determines whether the section should have a border, `false` by default */
+    /** Adds border to the root element */
     withBorder?: boolean;
-    /** Determines whether the section should inherit padding from the parent `Card`, `false` by default */
+    /** If set, the section inherits padding from the parent `Card` */
     inheritPadding?: boolean;
 }
 export type CardSectionFactory = PolymorphicFactory<{

package/lib/components/Center/Center.d.ts

@@ -1,9 +1,9 @@
 import { BoxProps, PolymorphicFactory, StylesApiProps } from '../../core';
 export type CenterStylesNames = 'root';
 export interface CenterProps extends BoxProps, StylesApiProps<CenterFactory> {
-    /** Content that should be centered vertically and horizontally */
+    /** Content to center */
     children?: React.ReactNode;
-    /** Determines whether `inline-flex` should be used instead of `flex`, `false` by default */
+    /** If set, `inline-flex` is used instead of `flex` */
     inline?: boolean;
 }
 export type CenterFactory = PolymorphicFactory<{

package/lib/components/Checkbox/Checkbox.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 { CheckboxCard } from './CheckboxCard/CheckboxCard';
 import { CheckboxGroup } from './CheckboxGroup/CheckboxGroup';
 import { CheckboxIndicator } from './CheckboxIndicator/CheckboxIndicator';
@@ -9,19 +9,19 @@ export type CheckboxCssVariables = {
     root: '--checkbox-size' | '--checkbox-radius' | '--checkbox-color' | '--checkbox-icon-color';
 };
 export interface CheckboxProps extends BoxProps, StylesApiProps<CheckboxFactory>, ElementProps<'input', 'size' | 'children'> {
-    /** Id used to connect input with the label. If not set, unique id is generated instead. */
+    /** Unique input id */
     id?: string;
-    /** Content of the `label` associated with the checkbox */
+    /** `label` associated with the checkbox */
     label?: React.ReactNode;
-    /** 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;
     /** 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;
@@ -34,11 +34,11 @@ export interface CheckboxProps extends BoxProps, StylesApiProps<CheckboxFactory>
         indeterminate: boolean | undefined;
         className: string;
     }>;
-    /** Assigns ref of the root element */
+    /** Root element ref */
     rootRef?: React.ForwardedRef<HTMLDivElement>;
-    /** Key of `theme.colors` or any valid CSS color to set icon color, by default value depends on `theme.autoContrast` */
+    /** Key of `theme.colors` or any valid CSS color to set icon color. By default, 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 CheckboxFactory = Factory<{

package/lib/components/Checkbox/CheckboxCard/CheckboxCard.d.ts

@@ -10,9 +10,9 @@ export interface CheckboxCardProps extends BoxProps, StylesApiProps<CheckboxCard
     defaultChecked?: boolean;
     /** Called when value changes */
     onChange?: (checked: boolean) => void;
-    /** 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 `Checkbox.Group` */
     value?: string;

package/lib/components/Checkbox/CheckboxGroup/CheckboxGroup.d.ts

@@ -12,7 +12,7 @@ export interface CheckboxGroupProps extends Omit<InputWrapperProps, 'onChange'>
     onChange?: (value: string[]) => void;
     /** Props passed down to the root element (`Input.Wrapper` component) */
     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;