@soyfri/shared-library 2.0.0-beta.2 → 2.0.0-beta.21

package/dist/Modal-BRZMPwDj.js

@@ -0,0 +1,348 @@
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+import { jsxs, jsx, Fragment } from "react/jsx-runtime";
+import { forwardRef, useState, useId, useImperativeHandle, Children, isValidElement, cloneElement } from "react";
+import { Box, Stack, Typography, useTheme, useMediaQuery, Modal as Modal$1, Paper } from "@mui/material";
+import InfoOutlinedIcon from "@mui/icons-material/InfoOutlined";
+import WarningAmberIcon from "@mui/icons-material/WarningAmber";
+import ErrorOutlineIcon from "@mui/icons-material/ErrorOutline";
+import CheckCircleOutlineIcon from "@mui/icons-material/CheckCircleOutline";
+import { B as Button } from "./Button-UkkP-bNw.js";
+import { m as mergeSx } from "./mergeSx-BXoNZjB_.js";
+const ModalFooter = ({
+  children,
+  showCloseButton = true,
+  closeButtonText = "Cerrar",
+  closeButtonDisabled = false,
+  onClose,
+  actions = []
+}) => {
+  return /* @__PURE__ */ jsxs(
+    Box,
+    {
+      sx: {
+        padding: 2,
+        borderTop: (theme) => `1px solid ${theme.palette.divider}`,
+        display: "flex",
+        justifyContent: "flex-end",
+        gap: 1
+      },
+      children: [
+        children,
+        /* @__PURE__ */ jsxs(Stack, { direction: "row", spacing: 1, children: [
+          showCloseButton && /* @__PURE__ */ jsx(
+            Button,
+            {
+              onClick: onClose,
+              disabled: closeButtonDisabled,
+              variant: "outlined",
+              color: "secondary",
+              children: closeButtonText
+            }
+          ),
+          actions.map((action) => {
+            const { buttonProps, text, onClick, disabled, variant, color } = action;
+            return /* @__PURE__ */ jsx(
+              Button,
+              __spreadProps(__spreadValues({
+                onClick,
+                disabled,
+                variant: variant || "contained",
+                color: color || "primary"
+              }, buttonProps), {
+                children: text
+              }),
+              text
+            );
+          })
+        ] })
+      ]
+    }
+  );
+};
+ModalFooter.displayName = "ModalFooter";
+const ModalHeader = ({ children, id }) => {
+  return /* @__PURE__ */ jsx(
+    Box,
+    {
+      sx: {
+        padding: 2,
+        borderBottom: (theme) => `1px solid ${theme.palette.divider}`,
+        display: "flex",
+        alignItems: "center",
+        justifyContent: "space-between"
+      },
+      children: /* @__PURE__ */ jsx(Typography, { id, variant: "h6", component: "h2", children })
+    }
+  );
+};
+ModalHeader.displayName = "ModalHeader";
+const ModalBody = ({ children, id }) => {
+  return /* @__PURE__ */ jsx(Box, { id, sx: { padding: 2, overflowY: "auto", flexGrow: 1 }, children });
+};
+ModalBody.displayName = "ModalBody";
+const isModalSlot = (child, Component, displayName) => {
+  if (child.type === Component) return true;
+  const type = child.type;
+  return (type == null ? void 0 : type.displayName) === displayName;
+};
+const modalStyle = {
+  position: "absolute",
+  top: "50%",
+  left: "50%",
+  transform: "translate(-50%, -50%)",
+  width: "90%",
+  maxHeight: "90vh",
+  display: "flex",
+  flexDirection: "column",
+  outline: "none"
+};
+const severityConfig = {
+  info: {
+    color: "primary",
+    icon: /* @__PURE__ */ jsx(InfoOutlinedIcon, { sx: { fontSize: 48 } }),
+    paletteKey: "primary"
+  },
+  warning: {
+    color: "warning",
+    icon: /* @__PURE__ */ jsx(WarningAmberIcon, { sx: { fontSize: 48 } }),
+    paletteKey: "warning"
+  },
+  error: {
+    color: "error",
+    icon: /* @__PURE__ */ jsx(ErrorOutlineIcon, { sx: { fontSize: 48 } }),
+    paletteKey: "error"
+  },
+  success: {
+    color: "success",
+    icon: /* @__PURE__ */ jsx(CheckCircleOutlineIcon, { sx: { fontSize: 48 } }),
+    paletteKey: "success"
+  }
+};
+const Modal = forwardRef(
+  ({
+    mode = "default",
+    open: controlledOpen,
+    onClose: controlledOnClose,
+    title,
+    children,
+    showCloseButton = true,
+    closeButtonText = "Cerrar",
+    closeButtonDisabled = false,
+    actions = [],
+    maxWidth = "sm",
+    hiddenHeader = false,
+    hiddenBody = false,
+    hiddenFooter = false,
+    sx,
+    paperSx,
+    className,
+    // Props del modo confirm
+    onConfirm,
+    confirmText = "Confirmar",
+    confirmDisabled = false,
+    severity = "info",
+    confirmMessage
+  }, ref) => {
+    const [internalOpen, setInternalOpen] = useState(false);
+    const [confirmLoading, setConfirmLoading] = useState(false);
+    const titleId = useId();
+    const descId = useId();
+    const isOpen = controlledOpen !== void 0 ? controlledOpen : internalOpen;
+    useImperativeHandle(ref, () => ({
+      open: () => setInternalOpen(true),
+      close: () => {
+        setInternalOpen(false);
+        controlledOnClose == null ? void 0 : controlledOnClose();
+      }
+    }));
+    const handleCloseInternal = () => {
+      setInternalOpen(false);
+      controlledOnClose == null ? void 0 : controlledOnClose();
+    };
+    const handleConfirm = async () => {
+      if (!onConfirm) {
+        handleCloseInternal();
+        return;
+      }
+      const result = onConfirm();
+      if (!(result instanceof Promise)) {
+        handleCloseInternal();
+        return;
+      }
+      setConfirmLoading(true);
+      try {
+        await result;
+        handleCloseInternal();
+      } catch (err) {
+        console.error("Modal onConfirm failed:", err);
+      } finally {
+        setConfirmLoading(false);
+      }
+    };
+    const theme = useTheme();
+    const isMobile = useMediaQuery(theme.breakpoints.down("sm"));
+    const getWidth = () => {
+      if (isMobile) return "95%";
+      switch (maxWidth) {
+        case "xs":
+          return 300;
+        case "sm":
+          return 500;
+        case "md":
+          return 700;
+        case "lg":
+          return 900;
+        case "xl":
+          return 1100;
+        case false:
+          return "auto";
+        default:
+          return typeof maxWidth === "string" ? maxWidth : 500;
+      }
+    };
+    const paperBaseSx = __spreadProps(__spreadValues({}, modalStyle), { width: getWidth() });
+    const mergedPaperSx = mergeSx(paperBaseSx, paperSx);
+    if (mode === "confirm") {
+      const config = severityConfig[severity];
+      const message = confirmMessage != null ? confirmMessage : children;
+      return /* @__PURE__ */ jsx(
+        Modal$1,
+        {
+          open: isOpen,
+          onClose: handleCloseInternal,
+          "aria-labelledby": title ? titleId : void 0,
+          "aria-describedby": message ? descId : void 0,
+          closeAfterTransition: true,
+          sx,
+          children: /* @__PURE__ */ jsxs(Paper, { className, sx: mergedPaperSx, children: [
+            /* @__PURE__ */ jsxs(Stack, { spacing: 2.5, sx: { p: 3, alignItems: "center", textAlign: "center" }, children: [
+              /* @__PURE__ */ jsx(
+                Box,
+                {
+                  sx: {
+                    width: 72,
+                    height: 72,
+                    borderRadius: "50%",
+                    backgroundColor: (t) => t.palette[config.paletteKey].light,
+                    color: (t) => t.palette[config.paletteKey].dark,
+                    display: "flex",
+                    alignItems: "center",
+                    justifyContent: "center",
+                    opacity: 0.9
+                  },
+                  children: config.icon
+                }
+              ),
+              title && /* @__PURE__ */ jsx(Typography, { id: titleId, variant: "h6", component: "h2", sx: { fontWeight: 700 }, children: title }),
+              message && /* @__PURE__ */ jsx(Typography, { id: descId, variant: "body2", color: "text.secondary", children: message })
+            ] }),
+            /* @__PURE__ */ jsx(
+              ModalFooter,
+              {
+                showCloseButton,
+                closeButtonText,
+                closeButtonDisabled: closeButtonDisabled || confirmLoading,
+                onClose: handleCloseInternal,
+                actions: [
+                  {
+                    text: confirmText,
+                    onClick: handleConfirm,
+                    disabled: confirmDisabled || confirmLoading,
+                    variant: "contained",
+                    color: config.color
+                  }
+                ]
+              }
+            )
+          ] })
+        }
+      );
+    }
+    const renderChildren = () => {
+      let header = null;
+      let body = null;
+      let footer = null;
+      Children.forEach(children, (child) => {
+        var _a, _b, _c, _d, _e;
+        if (!isValidElement(child)) return;
+        if (isModalSlot(child, ModalHeader, "ModalHeader")) {
+          const headerChild = child;
+          header = cloneElement(headerChild, __spreadValues({ id: titleId }, headerChild.props));
+        } else if (isModalSlot(child, ModalBody, "ModalBody")) {
+          const bodyChild = child;
+          body = cloneElement(bodyChild, __spreadValues({ id: descId }, bodyChild.props));
+        } else if (isModalSlot(child, ModalFooter, "ModalFooter")) {
+          const footerChild = child;
+          const childProps = footerChild.props;
+          footer = cloneElement(footerChild, {
+            showCloseButton: (_a = childProps.showCloseButton) != null ? _a : showCloseButton,
+            closeButtonText: (_b = childProps.closeButtonText) != null ? _b : closeButtonText,
+            closeButtonDisabled: (_c = childProps.closeButtonDisabled) != null ? _c : closeButtonDisabled,
+            onClose: (_d = childProps.onClose) != null ? _d : handleCloseInternal,
+            actions: (_e = childProps.actions) != null ? _e : actions
+          });
+        }
+      });
+      if (!footer && !hiddenFooter) {
+        footer = /* @__PURE__ */ jsx(
+          ModalFooter,
+          {
+            showCloseButton,
+            closeButtonText,
+            closeButtonDisabled,
+            onClose: handleCloseInternal,
+            actions
+          }
+        );
+      }
+      return /* @__PURE__ */ jsxs(Fragment, { children: [
+        !hiddenHeader && (header || title && /* @__PURE__ */ jsx(ModalHeader, { id: titleId, children: title })),
+        !hiddenBody && body,
+        footer
+      ] });
+    };
+    return /* @__PURE__ */ jsx(
+      Modal$1,
+      {
+        open: isOpen,
+        onClose: handleCloseInternal,
+        "aria-labelledby": titleId,
+        "aria-describedby": descId,
+        closeAfterTransition: true,
+        sx,
+        children: /* @__PURE__ */ jsx(Paper, { className, sx: mergedPaperSx, children: renderChildren() })
+      }
+    );
+  }
+);
+Modal.displayName = "Modal";
+const ModalWithStatics = Modal;
+ModalWithStatics.Header = ModalHeader;
+ModalWithStatics.Body = ModalBody;
+ModalWithStatics.Footer = ModalFooter;
+export {
+  ModalWithStatics as M,
+  Modal as a,
+  ModalHeader as b,
+  ModalBody as c,
+  ModalFooter as d
+};
+//# sourceMappingURL=Modal-BRZMPwDj.js.map

