@mantine/core 8.1.3 → 8.2.1

package/lib/components/Input/Input.d.ts

@@ -5,9 +5,10 @@ import { InputError } from './InputError/InputError';
 import { InputLabel } from './InputLabel/InputLabel';
 import { InputPlaceholder } from './InputPlaceholder/InputPlaceholder';
 import { __InputWrapperProps, InputWrapper, InputWrapperStylesNames } from './InputWrapper/InputWrapper';
-export interface __BaseInputProps extends __InputWrapperProps, Omit<__InputProps, 'wrapperProps'> {
+type WrapperProps = React.ComponentPropsWithoutRef<'div'> & DataAttributes;
+export interface __BaseInputProps extends __InputWrapperProps, __InputProps {
     /** Props passed down to the root element */
-    wrapperProps?: React.ComponentPropsWithoutRef<'div'> & DataAttributes;
+    wrapperProps?: WrapperProps;
 }
 export type __InputStylesNames = InputStylesNames | InputWrapperStylesNames;
 export type InputStylesNames = 'input' | 'wrapper' | 'section';
@@ -20,37 +21,35 @@ export interface InputStylesCtx {
     offsetBottom: boolean | undefined;
 }
 export interface __InputProps {
-    /** Content section rendered on the left side of the input */
+    /** Content section displayed on the left side of the input */
     leftSection?: React.ReactNode;
     /** Left section width, used to set `width` of the section and input `padding-left`, by default equals to the input height */
     leftSectionWidth?: React.CSSProperties['width'];
     /** Props passed down to the `leftSection` element */
     leftSectionProps?: React.ComponentPropsWithoutRef<'div'>;
-    /** Sets `pointer-events` styles on the `leftSection` element, `'none'` by default */
+    /** Sets `pointer-events` styles on the `leftSection` element @default `'none'` */
     leftSectionPointerEvents?: React.CSSProperties['pointerEvents'];
-    /** Content section rendered on the right side of the input */
+    /** Content section displayed on the right side of the input */
     rightSection?: React.ReactNode;
     /** Right section width, used to set `width` of the section and input `padding-right`, by default equals to the input height */
     rightSectionWidth?: React.CSSProperties['width'];
     /** Props passed down to the `rightSection` element */
     rightSectionProps?: React.ComponentPropsWithoutRef<'div'>;
-    /** Sets `pointer-events` styles on the `rightSection` element, `'none'` by default */
+    /** Sets `pointer-events` styles on the `rightSection` element @default `'none'` */
     rightSectionPointerEvents?: React.CSSProperties['pointerEvents'];
-    /** Props passed down to the root element of the `Input` component */
-    wrapperProps?: React.ComponentPropsWithoutRef<'div'> & DataAttributes;
     /** Sets `required` attribute on the `input` element */
     required?: 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;
     /** Sets `disabled` attribute on the `input` element */
     disabled?: boolean;
-    /** Controls input `height` and horizontal `padding`, `'sm'` by default */
+    /** Controls input `height` and horizontal `padding` @default `'sm'` */
     size?: MantineSize | (string & {});
-    /** Determines whether the input should have `cursor: pointer` style, `false` by default */
+    /** Determines whether the input should have `cursor: pointer` style @default `false` */
     pointer?: boolean;
-    /** Determines whether the input should have red border and red text color when the `error` prop is set, `true` by default */
+    /** Determines whether the input should have red border and red text color when the `error` prop is set @default `true` */
     withErrorStyles?: boolean;
-    /** `size` prop added to the input element */
+    /** `size` attribute passed down to the input element */
     inputSize?: string;
     /** Section to be displayed when the input is `__clearable` and `rightSection` is not defined */
     __clearSection?: React.ReactNode;
@@ -65,12 +64,14 @@ export interface InputProps extends BoxProps, __InputProps, StylesApiProps<Input
     __stylesApiProps?: Record<string, any>;
     /** Determines whether the input should have error styles and `aria-invalid` attribute */
     error?: React.ReactNode;
-    /** Determines whether the input can have multiple lines, for example when `component="textarea"`, `false` by default */
+    /** Determines whether the input can have multiple lines, for example when `component="textarea"` @default `false` */
     multiline?: boolean;
     /** Input element id */
     id?: string;
-    /** Determines whether `aria-` and other accessibility attributes should be added to the input, `true` by default */
+    /** Determines whether `aria-` and other accessibility attributes should be added to the input @default `true` */
     withAria?: boolean;
+    /** Props passed down to the root element of the `Input` component */
+    wrapperProps?: WrapperProps;
 }
 export type InputFactory = PolymorphicFactory<{
     props: InputProps;
@@ -153,3 +154,4 @@ export declare const Input: (<C = "input">(props: import("../../core").Polymorph
     Wrapper: typeof InputWrapper;
     ClearButton: typeof InputClearButton;
 };
+export {};

package/lib/components/Input/InputDescription/InputDescription.d.ts

@@ -6,7 +6,7 @@ export type InputDescriptionCssVariables = {
 export interface InputDescriptionProps extends BoxProps, StylesApiProps<InputDescriptionFactory>, ElementProps<'div'> {
     __staticSelector?: string;
     __inheritStyles?: boolean;
-    /** Controls description `font-size`, `'sm'` by default */
+    /** Controls description `font-size` @default `'sm'` */
     size?: MantineFontSize;
 }
 export type InputDescriptionFactory = Factory<{

package/lib/components/Input/InputError/InputError.d.ts

@@ -6,7 +6,7 @@ export type InputErrorCssVariables = {
 export interface InputErrorProps extends BoxProps, StylesApiProps<InputErrorFactory>, ElementProps<'div'> {
     __staticSelector?: string;
     __inheritStyles?: boolean;
-    /** Controls error `font-size`, `'sm'` by default */
+    /** Controls error `font-size` @default `'sm'` */
     size?: MantineFontSize;
 }
 export type InputErrorFactory = Factory<{

package/lib/components/Input/InputLabel/InputLabel.d.ts

@@ -5,11 +5,11 @@ export type InputLabelCssVariables = {
 };
 export interface InputLabelProps extends BoxProps, StylesApiProps<InputLabelFactory>, ElementProps<'label'> {
     __staticSelector?: string;
-    /** Determines whether the required asterisk should be displayed  */
+    /** If set, the required asterisk is displayed next to the label */
     required?: boolean;
-    /** Controls label `font-size`, `'sm'` by default */
+    /** Controls label `font-size` @default `'sm'` */
     size?: MantineFontSize;
-    /** Root element of the label, `'label'` by default */
+    /** Root element of the label @default `'label'` */
     labelElement?: 'label' | 'div';
 }
 export type InputLabelFactory = Factory<{

package/lib/components/Input/InputPlaceholder/InputPlaceholder.d.ts

@@ -2,7 +2,7 @@ import { BoxProps, ElementProps, Factory, StylesApiProps } from '../../../core';
 export type InputPlaceholderStylesNames = 'placeholder';
 export interface InputPlaceholderProps extends BoxProps, StylesApiProps<InputPlaceholderFactory>, ElementProps<'span'> {
     __staticSelector?: string;
-    /** If set, the placeholder will have error styles, `false` by default */
+    /** If set, the placeholder has error styles @default `false` */
     error?: React.ReactNode;
 }
 export type InputPlaceholderFactory = Factory<{

package/lib/components/Input/InputWrapper/InputWrapper.d.ts

@@ -1,29 +1,29 @@
-import { BoxProps, ElementProps, Factory, MantineFontSize, StylesApiProps } from '../../../core';
-import { InputDescriptionCssVariables, InputDescriptionStylesNames } from '../InputDescription/InputDescription';
-import { InputErrorCssVariables, InputErrorStylesNames } from '../InputError/InputError';
-import { InputLabelCssVariables, InputLabelStylesNames } from '../InputLabel/InputLabel';
+import { BoxProps, DataAttributes, ElementProps, Factory, MantineFontSize, StylesApiProps } from '../../../core';
+import { InputDescriptionCssVariables, InputDescriptionProps, InputDescriptionStylesNames } from '../InputDescription/InputDescription';
+import { InputErrorCssVariables, InputErrorProps, InputErrorStylesNames } from '../InputError/InputError';
+import { InputLabelCssVariables, InputLabelProps, InputLabelStylesNames } from '../InputLabel/InputLabel';
 export type InputWrapperCssVariables = InputLabelCssVariables & InputErrorCssVariables & InputDescriptionCssVariables;
 export type InputWrapperStylesNames = 'root' | InputLabelStylesNames | InputDescriptionStylesNames | InputErrorStylesNames;
 export interface __InputWrapperProps {
-    /** Contents of `Input.Label` component. If not set, label is not rendered. */
+    /** Contents of `Input.Label` component. If not set, label is not displayed. */
     label?: React.ReactNode;
-    /** Contents of `Input.Description` component. If not set, description is not rendered. */
+    /** Contents of `Input.Description` component. If not set, description is not displayed. */
     description?: React.ReactNode;
-    /** Contents of `Input.Error` component. If not set, error is not rendered. */
+    /** Contents of `Input.Error` component. If not set, error is not displayed. */
     error?: React.ReactNode;
-    /** Adds required attribute to the input and a red asterisk on the right side of label, `false` by default */
+    /** Adds required attribute to the input and a red asterisk on the right side of label @default `false` */
     required?: boolean;
-    /** Determines whether the required asterisk should be displayed. Overrides `required` prop. Does not add required attribute to the input. `false` by default */
+    /** If set, the required asterisk is displayed next to the label. Overrides `required` prop. Does not add required attribute to the input. @default `false` */
     withAsterisk?: boolean;
     /** Props passed down to the `Input.Label` component */
-    labelProps?: Record<string, any>;
+    labelProps?: InputLabelProps & DataAttributes;
     /** Props passed down to the `Input.Description` component */
-    descriptionProps?: Record<string, any>;
+    descriptionProps?: InputDescriptionProps & DataAttributes;
     /** Props passed down to the `Input.Error` component */
-    errorProps?: Record<string, any>;
-    /** Input container component, `React.Fragment` by default */
+    errorProps?: InputErrorProps & DataAttributes;
+    /** Input container component @default `React.Fragment` */
     inputContainer?: (children: React.ReactNode) => React.ReactNode;
-    /** Controls order of the elements, `['label', 'description', 'input', 'error']` by default */
+    /** Controls order of the elements @default `['label', 'description', 'input', 'error']` */
     inputWrapperOrder?: ('label' | 'input' | 'description' | 'error')[];
 }
 export interface InputWrapperProps extends __InputWrapperProps, BoxProps, StylesApiProps<InputWrapperFactory>, ElementProps<'div'> {

package/lib/components/Input/use-input-props.d.ts

@@ -8,7 +8,7 @@ interface BaseProps extends __BaseInputProps, BoxProps, StylesApiProps<{
     __stylesApiProps?: Record<string, any>;
     id?: string;
 }
-export declare function useInputProps<T extends BaseProps, U extends Partial<T>>(component: string, defaultProps: U, _props: T): Omit<T & { [Key in Extract<keyof T, never>]-?: {}[Key] | NonNullable<T[Key]>; }, "label" | "style" | "size" | "styles" | "className" | "id" | "vars" | "variant" | "unstyled" | "classNames" | "mod" | "error" | "description" | "__staticSelector" | "required" | "__stylesApiProps" | "withAsterisk" | "labelProps" | "descriptionProps" | "errorProps" | "inputContainer" | "inputWrapperOrder" | "wrapperProps"> & {
+export declare function useInputProps<T extends BaseProps, U extends Partial<T> | null>(component: string, defaultProps: U, _props: T): Omit<T & (U extends null | undefined ? {} : { [Key in Extract<keyof T, keyof U>]-?: U[Key] | NonNullable<T[Key]>; }), "label" | "style" | "size" | "styles" | "className" | "id" | "vars" | "variant" | "unstyled" | "attributes" | "classNames" | "mod" | "error" | "description" | "__staticSelector" | "required" | "__stylesApiProps" | "withAsterisk" | "labelProps" | "descriptionProps" | "errorProps" | "inputContainer" | "inputWrapperOrder" | "wrapperProps"> & {
     classNames: Partial<Record<string, string>> | ((theme: import("../../core").MantineTheme, props: any, ctx: unknown) => Partial<Record<string, string>>) | undefined;
     styles: Partial<Record<string, import("../../core").CSSProperties>> | ((theme: import("../../core").MantineTheme, props: any, ctx: unknown) => Partial<Record<string, import("../../core").CSSProperties>>) | undefined;
     unstyled: boolean | undefined;
@@ -298,10 +298,10 @@ export declare function useInputProps<T extends BaseProps, U extends Partial<T>>
         required: boolean | undefined;
         classNames: Partial<Record<string, string>> | ((theme: import("../../core").MantineTheme, props: any, ctx: unknown) => Partial<Record<string, string>>) | undefined;
         __staticSelector: string | undefined;
-        __stylesApiProps: Record<string, any>;
-        errorProps: Record<string, any> | undefined;
-        labelProps: Record<string, any> | undefined;
-        descriptionProps: Record<string, any> | undefined;
+        __stylesApiProps: Record<string, any> | BaseProps;
+        errorProps: (import(".").InputErrorProps & import("../../core").DataAttributes) | undefined;
+        labelProps: (import(".").InputLabelProps & import("../../core").DataAttributes) | undefined;
+        descriptionProps: (import(".").InputDescriptionProps & import("../../core").DataAttributes) | undefined;
         unstyled: boolean | undefined;
         styles: Partial<Record<string, import("../../core").CSSProperties>> | ((theme: import("../../core").MantineTheme, props: any, ctx: unknown) => Partial<Record<string, import("../../core").CSSProperties>>) | undefined;
         size: (string & {}) | import("../../core").MantineSize | undefined;
@@ -310,6 +310,9 @@ export declare function useInputProps<T extends BaseProps, U extends Partial<T>>
         withAsterisk: boolean | undefined;
         variant: string | undefined;
         mod: import("../../core").BoxMod | undefined;
+        attributes: {
+            [x: string]: Record<string, any> | undefined;
+        } | undefined;
     } & BoxProps;
     inputProps: {
         required: boolean | undefined;
@@ -318,10 +321,13 @@ export declare function useInputProps<T extends BaseProps, U extends Partial<T>>
         unstyled: boolean | undefined;
         size: (string & {}) | import("../../core").MantineSize | undefined;
         __staticSelector: string | undefined;
-        __stylesApiProps: Record<string, any>;
+        __stylesApiProps: Record<string, any> | BaseProps;
         error: import("react").ReactNode;
         variant: string | undefined;
         id: string | undefined;
+        attributes: {
+            [x: string]: Record<string, any> | undefined;
+        } | undefined;
     };
 };
 export {};

package/lib/components/InputBase/InputBase.d.ts

@@ -5,9 +5,9 @@ export interface InputBaseProps extends BoxProps, __BaseInputProps, StylesApiPro
     __stylesApiProps?: Record<string, any>;
     /** Props passed down to the root element (`Input.Wrapper` component) */
     wrapperProps?: React.ComponentPropsWithoutRef<'div'> & DataAttributes;
-    /** Determines whether the input can have multiple lines, for example when `component="textarea"`, `false` by default */
+    /** If set, the input can have multiple lines, for example when `component="textarea"` @default `false` */
     multiline?: boolean;
-    /** Determines whether `aria-` and other accessibility attributes should be added to the input, `true` by default */
+    /** If set, `aria-` and other accessibility attributes are added to the input @default `true` */
     withAria?: boolean;
 }
 export type InputBaseFactory = PolymorphicFactory<{

package/lib/components/JsonInput/JsonInput.d.ts

@@ -2,19 +2,19 @@ import { Factory } from '../../core';
 import { __InputStylesNames } from '../Input';
 import { TextareaProps } from '../Textarea';
 export interface JsonInputProps extends Omit<TextareaProps, 'onChange'> {
-    /** Value for controlled component */
+    /** Controlled component value */
     value?: string;
-    /** Default value for uncontrolled component */
+    /** Uncontrolled component default value */
     defaultValue?: string;
     /** Called when value changes */
     onChange?: (value: string) => void;
-    /** Determines whether the value should be formatted on blur, `false` by default */
+    /** Determines whether the value should be formatted on blur @default `false` */
     formatOnBlur?: boolean;
     /** Error message displayed when value is not valid JSON */
     validationError?: React.ReactNode;
-    /** Function to serialize value into a string, used for value formatting, `JSON.stringify` by default */
+    /** Function to serialize value into a string, used for value formatting @default `JSON.stringify` */
     serialize?: typeof JSON.stringify;
-    /** Function to deserialize string value, used for value formatting and input JSON validation, must throw error if string cannot be processed, `JSON.parse` by default */
+    /** Function to deserialize string value, used for value formatting and input JSON validation, must throw error if string cannot be processed @default `JSON.parse` */
     deserialize?: typeof JSON.parse;
 }
 export type JsonInputFactory = Factory<{

package/lib/components/Kbd/Kbd.d.ts

@@ -4,7 +4,7 @@ export type KbdCssVariables = {
     root: '--kbd-fz';
 };
 export interface KbdProps extends BoxProps, StylesApiProps<KbdFactory>, ElementProps<'kbd'> {
-    /** Controls `font-size` and `padding`, `'sm'` by default */
+    /** Controls `font-size` and `padding` @default `'sm'` */
     size?: MantineSize | number | (string & {});
 }
 export type KbdFactory = Factory<{

package/lib/components/List/List.d.ts

@@ -5,19 +5,19 @@ export type ListCssVariables = {
     root: '--list-fz' | '--list-lh' | '--list-spacing';
 };
 export interface ListProps extends BoxProps, StylesApiProps<ListFactory>, ElementProps<'ol', 'type'> {
-    /** `List.Item` components only */
+    /** `List.Item` components */
     children?: React.ReactNode;
-    /** List type: `ol` or `ul`, `'unordered'` by default */
+    /** List type @default `'unordered'` */
     type?: 'ordered' | 'unordered';
-    /** Determines whether list items should be offset with padding, `false` by default */
+    /** Determines whether list items should be offset with padding @default `false` */
     withPadding?: boolean;
-    /** Controls `font-size` and `line-height`, `'md'` by default */
+    /** Controls `font-size` and `line-height` @default `'md'` */
     size?: MantineSize;
-    /** Icon that replaces list item dot */
+    /** Icon to replace list item dot */
     icon?: React.ReactNode;
-    /** Key of `theme.spacing` or any valid CSS value to set spacing between items, `0` by default */
+    /** Key of `theme.spacing` or any valid CSS value to set spacing between items @default `0` */
     spacing?: MantineSpacing;
-    /** Determines whether items must be centered with their icon, `false` by default */
+    /** Determines whether items must be centered with their icon @default `false` */
     center?: boolean;
     /** Controls `list-style-type`, by default inferred from `type` */
     listStyleType?: React.CSSProperties['listStyleType'];

package/lib/components/Loader/Loader.d.ts

@@ -5,13 +5,13 @@ export type LoaderCssVariables = {
     root: '--loader-size' | '--loader-color';
 };
 export interface LoaderProps extends BoxProps, StylesApiProps<LoaderFactory>, Omit<React.ComponentPropsWithoutRef<'svg'>, keyof BoxProps> {
-    /** Controls `width` and `height` of the loader. `Loader` has predefined `xs`-`xl` values. Numbers are converted to rem. Default value is `'md'` */
+    /** Controls `width` and `height` of the loader. `Loader` has predefined `xs`-`xl` values. Numbers are converted to rem. @default `'md'` */
     size?: MantineSize | (string & {}) | number;
-    /** Key of `theme.colors` or any valid CSS color, default value is `theme.primaryColor`  */
+    /** Key of `theme.colors` or any valid CSS color @default `theme.primaryColor` */
     color?: MantineColor;
-    /** Loader type, key of `loaders` prop, default value is `'oval'` */
+    /** Loader type, key of `loaders` prop @default `'oval'` */
     type?: MantineLoader;
-    /** Object of loaders components, can be customized via default props or inline. Default value contains `bars`, `oval` and `dots` */
+    /** Object of loaders components, can be customized via default props or inline. */
     loaders?: MantineLoadersRecord;
     /** Overrides default loader with given content */
     children?: React.ReactNode;

package/lib/components/LoadingOverlay/LoadingOverlay.d.ts

@@ -7,15 +7,15 @@ export type LoadingOverlayCssVariables = {
     root: '--lo-z-index';
 };
 export interface LoadingOverlayProps extends BoxProps, StylesApiProps<LoadingOverlayFactory>, ElementProps<'div'> {
-    /** Props passed down to `Transition` component, `{ transition: 'fade', duration: 0 }` by default */
+    /** Props passed down to `Transition` component @default `{ transition: 'fade', duration: 0 }` */
     transitionProps?: TransitionOverride;
     /** Props passed down to `Loader` component */
     loaderProps?: LoaderProps;
     /** Props passed down to `Overlay` component */
     overlayProps?: OverlayProps;
-    /** Determines whether the overlay should be visible, `false` by default */
+    /** Determines whether the overlay should be visible @default `false` */
     visible?: boolean;
-    /** Controls overlay `z-index`, `400` by default */
+    /** Controls overlay `z-index` @default `400` */
     zIndex?: string | number;
 }
 export type LoadingOverlayFactory = Factory<{

package/lib/components/Mark/Mark.d.ts

@@ -4,7 +4,7 @@ export type MarkCssVariables = {
     root: '--mark-bg-dark' | '--mark-bg-light';
 };
 export interface MarkProps extends BoxProps, StylesApiProps<MarkFactory>, ElementProps<'mark'> {
-    /** Key of `theme.colors` or any valid CSS color, `yellow` by default */
+    /** Key of `theme.colors` or any valid CSS color @default `yellow` */
     color?: MantineColor;
 }
 export type MarkFactory = Factory<{

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 {