@m4l/components 9.0.0 → 9.1.0

package/components/mui_extended/Tab/Tab.js

@@ -0,0 +1,67 @@
+import { jsx } from "react/jsx-runtime";
+import { clsx } from "clsx";
+import { useModuleSkeleton, getPropertyByString } from "@m4l/core";
+import { useTheme } from "@mui/material";
+import { a as TYPOGRAPHY_KEY, b as TAB_SPECIFY, I as ICON_KEY } from "./constants.js";
+import { useRef, useMemo } from "react";
+import { u as useComponentSize } from "../../../hooks/useComponentSize/useComponentSize.js";
+import { R as RootStyled, T as TypographyStyled, I as IconStyled } from "./Slots/TabSlots.js";
+function Tab(props) {
+  const {
+    SKTWidth,
+    SKTHeight,
+    size = "medium",
+    // Tamaño del tab, por defecto 'medium'.
+    disabled,
+    // Indica si el tab está deshabilitado.
+    label,
+    // Texto que se muestra en el tab.
+    urlIcon,
+    // URL del icono a mostrar en el tab.
+    value,
+    ...other
+    // Otras propiedades que se pasan al componente.
+  } = props;
+  const refMuiTab = useRef(null);
+  const isSelected = useMemo(() => {
+    if (refMuiTab.current) {
+      return refMuiTab.current?.classList?.contains("Mui-selected");
+    }
+    return false;
+  }, [refMuiTab.current]);
+  const { currentSize } = useComponentSize(size);
+  const adjustedSize = currentSize === "small" || currentSize === "medium" ? currentSize : "medium";
+  const isSkeleton = useModuleSkeleton();
+  const theme = useTheme();
+  const paletteColor = getPropertyByString(theme.vars.palette, disabled || !isSelected || isSkeleton ? "default" : "primary", theme.vars.palette.default);
+  const OwnerState = {
+    paletteColor,
+    size: adjustedSize,
+    disabled,
+    skeleton: isSkeleton
+  };
+  return /* @__PURE__ */ jsx(
+    RootStyled,
+    {
+      ref: refMuiTab,
+      label: label ? /* @__PURE__ */ jsx(TypographyStyled, { className: clsx(TYPOGRAPHY_KEY, TAB_SPECIFY), skeletonWidth: 40, ownerState: { OwnerState }, variant: "body", children: label }) : void 0,
+      disabled,
+      ownerState: { ...OwnerState },
+      icon: urlIcon ? /* @__PURE__ */ jsx(
+        IconStyled,
+        {
+          className: clsx(ICON_KEY, TAB_SPECIFY),
+          ownerState: { OwnerState },
+          src: urlIcon,
+          size
+        }
+      ) : void 0,
+      value,
+      tabIndex: 0,
+      ...other
+    }
+  );
+}
+export {
+  Tab as T
+};

package/components/mui_extended/Tab/Tab.styles.d.ts

@@ -0,0 +1,5 @@
+import { TabStyles } from './types';
+/**
+ * Estilos personalizados para el componente Tab de Material-UI.
+ */
+export declare const tabStyles: TabStyles;

package/components/mui_extended/Tab/Tab.styles.js

