@soyfri/shared-library 4.0.4 → 4.1.0

package/components/Modal/Modal.d.cts

@@ -0,0 +1,87 @@
+import { forwardRef, ReactNode } from 'react';
+import { SxProps, Theme } from '@mui/material/styles';
+import { DialogProps } from '@mui/material/Dialog';
+import { ModalFooter, ModalAction } from './ModalFooter';
+import { ModalHeader } from './ModalHeader';
+import { ModalBody } from './ModalBody';
+export interface ModalRef {
+    open: () => void;
+    close: () => void;
+}
+export type ModalMode = 'default' | 'confirm';
+export type ModalSeverity = 'info' | 'warning' | 'error' | 'success';
+export interface ModalProps {
+    /**
+     * Modo del modal.
+     * - `default` (default): modal genérico con slots `Header`/`Body`/`Footer` y
+     *   `actions` custom.
+     * - `confirm`: reemplaza al `ConfirmModal` legacy. Renderiza un layout
+     *   focalizado con icono por severidad, mensaje y botones "Cancelar" /
+     *   "Confirmar".
+     */
+    mode?: ModalMode;
+    /** Controlado externamente. Omitir si se usa vía ref. */
+    open?: boolean;
+    /** Callback al cerrar. También se dispara al confirmar/cancelar. */
+    onClose?: () => void;
+    title?: string;
+    children?: ReactNode;
+    showCloseButton?: boolean;
+    closeButtonText?: string;
+    closeButtonDisabled?: boolean;
+    actions?: ModalAction[];
+    maxWidth?: DialogProps['maxWidth'];
+    /**
+     * Si `true`, el modal NO se cierra al hacer click en el backdrop ni con Escape
+     * (equivale a `backdrop="static"`). Cerrar solo vía botón/acción.
+     */
+    staticBackdrop?: boolean;
+    /** Test id aplicado al Paper interno (contenedor visual). */
+    'data-testid'?: string;
+    /** Oculta el header (incluso si hay `title` o se pasa un `<Modal.Header>`). */
+    hiddenHeader?: boolean;
+    /** Oculta el body (incluso si se pasa un `<Modal.Body>`). */
+    hiddenBody?: boolean;
+    /** Oculta el footer (incluso si se pasa un `<Modal.Footer>` o `actions`). */
+    hiddenFooter?: boolean;
+    /** sx del Modal root (MuiModal). */
+    sx?: SxProps<Theme>;
+    /** sx del Paper interno (contenedor visual). Se mergea sobre el default. */
+    paperSx?: SxProps<Theme>;
+    /** className del Paper interno. */
+    className?: string;
+    /**
+     * Callback de confirmación. Soporta promesa — si devuelve `Promise`, el
+     * botón muestra estado `disabled` mientras resuelve.
+     *
+     * Si la promesa **rechaza**, el modal queda abierto para que el consumer
+     * pueda mostrar el error en su UI. El modal se cierra solo en éxito.
+     */
+    onConfirm?: () => void | Promise<void>;
+    /** Texto del botón primario en modo `confirm`. Default: "Confirmar". */
+    confirmText?: string;
+    /** Deshabilita el botón de confirmar. */
+    confirmDisabled?: boolean;
+    /**
+     * Severidad visual en modo `confirm`. Controla el icono y el color del
+     * botón de confirmación.
+     * - `info` (default): primary
+     * - `warning`: warning (amarillo)
+     * - `error`: error (rojo) — típico para "Eliminar"
+     * - `success`: success (verde) — típico para "Aprobar"
+     */
+    severity?: ModalSeverity;
+    /**
+     * Mensaje del confirm. Puede ser string o cualquier ReactNode. Si se omite,
+     * se usa `children`.
+     */
+    confirmMessage?: ReactNode;
+}
+export declare const Modal: import('react').ForwardRefExoticComponent<ModalProps & import('react').RefAttributes<ModalRef>>;
+type ModalComponent = ReturnType<typeof forwardRef<ModalRef, ModalProps>> & {
+    Header: typeof ModalHeader;
+    Body: typeof ModalBody;
+    Footer: typeof ModalFooter;
+};
+declare const ModalWithStatics: ModalComponent;
+export default ModalWithStatics;

