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

package/components/DataGrid/hooks/useRowHeight/useRowHeight.js

@@ -1,51 +0,0 @@
-import { useState, useCallback } from "react";
-import { g as getIndexRowHeightVariant } from "../../helpers/getIndexRowHeightVariant/getIndexRowHeightVariant.js";
-const useRowHeight = ({
-  rowHeights,
-  rowHeaderHeights,
-  initialRowHeightVariant
-}) => {
-  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
-    };
-  });
-  const setRowHeightVariant = 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)]
-      });
-    },
-    [rowHeights, rowHeaderHeights]
-  );
-  return {
-    currentRowHeightVariant,
-    setRowHeightVariant
-  };
-};
-export {
-  useRowHeight as u
-};

package/components/DataGrid/hooks/useRowHeight/useRowHeight.test.d.ts

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

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

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

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

@@ -1 +0,0 @@
-

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

@@ -1,9 +0,0 @@
-import { UseViewConfigReturn } from '../../types.hooks';
-/**
- * Hook para manejar el estado de la configuración de columnas por vista.
- *
- * Maneja un estado genérico unificado para las configuraciones de TODAS las vistas
- * (table, cards, etc).
- * @returns Estado y funciones para manejar la configuración de vistas
- */
-export declare const useViewConfig: () => UseViewConfigReturn;

package/components/DataGrid/hooks/useViewConfig/useViewConfig.js

@@ -1,30 +0,0 @@
-import { useState, useCallback } from "react";
-const useViewConfig = () => {
-  const [viewConfig, setViewConfig] = useState(() => ({
-    table: [],
-    cards: []
-  }));
-  const getConfigColumns = useCallback(
-    (viewModeParam) => {
-      return viewConfig[viewModeParam];
-    },
-    [viewConfig]
-  );
-  const updateConfigColumns = useCallback(
-    (viewModeParam, config) => {
-      setViewConfig((prev) => ({
-        ...prev,
-        [viewModeParam]: config
-      }));
-    },
-    []
-  );
-  return {
-    viewConfig,
-    getConfigColumns,
-    updateConfigColumns
-  };
-};
-export {
-  useViewConfig as u
-};

package/components/DataGrid/hooks/useViewConfig/useViewConfig.test.d.ts

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

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

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

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

@@ -1 +0,0 @@
-

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

@@ -1,44 +0,0 @@
-import { UseViewModeParams, UseViewModeReturn } from '../../types.hooks';
-/**
- * Hook para manejar el estado del modo de visualización (table/cards).
- *
- * ## Precedencia para determinar el viewMode inicial
- *
- * 1. `viewMode` prop - Modo controlado (el padre controla completamente el estado)
- * 2. localStorage - Preferencia del usuario guardada previamente
- * 3. `defaultViewMode` prop - Valor inicial establecido por el desarrollador
- * 4. `useIsMobile()` - Fallback automático según el dispositivo:
- *    - Móvil: 'cards'
- *    - Escritorio: 'table'
- *
- * ## Persistencia del viewMode
- *
- * - Si `onChangeUserColumns` está definido → Guarda en backend (cookies de red)
- * - Si no está definido → Fallback a localStorage
- *
- * ## Modo controlado vs no controlado
- *
- * - **Controlado**: Cuando se pasa `viewMode` prop, el padre controla el estado
- * - **No controlado**: El hook maneja internamente el estado y persiste
- * @param id - Identificador único del DataGrid
- * @param viewMode - ViewMode controlado por el padre (opcional)
- * @param defaultViewMode - ViewMode por defecto cuando no hay valor guardado (opcional)
- * @param onViewModeChange - Callback cuando cambia el viewMode (opcional)
- * @param onChangeUserColumns - Callback para guardar en backend (opcional)
- * @returns viewModeState - Estado actual del viewMode
- * @returns handleViewModeChange - Función para cambiar el viewMode
- * @example
- * // Con persistencia en backend
- * const { viewModeState, handleViewModeChange } = useViewMode({
- *   id: 'my-grid',
- *   defaultViewMode: 'table',
- *   onChangeUserColumns, // Guarda en backend
- * });
- *
- * // Sin backend (solo localStorage)
- * const { viewModeState, handleViewModeChange } = useViewMode({
- *   id: 'my-grid',
- *   defaultViewMode: 'table',
- * });
- */
-export declare const useViewMode: ({ id, viewMode, defaultViewMode, onViewModeChange, onChangeUserColumns, }: UseViewModeParams) => UseViewModeReturn;