@@ -0,0 +1,147 @@
+const tabStyles = {
+  /**
+   * Slot Raíz: Estilos para el contenedor principal del componente Tab.
+   */
+  root: ({ theme, ownerState }) => ({
+    // Estructura y layout básico
+    display: "flex",
+    flexDirection: "row",
+    alignItems: "center",
+    width: "fit-content",
+    minHeight: "fit-content",
+    minWidth: "fit-content",
+    gap: theme.vars.size.baseSpacings.sp1,
+    opacity: 1,
+    overflow: "visible",
+    // Bordes y radio de borde
+    border: theme.vars.size.borderStroke.container,
+    borderColor: "transparent",
+    borderBottom: 0,
+    borderTopLeftRadius: `calc(${theme.vars.size.borderRadius.r1} - 1px)`,
+    borderTopRightRadius: `calc(${theme.vars.size.borderRadius.r1} - 1px)`,
+    boxSizing: "border-box",
+    // Padding
+    paddingTop: 0,
+    paddingBottom: 0,
+    paddingLeft: theme.vars.size.baseSpacings.sp2,
+    paddingRight: theme.vars.size.baseSpacings.sp2,
+    position: "relative",
+    // Altura para vista móvil y de escritorio basada en el tamaño
+    ...theme.generalSettings.isMobile ? {
+      ...ownerState.size === "medium" && {
+        height: theme.vars.size.mobile.medium.container
+      },
+      ...ownerState.size === "small" && {
+        height: theme.vars.size.mobile.small.container
+      }
+    } : {
+      ...ownerState.size === "medium" && {
+        height: theme.vars.size.desktop.medium.container
+      },
+      ...ownerState.size === "small" && {
+        height: theme.vars.size.desktop.small.container
+      }
+    },
+    // Ajuste de alineación del icono
+    "& .MuiTab-iconWrapper": {
+      marginBottom: 1
+    },
+    /**
+     * **Pseudoclases**:
+     * - Estilos para los estados hover, focus-visible y active.
+     */
+    "&:hover": {
+      background: theme.vars.palette.background.hover
+    },
+    "&:focus-visible": {
+      background: ownerState.paletteColor?.hoverOpacity,
+      "&::before": {
+        content: '""',
+        position: "absolute",
+        top: `-${theme.size.baseSpacings.sp1}`,
+        left: `-${theme.size.baseSpacings.sp1}`,
+        right: `-${theme.size.baseSpacings.sp1}`,
+        bottom: 0,
+        boxSizing: "border-box",
+        border: theme.vars.size.borderStroke.container,
+        borderBottom: 0,
+        borderColor: theme.vars.palette.border.main,
+        borderRadius: theme.vars.size.borderRadius.r1,
+        borderBottomRightRadius: 0,
+        borderBottomLeftRadius: 0
+      }
+    },
+    "&:active": {
+      background: ownerState.paletteColor?.activeOpacity
+    },
+    /**
+     * **Estado Seleccionado**:
+     * - Estilos aplicados cuando la pestaña está en estado seleccionado (`.Mui-selected`).
+     * - Incluye estilos específicos para el icono y la tipografía.
+     */
+    "&.Mui-selected": {
+      border: theme.vars.size.borderStroke.container,
+      borderColor: theme.vars.palette.border.secondary,
+      borderBottom: 0,
+      ".icon.M4lclassCssSpecificity div": {
+        backgroundColor: !ownerState.disabled ? ownerState.paletteColor?.main : theme.vars.palette.text.secondary
+      },
+      "span": {
+        color: !ownerState.disabled ? ownerState.paletteColor?.main : theme.vars.palette.text.secondary
+      },
+      // Efecto ripple en estado seleccionado
+      "& .MuiTouchRipple-root": {
+        borderTopLeftRadius: theme.vars.size.baseSpacings["sp0-5"],
+        borderTopRightRadius: theme.vars.size.baseSpacings["sp0-5"]
+      },
+      "&::after": {
+        content: '""',
+        width: "70%",
+        transform: "translateX(20%)",
+        height: theme.vars.size.borderRadius["r0-5"],
+        left: 0,
+        top: -1,
+        backgroundColor: ownerState.skeleton ? theme.vars.palette.background.surface : ownerState.disabled ? theme.vars.palette.background.surface : ownerState.paletteColor?.main,
+        borderEndStartRadius: theme.vars.size.borderRadius["r0-5"],
+        borderEndEndRadius: theme.vars.size.borderRadius["r0-5"],
+        position: "absolute"
+      }
+    },
+    "&.Mui-selected:hover": {
+      backgroundColor: ownerState.paletteColor?.hoverOpacity
+    },
+    "&.Mui-selected:active": {
+      background: ownerState.paletteColor?.activeOpacity,
+      ".icon.M4lclassCssSpecificity div": {
+        backgroundColor: ownerState.paletteColor?.active
+      },
+      "span": {
+        color: ownerState.paletteColor?.active
+      },
+      "&::after": {
+        background: ownerState.paletteColor?.active
+      }
+    }
+  }),
+  /**
+   * Slot de Icono:
+   * - **Estilos Generales**: Configura el color base del ícono, con especificidad adicional para clases específicas.
+   */
+  icon: ({ theme }) => ({
+    "&.M4lclassCssSpecificity div": {
+      backgroundColor: theme.vars.palette.text.secondary
+    }
+  }),
+  /**
+   * Slot de Tipografía:
+   * - **Estilos Generales**: Configura el color base del texto, aplicando especificidad para clases específicas.
+   */
+  tipography: ({ theme }) => ({
+    "&.M4lclassCssSpecificity": {
+      color: theme.vars.palette.text.secondary
+    }
+  })
+};
+export {
+  tabStyles as t
+};