package/components/Modal/Modal.d.mts

@@ -0,0 +1,87 @@
+import { forwardRef, ReactNode } from 'react';
+import { SxProps, Theme } from '@mui/material/styles';
+import { DialogProps } from '@mui/material/Dialog';
+import { ModalFooter, ModalAction } from './ModalFooter.mjs';
+import { ModalHeader } from './ModalHeader.mjs';
+import { ModalBody } from './ModalBody.mjs';
+export interface ModalRef {
+    open: () => void;
+    close: () => void;
+}
+export type ModalMode = 'default' | 'confirm';
+export type ModalSeverity = 'info' | 'warning' | 'error' | 'success';
+export interface ModalProps {
+    /**
+     * Modo del modal.
+     * - `default` (default): modal genérico con slots `Header`/`Body`/`Footer` y
+     *   `actions` custom.
+     * - `confirm`: reemplaza al `ConfirmModal` legacy. Renderiza un layout
+     *   focalizado con icono por severidad, mensaje y botones "Cancelar" /
+     *   "Confirmar".
+     */
+    mode?: ModalMode;
+    /** Controlado externamente. Omitir si se usa vía ref. */
+    open?: boolean;
+    /** Callback al cerrar. También se dispara al confirmar/cancelar. */
+    onClose?: () => void;
+    title?: string;
+    children?: ReactNode;
+    showCloseButton?: boolean;
+    closeButtonText?: string;
+    closeButtonDisabled?: boolean;
+    actions?: ModalAction[];
+    maxWidth?: DialogProps['maxWidth'];
+    /**
+     * Si `true`, el modal NO se cierra al hacer click en el backdrop ni con Escape
+     * (equivale a `backdrop="static"`). Cerrar solo vía botón/acción.
+     */
+    staticBackdrop?: boolean;
+    /** Test id aplicado al Paper interno (contenedor visual). */
+    'data-testid'?: string;
+    /** Oculta el header (incluso si hay `title` o se pasa un `<Modal.Header>`). */
+    hiddenHeader?: boolean;
+    /** Oculta el body (incluso si se pasa un `<Modal.Body>`). */
+    hiddenBody?: boolean;
+    /** Oculta el footer (incluso si se pasa un `<Modal.Footer>` o `actions`). */
+    hiddenFooter?: boolean;
+    /** sx del Modal root (MuiModal). */
+    sx?: SxProps<Theme>;
+    /** sx del Paper interno (contenedor visual). Se mergea sobre el default. */
+    paperSx?: SxProps<Theme>;
+    /** className del Paper interno. */
+    className?: string;
+    /**
+     * Callback de confirmación. Soporta promesa — si devuelve `Promise`, el
+     * botón muestra estado `disabled` mientras resuelve.
+     *
+     * Si la promesa **rechaza**, el modal queda abierto para que el consumer
+     * pueda mostrar el error en su UI. El modal se cierra solo en éxito.
+     */
+    onConfirm?: () => void | Promise<void>;
+    /** Texto del botón primario en modo `confirm`. Default: "Confirmar". */
+    confirmText?: string;
+    /** Deshabilita el botón de confirmar. */
+    confirmDisabled?: boolean;
+    /**
+     * Severidad visual en modo `confirm`. Controla el icono y el color del
+     * botón de confirmación.
+     * - `info` (default): primary
+     * - `warning`: warning (amarillo)
+     * - `error`: error (rojo) — típico para "Eliminar"
+     * - `success`: success (verde) — típico para "Aprobar"
+     */
+    severity?: ModalSeverity;
+    /**
+     * Mensaje del confirm. Puede ser string o cualquier ReactNode. Si se omite,
+     * se usa `children`.
+     */
+    confirmMessage?: ReactNode;
+}
+export declare const Modal: import('react').ForwardRefExoticComponent<ModalProps & import('react').RefAttributes<ModalRef>>;
+type ModalComponent = ReturnType<typeof forwardRef<ModalRef, ModalProps>> & {
+    Header: typeof ModalHeader;
+    Body: typeof ModalBody;
+    Footer: typeof ModalFooter;
+};
+declare const ModalWithStatics: ModalComponent;
+export default ModalWithStatics;

