@m4l/components 9.3.34-JT25112025.beta.3 → 9.3.34-JT26112025.beta.1

package/components/formatters/ImageFormatter/ImageFormatter.d.ts

@@ -0,0 +1,10 @@
+import { ImageFormatterProps } from './types';
+/**
+ * ImageFormatter
+ * Componente para formatear y mostrar una imagen con texto opcional.
+ * Fuerza enableIntersectionObserver a false ya que se usa en contextos donde
+ * el lazy loading es manejado por el contenedor padre (ej. DataGrid).
+ * @param {ImageFormatterProps} props - Las propiedades del componente.
+ * @returns JSX.Element
+ */
+export declare function ImageFormatter(props: ImageFormatterProps): import("react/jsx-runtime").JSX.Element;

package/components/formatters/ImageFormatter/ImageFormatter.js

@@ -0,0 +1,72 @@
+import { jsxs, Fragment, jsx } from "react/jsx-runtime";
+import { useMemo } from "react";
+import { I as ImageStyled, T as TextImageStyled, R as RootStyled } from "./slots/ImageFormatterSlots.js";
+import { I as ImageFormatterSlots } from "./slots/ImageFormatterEnum.js";
+import clsx from "clsx";
+import { a as getComponentSlotRoot } from "../../../utils/getComponentSlotRoot.js";
+import { a as getPropDataTestId } from "../../../test/getNameDataTestId.js";
+import { I as IMAGE_FORMATTER_KEY_COMPONENT } from "./constants.js";
+function ImageFormatter(props) {
+  const { src, alt, text, width, height, cover, dataTestId, className } = props;
+  const ownerState = useMemo(
+    () => ({
+      width,
+      height,
+      hasDefinedSize: width !== void 0 && height !== void 0,
+      cover
+    }),
+    [width, height, cover]
+  );
+  const content = useMemo(() => {
+    return /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx(
+        ImageStyled,
+        {
+          ownerState,
+          ...getPropDataTestId(
+            IMAGE_FORMATTER_KEY_COMPONENT,
+            ImageFormatterSlots.image,
+            dataTestId
+          ),
+          src,
+          alt,
+          width,
+          height,
+          cover,
+          enableIntersectionObserver: false
+        }
+      ),
+      text && /* @__PURE__ */ jsx(
+        TextImageStyled,
+        {
+          ...getPropDataTestId(
+            IMAGE_FORMATTER_KEY_COMPONENT,
+            ImageFormatterSlots.textImage,
+            dataTestId
+          ),
+          variant: "body",
+          children: text
+        }
+      )
+    ] });
+  }, [src, alt, text, width, height, cover, dataTestId, ownerState]);
+  return /* @__PURE__ */ jsx(
+    RootStyled,
+    {
+      ownerState,
+      className: clsx(
+        getComponentSlotRoot(IMAGE_FORMATTER_KEY_COMPONENT),
+        className
+      ),
+      ...getPropDataTestId(
+        IMAGE_FORMATTER_KEY_COMPONENT,
+        ImageFormatterSlots.root,
+        dataTestId
+      ),
+      children: content
+    }
+  );
+}
+export {
+  ImageFormatter as I
+};

package/components/formatters/ImageFormatter/ImageFormatter.styles.d.ts

@@ -0,0 +1,2 @@
+import { ImageFormatterStyles } from './types';
+export declare const imageFormatterStyles: ImageFormatterStyles;

package/components/formatters/ImageFormatter/ImageFormatter.styles.js

@@ -0,0 +1,42 @@
+const imageFormatterStyles = {
+  /**
+   * Estilos del root principal
+   */
+  root: ({ theme, ownerState }) => ({
+    display: "flex",
+    alignItems: "center",
+    gap: theme.vars.size.baseSpacings.sp2,
+    width: "100%",
+    ...!ownerState?.hasDefinedSize && {
+      height: "100%"
+    }
+  }),
+  /**
+   * Estilos de la imagen
+   */
+  image: ({ theme, ownerState }) => ({
+    flexShrink: 0,
+    borderRadius: theme.vars.size.borderRadius.r2,
+    border: `1px solid ${theme.vars.palette.border.disabled}`,
+    ...!ownerState?.hasDefinedSize && {
+      height: "90%",
+      aspectRatio: "1 / 1"
+    },
+    objectFit: ownerState?.cover ? "cover" : "contain"
+  }),
+  /**
+   * Estilos del texto de la imagen
+   */
+  textImage: ({ theme }) => ({
+    overflow: "hidden",
+    textOverflow: "ellipsis",
+    whiteSpace: "nowrap",
+    flex: 1,
+    "&.M4LTypography-root": {
+      color: theme.vars.palette.primary
+    }
+  })
+};
+export {
+  imageFormatterStyles as i
+};

