@m4l/components 9.4.1 → 9.4.2-JT11122025.beta.2

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

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

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

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

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,24 @@
+import { RowHeightVariants } from '../../types';
+/**
+ * Obtiene el índice correspondiente a un variant de altura de fila.
+ *
+ * ## Propósito
+ *
+ * Mapea el nombre del variant ('compact', 'standard', 'confortable') a su
+ * índice en los arrays de alturas (rowHeights y rowHeaderHeights).
+ *
+ * ## Mapeo de variants a índices
+ *
+ * | Variant     | Índice |
+ * |-------------|--------|
+ * | compact     | 0      |
+ * | standard    | 1      |
+ * | confortable | 2      |
+ * @param variant - Variant de altura de fila
+ * @returns Índice correspondiente en los arrays de alturas (0, 1 o 2)
+ * @example
+ * getIndexRowHeightVariant('compact');     // 0
+ * getIndexRowHeightVariant('standard');    // 1
+ * getIndexRowHeightVariant('confortable'); // 2
+ */
+export declare const getIndexRowHeightVariant: (variant: RowHeightVariants) => number;

package/components/DataGrid/helpers/getIndexRowHeightVariant/getIndexRowHeightVariant.js

@@ -0,0 +1,12 @@
+const getIndexRowHeightVariant = (variant) => {
+  if (variant === "compact") {
+    return 0;
+  }
+  if (variant === "standard") {
+    return 1;
+  }
+  return 2;
+};
+export {
+  getIndexRowHeightVariant as g
+};

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

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

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

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

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,48 @@
+import { Column } from 'react-data-grid';
+import { RowKey } from '../../types';
+import { BaseViewConfig } from '../../types.helpers';
+import { IViewConfig, ViewMode } from '../../contexts/DataGridContext/types';
+/**
+ * Obtiene la configuración inicial de columnas para cualquier vista.
+ *
+ * ## Propósito
+ *
+ * Genera la configuración inicial de columnas combinando:
+ * 1. Configuración inicial (defaultConfig) si existe
+ * 2. Configuración guardada en localStorage si no hay defaultConfig
+ * 3. Valores por defecto de las columnas
+ *
+ * ## Prioridad de configuración
+ *
+ * 1. defaultConfig (configuración inicial de columnas)
+ * 2. localStorage (preferencia guardada del usuario)
+ * 3. Valores por defecto de las columnas
+ * @param id - Identificador único del DataGrid
+ * @param columns - Columnas del DataGrid
+ * @param viewMode - Modo de visualización actual ('table' | 'cards')
+ * @param defaultConfig - Configuración inicial de columnas (opcional) para la vista de "table" es la que viene en cada columna su configuración (visible, frozen, etc.) y para la vista "cards" es la que viene en la configuración de cardsViewConfig.columnsConfig
+ * @param viewSpecificDefaults - Valores por defecto específicos de la vista
+ * @param originalViewSpecificDefaults - Valores originales específicos de la vista
+ * @returns Array de configuración de columnas ordenado por índice
+ * @example
+ * // Para vista table
+ * getInitialColumnsConfig(
+ *   'my-grid',
+ *   columns,
+ *   'table',
+ *   undefined,
+ *   { frozen: false },
+ *   { originalFrozen: false }
+ * );
+ *
+ * // Para vista cards
+ * getInitialColumnsConfig(
+ *   'my-grid',
+ *   columns,
+ *   'cards',
+ *   undefined,
+ *   { showTitle: true },
+ *   { originalShowTitle: true }
+ * );
+ */
+export declare const getInitialColumnsConfig: <TRow, TSummaryRow, TViewSpecific, TOriginalViewSpecific>(id: RowKey, columns: readonly Column<TRow, TSummaryRow>[], viewMode: ViewMode, defaultConfig?: BaseViewConfig<TViewSpecific>[], viewSpecificDefaults?: TViewSpecific, originalViewSpecificDefaults?: TOriginalViewSpecific) => IViewConfig<TViewSpecific, TOriginalViewSpecific>[];

package/components/DataGrid/helpers/getInitialColumnsConfig/getInitialColumnsConfig.js