package/dist/Modal-BRZMPwDj.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Modal-BRZMPwDj.js","sources":["../src/components/Modal/ModalFooter.tsx","../src/components/Modal/ModalHeader.tsx","../src/components/Modal/ModalBody.tsx","../src/components/Modal/Modal.tsx"],"sourcesContent":["import React from 'react';\nimport { Box, Stack } from '@mui/material';\nimport type { ButtonProps as MuiButtonProps } from '@mui/material/Button';\n\nimport { Button } from '../Button';\n\n// Interfaz para acciones personalizadas (se mantiene aquí)\nexport interface ModalAction {\n  text: string;\n  onClick?: () => void;\n  disabled?: boolean;\n  variant?: MuiButtonProps['variant'];\n  color?: MuiButtonProps['color'];\n  /**\n   * Props adicionales que se forwardean al `<Button>` interno. Útil para casos\n   * avanzados como conectar el botón con un `<form id=\"...\">` externo usando\n   * `buttonProps={{ type: 'submit', form: 'my-form-id' }}`.\n   */\n  buttonProps?: Partial<MuiButtonProps> & { form?: string };\n}\n\nexport interface ModalFooterProps {\n  children?: React.ReactNode;\n  showCloseButton?: boolean;\n  closeButtonText?: string;\n  closeButtonDisabled?: boolean;\n  onClose: () => void;\n  actions?: ModalAction[];\n}\n\nexport const ModalFooter: React.FC<ModalFooterProps> = ({\n  children,\n  showCloseButton = true,\n  closeButtonText = 'Cerrar',\n  closeButtonDisabled = false,\n  onClose,\n  actions = [],\n}) => {\n  return (\n    <Box\n      sx={{\n        padding: 2,\n        borderTop: (theme) => `1px solid ${theme.palette.divider}`,\n        display: 'flex',\n        justifyContent: 'flex-end',\n        gap: 1,\n      }}\n    >\n      {children}\n      <Stack direction=\"row\" spacing={1}>\n        {showCloseButton && (\n          <Button\n            onClick={onClose}\n            disabled={closeButtonDisabled}\n            variant=\"outlined\"\n            color=\"secondary\"\n          >\n            {closeButtonText}\n          </Button>\n        )}\n        {actions.map((action) => {\n          const { buttonProps, text, onClick, disabled, variant, color } = action;\n          return (\n            <Button\n              key={text}\n              onClick={onClick}\n              disabled={disabled}\n              variant={variant || 'contained'}\n              color={color || 'primary'}\n              {...(buttonProps as any)}\n            >\n              {text}\n            </Button>\n          );\n        })}\n      </Stack>\n    </Box>\n  );\n};\n\nModalFooter.displayName = 'ModalFooter';\n\nexport default ModalFooter;\n","import React from 'react';\nimport { Box, Typography } from '@mui/material';\n\nexport interface ModalHeaderProps {\n  children: React.ReactNode;\n  /**\n   * ID del elemento — usado para `aria-labelledby` del Modal. Se setea\n   * automáticamente cuando el header se renderiza dentro de `<Modal>`.\n   */\n  id?: string;\n}\n\nexport const ModalHeader: React.FC<ModalHeaderProps> = ({ children, id }) => {\n  return (\n    <Box\n      sx={{\n        padding: 2,\n        borderBottom: (theme) => `1px solid ${theme.palette.divider}`,\n        display: 'flex',\n        alignItems: 'center',\n        justifyContent: 'space-between',\n      }}\n    >\n      <Typography id={id} variant=\"h6\" component=\"h2\">\n        {children}\n      </Typography>\n    </Box>\n  );\n};\n\nModalHeader.displayName = 'ModalHeader';\n\nexport default ModalHeader;\n","import React from 'react';\nimport { Box } from '@mui/material';\n\nexport interface ModalBodyProps {\n  children: React.ReactNode;\n  /**\n   * ID del elemento — usado para `aria-describedby` del Modal. Se setea\n   * automáticamente cuando el body se renderiza dentro de `<Modal>`.\n   */\n  id?: string;\n}\n\nexport const ModalBody: React.FC<ModalBodyProps> = ({ children, id }) => {\n  return (\n    <Box id={id} sx={{ padding: 2, overflowY: 'auto', flexGrow: 1 }}>\n      {children}\n    </Box>\n  );\n};\n\nModalBody.displayName = 'ModalBody';\n\nexport default ModalBody;\n","import {\n  Children,\n  cloneElement,\n  forwardRef,\n  isValidElement,\n  useId,\n  useImperativeHandle,\n  useState,\n  type ReactElement,\n  type ReactNode,\n} from 'react';\nimport {\n  Modal as MuiModal,\n  Paper,\n  useMediaQuery,\n  useTheme,\n  Box,\n  Stack,\n  Typography,\n} from '@mui/material';\nimport type { SxProps, Theme } from '@mui/material/styles';\nimport InfoOutlinedIcon from '@mui/icons-material/InfoOutlined';\nimport WarningAmberIcon from '@mui/icons-material/WarningAmber';\nimport ErrorOutlineIcon from '@mui/icons-material/ErrorOutline';\nimport CheckCircleOutlineIcon from '@mui/icons-material/CheckCircleOutline';\n\nimport type { DialogProps } from '@mui/material/Dialog';\nimport { ModalFooter, type ModalAction, type ModalFooterProps } from './ModalFooter';\nimport { ModalHeader } from './ModalHeader';\nimport { ModalBody } from './ModalBody';\nimport { mergeSx } from '../_shared/mergeSx';\n\n// Detección robusta de sub-componentes — funciona con wrappers / HMR que\n// rompen la igualdad de referencia (`child.type === ModalHeader`).\nconst isModalSlot = (\n  child: ReactElement,\n  Component: unknown,\n  displayName: string,\n): boolean => {\n  if (child.type === Component) return true;\n  const type = child.type as { displayName?: string };\n  return type?.displayName === displayName;\n};\n\n// Define la interfaz para los métodos que el padre puede llamar a través de la ref\nexport interface ModalRef {\n  open: () => void;\n  close: () => void;\n}\n\nexport type ModalMode = 'default' | 'confirm';\nexport type ModalSeverity = 'info' | 'warning' | 'error' | 'success';\n\nexport interface ModalProps {\n  /**\n   * Modo del modal.\n   * - `default` (default): modal genérico con slots `Header`/`Body`/`Footer` y\n   *   `actions` custom.\n   * - `confirm`: reemplaza al `ConfirmModal` legacy. Renderiza un layout\n   *   focalizado con icono por severidad, mensaje y botones \"Cancelar\" /\n   *   \"Confirmar\".\n   */\n  mode?: ModalMode;\n\n  // ── Props comunes ────────────────────────────────────────────────────\n  /** Controlado externamente. Omitir si se usa vía ref. */\n  open?: boolean;\n  /** Callback al cerrar. También se dispara al confirmar/cancelar. */\n  onClose?: () => void;\n  title?: string;\n  children?: ReactNode;\n  showCloseButton?: boolean;\n  closeButtonText?: string;\n  closeButtonDisabled?: boolean;\n  actions?: ModalAction[];\n  maxWidth?: DialogProps['maxWidth'];\n  /** Oculta el header (incluso si hay `title` o se pasa un `<Modal.Header>`). */\n  hiddenHeader?: boolean;\n  /** Oculta el body (incluso si se pasa un `<Modal.Body>`). */\n  hiddenBody?: boolean;\n  /** Oculta el footer (incluso si se pasa un `<Modal.Footer>` o `actions`). */\n  hiddenFooter?: boolean;\n  /** sx del Modal root (MuiModal). */\n  sx?: SxProps<Theme>;\n  /** sx del Paper interno (contenedor visual). Se mergea sobre el default. */\n  paperSx?: SxProps<Theme>;\n  /** className del Paper interno. */\n  className?: string;\n\n  // ── Props del modo confirm ───────────────────────────────────────────\n  /**\n   * Callback de confirmación. Soporta promesa — si devuelve `Promise`, el\n   * botón muestra estado `disabled` mientras resuelve.\n   *\n   * Si la promesa **rechaza**, el modal queda abierto para que el consumer\n   * pueda mostrar el error en su UI. El modal se cierra solo en éxito.\n   */\n  onConfirm?: () => void | Promise<void>;\n  /** Texto del botón primario en modo `confirm`. Default: \"Confirmar\". */\n  confirmText?: string;\n  /** Deshabilita el botón de confirmar. */\n  confirmDisabled?: boolean;\n  /**\n   * Severidad visual en modo `confirm`. Controla el icono y el color del\n   * botón de confirmación.\n   * - `info` (default): primary\n   * - `warning`: warning (amarillo)\n   * - `error`: error (rojo) — típico para \"Eliminar\"\n   * - `success`: success (verde) — típico para \"Aprobar\"\n   */\n  severity?: ModalSeverity;\n  /**\n   * Mensaje del confirm. Puede ser string o cualquier ReactNode. Si se omite,\n   * se usa `children`.\n   */\n  confirmMessage?: ReactNode;\n}\n\nconst modalStyle = {\n  position: 'absolute' as const,\n  top: '50%',\n  left: '50%',\n  transform: 'translate(-50%, -50%)',\n  width: '90%',\n  maxHeight: '90vh',\n  display: 'flex',\n  flexDirection: 'column' as const,\n  outline: 'none',\n};\n\nconst severityConfig: Record<\n  ModalSeverity,\n  { color: ModalAction['color']; icon: ReactNode; paletteKey: 'primary' | 'warning' | 'error' | 'success' }\n> = {\n  info: {\n    color: 'primary',\n    icon: <InfoOutlinedIcon sx={{ fontSize: 48 }} />,\n    paletteKey: 'primary',\n  },\n  warning: {\n    color: 'warning',\n    icon: <WarningAmberIcon sx={{ fontSize: 48 }} />,\n    paletteKey: 'warning',\n  },\n  error: {\n    color: 'error',\n    icon: <ErrorOutlineIcon sx={{ fontSize: 48 }} />,\n    paletteKey: 'error',\n  },\n  success: {\n    color: 'success',\n    icon: <CheckCircleOutlineIcon sx={{ fontSize: 48 }} />,\n    paletteKey: 'success',\n  },\n};\n\nexport const Modal = forwardRef<ModalRef, ModalProps>(\n  (\n    {\n      mode = 'default',\n      open: controlledOpen,\n      onClose: controlledOnClose,\n      title,\n      children,\n      showCloseButton = true,\n      closeButtonText = 'Cerrar',\n      closeButtonDisabled = false,\n      actions = [],\n      maxWidth = 'sm',\n      hiddenHeader = false,\n      hiddenBody = false,\n      hiddenFooter = false,\n      sx,\n      paperSx,\n      className,\n\n      // Props del modo confirm\n      onConfirm,\n      confirmText = 'Confirmar',\n      confirmDisabled = false,\n      severity = 'info',\n      confirmMessage,\n    },\n    ref,\n  ) => {\n    const [internalOpen, setInternalOpen] = useState(false);\n    const [confirmLoading, setConfirmLoading] = useState(false);\n\n    // IDs estables para a11y: `aria-labelledby` y `aria-describedby`.\n    const titleId = useId();\n    const descId = useId();\n\n    const isOpen = controlledOpen !== undefined ? controlledOpen : internalOpen;\n\n    useImperativeHandle(ref, () => ({\n      open: () => setInternalOpen(true),\n      close: () => {\n        setInternalOpen(false);\n        controlledOnClose?.();\n      },\n    }));\n\n    const handleCloseInternal = () => {\n      setInternalOpen(false);\n      controlledOnClose?.();\n    };\n\n    const handleConfirm = async () => {\n      if (!onConfirm) {\n        handleCloseInternal();\n        return;\n      }\n      const result = onConfirm();\n      if (!(result instanceof Promise)) {\n        handleCloseInternal();\n        return;\n      }\n      setConfirmLoading(true);\n      try {\n        await result;\n        handleCloseInternal();\n      } catch (err) {\n        // No cerrar el modal en caso de error — el consumer es responsable\n        // de mostrar un estado de error en su UI. Logueamos para trazabilidad\n        // en dev.\n        // eslint-disable-next-line no-console\n        console.error('Modal onConfirm failed:', err);\n      } finally {\n        setConfirmLoading(false);\n      }\n    };\n\n    const theme = useTheme();\n    const isMobile = useMediaQuery(theme.breakpoints.down('sm'));\n\n    const getWidth = () => {\n      if (isMobile) return '95%';\n      switch (maxWidth) {\n        case 'xs':\n          return 300;\n        case 'sm':\n          return 500;\n        case 'md':\n          return 700;\n        case 'lg':\n          return 900;\n        case 'xl':\n          return 1100;\n        case false:\n          return 'auto';\n        default:\n          // Soporta string custom: `maxWidth=\"600px\"` se pasa tal cual.\n          return typeof maxWidth === 'string' ? maxWidth : 500;\n      }\n    };\n\n    // Base sx del Paper + width responsive; el consumer puede pisarlos via `paperSx`.\n    const paperBaseSx: SxProps<Theme> = { ...modalStyle, width: getWidth() };\n    const mergedPaperSx = mergeSx(paperBaseSx, paperSx);\n\n    // ── Render modo CONFIRM ─────────────────────────────────────────────\n    if (mode === 'confirm') {\n      const config = severityConfig[severity];\n      const message = confirmMessage ?? children;\n\n      return (\n        <MuiModal\n          open={isOpen}\n          onClose={handleCloseInternal}\n          aria-labelledby={title ? titleId : undefined}\n          aria-describedby={message ? descId : undefined}\n          closeAfterTransition\n          sx={sx}\n        >\n          <Paper className={className} sx={mergedPaperSx}>\n            <Stack spacing={2.5} sx={{ p: 3, alignItems: 'center', textAlign: 'center' }}>\n              <Box\n                sx={{\n                  width: 72,\n                  height: 72,\n                  borderRadius: '50%',\n                  backgroundColor: (t) => t.palette[config.paletteKey].light,\n                  color: (t) => t.palette[config.paletteKey].dark,\n                  display: 'flex',\n                  alignItems: 'center',\n                  justifyContent: 'center',\n                  opacity: 0.9,\n                }}\n              >\n                {config.icon}\n              </Box>\n              {title && (\n                <Typography id={titleId} variant=\"h6\" component=\"h2\" sx={{ fontWeight: 700 }}>\n                  {title}\n                </Typography>\n              )}\n              {message && (\n                <Typography id={descId} variant=\"body2\" color=\"text.secondary\">\n                  {message}\n                </Typography>\n              )}\n            </Stack>\n            <ModalFooter\n              showCloseButton={showCloseButton}\n              closeButtonText={closeButtonText}\n              closeButtonDisabled={closeButtonDisabled || confirmLoading}\n              onClose={handleCloseInternal}\n              actions={[\n                {\n                  text: confirmText,\n                  onClick: handleConfirm,\n                  disabled: confirmDisabled || confirmLoading,\n                  variant: 'contained',\n                  color: config.color,\n                },\n              ]}\n            />\n          </Paper>\n        </MuiModal>\n      );\n    }\n\n    // ── Render modo DEFAULT (compuesto) ─────────────────────────────────\n    const renderChildren = () => {\n      let header: ReactNode | null = null;\n      let body: ReactNode | null = null;\n      let footer: ReactNode | null = null;\n\n      Children.forEach(children, (child) => {\n        if (!isValidElement(child)) return;\n\n        if (isModalSlot(child, ModalHeader, 'ModalHeader')) {\n          const headerChild = child as ReactElement<{ id?: string }>;\n          header = cloneElement(headerChild, { id: titleId, ...headerChild.props });\n        } else if (isModalSlot(child, ModalBody, 'ModalBody')) {\n          const bodyChild = child as ReactElement<{ id?: string }>;\n          body = cloneElement(bodyChild, { id: descId, ...bodyChild.props });\n        } else if (isModalSlot(child, ModalFooter, 'ModalFooter')) {\n          const footerChild = child as ReactElement<ModalFooterProps>;\n          // Props del child ganan sobre los del Modal padre: si el consumer\n          // declara `<Modal.Footer showCloseButton={false}>`, ese valor se\n          // respeta. Solo los que vengan `undefined` caen al default del padre.\n          const childProps = footerChild.props;\n          footer = cloneElement(footerChild, {\n            showCloseButton: childProps.showCloseButton ?? showCloseButton,\n            closeButtonText: childProps.closeButtonText ?? closeButtonText,\n            closeButtonDisabled: childProps.closeButtonDisabled ?? closeButtonDisabled,\n            onClose: childProps.onClose ?? handleCloseInternal,\n            actions: childProps.actions ?? actions,\n          });\n        }\n      });\n\n      if (!footer && !hiddenFooter) {\n        footer = (\n          <ModalFooter\n            showCloseButton={showCloseButton}\n            closeButtonText={closeButtonText}\n            closeButtonDisabled={closeButtonDisabled}\n            onClose={handleCloseInternal}\n            actions={actions}\n          />\n        );\n      }\n\n      return (\n        <>\n          {!hiddenHeader && (header || (title && <ModalHeader id={titleId}>{title}</ModalHeader>))}\n          {!hiddenBody && body}\n          {footer}\n        </>\n      );\n    };\n\n    return (\n      <MuiModal\n        open={isOpen}\n        onClose={handleCloseInternal}\n        aria-labelledby={titleId}\n        aria-describedby={descId}\n        closeAfterTransition\n        sx={sx}\n      >\n        <Paper className={className} sx={mergedPaperSx}>\n          {renderChildren()}\n        </Paper>\n      </MuiModal>\n    );\n  },\n);\n\nModal.displayName = 'Modal';\n\n// Define los sub-componentes como propiedades estáticas con tipos explícitos\ntype ModalComponent = ReturnType<typeof forwardRef<ModalRef, ModalProps>> & {\n  Header: typeof ModalHeader;\n  Body: typeof ModalBody;\n  Footer: typeof ModalFooter;\n};\n\nconst ModalWithStatics = Modal as ModalComponent;\n\nModalWithStatics.Header = ModalHeader;\nModalWithStatics.Body = ModalBody;\nModalWithStatics.Footer = ModalFooter;\n\nexport default ModalWithStatics;\n"],"names":["MuiModal"],"mappings":"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"}