package/components/formatters/ImageFormatter/constants.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Clave del componente ImageFormatter
+ */
+export declare const IMAGE_FORMATTER_KEY_COMPONENT = "M4LImageFormatter";
+export declare const IMAGE_FORMATTER_CLASSES: Record<"root" | "image" | "textImage", string>;

package/components/formatters/ImageFormatter/constants.js

@@ -0,0 +1,10 @@
+import { g as getComponentClasses } from "../../../utils/getComponentSlotRoot.js";
+import { I as ImageFormatterSlots } from "./slots/ImageFormatterEnum.js";
+const IMAGE_FORMATTER_KEY_COMPONENT = "M4LImageFormatter";
+getComponentClasses(
+  IMAGE_FORMATTER_KEY_COMPONENT,
+  ImageFormatterSlots
+);
+export {
+  IMAGE_FORMATTER_KEY_COMPONENT as I
+};

package/components/formatters/ImageFormatter/index.d.ts

@@ -0,0 +1,2 @@
+export { ImageFormatter } from './ImageFormatter';
+export * from './types';

package/components/formatters/ImageFormatter/index.js

@@ -0,0 +1 @@
+

package/components/formatters/ImageFormatter/slots/ImageFormatterEnum.d.ts

@@ -0,0 +1,5 @@
+export declare enum ImageFormatterSlots {
+    root = "root",
+    image = "image",
+    textImage = "textImage"
+}

package/components/formatters/ImageFormatter/slots/ImageFormatterEnum.js

@@ -0,0 +1,9 @@
+var ImageFormatterSlots = /* @__PURE__ */ ((ImageFormatterSlots2) => {
+  ImageFormatterSlots2["root"] = "root";
+  ImageFormatterSlots2["image"] = "image";
+  ImageFormatterSlots2["textImage"] = "textImage";
+  return ImageFormatterSlots2;
+})(ImageFormatterSlots || {});
+export {
+  ImageFormatterSlots as I
+};

package/components/formatters/ImageFormatter/slots/ImageFormatterSlots.d.ts

@@ -0,0 +1,9 @@
+export declare const RootStyled: import('@emotion/styled').StyledComponent<import('@mui/system').MUIStyledCommonProps<import('@mui/material').Theme> & Record<string, unknown> & {
+    ownerState?: (Partial<import('..').ImageFormatterOwnerState> & Record<string, unknown>) | undefined;
+}, Pick<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, keyof import('react').ClassAttributes<HTMLDivElement> | keyof import('react').HTMLAttributes<HTMLDivElement>>, {}>;
+export declare const ImageStyled: import('@emotion/styled').StyledComponent<Pick<import('../../../Image').ImageProps, keyof import('../../../Image').ImageProps> & import('@mui/system').MUIStyledCommonProps<import('@mui/material').Theme> & Record<string, unknown> & {
+    ownerState?: (Partial<import('..').ImageFormatterOwnerState> & Record<string, unknown>) | undefined;
+}, {}, {}>;
+export declare const TextImageStyled: import('@emotion/styled').StyledComponent<Pick<Omit<import('../../../mui_extended/Typography/types').TypographyProps, "ref"> & import('react').RefAttributes<HTMLSpanElement>, "size" | "children" | "title" | "component" | "zIndex" | "id" | "disabled" | "paragraph" | "border" | "fontWeight" | "lineHeight" | "letterSpacing" | "fontSize" | "textTransform" | "fontFamily" | "typography" | "flex" | "hidden" | "color" | "left" | "right" | "bottom" | "top" | "ellipsis" | "content" | "style" | "position" | "padding" | "variant" | "borderRadius" | "width" | "display" | "borderColor" | "height" | "gap" | "minHeight" | "margin" | "overflow" | "boxShadow" | "minWidth" | "justifyContent" | "alignItems" | "paddingLeft" | "borderLeft" | "borderTop" | "maxWidth" | "flexDirection" | "paddingRight" | "borderRight" | "flexGrow" | "marginLeft" | "textOverflow" | "borderBottom" | "gridTemplateColumns" | "marginBottom" | "dataTestid" | "alignContent" | "alignSelf" | "boxSizing" | "columnGap" | "flexBasis" | "flexShrink" | "flexWrap" | "fontStyle" | "gridAutoColumns" | "gridAutoFlow" | "gridAutoRows" | "gridTemplateAreas" | "gridTemplateRows" | "justifyItems" | "justifySelf" | "marginBlockEnd" | "marginBlockStart" | "marginInlineEnd" | "marginInlineStart" | "marginRight" | "marginTop" | "maxHeight" | "order" | "paddingBlockEnd" | "paddingBlockStart" | "paddingBottom" | "paddingInlineEnd" | "paddingInlineStart" | "paddingTop" | "rowGap" | "textAlign" | "translate" | "visibility" | "whiteSpace" | "gridArea" | "gridColumn" | "gridRow" | "marginBlock" | "marginInline" | "paddingBlock" | "paddingInline" | "className" | "classes" | "sx" | "p" | "slot" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "autoCapitalize" | "autoFocus" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "enterKeyHint" | "lang" | "nonce" | "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" | "exportparts" | "part" | "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" | "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" | "bgcolor" | "m" | "mt" | "mr" | "mb" | "ml" | "mx" | "marginX" | "my" | "marginY" | "pt" | "pr" | "pb" | "pl" | "px" | "paddingX" | "py" | "paddingY" | "displayPrint" | "align" | "htmlFor" | "gutterBottom" | "noWrap" | "variantMapping" | "skeletonWidth" | "skeletonRows" | keyof import('react').RefAttributes<HTMLSpanElement>> & import('@mui/system').MUIStyledCommonProps<import('@mui/material').Theme> & Record<string, unknown> & {
+    ownerState?: (Partial<import('..').ImageFormatterOwnerState> & Record<string, unknown>) | undefined;
+}, {}, {}>;