@@ -0,0 +1,35 @@
+import { l as loadViewConfig } from "../loadViewConfig/loadViewConfig.js";
+import { g as getViewSuffix } from "../getViewSuffix/getViewSuffix.js";
+const getInitialColumnsConfig = (id, columns, viewMode, defaultConfig, viewSpecificDefaults, originalViewSpecificDefaults) => {
+  let columnsConfig;
+  if (defaultConfig) {
+    columnsConfig = defaultConfig;
+  } 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 : defaultConfig !== void 0 && defaultConfig.length > 0 ? false : 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);
+};
+export {
+  getInitialColumnsConfig as g
+};

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

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

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

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

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,41 @@
+import { Maybe } from '@m4l/core';
+import { RowKey } from '../../types';
+import { IGridConfigExtended, ViewMode } from '../../contexts/DataGridContext/types';
+/**
+ * Obtiene el modo de visualización del DataGrid.
+ *
+ * ## Flujo de persistencia
+ *
+ * Esta función obtiene el viewMode siguiendo una jerarquía de precedencia:
+ *
+ * 1. **defaultConfig.viewMode** (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.
+ *
+ * 3. **defaultViewMode** - Valor por defecto del desarrollador
+ * Se usa si no hay configuración guardada en ningún lado.
+ *
+ * ## Relación con saveViewMode
+ *
+ * - Cuando el usuario cambia de vista, `saveViewMode` envía los cambios
+ * mediante el callback `onChangeConfig`
+ * - En la siguiente carga, esos datos vuelven como `defaultConfig.viewMode`
+ * - localStorage es solo un fallback cuando no hay callback configurado
+ * @param id - Identificador único del DataGrid. Se usa como prefijo para la key en localStorage (fallback)
+ * @param defaultConfig - Configuración del usuario obtenida de cookies de red.
+ *                             Esta es la fuente principal en producción.
+ * @param defaultViewMode - Valor por defecto del desarrollador cuando no hay configuración guardada
+ * @returns El viewMode a usar, o undefined si no se encontró configuración
+ * @example
+ * // Sin configuración de cookies de red (usa localStorage como fallback)
+ * const viewMode = getViewMode('my-grid', null, 'table');
+ * @example
+ * // Con configuración de cookies de red (caso típico en producción)
+ * const viewMode = getViewMode('my-grid', { viewMode: 'cards' }, 'table');
+ * @see saveViewMode - Función complementaria para persistir la configuración
+ */
+export declare function getViewMode(id: RowKey, defaultConfig: Maybe<IGridConfigExtended>, defaultViewMode?: ViewMode): ViewMode | undefined;

package/components/DataGrid/helpers/getViewMode/getViewMode.js

@@ -0,0 +1,19 @@
+function getViewMode(id, defaultConfig, defaultViewMode) {
+  if (defaultConfig?.viewMode) {
+    return defaultConfig.viewMode;
+  }
+  try {
+    const savedViewMode = window.localStorage.getItem(`${id}_view_mode`);
+    if (savedViewMode === "cards" || savedViewMode === "table") {
+      return savedViewMode;
+    }
+  } catch (_e) {
+  }
+  if (defaultViewMode) {
+    return defaultViewMode;
+  }
+  return void 0;
+}
+export {
+  getViewMode as g
+};

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

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

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

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

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,28 @@
+import { ViewMode } from '../../contexts/DataGridContext/types';
+import { ViewSpecificConfig } from '../../types.helpers';
+/**
+ * Obtiene la configuración específica para cada modo de vista.
+ *
+ * ## Propósito
+ *
+ * Centraliza la lógica específica de cada ViewMode para evitar hardcoding
+ * disperso en el código. Cada vista tiene sus propias propiedades:
+ *
+ * - **table**: `frozen` (columnas fijas)
+ * - **cards**: `showTitle` (mostrar título en tarjetas)
+ *
+ * ## Estructura de retorno
+ *
+ * - `defaults`: Valores por defecto para nuevas columnas
+ * - `originalDefaults`: Valores originales para tracking
+ * - `dynamicOriginalProperty`: Función para extraer propiedades originales de items existentes
+ * @param viewMode - Modo de vista ('table' | 'cards')
+ * @returns Configuración específica del modo de vista
+ * @example
+ * const tableConfig = getViewSpecificConfig('table');
+ * // { defaults: { frozen: false }, originalDefaults: { originalFrozen: false }, ... }
+ * @example
+ * const cardsConfig = getViewSpecificConfig('cards');
+ * // { defaults: { showTitle: true }, originalDefaults: { originalShowTitle: true }, ... }
+ */
+export declare const getViewSpecificConfig: (viewMode: ViewMode) => ViewSpecificConfig;

