@mantine/core 8.1.2 → 8.2.0

package/lib/components/Menu/Menu.d.ts

@@ -8,13 +8,13 @@ export type MenuFactory = Factory<{
 }>;
 export interface MenuProps extends __PopoverProps, StylesApiProps<MenuFactory> {
     variant?: string;
-    /** Menu content */
+    /** Menu children */
     children?: React.ReactNode;
     /** Controlled menu opened state */
     opened?: boolean;
     /** Uncontrolled menu initial opened state */
     defaultOpened?: boolean;
-    /** Determines whether dropdown should trap focus of keyboard events */
+    /** If set, focus is trapped within the menu dropdown when it is opened */
     trapFocus?: boolean;
     /** Called when menu opened state changes */
     onChange?: (opened: boolean) => void;
@@ -22,27 +22,27 @@ export interface MenuProps extends __PopoverProps, StylesApiProps<MenuFactory> {
     onOpen?: () => void;
     /** Called when Menu is closed */
     onClose?: () => void;
-    /** Determines whether Menu should be closed when item is clicked */
+    /** If set, the Menu is closed when one of the items is clicked */
     closeOnItemClick?: boolean;
-    /** Determines whether arrow key presses should loop though items (first to last and last to first) */
+    /** If set, arrow key presses loop though items (first to last and last to first) */
     loop?: boolean;
-    /** Determines whether dropdown should be closed when Escape key is pressed */
+    /** If set, the dropdown is closed when the `Escape` key is pressed @default `true` */
     closeOnEscape?: boolean;
-    /** Event which should open menu */
+    /** Event trigger to open menu */
     trigger?: 'click' | 'hover' | 'click-hover';
-    /** Open delay in ms, applicable only to trigger="hover" variant */
+    /** Open delay in ms, applicable only to `trigger="hover"` variant */
     openDelay?: number;
-    /** Close delay in ms, applicable only to trigger="hover" variant */
+    /** Close delay in ms, applicable only to `trigger="hover"` variant */
     closeDelay?: number;
-    /** Determines whether dropdown should be closed on outside clicks */
+    /** If set, the dropdown is closed on outside clicks */
     closeOnClickOutside?: boolean;
-    /** Events that trigger outside clicks */
+    /** Events that trigger outside clicks @default `['mousedown', 'touchstart', 'keydown']` */
     clickOutsideEvents?: string[];
     /** Id base to create accessibility connections */
     id?: string;
-    /** Set the `tabindex` on all menu items. Defaults to -1 */
+    /** Set the `tabindex` on all menu items @default `-1` */
     menuItemTabIndex?: -1 | 0;
-    /** Determines whether focus placeholder element should be added before items, `true` by default */
+    /** If set, focus placeholder element is added before items @default `true` */
     withInitialFocusPlaceholder?: boolean;
 }
 export declare function Menu(_props: MenuProps): import("react/jsx-runtime").JSX.Element;

package/lib/components/Menu/MenuItem/MenuItem.d.ts

@@ -6,13 +6,13 @@ export interface MenuItemProps extends BoxProps, CompoundStylesApiProps<MenuItem
     children?: React.ReactNode;
     /** Key of `theme.colors` or any valid CSS color */
     color?: MantineColor;
-    /** Determines whether the menu should be closed when the item is clicked, overrides `closeOnItemClick` prop on the `Menu` component */
+    /** If set, the menu is closed when the item is clicked. Overrides `closeOnItemClick` prop on the `Menu` component. */
     closeMenuOnClick?: boolean;
-    /** Section displayed on the left side of the label */
+    /** Section displayed at the start of the label */
     leftSection?: React.ReactNode;
-    /** Section displayed on the right side of the label */
+    /** Section displayed at the end of the label */
     rightSection?: React.ReactNode;
-    /** Disables item */
+    /** Sets disabled attribute, applies disabled styles */
     disabled?: boolean;
 }
 export type MenuItemFactory = PolymorphicFactory<{

package/lib/components/Menu/MenuSub/MenuSub.d.ts

@@ -1,5 +1,5 @@
 import { ExtendComponent, Factory } from '../../../core';
-import { FloatingAxesOffsets, FloatingPosition } from '../../Floating';
+import { FloatingAxesOffsets, FloatingPosition } from '../../../utils/Floating';
 import { __PopoverProps } from '../../Popover';
 import { TransitionOverride } from '../../Transition';
 import { MenuSubTarget } from '../MenuSubTarget/MenuSubTarget';
@@ -10,11 +10,11 @@ interface MenuSubProps extends __PopoverProps {
     children: React.ReactNode;
     /** Close delay in ms */
     closeDelay?: number;
-    /** Dropdown position relative to the target element, `'right-start'` by default */
+    /** Dropdown position relative to the target element @default `'right-start'` */
     position?: FloatingPosition;
-    /** Offset of the dropdown element, `0` by default */
+    /** Offset of the dropdown element @default `0` */
     offset?: number | FloatingAxesOffsets;
-    /** Props passed down to the `Transition` component that used to animate dropdown presence, use to configure duration and animation type, `{ duration: 150, transition: 'fade' }` by default */
+    /** Props passed down to the `Transition` component that used to animate dropdown presence, use to configure duration and animation type @default `{ duration: 0 }` */
     transitionProps?: TransitionOverride;
 }
 export declare function MenuSub(_props: MenuSubProps): import("react/jsx-runtime").JSX.Element;

package/lib/components/Menu/MenuSubItem/MenuSubItem.d.ts

@@ -6,13 +6,13 @@ export interface MenuSubItemProps extends BoxProps, CompoundStylesApiProps<MenuS
     children?: React.ReactNode;
     /** Key of `theme.colors` or any valid CSS color */
     color?: MantineColor;
-    /** Section displayed on the left side of the label */
+    /** Section displayed at the start of the label */
     leftSection?: React.ReactNode;
-    /** Section displayed on the right side of the label */
+    /** Section displayed at the end of the label */
     rightSection?: React.ReactNode;
-    /** Disables item */
+    /** Sets disabled attribute, applies disabled styles */
     disabled?: boolean;
-    /** Determines whether the menu should be closed when the item is clicked, `false` by default */
+    /** If set, the menu is closed when the item is clicked. Overrides `closeOnItemClick` prop on the `Menu` component. */
     closeMenuOnClick?: boolean;
 }
 export type MenuSubItemFactory = PolymorphicFactory<{

package/lib/components/Menu/MenuSubTarget/MenuSubTarget.d.ts

@@ -1,7 +1,7 @@
 export interface MenuSubTargetProps {
     /** Target element */
     children: React.ReactNode;
-    /** Key of the prop that should be used to get element ref */
+    /** Key of the prop used to get element ref @default 'ref' */
     refProp?: string;
 }
 export declare function MenuSubTarget({ children, refProp }: MenuSubTargetProps): import("react/jsx-runtime").JSX.Element;

package/lib/components/Menu/MenuTarget/MenuTarget.d.ts

@@ -1,7 +1,7 @@
 export interface MenuTargetProps {
     /** Target element */
     children: React.ReactNode;
-    /** Key of the prop that should be used to get element ref */
+    /** Key of the prop used to get element ref @default `'ref'` */
     refProp?: string;
 }
 export declare const MenuTarget: import("react").ForwardRefExoticComponent<MenuTargetProps & import("react").RefAttributes<HTMLElement>>;

package/lib/components/Modal/Modal.d.ts

@@ -14,13 +14,13 @@ export interface ModalProps extends ModalRootProps {
     __staticSelector?: string;
     /** Modal title */
     title?: React.ReactNode;
-    /** Determines whether the overlay should be rendered, `true` by default */
+    /** If set, the overlay is rendered @default `true` */
     withOverlay?: boolean;
     /** Props passed down to the `Overlay` component, use to configure opacity, `background-color`, styles and other properties */
     overlayProps?: ModalBaseOverlayProps;
     /** Modal content */
     children?: React.ReactNode;
-    /** Determines whether the close button should be rendered, `true` by default */
+    /** If set, the close button is rendered @default `true` */
     withCloseButton?: boolean;
     /** Props passed down to the close button */
     closeButtonProps?: ModalBaseCloseButtonProps;

package/lib/components/Modal/ModalRoot.d.ts

@@ -7,17 +7,17 @@ export type ModalRootCssVariables = {
 };
 export interface ModalRootProps extends StylesApiProps<ModalRootFactory>, ModalBaseProps {
     __staticSelector?: string;
-    /** Top/bottom modal offset, `5dvh` by default */
+    /** Top/bottom modal offset @default `5dvh` */
     yOffset?: React.CSSProperties['marginTop'];
-    /** Left/right modal offset, `5vw` by default */
+    /** Left/right modal offset @default `5vw` */
     xOffset?: React.CSSProperties['marginLeft'];
-    /** Scroll area component, native `div` element by default */
+    /** Scroll area component @default `'div'` */
     scrollAreaComponent?: ScrollAreaComponent;
-    /** 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 the modal should be centered vertically, `false` by default */
+    /** If set, the modal is centered vertically @default `false` */
     centered?: boolean;
-    /** Determines whether the modal should take the entire screen, `false` by default */
+    /** If set, the modal takes the entire screen @default `false` */
     fullScreen?: boolean;
 }
 export type ModalRootFactory = Factory<{

package/lib/components/ModalBase/ModalBase.d.ts

@@ -5,25 +5,25 @@ import { TransitionOverride } from '../Transition';
 type RemoveScrollProps = Omit<React.ComponentProps<typeof RemoveScroll>, 'children'>;
 export interface ModalBaseProps extends BoxProps, ElementProps<'div', 'title'> {
     unstyled?: boolean;
-    /** If set modal/drawer will not be unmounted from the DOM when it is hidden, `display: none` styles will be added instead, `false` by default */
+    /** If set modal/drawer is not unmounted from the DOM when hidden. `display: none` styles are applied instead. @default `false` */
     keepMounted?: boolean;
-    /** Determines whether modal/drawer is opened */
+    /** Controls opened state */
     opened: boolean;
     /** Called when modal/drawer is closed */
     onClose: () => void;
     /** Id used to connect modal/drawer with body and title */
     id?: string;
-    /** Determines whether scroll should be locked when `opened={true}`, `true` by default */
+    /** If set, scroll is locked when `opened={true}` @default `true` */
     lockScroll?: boolean;
-    /** Determines whether focus should be trapped, `true` by default */
+    /** If set, focus is trapped within the modal/drawer @default `true` */
     trapFocus?: boolean;
-    /** Determines whether the component should be rendered inside `Portal`, `true` by default */
+    /** If set, the component is rendered inside `Portal` @default `true` */
     withinPortal?: boolean;
     /** Props passed down to the Portal component when `withinPortal` is set */
     portalProps?: BasePortalProps;
     /** Modal/drawer content */
     children?: React.ReactNode;
-    /** Determines whether the modal/drawer should be closed when user clicks on the overlay, `true` by default */
+    /** If set, the modal/drawer is closed when user clicks on the overlay @default `true` */
     closeOnClickOutside?: boolean;
     /** Props added to the `Transition` component that used to animate overlay and body, use to configure duration and animation type, `{ duration: 200, transition: 'fade-down' }` by default */
     transitionProps?: TransitionOverride;
@@ -31,17 +31,17 @@ export interface ModalBaseProps extends BoxProps, ElementProps<'div', 'title'> {
     onExitTransitionEnd?: () => void;
     /** Called when enter transition ends */
     onEnterTransitionEnd?: () => void;
-    /** Determines whether `onClose` should be called when user presses the escape key, `true` by default */
+    /** If set, `onClose` is called when user presses the escape key @default `true` */
     closeOnEscape?: boolean;
-    /** Determines whether focus should be returned to the last active element when `onClose` is called, `true` by default */
+    /** If set, focus is returned to the last active element when `onClose` is called @default `true` */
     returnFocus?: boolean;
-    /** `z-index` CSS property of the root element, `200` by default */
+    /** `z-index` CSS property of the root element @default `200` */
     zIndex?: string | number;
-    /** Key of `theme.shadows` or any valid CSS box-shadow value, 'xl' by default */
+    /** Key of `theme.shadows` or any valid CSS box-shadow value @default `'xl'` */
     shadow?: MantineShadow;
-    /** Key of `theme.spacing` or any valid CSS value to set content, header and footer padding, `'md'` by default */
+    /** Key of `theme.spacing` or any valid CSS value to set content, header and footer padding @default `'md'` */
     padding?: MantineSpacing;
-    /** Controls width of the content area, `'md'` by default */
+    /** Controls width of the content area @default `'md'` */
     size?: MantineSize | (string & {}) | number;
     /** Props passed down to react-remove-scroll, can be used to customize scroll lock behavior */
     removeScrollProps?: RemoveScrollProps;

package/lib/components/ModalBase/ModalBaseContent.d.ts

@@ -3,9 +3,9 @@ import { TransitionOverride } from '../Transition';
 export interface ModalBaseContentProps extends BoxProps, ElementProps<'div'> {
     /** Props passed down to the `Transition` component */
     transitionProps?: TransitionOverride;
-    /** 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;
 }
 interface _ModalBaseContentProps extends ModalBaseContentProps {

package/lib/components/MultiSelect/MultiSelect.d.ts

@@ -6,7 +6,7 @@ export type MultiSelectStylesNames = __InputStylesNames | ComboboxLikeStylesName
 export interface MultiSelectProps extends BoxProps, __BaseInputProps, ComboboxLikeProps, StylesApiProps<MultiSelectFactory>, ElementProps<'input', 'size' | 'value' | 'defaultValue' | 'onChange'> {
     /** Controlled component value */
     value?: string[];
-    /** Default value for uncontrolled component */
+    /** Uncontrolled component default value */
     defaultValue?: string[];
     /** Called when value changes */
     onChange?: (value: string[]) => void;
@@ -20,31 +20,31 @@ export interface MultiSelectProps extends BoxProps, __BaseInputProps, ComboboxLi
     defaultSearchValue?: string;
     /** Called when search changes */
     onSearchChange?: (value: string) => void;
-    /** Maximum number of values, `Infinity` by default */
+    /** Maximum number of values, no limit if not set */
     maxValues?: number;
-    /** Determines whether the select should be searchable, `false` by default */
+    /** Allows searching @default `false` */
     searchable?: boolean;
     /** Message displayed when no option matches the current search query while the `searchable` prop is set or there is no data */
     nothingFoundMessage?: React.ReactNode;
-    /** Determines whether check icon should be displayed near the selected option label, `true` by default */
+    /** If set, the check icon is displayed near the selected option label @default `true` */
     withCheckIcon?: boolean;
-    /** Position of the check icon relative to the option label, `'left'` by default */
+    /** Position of the check icon relative to the option label @default `'left'` */
     checkIconPosition?: 'left' | 'right';
-    /** Determines whether picked options should be removed from the options list, `false` by default */
+    /** If set, picked options are removed from the options list @default `false` */
     hidePickedOptions?: boolean;
-    /** Determines whether the clear button should be displayed in the right section when the component has value, `false` by default */
+    /** If set, the clear button is displayed in the right section when the component has value @default `false` */
     clearable?: boolean;
     /** Props passed down to the clear button */
-    clearButtonProps?: InputClearButtonProps & ElementProps<'button'>;
+    clearButtonProps?: InputClearButtonProps;
     /** Props passed down to the hidden input */
     hiddenInputProps?: Omit<React.ComponentPropsWithoutRef<'input'>, 'value'>;
-    /** 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?: (item: ComboboxLikeRenderOptionInput<ComboboxItem>) => React.ReactNode;
     /** Props passed down to the underlying `ScrollArea` component in the dropdown */
     scrollAreaProps?: ScrollAreaProps;
-    /** Controls color of the default chevron, by default depends on the color scheme */
+    /** Controls color of the default chevron */
     chevronColor?: MantineColor;
 }
 export type MultiSelectFactory = Factory<{

package/lib/components/NavLink/NavLink.d.ts

@@ -14,11 +14,11 @@ export interface NavLinkProps extends BoxProps, StylesApiProps<NavLinkFactory> {
     leftSection?: React.ReactNode;
     /** Section displayed on the right side of the label */
     rightSection?: React.ReactNode;
-    /** Determines whether the link should have active styles, `false` by default */
+    /** Determines whether the link should have active styles @default `false` */
     active?: boolean;
-    /** Key of `theme.colors` of any valid CSS color to control active styles, `theme.primaryColor` by default */
+    /** Key of `theme.colors` of any valid CSS color to control active styles @default `theme.primaryColor` */
     color?: MantineColor;
-    /** If set, label and description will not wrap to the next line, `false` by default */
+    /** If set, label and description do not wrap to the next line @default `false` */
     noWrap?: boolean;
     /** Child `NavLink` components */
     children?: React.ReactNode;
@@ -28,17 +28,13 @@ export interface NavLinkProps extends BoxProps, StylesApiProps<NavLinkFactory> {
     defaultOpened?: boolean;
     /** Called when open state changes */
     onChange?: (opened: boolean) => void;
-    /** If set, right section will not be rotated when collapse is opened, `false` by default */
+    /** If set, right section will not be rotated when collapse is opened @default `false` */
     disableRightSectionRotation?: boolean;
-    /** Key of `theme.spacing` or any valid CSS value to set collapsed links `padding-left`, `'lg'` by default */
+    /** Key of `theme.spacing` or any valid CSS value to set collapsed links `padding-left` @default `'lg'` */
     childrenOffset?: MantineSpacing;
-    /** If set, disabled styles will be added to the root element, `false` by default */
+    /** If set, disabled styles will be added to the root element @default `false` */
     disabled?: boolean;
-    /** Called when the link is clicked */
-    onClick?: (event: React.MouseEvent<HTMLAnchorElement>) => void;
-    /** Link `onkeydown` event */
-    onKeyDown?: (event: React.KeyboardEvent<HTMLAnchorElement>) => void;
-    /** 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 NavLinkFactory = PolymorphicFactory<{

package/lib/components/Notification/Notification.d.ts

@@ -6,27 +6,27 @@ export type NotificationCssVariables = {
 };
 export interface NotificationProps extends BoxProps, StylesApiProps<NotificationFactory>, ElementProps<'div', 'title'> {
     variant?: string;
-    /** Called when close button is clicked */
+    /** Called when the close button is clicked */
     onClose?: () => void;
-    /** Controls notification line or icon color, key of `theme.colors` or any valid CSS color, `theme.primaryColor` by default */
+    /** Controls notification line or icon color, 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;
     /** Notification icon, replaces color line */
     icon?: React.ReactNode;
-    /** Notification title, displayed before body */
+    /** Notification title, displayed above the message body */
     title?: React.ReactNode;
-    /** Notification body, place main text here */
+    /** Main notification message */
     children?: React.ReactNode;
-    /** Replaces colored line or icon with Loader component */
+    /** If set, the `Loader` component is displayed instead of the icon */
     loading?: boolean;
-    /** Determines whether notification should have a border, `false` by default */
+    /** Adds border to the root element */
     withBorder?: boolean;
-    /** Determines whether close button should be visible, `true` by default */
+    /** If set, the close button is visible @default `true` */
     withCloseButton?: boolean;
     /** Props passed down to the close button */
     closeButtonProps?: Record<string, any>;
-    /** Props passed down to `Loader` component */
+    /** Props passed down to the `Loader` component */
     loaderProps?: LoaderProps;
 }
 export type NotificationFactory = Factory<{

package/lib/components/NumberFormatter/NumberFormatter.d.ts

@@ -2,13 +2,13 @@ import { ExtendComponent, Factory, MantineThemeComponent } from '../../core';
 export interface NumberFormatterProps extends React.ComponentPropsWithoutRef<'span'> {
     /** Value to format */
     value?: number | string;
-    /** Determines whether negative values are allowed, `true` by default */
+    /** If set, negative values are allowed @default `true` */
     allowNegative?: boolean;
-    /** Limits the number of digits that are displayed after the decimal point, by default there is no limit */
+    /** Limits the number of digits that are displayed after the decimal point @default `Infinity` */
     decimalScale?: number;
     /** Character used as a decimal separator, `'.'` by default */
     decimalSeparator?: string;
-    /** If set, 0s are added after `decimalSeparator` to match given `decimalScale`. `false` by default */
+    /** If set, zeros are added after `decimalSeparator` to match given `decimalScale`. @default `false` */
     fixedDecimalScale?: boolean;
     /** Prefix added before the value */
     prefix?: string;
@@ -16,7 +16,7 @@ export interface NumberFormatterProps extends React.ComponentPropsWithoutRef<'sp
     suffix?: string;
     /** Defines the thousand grouping style */
     thousandsGroupStyle?: 'thousand' | 'lakh' | 'wan' | 'none';
-    /** A character used to separate thousands, `','` by default */
+    /** A character used to separate thousands @default  `','` */
     thousandSeparator?: string | boolean;
 }
 export type NumberFormatterFactory = Factory<{

package/lib/components/NumberInput/NumberInput.d.ts

@@ -19,17 +19,17 @@ export interface NumberInputProps extends BoxProps, __BaseInputProps, StylesApiP
     onChange?: (value: number | string) => void;
     /** Called when value changes with `react-number-format` payload */
     onValueChange?: OnValueChange;
-    /** Determines whether leading zeros are allowed. If set to `false`, leading zeros are removed when the input value becomes a valid number. `true` by default */
+    /** Determines whether leading zeros are allowed. If set to `false`, leading zeros are removed when the input value becomes a valid number. @default `true` */
     allowLeadingZeros?: boolean;
-    /** Determines whether negative values are allowed, `true` by default */
+    /** If set, negative values are allowed @default `true` */
     allowNegative?: boolean;
-    /** Characters which when pressed result in a decimal separator, `['.']` by default */
+    /** Characters which when pressed result in a decimal separator @default `['.']` */
     allowedDecimalSeparators?: string[];
-    /** Limits the number of digits that can be entered after the decimal point */
+    /** Limits the number of digits that can be entered after the decimal point @default `Infinity` */
     decimalScale?: number;
-    /** Character used as a decimal separator, `'.'` by default */
+    /** Character used as a decimal separator @default `'.'` */
     decimalSeparator?: string;
-    /** If set, 0s are added after `decimalSeparator` to match given `decimalScale`. `false` by default */
+    /** If set, 0s are added after `decimalSeparator` to match given `decimalScale`. @default `false` */
     fixedDecimalScale?: boolean;
     /** Prefix added before the input value */
     prefix?: string;
@@ -39,9 +39,9 @@ export interface NumberInputProps extends BoxProps, __BaseInputProps, StylesApiP
     thousandsGroupStyle?: 'thousand' | 'lakh' | 'wan' | 'none';
     /** A function to validate the input value. If this function returns `false`, the `onChange` will not be called and the input value will not change. */
     isAllowed?: (values: NumberFormatValues) => boolean;
-    /** If value is passed as string representation of numbers (unformatted) and number is used in any format props like in prefix or suffix in numeric format and format prop in pattern format then this should be passed as `true`. `false` by default. */
+    /** If value is passed as string representation of numbers (unformatted) and number is used in any format props like in prefix or suffix in numeric format and format prop in pattern format then this should be passed as `true`. @default `false` */
     valueIsNumericString?: boolean;
-    /** Controls input `type` attribute, `'text'` by default */
+    /** Controls input `type` attribute @default `'text'` */
     type?: 'text' | 'tel' | 'password';
     /** A character used to separate thousands */
     thousandSeparator?: string | boolean;
@@ -49,25 +49,25 @@ export interface NumberInputProps extends BoxProps, __BaseInputProps, StylesApiP
     min?: number;
     /** Maximum possible value */
     max?: number;
-    /** Number by which value will be incremented/decremented with up/down controls and keyboard arrows, `1` by default */
+    /** Number by which value will be incremented/decremented with up/down controls and keyboard arrows @default `1` */
     step?: number;
-    /** Determines whether the up/down controls should be hidden, `false` by default */
+    /** If set, the up/down controls are hidden @default `false` */
     hideControls?: boolean;
     /** Controls how value is clamped, `strict` – user is not allowed to enter values that are not in `[min, max]` range, `blur` – user is allowed to enter any values, but the value is clamped when the input loses focus (default behavior), `none` – lifts all restrictions, `[min, max]` range is applied only for controls and up/down keys */
     clampBehavior?: 'strict' | 'blur' | 'none';
-    /** Determines whether decimal values are allowed, `true` by default */
+    /** If set, decimal values are allowed @default `true` */
     allowDecimal?: boolean;
     /** Increment/decrement handlers */
     handlersRef?: React.ForwardedRef<NumberInputHandlers | undefined>;
-    /** Value set to the input when increment/decrement buttons are clicked or up/down arrows pressed if the input is empty, `0` by default */
+    /** Value set to the input when increment/decrement buttons are clicked or up/down arrows pressed if the input is empty @default `0` */
     startValue?: number;
     /** Delay before stepping the value. Can be a number of milliseconds or a function that receives the current step count and returns the delay in milliseconds. */
     stepHoldInterval?: number | ((stepCount: number) => number);
     /** Initial delay in milliseconds before stepping the value. */
     stepHoldDelay?: number;
-    /** Determines whether up/down keyboard events should be handled to increment/decrement value, `true` by default */
+    /** If set, up/down keyboard events increment/decrement value @default `true` */
     withKeyboardEvents?: boolean;
-    /** Determines whether leading zeros (e.g. `00100` -> `100`) should be removed on blur, `true` by default */
+    /** If set, leading zeros are removed on blur. For example, `00100` -> `100` @default `true` */
     trimLeadingZeroesOnBlur?: boolean;
 }
 export type NumberInputFactory = Factory<{

package/lib/components/Overlay/Overlay.d.ts

@@ -4,23 +4,23 @@ export type OverlayCssVariables = {
     root: '--overlay-bg' | '--overlay-filter' | '--overlay-radius' | '--overlay-z-index';
 };
 export interface OverlayProps extends BoxProps, StylesApiProps<OverlayFactory> {
-    /** Controls overlay `background-color` opacity 0–1, disregarded when `gradient` prop is set, `0.6` by default */
+    /** Overlay `background-color` opacity 0–1, ignored when `gradient` prop is set @default `0.6` */
     backgroundOpacity?: number;
-    /** Overlay `background-color`, `#000` by default */
+    /** Overlay `background-color` @default `#000` */
     color?: React.CSSProperties['backgroundColor'];
-    /** Overlay background blur, `0` by default */
+    /** Overlay background blur @default `0` */
     blur?: number | string;
-    /** Changes overlay to gradient. If set, `color` prop is ignored */
+    /** Changes overlay to gradient. If set, `color` prop is ignored. */
     gradient?: string;
-    /** Overlay z-index, `200` by default */
+    /** Overlay z-index @default `200` */
     zIndex?: string | number;
-    /** Key of `theme.radius` or any valid CSS value to set border-radius, `0` by default */
+    /** Key of `theme.radius` or any valid CSS value to set border-radius @default `0` */
     radius?: MantineRadius;
     /** Content inside overlay */
     children?: React.ReactNode;
-    /** Determines whether content inside overlay should be vertically and horizontally centered, `false` by default */
+    /** Centers content inside the overlay @default `false` */
     center?: boolean;
-    /** Determines whether overlay should have fixed position instead of absolute, `false` by default */
+    /** Changes position to `fixed` @default `false` */
     fixed?: boolean;
 }
 export type OverlayFactory = PolymorphicFactory<{

package/lib/components/Pagination/Pagination.d.ts

@@ -8,11 +8,11 @@ import { PaginationRoot, PaginationRootCssVariables, PaginationRootProps, Pagina
 export type PaginationStylesNames = PaginationRootStylesNames;
 export type PaginationCssVariables = PaginationRootCssVariables;
 export interface PaginationProps extends PaginationRootProps {
-    /** Determines whether first/last controls should be rendered, false by default */
+    /** If set, first/last controls are displayed @default `false` */
     withEdges?: boolean;
-    /** Determines whether next/previous controls should be rendered, true by default */
+    /** If set, next/previous controls are displayed @default `true` */
     withControls?: boolean;
-    /** Adds props to next/previous/first/last controls */
+    /** Props passed down to next/previous/first/last controls */
     getControlProps?: (control: 'first' | 'previous' | 'last' | 'next') => Record<string, any>;
     /** Next control icon component */
     nextIcon?: PaginationIcon;
@@ -24,11 +24,11 @@ export interface PaginationProps extends PaginationRootProps {
     firstIcon?: PaginationIcon;
     /** Dots icon component */
     dotsIcon?: PaginationIcon;
-    /** Key of `theme.spacing`, gap between controls, `8` by default */
+    /** Key of `theme.spacing`, gap between controls @default `8` */
     gap?: MantineSpacing;
-    /** Determines whether the pagination should be hidden when only one page is available (`total={1}`), `false` by default */
+    /** If set, the pagination is hidden when only one page is available (`total={1}`) @default `false` */
     hideWithOnePage?: boolean;
-    /** Determines whether pages controls should be displayed, `true` by default */
+    /** If set to `false`, pages controls are hidden @default `true` */
     withPages?: boolean;
 }
 export type PaginationFactory = Factory<{

package/lib/components/Pagination/PaginationControl/PaginationControl.d.ts

@@ -1,9 +1,9 @@
 import { BoxProps, CompoundStylesApiProps, ElementProps, Factory } from '../../../core';
 export type PaginationControlStylesNames = 'control';
 export interface PaginationControlProps extends BoxProps, CompoundStylesApiProps<PaginationControlFactory>, ElementProps<'button'> {
-    /** Determines whether control should have active styles */
+    /** Applies active styles, adds `data-active` attribute */
     active?: boolean;
-    /** Determines whether control should have padding, true by default */
+    /** Applies padding @default `true` */
     withPadding?: boolean;
 }
 export type PaginationControlFactory = Factory<{

package/lib/components/Pagination/PaginationRoot/PaginationRoot.d.ts

@@ -4,7 +4,7 @@ export type PaginationRootCssVariables = {
     root: '--pagination-control-size' | '--pagination-control-radius' | '--pagination-control-fz' | '--pagination-active-bg' | '--pagination-active-color';
 };
 export interface PaginationRootProps extends BoxProps, StylesApiProps<PaginationRootFactory>, ElementProps<'div', 'value' | 'onChange'> {
-    /** `height` and `min-width` of controls, `'md'` by default */
+    /** `height` and `min-width` of controls @default `'md'` */
     size?: MantineSize | (string & {}) | number;
     /** Total number of pages, must be an integer */
     total: number;
@@ -14,15 +14,15 @@ export interface PaginationRootProps extends BoxProps, StylesApiProps<Pagination
     defaultValue?: number;
     /** Called when page changes */
     onChange?: (value: number) => void;
-    /** Determines whether all controls should be disabled, `false` by default */
+    /** Disables all controls, applies disabled styles */
     disabled?: boolean;
-    /** Number of siblings displayed on the left/right side of the selected page, `1` by default */
+    /** Number of siblings displayed on the left/right side of the selected page @default `1` */
     siblings?: number;
-    /** Number of elements visible on the left/right edges, `1` by default */
+    /** Number of elements visible on the left/right edges @default `1` */
     boundaries?: number;
-    /** Key of `theme.colors`, active item color, `theme.primaryColor` by default */
+    /** Key of `theme.colors`, active item color @default `theme.primaryColor` */
     color?: MantineColor;
-    /** 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;
     /** Called when next page control is clicked */
     onNextPage?: () => void;
@@ -34,7 +34,7 @@ export interface PaginationRootProps extends BoxProps, StylesApiProps<Pagination
     onLastPage?: () => void;
     /** Additional props passed down to controls */
     getItemProps?: (page: number) => Record<string, any>;
-    /** 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`. */
+    /** If set, adjusts text color based on background color for `filled` variant */
     autoContrast?: boolean;
 }
 export type PaginationRootFactory = Factory<{

package/lib/components/Paper/Paper.d.ts

@@ -4,11 +4,11 @@ export type PaperCssVariables = {
     root: '--paper-radius' | '--paper-shadow';
 };
 export interface PaperBaseProps {
-    /** 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 paper should have border, border color depends on color scheme, `false` by default */
+    /** Adds border to the root element */
     withBorder?: boolean;
 }
 export interface PaperProps extends BoxProps, PaperBaseProps, StylesApiProps<PaperFactory> {