@via-profit/ui-kit 0.2.6 → 0.4.0

package/Popper/usePopper.d.ts

@@ -2,9 +2,8 @@ import React from 'react';
 import { PositionStrategy } from './PopperContainer';
 /**
  * Base directions for popper positioning.
- * These are the primary axes around which the popper can be placed.
+ * The popper is centered along the chosen side of the anchor.
  *
- * @default 'bottom' (when used as anchorPos)
  * @example
  * ```tsx
  * type Direction = 'top' | 'bottom' | 'left' | 'right';
@@ -12,38 +11,31 @@ import { PositionStrategy } from './PopperContainer';
  */
 export type Direction = 'top' | 'left' | 'right' | 'bottom';
 /**
- * Auto placement modifiers that enable intelligent positioning.
- * The popper will automatically choose the best placement that fits in the viewport.
- * - `auto`: Dynamically selects the optimal direction
- * - `auto-top`, `auto-bottom`, `auto-left`, `auto-right`: Auto placement with priority given to the specified direction
+ * Auto placements. With `autoFlip` the popper picks the first placement that fits in the viewport.
+ * - `auto`: Tries all placements starting with the bottom ones
+ * - `auto-top`, `auto-bottom`, `auto-left`, `auto-right`: Tries all placements starting with the specified side
+ *
+ * Without `autoFlip` `auto` works as `bottom`, `auto-top` as `top` and so on.
  *
  * @example
  * ```tsx
  * // Will try to place on top first, but will flip if needed
- * <Popper anchorPos="auto-top">...</Popper>
- *
- * // Will try all directions equally
- * <Popper anchorPos="auto">...</Popper>
+ * <Popper anchorPos="auto-top" autoFlip>...</Popper>
  * ```
  */
 export type AutoModifier = 'auto' | 'auto-top' | 'auto-bottom' | 'auto-left' | 'auto-right';
 /**
- * Precise placement modifiers for fine-tuned positioning.
- * These combine a base direction with specific alignment options:
- * - `start`/`end`: Aligns to the beginning or end of the anchor (useful for RTL layouts)
- * - `left`/`right`: Horizontal alignment for vertical placements
- * - `top`/`bottom`: Vertical alignment for horizontal placements
+ * Placements that combine a side with an alignment along it:
+ * - `start`/`end`: Aligns to the left/right edge of the anchor (text direction is not taken into account)
+ * - `left`/`right`: Same as `start`/`end`
+ * - `top`/`bottom`: Vertical alignment for the left and right sides
+ * - `fill`: Stretches the popper to the anchor width
  *
  * @example
  * ```tsx
- * // Corner placements
- * <Popper anchorPos="top-left">Aligns to top-left corner</Popper>
- *
- * // Logical placements (RTL-friendly)
- * <Popper anchorPos="bottom-start">Aligns to bottom edge, start side</Popper>
- *
- * // Side alignments
- * <Popper anchorPos="left-top">Aligns to left side, top edge</Popper>
+ * <Popper anchorPos="bottom-start">Below the anchor, aligned to its left edge</Popper>
+ * <Popper anchorPos="left-top">Left of the anchor, aligned to its top edge</Popper>
+ * <Popper anchorPos="bottom-fill">Below the anchor, as wide as the anchor</Popper>
  * ```
  */
 export type Modifier = 'top-start' | 'top-end' | 'top-left' | 'top-right' | 'bottom-end' | 'bottom-start' | 'bottom-right' | 'bottom-left' | 'left-top' | 'left-bottom' | 'right-top' | 'right-bottom' | 'bottom-fill' | 'top-fill';
@@ -54,12 +46,13 @@ export type Modifier = 'top-start' | 'top-end' | 'top-left' | 'top-right' | 'bot
  *
  * Categories:
  * - **Basic directions**: `top`, `bottom`, `left`, `right` - Centered placement
- * - **Corner placements**: `top-left`, `top-right`, `bottom-left`, `bottom-right` - Aligned to corners
- * - **Logical placements**: `top-start`, `top-end`, `bottom-start`, `bottom-end` - RTL-aware alignment
+ * - **Edge placements**: `top-start`, `top-end`, `bottom-start`, `bottom-end`
+ *   and their aliases `top-left`, `top-right`, `bottom-left`, `bottom-right`
  * - **Side alignments**: `left-top`, `left-bottom`, `right-top`, `right-bottom` - Edge-aligned
