@mantine/core 8.1.3 → 8.2.1

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

package/lib/components/PasswordInput/PasswordInput.d.ts

@@ -5,15 +5,15 @@ export type PasswordInputCssVariables = {
     root: '--psi-icon-size' | '--psi-button-size';
 };
 export interface PasswordInputProps extends BoxProps, __BaseInputProps, StylesApiProps<PasswordInputFactory>, ElementProps<'input', 'size'> {
-    /** A component to replace visibility toggle icon */
+    /** A component to replace the visibility toggle icon */
     visibilityToggleIcon?: React.FC<{
         reveal: boolean;
     }>;
     /** Props passed down to the visibility toggle button */
     visibilityToggleButtonProps?: Record<string, any>;
-    /** Determines whether input content should be visible */
+    /** If set, the input value is visible visible */
     visible?: boolean;
-    /** Determines whether input content should be visible by default */
+    /** If set, the input value is visible by default */
     defaultVisible?: boolean;
     /** Called when visibility changes */
     onVisibilityChange?: (visible: boolean) => void;

package/lib/components/Pill/Pill.d.ts

@@ -7,17 +7,17 @@ export type PillCssVariables = {
     root: '--pill-fz' | '--pill-radius' | '--pill-height';
 };
 export interface PillProps extends BoxProps, StylesApiProps<PillFactory>, ElementProps<'div'> {
-    /** Controls pill `font-size` and `padding`, `'sm'` by default */
+    /** Controls pill `font-size` and `padding` @default `'sm'` */
     size?: MantineSize;
-    /** Determines whether the remove button should be displayed, `false` by default */
+    /** Controls visibility of the remove button @default `false` */
     withRemoveButton?: boolean;
     /** Called when the remove button is clicked */
     onRemove?: () => void;
     /** Props passed down to the remove button */
     removeButtonProps?: CloseButtonProps & React.ComponentPropsWithoutRef<'button'>;
-    /** Key of `theme.radius` or any valid CSS value to set border-radius. Numbers are converted to rem. `'xl'` by default. */
+    /** Key of `theme.radius` or any valid CSS value to set border-radius. Numbers are converted to rem.  @default `'xl'` */
     radius?: MantineRadius;
-    /** If pill is disabled it has higher contrast to be visible on the disabled input background and the remove button is hidden */
+    /** Adds disabled attribute, applies disabled styles */
     disabled?: boolean;
 }
 export type PillFactory = Factory<{

package/lib/components/Pill/PillGroup/PillGroup.d.ts

@@ -6,9 +6,9 @@ export type PillGroupCssVariables = {
 export interface PillGroupProps extends BoxProps, StylesApiProps<PillGroupFactory>, ElementProps<'div'> {
     /** Controls spacing between pills, by default controlled by `size` */
     gap?: MantineSize | (string & {}) | number;
-    /** Controls size of the child `Pill` components and gap between them, `'sm'` by default */
+    /** Controls size of the child `Pill` components and gap between them @default `'sm'` */
     size?: MantineSize | (string & {});
-    /** Determines whether child `Pill` components should be disabled */
+    /** If set, adds disabled to all child `Pill` components */
     disabled?: boolean;
 }
 export type PillGroupFactory = Factory<{

package/lib/components/PillsInput/PillsInputField/PillsInputField.d.ts

@@ -1,7 +1,7 @@
 import { BoxProps, ElementProps, Factory, StylesApiProps } from '../../../core';
 export type PillsInputFieldStylesNames = 'field';
 export interface PillsInputFieldProps extends BoxProps, StylesApiProps<PillsInputFieldFactory>, ElementProps<'input', 'type'> {
-    /** Controls input styles when focused. If `auto` the input is hidden when not focused. If `visible` the input will always remain visible. `'visible'` by default  */
+    /** Controls input styles when focused. If `auto` the input is hidden when not focused. If `visible` the input will always remain visible. @default `'visible'` */
     type?: 'auto' | 'visible' | 'hidden';
     /** If set, cursor is changed to pointer */
     pointer?: boolean;

package/lib/components/PinInput/PinInput.d.ts

@@ -9,13 +9,13 @@ export interface PinInputProps extends BoxProps, StylesApiProps<PinInputFactory>
     name?: string;
     /** Hidden input `form` attribute */
     form?: string;
-    /** Key of `theme.spacing` or any valid CSS value to set `gap` between inputs, numbers are converted to rem, `'md'` by default */
+    /** Key of `theme.spacing` or any valid CSS value to set `gap` between inputs, numbers are converted to rem @default `'md'` */
     gap?: MantineSpacing;
-    /** 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;
-    /** Controls inputs `width` and `height`, `'sm'` by default */
+    /** Controls inputs `width` and `height` @default `'sm'` */
     size?: MantineSize;
-    /** If set, the first input is focused when component is mounted, `false` by default */
+    /** If set, the first input is focused when component is mounted @default `false` */
     autoFocus?: boolean;
     /** Controlled component value */
     value?: string;
@@ -25,23 +25,23 @@ export interface PinInputProps extends BoxProps, StylesApiProps<PinInputFactory>
     onChange?: (value: string) => void;
     /** Called when all inputs have value */
     onComplete?: (value: string) => void;
-    /** Inputs placeholder, `'○'` by default */
+    /** Inputs placeholder @default `'○'` */
     placeholder?: string;
-    /** Determines whether focus should be moved automatically to the next input once filled, `true` by default */
+    /** Determines whether focus should be moved automatically to the next input once filled @default `true` */
     manageFocus?: boolean;
-    /** Determines whether `autocomplete="one-time-code"` attribute should be set on all inputs, `true` by default */
+    /** Determines whether `autocomplete="one-time-code"` attribute should be set on all inputs @default `true` */
     oneTimeCode?: boolean;
-    /** Base id used for all inputs. By default, inputs' ids are generated randomly. */
+    /** Base id used to generate unique ids for inputs */
     id?: string;
-    /** If set, `disabled` attribute is added to all inputs */
+    /** Adds disabled attribute to all inputs */
     disabled?: boolean;
-    /** If set, adds error styles and `aria-invalid` attribute to all inputs */
+    /** Sets `aria-invalid` attribute and applies error styles to all inputs */
     error?: boolean;
-    /** Determines which values can be entered, `'alphanumeric'` by default */
+    /** Determines which values can be entered @default `'alphanumeric'` */
     type?: 'alphanumeric' | 'number' | RegExp;
-    /** Changes input type to `"password"`, `false` by default */
+    /** Changes input type to `"password"` @default `false` */
     mask?: boolean;
-    /** Number of inputs, `4` by default */
+    /** Number of inputs @default `4` */
     length?: number;
     /** If set, the user cannot edit the value */
     readOnly?: boolean;
@@ -49,7 +49,7 @@ export interface PinInputProps extends BoxProps, StylesApiProps<PinInputFactory>
     inputType?: React.HTMLInputTypeAttribute;
     /** `inputmode` attribute, inferred from the `type` prop if not specified */
     inputMode?: 'none' | 'text' | 'tel' | 'url' | 'email' | 'numeric' | 'decimal' | 'search' | undefined;
-    /** `aria-label` for the inputs */
+    /** `aria-label` attribute */
     ariaLabel?: string;
     /** Props passed down to the hidden input */
     hiddenInputProps?: React.ComponentPropsWithoutRef<'input'>;

package/lib/components/Popover/Popover.context.d.ts

@@ -1,5 +1,5 @@
 import { ClassNames, GetStylesApi, MantineRadius, MantineShadow, Styles } from '../../core';
-import { ArrowPosition, FloatingPosition, FloatingStrategy } from '../Floating';
+import { ArrowPosition, FloatingPosition, FloatingStrategy } from '../../utils/Floating';
 import { BasePortalProps } from '../Portal';
 import { TransitionOverride } from '../Transition';
 import type { PopoverFactory } from './Popover';

package/lib/components/Popover/Popover.d.ts

@@ -1,5 +1,5 @@
 import { ElementProps, ExtendComponent, Factory, MantineRadius, MantineShadow, StylesApiProps } from '../../core';
-import { ArrowPosition, FloatingAxesOffsets, FloatingPosition, FloatingStrategy } from '../Floating';
+import { ArrowPosition, FloatingAxesOffsets, FloatingPosition, FloatingStrategy } from '../../utils/Floating';
 import { OverlayProps } from '../Overlay';
 import { BasePortalProps } from '../Portal';
 import { TransitionOverride } from '../Transition';
@@ -9,9 +9,9 @@ export type PopoverCssVariables = {
     dropdown: '--popover-radius' | '--popover-shadow';
 };
 export interface __PopoverProps {
-    /** Dropdown position relative to the target element, `'bottom'` by default */
+    /** Dropdown position relative to the target element @default `'bottom'` */
     position?: FloatingPosition;
-    /** Offset of the dropdown element, `8` by default */
+    /** Offset of the dropdown element @default `8` */
     offset?: number | FloatingAxesOffsets;
     /** Called when dropdown position changes */
     onPositionChange?: (position: FloatingPosition) => void;
@@ -23,49 +23,49 @@ export interface __PopoverProps {
     onDismiss?: () => void;
     /** Called when dropdown opens */
     onOpen?: () => void;
-    /** If set dropdown will not be unmounted from the DOM when it is hidden, `display: none` styles will be added instead */
+    /** If set, the dropdown is not unmounted from the DOM when hidden. `display: none` styles are added instead. */
     keepMounted?: boolean;
-    /** 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. Use to configure duration and animation type. @default `{ duration: 150, transition: 'fade' }` */
     transitionProps?: TransitionOverride;
     /** Called when exit transition ends */
     onExitTransitionEnd?: () => void;
     /** Called when enter transition ends */
     onEnterTransitionEnd?: () => void;
-    /** Dropdown width, or `'target'` to make dropdown width the same as target element, `'max-content'` by default */
+    /** Dropdown width, or `'target'` to make dropdown width the same as target element @default `'max-content'` */
     width?: PopoverWidth;
-    /** Floating ui middlewares to configure position handling, `{ flip: true, shift: true, inline: false }` by default */
+    /** Floating ui middlewares to configure position handling @default `{ flip: true, shift: true, inline: false }` */
     middlewares?: PopoverMiddlewares;
-    /** Determines whether component should have an arrow, `false` by default */
+    /** Determines whether component should have an arrow @default `false` */
     withArrow?: boolean;
-    /** Determines whether the overlay should be displayed when the dropdown is opened, `false` by default */
+    /** Determines whether the overlay should be displayed when the dropdown is opened @default `false` */
     withOverlay?: boolean;
     /** Props passed down to `Overlay` component */
     overlayProps?: OverlayProps & ElementProps<'div'>;
-    /** Arrow size in px, `7` by default */
+    /** Arrow size in px @default `7` */
     arrowSize?: number;
-    /** Arrow offset in px, `5` by default */
+    /** Arrow offset in px @default `5` */
     arrowOffset?: number;
-    /** Arrow `border-radius` in px, `0` by default */
+    /** Arrow `border-radius` in px @default `0` */
     arrowRadius?: number;
     /** Arrow position */
     arrowPosition?: ArrowPosition;
-    /** Determines whether dropdown should be rendered within the `Portal`, `true` by default */
+    /** Determines whether dropdown should be rendered within the `Portal` @default `true` */
     withinPortal?: boolean;
     /** Props to pass down to the `Portal` when `withinPortal` is true */
     portalProps?: BasePortalProps;
-    /** Dropdown `z-index`, `300` by default */
+    /** Dropdown `z-index` @default `300` */
     zIndex?: string | number;
-    /** Key of `theme.radius` or any valid CSS value to set border-radius, `theme.defaultRadius` by default */
+    /** Key of `theme.radius` or any valid CSS value to set border-radius @default `theme.defaultRadius` */
     radius?: MantineRadius;
     /** Key of `theme.shadows` or any other valid CSS `box-shadow` value */
     shadow?: MantineShadow;
     /** If set, popover dropdown will not be rendered */
     disabled?: boolean;
-    /** Determines whether focus should be automatically returned to control when dropdown closes, `false` by default */
+    /** Determines whether focus should be automatically returned to control when dropdown closes @default `false` */
     returnFocus?: boolean;
-    /** Changes floating ui [position strategy](https://floating-ui.com/docs/usefloating#strategy), `'absolute'` by default */
+    /** Changes floating ui [position strategy](https://floating-ui.com/docs/usefloating#strategy) @default `'absolute'` */
     floatingStrategy?: FloatingStrategy;
-    /** If set, the dropdown is hidden when the element is hidden with styles or not visible on the screen, `true` by default */
+    /** If set, the dropdown is hidden when the element is hidden with styles or not visible on the screen @default `true` */
     hideDetached?: boolean;
     /** Prevents popover from flipping/shifting when it the dropdown is visible */
     preventPositionChangeWhenVisible?: boolean;
@@ -80,17 +80,17 @@ export interface PopoverProps extends __PopoverProps, StylesApiProps<PopoverFact
     opened?: boolean;
     /** Called with current state when dropdown opens or closes */
     onChange?: (opened: boolean) => void;
-    /** Determines whether dropdown should be closed on outside clicks, `true` by default */
+    /** Determines whether dropdown should be closed on outside clicks @default `true` */
     closeOnClickOutside?: boolean;
     /** Events that trigger outside clicks */
     clickOutsideEvents?: string[];
-    /** Determines whether focus should be trapped within dropdown, `false` by default */
+    /** Determines whether focus should be trapped within dropdown @default `false` */
     trapFocus?: boolean;
-    /** Determines whether dropdown should be closed when `Escape` key is pressed, `true` by default */
+    /** Determines whether dropdown should be closed when `Escape` key is pressed @default `true` */
     closeOnEscape?: boolean;
     /** Id base to create accessibility connections */
     id?: string;
-    /** Determines whether dropdown and target elements should have accessible roles, `true` by default */
+    /** Determines whether dropdown and target elements should have accessible roles @default `true` */
     withRoles?: boolean;
 }
 export type PopoverFactory = Factory<{

package/lib/components/Popover/PopoverTarget/PopoverTarget.d.ts

@@ -4,7 +4,7 @@ export interface PopoverTargetProps {
     children: React.ReactNode;
     /** Key of the prop that should be used to access element ref */
     refProp?: string;
-    /** Popup accessible type, `'dialog'` by default */
+    /** Popup accessible type @default `'dialog'` */
     popupType?: string;
 }
 export type PopoverTargetFactory = Factory<{