package/components/DataGrid/helpers/getViewSpecificConfig/getViewSpecificConfig.js

@@ -0,0 +1,22 @@
+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;
+};
+export {
+  getViewSpecificConfig as g
+};

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

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

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

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

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,24 @@
+import { ViewMode } from '../../contexts/DataGridContext/types';
+/**
+ * Genera el sufijo de localStorage basado en el viewMode.
+ *
+ * ## Propósito
+ *
+ * Mantiene retrocompatibilidad con las keys de localStorage existentes:
+ * - Vista `table`: sin sufijo (retrocompatibilidad)
+ * - Vista `cards`: con sufijo `_cards`
+ * - Futuras vistas: con sufijo `_${viewMode}`
+ *
+ * ## Uso en localStorage
+ *
+ * ```
+ * table: `${id}_columns_config`
+ * cards: `${id}_columns_config_cards`
+ * ```
+ * @param viewMode - Modo de vista ('table' | 'cards')
+ * @returns Sufijo para la key de localStorage ('' para table, '_cards' para cards)
+ * @example
+ * getViewSuffix('table');  // ''
+ * getViewSuffix('cards');  // '_cards'
+ */
+export declare const getViewSuffix: (viewMode: ViewMode) => string;

package/components/DataGrid/helpers/getViewSuffix/getViewSuffix.js

@@ -0,0 +1,9 @@
+const getViewSuffix = (viewMode) => {
+  if (viewMode === "table") {
+    return "";
+  }
+  return `_${viewMode}`;
+};
+export {
+  getViewSuffix as g
+};

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

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

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

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

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,13 @@
+export * from './saveColumnsWidth';
+export * from './castMapColumnsWidthToRecord';
+export * from './getColumnsWidth';
+export * from './getColumnKey';
+export * from './getAllViewModes';
+export * from './getViewSpecificConfig';
+export * from './getViewSuffix';
+export * from './saveViewMode';
+export * from './getViewMode';
+export * from './loadViewConfig';
+export * from './saveViewConfig';
+export * from './getIndexRowHeightVariant';
+export * from './getInitialColumnsConfig';

package/components/DataGrid/helpers/index.js

@@ -0,0 +1 @@
+

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

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

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,23 @@
+import { RowKey } from '../../types';
+/**
+ * Carga configuraciones de vista desde localStorage.
+ *
+ * ## Propósito
+ *
+ * Recupera la configuración de columnas guardada previamente para una vista específica.
+ * Trabaja en conjunto con `saveViewConfig` y `getViewSuffix` para persistencia.
+ *
+ * ## Formato de key en localStorage
+ *
+ * ```
+ * table: `${id}_columns_config`
+ * cards: `${id}_columns_config_cards`
+ * ```
+ * @param id - Identificador único del DataGrid
+ * @param viewSuffix - Sufijo para identificar la vista ('' para table, '_cards' para cards)
+ * @returns Array de configuración o null si no existe/error
+ * @example
+ * loadViewConfig('my-grid', '');        // Lee 'my-grid_columns_config'
+ * loadViewConfig('my-grid', '_cards');  // Lee 'my-grid_columns_config_cards'
+ */
+export declare const loadViewConfig: <T>(id: RowKey, viewSuffix: string) => T[] | null;

package/components/DataGrid/helpers/loadViewConfig/loadViewConfig.js