package/components/Modal/ModalBody.d.cts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+export interface ModalBodyProps {
+    children: React.ReactNode;
+    /**
+     * ID del elemento — usado para `aria-describedby` del Modal. Se setea
+     * automáticamente cuando el body se renderiza dentro de `<Modal>`.
+     */
+    id?: string;
+}
+export declare const ModalBody: React.FC<ModalBodyProps>;
+export default ModalBody;

package/components/Modal/ModalBody.d.mts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+export interface ModalBodyProps {
+    children: React.ReactNode;
+    /**
+     * ID del elemento — usado para `aria-describedby` del Modal. Se setea
+     * automáticamente cuando el body se renderiza dentro de `<Modal>`.
+     */
+    id?: string;
+}
+export declare const ModalBody: React.FC<ModalBodyProps>;
+export default ModalBody;

package/components/Modal/ModalFooter.d.cts

@@ -0,0 +1,27 @@
+import { default as React } from 'react';
+import { ButtonProps as MuiButtonProps } from '@mui/material/Button';
+export interface ModalAction {
+    text: string;
+    onClick?: () => void;
+    disabled?: boolean;
+    variant?: MuiButtonProps['variant'];
+    color?: MuiButtonProps['color'];
+    /**
+     * Props adicionales que se forwardean al `<Button>` interno. Útil para casos
+     * avanzados como conectar el botón con un `<form id="...">` externo usando
+     * `buttonProps={{ type: 'submit', form: 'my-form-id' }}`.
+     */
+    buttonProps?: Partial<MuiButtonProps> & {
+        form?: string;
+    };
+}
+export interface ModalFooterProps {
+    children?: React.ReactNode;
+    showCloseButton?: boolean;
+    closeButtonText?: string;
+    closeButtonDisabled?: boolean;
+    onClose: () => void;
+    actions?: ModalAction[];
+}
+export declare const ModalFooter: React.FC<ModalFooterProps>;
+export default ModalFooter;

package/components/Modal/ModalFooter.d.mts

@@ -0,0 +1,27 @@
+import { default as React } from 'react';
+import { ButtonProps as MuiButtonProps } from '@mui/material/Button';
+export interface ModalAction {
+    text: string;
+    onClick?: () => void;
+    disabled?: boolean;
+    variant?: MuiButtonProps['variant'];
+    color?: MuiButtonProps['color'];
+    /**
+     * Props adicionales que se forwardean al `<Button>` interno. Útil para casos
+     * avanzados como conectar el botón con un `<form id="...">` externo usando
+     * `buttonProps={{ type: 'submit', form: 'my-form-id' }}`.
+     */
+    buttonProps?: Partial<MuiButtonProps> & {
+        form?: string;
+    };
+}
+export interface ModalFooterProps {
+    children?: React.ReactNode;
+    showCloseButton?: boolean;
+    closeButtonText?: string;
+    closeButtonDisabled?: boolean;
+    onClose: () => void;
+    actions?: ModalAction[];
+}
+export declare const ModalFooter: React.FC<ModalFooterProps>;
+export default ModalFooter;

package/components/Modal/ModalHeader.d.cts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+export interface ModalHeaderProps {
+    children: React.ReactNode;
+    /**
+     * ID del elemento — usado para `aria-labelledby` del Modal. Se setea
+     * automáticamente cuando el header se renderiza dentro de `<Modal>`.
+     */
+    id?: string;
+}
+export declare const ModalHeader: React.FC<ModalHeaderProps>;
+export default ModalHeader;