- * - **Auto placements**: `auto`, `auto-top`, `auto-bottom`, `auto-left`, `auto-right` - Intelligent positioning
+ * - **Fill placements**: `top-fill`, `bottom-fill` - As wide as the anchor
+ * - **Auto placements**: `auto`, `auto-top`, `auto-bottom`, `auto-left`, `auto-right` - Picked by `autoFlip`
  *
- * @default 'bottom'
+ * @default 'auto'
  * @example
  * ```tsx
  * // Basic centered placement
@@ -69,10 +62,7 @@ export type Modifier = 'top-start' | 'top-end' | 'top-left' | 'top-right' | 'bot
  * <Popper anchorPos="top-right">Attached to top-right corner</Popper>
  *
  * // Auto placement with priority
- * <Popper anchorPos="auto-left">Try left first, then find best fit</Popper>
- *
- * // RTL-aware placement
- * <Popper anchorPos="top-start">Respects text direction</Popper>
+ * <Popper anchorPos="auto-left" autoFlip>Try left first, then find best fit</Popper>
  * ```
  */
 export type AnchorPos = Direction | Modifier | AutoModifier;

package/Popper/usePopper.js

@@ -44,10 +44,9 @@ const findScrollableAncestor = (element, includeHidden = false) => {
     return window;
 };
 exports.findScrollableAncestor = findScrollableAncestor;
+const useIsomorphicLayoutEffect = typeof window !== 'undefined' ? react_1.default.useLayoutEffect : react_1.default.useEffect;
 const usePopper = (props) => {
     const { anchorElement, anchorPos = 'auto', positionStrategy = 'fixed', autoFlip = false, offset = 0, viewportMargin = 10, isOpen = false, alternativePlacements, } = props;
-    const isMountedRef = react_1.default.useRef(false);
-    const isPositioningRef = react_1.default.useRef(false);
     const [actualPlacement, setActualPlacement] = react_1.default.useState(anchorPos);
     const [style, setStyle] = react_1.default.useState(null);
     const [isVisible, setIsVisible] = react_1.default.useState(false);
@@ -59,12 +58,15 @@ const usePopper = (props) => {
         }
         return (0, exports.findScrollableAncestor)(anchorElement);
     }, [anchorElement]);
-    // Synchronizing actualPlacement with anchorPos
+    // Reset actualPlacement only when the preferred placement itself changes.
+    // Comparing with actualPlacement here would immediately revert every flip.
+    const prevAnchorPosRef = react_1.default.useRef(anchorPos);
     react_1.default.useEffect(() => {
-        if (actualPlacement !== anchorPos) {
+        if (prevAnchorPosRef.current !== anchorPos) {
+            prevAnchorPosRef.current = anchorPos;
             setActualPlacement(anchorPos);
         }
-    }, [actualPlacement, anchorPos]);
+    }, [anchorPos]);
     const getPositionStyle = react_1.default.useCallback((props) => {
         var _a;
         const { place, anchorRect, popperRect, forViewportCheck = false } = props;
@@ -383,25 +385,56 @@ const usePopper = (props) => {
         }
         const anchorRect = anchorElement.getBoundingClientRect();
         const popperRect = popperRef.current.getBoundingClientRect();
-        const { style, placement, found } = getPreferredPlacements(anchorPos, anchorRect, popperRect);
-        if (found) {
-            setActualPlacement(placement);
-        }
+        const { style, placement } = getPreferredPlacements(anchorPos, anchorRect, popperRect);
+        setActualPlacement(placement);
         setStyle(style);
     }, [anchorElement, anchorPos, getPreferredPlacements]);
