@mantine/core 8.1.3 → 8.2.1

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;

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

@@ -5,15 +5,15 @@ export type CheckboxIndicatorCssVariables = {
     indicator: '--checkbox-size' | '--checkbox-radius' | '--checkbox-color' | '--checkbox-icon-color';
 };
 export interface CheckboxIndicatorProps extends BoxProps, StylesApiProps<CheckboxIndicatorFactory>, 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;
     /** Indeterminate state of the checkbox. If set, `checked` prop is ignored. */
     indeterminate?: boolean;

package/lib/components/Chip/Chip.d.ts

@@ -6,11 +6,11 @@ export type ChipCssVariables = {
     root: '--chip-fz' | '--chip-size' | '--chip-icon-size' | '--chip-padding' | '--chip-checked-padding' | '--chip-radius' | '--chip-bg' | '--chip-hover' | '--chip-color' | '--chip-bd' | '--chip-spacing';
 };
 export interface ChipProps extends BoxProps, StylesApiProps<ChipFactory>, ElementProps<'input', 'size' | 'onChange'> {
-    /** 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;
-    /** Controls various properties related to component size, `'sm'` by default */
+    /** Controls various properties related to component size @default `'sm'` */
     size?: MantineSize;
-    /** Chip input type, `'checkbox'` by default */
+    /** Chip input type @default `'checkbox'` */
     type?: 'radio' | 'checkbox';
     /** `label` element associated with the input */
     children: React.ReactNode;
@@ -20,9 +20,9 @@ export interface ChipProps extends BoxProps, StylesApiProps<ChipFactory>, Elemen
     defaultChecked?: boolean;
     /** Calls when checked state changes */
     onChange?: (checked: boolean) => void;
-    /** Controls components colors based on `variant` prop. Key of `theme.colors` or any valid CSS color. `theme.primaryColor` by default */
+    /** Controls components colors based on `variant` prop. Key of `theme.colors` or any valid CSS color. @default `theme.primaryColor` */
     color?: MantineColor;
-    /** Static id to connect input with the label, by default `id` is randomly generated */
+    /** Unique input id */
     id?: string;
     /** Props passed down to the root element */
     wrapperProps?: React.ComponentPropsWithoutRef<'div'> & DataAttributes;
@@ -30,7 +30,7 @@ export interface ChipProps extends BoxProps, StylesApiProps<ChipFactory>, Elemen
     icon?: React.ReactNode;
     /** Assigns ref of the root element */
     rootRef?: React.ForwardedRef<HTMLDivElement>;
-    /** 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 ChipFactory = Factory<{

package/lib/components/Chip/ChipGroup/ChipGroup.d.ts

@@ -1,5 +1,5 @@
 export interface ChipGroupProps<T extends boolean = false> {
-    /** Determines whether it is allowed to select multiple values, `false` by default */
+    /** If set, multiple values can be selected */
     multiple?: T;
     /** Controlled component value */
     value?: T extends true ? string[] : string | null;

package/lib/components/Chip/ChipGroup.context.d.ts

@@ -1,7 +1,7 @@
 interface ChipGroupContextValue {
     isChipSelected: (value: string) => boolean;
     onChange: (event: React.ChangeEvent<HTMLInputElement>) => void;
-    multiple: boolean;
+    multiple: boolean | undefined;
 }
 export declare const ChipGroupProvider: ({ children, value }: {
     value: ChipGroupContextValue;

package/lib/components/CloseButton/CloseButton.d.ts

@@ -6,17 +6,17 @@ export type CloseButtonCssVariables = {
 };
 export interface __CloseButtonProps {
     'data-disabled'?: boolean;
-    /** Controls width and height of the button. Numbers are converted to rem. `'md'` by default. */
+    /** Controls width and height of the button. Numbers are converted to rem. @default `'md'` */
     size?: MantineSize | (string & {}) | number;
-    /** 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;
-    /** Sets `disabled` and `data-disabled` attributes on the button element */
+    /** Sets `disabled` attribute, assigns disabled styles */
     disabled?: boolean;
-    /** `X` icon `width` and `height`, `80%` by default */
+    /** `X` icon `width` and `height` @default `80%` */
     iconSize?: number | string;
-    /** Content rendered inside the button, for example `VisuallyHidden` with label for screen readers */
+    /** Content rendered inside the button. For example `VisuallyHidden` with label for screen readers. */
     children?: React.ReactNode;
-    /** Replaces default close icon. If set, `iconSize` prop is ignored. */
+    /** React node to replace the default close icon. If set, `iconSize` prop is ignored. */
     icon?: React.ReactNode;
 }
 export interface CloseButtonProps extends __CloseButtonProps, BoxProps, StylesApiProps<CloseButtonFactory> {

package/lib/components/Code/Code.d.ts

@@ -4,9 +4,9 @@ export type CodeCssVariables = {
     root: '--code-bg';
 };
 export interface CodeProps extends BoxProps, StylesApiProps<CodeFactory>, ElementProps<'code'> {
-    /** Key of `theme.colors` or any valid CSS color, controls `background-color` of the code, by default value is calculated based on color scheme */
+    /** Key of `theme.colors` or any valid CSS color, controls `background-color` of the code. By default, calculated based on the color scheme. */
     color?: MantineColor;
-    /** If set code will be rendered inside `pre`, `false` by default */
+    /** If set, code is rendered in `pre` */
     block?: boolean;
 }
 export type CodeFactory = Factory<{

package/lib/components/Collapse/Collapse.d.ts

@@ -4,11 +4,11 @@ export interface CollapseProps extends BoxProps, Omit<React.ComponentPropsWithou
     in: boolean;
     /** Called each time transition ends */
     onTransitionEnd?: () => void;
-    /** Transition duration in ms, `200` by default */
+    /** Transition duration in ms @default `200` */
     transitionDuration?: number;
-    /** Transition timing function, default value is `ease` */
+    /** Transition timing function @default `ease` */
     transitionTimingFunction?: string;
-    /** Determines whether opacity should be animated, `true` by default */
+    /** Determines whether opacity should be animated @default `true` */
     animateOpacity?: boolean;
     /** Keep element in DOM when collapsed, useful for nested collapses */
     keepMounted?: boolean;

package/lib/components/ColorInput/ColorInput.d.ts

@@ -8,19 +8,19 @@ export type ColorInputCssVariables = {
     colorPreview: '--ci-preview-size';
 };
 export interface ColorInputProps extends BoxProps, __BaseInputProps, __ColorPickerProps, StylesApiProps<ColorInputFactory>, ElementProps<'input', 'size' | 'onChange' | 'value' | 'defaultValue'> {
-    /** If input is not allowed, the user can only pick value with color picker and swatches, `false` by default */
+    /** If input is not allowed, the user can only pick value with color picker and swatches */
     disallowInput?: boolean;
-    /** Determines whether the input value should be reset to the last known valid value when the input loses focus, `true` by default */
+    /** If set, the input value resets to the last known valid value when the input loses focus @default `true` */
     fixOnBlur?: boolean;
     /** Props passed down to the `Popover` component */
     popoverProps?: PopoverProps;
-    /** Determines whether the preview color swatch should be displayed in the left section of the input, `true` by default */
+    /** If set, the preview color swatch is displayed in the left section of the input @default `true` */
     withPreview?: boolean;
-    /** Determines whether eye dropper button should be displayed in the right section, `true` by default */
+    /** If set, the eye dropper button is displayed in the right section @default `true` */
     withEyeDropper?: boolean;
     /** An icon to replace the default eye dropper icon */
     eyeDropperIcon?: React.ReactNode;
-    /** Determines whether the dropdown should be closed when one of the color swatches is clicked, `false` by default */
+    /** If set, the dropdown is closed when one of the color swatches is clicked @default `false` */
     closeOnColorSwatchClick?: boolean;
     /** Props passed down to the eye dropper button */
     eyeDropperButtonProps?: Record<string, any>;

package/lib/components/ColorPicker/ColorPicker.d.ts

@@ -11,30 +11,30 @@ export interface __ColorPickerProps {
     defaultValue?: string;
     /** Called when value changes */
     onChange?: (value: string) => void;
-    /** Called when the user stops dragging one of the sliders or changes the value with arrow keys */
+    /** Called when the user stops dragging one of the sliders or changes the value with keyboard */
     onChangeEnd?: (value: string) => void;
-    /** Color format, `'hex'` by default */
+    /** Color format @default `'hex'` */
     format?: ColorFormat;
-    /** Determines whether the color picker should be displayed, `true` by default */
+    /** Determines whether the color picker should be displayed @default `true` */
     withPicker?: boolean;
-    /** An array of colors in one of the supported formats. Used to render swatches list below the color picker. */
+    /** A list of colors used to display swatches list below the color picker */
     swatches?: string[];
-    /** Number of swatches per row, `7` by default */
+    /** Number of swatches per row @default `7` */
     swatchesPerRow?: number;
-    /** Controls size of hue, alpha and saturation sliders, `'md'` by default */
+    /** Controls size of hue, alpha and saturation sliders @default `'md'` */
     size?: MantineSize | (string & {});
 }
 export interface ColorPickerProps extends BoxProps, __ColorPickerProps, StylesApiProps<ColorPickerFactory>, ElementProps<'div', 'onChange' | 'value' | 'defaultValue'> {
     __staticSelector?: string;
-    /** Determines whether the component should take 100% width of its container, `false` by default */
+    /** If set, the component takes 100% width of its container @default `false` */
     fullWidth?: boolean;
-    /** Determines whether interactive elements (sliders thumbs and swatches) should be focusable, `true` by default */
+    /** If set, interactive elements (sliders thumbs and swatches) are focusable with keyboard @default `true` */
     focusable?: boolean;
-    /** Saturation slider `aria-label` prop */
+    /** Saturation slider `aria-label` */
     saturationLabel?: string;
-    /** Hue slider `aria-label` prop */
+    /** Hue slider `aria-label` */
     hueLabel?: string;
-    /** Alpha slider `aria-label` prop */
+    /** Alpha slider `aria-label` */
     alphaLabel?: string;
     /** Called when one of the color swatches is clicked */
     onColorSwatchClick?: (color: string) => void;

package/lib/components/ColorSwatch/ColorSwatch.d.ts

@@ -4,15 +4,15 @@ export type ColorSwatchCssVariables = {
     root: '--cs-radius' | '--cs-size';
 };
 export interface ColorSwatchProps extends BoxProps, StylesApiProps<ColorSwatchFactory> {
-    /** Color to display, not related to `theme.colors` – supports only CSS color values */
+    /** Valid CSS color to display */
     color: string;
-    /** Controls `width` and `height` of the swatch, any valid CSS value, numbers are converted to rem */
+    /** Controls `width` and `height` of the swatch, any valid CSS value, numbers are converted to rem. @default `28` */
     size?: React.CSSProperties['width'];
-    /** Key of `theme.radius` or any valid CSS value to set `border-radius`, numbers are converted to rem */
+    /** Key of `theme.radius` or any valid CSS value to set `border-radius`, numbers are converted to rem. @default `1000` */
     radius?: MantineRadius;
-    /** Determines whether the swatch should have inner `box-shadow`, `true` by default */
+    /** Determines whether the swatch should have inner `box-shadow` @default `true` */
     withShadow?: boolean;
-    /** Content rendered inside the swatch */
+    /** Content displayed inside the swatch */
     children?: React.ReactNode;
 }
 export type ColorSwatchFactory = PolymorphicFactory<{

package/lib/components/Combobox/Combobox.d.ts

@@ -26,15 +26,15 @@ export interface ComboboxProps extends __PopoverProps, StylesApiProps<ComboboxFa
     children?: React.ReactNode;
     /** Combobox store, can be used to control combobox state */
     store?: ComboboxStore;
-    /** Called when item is selected with `Enter` key or by clicking it */
+    /** Called when item is selected with the `Enter` key or by clicking it */
     onOptionSubmit?: (value: string, optionProps: ComboboxOptionProps) => void;
-    /** Controls items `font-size` and `padding`, `'sm'` by default */
+    /** Controls items `font-size` and `padding` @default `'sm'` */
     size?: MantineSize | (string & {});
-    /** Controls `padding` of the dropdown, `4` by default */
+    /** Controls `padding` of the dropdown @default `4` */
     dropdownPadding?: React.CSSProperties['padding'];
-    /** Determines whether selection should be reset when option is hovered, `false` by default */
+    /** Determines whether selection should be reset when option is hovered @default `false` */
     resetSelectionOnOptionHover?: boolean;
-    /** Determines whether Combobox value can be changed */
+    /** Determines whether the `Combobox` value can be changed */
     readOnly?: boolean;
 }
 export type ComboboxFactory = Factory<{

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

@@ -30,7 +30,7 @@ export interface ComboboxLikeProps {
     onDropdownOpen?: () => void;
     /** Called when dropdown closes */
     onDropdownClose?: () => void;
-    /** Determines whether the first option should be selected when value changes, `false` by default */
+    /** If set, the first option is selected when value changes, `false` by default */
     selectFirstOptionOnChange?: boolean;
     /** Called when option is submitted from dropdown with mouse click or `Enter` key */
     onOptionSubmit?: (value: string) => void;