@mantine/core 8.1.3 → 8.2.1

package/lib/components/Stepper/Stepper.d.ts

@@ -9,37 +9,37 @@ export type StepperCssVariables = {
     root: '--stepper-color' | '--stepper-icon-color' | '--stepper-icon-size' | '--stepper-content-padding' | '--stepper-radius' | '--stepper-fz' | '--stepper-spacing';
 };
 export interface StepperProps extends BoxProps, StylesApiProps<StepperFactory>, ElementProps<'div'> {
-    /** <Stepper.Step /> components */
+    /** `Stepper.Step` components */
     children: React.ReactNode;
     /** Called when step is clicked */
     onStepClick?: (stepIndex: number) => void;
     /** Index of the active step */
     active: number;
-    /** Step icon, default value is step index + 1 */
+    /** Step icon, default value is `step index + 1` */
     icon?: React.ReactNode | StepFragmentComponent;
     /** Step icon displayed when step is completed, check icon by default */
     completedIcon?: React.ReactNode | StepFragmentComponent;
-    /** Step icon displayed when step is in progress, default value is step index + 1 */
+    /** Step icon displayed when step is in progress, default value is `step index + 1` */
     progressIcon?: React.ReactNode | StepFragmentComponent;
-    /** Key of `theme.colors` or any valid CSS color, controls colors of active and progress steps, `theme.primaryColor` by default */
+    /** Key of `theme.colors` or any valid CSS color, controls colors of active and progress steps @default `theme.primaryColor` */
     color?: MantineColor;
     /** Controls size of the step icon, by default icon size is inferred from `size` prop */
     iconSize?: number | string;
     /** Key of `theme.spacing` or any valid CSS value to set `padding-top` of the content */
     contentPadding?: MantineSpacing;
-    /** Stepper orientation, `'horizontal'` by default */
+    /** Stepper orientation @default `'horizontal'` */
     orientation?: 'vertical' | 'horizontal';
-    /** Icon position relative to the step body, `'left'` by default */
+    /** Icon position relative to the step body @default `'left'` */
     iconPosition?: 'right' | 'left';
     /** Controls size of various Stepper elements */
     size?: MantineSize;
-    /** Key of `theme.radius` or any valid CSS value to set steps border-radius, `"xl"` by default */
+    /** Key of `theme.radius` or any valid CSS value to set steps border-radius @default `"xl"` */
     radius?: MantineRadius;
-    /** Determines whether next steps can be selected, `true` by default **/
+    /** If set, next steps can be selected @default `true` */
     allowNextStepsSelect?: boolean;
-    /** Determines whether steps should wrap to the next line if no space is available, `true` by default */
+    /** Determines whether steps should wrap to the next line if no space is available @default `true` */
     wrap?: boolean;
-    /** Determines whether icon color with filled variant should depend on `background-color`. If luminosity of the `color` prop is less than `theme.luminosityThreshold`, then `theme.white` will be used for text color, otherwise `theme.black`. Overrides `theme.autoContrast`. */
+    /** If set, adjusts text color based on background color for `filled` variant */
     autoContrast?: boolean;
 }
 export type StepperFactory = Factory<{

package/lib/components/Stepper/StepperStep/StepperStep.d.ts

@@ -2,7 +2,7 @@ import { BoxProps, CompoundStylesApiProps, ElementProps, Factory, MantineColor }
 import type { StepFragmentComponent } from '../Stepper';
 export type StepperStepStylesNames = 'step' | 'stepLoader' | 'verticalSeparator' | 'stepWrapper' | 'stepIcon' | 'stepCompletedIcon' | 'stepBody' | 'stepLabel' | 'stepDescription';
 export interface StepperStepProps extends BoxProps, CompoundStylesApiProps<StepperStepFactory>, ElementProps<'button'> {
-    /** Step index, controlled by Stepper component **/
+    /** Step index, controlled by Stepper component */
     step?: number;
     /** Step state, controlled by Stepper component */
     state?: 'stepInactive' | 'stepProgress' | 'stepCompleted';
@@ -10,7 +10,7 @@ export interface StepperStepProps extends BoxProps, CompoundStylesApiProps<Stepp
     color?: MantineColor;
     /** Determines whether the icon should be displayed */
     withIcon?: boolean;
-    /** Step icon, defaults to step index + 1 when rendered within Stepper */
+    /** Step icon, defaults to `step index + 1` when rendered within Stepper */
     icon?: React.ReactNode | StepFragmentComponent;
     /** Step icon displayed when step is completed */
     completedIcon?: React.ReactNode | StepFragmentComponent;

package/lib/components/Switch/Switch.d.ts

@@ -1,5 +1,5 @@
 import { BoxProps, DataAttributes, ElementProps, Factory, MantineColor, MantineRadius, MantineSize, StylesApiProps } from '../../core';
-import { InlineInputStylesNames } from '../InlineInput';
+import { InlineInputStylesNames } from '../../utils/InlineInput';
 import { SwitchGroup } from './SwitchGroup/SwitchGroup';
 export type SwitchStylesNames = 'root' | 'track' | 'trackLabel' | 'thumb' | 'input' | InlineInputStylesNames;
 export type SwitchCssVariables = {
@@ -14,17 +14,17 @@ export interface SwitchProps extends BoxProps, StylesApiProps<SwitchFactory>, El
     offLabel?: React.ReactNode;
     /** Inner label when the `Switch` is in checked state */
     onLabel?: React.ReactNode;
-    /** Key of `theme.colors` or any valid CSS color to set input color in checked state, `theme.primaryColor` by default */
+    /** Key of `theme.colors` or any valid CSS color to set input color in checked state @default `theme.primaryColor` */
     color?: MantineColor;
     /** Controls size of all elements */
     size?: MantineSize | (string & {});
-    /** Key of `theme.radius` or any valid CSS value to set `border-radius,` "xl" by default */
+    /** Key of `theme.radius` or any valid CSS value to set `border-radius,` @default `'xl'` */
     radius?: MantineRadius;
     /** Props passed down to the root element */
     wrapperProps?: React.ComponentPropsWithoutRef<'div'> & DataAttributes;
     /** Icon inside the thumb of the switch */
     thumbIcon?: React.ReactNode;
-    /** Position of the label relative to the input, `'right'` by default */
+    /** Position of the label relative to the input @default `'right'` */
     labelPosition?: 'left' | 'right';
     /** Description displayed below the label */
     description?: React.ReactNode;
@@ -32,7 +32,7 @@ export interface SwitchProps extends BoxProps, StylesApiProps<SwitchFactory>, El
     error?: React.ReactNode;
     /** Assigns ref of the root element */
     rootRef?: React.ForwardedRef<HTMLDivElement>;
-    /** If set, the indicator will be displayed inside thumb, `true` by default */
+    /** If set, the indicator will be displayed inside thumb @default `true` */
     withThumbIndicator?: boolean;
 }
 export type SwitchFactory = Factory<{

package/lib/components/Switch/SwitchGroup/SwitchGroup.d.ts

@@ -12,7 +12,7 @@ export interface SwitchGroupProps extends Omit<InputWrapperProps, 'onChange'> {
     onChange?: (value: string[]) => void;
     /** Props passed down to the `Input.Wrapper` */
     wrapperProps?: React.ComponentPropsWithoutRef<'div'> & DataAttributes;
-    /** Controls size of the `Input.Wrapper`, `'sm'` by default */
+    /** Controls size of the `Input.Wrapper` @default `'sm'` */
     size?: MantineSize | (string & {});
     /** If set, value cannot be changed */
     readOnly?: boolean;

package/lib/components/Table/Table.d.ts

@@ -14,37 +14,37 @@ export interface TableData {
     caption?: string;
 }
 export interface TableProps extends BoxProps, StylesApiProps<TableFactory>, ElementProps<'table'> {
-    /** Value of `table-layout` style, `auto` by default */
+    /** Value of `table-layout` style @default `auto` */
     layout?: React.CSSProperties['tableLayout'];
-    /** Determines on which side `Table.Caption` is displayed, `bottom` by default */
+    /** Side of the `Table.Caption` @default `bottom` */
     captionSide?: 'top' | 'bottom';
     /** Color of table borders, key of `theme.colors` or any valid CSS color */
     borderColor?: MantineColor;
-    /** Determines whether the table should have outer border, `false` by default */
+    /** If set, the table has the outer border @default `false` */
     withTableBorder?: boolean;
-    /** Determines whether the table should have borders between columns, `false` by default */
+    /** If set, the table has borders between columns @default `false` */
     withColumnBorders?: boolean;
-    /** Determines whether the table should have borders between rows, `true` by default */
+    /** If set, the table has borders between rows @default `true` */
     withRowBorders?: boolean;
-    /** Horizontal cells spacing, key of `theme.spacing` or any valid CSS value for padding, numbers are converted to rem, default value is `xs` */
+    /** Horizontal cells spacing, key of `theme.spacing` or any valid CSS value for padding, numbers are converted to rem @default `xs` */
     horizontalSpacing?: MantineSpacing;
-    /** Vertical cells spacing, key of `theme.spacing` or any valid CSS value for padding, numbers are converted to rem, default value is `xs` */
+    /** Vertical cells spacing, key of `theme.spacing` or any valid CSS value for padding, numbers are converted to rem @default `xs` */
     verticalSpacing?: MantineSpacing;
-    /** Determines whether every odd/even row background should be changed to `strippedColor`, if set to `true`, then `odd` value will be used, `false` by default  */
+    /** If set, every odd/even row background changes to `strippedColor`, if set to `true`, then `odd` value will be used @default `false`  */
     striped?: boolean | 'odd' | 'even';
     /** Background color of striped rows, key of `theme.colors` or any valid CSS color */
     stripedColor?: MantineColor;
-    /** Determines whether table rows background should change to `highlightOnHoverColor` when hovered, `false` by default */
+    /** If set, table rows background changes to `highlightOnHoverColor` when hovered @default `false` */
     highlightOnHover?: boolean;
     /** Background color of table rows when hovered, key of `theme.colors` or any valid CSS color */
     highlightOnHoverColor?: MantineColor;
-    /** Data that should be used to generate table, ignored if `children` prop is set */
+    /** Data used to generate table, ignored if `children` prop is set */
     data?: TableData;
-    /** Determines whether `Table.Thead` should be sticky, `false` by default */
+    /** If set, `Table.Thead` is sticky @default `false` */
     stickyHeader?: boolean;
-    /** Offset from top at which `Table.Thead` should become sticky, `0` by default */
+    /** Offset from top at which `Table.Thead` should become sticky @default `0` */
     stickyHeaderOffset?: number | string;
-    /** Determines whether `font-variant-numeric: tabular-nums` style should be set, `false` by default */
+    /** If set, `font-variant-numeric: tabular-nums` style is applied @default `false` */
     tabularNums?: boolean;
 }
 export type TableFactory = Factory<{

package/lib/components/Table/TableScrollContainer.d.ts

@@ -9,7 +9,7 @@ export interface TableScrollContainerProps extends BoxProps, StylesApiProps<Tabl
     minWidth: React.CSSProperties['minWidth'];
     /** `max-height` of the `Table` at which it should become scrollable */
     maxHeight?: React.CSSProperties['maxHeight'];
-    /** Type of the scroll container, `native` to use native scrollbars, `scrollarea` to use `ScrollArea` component, `scrollarea` by default */
+    /** Type of the scroll container, `native` to use native scrollbars, `scrollarea` to use `ScrollArea` component @default `'scrollarea'` */
     type?: 'native' | 'scrollarea';
     /** Props passed down to `ScrollArea` component, not applicable with `type="native"` */
     scrollAreaProps?: ScrollAreaProps;

package/lib/components/TableOfContents/TableOfContents.d.ts

@@ -21,15 +21,15 @@ export interface TableOfContentsGetControlPropsPayload {
     data: UseScrollSpyHeadingData;
 }
 export interface TableOfContentsProps extends BoxProps, StylesApiProps<TableOfContentsFactory>, ElementProps<'div'> {
-    /** Key of `theme.colors` or any valid CSS color value, `theme.primaryColor` by default */
+    /** Key of `theme.colors` or any valid CSS color value @default `theme.primaryColor` */
     color?: MantineColor;
-    /** Controls font-size and padding of all elements, `'md'` by default */
+    /** Controls font-size and padding of all elements @default `'md'` */
     size?: MantineSize | (string & {}) | number;
-    /** Determines whether text color with filled variant should depend on `background-color`. If luminosity of the `color` prop is less than `theme.luminosityThreshold`, then `theme.white` will be used for text color, otherwise `theme.black`. Overrides `theme.autoContrast`. */
+    /** If set, adjusts text color based on background color for `filled` variant */
     autoContrast?: boolean;
     /** Options passed down to `use-scroll-spy` hook */
     scrollSpyOptions?: UseScrollSpyOptions;
-    /** Data used to render content until actual values are retrieved from the DOM, empty array by default */
+    /** Data used to render content until actual values are retrieved from the DOM */
     initialData?: InitialTableOfContentsData[];
     /** A function to pass props down to controls, accepts values from `use-scroll-spy` hook as an argument and active state. */
     getControlProps?: (payload: TableOfContentsGetControlPropsPayload) => UnstyledButtonProps & ElementProps<'button'> & Record<`data-${string}`, any>;
@@ -37,7 +37,7 @@ export interface TableOfContentsProps extends BoxProps, StylesApiProps<TableOfCo
     minDepthToOffset?: number;
     /** Controls padding on the left side of control, multiplied by (`depth` - `minDepthToOffset`), `20px` by default  */
     depthOffset?: number | string;
-    /** Key of `theme.radius` or any valid CSS value to set `border-radius`, `theme.defaultRadius` by default */
+    /** Key of `theme.radius` or any valid CSS value to set `border-radius`@default `theme.defaultRadius` */
     radius?: MantineRadius;
     /** A function to reinitialize headings from `use-scroll-spy` hook */
     reinitializeRef?: React.RefObject<() => void>;

package/lib/components/Tabs/Tabs.d.ts

@@ -8,35 +8,35 @@ export type TabsCssVariables = {
     root: '--tabs-color' | '--tabs-radius';
 };
 export interface TabsProps extends BoxProps, StylesApiProps<TabsFactory>, ElementProps<'div', 'defaultValue' | 'value' | 'onChange'> {
-    /** Default value for uncontrolled component */
+    /** Uncontrolled component default value */
     defaultValue?: string | null;
-    /** Value for controlled component */
+    /** Controlled component value */
     value?: string | null;
     /** Called when value changes */
     onChange?: (value: string | null) => void;
-    /** Tabs orientation, `'horizontal'` by default */
+    /** Tabs orientation @default `'horizontal'` */
     orientation?: 'vertical' | 'horizontal';
-    /** `Tabs.List` placement relative to `Tabs.Panel`, applicable only when `orientation="vertical"`, `'left'` by default */
+    /** `Tabs.List` placement relative to `Tabs.Panel`, applicable only when `orientation="vertical"` @default `'left'` */
     placement?: 'left' | 'right';
     /** Base id, used to generate ids to connect labels with controls, generated randomly by default */
     id?: string;
-    /** Determines whether arrow key presses should loop though items (first to last and last to first), `true` by default */
+    /** If set, arrow key presses loop though items (first to last and last to first) @default `true` */
     loop?: boolean;
-    /** Determines whether tab should be activated with arrow key press, `true` by default */
+    /** If set, tab is activated with arrow key press @default `true` */
     activateTabWithKeyboard?: boolean;
-    /** Determines whether tab can be deactivated, `false` by default */
+    /** If set, tab can be deactivated @default `false` */
     allowTabDeactivation?: boolean;
     /** Tabs content */
     children?: React.ReactNode;
     /** Changes colors of `Tabs.Tab` components when variant is `pills` or `default`, does nothing for other variants */
     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;
-    /** Determines whether tabs should have inverted styles, `false` by default */
+    /** Determines whether tabs should have inverted styles @default `false` */
     inverted?: boolean;
-    /** If set to `false`, `Tabs.Panel` content will be unmounted when the associated tab is not active, `true` by default */
+    /** If set to `false`, `Tabs.Panel` content will be unmounted when the associated tab is not active @default `true` */
     keepMounted?: boolean;
-    /** 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`. Only applicable when `variant="pills"` */
+    /** If set, adjusts text color based on background color for `pills` variant */
     autoContrast?: boolean;
 }
 export type TabsFactory = Factory<{

package/lib/components/Tabs/TabsList/TabsList.d.ts

@@ -3,9 +3,9 @@ export type TabsListStylesNames = 'list';
 export interface TabsListProps extends BoxProps, CompoundStylesApiProps<TabsListFactory>, ElementProps<'div'> {
     /** `Tabs.Tab` components */
     children: React.ReactNode;
-    /** Determines whether tabs should take all available space, `false` by default */
+    /** Determines whether tabs should take all available space @default `false` */
     grow?: boolean;
-    /** Tabs alignment, `flex-start` by default */
+    /** Tabs alignment @default `flex-start` */
     justify?: React.CSSProperties['justifyContent'];
 }
 export type TabsListFactory = Factory<{

package/lib/components/Tabs/TabsPanel/TabsPanel.d.ts

@@ -3,7 +3,7 @@ export type TabsPanelStylesNames = 'panel';
 export interface TabsPanelProps extends BoxProps, CompoundStylesApiProps<TabsPanelFactory>, ElementProps<'div'> {
     /** Panel content */
     children: React.ReactNode;
-    /** If set to `true`, the content will be kept mounted, even if `keepMounted` is set `false` in the parent `Tabs` component */
+    /** If set, the content is kept mounted, even if `keepMounted` is set `false` in the parent `Tabs` component */
     keepMounted?: boolean;
     /** Value of associated control */
     value: string;

package/lib/components/Tabs/TabsTab/TabsTab.d.ts

@@ -6,9 +6,9 @@ export interface TabsTabProps extends Omit<UnstyledButtonProps, 'classNames' | '
     value: string;
     /** Tab label */
     children?: React.ReactNode;
-    /** Content displayed on the right side of the label, for example, icon */
+    /** Content displayed on the right side of the label */
     rightSection?: React.ReactNode;
-    /** Content displayed on the left side of the label, for example, icon */
+    /** Content displayed on the left side of the label */
     leftSection?: React.ReactNode;
     /** Key of `theme.colors` or any valid CSS color, controls control color based on `variant` */
     color?: MantineColor;

package/lib/components/TagsInput/TagsInput.d.ts

@@ -4,11 +4,11 @@ import { __BaseInputProps, __InputStylesNames, InputClearButtonProps } from '../
 import { ScrollAreaProps } from '../ScrollArea';
 export type TagsInputStylesNames = __InputStylesNames | ComboboxLikeStylesNames | 'pill' | 'pillsList' | 'inputField';
 export interface TagsInputProps extends BoxProps, __BaseInputProps, Omit<ComboboxLikeProps, 'data'>, StylesApiProps<TagsInputFactory>, ElementProps<'input', 'size' | 'value' | 'defaultValue' | 'onChange'> {
-    /** Data displayed in the dropdown. Values must be unique, otherwise an error will be thrown and component will not render. */
+    /** Data displayed in the dropdown. Values must be unique. */
     data?: ComboboxStringData;
     /** Controlled component value */
     value?: string[];
-    /** Default value for uncontrolled component */
+    /** Uncontrolled component default value */
     defaultValue?: string[];
     /** Called when value changes */
     onChange?: (value: string[]) => void;
@@ -22,27 +22,27 @@ export interface TagsInputProps extends BoxProps, __BaseInputProps, Omit<Combobo
     defaultSearchValue?: string;
     /** Called when search changes */
     onSearchChange?: (value: string) => void;
-    /** Maximum number of tags, `Infinity` by default */
+    /** Maximum number of tags @default `Infinity` */
     maxTags?: number;
-    /** Determines whether duplicate tags are allowed, `false` by default */
+    /** If set, duplicate tags are allowed @default `false` */
     allowDuplicates?: boolean;
     /** Called when user tries to submit a duplicated tag */
     onDuplicate?: (value: string) => void;
     /** Characters that should trigger tags split, `[',']` by default */
     splitChars?: string[];
-    /** 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?: (input: ComboboxLikeRenderOptionInput<ComboboxStringItem>) => React.ReactNode;
     /** Props passed down to the underlying `ScrollArea` component in the dropdown */
     scrollAreaProps?: ScrollAreaProps;
-    /** Determines whether the value typed in by the user but not submitted should be accepted when the input is blurred, `true` by default */
+    /** If set, the value typed in by the user but not submitted is accepted when the input is blurred @default `true` */
     acceptValueOnBlur?: boolean;
     /** Custom function to determine if a tag is duplicate. Accepts tag value and array of current values. By default, checks if the tag exists case-insensitively. */
     isDuplicate?: (value: string, currentValues: string[]) => boolean;

package/lib/components/Text/Text.d.ts

@@ -7,19 +7,19 @@ export type TextCssVariables = {
 };
 export interface TextProps extends BoxProps, StylesApiProps<TextFactory> {
     __staticSelector?: string;
-    /** Controls `font-size` and `line-height`, `'md'` by default */
+    /** Controls `font-size` and `line-height` @default `'md'` */
     size?: MantineFontSize | MantineLineHeight;
     /** Number of lines after which Text will be truncated */
     lineClamp?: number;
     /** Side on which Text must be truncated, if `true`, text is truncated from the start */
     truncate?: TextTruncate;
-    /** Sets `line-height` to 1 for centering, `false` by default */
+    /** Sets `line-height` to 1 for centering @default `false` */
     inline?: boolean;
-    /** Determines whether font properties should be inherited from the parent, `false` by default */
+    /** Determines whether font properties should be inherited from the parent @default `false` */
     inherit?: boolean;
-    /** Gradient configuration, ignored when `variant` is not `gradient`, `theme.defaultGradient` by default */
+    /** Gradient configuration, ignored when `variant` is not `gradient` @default `theme.defaultGradient` */
     gradient?: MantineGradient;
-    /** Shorthand for `component="span"`, `false` by default, default root element is `p` */
+    /** Shorthand for `component="span"` */
     span?: boolean;
     /** @deprecated Use `c` prop instead */
     color?: MantineColor;

package/lib/components/Textarea/Textarea.d.ts

@@ -2,13 +2,13 @@ import { BoxProps, ElementProps, Factory, StylesApiProps } from '../../core';
 import { __BaseInputProps, __InputStylesNames } from '../Input';
 export interface TextareaProps extends BoxProps, __BaseInputProps, StylesApiProps<TextareaFactory>, ElementProps<'textarea', 'size'> {
     __staticSelector?: string;
-    /** Determines whether the textarea height should grow with its content, `false` by default */
+    /** If set, enables textarea height growing with its content @default `false` */
     autosize?: boolean;
     /** Maximum rows for autosize textarea to grow, ignored if `autosize` prop is not set */
     maxRows?: number;
     /** Minimum rows of autosize textarea, ignored if `autosize` prop is not set */
     minRows?: number;
-    /** Controls `resize` CSS property, `'none'` by default */
+    /** Controls `resize` CSS property @default `'none'` */
     resize?: React.CSSProperties['resize'];
 }
 export type TextareaFactory = Factory<{

package/lib/components/ThemeIcon/ThemeIcon.d.ts

@@ -5,17 +5,17 @@ export type ThemeIconCssVariables = {
     root: '--ti-radius' | '--ti-size' | '--ti-bg' | '--ti-color' | '--ti-bd';
 };
 export interface ThemeIconProps extends BoxProps, StylesApiProps<ThemeIconFactory>, ElementProps<'div'> {
-    /** Controls width and height of the button. Numbers are converted to rem. `'md'` by default. */
+    /** Controls width and height of the button. Numbers are converted to rem. @default `'md'` */
     size?: MantineSize | (string & {}) | number;
-    /** Key of `theme.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;
-    /** 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;
-    /** Gradient data used when `variant="gradient"`, default value is `theme.defaultGradient` */
+    /** Gradient data used when `variant="gradient"` @default `theme.defaultGradient` */
     gradient?: MantineGradient;
     /** Icon displayed inside the component */
     children?: React.ReactNode;
-    /** 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 ThemeIconFactory = Factory<{

package/lib/components/Timeline/Timeline.d.ts

@@ -7,21 +7,21 @@ export type TimelineCssVariables = {
 export interface TimelineProps extends BoxProps, StylesApiProps<TimelineFactory>, ElementProps<'div'> {
     /** `Timeline.Item` components */
     children?: React.ReactNode;
-    /** Index of active element */
+    /** Index of the active element */
     active?: number;
-    /** Key of `theme.colors` or any valid CSS color to control active item colors, `theme.primaryColor` by default */
+    /** Key of `theme.colors` or any valid CSS color to control active item colors @default `theme.primaryColor` */
     color?: MantineColor;
-    /** 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;
-    /** Controls size of the bullet, `20` by default */
+    /** Size of the bullet @default `20` */
     bulletSize?: number | string;
-    /** Controls how the content is positioned relative to the bullet, `'left'` by default */
+    /** Position of content relative to the bullet @default `'left'` */
     align?: 'right' | 'left';
     /** Control width of the line */
     lineWidth?: number | string;
-    /** Determines whether the active items direction should be reversed without reversing items order, `false` by default */
+    /** If set, the active items direction is reversed without reversing items order @default `false` */
     reverseActive?: boolean;
-    /** Determines whether icon color 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 TimelineFactory = Factory<{

package/lib/components/Timeline/TimelineItem/TimelineItem.d.ts

@@ -1,11 +1,8 @@
 import { BoxProps, CompoundStylesApiProps, ElementProps, Factory, MantineColor, MantineRadius } from '../../../core';
 export type TimelineItemStylesNames = 'itemBody' | 'itemContent' | 'itemBullet' | 'item' | 'itemTitle';
 export interface TimelineItemProps extends BoxProps, CompoundStylesApiProps<TimelineItemFactory>, ElementProps<'div', 'title'> {
-    /** Determines whether the item should be highlighted, controlled by the parent `Timeline` component  */
     __active?: boolean;
-    /** Determines whether the line of the item should be highlighted, controlled by the parent Timeline component */
     __lineActive?: boolean;
-    /** Line and bullet position relative to item content, controlled by the parent Timeline component */
     __align?: 'right' | 'left';
     /** Item title, displayed next to the bullet */
     title?: React.ReactNode;
@@ -13,11 +10,11 @@ export interface TimelineItemProps extends BoxProps, CompoundStylesApiProps<Time
     children?: React.ReactNode;
     /** React node that should be rendered inside the bullet – icon, image, avatar, etc. By default, large white dot is displayed. */
     bullet?: React.ReactNode;
-    /** 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;
-    /** Key of `theme.colors` or any valid CSS color to control active item colors, `theme.primaryColor` by default */
+    /** Key of `theme.colors` or any valid CSS color to control active item colors @default `theme.primaryColor` */
     color?: MantineColor;
-    /** Controls line border style, `'solid'` by default */
+    /** Controls line border style @default `'solid'` */
     lineVariant?: 'solid' | 'dashed' | 'dotted';
 }
 export type TimelineItemFactory = Factory<{

package/lib/components/Title/Title.d.ts

@@ -6,13 +6,13 @@ export type TitleCssVariables = {
     root: '--title-fw' | '--title-lh' | '--title-fz' | '--title-line-clamp' | '--title-text-wrap';
 };
 export interface TitleProps extends BoxProps, StylesApiProps<TitleFactory>, ElementProps<'h1', 'color'> {
-    /** Determines which tag will be used (h1-h6), controls `font-size` style if `size` prop is not set, `1` by default */
+    /** Heading order (1-6), controls `font-size` style if `size` prop is not set @default `1` */
     order?: TitleOrder;
     /** Changes title size, if not set, then size is controlled by `order` prop */
     size?: TitleSize;
-    /** Number of lines after which Text will be truncated */
+    /** Number of lines after which heading will be truncated */
     lineClamp?: number;
-    /** Controls `text-wrap` property, `'wrap'` by default */
+    /** Heading `text-wrap` CSS property @default `'wrap'` */
     textWrap?: 'wrap' | 'nowrap' | 'balance' | 'pretty' | 'stable';
 }
 export type TitleFactory = Factory<{

package/lib/components/Tooltip/Tooltip.d.ts

@@ -1,5 +1,5 @@
 import { Factory } from '../../core';
-import { ArrowPosition, FloatingAxesOffsets, FloatingPosition, FloatingStrategy } from '../Floating';
+import { ArrowPosition, FloatingAxesOffsets, FloatingPosition, FloatingStrategy } from '../../utils/Floating';
 import { TransitionOverride } from '../Transition';
 import { TooltipBaseProps, TooltipCssVariables, TooltipStylesNames } from './Tooltip.types';
 import { TooltipFloating } from './TooltipFloating/TooltipFloating';
@@ -9,27 +9,27 @@ export interface TooltipProps extends TooltipBaseProps {
     onPositionChange?: (position: FloatingPosition) => void;
     /** Open delay in ms */
     openDelay?: number;
-    /** Close delay in ms, `0` by default */
+    /** Close delay in ms @default `0` */
     closeDelay?: number;
     /** Controlled opened state */
     opened?: boolean;
     /** Uncontrolled tooltip initial opened state */
     defaultOpened?: boolean;
-    /** Space between target element and tooltip in px, `5` by default */
+    /** Space between target element and tooltip in px @default `5` */
     offset?: number | FloatingAxesOffsets;
-    /** Determines whether the tooltip should have an arrow, `false` by default */
+    /** If set, the tooltip has an arrow @default `false` */
     withArrow?: boolean;
-    /** Arrow size in px, `4` by default */
+    /** Arrow size in px @default `4` */
     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 relative to the tooltip, `side` by default */
+    /** Arrow position relative to the tooltip @default `side` */
     arrowPosition?: ArrowPosition;
-    /** Props passed down to the `Transition` component that used to animate tooltip presence, use to configure duration and animation type, `{ duration: 100, transition: 'fade' }` by default */
+    /** Props passed down to the `Transition` component that used to animate tooltip presence, use to configure duration and animation type @default `{ duration: 100, transition: 'fade' }` */
     transitionProps?: TransitionOverride;
-    /** Determines which events will be used to show tooltip, `{ hover: true, focus: false, touch: false }` by default */
+    /** Determines which events will be used to show tooltip @default `{ hover: true, focus: false, touch: false }` */
     events?: {
         hover: boolean;
         focus: boolean;
@@ -39,12 +39,14 @@ export interface TooltipProps extends TooltipBaseProps {
     positionDependencies?: any[];
     /** Must be set if the tooltip target is an inline element */
     inline?: boolean;
-    /** If set, the tooltip will not be unmounted from the DOM when it is hidden, `display: none` styles will be applied instead */
+    /** If set, the tooltip is not unmounted from the DOM when hidden, `display: none` styles are applied instead */
     keepMounted?: 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;
-    /** Determines whether tooltip text color 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;
+    /** Selector, ref of an element or element itself that should be used for positioning */
+    target?: React.RefObject<HTMLElement | null> | HTMLElement | null | string;
 }
 export type TooltipFactory = Factory<{
     props: TooltipProps;

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

@@ -1,6 +1,6 @@
 import type { FlipOptions, InlineOptions, ShiftOptions, SizeOptions } from '@floating-ui/react';
 import { BoxProps, ElementProps, MantineColor, MantineRadius, StylesApiProps } from '../../core';
-import { FloatingPosition } from '../Floating';
+import { FloatingPosition } from '../../utils/Floating';
 import { BasePortalProps } from '../Portal';
 import type { TooltipFactory } from './Tooltip';
 export type TooltipStylesNames = 'tooltip' | 'arrow';
@@ -15,7 +15,7 @@ export interface TooltipMiddlewares {
 }
 export interface TooltipBaseProps extends BoxProps, StylesApiProps<TooltipFactory>, ElementProps<'div'> {
     /** Target element, must support `ref` prop and `...others` */
-    children: React.ReactNode;
+    children?: React.ReactNode;
     /** Tooltip position relative to target element (`Tooltip` component) or mouse (`Tooltip.Floating` component) */
     position?: FloatingPosition;
     /** Key of the prop that can be used to access element ref, `ref` by default */
@@ -24,7 +24,7 @@ export interface TooltipBaseProps extends BoxProps, StylesApiProps<TooltipFactor
     label: React.ReactNode;
     /** Determines whether tooltip should be rendered within `Portal`, `true` by default */
     withinPortal?: 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;
     /** Key of `theme.colors` or any valid CSS color, controls tooltip background, by default set based on current color scheme */
     color?: MantineColor;

package/lib/components/Tooltip/TooltipFloating/TooltipFloating.d.ts

@@ -1,7 +1,7 @@
 import { Factory } from '../../../core';
 import { TooltipBaseProps, TooltipCssVariables, TooltipStylesNames } from '../Tooltip.types';
 export interface TooltipFloatingProps extends TooltipBaseProps {
-    /** Offset from mouse in px, `10` by default */
+    /** Offset from mouse in px @default `10` */
     offset?: number;
     /** Uncontrolled tooltip initial opened state */
     defaultOpened?: boolean;

package/lib/components/Tooltip/TooltipFloating/use-floating-tooltip.d.ts

@@ -1,4 +1,4 @@
-import { FloatingPosition } from '../../Floating';
+import { FloatingPosition } from '../../../utils/Floating';
 interface UseFloatingTooltip {
     offset: number;
     position: FloatingPosition;

package/lib/components/Tooltip/TooltipGroup/TooltipGroup.d.ts

@@ -1,6 +1,6 @@
 import { ExtendComponent, Factory, MantineThemeComponent } from '../../../core';
 export interface TooltipGroupProps {
-    /** <Tooltip /> components */
+    /** `Tooltip` components */
     children: React.ReactNode;
     /** Open delay in ms */
     openDelay?: number;