package/components/mui_extended/Tab/constants.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Nombre de clase que se usa para dar identidad a los slots del componente.
+ */
+export declare const TAB_KEY_COMPONENT = "M4LTab";
+/**
+ * Nombre de clase creado para aportar especificidad a los estilos del componente. Es usado para sobreescribir los estilos de MUI sin
+ * tener la necesidad de agregar valores en !important.
+ */
+export declare const TAB_SPECIFY = "M4lclassCssSpecificity";
+/**
+ *
+ */
+export declare const TYPOGRAPHY_KEY = "tipography";
+export declare const ICON_KEY = "icon";

package/components/mui_extended/Tab/constants.js

@@ -0,0 +1,10 @@
+const TAB_KEY_COMPONENT = "M4LTab";
+const TAB_SPECIFY = "M4lclassCssSpecificity";
+const TYPOGRAPHY_KEY = "tipography";
+const ICON_KEY = "icon";
+export {
+  ICON_KEY as I,
+  TAB_KEY_COMPONENT as T,
+  TYPOGRAPHY_KEY as a,
+  TAB_SPECIFY as b
+};

package/components/mui_extended/Tab/index.d.ts

@@ -1,5 +1 @@
-import { TabProps } from './types';
-/**
- * TODO: Documentar
- */
-export declare function Tab(props: TabProps): import("react/jsx-runtime").JSX.Element;
+export * from './Tab';

package/components/mui_extended/Tab/types.d.ts

