@m4l/components 9.4.1 → 9.4.2-JT12122025.beta.1

package/components/DataGrid/DataGrid.js

@@ -34,8 +34,12 @@ function DataGrid(props) {
     dataTestId = "",
     customHeader: CustomHeader,
     visibleCustomHeader = true,
+    defaultConfig,
+    onChangeConfig,
     defaultUserColumns,
+    // deprecated
     onChangeUserColumns,
+    // deprecated
     size,
     externalSortSettings,
     externalFilterSettings,
@@ -91,8 +95,10 @@ function DataGrid(props) {
           checkedRowsMultiple,
           rowKeyGetter,
           rows,
-          onChangeUserColumns,
+          defaultConfig,
+          onChangeConfig,
           defaultUserColumns,
+          onChangeUserColumns,
           size: currentSize,
           externalSortSettings,
           externalFilterSettings,

package/components/DataGrid/constants.d.ts

@@ -52,3 +52,16 @@ export declare const DATAGRID_ROW_HEIGHTS_CONFORTABLE: number[];
  * Densidad confortable
  */
 export declare const DATAGRID_DENSITIES_CONFORTABLE: DataGridDensityConfig;
+/**
+ * Constantes para el cálculo de altura de cards
+ */
+export declare const CARD_HEIGHT: {
+    /** Altura del CardHeader (checkbox + iconos de acción) */
+    HEADER: number;
+    /** Altura por columna (label + value) */
+    COLUMN: number;
+    /** Padding vertical total (arriba + abajo) */
+    PADDING_VERTICAL: number;
+    /** Altura mínima base */
+    BASE_MIN: number;
+};

package/components/DataGrid/constants.js

@@ -28,7 +28,18 @@ var DATAGRID_SEMANTIC_WIDTHS = /* @__PURE__ */ ((DATAGRID_SEMANTIC_WIDTHS2) => {
 })(DATAGRID_SEMANTIC_WIDTHS || {});
 const DATAGRID_ROW_HEADER_HEIGHTS = [32, 40, 48];
 const DATAGRID_ROW_HEIGHTS = [32, 40, 48];
+const CARD_HEIGHT = {
+  /** Altura del CardHeader (checkbox + iconos de acción) */
+  HEADER: 42,
+  /** Altura por columna (label + value) */
+  COLUMN: 32,
+  /** Padding vertical total (arriba + abajo) */
+  PADDING_VERTICAL: 40,
+  /** Altura mínima base */
+  BASE_MIN: 120
+};
 export {
+  CARD_HEIGHT as C,
   DATAGRID_PREFIX_NAME as D,
   TEST_SKELETON as T,
   DATAGRID_ROW_HEIGHTS as a,

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

@@ -1,152 +1,33 @@
 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";
+import { g as getViewMode } from "../../helpers/getViewMode/getViewMode.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,
     children,
     columns,
+    defaultConfig,
+    onChangeConfig,
     defaultUserColumns,
+    // deprecated
+    onChangeUserColumns,
+    // deprecated
     rows,
     rowsCount,
     rowActionsGetter,
@@ -157,7 +38,6 @@ function DataGridProvider(props) {
     onCheckedRowsChange,
     checkedRowsMultiple,
     rowKeyGetter,
-    onChangeUserColumns,
     externalSortSettings: sortSettings,
     externalFilterSettings: filterSettings,
     size,
@@ -166,8 +46,37 @@ function DataGridProvider(props) {
     defaultViewMode,
     cardsViewConfig
   } = props;
+  const resolvedDefaultConfig = defaultConfig ?? defaultUserColumns;
+  const resolvedOnChangeConfig = onChangeConfig ?? onChangeUserColumns;
   const isFirstRender = useFirstRender([columns, id]);
-  const isMobile = useIsMobile();
+  const { viewModeState, setViewModeState, handleViewModeChange } = useViewMode(
+    {
+      id,
+      viewMode,
+      defaultViewMode,
+      onViewModeChange,
+      onChangeConfig: resolvedOnChangeConfig
+    }
+  );
+  const { currentRowHeightVariant, setRowHeightVariant } = useRowHeight({
+    rowHeights,
+    rowHeaderHeights,
+    initialRowHeightVariant
+  });
+  const { columnsWidths, setColumnsWidths, onChangeColumnWidth } = useColumnsWidth({
+    id,
+    onChangeConfig: resolvedOnChangeConfig
+  });
+  const { getConfigColumns, updateConfigColumns } = useViewConfig();
+  const { onChangeColumnsConfig } = useChangeColumnsConfig({
+    id,
+    onChangeConfig: resolvedOnChangeConfig,
+    updateConfigColumns
+  });
+  const { onChangeColumnsOrder } = useChangeColumnsOrder({
+    getConfigColumns,
+    onChangeColumnsConfig
+  });
   const classes = getComponentClasses(DATAGRID_PREFIX_NAME, {
     ...DataGridSlots,
     ...ActionsSlots,
@@ -177,80 +86,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) {
@@ -316,24 +153,26 @@ function DataGridProvider(props) {
     }
   }, [columns, sortSettings, filterSettings, cardsViewConfig]);
   const finalRowHeights = useMemo(() => rowHeights, [rowHeights]);
-  let timerSaveColumns;
   useEffect(() => {
     if (isFirstRender) {
-      setColumnsWidths(getColumnsWidth(id, columns, defaultUserColumns));
+      setColumnsWidths(getColumnsWidth(id, columns, resolvedDefaultConfig));
+      setViewModeState(
+        getViewMode(id, resolvedDefaultConfig, defaultViewMode) ?? "table"
+      );
       updateConfigColumns(
         "table",
         getInitialColumnsConfig(
           id,
           columns,
           "table",
-          defaultUserColumns?.columnsConfig,
+          resolvedDefaultConfig?.columnsConfig,
           { frozen: false },
           { originalFrozen: false }
         )
       );
       const finalCardsConfig = (() => {
-        if (defaultUserColumns?.columnsConfigCards) {
-          return defaultUserColumns.columnsConfigCards;
+        if (resolvedDefaultConfig?.columnsConfigCards && resolvedDefaultConfig.columnsConfigCards.length > 0) {
+          return resolvedDefaultConfig.columnsConfigCards;
         }
         if (cardsViewConfig?.columnsConfig) {
           return cardsViewConfig.columnsConfig.map((colConfig, index) => {
@@ -362,7 +201,7 @@ function DataGridProvider(props) {
         )
       );
     }
-  }, [defaultUserColumns]);
+  }, [resolvedDefaultConfig]);
   useEffect(() => {
     if (!isFirstRender) {
       const updatedConfigs = {
@@ -393,8 +232,11 @@ function DataGridProvider(props) {
       });
       getAllViewModes().forEach((viewModeParam) => {
         const currentConfig = updatedConfigs[viewModeParam];
+        const currentConfigKeys = new Set(
+          getConfigColumns(viewModeParam).map((c) => c.key)
+        );
         const newColumnsForView = columns.filter(
-          (column, index) => column.key !== getConfigColumns(viewModeParam)[index]?.key
+          (column) => !currentConfigKeys.has(column.key)
         );
         if (newColumnsForView.length > 0) {
           const colLength = currentConfig.length;
@@ -451,65 +293,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,
     {
@@ -529,11 +315,13 @@ function DataGridProvider(props) {
         onChangeColumnWidth,
         setRowsCount: setRowFilterCountInternal,
         rowActionsGetter,
-        setRowHeightVariant: setCurrentRowHeightInternal,
+        setRowHeightVariant,
         onCheckedRowsChange,
         checkedRowsMultiple,
         rowKeyGetter,
-        onChangeUserColumns,
+        onChangeConfig: resolvedOnChangeConfig,
+        onChangeUserColumns: resolvedOnChangeConfig,
+        // deprecated alias
         sortColumns,
         setSortColumns,
         externalSortSettings: sortSettings,

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

@@ -1,23 +1,14 @@
 import { ReactNode } from 'react';
-import { RowKey, RowHeightVariants, GridProps } from '../../types';
+import { RowKey, RowHeightVariants, GridProps, OnChangeConfig } 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,21 +60,40 @@ 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' | 'checkedRowsMultiple' | 'rowKeyGetter' | 'onChangeUserColumns' | 'defaultUserColumns' | 'externalSortSettings' | 'externalFilterSettings' | 'defaultViewMode' | 'cardsViewConfig'> {
+export interface DataGridProviderProps<TRow, TSummaryRow, TKey extends RowKey = RowKey> extends Pick<GridProps<TRow, TSummaryRow, TKey>, 'rows' | 'columns' | 'rowActionsGetter' | 'rowHeaderHeights' | 'rowHeights' | 'initialRowHeightVariant' | 'checkedRows' | 'onCheckedRowsChange' | 'checkedRowsMultiple' | 'rowKeyGetter' | 'externalSortSettings' | 'externalFilterSettings' | 'defaultViewMode' | 'cardsViewConfig'> {
     id: number | string;
     children: ReactNode;
     rowsCount: number;
     size: GridProps<any, any, any>['size'];
     viewMode?: ViewMode;
     onViewModeChange?: (viewMode: ViewMode) => void;
+    /** Configuración inicial del DataGrid */
+    defaultConfig?: IGridConfigExtended;
+    /** Callback para persistir cambios de configuración */
+    onChangeConfig?: OnChangeConfig;
+    /**
+     * @deprecated Usar `defaultConfig` en su lugar.
+     */
+    defaultUserColumns?: IGridConfigExtended;
+    /**
+     * @deprecated Usar `onChangeConfig` en su lugar.
+     */
+    onChangeUserColumns?: OnChangeConfig;
 }
 export type RowHeightState = {
     rowHVariant: RowHeightVariants;
     rowHeight: number;
     rowHeaderHeight: number;
 };
-export interface DataGridContextProps<TRow, TSummaryRow, TKey extends RowKey = RowKey> extends Pick<DataGridProviderProps<TRow, TSummaryRow, TKey>, 'rows' | 'checkedRows' | 'onCheckedRowsChange' | 'checkedRowsMultiple' | 'rowHeights' | 'rowsCount' | 'rowActionsGetter' | 'rowKeyGetter' | 'onChangeUserColumns' | 'externalSortSettings' | 'externalFilterSettings' | 'viewMode' | 'onViewModeChange' | 'defaultViewMode' | 'cardsViewConfig'> {
+export interface DataGridContextProps<TRow, TSummaryRow, TKey extends RowKey = RowKey> extends Pick<DataGridProviderProps<TRow, TSummaryRow, TKey>, 'rows' | 'checkedRows' | 'onCheckedRowsChange' | 'checkedRowsMultiple' | 'rowHeights' | 'rowsCount' | 'rowActionsGetter' | 'rowKeyGetter' | 'externalSortSettings' | 'externalFilterSettings' | 'viewMode' | 'onViewModeChange' | 'defaultViewMode' | 'cardsViewConfig'> {
+    /** Callback para persistir cambios de configuración */
+    onChangeConfig?: OnChangeConfig;
+    /**
+     * @deprecated Usar `onChangeConfig` en su lugar.
+     */
+    onChangeUserColumns?: OnChangeConfig;
     getConfigColumns: (viewMode: ViewMode) => IViewConfig[];
     onChangeColumnsConfig: (viewMode: ViewMode, config: IViewConfig[]) => void;
     onChangeColumnsOrder: (viewMode: ViewMode, sourceKey: string, targetKey: string) => void;

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[];

package/components/DataGrid/helpers/getAllViewModes/getAllViewModes.js

@@ -0,0 +1,6 @@
+const getAllViewModes = () => {
+  return ["table", "cards"];
+};
+export {
+  getAllViewModes as g
+};

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

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

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

@@ -0,0 +1 @@
+export { getAllViewModes } from './getAllViewModes';

package/components/DataGrid/helpers/getAllViewModes/index.js

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,47 @@
+import { Column } from 'react-data-grid';
+import { Maybe } from '@m4l/core';
+import { RowKey } from '../../types';
+import { IGridConfig } from '../../types.helpers';
+/**
+ * Obtiene la configuración de anchos de las columnas del DataGrid.
+ *
+ * ## Flujo de persistencia
+ *
+ * Esta función obtiene los anchos de columnas siguiendo una jerarquía de precedencia:
+ *
+ * 1. **defaultConfig** (Cookies de red) - Prioridad máxima
+ * Configuración que viene de las cookies de red cuando el componente se monta.
+ * En producción, esta es la fuente principal de datos persistidos.
+ *
+ * 2. **localStorage** - Fallback local
+ * Solo se usa cuando NO hay configuración de cookies de red.
+ * Útil para desarrollo o cuando no hay integración con cookies de red.
+ *
+ * Si no se encuentra configuración en ninguna fuente, la columna no se incluye
+ * en el Map resultante y usará el ancho por defecto definido en la columna.
+ *
+ * ## Relación con saveColumnsWidth
+ *
+ * - Cuando el usuario modifica anchos, `saveColumnsWidth` envía los cambios
+ * mediante el callback `onChangeConfig`
+ * - En la siguiente carga, esos datos vuelven como `defaultConfig`
+ * - localStorage es solo un fallback cuando no hay callback configurado
+ * @template TRow - Tipo de datos de cada fila del DataGrid
+ * @template TSummaryRow - Tipo de datos de la fila de resumen del DataGrid
+ * @param id - Identificador único del DataGrid. Se usa como prefijo para la key en localStorage (fallback)
+ * @param columns - Array de columnas del DataGrid con su configuración
+ * @param defaultConfig - Configuración del usuario obtenida de cookies de red.
+ *                             Esta es la fuente principal en producción.
+ * @returns Map donde la key es el identificador de la columna (column.key) y el value
+ *          es el ancho configurado (número en píxeles o string con unidad CSS)
+ * @example
+ * // Sin configuración de cookies de red (usa localStorage como fallback)
+ * const columnsWidths = getColumnsWidth('my-grid', columns, null);
+ * @example
+ * // Con configuración de cookies de red (caso típico en producción)
+ * const columnsWidths = getColumnsWidth('my-grid', columns, {
+ *   columnsWidths: { name: 200, email: 300 }
+ * });
+ * @see saveColumnsWidth - Función complementaria para persistir la configuración
+ */
+export declare function getColumnsWidth<TRow, TSummaryRow>(id: RowKey, columns: readonly Column<TRow, TSummaryRow>[], defaultConfig: Maybe<IGridConfig>): Map<string, Maybe<string | number>>;