package/components/Modal/ModalHeader.d.mts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+export interface ModalHeaderProps {
+    children: React.ReactNode;
+    /**
+     * ID del elemento — usado para `aria-labelledby` del Modal. Se setea
+     * automáticamente cuando el header se renderiza dentro de `<Modal>`.
+     */
+    id?: string;
+}
+export declare const ModalHeader: React.FC<ModalHeaderProps>;
+export default ModalHeader;

package/components/Modal/index.cjs

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
+const Modal = require("../../chunks/Modal-KRUDCrlp.cjs");
+exports.Modal = Modal.ModalWithStatics;
+exports.ModalBody = Modal.ModalBody;
+exports.ModalFooter = Modal.ModalFooter;
+exports.ModalHeader = Modal.ModalHeader;
+exports.default = Modal.ModalWithStatics;
+//# sourceMappingURL=index.cjs.map

package/components/Modal/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}

package/components/Modal/index.d.cts

@@ -0,0 +1,8 @@
+export { default, default as Modal } from './Modal';
+export type { ModalRef, ModalMode, ModalSeverity } from './Modal';
+export { ModalHeader } from './ModalHeader';
+export type { ModalHeaderProps } from './ModalHeader';
+export { ModalBody } from './ModalBody';
+export type { ModalBodyProps } from './ModalBody';
+export { ModalFooter } from './ModalFooter';
+export type { ModalAction, ModalFooterProps } from './ModalFooter';

package/components/Modal/index.d.mts

@@ -0,0 +1,8 @@
+export { default, default as Modal } from './Modal.mjs';
+export type { ModalRef, ModalMode, ModalSeverity } from './Modal.mjs';
+export { ModalHeader } from './ModalHeader.mjs';
+export type { ModalHeaderProps } from './ModalHeader.mjs';
+export { ModalBody } from './ModalBody.mjs';
+export type { ModalBodyProps } from './ModalBody.mjs';
+export { ModalFooter } from './ModalFooter.mjs';
+export type { ModalAction, ModalFooterProps } from './ModalFooter.mjs';

package/components/Modal/index.mjs

@@ -0,0 +1,9 @@
+import { M, b, c, a, M as M2 } from "../../chunks/Modal-E1V8hyFI.mjs";
+export {
+  M as Modal,
+  b as ModalBody,
+  c as ModalFooter,
+  a as ModalHeader,
+  M2 as default
+};
+//# sourceMappingURL=index.mjs.map

package/components/Modal/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/components/Modal.d.cts

@@ -0,0 +1,6 @@
+export * from './Modal/index'
+export {}
+import _default from './Modal/index'
+export default _default
+export * from './Modal/index'
+export {}

package/components/Modal.d.mts

@@ -0,0 +1,6 @@
+export * from './Modal/index.mjs'
+export {}
+import _default from './Modal/index.mjs'
+export default _default
+export * from './Modal/index.mjs'
+export {}

package/components/PageHeader/PageHeader.d.cts

@@ -0,0 +1,36 @@
+import { ReactNode } from 'react';
+import { BoxProps, TypographyProps } from '@mui/material';
+import { SxProps, Theme } from '@mui/material/styles';
+/** Nodos internos alcanzables vía `slotProps`. */
+export interface PageHeaderSlotProps {
+    /** El `Typography` del título (se renderiza como `h1`). */
+    title?: Partial<TypographyProps>;
+    /** El `Box` que agrupa migas + acciones a la derecha. */
+    aside?: Partial<BoxProps>;
+}
+export interface PageHeaderProps extends Omit<BoxProps, 'title' | 'children'> {
+    /** Título de la página. Se renderiza como `<h1>`. */
+    title: ReactNode;
+    /**
+     * Migas de pan ya armadas por el consumidor — normalmente un `<Breadcrumbs>`
+     * con los `Link` de su router. Es un slot a propósito: el paquete no depende
+     * de ninguna librería de routing.
+     */
+    breadcrumbs?: ReactNode;
+    /** Acciones a la derecha (botones, menús). */
+    actions?: ReactNode;
+    /**
+     * @deprecated Usar `theme.components.FriPageHeader.styleOverrides` /
+     * `variants` — la API nativa de MUI.
+     */
+    preset?: string;
+    /** Props para los nodos internos. `className` y `sx` se acumulan. */
+    slotProps?: PageHeaderSlotProps;
+    sx?: SxProps<Theme>;
+}
+/**
+ * Encabezado de página: título a la izquierda, migas + acciones a la derecha.
+ * En pantallas angostas envuelve en vez de comprimir el título.
+ */
+export declare const PageHeader: import('react').ForwardRefExoticComponent<Omit<PageHeaderProps, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+export default PageHeader;

