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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (169) hide show
  1. package/@types/types.d.ts +9 -1
  2. package/components/AccountPopover/slots/AccountPopoverSlots.d.ts +3 -3
  3. package/components/ActionsGroup/ActionsGroup.d.ts +5 -0
  4. package/components/ActionsGroup/ActionsGroup.js +40 -0
  5. package/components/ActionsGroup/ActionsGroup.styles.d.ts +2 -0
  6. package/components/ActionsGroup/ActionsGroup.styles.js +95 -0
  7. package/components/ActionsGroup/constants.d.ts +2 -0
  8. package/components/ActionsGroup/constants.js +8 -0
  9. package/components/ActionsGroup/icons.d.ts +3 -0
  10. package/components/ActionsGroup/icons.js +6 -0
  11. package/components/ActionsGroup/index.d.ts +1 -0
  12. package/components/ActionsGroup/slots/ActionsGroupEnum.d.ts +8 -0
  13. package/components/ActionsGroup/slots/ActionsGroupEnum.js +12 -0
  14. package/components/ActionsGroup/slots/ActionsGroupSlots.d.ts +15 -0
  15. package/components/ActionsGroup/slots/ActionsGroupSlots.js +35 -0
  16. package/components/ActionsGroup/subcomponents/ActionIconButton/ActionIconButton.d.ts +6 -0
  17. package/components/ActionsGroup/subcomponents/ActionIconButton/ActionIconButton.js +76 -0
  18. package/components/ActionsGroup/subcomponents/ActionIconButton/types.d.ts +7 -0
  19. package/components/ActionsGroup/types.d.ts +60 -0
  20. package/components/Chip/slots/ChipSlots.d.ts +1 -1
  21. package/components/DataGrid/contexts/DataGridContext/index.js +268 -39
  22. package/components/DataGrid/contexts/DataGridContext/types.d.ts +20 -3
  23. package/components/DataGrid/index.d.ts +4 -5
  24. package/components/EditLabel/slots/EditLabelSlots.d.ts +1 -1
  25. package/components/HelperError/slots/HelperErrorSlots.d.ts +1 -1
  26. package/components/ImageText/slots/ImageTextSlots.d.ts +2 -2
  27. package/components/Label/index.d.ts +1 -1
  28. package/components/Label/slots/LabelSlots.d.ts +2 -2
  29. package/components/Label/types.d.ts +6 -0
  30. package/components/LoadingError/slots/LoadingErrorSlots.d.ts +1 -1
  31. package/components/Pager/slots/PagerSlots.d.ts +3 -3
  32. package/components/PaperForm/slots/PaperFormSlots.d.ts +1 -1
  33. package/components/SettingsLayout/slots/SettingsLayoutSlots.d.ts +1 -1
  34. package/components/Stepper/slots/StepperSlot.d.ts +4 -4
  35. package/components/TabsNavigator/slots/TabsNavigatorSlots.d.ts +12 -12
  36. package/components/ToastContainer/slots/toastContainerSlots.d.ts +2 -2
  37. package/components/WindowBase/WindowBase.styles.js +8 -0
  38. package/components/WindowBase/slots/WindowBaseSlots.d.ts +2 -2
  39. package/components/WindowBase/subcomponents/Header/useButtonActions.js +23 -13
  40. package/components/areas/components/AreasAdmin/slots/AreasAdminSlots.d.ts +1 -1
  41. package/components/formatters/BooleanFormatter/slots/BooleanFormatterSlots.d.ts +1 -1
  42. package/components/formatters/ConcatenatedFormatter/slots/ConcatenatedFormatterSlots.d.ts +1 -1
  43. package/components/formatters/DateFormatter/slots/DateFormatterSlots.d.ts +1 -1
  44. package/components/formatters/DistanceToNowFormatter/slots/DistanceToNowFormatterSlots.d.ts +1 -1
  45. package/components/formatters/ImageFormatter/slots/ImageFormatterSlots.d.ts +1 -1
  46. package/components/formatters/PeriodFormatter/slots/PeriodFormatterSlots.d.ts +1 -1
  47. package/components/formatters/PointsFormatter/slots/ointsFormatterSlots.d.ts +1 -1
  48. package/components/formatters/PriceFormatter/slots/PriceFormatterSlots.d.ts +1 -1
  49. package/components/formatters/UncertaintyFormatter/slots/UncertaintyFormatterSlots.d.ts +1 -1
  50. package/components/hook-form/RHFActionsGroup/RHFActionsGroup.d.ts +7 -0
  51. package/components/hook-form/RHFActionsGroup/RHFActionsGroup.js +87 -0
  52. package/components/hook-form/RHFActionsGroup/RHFActionsGroupStyles.d.ts +2 -0
  53. package/components/hook-form/RHFActionsGroup/RHFActionsGroupStyles.js +14 -0
  54. package/components/hook-form/RHFActionsGroup/constants.d.ts +9 -0
  55. package/components/hook-form/RHFActionsGroup/constants.js +8 -0
  56. package/components/hook-form/RHFActionsGroup/index.d.ts +2 -0
  57. package/components/hook-form/RHFActionsGroup/slots/RHFActionsGroupEnum.d.ts +3 -0
  58. package/components/hook-form/RHFActionsGroup/slots/RHFActionsGroupEnum.js +7 -0
  59. package/components/hook-form/RHFActionsGroup/slots/RHFActionsGroupSlots.d.ts +1 -0
  60. package/components/hook-form/RHFActionsGroup/slots/RHFActionsGroupSlots.js +11 -0
  61. package/components/hook-form/RHFActionsGroup/slots/index.d.ts +2 -0
  62. package/components/hook-form/RHFActionsGroup/tests/common.d.ts +28 -0
  63. package/components/hook-form/RHFActionsGroup/types.d.ts +54 -0
  64. package/components/hook-form/RHFUpload/RHFUploadImage/slots/RHFUploadImageSlots.d.ts +1 -1
  65. package/components/hook-form/RHFUpload/RHFUploadSingleFile/slots/RHFUploadSingleFileSlots.d.ts +5 -5
  66. package/components/hook-form/index.d.ts +1 -0
  67. package/components/index.d.ts +1 -0
  68. package/components/mui_extended/Accordion/slots/AccordionSlots.d.ts +1 -1
  69. package/components/mui_extended/Autocomplete/slots/AutocompleteSlots.d.ts +2 -2
  70. package/components/mui_extended/Button/slots/ButtonSlots.d.ts +1 -1
  71. package/components/mui_extended/CheckBox/slots/CheckBoxSlots.d.ts +1 -1
  72. package/components/mui_extended/MenuItem/slots/MenuItemSlots.d.ts +1 -1
  73. package/components/mui_extended/NavLink/slots/NavLinkSlots.d.ts +1 -1
  74. package/components/mui_extended/Select/slots/SelectSlots.d.ts +3 -3
  75. package/components/mui_extended/Tab/Slots/TabSlots.d.ts +1 -1
  76. package/components/mui_extended/TextField/slots/TextFieldSlots.d.ts +3 -3
  77. package/components/mui_extended/Tooltip/Tooltip.styles.js +22 -4
  78. package/hooks/useDataGridPersistence/constants.d.ts +0 -1
  79. package/hooks/useDataGridPersistence/constants.js +2 -4
  80. package/hooks/useDataGridPersistence/useDataGridPersistence.js +2 -5
  81. package/index.js +34 -30
  82. package/package.json +1 -1
  83. package/components/DataGrid/helpers/getAllViewModes/getAllViewModes.d.ts +0 -19
  84. package/components/DataGrid/helpers/getAllViewModes/getAllViewModes.js +0 -6
  85. package/components/DataGrid/helpers/getAllViewModes/index.d.ts +0 -1
  86. package/components/DataGrid/helpers/getColumnsWidth/getColumnsWidth.d.ts +0 -47
  87. package/components/DataGrid/helpers/getColumnsWidth/getColumnsWidth.js +0 -32
  88. package/components/DataGrid/helpers/getColumnsWidth/index.d.ts +0 -1
  89. package/components/DataGrid/helpers/getIndexRowHeightVariant/getIndexRowHeightVariant.d.ts +0 -24
  90. package/components/DataGrid/helpers/getIndexRowHeightVariant/getIndexRowHeightVariant.js +0 -12
  91. package/components/DataGrid/helpers/getIndexRowHeightVariant/getIndexRowHeightVariant.test.d.ts +0 -1
  92. package/components/DataGrid/helpers/getIndexRowHeightVariant/index.d.ts +0 -1
  93. package/components/DataGrid/helpers/getInitialColumnsConfig/getInitialColumnsConfig.d.ts +0 -48
  94. package/components/DataGrid/helpers/getInitialColumnsConfig/getInitialColumnsConfig.js +0 -35
  95. package/components/DataGrid/helpers/getInitialColumnsConfig/getInitialColumnsConfig.test.d.ts +0 -1
  96. package/components/DataGrid/helpers/getInitialColumnsConfig/index.d.ts +0 -1
  97. package/components/DataGrid/helpers/getInitialColumnsConfig/index.js +0 -1
  98. package/components/DataGrid/helpers/getViewSpecificConfig/getViewSpecificConfig.d.ts +0 -28
  99. package/components/DataGrid/helpers/getViewSpecificConfig/getViewSpecificConfig.js +0 -22
  100. package/components/DataGrid/helpers/getViewSpecificConfig/getViewSpecificConfig.test.d.ts +0 -1
  101. package/components/DataGrid/helpers/getViewSpecificConfig/index.d.ts +0 -1
  102. package/components/DataGrid/helpers/getViewSpecificConfig/index.js +0 -1
  103. package/components/DataGrid/helpers/getViewSuffix/getViewSuffix.d.ts +0 -24
  104. package/components/DataGrid/helpers/getViewSuffix/getViewSuffix.js +0 -9
  105. package/components/DataGrid/helpers/getViewSuffix/getViewSuffix.test.d.ts +0 -1
  106. package/components/DataGrid/helpers/getViewSuffix/index.d.ts +0 -1
  107. package/components/DataGrid/helpers/getViewSuffix/index.js +0 -1
  108. package/components/DataGrid/helpers/index.d.ts +0 -12
  109. package/components/DataGrid/helpers/index.js +0 -1
  110. package/components/DataGrid/helpers/loadViewConfig/index.d.ts +0 -1
  111. package/components/DataGrid/helpers/loadViewConfig/index.js +0 -1
  112. package/components/DataGrid/helpers/loadViewConfig/loadViewConfig.d.ts +0 -23
  113. package/components/DataGrid/helpers/loadViewConfig/loadViewConfig.js +0 -12
  114. package/components/DataGrid/helpers/loadViewConfig/loadViewConfig.test.d.ts +0 -1
  115. package/components/DataGrid/helpers/saveColumnsWidth/index.d.ts +0 -1
  116. package/components/DataGrid/helpers/saveColumnsWidth/index.js +0 -1
  117. package/components/DataGrid/helpers/saveColumnsWidth/saveColumnsWidth.d.ts +0 -52
  118. package/components/DataGrid/helpers/saveColumnsWidth/saveColumnsWidth.js +0 -18
  119. package/components/DataGrid/helpers/saveColumnsWidth/saveColumnsWidth.test.d.ts +0 -1
  120. package/components/DataGrid/helpers/saveViewConfig/index.d.ts +0 -1
  121. package/components/DataGrid/helpers/saveViewConfig/index.js +0 -1
  122. package/components/DataGrid/helpers/saveViewConfig/saveViewConfig.d.ts +0 -35
  123. package/components/DataGrid/helpers/saveViewConfig/saveViewConfig.js +0 -15
  124. package/components/DataGrid/helpers/saveViewConfig/saveViewConfig.test.d.ts +0 -1
  125. package/components/DataGrid/helpers/saveViewMode/index.d.ts +0 -1
  126. package/components/DataGrid/helpers/saveViewMode/index.js +0 -1
  127. package/components/DataGrid/helpers/saveViewMode/saveViewMode.d.ts +0 -33
  128. package/components/DataGrid/helpers/saveViewMode/saveViewMode.js +0 -13
  129. package/components/DataGrid/helpers/saveViewMode/saveViewMode.test.d.ts +0 -1
  130. package/components/DataGrid/hooks/index.d.ts +0 -6
  131. package/components/DataGrid/hooks/index.js +0 -1
  132. package/components/DataGrid/hooks/useChangeColumnsConfig/index.d.ts +0 -1
  133. package/components/DataGrid/hooks/useChangeColumnsConfig/index.js +0 -1
  134. package/components/DataGrid/hooks/useChangeColumnsConfig/useChangeColumnsConfig.d.ts +0 -9
  135. package/components/DataGrid/hooks/useChangeColumnsConfig/useChangeColumnsConfig.js +0 -27
  136. package/components/DataGrid/hooks/useChangeColumnsConfig/useChangeColumnsConfig.test.d.ts +0 -1
  137. package/components/DataGrid/hooks/useChangeColumnsOrder/index.d.ts +0 -1
  138. package/components/DataGrid/hooks/useChangeColumnsOrder/index.js +0 -1
  139. package/components/DataGrid/hooks/useChangeColumnsOrder/useChangeColumnsOrder.d.ts +0 -10
  140. package/components/DataGrid/hooks/useChangeColumnsOrder/useChangeColumnsOrder.js +0 -34
  141. package/components/DataGrid/hooks/useChangeColumnsOrder/useChangeColumnsOrder.test.d.ts +0 -1
  142. package/components/DataGrid/hooks/useColumnsWidth/index.d.ts +0 -1
  143. package/components/DataGrid/hooks/useColumnsWidth/index.js +0 -1
  144. package/components/DataGrid/hooks/useColumnsWidth/useColumnsWidth.d.ts +0 -11
  145. package/components/DataGrid/hooks/useColumnsWidth/useColumnsWidth.js +0 -29
  146. package/components/DataGrid/hooks/useColumnsWidth/useColumnsWidth.test.d.ts +0 -1
  147. package/components/DataGrid/hooks/useRowHeight/index.d.ts +0 -1
  148. package/components/DataGrid/hooks/useRowHeight/index.js +0 -1
  149. package/components/DataGrid/hooks/useRowHeight/useRowHeight.d.ts +0 -28
  150. package/components/DataGrid/hooks/useRowHeight/useRowHeight.js +0 -51
  151. package/components/DataGrid/hooks/useRowHeight/useRowHeight.test.d.ts +0 -1
  152. package/components/DataGrid/hooks/useViewConfig/index.d.ts +0 -1
  153. package/components/DataGrid/hooks/useViewConfig/index.js +0 -1
  154. package/components/DataGrid/hooks/useViewConfig/useViewConfig.d.ts +0 -9
  155. package/components/DataGrid/hooks/useViewConfig/useViewConfig.js +0 -30
  156. package/components/DataGrid/hooks/useViewConfig/useViewConfig.test.d.ts +0 -1
  157. package/components/DataGrid/hooks/useViewMode/index.d.ts +0 -1
  158. package/components/DataGrid/hooks/useViewMode/index.js +0 -1
  159. package/components/DataGrid/hooks/useViewMode/useViewMode.d.ts +0 -44
  160. package/components/DataGrid/hooks/useViewMode/useViewMode.js +0 -48
  161. package/components/DataGrid/hooks/useViewMode/useViewMode.test.d.ts +0 -1
  162. package/components/DataGrid/types.helpers.d.ts +0 -55
  163. package/components/DataGrid/types.helpers.js +0 -1
  164. package/components/DataGrid/types.hooks.d.ts +0 -79
  165. /package/components/{DataGrid/helpers/getAllViewModes/getAllViewModes.test.d.ts → ActionsGroup/__tests__/ActionsGroup.test.d.ts} +0 -0
  166. /package/components/{DataGrid/helpers/getAllViewModes → ActionsGroup}/index.js +0 -0
  167. /package/components/{DataGrid/helpers/getColumnsWidth → hook-form/RHFActionsGroup}/index.js +0 -0
  168. /package/components/{DataGrid/helpers/getIndexRowHeightVariant → hook-form/RHFActionsGroup/slots}/index.js +0 -0
  169. /package/components/{DataGrid/helpers/getColumnsWidth/getColumnsWidth.test.d.ts → hook-form/RHFActionsGroup/tests/RHFActionsGroup.test.d.ts} +0 -0
