@m4l/components 9.3.34 → 9.3.35-JT27112025.beta.1

package/@types/export.d.ts

@@ -241,5 +241,8 @@ declare module '@mui/material/styles' {
     M4LIconsFormatter?: {
       styleOverrides?: ComponentsOverrides<Theme>['M4LIconsFormatter'];
     };
+    M4LImageFormatter?: {
+      styleOverrides?: ComponentsOverrides<Theme>['M4LImageFormatter'];
+    };
   }
 }

package/@types/types.d.ts

@@ -304,6 +304,10 @@ import {
   IconsFormatterOwnerState,
   IconsFormatterSlotsType,
 } from '../components/formatters/IconsFormatter/types';
+import {
+  ImageFormatterOwnerState,
+  ImageFormatterSlotsType,
+} from '../components/formatters/ImageFormatter';
 
 declare module '@mui/material/styles' {
   // Define the slots in the theme
@@ -397,6 +401,7 @@ declare module '@mui/material/styles' {
     M4LMFIsolationApp: MFIsolationAppSlotsType;
     M4LTagsFormatter: TagsFormatterSlotsType;
     M4LIconsFormatter: IconsFormatterSlotsType;
+    M4LImageFormatter: ImageFormatterSlotsType;
   }
   interface ComponentsPropsList {
     // Extend ComponentsProps or ComponentsOwnerState(this extend ComponentProps)
@@ -489,6 +494,7 @@ declare module '@mui/material/styles' {
     M4LMFIsolationApp: Partial<MFIsolationAppOwnerState>;
     M4LTagsFormatter: Partial<TagsFormatterOwnerState>;
     M4LIconsFormatter: Partial<IconsFormatterOwnerState>;
+    M4LImageFormatter: Partial<ImageFormatterOwnerState>;
   }
   interface Components {
     M4LDynamicFilter?: {
@@ -946,5 +952,10 @@ declare module '@mui/material/styles' {
       styleOverrides?: ComponentsOverrides<Theme>['M4LIconsFormatter'];
       variants?: ComponentsVariants['M4LIconsFormatter'];
     };
+    M4LImageFormatter?: {
+      defaultProps?: ComponentsPropsList['M4LImageFormatter'];
+      styleOverrides?: ComponentsOverrides<Theme>['M4LImageFormatter'];
+      variants?: ComponentsVariants['M4LImageFormatter'];
+    };
   }
 }

package/components/DataGrid/Datagrid.styles.js

@@ -270,6 +270,7 @@ const dataGridStyles = {
       border: theme.vars.size.borderStroke.container,
       borderColor: theme.vars.palette?.border.secondary,
       "& .rdg ": {
+        scrollBehavior: "smooth",
         display: "grid",
         contain: "content",
         boxSizing: "border-box",

package/components/DataGrid/contexts/DataGridContext/index.js

@@ -1,146 +1,21 @@
 import { jsx } from "react/jsx-runtime";
-import { useState, useCallback, useEffect, useMemo, createContext } from "react";
-import { c as castMapColumnsWidthToRecord } from "../../helpers/castMapColumnsWidthToRecord.js";
-import { useFirstRender, useIsMobile } from "@m4l/graphics";
+import { useState, useEffect, useMemo, createContext } from "react";
+import { useFirstRender } from "@m4l/graphics";
 import { g as getComponentClasses } from "../../../../utils/getComponentSlotRoot.js";
 import { a as DATAGRID_ROW_HEIGHTS, b as DATAGRID_ROW_HEADER_HEIGHTS, D as DATAGRID_PREFIX_NAME } from "../../constants.js";
 import { C as ControlNavigateSlots, a as ColumnsConfigSlots, T as TextEditorSlots, b as TableSlots, R as RowsCountSlots, A as ActionsSlots, D as DataGridSlots } from "../../slots/DataGridEnum.js";
 import { deepEqual } from "fast-equals";
+import { u as useViewMode } from "../../hooks/useViewMode/useViewMode.js";
+import { u as useRowHeight } from "../../hooks/useRowHeight/useRowHeight.js";
+import { u as useColumnsWidth } from "../../hooks/useColumnsWidth/useColumnsWidth.js";
+import { u as useViewConfig } from "../../hooks/useViewConfig/useViewConfig.js";
+import { u as useChangeColumnsConfig } from "../../hooks/useChangeColumnsConfig/useChangeColumnsConfig.js";
+import { u as useChangeColumnsOrder } from "../../hooks/useChangeColumnsOrder/useChangeColumnsOrder.js";
+import { g as getColumnsWidth } from "../../helpers/getColumnsWidth/getColumnsWidth.js";
+import { g as getInitialColumnsConfig } from "../../helpers/getInitialColumnsConfig/getInitialColumnsConfig.js";
+import { g as getAllViewModes } from "../../helpers/getAllViewModes/getAllViewModes.js";
+import { g as getViewSpecificConfig } from "../../helpers/getViewSpecificConfig/getViewSpecificConfig.js";
 const DataGridContext = createContext(null);
-function getColumnsWidth(id, columns, defaultUserColumns) {
-  const newMap = /* @__PURE__ */ new Map();
-  let storeColumnsWidth;
-  try {
-    const item = window.localStorage.getItem(`${id}_columns_width`);
-    storeColumnsWidth = item !== null ? new Map(JSON.parse(item)) : /* @__PURE__ */ new Map();
-  } catch (_e) {
-    storeColumnsWidth = /* @__PURE__ */ new Map();
-  }
-  for (let i = 0; i < columns.length; i++) {
-    let width;
-    if (defaultUserColumns) {
-      try {
-        width = defaultUserColumns.columnsWidths[columns[i].key];
-      } catch (_e) {
-      }
-    }
-    if (width === void 0) {
-      const storeWidth = storeColumnsWidth.get(columns[i].key);
-      if (typeof storeWidth === "number") {
-        width = storeWidth;
-      }
-    }
-    if (width !== void 0) {
-      newMap.set(columns[i].key, width);
-    }
-  }
-  return newMap;
-}
-function saveColumnsWidth(id, storeColumnsWidth, onChangeUserColumns) {
-  if (onChangeUserColumns) {
-    const columnsWidthObject = castMapColumnsWidthToRecord(storeColumnsWidth);
-    onChangeUserColumns({
-      reason: "columnsWidths",
-      userConfig: columnsWidthObject
-    });
-    return;
-  }
-  localStorage.setItem(
-    `${id}_columns_width`,
-    JSON.stringify([...storeColumnsWidth])
-  );
-}
-const getAllViewModes = () => {
-  return ["table", "cards"];
-};
-const getViewSpecificConfig = (viewMode) => {
-  const configs = {
-    table: {
-      defaults: { frozen: false },
-      originalDefaults: { originalFrozen: false },
-      dynamicOriginalProperty: (item) => ({
-        originalFrozen: item?.frozen ?? false
-      })
-    },
-    cards: {
-      defaults: { showTitle: true },
-      originalDefaults: { originalShowTitle: true },
-      dynamicOriginalProperty: (item) => ({
-        originalShowTitle: item?.showTitle ?? true
-      })
-    }
-  };
-  return configs[viewMode] || configs.table;
-};
-const getViewSuffix = (viewMode) => {
-  if (viewMode === "table") {
-    return "";
-  }
-  return `_${viewMode}`;
-};
-function getInitialColumnsConfig(id, columns, viewMode, defaultUserConfig, viewSpecificDefaults, originalViewSpecificDefaults) {
-  let columnsConfig;
-  if (defaultUserConfig) {
-    columnsConfig = defaultUserConfig;
-  } else {
-    columnsConfig = loadViewConfig(
-      id,
-      getViewSuffix(viewMode)
-    ) || [];
-  }
-  return columns.map((column, index) => {
-    const existingConfig = columnsConfig.find((c) => c.key === column.key);
-    const columnConfigIndex = existingConfig ? columnsConfig.indexOf(existingConfig) : -1;
-    const baseConfig = {
-      key: column.key,
-      name: typeof column.name === "string" ? column.name : String(column.name),
-      hidden: column.hidden === void 0 ? false : column.hidden,
-      index: columnConfigIndex > -1 ? columnConfigIndex : index,
-      visible: existingConfig?.visible !== void 0 ? existingConfig.visible : column.visible === void 0 ? true : column.visible,
-      originalIndex: index,
-      originalVisible: column.visible === void 0 ? true : column.visible
-    };
-    return {
-      ...baseConfig,
-      ...viewSpecificDefaults,
-      ...originalViewSpecificDefaults,
-      ...existingConfig || {}
-    };
-  }).sort((a, b) => a.index - b.index);
-}
-function saveViewConfig(id, viewSuffix, config, onChangeCallback) {
-  if (onChangeCallback) {
-    const reason = viewSuffix === "" ? "columnsConfig" : `columnsConfig${viewSuffix.replace("_", "")}`;
-    onChangeCallback({
-      reason,
-      userConfig: config
-    });
-    return;
-  }
-  const storageKey = viewSuffix === "" ? `${id}_columns_config` : `${id}_columns_config${viewSuffix}`;
-  localStorage.setItem(storageKey, JSON.stringify(config));
-}
-function loadViewConfig(id, viewSuffix) {
-  try {
-    const storageKey = viewSuffix === "" ? `${id}_columns_config` : `${id}_columns_config${viewSuffix}`;
-    const stored = localStorage.getItem(storageKey);
-    return stored ? JSON.parse(stored) : null;
-  } catch (_e) {
-    return null;
-  }
-}
-function saveViewMode(id, viewMode) {
-  localStorage.setItem(`${id}_view_mode`, viewMode);
-}
-function getIndexRowHeightVariant(variant) {
-  if (variant === "compact") {
-    return 0;
-  }
-  if (variant === "standard") {
-    return 1;
-  }
-  return 2;
-}
 function DataGridProvider(props) {
   const {
     id,
@@ -166,7 +41,32 @@ function DataGridProvider(props) {
     cardsViewConfig
   } = props;
   const isFirstRender = useFirstRender([columns, id]);
-  const isMobile = useIsMobile();
+  const { viewModeState, handleViewModeChange } = useViewMode({
+    id,
+    viewMode,
+    defaultViewMode,
+    onViewModeChange,
+    onChangeUserColumns
+  });
+  const { currentRowHeightVariant, setRowHeightVariant } = useRowHeight({
+    rowHeights,
+    rowHeaderHeights,
+    initialRowHeightVariant
+  });
+  const { columnsWidths, setColumnsWidths, onChangeColumnWidth } = useColumnsWidth({
+    id,
+    onChangeUserColumns
+  });
+  const { getConfigColumns, updateConfigColumns } = useViewConfig();
+  const { onChangeColumnsConfig } = useChangeColumnsConfig({
+    id,
+    onChangeUserColumns,
+    updateConfigColumns
+  });
+  const { onChangeColumnsOrder } = useChangeColumnsOrder({
+    getConfigColumns,
+    onChangeColumnsConfig
+  });
   const classes = getComponentClasses(DATAGRID_PREFIX_NAME, {
     ...DataGridSlots,
     ...ActionsSlots,
@@ -176,80 +76,8 @@ function DataGridProvider(props) {
     ...ColumnsConfigSlots,
     ...ControlNavigateSlots
   });
-  const [columnsWidths, setColumnsWidths] = useState(/* @__PURE__ */ new Map());
-  const [viewConfig, setViewConfig] = useState(() => ({
-    table: [],
-    cards: []
-  }));
-  const getConfigColumns = useCallback(
-    (viewModeParam) => {
-      return viewConfig[viewModeParam];
-    },
-    [viewConfig]
-  );
-  const updateConfigColumns = useCallback(
-    (viewModeParam, config) => {
-      setViewConfig((prev) => ({
-        ...prev,
-        [viewModeParam]: config
-      }));
-    },
-    []
-  );
   const [rowsFilterCount, setRowFilterCount] = useState(rowsCount);
   const [sortColumns, setSortColumns] = useState([]);
-  const [viewModeState, setViewModeState] = useState(() => {
-    if (viewMode) {
-      return viewMode;
-    }
-    try {
-      const savedViewMode = localStorage.getItem(`${id}_view_mode`);
-      if (savedViewMode === "cards" || savedViewMode === "table") {
-        return savedViewMode;
-      }
-    } catch (_e) {
-    }
-    if (defaultViewMode) {
-      return defaultViewMode;
-    }
-    return isMobile ? "cards" : "table";
-  });
-  const handleViewModeChange = useCallback(
-    (newViewMode) => {
-      setViewModeState(newViewMode);
-      saveViewMode(id, newViewMode);
-      onViewModeChange?.(newViewMode);
-    },
-    [onViewModeChange, id]
-  );
-  useEffect(() => {
-    if (viewMode !== void 0) {
-      setViewModeState(viewMode);
-    }
-  }, [viewMode]);
-  const [currentRowHeightVariant, setCurrentRowHeightVariant] = useState(() => {
-    if (typeof rowHeights !== typeof rowHeaderHeights) {
-      throw new Error("Must be same type rowheights and rowHeaderTypes");
-    }
-    if (typeof rowHeights === "number" && typeof rowHeaderHeights === "number") {
-      return {
-        rowHVariant: "compact",
-        rowHeight: rowHeights,
-        rowHeaderHeight: rowHeaderHeights
-      };
-    }
-    if (typeof rowHeights !== "number" && rowHeights.length !== 3) {
-      throw new Error("Must be 3 heights");
-    }
-    if (typeof rowHeaderHeights !== "number" && rowHeaderHeights.length !== 3) {
-      throw new Error("Must be 3 HeaderHeights");
-    }
-    return {
-      rowHVariant: initialRowHeightVariant,
-      rowHeight: typeof rowHeights !== "number" ? rowHeights[getIndexRowHeightVariant(initialRowHeightVariant)] : rowHeights,
-      rowHeaderHeight: typeof rowHeaderHeights !== "number" ? rowHeaderHeights[getIndexRowHeightVariant(initialRowHeightVariant)] : rowHeaderHeights
-    };
-  });
   useEffect(() => {
     const keys = new Set(columns.map((c) => c.key));
     if (sortSettings?.sortsColumns) {
@@ -315,7 +143,6 @@ function DataGridProvider(props) {
     }
   }, [columns, sortSettings, filterSettings, cardsViewConfig]);
   const finalRowHeights = useMemo(() => rowHeights, [rowHeights]);
-  let timerSaveColumns;
   useEffect(() => {
     if (isFirstRender) {
       setColumnsWidths(getColumnsWidth(id, columns, defaultUserColumns));
@@ -450,65 +277,9 @@ function DataGridProvider(props) {
       });
     }
   }, [columns, id]);
-  const onChangeColumnsConfig = useCallback(
-    (viewModeParam, newConfig) => {
-      saveViewConfig(
-        id,
-        getViewSuffix(viewModeParam),
-        newConfig,
-        onChangeUserColumns
-      );
-      updateConfigColumns(viewModeParam, newConfig);
-    },
-    [id, onChangeUserColumns, updateConfigColumns]
-  );
-  const onChangeColumnsOrder = useCallback(
-    (viewModeParam, sourceKey, targetKey) => {
-      if (sourceKey === targetKey) {
-        return;
-      }
-      const currentConfig = getConfigColumns(viewModeParam);
-      const sourceColumnIndex = currentConfig.findIndex(
-        (c) => c.key === sourceKey
-      );
-      const targetColumnIndex = currentConfig.findIndex(
-        (c) => c.key === targetKey
-      );
-      const reorderedConfig = [...currentConfig];
-      reorderedConfig.splice(
-        targetColumnIndex,
-        0,
-        reorderedConfig.splice(sourceColumnIndex, 1)[0]
-      );
-      onChangeColumnsConfig(viewModeParam, reorderedConfig);
-    },
-    [getConfigColumns, onChangeColumnsConfig]
-  );
-  const onChangeColumnWidth = (columnKey, width) => {
-    columnsWidths.set(columnKey, Math.round(width));
-    if (timerSaveColumns) {
-      clearTimeout(timerSaveColumns);
-    }
-    timerSaveColumns = setTimeout(() => {
-      saveColumnsWidth(id, columnsWidths, onChangeUserColumns);
-    }, 500);
-  };
   const setRowFilterCountInternal = (newRowsCount) => {
     setRowFilterCount(newRowsCount);
   };
-  const setCurrentRowHeightInternal = useCallback(
-    (newVariant) => {
-      if (typeof rowHeights === "number" || typeof rowHeaderHeights === "number") {
-        throw new Error("Only use setCurrentRowHeight with vector rowHeights");
-      }
-      setCurrentRowHeightVariant({
-        rowHVariant: newVariant,
-        rowHeight: rowHeights[getIndexRowHeightVariant(newVariant)],
-        rowHeaderHeight: rowHeaderHeights[getIndexRowHeightVariant(newVariant)]
-      });
-    },
-    [setCurrentRowHeightVariant, rowHeights, rowHeaderHeights]
-  );
   return /* @__PURE__ */ jsx(
     DataGridContext.Provider,
     {
@@ -528,7 +299,7 @@ function DataGridProvider(props) {
         onChangeColumnWidth,
         setRowsCount: setRowFilterCountInternal,
         rowActionsGetter,
-        setRowHeightVariant: setCurrentRowHeightInternal,
+        setRowHeightVariant,
         onCheckedRowsChange,
         rowKeyGetter,
         onChangeUserColumns,

package/components/DataGrid/contexts/DataGridContext/types.d.ts

@@ -3,21 +3,12 @@ import { RowKey, RowHeightVariants, GridProps } from '../../types';
 import { Maybe } from '@m4l/core';
 import { ActionsSlots, ColumnsConfigSlots, ControlNavigateSlots, DataGridSlots, RowsCountSlots, TableSlots, TextEditorSlots } from '../../slots/DataGridEnum';
 import { SortColumn } from 'react-data-grid';
-/**
- * Configuración base genérica que puede extenderse con propiedades específicas de cualquier vista
- * USO INTERNO: El sistema usa esto para manejar genéricamente las configuraciones
- */
-export type BaseViewConfig<TViewSpecific = {}> = TViewSpecific & {
-    key: string;
-    visible: boolean;
-    index: number;
-    name?: string;
-};
+import { IGridConfig, BaseViewConfig } from '../../types.helpers';
 /**
  * Configuración extendida genérica con propiedades originales
  * USO INTERNO: El contexto usa esto para el estado interno con propiedades de tracking
  */
-export type IViewConfig<TViewSpecific = {}, TOriginalViewSpecific = {}> = BaseViewConfig<TViewSpecific> & {
+export type IViewConfig<TViewSpecific = object, TOriginalViewSpecific = object> = BaseViewConfig<TViewSpecific> & {
     hidden: boolean;
     originalIndex: number;
     originalVisible: boolean;
@@ -62,15 +53,6 @@ export interface IConfigColumnCards extends Omit<IConfigColumn, 'frozen' | 'orig
     originalShowTitle: boolean;
 }
 export type ViewMode = 'table' | 'cards';
-/**
- * Configuración base del Grid (API pública original)
- * USO: Tipo base para defaultUserColumns - mantiene retrocompatibilidad
- * IMPORTANTE: No modificar para mantener retrocompatibilidad con código existente
- */
-export interface IGridConfig {
-    columnsConfig: BaseConfigColumn[];
-    columnsWidths: Record<RowKey, number>;
-}
 /**
  * Configuración extendida del Grid para soportar múltiples vistas
  * USO: Para nuevas implementaciones que soporten cards y futuras vistas
@@ -78,6 +60,7 @@ export interface IGridConfig {
  */
 export interface IGridConfigExtended extends IGridConfig {
     columnsConfigCards?: BaseConfigColumnCards[];
+    viewMode?: ViewMode;
 }
 export interface DataGridProviderProps<TRow, TSummaryRow, TKey extends RowKey = RowKey> extends Pick<GridProps<TRow, TSummaryRow, TKey>, 'rows' | 'columns' | 'rowActionsGetter' | 'rowHeaderHeights' | 'rowHeights' | 'initialRowHeightVariant' | 'checkedRows' | 'onCheckedRowsChange' | 'rowKeyGetter' | 'onChangeUserColumns' | 'defaultUserColumns' | 'externalSortSettings' | 'externalFilterSettings' | 'defaultViewMode' | 'cardsViewConfig'> {
     id: number | string;

package/components/DataGrid/formatters/ColumnImageFormatter/ImageFormatterCell.d.ts

@@ -0,0 +1,13 @@
+import { ColumnImageFormatterProps } from './types';
+import { RenderCellProps } from 'react-data-grid';
+/**
+ * Componente interno que renderiza la celda y puede usar hooks
+ */
+export declare function ImageFormatterCell<TRow>(props: {
+    formatterProps: RenderCellProps<TRow>;
+    fieldValue: ColumnImageFormatterProps<TRow>['fieldValue'];
+    fieldText: ColumnImageFormatterProps<TRow>['fieldText'];
+    width?: ColumnImageFormatterProps<TRow>['width'];
+    height?: ColumnImageFormatterProps<TRow>['height'];
+    cover?: ColumnImageFormatterProps<TRow>['cover'];
+}): import("react/jsx-runtime").JSX.Element;

package/components/DataGrid/formatters/ColumnImageFormatter/ImageFormatterCell.js

@@ -0,0 +1,33 @@
+import { jsx, Fragment } from "react/jsx-runtime";
+import { useContext } from "react";
+import { getPropertyByString } from "@m4l/core";
+import { I as IMAGE_SIZES } from "./constants.js";
+import { a as DataGridContext } from "../../contexts/DataGridContext/index.js";
+import { I as ImageFormatter } from "../../../formatters/ImageFormatter/ImageFormatter.js";
+function ImageFormatterCell(props) {
+  const { formatterProps, fieldValue, fieldText, width, height, cover } = props;
+  const context = useContext(DataGridContext);
+  const viewMode = context?.viewMode ?? "cards";
+  const hasCustomSize = width !== void 0 && height !== void 0;
+  const finalWidth = viewMode === "cards" && hasCustomSize ? width : viewMode === "cards" ? IMAGE_SIZES.cards : void 0;
+  const finalHeight = viewMode === "cards" && hasCustomSize ? height : viewMode === "cards" ? IMAGE_SIZES.cards : void 0;
+  const src = getPropertyByString(formatterProps.row, fieldValue) ?? void 0;
+  const text = fieldText ? getPropertyByString(formatterProps.row, fieldText) ?? void 0 : void 0;
+  if (!src) {
+    return /* @__PURE__ */ jsx(Fragment, { children: "-" });
+  }
+  return /* @__PURE__ */ jsx(
+    ImageFormatter,
+    {
+      src,
+      alt: text || src,
+      width: finalWidth,
+      height: finalHeight,
+      text,
+      cover
+    }
+  );
+}
+export {
+  ImageFormatterCell as I
+};

package/components/DataGrid/formatters/ColumnImageFormatter/constants.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Dimensiones de imagen según densidad en vista tabla
+ */
+export declare const IMAGE_SIZES: {
+    readonly cards: 60;
+};

package/components/DataGrid/formatters/ColumnImageFormatter/constants.js

@@ -0,0 +1,6 @@
+const IMAGE_SIZES = {
+  cards: 60
+};
+export {
+  IMAGE_SIZES as I
+};

package/components/DataGrid/formatters/ColumnImageFormatter/formatter.d.ts

@@ -0,0 +1,8 @@
+import { RenderCellProps } from 'react-data-grid';
+import { ColumnImageFormatterProps } from './types';
+/**
+ * Formatter para mostrar imágenes con o sin texto
+ * @param props - Propiedades del formatter
+ * @returns Función que recibe RenderCellProps y retorna el ImageFormatter
+ */
+export declare function ColumnImageFormatter<TRow>(props: ColumnImageFormatterProps<TRow>): (formatterProps: RenderCellProps<TRow>) => import("react/jsx-runtime").JSX.Element;

package/components/DataGrid/formatters/ColumnImageFormatter/formatter.js

@@ -0,0 +1,25 @@
+import { jsx } from "react/jsx-runtime";
+import { I as ImageFormatterCell } from "./ImageFormatterCell.js";
+function ColumnImageFormatter(props) {
+  const { fieldValue, fieldText, cover } = props;
+  const width = "width" in props && props.width !== void 0 ? props.width : void 0;
+  const height = "height" in props && props.height !== void 0 ? props.height : void 0;
+  const formatter = (formatterProps) => {
+    return /* @__PURE__ */ jsx(
+      ImageFormatterCell,
+      {
+        formatterProps,
+        fieldValue,
+        fieldText,
+        width,
+        height,
+        cover
+      }
+    );
+  };
+  formatter.__imageFormatterHeight = height ?? 60;
+  return formatter;
+}
+export {
+  ColumnImageFormatter as C
+};

package/components/DataGrid/formatters/ColumnImageFormatter/index.d.ts

@@ -0,0 +1,3 @@
+export { useColumnImage } from './useColumnImage';
+export { ColumnImageFormatter } from './formatter';
+export * from './types';

package/components/DataGrid/formatters/ColumnImageFormatter/index.js

@@ -0,0 +1 @@
+

package/components/DataGrid/formatters/ColumnImageFormatter/tests/ColumnImageFormatter.test.d.ts

@@ -0,0 +1 @@
+export {};

package/components/DataGrid/formatters/ColumnImageFormatter/types.d.ts

@@ -0,0 +1,44 @@
+import { DeepKeyOf } from '../../../../utils/types';
+interface ColumnImageFormatterBaseProps<TRow> {
+    /**
+     * Campo del row que contiene la URL de la imagen
+     */
+    fieldValue: DeepKeyOf<TRow>;
+    /**
+     * Campo opcional del row que contiene el texto a mostrar junto a la imagen
+     */
+    fieldText?: DeepKeyOf<TRow>;
+    /**
+     * Si es true, la imagen usa object-fit: cover (recorta si es necesario)
+     * Si es false o undefined, usa object-fit: contain (muestra completa)
+     * @default false
+     */
+    cover?: boolean;
+}
+/**
+ * Props sin dimensiones personalizadas (usa IMAGE_SIZES.cards por defecto)
+ */
+interface ColumnImageFormatterWithoutSize<TRow> extends ColumnImageFormatterBaseProps<TRow> {
+    width?: never;
+    height?: never;
+}
+/**
+ * Props con dimensiones personalizadas para vista cards
+ * IMPORTANTE: width y height deben proporcionarse juntas
+ */
+interface ColumnImageFormatterWithSize<TRow> extends ColumnImageFormatterBaseProps<TRow> {
+    /**
+     * Ancho personalizado para la imagen en vista cards (en píxeles)
+     */
+    width: number;
+    /**
+     * Alto personalizado para la imagen en vista cards (en píxeles)
+     */
+    height: number;
+}
+/**
+ * Props para ColumnImageFormatter
+ * Puede tener dimensiones personalizadas (width Y height juntas) o ninguna
+ */
+export type ColumnImageFormatterProps<TRow> = ColumnImageFormatterWithoutSize<TRow> | ColumnImageFormatterWithSize<TRow>;
+export {};

package/components/DataGrid/formatters/ColumnImageFormatter/types.js

@@ -0,0 +1 @@
+

package/components/DataGrid/formatters/ColumnImageFormatter/useColumnImage.d.ts

@@ -0,0 +1,9 @@
+import { ColumnImageFormatterProps } from './types';
+/**
+ * Hook que retorna el formatter para columnas con imágenes en DataGrid
+ * @param props - Propiedades del formatter
+ * @returns Objeto con el formatter
+ */
+export declare const useColumnImage: <TRow>(props: ColumnImageFormatterProps<TRow>) => {
+    formatter: (formatterProps: import('react-data-grid').RenderCellProps<TRow, unknown>) => import("react/jsx-runtime").JSX.Element;
+};

package/components/DataGrid/formatters/ColumnImageFormatter/useColumnImage.js

@@ -0,0 +1,22 @@
+import { useState, useRef, useEffect, useMemo } from "react";
+import { deepEqual } from "fast-equals";
+import { C as ColumnImageFormatter } from "./formatter.js";
+const useColumnImage = (props) => {
+  const [stateProps, setStateProps] = useState(props);
+  const refProps = useRef({ ...props });
+  useEffect(() => {
+    if (!deepEqual(refProps.current, props)) {
+      refProps.current = props;
+      setStateProps(props);
+    }
+  }, [props]);
+  return useMemo(
+    () => ({
+      formatter: ColumnImageFormatter(stateProps)
+    }),
+    [stateProps]
+  );
+};
+export {
+  useColumnImage as u
+};

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

@@ -11,3 +11,4 @@ export * from './ColumnUncertaintyFormatter';
 export * from './ColumnChipStatusFormatter';
 export * from './ColumnTagsFormatter';
 export * from './ColumnColorFormatter';
+export * from './ColumnImageFormatter';

package/components/DataGrid/helpers/getAllViewModes/getAllViewModes.d.ts

@@ -0,0 +1,19 @@
+import { ViewMode } from '../../contexts/DataGridContext/types';
+/**
+ * Obtiene todos los modos de vista disponibles en el DataGrid.
+ *
+ * ## Modos disponibles
+ *
+ * - `table`: Vista de tabla tradicional con filas y columnas
+ * - `cards`: Vista de tarjetas para visualización compacta
+ *
+ * ## Uso
+ *
+ * Esta función centraliza los modos de vista disponibles,
+ * facilitando la extensión futura si se agregan nuevos modos.
+ * @returns Array con los modos de vista disponibles
+ * @example
+ * const modes = getAllViewModes();
+ * // ['table', 'cards']
+ */
+export declare const getAllViewModes: () => ViewMode[];