package/components/PageHeader/PageHeader.d.mts

@@ -0,0 +1,36 @@
+import { ReactNode } from 'react';
+import { BoxProps, TypographyProps } from '@mui/material';
+import { SxProps, Theme } from '@mui/material/styles';
+/** Nodos internos alcanzables vía `slotProps`. */
+export interface PageHeaderSlotProps {
+    /** El `Typography` del título (se renderiza como `h1`). */
+    title?: Partial<TypographyProps>;
+    /** El `Box` que agrupa migas + acciones a la derecha. */
+    aside?: Partial<BoxProps>;
+}
+export interface PageHeaderProps extends Omit<BoxProps, 'title' | 'children'> {
+    /** Título de la página. Se renderiza como `<h1>`. */
+    title: ReactNode;
+    /**
+     * Migas de pan ya armadas por el consumidor — normalmente un `<Breadcrumbs>`
+     * con los `Link` de su router. Es un slot a propósito: el paquete no depende
+     * de ninguna librería de routing.
+     */
+    breadcrumbs?: ReactNode;
+    /** Acciones a la derecha (botones, menús). */
+    actions?: ReactNode;
+    /**
+     * @deprecated Usar `theme.components.FriPageHeader.styleOverrides` /
+     * `variants` — la API nativa de MUI.
+     */
+    preset?: string;
+    /** Props para los nodos internos. `className` y `sx` se acumulan. */
+    slotProps?: PageHeaderSlotProps;
+    sx?: SxProps<Theme>;
+}
+/**
+ * Encabezado de página: título a la izquierda, migas + acciones a la derecha.
+ * En pantallas angostas envuelve en vez de comprimir el título.
+ */
+export declare const PageHeader: import('react').ForwardRefExoticComponent<Omit<PageHeaderProps, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+export default PageHeader;

package/components/PageHeader/PageHeader.d.ts

@@ -1,6 +1,14 @@
 import { ReactNode } from 'react';
+import { BoxProps, TypographyProps } from '@mui/material';
 import { SxProps, Theme } from '@mui/material/styles';
-export interface PageHeaderProps {
+/** Nodos internos alcanzables vía `slotProps`. */
+export interface PageHeaderSlotProps {
+    /** El `Typography` del título (se renderiza como `h1`). */
+    title?: Partial<TypographyProps>;
+    /** El `Box` que agrupa migas + acciones a la derecha. */
+    aside?: Partial<BoxProps>;
+}
+export interface PageHeaderProps extends Omit<BoxProps, 'title' | 'children'> {
     /** Título de la página. Se renderiza como `<h1>`. */
     title: ReactNode;
     /**
@@ -11,15 +19,18 @@ export interface PageHeaderProps {
     breadcrumbs?: ReactNode;
     /** Acciones a la derecha (botones, menús). */
     actions?: ReactNode;
-    /** Preset registrado en `theme.styles.PageHeader`. */
+    /**
+     * @deprecated Usar `theme.components.FriPageHeader.styleOverrides` /
+     * `variants` — la API nativa de MUI.
+     */
     preset?: string;
+    /** Props para los nodos internos. `className` y `sx` se acumulan. */
+    slotProps?: PageHeaderSlotProps;
     sx?: SxProps<Theme>;
-    className?: string;
-    'data-testid'?: string;
 }
 /**
  * Encabezado de página: título a la izquierda, migas + acciones a la derecha.
  * En pantallas angostas envuelve en vez de comprimir el título.
  */
-export declare function PageHeader({ title, breadcrumbs, actions, preset, sx, className, 'data-testid': dataTestId, }: PageHeaderProps): import("react/jsx-runtime").JSX.Element;
+export declare const PageHeader: import('react').ForwardRefExoticComponent<Omit<PageHeaderProps, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
 export default PageHeader;

package/components/PageHeader/index.cjs

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
+const PageHeader = require("../../chunks/PageHeader-C5tVfSvH.cjs");
+exports.PageHeader = PageHeader.PageHeader;
+exports.default = PageHeader.PageHeader;
+//# sourceMappingURL=index.cjs.map

package/components/PageHeader/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}