@@ -1,6 +1,57 @@
-import { TabProps as MUITabProps } from '@mui/material';
-export interface TabProps extends MUITabProps {
+import { TabProps as MUITabProps, PaletteColor, Theme } from '@mui/material';
+import { OverridesStyleRules } from '@mui/material/styles/overrides';
+import { Sizes } from '@m4l/styles';
+import { TabSlots } from './Slots/TabEnum';
+import { TAB_KEY_COMPONENT } from './constants';
+/**
+ * Propiedades personalizadas para el componente `Tab`, extendiendo algunas propiedades de MUI.
+ */
+export interface TabProps extends Omit<MUITabProps, 'size' | 'label' | 'color'> {
+    /**
+     * Anchura del componente en estado Skeleton.
+     * Puede ser un valor numérico o un string con unidades CSS (por ejemplo, `px`, `%`, etc.).
+     */
     SKTWidth: string | number;
+    /**
+     * Altura del componente en estado Skeleton.
+     * Puede ser un valor numérico o un string con unidades CSS (por ejemplo, `px`, `%`, etc.).
+     */
     SKTHeight: string | number;
+    /**
+     * Identificador único para pruebas unitarias.
+     */
     dataTestId?: string;
+    /**
+     * Tamaño del `Tab`, limitado a los valores `small` o `medium`.
+     */
+    size?: Extract<Sizes, 'small' | 'medium'>;
+    /**
+     * URL del icono a mostrar en el `Tab`.
+     */
+    urlIcon?: string;
+    /**
+     * Texto a mostrar en el `Tab`.
+     */
+    label?: string;
 }
+/**
+ * Tipo de slot del `Tab`, basado en las opciones definidas en `TabSlots`.
+ */
+export type TabSlotsType = keyof typeof TabSlots;
+/**
+ * Estado interno del propietario del `Tab`.
+ */
+export interface TabOwnerState extends Pick<TabProps, 'size' | 'disabled'> {
+    /**
+     * Indica si el `Tab` está en estado Skeleton.
+     */
+    skeleton: boolean;
+    /**
+     * Color de la paleta asociado al `Tab`.
+     */
+    paletteColor: PaletteColor;
+}
+/**
+ * Estilos personalizados para el `Tab`, sobreescribiendo las reglas de estilo.
+ */
+export type TabStyles = Partial<OverridesStyleRules<TabSlots, typeof TAB_KEY_COMPONENT, Theme> | undefined> | undefined;

package/components/mui_extended/TextField/slots/TextFieldEnum.d.ts

@@ -1,5 +1,5 @@
 export declare enum TextFieldSlots {
-    muiTextFieldStyled = "muiTextFieldStyled",
+    root = "root",
     textFieldRootStyled = "textFieldRootStyled",
     muiSkeletonStyled = "muiSkeletonStyled"
 }

package/components/mui_extended/TextField/slots/TextFieldSlots.d.ts

@@ -1,13 +1,13 @@
 export declare const MuiTextFieldStyled: import('@emotion/styled').StyledComponent<Pick<{
     variant?: import('@mui/material').TextFieldVariants | undefined;
-} & Omit<import('@mui/material').FilledTextFieldProps | import('@mui/material').OutlinedTextFieldProps | import('@mui/material').StandardTextFieldProps, "variant">, "children" | "value" | "ref" | "title" | "component" | "size" | "name" | "error" | "select" | "rows" | "id" | "type" | "hidden" | "color" | "content" | "style" | "disabled" | "variant" | "margin" | "translate" | "sx" | "classes" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "autoCapitalize" | "autoFocus" | "className" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "enterKeyHint" | "lang" | "nonce" | "slot" | "spellCheck" | "tabIndex" | "radioGroup" | "role" | "about" | "datatype" | "inlist" | "prefix" | "property" | "rel" | "resource" | "rev" | "typeof" | "vocab" | "autoCorrect" | "autoSave" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-braillelabel" | "aria-brailleroledescription" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colindextext" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-description" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowindextext" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onResize" | "onResizeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerLeave" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "label" | "key" | "autoComplete" | "placeholder" | "required" | "fullWidth" | "inputProps" | "inputRef" | "SelectProps" | "multiline" | "maxRows" | "minRows" | "hiddenLabel" | "focused" | "InputProps" | "FormHelperTextProps" | "helperText" | "InputLabelProps"> & import('@mui/system').MUIStyledCommonProps<import('@mui/material').Theme> & Partial<import('../types').OwnerState> & Record<string, unknown> & {
-    ownerState: Partial<import('../types').OwnerState> & Record<string, unknown>;
+} & Omit<import('@mui/material').FilledTextFieldProps | import('@mui/material').OutlinedTextFieldProps | import('@mui/material').StandardTextFieldProps, "variant">, "children" | "value" | "ref" | "title" | "component" | "size" | "name" | "error" | "select" | "rows" | "id" | "type" | "hidden" | "color" | "content" | "style" | "disabled" | "variant" | "margin" | "translate" | "sx" | "classes" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "autoCapitalize" | "autoFocus" | "className" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "enterKeyHint" | "lang" | "nonce" | "slot" | "spellCheck" | "tabIndex" | "radioGroup" | "role" | "about" | "datatype" | "inlist" | "prefix" | "property" | "rel" | "resource" | "rev" | "typeof" | "vocab" | "autoCorrect" | "autoSave" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-braillelabel" | "aria-brailleroledescription" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colindextext" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-description" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowindextext" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onResize" | "onResizeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerLeave" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "label" | "key" | "autoComplete" | "placeholder" | "required" | "fullWidth" | "maxRows" | "focused" | "hiddenLabel" | "InputProps" | "FormHelperTextProps" | "helperText" | "InputLabelProps" | "inputProps" | "inputRef" | "multiline" | "minRows" | "SelectProps"> & import('@mui/system').MUIStyledCommonProps<import('@mui/material').Theme> & Partial<import('../types').TextFieldOwnerState> & Record<string, unknown> & {
+    ownerState: Partial<import('../types').TextFieldOwnerState> & Record<string, unknown>;
 }, {}, {}>;
