@soyfri/shared-library 4.0.2 → 4.1.0

package/components/Button/Button.d.ts

@@ -1,22 +1,17 @@
-import { SxProps, Theme } from '@mui/material/styles';
-import { default as React } from 'react';
-export interface ButtonProps {
-    children?: React.ReactNode;
-    variant?: "text" | "outlined" | "contained";
-    disabled?: boolean;
-    endIcon?: React.ReactNode;
-    startIcon?: React.ReactNode;
-    size?: "small" | "medium" | "large";
-    className?: string;
-    onClick?: (event: React.MouseEvent<HTMLButtonElement>) => void;
-    loading?: boolean;
-    loadingIndicator?: React.ReactNode;
-    loadingPosition?: "start" | "end" | "center";
-    color?: "inherit" | "primary" | "secondary" | "success" | "error" | "info" | "warning";
-    href?: string;
-    "data-testid"?: string;
-    type?: "button" | "submit";
-    sx?: SxProps<Theme>;
-}
-export declare const Button: React.FC<ButtonProps>;
+import { ButtonProps as MuiButtonProps } from '@mui/material';
+/**
+ * Props del Button: las de MUI, tal cual.
+ *
+ * Antes esto era una lista cerrada escrita a mano, así que todo lo que no
+ * estuviera enumerado (`fullWidth`, `id`, `form`, `name`, `tabIndex`, `aria-*`,
+ * `onFocus`/`onBlur`, `component`…) no se podía pasar y obligaba al consumidor
+ * a importar `@mui/material` directo — justo lo que la librería intenta evitar.
+ */
+export type ButtonProps = MuiButtonProps;
+/**
+ * Button del design system. Wrapper fino sobre MUI: sin ripple, sin elevación y
+ * sin `text-transform`. Esos tres defaults van antes del spread de props, así
+ * que un consumidor puede pisarlos si de verdad los necesita.
+ */
+export declare const Button: import('react').ForwardRefExoticComponent<Omit<ButtonProps, "ref"> & import('react').RefAttributes<HTMLButtonElement>>;
 export default Button;

package/components/Button/index.cjs

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const Button = require("../../chunks/Button-BCNhPNKU.cjs");
+exports.Button = Button.Button;
+//# sourceMappingURL=index.cjs.map

package/components/Button/index.cjs.map

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

package/components/Button/index.d.cts

@@ -0,0 +1,2 @@
+export { default as Button } from './Button';
+export type { ButtonProps } from './Button';

package/components/Button/index.d.mts

@@ -0,0 +1,2 @@
+export { default as Button } from './Button.mjs';
+export type { ButtonProps } from './Button.mjs';

package/components/Button/index.mjs

@@ -0,0 +1,5 @@
+import { B } from "../../chunks/Button-DbqDgTAR.mjs";
+export {
+  B as Button
+};
+//# sourceMappingURL=index.mjs.map

package/components/Button/index.mjs.map

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

package/components/Button.d.cts

@@ -0,0 +1,2 @@
+export * from './Button/index'
+export {}

package/components/Button.d.mts

@@ -0,0 +1,2 @@
+export * from './Button/index.mjs'
+export {}

package/components/ButtonGroup/ButtonGroup.d.cts

@@ -0,0 +1,9 @@
+import { ReactNode } from 'react';
+import { ButtonGroupProps as MuiButtonGroupProps } from '@mui/material';
+export interface ButtonGroupProps extends MuiButtonGroupProps {
+    /** Botones agrupados. */
+    children?: ReactNode;
+}
+/** Grupo de botones segmentado. Wrapper fino sobre MUI `ButtonGroup`. */
+export declare const ButtonGroup: import('react').ForwardRefExoticComponent<Omit<ButtonGroupProps, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+export default ButtonGroup;

package/components/ButtonGroup/ButtonGroup.d.mts