package/components/PageHeader/index.d.cts

@@ -0,0 +1,2 @@
+export { PageHeader, default } from './PageHeader';
+export type { PageHeaderProps } from './PageHeader';

package/components/PageHeader/index.d.mts

@@ -0,0 +1,2 @@
+export { PageHeader, default } from './PageHeader.mjs';
+export type { PageHeaderProps } from './PageHeader.mjs';

package/components/PageHeader/index.mjs

@@ -0,0 +1,6 @@
+import { P, P as P2 } from "../../chunks/PageHeader-DAYz1_fF.mjs";
+export {
+  P as PageHeader,
+  P2 as default
+};
+//# sourceMappingURL=index.mjs.map

package/components/PageHeader/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/components/PageHeader.d.cts

@@ -0,0 +1,6 @@
+export * from './PageHeader/index'
+export {}
+import _default from './PageHeader/index'
+export default _default
+export * from './PageHeader/index'
+export {}

package/components/PageHeader.d.mts

@@ -0,0 +1,6 @@
+export * from './PageHeader/index.mjs'
+export {}
+import _default from './PageHeader/index.mjs'
+export default _default
+export * from './PageHeader/index.mjs'
+export {}

package/components/RadioGroup/RadioGroup.d.cts

@@ -0,0 +1,58 @@
+import { RadioGroupProps as MuiRadioGroupProps, SxProps, Theme } from '@mui/material';
+import { RegisterOptions } from 'react-hook-form';
+export interface RadioOption {
+    /** Valor que se emite cuando se selecciona la opción. */
+    value: string;
+    /** Texto mostrado al lado del radio. */
+    label: string;
+    /** Deshabilitar opción individualmente. */
+    disabled?: boolean;
+    /** ID custom del input (default: prefijo + value). */
+    id?: string;
+}
+export type RadioGroupSize = 'small' | 'medium';
+export interface BaseRadioGroupProps extends Omit<MuiRadioGroupProps, 'value' | 'onChange' | 'defaultValue'> {
+    options: RadioOption[];
+    /** Label superior del grupo. */
+    label?: string;
+    /** Distribución horizontal (default: true — replica el comportamiento legacy). */
+    row?: boolean;
+    size?: RadioGroupSize;
+    disabled?: boolean;
+    error?: boolean;
+    helperText?: string;
+    /** Renderiza un contenedor con borde estilo "form field". Default: true. */
+    bordered?: boolean;
+    /** Border radius del contenedor (cuando bordered). Default: 10. */
+    borderRadius?: number | string;
+    defaultValue?: string;
+    /**
+     * Nombre del preset de estilo registrado en `theme.styles.RadioGroup`.
+     * - `"default"` (o ausente) = estilo built-in del paquete.
+     * - Cualquier otro string = mergea el preset encima del estilo built-in.
+     */
+    preset?: string;
+    sx?: SxProps<Theme>;
+}
+export interface RHFRadioGroupProps extends BaseRadioGroupProps {
+    name: string;
+    control: any;
+    validation?: RegisterOptions;
+    /**
+     * Side-effect que corre después de que RHF actualiza el form state.
+     * Útil para cascadas entre campos. NO reemplaza al handler de RHF.
+     */
+    onValueChange?: (value: string) => void;
+    value?: never;
+    onChange?: never;
+}
+export interface ControlledRadioGroupProps extends BaseRadioGroupProps {
+    name?: string;
+    control?: never;
+    validation?: never;
+    value: string;
+    onChange: (value: string) => void;
+}
+export type RadioGroupProps = RHFRadioGroupProps | ControlledRadioGroupProps;
+export declare const RadioGroup: import('react').ForwardRefExoticComponent<(Omit<RHFRadioGroupProps, "ref"> | Omit<ControlledRadioGroupProps, "ref">) & import('react').RefAttributes<HTMLDivElement>>;
+export default RadioGroup;