package/components/DataGrid/hooks/useViewMode/useViewMode.js

@@ -1,48 +0,0 @@
-import { useState, useCallback, useEffect } from "react";
-import { useIsMobile } from "@m4l/graphics";
-import { s as saveViewMode } from "../../helpers/saveViewMode/saveViewMode.js";
-const useViewMode = ({
-  id,
-  viewMode,
-  defaultViewMode,
-  onViewModeChange,
-  onChangeUserColumns
-}) => {
-  const isMobile = useIsMobile();
-  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, onChangeUserColumns);
-      onViewModeChange?.(newViewMode);
-    },
-    [id, onViewModeChange, onChangeUserColumns]
-  );
-  useEffect(() => {
-    if (viewMode !== void 0) {
-      setViewModeState(viewMode);
-    }
-  }, [viewMode]);
-  return {
-    viewModeState,
-    handleViewModeChange
-  };
-};
-export {
-  useViewMode as u
-};

package/components/DataGrid/hooks/useViewMode/useViewMode.test.d.ts

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

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

@@ -1,55 +0,0 @@
-import { RowKey } from './types';
-import { BaseConfigColumn } from './contexts/DataGridContext/types';
-/**
- * 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
- * de columnas sin importar el tipo de vista (table, cards, etc).
- * @example
- * // Para vista table
- * BaseViewConfig<{ frozen: boolean }>
- *
- * // Para vista cards
- * BaseViewConfig<{ showTitle: boolean }>
- */
-export type BaseViewConfig<TViewSpecific = object> = TViewSpecific & {
-    key: string;
-    visible: boolean;
-    index: number;
-    name?: string;
-};
-/**
- *
- *Este tipo define la estructura de configuración que el usuario puede
- *pasar al DataGrid para personalizar columnas y sus anchos.
- *
- *- `columnsConfig`: Configuración de visibilidad y orden de columnas para vista table
- *- `columnsWidths`: Anchos personalizados de columnas
- * @example
- * ```typescript
- * const userConfig: IGridConfig = {
- *   columnsConfig: [
- *     { key: 'name', visible: true, index: 0, frozen: false },
- *     { key: 'email', visible: true, index: 1, frozen: false },
- *   ],
- *   columnsWidths: { name: 200, email: 300 }
- * };
- * ```
- */
-export interface IGridConfig {
-    /** Configuración de columnas para vista table (visibilidad, orden, frozen) */
-    columnsConfig: BaseConfigColumn[];
-    /** Anchos de columnas en píxeles */
-    columnsWidths: Record<RowKey, number>;
-}
-/**
- * Configuración específica retornada por getViewSpecificConfig
- */
-export interface ViewSpecificConfig {
-    /** Valores por defecto para propiedades específicas de la vista */
-    defaults: Record<string, unknown>;
-    /** Valores originales por defecto para tracking de cambios */
-    originalDefaults: Record<string, unknown>;
-    /** Función para obtener propiedades originales dinámicas de un item */
-    dynamicOriginalProperty: (item: unknown) => Record<string, unknown>;
-}

package/components/DataGrid/types.helpers.js

@@ -1 +0,0 @@
-

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