@@ -0,0 +1,9 @@
+import { ReactNode } from 'react';
+import { ButtonGroupProps as MuiButtonGroupProps } from '@mui/material';
+export interface ButtonGroupProps extends MuiButtonGroupProps {
+    /** Botones agrupados. */
+    children?: ReactNode;
+}
+/** Grupo de botones segmentado. Wrapper fino sobre MUI `ButtonGroup`. */
+export declare const ButtonGroup: import('react').ForwardRefExoticComponent<Omit<ButtonGroupProps, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+export default ButtonGroup;

package/components/ButtonGroup/ButtonGroup.d.ts

@@ -1,18 +1,9 @@
 import { ReactNode } from 'react';
-import { SxProps, Theme } from '@mui/material/styles';
-export interface ButtonGroupProps {
+import { ButtonGroupProps as MuiButtonGroupProps } from '@mui/material';
+export interface ButtonGroupProps extends MuiButtonGroupProps {
     /** Botones agrupados. */
     children?: ReactNode;
-    size?: 'small' | 'medium' | 'large';
-    variant?: 'text' | 'outlined' | 'contained';
-    orientation?: 'horizontal' | 'vertical';
-    color?: 'inherit' | 'primary' | 'secondary' | 'error' | 'info' | 'success' | 'warning';
-    disabled?: boolean;
-    fullWidth?: boolean;
-    sx?: SxProps<Theme>;
-    className?: string;
-    'aria-label'?: string;
 }
 /** Grupo de botones segmentado. Wrapper fino sobre MUI `ButtonGroup`. */
-export declare function ButtonGroup({ children, size, variant, orientation, color, disabled, fullWidth, sx, className, 'aria-label': ariaLabel, }: ButtonGroupProps): import("react/jsx-runtime").JSX.Element;
+export declare const ButtonGroup: import('react').ForwardRefExoticComponent<Omit<ButtonGroupProps, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
 export default ButtonGroup;

package/components/ButtonGroup/index.cjs

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

package/components/ButtonGroup/index.cjs.map

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

package/components/ButtonGroup/index.d.cts

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

package/components/ButtonGroup/index.d.mts

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

package/components/ButtonGroup/index.mjs

@@ -0,0 +1,6 @@
+import { B, B as B2 } from "../../chunks/ButtonGroup-DFPzal0z.mjs";
+export {
+  B as ButtonGroup,
+  B2 as default
+};
+//# sourceMappingURL=index.mjs.map

package/components/ButtonGroup/index.mjs.map

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

package/components/ButtonGroup.d.cts

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

package/components/ButtonGroup.d.mts

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

package/components/Card/Card.d.cts

@@ -0,0 +1,72 @@
+import { ReactNode } from 'react';
+import { CardProps as MuiCardProps, CardHeaderProps, CardContentProps } from '@mui/material';
+import { SxProps, Theme } from '@mui/material/styles';
+import { CardVariant, CardPadding } from './Card.sx';
+/** Nodos internos alcanzables vía `slotProps`. */
+export interface CardSlotProps {
+    /** El `CardHeader` — sólo se renderiza si hay `title`/`subheader`/`action`. */
+    header?: Partial<CardHeaderProps>;
+    /** El `CardContent` que envuelve al children en modo composición. */
+    content?: Partial<CardContentProps>;
+}
+/** Estado interno del Card que decide su estilo de fábrica. */
+export interface CardOwnerState {
+    variant: CardVariant;
+    padding: CardPadding;
+    clickable: boolean;
+}
+export interface CardProps extends Omit<MuiCardProps, 'variant' | 'raised' | 'title' | 'content'> {
+    /** Contenido del Card. */
+    children?: ReactNode;
+    /**
+     * Variante visual.
+     * - `elevated` (default): sombra sutil.
+     * - `outlined`: borde sin sombra.
+     * - `plain`: sin borde ni sombra, útil para layouts con nesting.
+     */
+    variant?: CardVariant;
+    /** Densidad del padding interno. */
+    padding?: CardPadding;
+    /** Si `true`, muestra feedback de hover/active (cursor, sombra). */
+    clickable?: boolean;
+    /**
+     * Preset registrado en `theme.styles.Card`. `"default"` usa el estilo
+     * built-in sin preset extra.
+     */
+    preset?: string;
+    /**
+     * MUI `raised` legacy — mantenido por backward-compat. Equivale a
+     * `variant="elevated"` con sombra mayor. Ignora `variant` si se usa.
+     */
+    raised?: boolean;
+    /**
+     * Título de cabecera. Si se provee (o `subheader`/`action`), se renderiza un
+     * `CardHeader` antes del contenido. Reemplaza el patrón
+     * `<Card><CardHeader/>...</Card>` de MUI.
+     */
+    title?: ReactNode;
+    /** Subtítulo de la cabecera. */
+    subheader?: ReactNode;
+    /** Acción a la derecha de la cabecera (ej. botón/menú). */
+    action?: ReactNode;
+    /**
+     * @deprecated Usar `slotProps={{ header: { sx } }}`. Se mantiene porque es
+     * API pública y hay call-sites usándola.
+     */
+    headerSx?: SxProps<Theme>;
+    /**
+     * sx aplicado al `CardContent` que envuelve a `children`. Al proveerlo (o al
+     * usar header), el body se envuelve en un `CardContent` y el padding del root
+     * pasa a `none` — equivale al patrón `<CardContent sx={...}>` de MUI.
+     */
+    contentSx?: SxProps<Theme>;
+    /**
+     * Props para los nodos internos. `className` y `sx` se acumulan sobre los
+     * internos en vez de pisarlos. Reemplaza a `headerSx`/`contentSx`.
+     */
+    slotProps?: CardSlotProps;
+    /** sx del root. Se compone sobre el base + preset. */
+    sx?: SxProps<Theme>;
+}
+export declare const Card: import('react').ForwardRefExoticComponent<Omit<CardProps, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+export default Card;

package/components/Card/Card.d.mts

@@ -0,0 +1,72 @@
+import { ReactNode } from 'react';
+import { CardProps as MuiCardProps, CardHeaderProps, CardContentProps } from '@mui/material';
+import { SxProps, Theme } from '@mui/material/styles';
+import { CardVariant, CardPadding } from './Card.sx.mjs';
+/** Nodos internos alcanzables vía `slotProps`. */
+export interface CardSlotProps {
+    /** El `CardHeader` — sólo se renderiza si hay `title`/`subheader`/`action`. */
+    header?: Partial<CardHeaderProps>;
+    /** El `CardContent` que envuelve al children en modo composición. */
+    content?: Partial<CardContentProps>;
+}
+/** Estado interno del Card que decide su estilo de fábrica. */
+export interface CardOwnerState {
+    variant: CardVariant;
+    padding: CardPadding;
+    clickable: boolean;
+}
+export interface CardProps extends Omit<MuiCardProps, 'variant' | 'raised' | 'title' | 'content'> {
+    /** Contenido del Card. */
+    children?: ReactNode;
+    /**
+     * Variante visual.
+     * - `elevated` (default): sombra sutil.
+     * - `outlined`: borde sin sombra.
+     * - `plain`: sin borde ni sombra, útil para layouts con nesting.
+     */
+    variant?: CardVariant;
+    /** Densidad del padding interno. */
+    padding?: CardPadding;
+    /** Si `true`, muestra feedback de hover/active (cursor, sombra). */
+    clickable?: boolean;
+    /**
+     * Preset registrado en `theme.styles.Card`. `"default"` usa el estilo
+     * built-in sin preset extra.
+     */
+    preset?: string;
+    /**
+     * MUI `raised` legacy — mantenido por backward-compat. Equivale a
+     * `variant="elevated"` con sombra mayor. Ignora `variant` si se usa.
+     */
+    raised?: boolean;
+    /**
+     * Título de cabecera. Si se provee (o `subheader`/`action`), se renderiza un
+     * `CardHeader` antes del contenido. Reemplaza el patrón
+     * `<Card><CardHeader/>...</Card>` de MUI.
+     */
+    title?: ReactNode;
+    /** Subtítulo de la cabecera. */
+    subheader?: ReactNode;
+    /** Acción a la derecha de la cabecera (ej. botón/menú). */
+    action?: ReactNode;
+    /**
+     * @deprecated Usar `slotProps={{ header: { sx } }}`. Se mantiene porque es
+     * API pública y hay call-sites usándola.
+     */
+    headerSx?: SxProps<Theme>;
+    /**
+     * sx aplicado al `CardContent` que envuelve a `children`. Al proveerlo (o al
+     * usar header), el body se envuelve en un `CardContent` y el padding del root
+     * pasa a `none` — equivale al patrón `<CardContent sx={...}>` de MUI.
+     */
+    contentSx?: SxProps<Theme>;
+    /**
+     * Props para los nodos internos. `className` y `sx` se acumulan sobre los
+     * internos en vez de pisarlos. Reemplaza a `headerSx`/`contentSx`.
+     */
+    slotProps?: CardSlotProps;
+    /** sx del root. Se compone sobre el base + preset. */
+    sx?: SxProps<Theme>;
+}
+export declare const Card: import('react').ForwardRefExoticComponent<Omit<CardProps, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+export default Card;

package/components/Card/Card.d.ts

@@ -1,7 +1,21 @@
 import { ReactNode } from 'react';
+import { CardProps as MuiCardProps, CardHeaderProps, CardContentProps } from '@mui/material';
 import { SxProps, Theme } from '@mui/material/styles';
 import { CardVariant, CardPadding } from './Card.sx';
-export interface CardProps {
+/** Nodos internos alcanzables vía `slotProps`. */
+export interface CardSlotProps {
+    /** El `CardHeader` — sólo se renderiza si hay `title`/`subheader`/`action`. */
+    header?: Partial<CardHeaderProps>;
+    /** El `CardContent` que envuelve al children en modo composición. */
+    content?: Partial<CardContentProps>;
+}
+/** Estado interno del Card que decide su estilo de fábrica. */
+export interface CardOwnerState {
+    variant: CardVariant;
+    padding: CardPadding;
+    clickable: boolean;
+}
+export interface CardProps extends Omit<MuiCardProps, 'variant' | 'raised' | 'title' | 'content'> {
     /** Contenido del Card. */
     children?: ReactNode;
     /**
@@ -35,7 +49,10 @@ export interface CardProps {
     subheader?: ReactNode;
     /** Acción a la derecha de la cabecera (ej. botón/menú). */
     action?: ReactNode;
-    /** sx aplicado al `CardHeader`. */
+    /**
+     * @deprecated Usar `slotProps={{ header: { sx } }}`. Se mantiene porque es
+     * API pública y hay call-sites usándola.
+     */
     headerSx?: SxProps<Theme>;
     /**
      * sx aplicado al `CardContent` que envuelve a `children`. Al proveerlo (o al
@@ -43,12 +60,13 @@ export interface CardProps {
      * pasa a `none` — equivale al patrón `<CardContent sx={...}>` de MUI.
      */
     contentSx?: SxProps<Theme>;
+    /**
+     * Props para los nodos internos. `className` y `sx` se acumulan sobre los
+     * internos en vez de pisarlos. Reemplaza a `headerSx`/`contentSx`.
+     */
+    slotProps?: CardSlotProps;
     /** sx del root. Se compone sobre el base + preset. */
     sx?: SxProps<Theme>;
-    onClick?: () => void;
-    onBlur?: () => void;
-    className?: string;
-    'data-testid'?: string;
 }
-export declare function Card({ children, variant, padding, clickable, preset, raised, title, subheader, action, headerSx, contentSx, sx, onClick, onBlur, className, 'data-testid': dataTestId, }: CardProps): import("react/jsx-runtime").JSX.Element;
+export declare const Card: import('react').ForwardRefExoticComponent<Omit<CardProps, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
 export default Card;

package/components/Card/Card.sx.d.cts

@@ -0,0 +1,25 @@
+import { CSSObject, SxProps, Theme } from '@mui/material/styles';
+export type CardVariant = 'elevated' | 'outlined' | 'plain';
+export type CardPadding = 'none' | 'dense' | 'normal' | 'loose';
+export interface BuildCardSxArgs {
+    variant: CardVariant;
+    padding: CardPadding;
+    clickable: boolean;
+}
+/**
+ * Estilo base del Card, en CSS real (no en atajos de `sx`).
+ *
+ * La distinción importa: esto lo consume `styled()`, donde emotion recibe CSS
+ * plano y NO interpreta los atajos del sistema de MUI — `p: 2.5` sería
+ * `padding: 2.5` (inválido) en vez de 20px, y `'background.paper'` no
+ * resolvería a la paleta. Por eso cada valor pasa por `theme.spacing` /
+ * `theme.palette` explícitamente.
+ */
+export declare function buildCardStyles(theme: Theme, { variant, padding, clickable }: BuildCardSxArgs): CSSObject;
+/**
+ * @deprecated Quedó como parte de la API pública del paquete, pero el Card ya
+ * no la usa: su estilo de fábrica vive en el `styled()` del componente para que
+ * `theme.components.FriCard.styleOverrides` pueda ganarle. Preferir
+ * `buildCardStyles(theme, args)`.
+ */
+export declare function buildCardSx(args: BuildCardSxArgs): SxProps<Theme>;

package/components/Card/Card.sx.d.mts

@@ -0,0 +1,25 @@
+import { CSSObject, SxProps, Theme } from '@mui/material/styles';
+export type CardVariant = 'elevated' | 'outlined' | 'plain';
+export type CardPadding = 'none' | 'dense' | 'normal' | 'loose';
+export interface BuildCardSxArgs {
+    variant: CardVariant;
+    padding: CardPadding;
+    clickable: boolean;
+}
+/**
+ * Estilo base del Card, en CSS real (no en atajos de `sx`).
+ *
+ * La distinción importa: esto lo consume `styled()`, donde emotion recibe CSS
+ * plano y NO interpreta los atajos del sistema de MUI — `p: 2.5` sería
+ * `padding: 2.5` (inválido) en vez de 20px, y `'background.paper'` no
+ * resolvería a la paleta. Por eso cada valor pasa por `theme.spacing` /
+ * `theme.palette` explícitamente.
+ */
+export declare function buildCardStyles(theme: Theme, { variant, padding, clickable }: BuildCardSxArgs): CSSObject;
+/**
+ * @deprecated Quedó como parte de la API pública del paquete, pero el Card ya
+ * no la usa: su estilo de fábrica vive en el `styled()` del componente para que
+ * `theme.components.FriCard.styleOverrides` pueda ganarle. Preferir
+ * `buildCardStyles(theme, args)`.
+ */
+export declare function buildCardSx(args: BuildCardSxArgs): SxProps<Theme>;

package/components/Card/Card.sx.d.ts

@@ -1,4 +1,4 @@
-import { SxProps, Theme } from '@mui/material/styles';
+import { CSSObject, SxProps, Theme } from '@mui/material/styles';
 export type CardVariant = 'elevated' | 'outlined' | 'plain';
 export type CardPadding = 'none' | 'dense' | 'normal' | 'loose';
 export interface BuildCardSxArgs {
@@ -7,8 +7,19 @@ export interface BuildCardSxArgs {
     clickable: boolean;
 }
 /**
- * Estilo base del Card. La prop `sx` del consumer se compone encima junto al
- * preset resuelto (en Card.tsx). Este builder solo se ocupa de variant +
- * padding para que siga siendo predecible.
+ * Estilo base del Card, en CSS real (no en atajos de `sx`).
+ *
+ * La distinción importa: esto lo consume `styled()`, donde emotion recibe CSS
+ * plano y NO interpreta los atajos del sistema de MUI — `p: 2.5` sería
+ * `padding: 2.5` (inválido) en vez de 20px, y `'background.paper'` no
+ * resolvería a la paleta. Por eso cada valor pasa por `theme.spacing` /
+ * `theme.palette` explícitamente.
  */
-export declare function buildCardSx({ variant, padding, clickable, }: BuildCardSxArgs): SxProps<Theme>;
+export declare function buildCardStyles(theme: Theme, { variant, padding, clickable }: BuildCardSxArgs): CSSObject;
+/**
+ * @deprecated Quedó como parte de la API pública del paquete, pero el Card ya
+ * no la usa: su estilo de fábrica vive en el `styled()` del componente para que
+ * `theme.components.FriCard.styleOverrides` pueda ganarle. Preferir
+ * `buildCardStyles(theme, args)`.
+ */
+export declare function buildCardSx(args: BuildCardSxArgs): SxProps<Theme>;

package/components/Card/index.cjs

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

package/components/Card/index.cjs.map

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

package/components/Card/index.d.cts

@@ -0,0 +1,4 @@
+export { Card, default } from './Card';
+export type { CardProps } from './Card';
+export type { CardVariant, CardPadding } from './Card.sx';
+export { buildCardSx, buildCardStyles } from './Card.sx';

package/components/Card/index.d.mts

@@ -0,0 +1,4 @@
+export { Card, default } from './Card.mjs';
+export type { CardProps } from './Card.mjs';
+export type { CardVariant, CardPadding } from './Card.sx.mjs';
+export { buildCardSx, buildCardStyles } from './Card.sx.mjs';

package/components/Card/index.d.ts

@@ -1,4 +1,4 @@
 export { Card, default } from './Card';
 export type { CardProps } from './Card';
 export type { CardVariant, CardPadding } from './Card.sx';
-export { buildCardSx } from './Card.sx';
+export { buildCardSx, buildCardStyles } from './Card.sx';

package/components/Card/index.mjs

@@ -0,0 +1,8 @@
+import { C, a, b, C as C2 } from "../../chunks/Card-DfueKp5e.mjs";
+export {
+  C as Card,
+  a as buildCardStyles,
+  b as buildCardSx,
+  C2 as default
+};
+//# sourceMappingURL=index.mjs.map

package/components/Card/index.mjs.map

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

package/components/Card.d.cts

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

package/components/Card.d.mts

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

package/components/Checkbox/Checkbox.d.cts

@@ -0,0 +1,54 @@
+import { CheckboxProps as MuiCheckboxProps, SxProps, Theme } from '@mui/material';
+import { RegisterOptions } from 'react-hook-form';
+export type CheckboxSize = 'small' | 'medium';
+export type CheckboxLabelPlacement = 'start' | 'end' | 'top' | 'bottom';
+export type CheckboxColor = 'default' | 'primary' | 'secondary' | 'success' | 'error' | 'info' | 'warning';
+export interface BaseCheckboxProps extends Omit<MuiCheckboxProps, 'value' | 'onChange' | 'checked' | 'defaultChecked' | 'size' | 'color'> {
+    /** Texto al lado del checkbox. Si está ausente, se renderiza solo el control. */
+    label?: string;
+    size?: CheckboxSize;
+    /** Color del checkbox. Default: `'primary'`. */
+    color?: CheckboxColor;
+    /** Posición del label respecto al checkbox. Default: `'end'`. */
+    labelPlacement?: CheckboxLabelPlacement;
+    /** Estado indeterminate (tri-state). Típico para "select all" parcial. */
+    indeterminate?: boolean;
+    disabled?: boolean;
+    error?: boolean;
+    helperText?: string;
+    /** Renderiza un contenedor con borde alrededor del checkbox + label. Default: false. */
+    bordered?: boolean;
+    /** Border radius del contenedor (cuando bordered). Default: 10. */
+    borderRadius?: number | string;
+    /** Valor inicial del checkbox en modo RHF. */
+    defaultChecked?: boolean;
+    /**
+     * Nombre del preset de estilo registrado en `theme.styles.Checkbox`.
+     * - `"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 RHFCheckboxProps extends BaseCheckboxProps {
+    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?: (checked: boolean) => void;
+    checked?: never;
+    onChange?: never;
+}
+export interface ControlledCheckboxProps extends BaseCheckboxProps {
+    name?: string;
+    control?: never;
+    validation?: never;
+    checked: boolean;
+    onChange: (checked: boolean) => void;
+}
+export type CheckboxProps = RHFCheckboxProps | ControlledCheckboxProps;
+export declare const Checkbox: import('react').ForwardRefExoticComponent<(Omit<RHFCheckboxProps, "ref"> | Omit<ControlledCheckboxProps, "ref">) & import('react').RefAttributes<HTMLDivElement>>;
+export default Checkbox;

package/components/Checkbox/Checkbox.d.mts

@@ -0,0 +1,54 @@
+import { CheckboxProps as MuiCheckboxProps, SxProps, Theme } from '@mui/material';
+import { RegisterOptions } from 'react-hook-form';
+export type CheckboxSize = 'small' | 'medium';
+export type CheckboxLabelPlacement = 'start' | 'end' | 'top' | 'bottom';
+export type CheckboxColor = 'default' | 'primary' | 'secondary' | 'success' | 'error' | 'info' | 'warning';
+export interface BaseCheckboxProps extends Omit<MuiCheckboxProps, 'value' | 'onChange' | 'checked' | 'defaultChecked' | 'size' | 'color'> {
+    /** Texto al lado del checkbox. Si está ausente, se renderiza solo el control. */
+    label?: string;
+    size?: CheckboxSize;
+    /** Color del checkbox. Default: `'primary'`. */
+    color?: CheckboxColor;
+    /** Posición del label respecto al checkbox. Default: `'end'`. */
+    labelPlacement?: CheckboxLabelPlacement;
+    /** Estado indeterminate (tri-state). Típico para "select all" parcial. */
+    indeterminate?: boolean;
+    disabled?: boolean;
+    error?: boolean;
+    helperText?: string;
+    /** Renderiza un contenedor con borde alrededor del checkbox + label. Default: false. */
+    bordered?: boolean;
+    /** Border radius del contenedor (cuando bordered). Default: 10. */
+    borderRadius?: number | string;
+    /** Valor inicial del checkbox en modo RHF. */
+    defaultChecked?: boolean;
+    /**
+     * Nombre del preset de estilo registrado en `theme.styles.Checkbox`.
+     * - `"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 RHFCheckboxProps extends BaseCheckboxProps {
+    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?: (checked: boolean) => void;
+    checked?: never;
+    onChange?: never;
+}
+export interface ControlledCheckboxProps extends BaseCheckboxProps {
+    name?: string;
+    control?: never;
+    validation?: never;
+    checked: boolean;
+    onChange: (checked: boolean) => void;
+}
+export type CheckboxProps = RHFCheckboxProps | ControlledCheckboxProps;
+export declare const Checkbox: import('react').ForwardRefExoticComponent<(Omit<RHFCheckboxProps, "ref"> | Omit<ControlledCheckboxProps, "ref">) & import('react').RefAttributes<HTMLDivElement>>;
+export default Checkbox;

package/components/Checkbox/Checkbox.d.ts

@@ -1,4 +1,3 @@
-import { FC } from 'react';
 import { CheckboxProps as MuiCheckboxProps, SxProps, Theme } from '@mui/material';
 import { RegisterOptions } from 'react-hook-form';
 export type CheckboxSize = 'small' | 'medium';
@@ -51,5 +50,5 @@ export interface ControlledCheckboxProps extends BaseCheckboxProps {
     onChange: (checked: boolean) => void;
 }
 export type CheckboxProps = RHFCheckboxProps | ControlledCheckboxProps;
-export declare const Checkbox: FC<CheckboxProps>;
+export declare const Checkbox: import('react').ForwardRefExoticComponent<(Omit<RHFCheckboxProps, "ref"> | Omit<ControlledCheckboxProps, "ref">) & import('react').RefAttributes<HTMLDivElement>>;
 export default Checkbox;