-export declare const TextFieldRootStyled: import('@emotion/styled').StyledComponent<import('@mui/system').MUIStyledCommonProps<import('@mui/material').Theme> & Partial<import('../types').OwnerState> & Record<string, unknown> & {
-    ownerState: Partial<import('../types').OwnerState> & Record<string, unknown>;
+export declare const TextFieldRootStyled: import('@emotion/styled').StyledComponent<import('@mui/system').MUIStyledCommonProps<import('@mui/material').Theme> & Partial<import('../types').TextFieldOwnerState> & Record<string, unknown> & {
+    ownerState: Partial<import('../types').TextFieldOwnerState> & Record<string, unknown>;
 }, Pick<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, keyof import('react').HTMLAttributes<HTMLDivElement> | keyof import('react').ClassAttributes<HTMLDivElement>>, {}>;
 export declare const MuiSkeletonStyled: import('@emotion/styled').StyledComponent<Pick<import('@mui/material').SkeletonOwnProps & import('@mui/material/OverridableComponent').CommonProps & Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, "ref"> & {
     ref?: ((instance: HTMLSpanElement | null) => void | import('react').DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof import('react').DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | import('react').RefObject<HTMLSpanElement> | null | undefined;
-}, "children" | "style" | "variant" | "width" | "height" | "animation" | "sx" | "classes" | "className">, "children" | "ref" | "title" | "id" | "hidden" | "color" | "content" | "style" | "variant" | "width" | "height" | "translate" | "animation" | "sx" | "classes" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "autoCapitalize" | "autoFocus" | "className" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "enterKeyHint" | "lang" | "nonce" | "slot" | "spellCheck" | "tabIndex" | "radioGroup" | "role" | "about" | "datatype" | "inlist" | "prefix" | "property" | "rel" | "resource" | "rev" | "typeof" | "vocab" | "autoCorrect" | "autoSave" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-braillelabel" | "aria-brailleroledescription" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colindextext" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-description" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowindextext" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onResize" | "onResizeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerLeave" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "key"> & import('@mui/system').MUIStyledCommonProps<import('@mui/material').Theme> & Partial<import('../types').OwnerState> & Record<string, unknown> & {
-    ownerState: Partial<import('../types').OwnerState> & Record<string, unknown>;
+}, "children" | "style" | "variant" | "width" | "height" | "animation" | "sx" | "classes" | "className">, "children" | "ref" | "title" | "id" | "hidden" | "color" | "content" | "style" | "variant" | "width" | "height" | "translate" | "animation" | "sx" | "classes" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "autoCapitalize" | "autoFocus" | "className" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "enterKeyHint" | "lang" | "nonce" | "slot" | "spellCheck" | "tabIndex" | "radioGroup" | "role" | "about" | "datatype" | "inlist" | "prefix" | "property" | "rel" | "resource" | "rev" | "typeof" | "vocab" | "autoCorrect" | "autoSave" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-braillelabel" | "aria-brailleroledescription" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colindextext" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-description" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowindextext" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onResize" | "onResizeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerLeave" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "key"> & import('@mui/system').MUIStyledCommonProps<import('@mui/material').Theme> & Partial<import('../types').TextFieldOwnerState> & Record<string, unknown> & {
+    ownerState: Partial<import('../types').TextFieldOwnerState> & Record<string, unknown>;
 }, {}, {}>;

package/components/mui_extended/TextField/types.d.ts

@@ -4,7 +4,6 @@ import { TextFieldSlots } from './slots/TextFieldEnum';
 import { OverridesStyleRules } from '@mui/material/styles/overrides';
 import { TEXT_FIELD_KEY_COMPONENT } from './constants';
 import { ComponentPalletColor, Sizes } from '@m4l/styles';
-import { LabelProps } from '../../Label/types';
 /**
  * Variants for the TextField component.
  */
@@ -17,19 +16,64 @@ export type SkeletonVariants = 'rectangular' | 'circular' | 'text';
  * Props for the TextField component.
  *
  */