+    const frameRef = react_1.default.useRef(null);
+    const scheduleUpdate = react_1.default.useCallback(() => {
+        if (frameRef.current !== null) {
+            return;
+        }
+        frameRef.current = window.requestAnimationFrame(() => {
+            frameRef.current = null;
+            calculatePosition();
+        });
+    }, [calculatePosition]);
+    // Cancel the pending frame on unmount
+    react_1.default.useEffect(() => () => {
+        if (frameRef.current !== null) {
+            window.cancelAnimationFrame(frameRef.current);
+            frameRef.current = null;
+        }
+    }, []);
     /**
-     * Open / Close popper logic
+     * Close popper logic
      */
     react_1.default.useEffect(() => {
         if (!isOpen) {
             setIsVisible(false);
             setStyle(null);
         }
-        else if (anchorElement && isOpen && popperRef.current) {
+    }, [isOpen]);
+    /**
+     * Open popper logic.
+     * Runs after every render because the popper node can appear later than `isOpen`
+     * becomes true (e.g. the portal is rendered only after the client mount)
+     */
+    useIsomorphicLayoutEffect(() => {
+        if (isOpen && !isVisible && anchorElement && popperRef.current) {
             calculatePosition();
             setIsVisible(true);
         }
-    }, [anchorElement, getPreferredPlacements, isOpen, calculatePosition]);
+    });
+    /**
+     * Recalculate position when the positioning params are changed
+     */
+    react_1.default.useEffect(() => {
+        if (isOpen && isVisible) {
+            calculatePosition();
+        }
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [calculatePosition]);
     /**
      * The anchor element changes
      */
@@ -409,12 +442,7 @@ const usePopper = (props) => {
         if (!isOpen || !anchorElement) {
             return;
         }
-        const observer = new MutationObserver(() => {
-            window.requestAnimationFrame(() => {
-                // console.log('The anchor element was change');
-                calculatePosition();
-            });
-        });
+        const observer = new MutationObserver(scheduleUpdate);
         observer.observe(anchorElement, {
             attributes: true,
             childList: true,
@@ -424,36 +452,47 @@ const usePopper = (props) => {
         return () => {
             observer.disconnect();
         };
-    }, [isOpen, anchorElement, calculatePosition]);
+    }, [isOpen, anchorElement, scheduleUpdate]);
     /**
-     * On scroll - recalculate position
+     * The size of the anchor or popper changes
      */
     react_1.default.useEffect(() => {
-        if (!isOpen || !scrollableAncestor) {
+        if (!isOpen || !isVisible || typeof ResizeObserver === 'undefined') {
             return;
         }
-        const handleScroll = () => {
-            window.requestAnimationFrame(() => {
-                calculatePosition();
-            });
-        };
-        // parent scroll listener
-        if (scrollableAncestor instanceof HTMLElement) {
-            scrollableAncestor.addEventListener('scroll', handleScroll, { passive: true });
+        const observer = new ResizeObserver(scheduleUpdate);
+        if (anchorElement) {
+            observer.observe(anchorElement);
         }
-        else if (scrollableAncestor === window) {
-            window.addEventListener('scroll', handleScroll, { passive: true });
+        if (popperRef.current) {
+            observer.observe(popperRef.current);
         }
         // eslint-disable-next-line consistent-return
         return () => {
-            if (scrollableAncestor instanceof HTMLElement) {
-                scrollableAncestor.removeEventListener('scroll', handleScroll);
-            }
-            else if (scrollableAncestor === window) {
-                window.removeEventListener('scroll', handleScroll);
+            observer.disconnect();
+        };
+    }, [isOpen, isVisible, anchorElement, scheduleUpdate]);
+    /**
+     * On scroll of any ancestor (captured on window) - recalculate position
+     */
+    react_1.default.useEffect(() => {
+        if (!isOpen) {
+            return;
+        }
+        const handleScroll = (event) => {
+            var _a;
+            // Scrolling inside the popper does not move it
+            if (event.target instanceof Node && ((_a = popperRef.current) === null || _a === void 0 ? void 0 : _a.contains(event.target))) {
+                return;
             }
+            scheduleUpdate();
+        };
+        window.addEventListener('scroll', handleScroll, { passive: true, capture: true });
+        // eslint-disable-next-line consistent-return
+        return () => {
+            window.removeEventListener('scroll', handleScroll, { capture: true });
         };
-    }, [isOpen, scrollableAncestor, calculatePosition]);
+    }, [isOpen, scheduleUpdate]);
     /**
      * On window resize - recalculate position
      */
@@ -461,18 +500,12 @@ const usePopper = (props) => {
         if (!isOpen) {
             return;
         }
-        const handleResize = () => {
-            window.requestAnimationFrame(() => {
-                calculatePosition();
-            });
-        };
-        // parent scroll listener
-        window.addEventListener('resize', handleResize);
+        window.addEventListener('resize', scheduleUpdate);
         // eslint-disable-next-line consistent-return
         return () => {
-            window.removeEventListener('resize', handleResize);
+            window.removeEventListener('resize', scheduleUpdate);
         };
-    }, [calculatePosition, isOpen]);
+    }, [scheduleUpdate, isOpen]);
     return {
         actualPlacement,
         style,

package/README.md

@@ -1,17 +1,34 @@
-## Установка.
+# @via-profit/ui-kit
 
-Для работы требуются следующие модули:
-
-- react
-- react-dom
-- @emotion/styled - CSS In JS
-- @emotion/react - CSS In JS React
-- react-popper - Выпадающие меню
+Набор React-компонентов для интерфейсов: поля ввода, кнопки, календарь, меню, модальные окна и другие. Компоненты оформлены по теме, которую вы задаёте один раз для всего приложения.
 
+## Установка
 
 ```bash
-$ npm install @emotion/react @emotion/styled react react-dom react-popper
+npm install @via-profit/ui-kit @emotion/react @emotion/styled react react-dom
+```
+
+Пакету нужны `react` и `react-dom` версии 18.2 и новее, `@emotion/react` и `@emotion/styled` версии 11.10.6 и новее.
+
+## Быстрый старт
 
+```tsx
+import React from 'react';
+import { createRoot } from 'react-dom/client';
+import ThemeProvider, { createTheme } from '@via-profit/ui-kit/ThemeProvider';
+import Button from '@via-profit/ui-kit/Button';
+
+const theme = createTheme();
+
+createRoot(document.getElementById('app')!).render(
+  <ThemeProvider theme={theme}>
+    <Button color="primary">Привет</Button>
+  </ThemeProvider>,
+);
 ```
 
-## Документация [здесь](./docs/README.md)
+## Документация
+
+[Документация](https://github.com/via-profit/ui-kit/blob/master/packages/ui-kit/docs/README.md) — установка, тема оформления, общие принципы и описание всех компонентов.
+
+[Список изменений](./CHANGELOG.md)

package/Radio/RadioBox.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+export type RadioBoxProps = Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type'> & {
+    /**
+     * Paints the border with the error color
+     */
+    readonly error?: boolean;
+};
+declare const _default: React.ForwardRefExoticComponent<Omit<React.InputHTMLAttributes<HTMLInputElement>, "type"> & {
+    /**
+     * Paints the border with the error color
+     */
+    readonly error?: boolean | undefined;
+} & React.RefAttributes<HTMLInputElement>>;
+export default _default;

package/Radio/RadioBox.js

@@ -0,0 +1,100 @@
+"use strict";
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = __importDefault(require("react"));
+const styled_1 = __importDefault(require("@emotion/styled"));
+const react_2 = require("@emotion/react");
+const useRadioColor_1 = __importDefault(require("./useRadioColor"));
+const Root = styled_1.default.span `
+  position: relative;
+  display: inline-flex;
+  flex-shrink: 0;
+  width: 1.15em;
+  height: 1.15em;
+`;
+/**
+ * The checked look comes from the `:checked` state of the input, not from the props:
+ * the browser unchecks the other radio buttons of the same `name` itself
+ * (data attributes, not class names: emotion labels are absent in the published package)
+ */
+const StyledInput = styled_1.default.input `
+  position: absolute;
+  inset: 0;
+  width: 100%;
+  height: 100%;
+  margin: 0;
+  padding: 0;
+  opacity: 0;
+  cursor: inherit;
+  z-index: 1;
+
+  &:checked + [data-radio-circle] {
+    border-color: ${({ theme, $color, $error }) => $error ? theme.color.error.toString() : $color.toString()};
+  }
+
+  &:checked + [data-radio-circle] [data-radio-dot] {
+    transform: scale(1);
+  }
+
+  &:focus-visible + [data-radio-circle] {
+    outline: 0.14em solid ${({ theme }) => theme.color.accentPrimary.toString()};
+    outline-offset: 0.14em;
+  }
+`;
+const Circle = styled_1.default.span `
+  box-sizing: border-box;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 100%;
+  height: 100%;
+  border-radius: 50%;
+  border-width: 0.1em;
+  border-style: solid;
+  background-color: ${({ theme }) => theme.color.surface.toString()};
+  transition: border-color 150ms ease-out;
+  border-color: ${({ theme, $error }) => $error ? theme.color.error.toString() : theme.color.textPrimary.alpha(0.4).toString()};
+
+  ${({ $disabled, $error, $color }) => !$disabled &&
+    !$error &&
+    (0, react_2.css) `
+      label:hover & {
+        border-color: ${$color.toString()};
+      }
+    `}
+`;
+const Dot = styled_1.default.span `
+  width: 50%;
+  height: 50%;
+  border-radius: 50%;
+  background-color: ${({ $color }) => $color.toString()};
+  transform: scale(0);
+  transition: transform 150ms ease-out;
+`;
+/**
+ * The circle with the native input over it.
+ * The ref and the input attributes go to the input: it is the element that holds the value and the focus.
+ * `className` and `style` go to the root element, so `styled(RadioBox)` styles the circle
+ */
+const RadioBox = (props, ref) => {
+    const { error, color, disabled, className, style } = props, nativeProps = __rest(props, ["error", "color", "disabled", "className", "style"]);
+    const $color = (0, useRadioColor_1.default)(color);
+    return (react_1.default.createElement(Root, { className: className, style: style },
+        react_1.default.createElement(StyledInput, Object.assign({}, nativeProps, { type: "radio", disabled: disabled, "$color": $color, "$error": Boolean(error), ref: ref })),
+        react_1.default.createElement(Circle, { "data-radio-circle": "", "$color": $color, "$error": Boolean(error), "$disabled": Boolean(disabled) },
+            react_1.default.createElement(Dot, { "data-radio-dot": "", "$color": $color }))));
+};
+exports.default = react_1.default.forwardRef(RadioBox);

package/Radio/RadioContainer.d.ts

@@ -0,0 +1,27 @@
+import React from 'react';
+export type RadioLabelPosition = 'start' | 'end' | 'top' | 'bottom';
+export type RadioContainerProps = React.LabelHTMLAttributes<HTMLLabelElement> & {
+    /**
+     * Position of the label relative to the radio button
+     * Default: `end`
+     */
+    readonly labelPosition?: RadioLabelPosition;
+    /**
+     * If `true` the radio button state can not be changed
+     * Default: false;
+     */
+    readonly disabled?: boolean;
+};
+declare const _default: React.ForwardRefExoticComponent<React.LabelHTMLAttributes<HTMLLabelElement> & {
+    /**
+     * Position of the label relative to the radio button
+     * Default: `end`
+     */
+    readonly labelPosition?: RadioLabelPosition | undefined;
+    /**
+     * If `true` the radio button state can not be changed
+     * Default: false;
+     */
+    readonly disabled?: boolean | undefined;
+} & React.RefAttributes<HTMLLabelElement>>;
+export default _default;

package/Radio/RadioContainer.js

@@ -0,0 +1,38 @@
+"use strict";
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = __importDefault(require("react"));
+const styled_1 = __importDefault(require("@emotion/styled"));
+const directions = {
+    start: 'row-reverse',
+    end: 'row',
+    top: 'column-reverse',
+    bottom: 'column',
+};
+const StyledContainer = styled_1.default.label `
+  cursor: ${({ $disabled }) => ($disabled ? 'default' : 'pointer')};
+  font-size: 1em;
+  display: inline-flex;
+  align-items: center;
+  gap: 0.5em;
+  opacity: ${({ $disabled }) => ($disabled ? 0.6 : 1)};
+  flex-direction: ${({ $labelPosition }) => directions[$labelPosition || 'end']};
+`;
+const RadioContainer = (props, ref) => {
+    const { children, labelPosition, disabled } = props, nativeProps = __rest(props, ["children", "labelPosition", "disabled"]);
+    return (react_1.default.createElement(StyledContainer, Object.assign({}, nativeProps, { "$labelPosition": labelPosition, "$disabled": disabled, ref: ref }), children));
+};
+exports.default = react_1.default.forwardRef(RadioContainer);

package/Radio/RadioTextWrapper.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+export type RadioTextWrapperProps = React.HTMLAttributes<HTMLSpanElement>;
+declare const _default: React.ForwardRefExoticComponent<RadioTextWrapperProps & React.RefAttributes<HTMLSpanElement>>;
+export default _default;

package/Radio/RadioTextWrapper.js

@@ -0,0 +1,29 @@
+"use strict";
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = __importDefault(require("react"));
+const styled_1 = __importDefault(require("@emotion/styled"));
+const TextWrapper = styled_1.default.span `
+  font-size: 0.86em;
+  display: flex;
+  align-items: center;
+  user-select: none;
+`;
+const RadioTextWrapper = (props, ref) => {
+    const { children } = props, nativeProps = __rest(props, ["children"]);
+    return (react_1.default.createElement(TextWrapper, Object.assign({}, nativeProps, { ref: ref }), children));
+};
+exports.default = react_1.default.forwardRef(RadioTextWrapper);

package/Radio/index.d.ts

@@ -0,0 +1,64 @@
+import React from 'react';
+import { RadioContainerProps, RadioLabelPosition } from './RadioContainer';
+import { RadioBoxProps } from './RadioBox';
+import { RadioTextWrapperProps } from './RadioTextWrapper';
+export type { RadioLabelPosition };
+export type RadioProps = Omit<RadioBoxProps, 'color' | 'error'> & {
+    /**
+     * The value of the radio button. Inside `<RadioGroup>` it is required:
+     * the group compares it with its own value
+     */
+    readonly value?: string;
+    /**
+     * You can pass the primary, default, secondary name of the colors or your specified color value\
+     * **Default:** `default`, inside `<RadioGroup>` — the color of the group
+     */
+    readonly color?: 'default' | 'primary' | 'secondary' | string;
+    /**
+     * Position of the label relative to the radio button\
+     * **Default:** `end`
+     */
+    readonly labelPosition?: RadioLabelPosition;
+    /**
+     * Paints the circle with the error color. Inside `<RadioGroup>` it comes from the group
+     */
+    readonly error?: boolean;
+    readonly overrides?: RadioOverrides;
+};
+export interface RadioOverrides {
+    /**
+     * The label element with the radio button and the text
+     */
+    readonly Container?: React.ComponentType<RadioContainerProps & React.RefAttributes<HTMLLabelElement>>;
+    /**
+     * The circle with the native input
+     */
+    readonly Box?: React.ComponentType<RadioBoxProps & React.RefAttributes<HTMLInputElement>>;
+    /**
+     * The text wrapper
+     */
+    readonly TextWrapper?: React.ComponentType<RadioTextWrapperProps & React.RefAttributes<HTMLSpanElement>>;
+}
+declare const _default: React.ForwardRefExoticComponent<Omit<RadioBoxProps, "color" | "error"> & {
+    /**
+     * The value of the radio button. Inside `<RadioGroup>` it is required:
+     * the group compares it with its own value
+     */
+    readonly value?: string | undefined;
+    /**
+     * You can pass the primary, default, secondary name of the colors or your specified color value\
+     * **Default:** `default`, inside `<RadioGroup>` — the color of the group
+     */
+    readonly color?: string | undefined;
+    /**
+     * Position of the label relative to the radio button\
+     * **Default:** `end`
+     */
+    readonly labelPosition?: RadioLabelPosition | undefined;
+    /**
+     * Paints the circle with the error color. Inside `<RadioGroup>` it comes from the group
+     */
+    readonly error?: boolean | undefined;
+    readonly overrides?: RadioOverrides | undefined;
+} & React.RefAttributes<HTMLInputElement>>;
+export default _default;