@@ -0,0 +1,12 @@
+const 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;
+  }
+};
+export {
+  loadViewConfig as l
+};

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

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

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

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

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,52 @@
+import { Maybe } from '@m4l/core';
+import { RowKey, OnChangeConfig } from '../../types';
+/**
+ * Persiste la configuración de anchos de las columnas del DataGrid.
+ *
+ * ## Flujo de persistencia
+ *
+ * Esta función guarda los anchos de columnas siguiendo esta lógica:
+ *
+ * 1. **onChangeConfig** (Cookies de red) - Método principal en producción
+ * Si está disponible, envía la configuración al callback para que el consumidor
+ * la persista en cookies de red. En la siguiente carga, estos datos volverán
+ * como `defaultConfig` en `getColumnsWidth`.
+ *
+ * 2. **localStorage** - Fallback local
+ * Solo se usa cuando NO hay callback configurado.
+ * Útil para desarrollo o cuando no hay integración con cookies de red.
+ *
+ * ## Ciclo completo de persistencia
+ *
+ * ```
+ * Usuario redimensiona columna
+ * ↓
+ * saveColumnsWidth() envía via onChangeConfig
+ * ↓
+ * Se persiste en cookies de red
+ * ↓
+ * Próxima carga: datos vienen en defaultConfig
+ * ↓
+ * getColumnsWidth() lee de defaultConfig
+ * ```
+ * @param id - Identificador único del DataGrid. Se usa como prefijo en localStorage (fallback)
+ * @param storeColumnsWidth - Map con la configuración de anchos donde:
+ *                            - key: identificador de la columna (column.key)
+ *                            - value: ancho en píxeles (number) o string con unidad CSS
+ * @param onChangeConfig - Callback para enviar la configuración a cookies de red.
+ *                              Recibe un objeto con:
+ *                              - reason: 'columnsWidths' (identificador del tipo de cambio)
+ *                              - userConfig: Record con los anchos de columnas
+ * @example
+ * // Producción: Guardar mediante callback a cookies de red
+ * saveColumnsWidth('my-grid', columnsWidthsMap, ({ reason, userConfig }) => {
+ *   // Persistir en cookies de red
+ *   setCookie(userConfig);
+ * });
+ * @example
+ * // Desarrollo: Guardar en localStorage (sin cookies de red)
+ * saveColumnsWidth('my-grid', columnsWidthsMap);
+ * @see getColumnsWidth - Función complementaria para obtener la configuración
+ * @see castMapColumnsWidthToRecord - Helper usado para convertir el Map a Record
+ */
+export declare function saveColumnsWidth(id: RowKey, storeColumnsWidth: Map<string, Maybe<string | number>>, onChangeConfig?: OnChangeConfig): void;

package/components/DataGrid/helpers/saveColumnsWidth/saveColumnsWidth.js

@@ -0,0 +1,18 @@
+import { c as castMapColumnsWidthToRecord } from "../castMapColumnsWidthToRecord.js";
+function saveColumnsWidth(id, storeColumnsWidth, onChangeConfig) {
+  if (onChangeConfig) {
+    const columnsWidthObject = castMapColumnsWidthToRecord(storeColumnsWidth);
+    onChangeConfig({
+      reason: "columnsWidths",
+      userConfig: columnsWidthObject
+    });
+    return;
+  }
+  localStorage.setItem(
+    `${id}_columns_width`,
+    JSON.stringify([...storeColumnsWidth])
+  );
+}
+export {
+  saveColumnsWidth as s
+};

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

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

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

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

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,35 @@
+import { RowKey } from '../../types';
+/**
+ * Guarda configuraciones de vista en localStorage o notifica via callback.
+ *
+ * ## Propósito
+ *
+ * Persiste la configuración de columnas para una vista específica.
+ * Soporta dos modos: localStorage directo o callback externo (cookies de red).
+ *
+ * ## Prioridad de persistencia
+ *
+ * 1. Si hay `onChangeConfig`, notifica al callback (para guardar en cookies de red)
+ * 2. Si no hay callback, guarda directamente en localStorage
+ *
+ * ## Formato de key en localStorage
+ *
+ * ```
+ * table: `${id}_columns_config`
+ * cards: `${id}_columns_config_cards`
+ * ```
+ * @param id - Identificador único del DataGrid
+ * @param viewSuffix - Sufijo para identificar la vista ('' para table, '_cards' para cards)
+ * @param config - Array de configuración a guardar
+ * @param onChangeConfig - Callback opcional para notificar cambios (prioridad sobre localStorage)
+ * @example
+ * // Guardar en localStorage
+ * saveViewConfig('my-grid', '', config);
+ *
+ * // Notificar via callback
+ * saveViewConfig('my-grid', '_cards', config, onChangeConfig);
+ */
+export declare const saveViewConfig: <T>(id: RowKey, viewSuffix: string, config: T[], onChangeConfig?: (data: {
+    reason: string;
+    userConfig: T[];
+}) => void) => void;