package/dist/README.md

@@ -0,0 +1,243 @@
+# @soyfri/shared-library
+
+Una librería de componentes React reutilizables construida con Material-UI, TypeScript y Tailwind CSS, diseñada para proporcionar componentes UI consistentes y bien documentados.
+
+## 📋 Tabla de Contenidos
+
+- [Características](#características)
+- [Instalación](#instalación)
+- [Uso](#uso)
+- [Componentes Disponibles](#componentes-disponibles)
+- [Desarrollo](#desarrollo)
+- [Scripts Disponibles](#scripts-disponibles)
+- [Storybook](#storybook)
+- [Testing](#testing)
+- [Tecnologías](#tecnologías)
+- [Estructura del Proyecto](#estructura-del-proyecto)
+
+## ✨ Características
+
+- 🎨 **Componentes tipados**: Todos los componentes están construidos con TypeScript para mayor seguridad de tipos
+- 📚 **Documentación con Storybook**: Cada componente incluye historias interactivas y documentación
+- 🎯 **Material-UI**: Basado en Material-UI para un diseño consistente y accesible
+- 🌈 **Tailwind CSS**: Integración con Tailwind para estilos utilitarios
+- 🧪 **Testing**: Configurado con Vitest y Playwright para testing de componentes
+- 📦 **Build optimizado**: Configuración con Rollup para generar builds ESM y CommonJS
+
+## 📦 Instalación
+
+```bash
+npm install @soyfri/shared-library
+```
+
+## 🚀 Uso
+
+```tsx
+import { Button, Table, Select } from '@soyfri/shared-library';
+import '@soyfri/shared-library/dist/styles.css';
+
+function App() {
+  return (
+    <div>
+      <Button variant="contained" color="primary">
+        Mi Botón
+      </Button>
+    </div>
+  );
+}
+```
+
+## 🧩 Componentes Disponibles
+
+### Button
+Componente de botón personalizable basado en Material-UI con soporte para iconos, diferentes tamaños y estados.
+
+**Características:**
+- Variantes: `text`, `outlined`, `contained`
+- Tamaños: `small`, `medium`, `large`
+- Soporte para iconos de inicio y fin
+- Estados de carga
+- Completamente tipado
+
+### Table
+Componente de tabla flexible con paginación interna y externa, ordenamiento y renderizado personalizado de columnas.
+
+**Características:**
+- Paginación interna automática
+- Paginación externa controlada
+- Columnas personalizables con renderizado custom
+- Soporte para componentes complejos en celdas
+- Completamente tipado con generics
+
+### Select
+Componente select avanzado con soporte para selección múltiple, filtros, agrupación y renderizado personalizado.
+
+**Características:**
+- Selección simple y múltiple
+- Filtrado de opciones
+- Agrupación de opciones
+- Renderizado personalizado con avatars
+- Placeholder configurable
+
+### Avatar
+Componente para mostrar avatares de usuarios con soporte para imágenes y texto.
+
+### Icon
+Wrapper para iconos de Material-UI con propiedades consistentes.
+
+### Stat
+Componente para mostrar estadísticas con diferentes plantillas de visualización.
+
+**Características:**
+- Plantilla simple
+- Plantilla con chip
+- Plantilla con lista de chips
+- Colores personalizables
+
+### Column
+Componente auxiliar para definir columnas en el componente Table.
+
+## 🛠️ Desarrollo
+
+### Prerrequisitos
+
+- Node.js (versión 18 o superior)
+- npm o yarn
+
+### Configuración del entorno de desarrollo
+
+1. Clona el repositorio:
+```bash
+git clone <repository-url>
+cd shared-library
+```
+
+2. Instala las dependencias:
+```bash
+npm install
+```
+
+3. Inicia el entorno de desarrollo:
+```bash
+npm run dev
+```
+
+## 📜 Scripts Disponibles
+
+- `npm run build` - Construye la librería para producción
+- `npm run dev` - Inicia el modo de desarrollo con watch
+- `npm run build:css` - Construye los estilos CSS
+- `npm run watch:css` - Observa cambios en los estilos CSS
+- `npm run clean` - Limpia la carpeta dist
+- `npm run prepare` - Limpia y construye la librería
+- `npm run storybook` - Inicia Storybook en modo desarrollo
+- `npm run build-storybook` - Construye Storybook para producción
+- `npm run dist` - Ejecuta el script de distribución personalizado
+
+## 📚 Storybook
+
+La librería incluye Storybook para documentación interactiva y desarrollo de componentes.
+
+### Iniciar Storybook
+
+```bash
+npm run storybook
+```
+
+Esto abrirá Storybook en `http://localhost:6006` donde podrás:
+
+- Ver todos los componentes disponibles
+- Interactuar con las propiedades de cada componente
+- Ver ejemplos de uso
+- Acceder a la documentación detallada
+
+### Construir Storybook
+
+```bash
+npm run build-storybook
+```
+
+## 🧪 Testing
+
+La librería está configurada con Vitest y Playwright para testing de componentes.
+
+### Configuración de Testing
+
+- **Vitest**: Para unit tests y testing de componentes
+- **Playwright**: Para testing de browser
+- **Storybook Test Addon**: Para testing de historias de Storybook
+
+## 🔧 Tecnologías
+
+### Dependencias Principales
+
+- **React 19.1.0**: Librería de UI
+- **Material-UI 7.1.0**: Sistema de diseño y componentes
+- **TypeScript 5.8.3**: Tipado estático
+- **Tailwind CSS 4.1.7**: Framework de CSS utilitario
+
+### Herramientas de Desarrollo
+
+- **Storybook 9.0.8**: Documentación y desarrollo de componentes
+- **Rollup**: Bundler para la construcción de la librería
+- **Vitest**: Framework de testing
+- **Playwright**: Testing de browser
+- **Prettier**: Formateo de código
+
+## 📁 Estructura del Proyecto
+
+```
+shared-library/
+├── .storybook/          # Configuración de Storybook
+├── src/
+│   ├── components/      # Componentes de la librería
+│   │   ├── Avatar/
+│   │   ├── Button/
+│   │   ├── Column/
+│   │   ├── Icon/
+│   │   ├── Select/
+│   │   ├── Stat/
+│   │   └── Table/
+│   ├── index.ts         # Punto de entrada principal
+│   └── styles.css       # Estilos globales
+├── dist/                # Archivos construidos
+├── package.json
+├── tsconfig.json
+├── tailwind.config.js
+├── rollup.config.cjs
+└── vitest.config.ts
+```
+
+### Estructura de Componentes
+
+Cada componente sigue una estructura consistente:
+
+```
+ComponentName/
+├── ComponentName.tsx        # Implementación del componente
+├── ComponentName.stories.tsx # Historias de Storybook
+├── ComponentName.definition.ts # Definiciones de código (opcional)
+├── index.ts                 # Exportaciones
+└── types.ts                 # Tipos específicos (opcional)
+```
+
+## 🤝 Contribución
+
+Para contribuir al proyecto:
+
+1. Fork el repositorio
+2. Crea una rama para tu feature (`git checkout -b feature/nueva-funcionalidad`)
+3. Commit tus cambios (`git commit -am 'Agrega nueva funcionalidad'`)
+4. Push a la rama (`git push origin feature/nueva-funcionalidad`)
+5. Crea un Pull Request
+
+## 📄 Licencia
+
+ISC License
+
+---
+
+**Versión actual:** 1.0.1
+
+Para más información y ejemplos detallados, consulta la documentación en Storybook ejecutando `npm run storybook`.
+