@@ -1,35 +0,0 @@
1
- import { l as loadViewConfig } from "../loadViewConfig/loadViewConfig.js";
2
- import { g as getViewSuffix } from "../getViewSuffix/getViewSuffix.js";
3
- const getInitialColumnsConfig = (id, columns, viewMode, defaultUserConfig, viewSpecificDefaults, originalViewSpecificDefaults) => {
4
- let columnsConfig;
5
- if (defaultUserConfig) {
6
- columnsConfig = defaultUserConfig;
7
- } else {
8
- columnsConfig = loadViewConfig(
9
- id,
10
- getViewSuffix(viewMode)
11
- ) || [];
12
- }
13
- return columns.map((column, index) => {
14
- const existingConfig = columnsConfig.find((c) => c.key === column.key);
15
- const columnConfigIndex = existingConfig ? columnsConfig.indexOf(existingConfig) : -1;
16
- const baseConfig = {
17
- key: column.key,
18
- name: typeof column.name === "string" ? column.name : String(column.name),
19
- hidden: column.hidden === void 0 ? false : column.hidden,
20
- index: columnConfigIndex > -1 ? columnConfigIndex : index,
21
- visible: existingConfig?.visible !== void 0 ? existingConfig.visible : column.visible === void 0 ? true : column.visible,
22
- originalIndex: index,
23
- originalVisible: column.visible === void 0 ? true : column.visible
24
- };
25
- return {
26
- ...baseConfig,
27
- ...viewSpecificDefaults,
28
- ...originalViewSpecificDefaults,
29
- ...existingConfig || {}
30
- };
31
- }).sort((a, b) => a.index - b.index);
32
- };
33
- export {
34
- getInitialColumnsConfig as g
35
- };
@@ -1 +0,0 @@
1
- export { getInitialColumnsConfig } from './getInitialColumnsConfig';
@@ -1,28 +0,0 @@
1
- import { ViewMode } from '../../contexts/DataGridContext/types';
2
- import { ViewSpecificConfig } from '../../types.helpers';
3
- /**
4
- * Obtiene la configuración específica para cada modo de vista.
5
- *
6
- * ## Propósito
7
- *
8
- * Centraliza la lógica específica de cada ViewMode para evitar hardcoding
9
- * disperso en el código. Cada vista tiene sus propias propiedades:
10
- *
11
- * - **table**: `frozen` (columnas fijas)
12
- * - **cards**: `showTitle` (mostrar título en tarjetas)
13
- *
14
- * ## Estructura de retorno
15
- *
16
- * - `defaults`: Valores por defecto para nuevas columnas
17
- * - `originalDefaults`: Valores originales para tracking
18
- * - `dynamicOriginalProperty`: Función para extraer propiedades originales de items existentes
19
- * @param viewMode - Modo de vista ('table' | 'cards')
20
- * @returns Configuración específica del modo de vista
21
- * @example
22
- * const tableConfig = getViewSpecificConfig('table');
23
- * // { defaults: { frozen: false }, originalDefaults: { originalFrozen: false }, ... }
24
- * @example
25
- * const cardsConfig = getViewSpecificConfig('cards');
26
- * // { defaults: { showTitle: true }, originalDefaults: { originalShowTitle: true }, ... }
27
- */
28
- export declare const getViewSpecificConfig: (viewMode: ViewMode) => ViewSpecificConfig;
@@ -1,22 +0,0 @@
1
- const getViewSpecificConfig = (viewMode) => {
2
- const configs = {
3
- table: {
4
- defaults: { frozen: false },
5
- originalDefaults: { originalFrozen: false },
6
- dynamicOriginalProperty: (item) => ({
7
- originalFrozen: item?.frozen ?? false
8
- })
9
- },
10
- cards: {
11
- defaults: { showTitle: true },
12
- originalDefaults: { originalShowTitle: true },
13
- dynamicOriginalProperty: (item) => ({
14
- originalShowTitle: item?.showTitle ?? true
15
- })
16
- }
17
- };
18
- return configs[viewMode] || configs.table;
19
- };
20
- export {
21
- getViewSpecificConfig as g
22
- };
@@ -1 +0,0 @@
1
- export { getViewSpecificConfig } from './getViewSpecificConfig';
@@ -1,24 +0,0 @@
1
- import { ViewMode } from '../../contexts/DataGridContext/types';
2
- /**
3
- * Genera el sufijo de localStorage basado en el viewMode.
4
- *
5
- * ## Propósito
6
- *
7
- * Mantiene retrocompatibilidad con las keys de localStorage existentes:
8
- * - Vista `table`: sin sufijo (retrocompatibilidad)
9
- * - Vista `cards`: con sufijo `_cards`
10
- * - Futuras vistas: con sufijo `_${viewMode}`
11
- *
12
- * ## Uso en localStorage
13
- *
14
- * ```
15
- * table: `${id}_columns_config`
16
- * cards: `${id}_columns_config_cards`
17
- * ```
18
- * @param viewMode - Modo de vista ('table' | 'cards')
19
- * @returns Sufijo para la key de localStorage ('' para table, '_cards' para cards)
20
- * @example
21
- * getViewSuffix('table'); // ''
22
- * getViewSuffix('cards'); // '_cards'
23
- */
24
- export declare const getViewSuffix: (viewMode: ViewMode) => string;
@@ -1,9 +0,0 @@
1
- const getViewSuffix = (viewMode) => {
2
- if (viewMode === "table") {
3
- return "";
4
- }
5
- return `_${viewMode}`;
6
- };
7
- export {
8
- getViewSuffix as g
9
- };
@@ -1 +0,0 @@
1
- export { getViewSuffix } from './getViewSuffix';
@@ -1,12 +0,0 @@
1
- export * from './saveColumnsWidth';
2
- export * from './castMapColumnsWidthToRecord';
3
- export * from './getColumnsWidth';
4
- export * from './getColumnKey';
5
- export * from './getAllViewModes';
6
- export * from './getViewSpecificConfig';
7
- export * from './getViewSuffix';
8
- export * from './saveViewMode';
9
- export * from './loadViewConfig';
10
- export * from './saveViewConfig';
11
- export * from './getIndexRowHeightVariant';
12
- export * from './getInitialColumnsConfig';
@@ -1 +0,0 @@
1
-
@@ -1 +0,0 @@
1
- export { loadViewConfig } from './loadViewConfig';
@@ -1,23 +0,0 @@
1
- import { RowKey } from '../../types';
2
- /**
3
- * Carga configuraciones de vista desde localStorage.
4
- *
5
- * ## Propósito
6
- *
7
- * Recupera la configuración de columnas guardada previamente para una vista específica.
8
- * Trabaja en conjunto con `saveViewConfig` y `getViewSuffix` para persistencia.
9
- *
10
- * ## Formato de key en localStorage
11
- *
12
- * ```
13
- * table: `${id}_columns_config`
14
- * cards: `${id}_columns_config_cards`
15
- * ```
16
- * @param id - Identificador único del DataGrid
17
- * @param viewSuffix - Sufijo para identificar la vista ('' para table, '_cards' para cards)
18
- * @returns Array de configuración o null si no existe/error
19
- * @example
20
- * loadViewConfig('my-grid', ''); // Lee 'my-grid_columns_config'
21
- * loadViewConfig('my-grid', '_cards'); // Lee 'my-grid_columns_config_cards'
22
- */
23
- export declare const loadViewConfig: <T>(id: RowKey, viewSuffix: string) => T[] | null;
@@ -1,12 +0,0 @@
1
- const loadViewConfig = (id, viewSuffix) => {
2
- try {
3
- const storageKey = viewSuffix === "" ? `${id}_columns_config` : `${id}_columns_config${viewSuffix}`;
4
- const stored = localStorage.getItem(storageKey);
5
- return stored ? JSON.parse(stored) : null;
6
- } catch (_e) {
7
- return null;
8
- }
9
- };
10
- export {
11
- loadViewConfig as l
12
- };
@@ -1 +0,0 @@
1
- export { saveColumnsWidth } from './saveColumnsWidth';
@@ -1,52 +0,0 @@
1
- import { Maybe } from '@m4l/core';
2
- import { RowKey, OnChangeUserColumns } from '../../types';
3
- /**
4
- * Persiste la configuración de anchos de las columnas del DataGrid.
5
- *
6
- * ## Flujo de persistencia
7
- *
8
- * Esta función guarda los anchos de columnas siguiendo esta lógica:
9
- *
10
- * 1. **onChangeUserColumns** (Backend/API) - Método principal en producción
11
- * Si está disponible, envía la configuración al callback para que el consumidor
12
- * la persista en el backend. En la siguiente carga, estos datos volverán
13
- * como `defaultUserColumns` en `getColumnsWidth`.
14
- *
15
- * 2. **localStorage** - Fallback local
16
- * Solo se usa cuando NO hay callback configurado.
17
- * Útil para desarrollo o cuando no hay integración con backend.
18
- *
19
- * ## Ciclo completo de persistencia
20
- *
21
- * ```
22
- * Usuario redimensiona columna
23
- * ↓
24
- * saveColumnsWidth() envía al backend via onChangeUserColumns
25
- * ↓
26
- * Backend persiste en BD/cookies
27
- * ↓
28
- * Próxima carga: datos vienen en defaultUserColumns
29
- * ↓
30
- * getColumnsWidth() lee de defaultUserColumns
31
- * ```
32
- * @param id - Identificador único del DataGrid. Se usa como prefijo en localStorage (fallback)
33
- * @param storeColumnsWidth - Map con la configuración de anchos donde:
34
- * - key: identificador de la columna (column.key)
35
- * - value: ancho en píxeles (number) o string con unidad CSS
36
- * @param onChangeUserColumns - Callback para enviar la configuración al backend.
37
- * Recibe un objeto con:
38
- * - reason: 'columnsWidths' (identificador del tipo de cambio)
39
- * - userConfig: Record con los anchos de columnas
40
- * @example
41
- * // Producción: Guardar mediante callback al backend
42
- * saveColumnsWidth('my-grid', columnsWidthsMap, ({ reason, userConfig }) => {
43
- * // El backend persiste en BD o cookies
44
- * api.saveUserPreferences(userConfig);
45
- * });
46
- * @example
47
- * // Desarrollo: Guardar en localStorage (sin backend)
48
- * saveColumnsWidth('my-grid', columnsWidthsMap);
49
- * @see getColumnsWidth - Función complementaria para obtener la configuración
50
- * @see castMapColumnsWidthToRecord - Helper usado para convertir el Map a Record
51
- */
52
- export declare function saveColumnsWidth(id: RowKey, storeColumnsWidth: Map<string, Maybe<string | number>>, onChangeUserColumns?: OnChangeUserColumns): void;
@@ -1,18 +0,0 @@
1
- import { c as castMapColumnsWidthToRecord } from "../castMapColumnsWidthToRecord.js";
2
- function saveColumnsWidth(id, storeColumnsWidth, onChangeUserColumns) {
3
- if (onChangeUserColumns) {
4
- const columnsWidthObject = castMapColumnsWidthToRecord(storeColumnsWidth);
5
- onChangeUserColumns({
6
- reason: "columnsWidths",
7
- userConfig: columnsWidthObject
8
- });
9
- return;
10
- }
11
- localStorage.setItem(
12
- `${id}_columns_width`,
13
- JSON.stringify([...storeColumnsWidth])
14
- );
15
- }
16
- export {
17
- saveColumnsWidth as s
18
- };
@@ -1 +0,0 @@
1
- export { saveViewConfig } from './saveViewConfig';
@@ -1,35 +0,0 @@
1
- import { RowKey } from '../../types';
2
- /**
3
- * Guarda configuraciones de vista en localStorage o notifica via callback.
4
- *
5
- * ## Propósito
6
- *
7
- * Persiste la configuración de columnas para una vista específica.
8
- * Soporta dos modos: localStorage directo o callback externo (API/backend).
9
- *
10
- * ## Prioridad de persistencia
11
- *
12
- * 1. Si hay `onChangeCallback`, notifica al callback (para guardar en backend)
13
- * 2. Si no hay callback, guarda directamente en localStorage
14
- *
15
- * ## Formato de key en localStorage
16
- *
17
- * ```
18
- * table: `${id}_columns_config`
19
- * cards: `${id}_columns_config_cards`
20
- * ```
21
- * @param id - Identificador único del DataGrid
22
- * @param viewSuffix - Sufijo para identificar la vista ('' para table, '_cards' para cards)
23
- * @param config - Array de configuración a guardar
24
- * @param onChangeCallback - Callback opcional para notificar cambios (prioridad sobre localStorage)
25
- * @example
26
- * // Guardar en localStorage
27
- * saveViewConfig('my-grid', '', config);
28
- *
29
- * // Notificar via callback
30
- * saveViewConfig('my-grid', '_cards', config, handleChange);
31
- */
32
- export declare const saveViewConfig: <T>(id: RowKey, viewSuffix: string, config: T[], onChangeCallback?: (data: {
33
- reason: string;
34
- userConfig: T[];
35
- }) => void) => void;
@@ -1,15 +0,0 @@
1
- const saveViewConfig = (id, viewSuffix, config, onChangeCallback) => {
2
- if (onChangeCallback) {
3
- const reason = viewSuffix === "" ? "columnsConfig" : `columnsConfig${viewSuffix.replace("_", "")}`;
4
- onChangeCallback({
5
- reason,
6
- userConfig: config
7
- });
8
- return;
9
- }
10
- const storageKey = viewSuffix === "" ? `${id}_columns_config` : `${id}_columns_config${viewSuffix}`;
11
- localStorage.setItem(storageKey, JSON.stringify(config));
12
- };
13
- export {
14
- saveViewConfig as s
15
- };
@@ -1 +0,0 @@
1
- export { saveViewMode } from './saveViewMode';
@@ -1,33 +0,0 @@
1
- import { ViewMode } from '../../contexts/DataGridContext/types';
2
- import { OnChangeUserColumns, RowKey } from '../../types';
3
- /**
4
- * Guarda el modo de visualización (table o cards).
5
- *
6
- * ## Propósito
7
- *
8
- * Persiste la preferencia del usuario sobre el modo de vista seleccionado.
9
- * Permite que al recargar la página se mantenga la última vista utilizada.
10
- *
11
- * ## Prioridad de guardado
12
- *
13
- * 1. Si existe `onChangeUserColumns` → Guarda en backend (cookies de red)
14
- * 2. Si no existe → Fallback a localStorage
15
- *
16
- * ## Formato de key en localStorage (fallback)
17
- *
18
- * ```
19
- * `${id}_view_mode` -> 'table' | 'cards'
20
- * ```
21
- * @param id - Identificador único del DataGrid
22
- * @param viewMode - Modo de visualización ('table' | 'cards')
23
- * @param onChangeUserColumns - Callback opcional para guardar en backend
24
- * @example
25
- * // Con backend
26
- * saveViewMode('my-grid', 'cards', onChangeUserColumns);
27
- * // Llama: onChangeUserColumns({ reason: 'viewMode', userConfig: 'cards' })
28
- *
29
- * // Sin backend (fallback)
30
- * saveViewMode('my-grid', 'cards');
31
- * // localStorage: 'my-grid_view_mode' = 'cards'
32
- */
33
- export declare const saveViewMode: (id: RowKey, viewMode: ViewMode, onChangeUserColumns?: OnChangeUserColumns) => void;
@@ -1,13 +0,0 @@
1
- const saveViewMode = (id, viewMode, onChangeUserColumns) => {
2
- if (onChangeUserColumns) {
3
- onChangeUserColumns({
4
- reason: "viewMode",
5
- userConfig: viewMode
6
- });
7
- return;
8
- }
9
- localStorage.setItem(`${id}_view_mode`, viewMode);
10
- };
11
- export {
12
- saveViewMode as s
13
- };
@@ -1,6 +0,0 @@
1
- export * from './useViewMode';
2
- export * from './useRowHeight';
3
- export * from './useColumnsWidth';
4
- export * from './useViewConfig';
5
- export * from './useChangeColumnsConfig';
6
- export * from './useChangeColumnsOrder';
@@ -1 +0,0 @@
1
-
@@ -1 +0,0 @@
1
- export { useChangeColumnsConfig } from './useChangeColumnsConfig';
@@ -1,9 +0,0 @@
1
- import { UseChangeColumnsConfigParams, UseChangeColumnsConfigReturn } from '../../types.hooks';
2
- /**
3
- * Hook para manejar el cambio de configuración de columnas.
4
- *
5
- * Guarda la configuración en localStorage y actualiza el estado.
6
- * @param params - Parámetros del hook
7
- * @returns Función para cambiar la configuración de columnas
8
- */
9
- export declare const useChangeColumnsConfig: ({ id, onChangeUserColumns, updateConfigColumns, }: UseChangeColumnsConfigParams) => UseChangeColumnsConfigReturn;
@@ -1,27 +0,0 @@
1
- import { useCallback } from "react";
2
- import { s as saveViewConfig } from "../../helpers/saveViewConfig/saveViewConfig.js";
3
- import { g as getViewSuffix } from "../../helpers/getViewSuffix/getViewSuffix.js";
4
- const useChangeColumnsConfig = ({
5
- id,
6
- onChangeUserColumns,
7
- updateConfigColumns
8
- }) => {
9
- const onChangeColumnsConfig = useCallback(
10
- (viewModeParam, newConfig) => {
11
- saveViewConfig(
12
- id,
13
- getViewSuffix(viewModeParam),
14
- newConfig,
15
- onChangeUserColumns
16
- );
17
- updateConfigColumns(viewModeParam, newConfig);
18
- },
19
- [id, onChangeUserColumns, updateConfigColumns]
20
- );
21
- return {
22
- onChangeColumnsConfig
23
- };
24
- };
25
- export {
26
- useChangeColumnsConfig as u
27
- };
@@ -1 +0,0 @@
1
- export { useChangeColumnsOrder } from './useChangeColumnsOrder';
@@ -1,10 +0,0 @@
1
- import { UseChangeColumnsOrderParams, UseChangeColumnsOrderReturn } from '../../types.hooks';
2
- /**
3
- * Hook para manejar el cambio de orden de columnas.
4
- *
5
- * Reordena las columnas y llama a onChangeColumnsConfig para persistir.
6
- * @param getConfigColumns Función para obtener la configuración de columnas
7
- * @param onChangeColumnsConfig Función para cambiar la configuración de columnas
8
- * @returns Función para cambiar el orden de columnas
9
- */
10
- export declare const useChangeColumnsOrder: ({ getConfigColumns, onChangeColumnsConfig, }: UseChangeColumnsOrderParams) => UseChangeColumnsOrderReturn;
@@ -1,34 +0,0 @@
1
- import { useCallback } from "react";
2
- const useChangeColumnsOrder = ({
3
- getConfigColumns,
4
- onChangeColumnsConfig
5
- }) => {
6
- const onChangeColumnsOrder = useCallback(
7
- (viewModeParam, sourceKey, targetKey) => {
8
- if (sourceKey === targetKey) {
9
- return;
10
- }
11
- const currentConfig = getConfigColumns(viewModeParam);
12
- const sourceColumnIndex = currentConfig.findIndex(
13
- (c) => c.key === sourceKey
14
- );
15
- const targetColumnIndex = currentConfig.findIndex(
16
- (c) => c.key === targetKey
17
- );
18
- const reorderedConfig = [...currentConfig];
19
- reorderedConfig.splice(
20
- targetColumnIndex,
21
- 0,
22
- reorderedConfig.splice(sourceColumnIndex, 1)[0]
23
- );
24
- onChangeColumnsConfig(viewModeParam, reorderedConfig);
25
- },
26
- [getConfigColumns, onChangeColumnsConfig]
27
- );
28
- return {
29
- onChangeColumnsOrder
30
- };
31
- };
32
- export {
33
- useChangeColumnsOrder as u
34
- };
@@ -1 +0,0 @@
1
- export { useColumnsWidth } from './useColumnsWidth';
@@ -1,11 +0,0 @@
1
- import { UseColumnsWidthParams, UseColumnsWidthReturn } from '../../types.hooks';
2
- /**
3
- * Hook para manejar el estado del ancho de las columnas del DataGrid.
4
- *
5
- * Maneja:
6
- * - Estado del ancho de cada columna
7
- * - Guardado con debounce de 500ms al cambiar el ancho
8
- * @param params - Parámetros del hook
9
- * @returns Estado y función para cambiar el ancho de columnas
10
- */
11
- export declare const useColumnsWidth: ({ id, onChangeUserColumns, }: UseColumnsWidthParams) => UseColumnsWidthReturn;
@@ -1,29 +0,0 @@
1
- import { useState, useRef, useCallback } from "react";
2
- import { s as saveColumnsWidth } from "../../helpers/saveColumnsWidth/saveColumnsWidth.js";
3
- const useColumnsWidth = ({
4
- id,
5
- onChangeUserColumns
6
- }) => {
7
- const [columnsWidths, setColumnsWidths] = useState(/* @__PURE__ */ new Map());
8
- const timerRef = useRef(null);
9
- const onChangeColumnWidth = useCallback(
10
- (columnKey, width) => {
11
- columnsWidths.set(columnKey, Math.round(width));
12
- if (timerRef.current) {
13
- clearTimeout(timerRef.current);
14
- }
15
- timerRef.current = setTimeout(() => {
16
- saveColumnsWidth(id, columnsWidths, onChangeUserColumns);
17
- }, 500);
18
- },
19
- [id, columnsWidths, onChangeUserColumns]
20
- );
21
- return {
22
- columnsWidths,
23
- setColumnsWidths,
24
- onChangeColumnWidth
25
- };
26
- };
27
- export {
28
- useColumnsWidth as u
29
- };
@@ -1 +0,0 @@
1
- export { useRowHeight } from './useRowHeight';
@@ -1,28 +0,0 @@
1
- import { UseRowHeightParams, UseRowHeightReturn } from '../../types.hooks';
2
- /**
3
- * Hook para manejar el estado de la altura de las filas del DataGrid.
4
- *
5
- * Soporta dos modos:
6
- * - **Modo fijo**: rowHeights y rowHeaderHeights son números fijos
7
- * - **Modo variable**: rowHeights y rowHeaderHeights son arrays de 3 elementos [compact, standard, confortable]
8
- * @param params - Parámetros del hook
9
- * @returns Estado actual y función para cambiar el variant
10
- * @throws Error si rowHeights y rowHeaderHeights no son del mismo tipo
11
- * @throws Error si los arrays no tienen exactamente 3 elementos
12
- * @throws Error si se intenta cambiar el variant en modo fijo
13
- * @example
14
- * // Modo variable (permite cambiar variant)
15
- * const { currentRowHeightVariant, setRowHeightVariant } = useRowHeight({
16
- * rowHeights: [32, 40, 48],
17
- * rowHeaderHeights: [36, 44, 52],
18
- * initialRowHeightVariant: 'standard',
19
- * });
20
- *
21
- * // Modo fijo (altura constante)
22
- * const { currentRowHeightVariant } = useRowHeight({
23
- * rowHeights: 40,
24
- * rowHeaderHeights: 44,
25
- * initialRowHeightVariant: 'standard',
26
- * });
27
- */
28
- export declare const useRowHeight: ({ rowHeights, rowHeaderHeights, initialRowHeightVariant, }: UseRowHeightParams) => UseRowHeightReturn;