@@ -1,79 +0,0 @@
-import { RowKey, RowHeightVariants, RowHeights, OnChangeUserColumns } from './types';
-import { Maybe } from '@m4l/core';
-import { IViewConfig, RowHeightState, ViewMode } from './contexts/DataGridContext/types';
-export interface UseViewModeParams {
-    /** Identificador único del DataGrid */
-    id: RowKey;
-    /** ViewMode controlado por el padre */
-    viewMode?: ViewMode;
-    /** ViewMode por defecto cuando no hay valor guardado */
-    defaultViewMode?: ViewMode;
-    /** Callback cuando cambia el viewMode */
-    onViewModeChange?: (viewMode: ViewMode) => void;
-    /** Callback para guardar cambios en backend (cookies de red) */
-    onChangeUserColumns?: OnChangeUserColumns;
-}
-export interface UseViewModeReturn {
-    /** Estado actual del viewMode */
-    viewModeState: ViewMode;
-    /** Función para cambiar el viewMode */
-    handleViewModeChange: (newViewMode: ViewMode) => void;
-}
-export interface UseRowHeightParams {
-    /** Alturas de las filas (número fijo o array de 3 elementos) */
-    rowHeights: RowHeights;
-    /** Alturas de los headers (número fijo o array de 3 elementos) */
-    rowHeaderHeights: RowHeights;
-    /** Variant inicial de altura */
-    initialRowHeightVariant: RowHeightVariants;
-}
-export interface UseRowHeightReturn {
-    /** Estado actual de la altura de filas */
-    currentRowHeightVariant: RowHeightState;
-    /** Función para cambiar el variant de altura */
-    setRowHeightVariant: (newVariant: RowHeightVariants) => void;
-}
-export interface UseColumnsWidthParams {
-    /** Identificador único del DataGrid */
-    id: RowKey;
-    /** Callback para guardar cambios en columnas */
-    onChangeUserColumns?: OnChangeUserColumns;
-}
-export interface UseColumnsWidthReturn {
-    /** Mapa con el ancho de cada columna */
-    columnsWidths: Map<string, Maybe<string | number>>;
-    /** Función para establecer el mapa de anchos */
-    setColumnsWidths: React.Dispatch<React.SetStateAction<Map<string, Maybe<string | number>>>>;
-    /** Función para cambiar el ancho de una columna */
-    onChangeColumnWidth: (columnKey: string, width: number) => void;
-}
-export interface UseViewConfigReturn {
-    /** Estado de configuración por vista */
-    viewConfig: Record<ViewMode, IViewConfig<any, any>[]>;
-    /** Obtiene la configuración de columnas para una vista */
-    getConfigColumns: (viewMode: ViewMode) => IViewConfig<any, any>[];
-    /** Actualiza la configuración de columnas para una vista */
-    updateConfigColumns: (viewMode: ViewMode, config: IViewConfig<any, any>[]) => void;
-}
-export interface UseChangeColumnsConfigParams {
-    /** Identificador único del DataGrid */
-    id: RowKey;
-    /** Callback para guardar cambios en columnas */
-    onChangeUserColumns?: OnChangeUserColumns;
-    /** Función para actualizar la configuración de columnas */
-    updateConfigColumns: (viewMode: ViewMode, config: IViewConfig<any, any>[]) => void;
-}
-export interface UseChangeColumnsConfigReturn {
-    /** Función para cambiar la configuración de columnas de una vista */
-    onChangeColumnsConfig: (viewMode: ViewMode, newConfig: IViewConfig<any, any>[]) => void;
-}
-export interface UseChangeColumnsOrderParams {
-    /** Función para obtener la configuración de columnas de una vista */
-    getConfigColumns: (viewMode: ViewMode) => IViewConfig<any, any>[];
-    /** Función para cambiar la configuración de columnas */
-    onChangeColumnsConfig: (viewMode: ViewMode, newConfig: IViewConfig<any, any>[]) => void;
-}
-export interface UseChangeColumnsOrderReturn {
-    /** Función para cambiar el orden de columnas de una vista */
-    onChangeColumnsOrder: (viewMode: ViewMode, sourceKey: string, targetKey: string) => void;
-}