package/components/DataGrid/helpers/saveViewConfig/saveViewConfig.js

@@ -0,0 +1,15 @@
+const saveViewConfig = (id, viewSuffix, config, onChangeConfig) => {
+  if (onChangeConfig) {
+    const reason = viewSuffix === "" ? "columnsConfig" : `columnsConfig${viewSuffix.replace("_", "").charAt(0).toUpperCase()}${viewSuffix.replace("_", "").slice(1)}`;
+    onChangeConfig({
+      reason,
+      userConfig: config
+    });
+    return;
+  }
+  const storageKey = viewSuffix === "" ? `${id}_columns_config` : `${id}_columns_config${viewSuffix}`;
+  localStorage.setItem(storageKey, JSON.stringify(config));
+};
+export {
+  saveViewConfig as s
+};

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

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

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

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

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,33 @@
+import { ViewMode } from '../../contexts/DataGridContext/types';
+import { OnChangeConfig, RowKey } from '../../types';
+/**
+ * Guarda el modo de visualización (table o cards).
+ *
+ * ## Propósito
+ *
+ * Persiste la preferencia del usuario sobre el modo de vista seleccionado.
+ * Permite que al recargar la página se mantenga la última vista utilizada.
+ *
+ * ## Prioridad de guardado
+ *
+ * 1. Si existe `onChangeConfig` → Guarda en cookies de red
+ * 2. Si no existe → Fallback a localStorage
+ *
+ * ## Formato de key en localStorage (fallback)
+ *
+ * ```
+ * `${id}_view_mode` -> 'table' | 'cards'
+ * ```
+ * @param id - Identificador único del DataGrid
+ * @param viewMode - Modo de visualización ('table' | 'cards')
+ * @param onChangeConfig - Callback opcional para guardar en cookies de red
+ * @example
+ * // Con cookies de red
+ * saveViewMode('my-grid', 'cards', onChangeConfig);
+ * // Llama: onChangeConfig({ reason: 'viewMode', userConfig: 'cards' })
+ *
+ * // Sin cookies de red (fallback)
+ * saveViewMode('my-grid', 'cards');
+ * // localStorage: 'my-grid_view_mode' = 'cards'
+ */
+export declare const saveViewMode: (id: RowKey, viewMode: ViewMode, onChangeConfig?: OnChangeConfig) => void;

package/components/DataGrid/helpers/saveViewMode/saveViewMode.js

@@ -0,0 +1,13 @@
+const saveViewMode = (id, viewMode, onChangeConfig) => {
+  if (onChangeConfig) {
+    onChangeConfig({
+      reason: "viewMode",
+      userConfig: viewMode
+    });
+    return;
+  }
+  localStorage.setItem(`${id}_view_mode`, viewMode);
+};
+export {
+  saveViewMode as s
+};

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

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

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

@@ -0,0 +1,6 @@
+export * from './useViewMode';
+export * from './useRowHeight';
+export * from './useColumnsWidth';
+export * from './useViewConfig';
+export * from './useChangeColumnsConfig';
+export * from './useChangeColumnsOrder';

package/components/DataGrid/hooks/index.js

@@ -0,0 +1 @@
+

package/components/DataGrid/hooks/useChangeColumnsConfig/index.d.ts

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

package/components/DataGrid/hooks/useChangeColumnsConfig/index.js

@@ -0,0 +1 @@
+

package/components/DataGrid/hooks/useChangeColumnsConfig/useChangeColumnsConfig.d.ts

@@ -0,0 +1,9 @@
+import { UseChangeColumnsConfigParams, UseChangeColumnsConfigReturn } from '../../types.hooks';
+/**
+ * Hook para manejar el cambio de configuración de columnas.
+ *
+ * Guarda la configuración en localStorage y actualiza el estado.
+ * @param params - Parámetros del hook
+ * @returns Función para cambiar la configuración de columnas
+ */
+export declare const useChangeColumnsConfig: ({ id, onChangeConfig, updateConfigColumns, }: UseChangeColumnsConfigParams) => UseChangeColumnsConfigReturn;