@m4l/components 8.1.0-beta.devManuela.TextField → 8.1.0

package/components/HelperError/HelperError.d.ts

@@ -7,7 +7,7 @@ import { HelperErrorProps } from './types';
  * @returns {JSX.Element} The rendered HelperError component.
  * @author Bruce Escobar - automatic
  * @createdAt 2024-10-22 09:42:38 - automatic
- * @updatedAt 2024-10-22 09:42:38 - automatic
+ * @updatedAt 2024-10-22 19:47:05 - automatic
  * @updatedUser Bruce Escobar - automatic
  */
 export declare const HelperError: (props: HelperErrorProps) => import("react/jsx-runtime").JSX.Element;

package/components/HelperError/HelperError.js

@@ -1,11 +1,30 @@
 import { jsx } from "react/jsx-runtime";
+import { useTheme } from "@mui/material";
+import { getPropertyByString } from "@m4l/core";
+import { clsx } from "clsx";
+import { H as HELPER_ERROR_SPINNER_SPECIFY } from "./constant.js";
+import { u as useComponentSize } from "../../hooks/useComponentSize/useComponentSize.js";
 import { T as TypographyStyled } from "./slots/HelperErrorSlots.js";
 const HelperError = (props) => {
-  const { message = "", skeletonWidth } = props;
+  const { message = "", skeletonWidth, size = "medium", className } = props;
+  const { currentSize } = useComponentSize(size);
+  const adjustedSize = currentSize === "small" || currentSize === "medium" ? currentSize : "medium";
+  const theme = useTheme();
+  const paletteColor = getPropertyByString(
+    theme.palette,
+    "error",
+    theme.palette.default
+  );
+  const ownerState = {
+    helperErrorPaletteColor: paletteColor,
+    helperErrorSizes: size
+  };
   return /* @__PURE__ */ jsx(
     TypographyStyled,
     {
-      ownerState: {},
+      className: clsx(HELPER_ERROR_SPINNER_SPECIFY, className),
+      ownerState: { ...ownerState, size: currentSize },
+      size: adjustedSize,
       variant: "body",
       skeletonWidth,
       children: message

package/components/HelperError/HelperError.styles.js

@@ -1,10 +1,15 @@
+import { H as HELPER_ERROR_SPINNER_SPECIFY } from "./constant.js";
 const helperErrorStyles = {
   /**
    * Estilos para el slot del root HelperError
+   * @author Bruce Escobar - automatic
+   * @createdAt 2024-10-22 19:27:21 - automatic
+   * @updatedAt 2024-10-22 19:47:05 - automatic
+   * @updatedUser Bruce Escobar - automatic
    */
   root: ({ theme, ownerState }) => ({
-    "& .MuiTypography-root": {
-      color: theme.vars.palette.error.main,
+    [`&.${HELPER_ERROR_SPINNER_SPECIFY}`]: {
+      color: ownerState.helperErrorPaletteColor?.main,
       ...ownerState.size === "small" && {
         ...theme.generalSettings.isMobile ? { height: theme.size.typography.mobile.small } : { height: theme.size.typography.desktop.small }
       },
@@ -15,6 +20,10 @@ const helperErrorStyles = {
   }),
   /**
    * Estilos personalizados Skeleton
+   * @author Bruce Escobar - automatic
+   * @createdAt 2024-10-22 19:27:21 - automatic
+   * @updatedAt 2024-10-22 19:47:05 - automatic
+   * @updatedUser Bruce Escobar - automatic
    */
   skeletonStyled: ({ theme, ownerState }) => ({
     ...ownerState.size === "small" && {

package/components/HelperError/constant.d.ts

@@ -1 +1,10 @@
+/**
+ * A constant representing the key for the M4L Helper Error component.
+ * This key is used to uniquely identify the Helper Error component within the application.
+ */
 export declare const HELPER_ERROR_KEY_COMPONENT = "M4LHelperError";
+/**
+ * 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 HELPER_ERROR_SPINNER_SPECIFY = "M4lclassCssSpecificity";

package/components/HelperError/constant.js

@@ -1,4 +1,6 @@
 const HELPER_ERROR_KEY_COMPONENT = "M4LHelperError";
+const HELPER_ERROR_SPINNER_SPECIFY = "M4lclassCssSpecificity";
 export {
-  HELPER_ERROR_KEY_COMPONENT as H
+  HELPER_ERROR_SPINNER_SPECIFY as H,
+  HELPER_ERROR_KEY_COMPONENT as a
 };

package/components/HelperError/slots/HelperErrorEnum.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Enum representing the different slots available for the HelperError component.
+ */
 export declare enum HelperErrorSlots {
     root = "root",
     skeletonStyled = "skeletonStyled"

package/components/HelperError/slots/HelperErrorSlots.d.ts

@@ -1,6 +1,6 @@
-export declare const TypographyStyled: import('@emotion/styled').StyledComponent<Pick<import('../../mui_extended/Typography/types').TypographyProps, keyof import('../../mui_extended/Typography/types').TypographyProps> & import('@mui/system').MUIStyledCommonProps<import('@mui/material/styles').Theme> & Partial<import('..').HelperErrorProps> & Record<string, unknown> & {
-    ownerState: Partial<import('..').HelperErrorProps> & Record<string, unknown>;
+export declare const TypographyStyled: import('@emotion/styled').StyledComponent<Pick<import('../../mui_extended/Typography/types').TypographyProps, keyof import('../../mui_extended/Typography/types').TypographyProps> & import('@mui/system').MUIStyledCommonProps<import('@mui/material/styles').Theme> & Partial<import('../types').HelperErrorOwnerState> & Record<string, unknown> & {
+    ownerState: Partial<import('../types').HelperErrorOwnerState> & Record<string, unknown>;
 }, {}, {}>;
-export declare const SkeletonStyled: import('@emotion/styled').StyledComponent<Pick<import('../../mui_extended/Skeleton/types').SkeletonProps, keyof import('../../mui_extended/Skeleton/types').SkeletonProps> & import('@mui/system').MUIStyledCommonProps<import('@mui/material/styles').Theme> & Partial<import('..').HelperErrorProps> & Record<string, unknown> & {
-    ownerState: Partial<import('..').HelperErrorProps> & Record<string, unknown>;
+export declare const SkeletonStyled: import('@emotion/styled').StyledComponent<Pick<import('../../mui_extended/Skeleton/types').SkeletonProps, keyof import('../../mui_extended/Skeleton/types').SkeletonProps> & import('@mui/system').MUIStyledCommonProps<import('@mui/material/styles').Theme> & Partial<import('../types').HelperErrorOwnerState> & Record<string, unknown> & {
+    ownerState: Partial<import('../types').HelperErrorOwnerState> & Record<string, unknown>;
 }, {}, {}>;

package/components/HelperError/slots/HelperErrorSlots.js

@@ -1,6 +1,6 @@
 import { styled } from "@mui/material/styles";
 import { H as HelperErrorSlots } from "./HelperErrorEnum.js";
-import { H as HELPER_ERROR_KEY_COMPONENT } from "../constant.js";
+import { a as HELPER_ERROR_KEY_COMPONENT } from "../constant.js";
 import { h as helperErrorStyles } from "../HelperError.styles.js";
 import { T as Typography } from "../../mui_extended/Typography/Typography.js";
 import { S as Skeleton } from "../../mui_extended/Skeleton/Skeleton.js";

package/components/HelperError/types.d.ts

@@ -1,10 +1,9 @@
-import { Theme } from '@mui/material';
+import { PaletteColor, Theme } from '@mui/material';
 import { TypographyProps } from '../mui_extended/Typography/types';
 import { HELPER_ERROR_KEY_COMPONENT } from './constant';
 import { HelperErrorSlots } from './slots';
 import { OverridesStyleRules } from '@mui/material/styles/overrides';
-import { Sizes } from '@m4l/styles';
-export type HelperErrorSize = 'small' | 'medium';
+import { ComponentPalletColor, Sizes } from '@m4l/styles';
 /**
  * Extiende de TypographyProps para incluir propiedades de esqueleto y añade la propiedad `message`.
  * `message` es el mensaje de error a mostrar.
@@ -14,13 +13,37 @@ export interface HelperErrorProps extends Pick<TypographyProps, 'skeletonWidth'>
      * Mensaje que se visualiza en el componente HelperError.
      */
     message: string | undefined;
-    size?: Sizes;
+    /**
+     * Propiedad que permite administrar estilos para su uso en los slots
+     */
+    className?: string;
+    /**
+     * Tamaño del componente, puede ser uno de los valores definidos en 'small' , 'medium'.
+     */
+    size?: Extract<Sizes, 'small' | 'medium'>;
 }
 /**
  * Representa el estado del componente HelperError, incluyendo todas las propiedades de HelperErrorProps.
  * Se utiliza para controlar el estilo del componente basado en su estado.
  */
-export type HelperErrorOwnerState = HelperErrorProps;
+export interface HelperErrorOwnerState {
+    /**
+     * Color de la paleta del campo de texto.
+     */
+    helperErrorPaletteColor: PaletteColor;
+    /**
+     * Color de la paleta del componente del campo de texto.
+     */
+    helperErrorComponentPaletteColor?: ComponentPalletColor;
+    /**
+     * Tamaño del campo de texto.
+     */
+    helperErrorSizes: Extract<Sizes, 'small' | 'medium'>;
+    /**
+     * Indica si el campo de texto es error.
+     */
+    helperStateError?: boolean;
+}
 /**
  * Define los tipos de slots disponibles en HelperError utilizando las claves de HelperErrorSlots.
  */

package/components/Icon/Icon.d.ts

@@ -1,8 +1,9 @@
 import { IconProps } from './types';
 /**
  * Provee de un medio por el cual se carga un icono svg en la plataforma web, aporta su versión provisional de carga en red.
- */
-/**
- * TODO: Documentar
+ * @author Bruce Escobar - automatic
+ * @createdAt 2024-10-22 19:08:59 - automatic
+ * @updatedAt 2024-10-22 19:09:00 - automatic
+ * @updatedUser Bruce Escobar - automatic
  */
 export declare const Icon: (props: IconProps) => import("react/jsx-runtime").JSX.Element;

package/components/Icon/Icon.js

@@ -1,17 +1,16 @@
-import { jsx, Fragment } from "react/jsx-runtime";
-import { T as TEST_PROP_ID } from "../../test/constants_no_mock.js";
-import { g as getNameDataTestId } from "../../test/getNameDataTestId.js";
+import { jsxs, Fragment, jsx } from "react/jsx-runtime";
+import { useModuleSkeleton } from "@m4l/core";
+import { a as getPropDataTestId } from "../../test/getNameDataTestId.js";
 import { I as ICON_PREFIX } from "./constants.js";
 import { u as useComponentSize } from "../../hooks/useComponentSize/useComponentSize.js";
-import { T as TooltipStyled, R as RootStyled, I as IconStyled } from "./slots/IconSlots.js";
+import { T as TooltipStyled, R as RootStyled, I as IconStyled, a as IconSkeletonStyled } from "./slots/IconSlots.js";
 import { I as IconSlots } from "./slots/IconEnum.js";
 const Icon = (props) => {
   const {
     src,
-    size = "small",
+    size = "medium",
     rotationAngle,
     tooltipContent,
-    securityArea,
     color = "text.primary",
     className,
     placement = "bottom",
@@ -19,72 +18,56 @@ const Icon = (props) => {
     disabled
   } = props;
   const { currentSize } = useComponentSize(size);
-  return /* @__PURE__ */ jsx(Fragment, { children: tooltipContent ? /* @__PURE__ */ jsx(
-    TooltipStyled,
-    {
-      title: tooltipContent,
-      ownerState: {},
-      placement,
-      ...process.env.NODE_ENV !== "production" ? {
-        [TEST_PROP_ID]: getNameDataTestId(
-          ICON_PREFIX,
-          IconSlots.tooltip,
-          instaceDataTestId
+  const isSkeleton = useModuleSkeleton();
+  const ownerState = {
+    iconSize: currentSize,
+    iconColor: color,
+    iconSrc: src,
+    iconDisabled: disabled,
+    iconRotationAngle: rotationAngle,
+    isSkeleton
+  };
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    tooltipContent ? /* @__PURE__ */ jsx(
+      TooltipStyled,
+      {
+        title: tooltipContent,
+        ownerState: { ...ownerState },
+        placement,
+        ...getPropDataTestId(ICON_PREFIX, IconSlots.tooltip, instaceDataTestId),
+        children: /* @__PURE__ */ jsx(
+          RootStyled,
+          {
+            className,
+            ownerState: { ...ownerState },
+            ...getPropDataTestId(ICON_PREFIX, IconSlots.root, instaceDataTestId),
+            children: /* @__PURE__ */ jsx(
+              IconStyled,
+              {
+                ownerState: { ...ownerState },
+                ...getPropDataTestId(ICON_PREFIX, IconSlots.icon, instaceDataTestId)
+              }
+            )
+          }
         )
-      } : {},
-      children: /* @__PURE__ */ jsx(
-        RootStyled,
-        {
-          className,
-          ownerState: { securityArea, size: currentSize },
-          ...process.env.NODE_ENV !== "production" ? {
-            [TEST_PROP_ID]: getNameDataTestId(ICON_PREFIX, IconSlots.root, instaceDataTestId)
-          } : {},
-          children: /* @__PURE__ */ jsx(
-            IconStyled,
-            {
-              ownerState: {
-                src,
-                rotationAngle,
-                size: currentSize,
-                disabled,
-                color
-              },
-              ...process.env.NODE_ENV !== "production" ? {
-                [TEST_PROP_ID]: getNameDataTestId(
-                  ICON_PREFIX,
-                  IconSlots.icon,
-                  instaceDataTestId
-                )
-              } : {}
-            }
-          )
-        }
-      )
-    }
-  ) : /* @__PURE__ */ jsx(
-    RootStyled,
-    {
-      className,
-      ownerState: { securityArea, size: currentSize },
-      ...process.env.NODE_ENV !== "production" ? { [TEST_PROP_ID]: getNameDataTestId(ICON_PREFIX, IconSlots.root, instaceDataTestId) } : {},
-      children: /* @__PURE__ */ jsx(
-        IconStyled,
-        {
-          ownerState: {
-            src,
-            rotationAngle,
-            size: currentSize,
-            color,
-            disabled
-          },
-          ...process.env.NODE_ENV !== "production" ? {
-            [TEST_PROP_ID]: getNameDataTestId(ICON_PREFIX, IconSlots.icon, instaceDataTestId)
-          } : {}
-        }
-      )
-    }
-  ) });
+      }
+    ) : /* @__PURE__ */ jsx(
+      RootStyled,
+      {
+        className,
+        ownerState: { ...ownerState },
+        ...getPropDataTestId(ICON_PREFIX, IconSlots.root, instaceDataTestId),
+        children: /* @__PURE__ */ jsx(
+          IconStyled,
+          {
+            ownerState: { ...ownerState },
+            ...getPropDataTestId(ICON_PREFIX, IconSlots.icon, instaceDataTestId)
+          }
+        )
+      }
+    ),
+    isSkeleton && /* @__PURE__ */ jsx(IconSkeletonStyled, { variant: "rectangular", ownerState: { ...ownerState } })
+  ] });
 };
 export {
   Icon as I

package/components/Icon/Icon.styles.js

@@ -1,54 +1,108 @@
 import { getPropertyByString } from "@m4l/core";
 const iconStyles = {
   /**
-   * TODO: Documentar
+   * Slot root: Contiene los estilos para el contenedor principal del ícono.
+   * Este slot es responsable de definir el layout del ícono dentro de su contenedor,
+   * incluyendo propiedades de flexbox para centrar su contenido, y el tamaño
+   * dinámico basado en el dispositivo (móvil o desktop) y el tamaño del ícono
+   * ('small' o 'medium'). También incluye animaciones como la transición
+   * suave de transformación.
+   * @author Bruce Escobar - automatic
+   * @createdAt 2024-10-22 19:08:59 - automatic
+   * @updatedAt 2024-10-22 19:09:00 - automatic
+   * @updatedUser Bruce Escobar - automatic
    */
   root: ({ theme, ownerState }) => ({
-    display: "flex",
+    display: ownerState.isSkeleton ? "none" : "flex",
     justifyContent: "center",
     alignItems: "center",
     width: "fit-content",
     transition: "transform 0.5s ease-in-out",
-    borderRadius: ownerState.skeleton ? "4px" : void 0,
-    backgroundColor: ownerState.skeleton ? `${theme.vars.palette.skeleton.default} !important` : void 0,
-    padding: ownerState.securityArea ? "8px" : "0px"
+    ...ownerState.iconSize === "medium" && {
+      ...theme.generalSettings.isMobile ? {
+        width: theme.vars.size.mobile.medium.base,
+        height: theme.vars.size.mobile.medium.base
+      } : {
+        width: theme.vars.size.desktop.medium.base,
+        height: theme.vars.size.desktop.medium.base
+      }
+    },
+    ...ownerState.iconSize === "small" && {
+      ...theme.generalSettings.isMobile ? {
+        width: theme.vars.size.mobile.small.base,
+        height: theme.vars.size.mobile.small.base
+      } : {
+        width: theme.vars.size.desktop.small.base,
+        height: theme.vars.size.desktop.small.base
+      }
+    }
   }),
-  tooltip: () => ({}),
   /**
-   * TODO: Documentar
+   * Slot icon: Define los estilos para el ícono que se carga dinámicamente.
+   * Este slot gestiona cómo se carga y muestra el recurso gráfico en formato de máscara,
+   * incluyendo su posición, repetición y ajuste de tamaño. También controla la rotación
+   * del ícono basada en el ángulo de rotación proporcionado, y el color de fondo que
+   * se ajusta de acuerdo con el estado de deshabilitación o no del ícono.
+   * @author Bruce Escobar - automatic
+   * @createdAt 2024-10-22 19:08:59 - automatic
+   * @updatedAt 2024-10-22 19:09:00 - automatic
+   * @updatedUser Bruce Escobar - automatic
    */
   icon: ({ theme, ownerState }) => ({
     maskPosition: "center",
     maskRepeat: "no-repeat",
     maskSize: "cover",
     WebkitMaskRepeat: "no-repeat",
-    mask: `url(${ownerState.src})`,
-    WebkitMask: `url(${ownerState.src})`,
+    mask: `url(${ownerState.iconSrc})`,
+    WebkitMask: `url(${ownerState.iconSrc})`,
     WebkitMaskSize: "cover",
-    ...ownerState.rotationAngle && {
-      transform: `rotate(${ownerState.rotationAngle}deg)`
-    },
-    backgroundColor: !ownerState.disabled ? getPropertyByString(theme.vars.palette, ownerState.color || "text.primary") : theme.vars.palette.text.disabled,
-    ...ownerState.size === "medium" && {
-      ...theme.generalSettings.isMobile ? {
-        minWidth: theme.vars.size.mobile.medium.action,
-        minHeight: theme.vars.size.mobile.medium.action
-      } : {
-        minWidth: theme.vars.size.desktop.medium.base,
-        minHeight: theme.vars.size.desktop.medium.base
-      }
-    },
-    ...ownerState.size === "small" && {
-      ...theme.generalSettings.isMobile ? {
-        minWidth: theme.vars.size.mobile.small.base,
-        minHeight: theme.vars.size.mobile.small.action
-      } : {
-        minWidth: theme.vars.size.desktop.small.base,
-        minHeight: theme.vars.size.desktop.small.base
-      }
+    ...ownerState.iconRotationAngle && {
+      transform: `rotate(${ownerState.iconRotationAngle}deg)`
     },
+    backgroundColor: !ownerState.iconDisabled ? getPropertyByString(theme.vars.palette, String(ownerState.iconColor) || "text.primary") : theme.vars.palette.text.disabled,
+    width: "inherit",
+    height: "inherit",
     variants: []
-  })
+  }),
+  /**
+   * Slot iconSkeleton: Define los estilos para el esqueleto del ícono.
+   * Se utiliza cuando el ícono aún no está completamente cargado, proporcionando
+   * un contorno visible para indicar que la carga está en progreso. Incluye un
+   * borde redondeado y tamaño del ícono.
+   * @author Bruce Escobar - automatic
+   * @createdAt 2024-10-22 19:08:59 - automatic
+   * @updatedAt 2024-10-22 19:09:00 - automatic
+   * @updatedUser Bruce Escobar - automatic
+   */
+  iconSkeleton: ({ theme, ownerState }) => ({
+    "&.M4lclassCssSpecificity": {
+      borderRadius: theme.size.borderRadius.r1,
+      ...ownerState.iconSize === "medium" && {
+        ...theme.generalSettings.isMobile ? {
+          width: theme.vars.size.mobile.medium.base,
+          height: theme.vars.size.mobile.medium.base
+        } : {
+          width: theme.vars.size.desktop.medium.base,
+          height: theme.vars.size.desktop.medium.base
+        }
+      },
+      ...ownerState.iconSize === "small" && {
+        ...theme.generalSettings.isMobile ? {
+          width: theme.vars.size.mobile.small.base,
+          height: theme.vars.size.mobile.small.base
+        } : {
+          width: theme.vars.size.desktop.small.base,
+          height: theme.vars.size.desktop.small.base
+        }
+      }
+    }
+  }),
+  /**
+   * Slot tooltip: Define los estilos para el tooltip asociado al ícono.
+   * Este slot permite agregar una descripción emergente cuando el ícono es
+   * hovereado o enfocado.
+   */
+  tooltip: {}
 };
 export {
   iconStyles as i

package/components/Icon/slots/IconEnum.d.ts

@@ -1,5 +1,6 @@
 export declare enum IconSlots {
     root = "root",
     tooltip = "tooltip",
-    icon = "icon"
+    icon = "icon",
+    iconSkeleton = "iconSkeleton"
 }

package/components/Icon/slots/IconEnum.js

@@ -2,6 +2,7 @@ var IconSlots = /* @__PURE__ */ ((IconSlots2) => {
   IconSlots2["root"] = "root";
   IconSlots2["tooltip"] = "tooltip";
   IconSlots2["icon"] = "icon";
+  IconSlots2["iconSkeleton"] = "iconSkeleton";
   return IconSlots2;
 })(IconSlots || {});
 export {

package/components/Icon/slots/IconSlots.d.ts

@@ -7,3 +7,6 @@ export declare const TooltipStyled: import('@emotion/styled').StyledComponent<Pi
 export declare const IconStyled: import('@emotion/styled').StyledComponent<import('@mui/system').MUIStyledCommonProps<import('@mui/material/styles').Theme> & Partial<import('..').IconOwnerState> & Record<string, unknown> & {
     ownerState: Partial<import('..').IconOwnerState> & 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 IconSkeletonStyled: import('@emotion/styled').StyledComponent<Pick<import('../../mui_extended/Skeleton/types').SkeletonProps, keyof import('../../mui_extended/Skeleton/types').SkeletonProps> & import('@mui/system').MUIStyledCommonProps<import('@mui/material/styles').Theme> & Partial<import('..').IconOwnerState> & Record<string, unknown> & {
+    ownerState: Partial<import('..').IconOwnerState> & Record<string, unknown>;
+}, {}, {}>;

package/components/Icon/slots/IconSlots.js

@@ -3,6 +3,7 @@ import { I as IconSlots } from "./IconEnum.js";
 import { a as ICON_KEY_COMPONENT } from "../constants.js";
 import { i as iconStyles } from "../Icon.styles.js";
 import { T as Tooltip } from "../../mui_extended/Tooltip/Tooltip.js";
+import { S as Skeleton } from "../../mui_extended/Skeleton/Skeleton.js";
 const RootStyled = styled("div", {
   name: ICON_KEY_COMPONENT,
   slot: IconSlots.root
@@ -15,8 +16,13 @@ const IconStyled = styled("div", {
   name: ICON_KEY_COMPONENT,
   slot: IconSlots.icon
 })(iconStyles?.icon);
+const IconSkeletonStyled = styled(Skeleton, {
+  name: ICON_KEY_COMPONENT,
+  slot: IconSlots.iconSkeleton
+})(iconStyles?.iconSkeleton);
 export {
   IconStyled as I,
   RootStyled as R,
-  TooltipStyled as T
+  TooltipStyled as T,
+  IconSkeletonStyled as a
 };

package/components/Icon/stories/DefaultWithProps/Icon.defaultWithProps.stories.d.ts

@@ -0,0 +1,35 @@
+import { Meta, StoryObj } from '@storybook/react/*';
+import { Icon } from '../../Icon';
+declare const meta: Meta<typeof Icon>;
+type Story = StoryObj<typeof Icon>;
+/**
+ * Estado base del icono con las propiedades por defecto.
+ * Este icono carga una imagen SVG.
+ */
+export declare const Base: Story;
+/**
+ * Icono renderizado con el color establecido en 'text.primary'.
+ * Este ejemplo ilustra cómo se puede estilizar el Icono con un color específico.
+ */
+export declare const WithColorTextPrimary: Story;
+/**
+ * Icono con una rotación aplicada.
+ * Demuestra el uso de la propiedad rotationAngle para manipular visualmente la orientación del icono.
+ */
+export declare const Rotation: Story;
+/**
+ * Icono que incluye un tooltip.
+ * Esta historia muestra la propiedad tooltipContent, que proporciona contexto adicional cuando el usuario pasa el cursor sobre el icono.
+ */
+export declare const WithTooltip: Story;
+/**
+ * Icono renderizado con el color establecido en 'contrast.text'.
+ * Este ejemplo muestra otra opción de estilización por color para el componente Icon.
+ */
+export declare const WithColorContrastText: Story;
+/**
+ * Icono con la propiedad deshabilitada.
+ * Este ejemplo demuestra cómo el Icono se puede renderizar en un estado deshabilitado, indicando visualmente que está inactivo.
+ */
+export declare const WithDisabled: Story;
+export default meta;

package/components/Icon/stories/Preset/Icon.preset.stories.d.ts

@@ -0,0 +1,16 @@
+import { Meta, StoryObj } from '@storybook/react/*';
+import { Icon } from '../../Icon';
+declare const meta: Meta<typeof Icon>;
+type Story = StoryObj<typeof Icon>;
+/**
+ * Estado base del icono con las propiedades por defecto.
+ * Este icono carga una imagen SVG.
+ */
+export declare const Base: Story;
+/**
+ * Icono con el color 'primary.main'.
+ * Este icono toma su color principal del tema definido en la aplicación.
+ * El color 'primary.main' generalmente se utiliza para representar la acción principal en la interfaz.
+ */
+export declare const WithColorPrimaryMain: Story;
+export default meta;

package/components/Icon/stories/Semantic/Icon.semantic.stories.d.ts

@@ -0,0 +1,30 @@
+import { Meta, StoryObj } from '@storybook/react/*';
+import { Icon } from '../../Icon';
+declare const meta: Meta<typeof Icon>;
+type Story = StoryObj<typeof Icon>;
+/**
+ * Estado base del icono con las propiedades por defecto.
+ * Este icono carga una imagen SVG.
+ */
+export declare const Base: Story;
+/**
+ * Icono con el color 'error.main'.
+ * Este icono se utiliza para denotar errores o advertencias críticas.
+ */
+export declare const WithColorErrorMain: Story;
+/**
+ * Icono con el color 'warning.main'.
+ * Se utiliza para representar advertencias o situaciones que requieren atención, pero no son críticas.
+ */
+export declare const WithColorWarningMain: Story;
+/**
+ * Icono con el color 'success.main'.
+ * Este icono representa estados exitosos o acciones completadas de forma correcta.
+ */
+export declare const WithColorSuccessMain: Story;
+/**
+ * Icono con el color 'info.main'.
+ * Utilizado para proporcionar información relevante o mensajes neutrales en la interfaz.
+ */
+export declare const WithColorInfoMain: Story;
+export default meta;

package/components/Icon/stories/Sizes/icon.sizes.stories.d.ts

@@ -0,0 +1,40 @@
+import { Meta, StoryObj } from '@storybook/react/*';
+import { Icon } from '../../Icon';
+declare const meta: Meta<typeof Icon>;
+type Story = StoryObj<typeof Icon>;
+/**
+ * Estado base del icono con las propiedades por defecto.
+ * Este icono carga una imagen SVG.
+ */
+export declare const Base: Story;
+/**
+ * Icono en tamaño 'small'.
+ * Este icono se ajusta a un tamaño pequeño, útil en componentes compactos o en interfaces móviles.
+ */
+export declare const Small: Story;
+/**
+ * Icono en tamaño 'medium'.
+ * Este tamaño es ideal para su uso en botones o como elemento destacado en la interfaz.
+ */
+export declare const Medium: Story;
+/**
+ * Icono en modo 'skeleton'.
+ * Esta es una representación temporal del icono mientras su contenido gráfico está siendo cargado.
+ */
+export declare const SkeletonIcon: {
+    parameters: {
+        isolationForceSkeleton: boolean;
+    };
+    args: {
+        src?: string | undefined;
+        size?: Extract<import('@m4l/styles').Sizes, "small" | "medium">;
+        rotationAngle?: number;
+        tooltipContent?: import('react').ReactNode;
+        color?: import('../..').IconColors;
+        className?: string;
+        instaceDataTestId?: string;
+        disabled?: boolean;
+        placement?: "bottom-end" | "bottom-start" | "bottom" | "left-end" | "left-start" | "left" | "right-end" | "right-start" | "right" | "top-end" | "top-start" | "top";
+    };
+};
+export default meta;