package/components/RadioGroup/RadioGroup.d.mts

@@ -0,0 +1,58 @@
+import { RadioGroupProps as MuiRadioGroupProps, SxProps, Theme } from '@mui/material';
+import { RegisterOptions } from 'react-hook-form';
+export interface RadioOption {
+    /** Valor que se emite cuando se selecciona la opción. */
+    value: string;
+    /** Texto mostrado al lado del radio. */
+    label: string;
+    /** Deshabilitar opción individualmente. */
+    disabled?: boolean;
+    /** ID custom del input (default: prefijo + value). */
+    id?: string;
+}
+export type RadioGroupSize = 'small' | 'medium';
+export interface BaseRadioGroupProps extends Omit<MuiRadioGroupProps, 'value' | 'onChange' | 'defaultValue'> {
+    options: RadioOption[];
+    /** Label superior del grupo. */
+    label?: string;
+    /** Distribución horizontal (default: true — replica el comportamiento legacy). */
+    row?: boolean;
+    size?: RadioGroupSize;
+    disabled?: boolean;
+    error?: boolean;
+    helperText?: string;
+    /** Renderiza un contenedor con borde estilo "form field". Default: true. */
+    bordered?: boolean;
+    /** Border radius del contenedor (cuando bordered). Default: 10. */
+    borderRadius?: number | string;
+    defaultValue?: string;
+    /**
+     * Nombre del preset de estilo registrado en `theme.styles.RadioGroup`.
+     * - `"default"` (o ausente) = estilo built-in del paquete.
+     * - Cualquier otro string = mergea el preset encima del estilo built-in.
+     */
+    preset?: string;
+    sx?: SxProps<Theme>;
+}
+export interface RHFRadioGroupProps extends BaseRadioGroupProps {
+    name: string;
+    control: any;
+    validation?: RegisterOptions;
+    /**
+     * Side-effect que corre después de que RHF actualiza el form state.
+     * Útil para cascadas entre campos. NO reemplaza al handler de RHF.
+     */
+    onValueChange?: (value: string) => void;
+    value?: never;
+    onChange?: never;
+}
+export interface ControlledRadioGroupProps extends BaseRadioGroupProps {
+    name?: string;
+    control?: never;
+    validation?: never;
+    value: string;
+    onChange: (value: string) => void;
+}
+export type RadioGroupProps = RHFRadioGroupProps | ControlledRadioGroupProps;
+export declare const RadioGroup: import('react').ForwardRefExoticComponent<(Omit<RHFRadioGroupProps, "ref"> | Omit<ControlledRadioGroupProps, "ref">) & import('react').RefAttributes<HTMLDivElement>>;
+export default RadioGroup;

package/components/RadioGroup/RadioGroup.d.ts

@@ -1,4 +1,3 @@
-import { FC } from 'react';
 import { RadioGroupProps as MuiRadioGroupProps, SxProps, Theme } from '@mui/material';
 import { RegisterOptions } from 'react-hook-form';
 export interface RadioOption {
@@ -55,5 +54,5 @@ export interface ControlledRadioGroupProps extends BaseRadioGroupProps {
     onChange: (value: string) => void;
 }
 export type RadioGroupProps = RHFRadioGroupProps | ControlledRadioGroupProps;
-export declare const RadioGroup: FC<RadioGroupProps>;
+export declare const RadioGroup: import('react').ForwardRefExoticComponent<(Omit<RHFRadioGroupProps, "ref"> | Omit<ControlledRadioGroupProps, "ref">) & import('react').RefAttributes<HTMLDivElement>>;
 export default RadioGroup;