-export interface TextFieldProps extends Omit<MUITextFieldProps, 'size' | 'color' | 'disabled' | 'variant'>, Pick<LabelProps, 'helperMessage' | 'htmlFor' | 'id' | 'mandatory' | 'mandatoryMessage'> {
+export interface TextFieldProps extends Omit<MUITextFieldProps, 'size' | 'color' | 'disabled' | 'variant'> {
+    /**
+     * todo: documentar
+     */
     dataTestId?: string;
+    /**
+     * Variante del campo de texto.
+     * variant="text"
+     */
     variant?: TextFieldVariants;
+    /**
+     * Indica si el campo de texto está deshabilitado.
+     * disabled={true}
+     */
     disabled?: boolean;
-    size?: Sizes;
+    /**
+     * Tamaño del campo de texto.
+     * size="medium"
+     */
+    size?: Extract<Sizes, 'small' | 'medium'>;
+    /**
+     * Color del campo de texto.
+     * color="primary"
+     */
     color?: Extract<ComponentPalletColor, 'primary'>;
 }
-export type OwnerState = Pick<TextFieldProps, 'size' | 'color' | 'disabled' | 'error'> & {
-    disabled?: boolean;
-    paletteColor: PaletteColor;
-    variantTextField?: TextFieldVariants;
-    componentPaletteColor?: ComponentPalletColor;
-};
+/**
+ * Estado del propietario del campo de texto.
+ */
+export interface TextFieldOwnerState {
+    /**
+     * Indica si el campo de texto está deshabilitado.
+     */
+    textFieldDisabled?: boolean;
+    /**
+     * Color de la paleta del campo de texto.
+     */
+    textFieldPaletteColor: PaletteColor;
+    /**
+     * Variante del campo de texto.
+     */
+    textFieldVariant?: TextFieldVariants;
+    /**
+     * Color de la paleta del componente del campo de texto.
+     */
+    textFieldComponentPaletteColor?: ComponentPalletColor;
+    /**
+     * Tamaño del campo de texto.
+     */
+    textFieldSizes: Extract<Sizes, 'small' | 'medium'>;
+    /**
+     * Indica si el campo de texto es error.
+     */
+    textFieldError?: boolean;
+    /**
+     * Color del campo de texto.
+     */
+    textFieldColor?: Extract<ComponentPalletColor, 'primary'>;
+}
 export type TextFieldSlotsType = keyof typeof TextFieldSlots;
-export type TextFieldOwnerState = OwnerState;
 export type TextFieldStyles = Partial<OverridesStyleRules<TextFieldSlotsType, typeof TEXT_FIELD_KEY_COMPONENT, Theme> | undefined> | undefined;

package/components/mui_extended/index.d.ts

@@ -24,7 +24,7 @@ export * from './TabContent';
 export { Pager } from './Pager';
 export type { PagerProps } from './Pager/types';
 export { getPagerComponentsDictionary } from './Pager/dicctionary';
-export { Tab } from './Tab';
+export { Tab } from './Tab/Tab';
 export * from './TabContext';
 export * from './Typography/Typography';
 export * from './ToggleButton';

package/index.js

@@ -151,7 +151,7 @@ import { L as L9 } from "./components/mui_extended/LinkWithRoute/index.js";
 import { L as L10 } from "./components/mui_extended/LoadingButton/index.js";
 import { P as P13 } from "./components/mui_extended/Pager/index.js";
 import { g as g26 } from "./components/mui_extended/Pager/dicctionary.js";
-import { T as T5 } from "./components/mui_extended/Tab/index.js";
+import { T as T5 } from "./components/mui_extended/Tab/Tab.js";
 import { a as a9 } from "./components/mui_extended/MenuActions/dictionary.js";
 import { a as a10, M as M11 } from "./components/mui_extended/MenuActions/MenuActions.js";
 import { T as T6 } from "./components/mui_extended/Tooltip/Tooltip.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m4l/components",
-  "version": "9.0.0",
+  "version": "9.1.0",
   "license": "UNLICENSED",
   "lint-staged": {
     "*.{js,ts,tsx}": "eslint --fix --max-warnings 0"

package/storybook/components/extended/mui/Tab/stories/Tab.disable.stories.d.ts

@@ -0,0 +1,36 @@
+import { Meta, StoryObj } from '@storybook/react';
+import { Tab } from '../../../../../../src/components/mui_extended/Tab';
+/**
+ * Información meta para Storybook del componente `Tab`, en la variante deshabilitada.
+ */
+declare const meta: Meta<typeof Tab>;
+export default meta;
+type Story = StoryObj<typeof Tab>;
+/**
+ * Historia `Base`: Tab deshabilitado con icono, texto, y sin efecto ripple.
+ */
+export declare const Base: Story;
+/**
+ * Historia `DisabledActiveWithIconAndText`: Tab activo, deshabilitado, con icono y texto.
+ */
+export declare const DisabledActiveWithIconAndText: Story;
+/**
+ * Historia `DisabledActiveWithText`: Tab activo, deshabilitado, solo con texto.
+ */
+export declare const DisabledActiveWithText: Story;
+/**
+ * Historia `DisabledActiveWithIcon`: Tab activo, deshabilitado, solo con icono.
+ */
+export declare const DisabledActiveWithIcon: Story;
+/**
+ * Historia `DisabledDefaultWithIconAndText`: Tab por defecto, deshabilitado, con icono y texto.
+ */
+export declare const DisabledDefaultWithIconAndText: Story;
+/**
+ * Historia `DisabledDefaultActiveWithText`: Tab por defecto activo, deshabilitado, solo con texto.
+ */
+export declare const DisabledDefaultActiveWithText: Story;
+/**
+ * Historia `DisabledDefaultActiveWithIcon`: Tab por defecto activo, deshabilitado, solo con icono.
+ */
+export declare const DisabledDefaultActiveWithIcon: Story;

package/storybook/components/extended/mui/Tab/stories/Tab.enable.stories.d.ts

@@ -0,0 +1,36 @@
+import { Meta, StoryObj } from '@storybook/react';
+import { Tab } from '../../../../../../src/components/mui_extended/Tab';
+/**
+ * The Tab component groups related content, enabling navigation without leaving the page.
+ */
+declare const meta: Meta<typeof Tab>;
+export default meta;
+type Story = StoryObj<typeof Tab>;
+/**
+ * Base tab component with icon and text
+ */
+export declare const Base: Story;
+/**
+ * Active Tab with icon and text
+ */
+export declare const ActiveWithIconAndText: Story;
+/**
+ * Active Tab with text only
+ */
+export declare const ActiveWithText: Story;
+/**
+ * Active Tab with icon only
+ */
+export declare const ActiveWithIcon: Story;
+/**
+ * Default Tab with icon and text
+ */
+export declare const DefaultWithIconAndText: Story;
+/**
+ * Default active Tab with text only
+ */
+export declare const DefaultActiveWithText: Story;
+/**
+ * Default active Tab with icon only
+ */
+export declare const DefaultActiveWithIcon: Story;

package/storybook/components/extended/mui/Tab/stories/Tab.sizes.stories.d.ts

@@ -0,0 +1,28 @@
+import { Meta, StoryObj } from '@storybook/react';
+import { Tab } from '../../../../../../src/components/mui_extended/Tab';
+/**
+ * El componente Tab agrupa contenido relacionado y permite la navegación sin salir de la página.
+ */
+declare const meta: Meta<typeof Tab>;
+export default meta;
+type Story = StoryObj<typeof Tab>;
+/**
+ * Tab base con icono y tamaño mediano, estilo seleccionado (activo).
+ */
+export declare const Base: Story;
+/**
+ * Tab activo de tamaño pequeño con icono.
+ */
+export declare const SmallActive: Story;
+/**
+ * Tab activo de tamaño mediano con icono.
+ */
+export declare const MediumActive: Story;
+/**
+ * Tab por defecto de tamaño pequeño con icono.
+ */
+export declare const SmallDefault: Story;
+/**
+ * Tab por defecto de tamaño mediano con icono.
+ */
+export declare const MediumDefault: Story;