package/components/formatters/ImageFormatter/slots/ImageFormatterSlots.js

@@ -0,0 +1,23 @@
+import { styled } from "@mui/material";
+import { I as IMAGE_FORMATTER_KEY_COMPONENT } from "../constants.js";
+import { I as ImageFormatterSlots } from "./ImageFormatterEnum.js";
+import { i as imageFormatterStyles } from "../ImageFormatter.styles.js";
+import { I as Image } from "../../../Image/Image.js";
+import { T as Typography } from "../../../mui_extended/Typography/Typography.js";
+const RootStyled = styled("div", {
+  name: IMAGE_FORMATTER_KEY_COMPONENT,
+  slot: ImageFormatterSlots.root
+})(imageFormatterStyles.root);
+const ImageStyled = styled(Image, {
+  name: IMAGE_FORMATTER_KEY_COMPONENT,
+  slot: ImageFormatterSlots.image
+})(imageFormatterStyles.image);
+const TextImageStyled = styled(Typography, {
+  name: IMAGE_FORMATTER_KEY_COMPONENT,
+  slot: ImageFormatterSlots.textImage
+})(imageFormatterStyles.textImage);
+export {
+  ImageStyled as I,
+  RootStyled as R,
+  TextImageStyled as T
+};

package/components/formatters/ImageFormatter/types.d.ts

@@ -0,0 +1,51 @@
+import { M4LOverridesStyleRules } from '../../../@types/augmentations';
+import { ImageFormatterSlots } from './slots/ImageFormatterEnum';
+import { ImageProps } from '../../Image';
+import { IMAGE_FORMATTER_KEY_COMPONENT } from './constants';
+import { Theme } from '@mui/material';
+/**
+ * Props del ImageFormatter
+ */
+export interface ImageFormatterProps extends Pick<ImageProps, 'src' | 'alt' | 'width' | 'height' | 'cover' | 'enableIntersectionObserver'> {
+    /**
+     * Texto de la imagen
+     */
+    text?: string;
+    /**
+     * ID para testing
+     */
+    dataTestId?: string;
+    /**
+     * Clase CSS personalizada
+     */
+    className?: string;
+}
+/**
+ * Owner state del ImageFormatter
+ */
+export interface ImageFormatterOwnerState {
+    /**
+     * Ancho de la imagen
+     */
+    width?: number | string;
+    /**
+     * Alto de la imagen
+     */
+    height?: number | string;
+    /**
+     * Si la imagen tiene tamaño definido o debe usar 100% + aspect ratio
+     */
+    hasDefinedSize: boolean;
+    /**
+     * Si es verdadero, la imagen se ajusta al contenedor y se recorta si es necesario.
+     */
+    cover?: boolean;
+}
+/**
+ * Tipos de slots disponibles para el ImageFormatter
+ */
+export type ImageFormatterSlotsType = ImageFormatterSlots;
+/**
+ * Estilos aplicables al ImageFormatter
+ */
+export type ImageFormatterStyles = M4LOverridesStyleRules<ImageFormatterSlotsType, typeof IMAGE_FORMATTER_KEY_COMPONENT, Theme>;

package/components/formatters/ImageFormatter/types.js

@@ -0,0 +1 @@
+

package/components/formatters/index.d.ts

@@ -10,3 +10,4 @@ export * from './DistanceToNowFormatter';
 export type { UncertaintyRange } from './UncertaintyFormatter/types';
 export { TagsFormatter } from './TagsFormatter';
 export { ColorFormatter } from './ColorFormatter';
+export { ImageFormatter } from './ImageFormatter';

package/components/mui_extended/index.d.ts

@@ -8,7 +8,6 @@ export { Breadcrumbs } from './Breadcrumbs';
 export type { TLink } from './Breadcrumbs/types';
 export * from './Button/Button';
 export * from './CheckBox';
-export * from './RadioButton';
 export { CircularProgress } from './CircularProgress';
 export { Badge } from './Badge';
 export * from './ImageButton/ImageButton';