capibara 1.3.69 → 1.3.72

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.
@@ -0,0 +1,188 @@
1
+ # Plan: árbol anidado e indicadores de celda en Capibara
2
+
3
+ Estado: **propuesto, sin implementación**
4
+ Rama: `feature/valvulas-planilla`
5
+
6
+ Este documento forma parte del plan aislado en `docs/valvulas-planilla/`. El índice funcional y
7
+ el contrato del consumidor están en la carpeta homónima de `irricrops-mobile`.
8
+
9
+ ## Propósito
10
+
11
+ Generalizar Capibara para representar árboles de más de dos niveles y mostrar indicadores
12
+ accesibles en una celda. La biblioteca no debe conocer conceptos de equipo, sector, válvula ni
13
+ riego parcial; esos significados pertenecen al consumidor.
14
+
15
+ El caso que motiva el cambio necesita un nodo intermedio que simultáneamente:
16
+
17
+ - tenga hijos desplegables;
18
+ - mantenga una fila agregada propia;
19
+ - pueda seleccionarse;
20
+ - muestre datos e indicadores por día.
21
+
22
+ ## Situación actual
23
+
24
+ El código actual declara y asume un árbol de dos niveles `parent -> children` en varios lugares:
25
+
26
+ - `createNavLeft` genera manualmente padres e hijos.
27
+ - las columnas inicial, extendida y de botones duplican el recorrido de primer nivel;
28
+ - `redrawFloatBox` procesa padre e hijo por separado;
29
+ - `getTableDimensions`, `getPositionByItem`, `getItemByEvent` y `getItemById` recorren solo dos
30
+ niveles;
31
+ - `selectByDate`, `deselectByDate` e `isSelectedAllDate` seleccionan hijos directos.
32
+
33
+ Agregar un tercer `forEach` en cada función aumentaría las divergencias. El cambio debe partir de
34
+ un recorrido canónico reutilizable.
35
+
36
+ ## Contrato propuesto de nodo
37
+
38
+ ```js
39
+ {
40
+ id: 12,
41
+ type: "consumer-defined-type",
42
+ label: "Etiqueta",
43
+ data: [],
44
+ children: [],
45
+ isClosed: false,
46
+ isHidden: false,
47
+ selectable: true,
48
+ withNav: true
49
+ }
50
+ ```
51
+
52
+ - `children` puede aparecer en cualquier nivel.
53
+ - `selectable` define si la fila participa en selección. Para compatibilidad, su ausencia conserva
54
+ la semántica actual según el tipo de fila.
55
+ - Un nodo con hijos puede tener `data` y ser seleccionable.
56
+ - `isClosed` solo oculta descendientes, no la fila del propio nodo.
57
+ - `type` e `id` forman la identidad lógica; Capibara no debe tratar el ID numérico como global.
58
+
59
+ Contrato propuesto para una celda:
60
+
61
+ ```js
62
+ {
63
+ date: "2026-09-11",
64
+ indicators: [
65
+ {
66
+ icon: "<svg ...>",
67
+ label: "Descripción accesible",
68
+ className: "consumer-class"
69
+ }
70
+ ]
71
+ }
72
+ ```
73
+
74
+ - `indicators` es opcional.
75
+ - Capibara ubica el símbolo sin tapar el contenido principal.
76
+ - `label` se expone como tooltip y nombre accesible.
77
+ - El consumidor controla significado, icono y clase; Capibara controla geometría y seguridad de
78
+ render.
79
+
80
+ ## Recorrido canónico
81
+
82
+ Crear una utilidad pura equivalente a:
83
+
84
+ ```js
85
+ flattenVisibleTree(data) -> [
86
+ { item, parent, ancestors, depth, key }
87
+ ]
88
+ ```
89
+
90
+ Reglas:
91
+
92
+ - omitir nodos `isHidden` y todos sus descendientes;
93
+ - incluir el nodo actual antes de sus hijos;
94
+ - omitir descendientes de un nodo `isClosed`;
95
+ - producir `key` a partir de `type:id` y detectar duplicados exactos;
96
+ - conservar referencias originales a `item` para que eventos y selección no trabajen con copias.
97
+
98
+ También se requiere un recorrido completo, independiente del estado abierto, para buscar datos y
99
+ restaurar estado después de redibujar.
100
+
101
+ ## Componentes que deben migrar al listado aplanado
102
+
103
+ 1. Cálculo de alto y número de filas.
104
+ 2. Navegación izquierda y sangría.
105
+ 3. Columnas iniciales, extendidas y de botones.
106
+ 4. Float boxes y contenido diario.
107
+ 5. Hit testing de mouse y posición de un nodo.
108
+ 6. Búsqueda por identidad.
109
+ 7. Selección/deselección por fecha.
110
+ 8. Línea de hoy y overlays cuya altura dependa de la tabla.
111
+ 9. Redibujado tras expandir/contraer.
112
+
113
+ Todos deben recibir el mismo orden de filas; no se permiten recorridos independientes que puedan
114
+ desalinear sidebar, grilla y selección.
115
+
116
+ ## Navegación y eventos
117
+
118
+ - Renderizar cada fila mediante una función única que reciba `depth`.
119
+ - Aplicar sangría con una variable CSS por profundidad.
120
+ - Mostrar chevron solo si existen hijos visibles.
121
+ - Separar el evento de expansión del evento de selección.
122
+ - Propagar en eventos públicos `{ item, parent, ancestors, depth, key }`.
123
+ - Mantener los nombres y payloads actuales cuando se trate de árboles existentes, agregando
124
+ información de manera compatible.
125
+ - No depender de selectores DOM basados únicamente en `item-id`.
126
+
127
+ ## Selección
128
+
129
+ - Solo los nodos elegibles según `selectable` y la configuración de la pestaña participan.
130
+ - Un nodo con hijos puede seleccionarse sin seleccionar automáticamente sus descendientes.
131
+ - “Seleccionar fecha completa” opera sobre todas las filas seleccionables visibles.
132
+ - Contraer un grupo no debe corromper la selección; se debe definir si las selecciones ocultas se
133
+ conservan, siguiendo el comportamiento actual y haciéndolo consistente en todos los niveles.
134
+ - La posición de cada selección se recalcula desde el listado visible después de expandir,
135
+ contraer o reconstruir datos.
136
+
137
+ ## Indicadores
138
+
139
+ - Renderizar cero o más indicadores en un contenedor reservado de la celda.
140
+ - Escapar texto y validar el contenido permitido del icono conforme al mecanismo actual de iconos.
141
+ - Añadir `title` y texto accesible.
142
+ - Evitar que el indicador capture los eventos de selección de la celda.
143
+ - Ofrecer clases base para posición y tamaño, sin imponer color semántico.
144
+ - Verificar celdas vacías, múltiples indicadores, contenido largo, mobile y zoom.
145
+
146
+ ## Compatibilidad obligatoria
147
+
148
+ - Un árbol actual de dos niveles debe producir el mismo orden, alto y selección.
149
+ - Propiedades nuevas ausentes no cambian la salida.
150
+ - No cambiar la API de `rebuildConfigData` ni requerir reinicializar una instancia existente.
151
+ - Validar los consumidores Planilla y Aplicaciones.
152
+ - Mantener soporte del toolchain JavaScript actual del paquete.
153
+ - La futura implementación se hace en `src/`; luego se genera y verifica `dist/`.
154
+
155
+ ## Secuencia futura de implementación
156
+
157
+ 1. Incorporar y probar las funciones de recorrido puro.
158
+ 2. Migrar dimensiones, búsqueda y hit testing.
159
+ 3. Migrar grilla/float boxes.
160
+ 4. Reemplazar la navegación izquierda duplicada por render recursivo.
161
+ 5. Migrar selección y eventos.
162
+ 6. Agregar nodos seleccionables con hijos.
163
+ 7. Agregar indicadores de celda.
164
+ 8. Construir `dist/` y validar ejemplos existentes.
165
+ 9. Consumir el artefacto local desde Mobile y ejecutar la matriz de regresión.
166
+
167
+ ## Pruebas mínimas
168
+
169
+ - Árbol vacío.
170
+ - Árbol de un nivel.
171
+ - Árbol vigente de dos niveles.
172
+ - Árbol de tres y cuatro niveles.
173
+ - Grupo intermedio con datos propios y seleccionable.
174
+ - Nodos ocultos y grupos cerrados en cada profundidad.
175
+ - IDs numéricos iguales con tipos distintos.
176
+ - Selección por fecha con grupos abiertos y cerrados.
177
+ - Expansión sin selección accidental.
178
+ - Alineación entre sidebar, columnas laterales, celdas y hit testing.
179
+ - Indicador único y múltiple con tooltip y teclado/lector de pantalla.
180
+ - Reconstrucción de datos sin doble inicialización.
181
+
182
+ ## Fuera de alcance
183
+
184
+ - Reglas de agregación del dominio consumidor.
185
+ - Cálculo de cobertura o parcialidad.
186
+ - Formularios y llamadas HTTP.
187
+ - Nombres, iconos o colores específicos de válvulas.
188
+ - Cambios funcionales a árboles existentes que no opten por las nuevas capacidades.
@@ -0,0 +1,9 @@
1
+ # Capibara para Válvulas en Planilla
2
+
3
+ Esta carpeta aísla la parte del plan que corresponde al repositorio `capibara`.
4
+
5
+ - `PLAN_ARBOL_ANIDADO_E_INDICADORES.md`: diseño genérico del árbol recursivo, nodos intermedios
6
+ seleccionables e indicadores accesibles por celda.
7
+
8
+ La biblioteca debe mantenerse agnóstica al dominio. El alcance funcional y el contrato con
9
+ `api-go` se documentan en `irricrops-mobile/ai-plans/plans/valvulas-planilla/`.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "capibara",
3
- "version": "1.3.69",
3
+ "version": "1.3.72",
4
4
  "main": "dist/index.js",
5
5
  "repository": {
6
6
  "type": "git",
@@ -13,7 +13,8 @@
13
13
  "scripts": {
14
14
  "dev": "vite",
15
15
  "build": "vite build",
16
- "preview": "vite preview"
16
+ "preview": "vite preview",
17
+ "test": "vitest run"
17
18
  },
18
19
  "keywords": [],
19
20
  "devDependencies": {
@@ -24,7 +25,8 @@
24
25
  "prettier": "3.0.0",
25
26
  "sass": "^1.99.0",
26
27
  "vite": "^6.4.3",
27
- "vite-plugin-css-injected-by-js": "^4.0.1"
28
+ "vite-plugin-css-injected-by-js": "^4.0.1",
29
+ "vitest": "^2.1.9"
28
30
  },
29
31
  "dependencies": {
30
32
  "22": "^0.0.0",
@@ -643,8 +643,18 @@ export class Capibara{
643
643
 
644
644
  case 'select':
645
645
  inputElement = elem.querySelector("select.input-select");
646
- let inputValue = inputElement.value;
647
- value = inputConfig.options.find(o => o.id == inputValue)
646
+ if(inputConfig.multiple){
647
+ value = Array.prototype.slice.call(inputElement.selectedOptions).map(option => option.value);
648
+ }else{
649
+ let inputValue = inputElement.value;
650
+ const options = typeof inputConfig.options === "function" ? inputConfig.options({ selected: this.selected }) : inputConfig.options || [];
651
+ value = options.find(o => o.id == inputValue);
652
+ }
653
+ break;
654
+
655
+ case 'checkboxList':
656
+ value = Array.prototype.slice.call(elem.querySelectorAll("input.input-checkbox-list:checked"))
657
+ .map(input => input.value);
648
658
  break;
649
659
 
650
660
  case 'file':
@@ -725,7 +735,10 @@ export class Capibara{
725
735
  $detail.classList.remove("hide");
726
736
  };
727
737
 
728
- $detail.innerHTML = tableElements.getDetailNavItemContent(item);
738
+ $detail.innerHTML = tableElements.getDetailNavItemContent(item, {
739
+ selected: this.selected,
740
+ tabSelected: this.tabSelected,
741
+ });
729
742
 
730
743
  if(pos.yPercent > 50){ //mayor a 50%
731
744
  if(!$detail.classList.contains("to-bottom")){
@@ -951,6 +964,10 @@ export class Capibara{
951
964
  return false;
952
965
  }
953
966
 
967
+ if(item.selectableInTabs && this.tabSelected && item.selectableInTabs.indexOf(this.tabSelected.key) === -1){
968
+ return false;
969
+ }
970
+
954
971
  if(this.config.timeline.noFutureSelectable){
955
972
  let d = new Date(date);
956
973
  let today = new Date();
@@ -1096,29 +1113,28 @@ export class Capibara{
1096
1113
 
1097
1114
  isSelectedAllDate(date){
1098
1115
  let isAllSelected = true;
1099
- this.config.data.forEach(parent => {
1100
- parent.children.forEach(item => {
1101
- if(!this.isSelected(date, item)){
1102
- isAllSelected = false;
1103
- }
1104
- });
1116
+ const rows = utils.flattenTree(this.config.data, { tabKey: this.tabSelected && this.tabSelected.key });
1117
+ rows.forEach(row => {
1118
+ if(!this.isSelectable({ item: row.item, date, dataByDate: null }) || !this.isSelected(date, row.item)){
1119
+ isAllSelected = false;
1120
+ }
1105
1121
  });
1106
1122
  return isAllSelected;
1107
1123
  };
1108
1124
 
1109
1125
  selectByDate(date){
1110
- this.config.data.forEach(parent => {
1111
- parent.children.forEach(item => {
1112
- this.selectByItemDate(date, item, false);
1113
- });
1126
+ const rows = utils.flattenTree(this.config.data, { tabKey: this.tabSelected && this.tabSelected.key });
1127
+ rows.forEach(row => {
1128
+ if(this.isSelectable({ item: row.item, date, dataByDate: null })){
1129
+ this.selectByItemDate(date, row.item, false);
1130
+ }
1114
1131
  });
1115
1132
  };
1116
1133
 
1117
1134
  deselectByDate(date){
1118
- this.config.data.forEach(parent => {
1119
- parent.children.forEach(item => {
1120
- this.deselectByItemDate(date, item, false);
1121
- });
1135
+ const rows = utils.flattenTree(this.config.data, { tabKey: this.tabSelected && this.tabSelected.key });
1136
+ rows.forEach(row => {
1137
+ this.deselectByItemDate(date, row.item, false);
1122
1138
  });
1123
1139
  };
1124
1140
 
@@ -346,6 +346,54 @@
346
346
  }
347
347
  }
348
348
 
349
+ .cap-checkbox-list-section {
350
+ align-items: stretch;
351
+ border: 1px solid rgba(127, 127, 127, 0.5);
352
+ border-radius: 8px;
353
+ margin: 8px 16px;
354
+ padding: 10px 12px;
355
+
356
+ .text-subtitle {
357
+ line-height: 1.2;
358
+ }
359
+ }
360
+
361
+ .cap-checkbox-list-help {
362
+ color: inherit;
363
+ font-size: 0.8em;
364
+ line-height: 1.25;
365
+ margin-top: 0.25em;
366
+ opacity: 0.68;
367
+ }
368
+
369
+ .cap-checkbox-list {
370
+ display: grid;
371
+ gap: 0.35em;
372
+ margin-top: 0.35em;
373
+ }
374
+
375
+ .cap-checkbox-list-option {
376
+ align-items: center;
377
+ border: 1px solid rgba(255, 255, 255, 0.25);
378
+ border-radius: 6px;
379
+ cursor: pointer;
380
+ display: flex;
381
+ gap: 0.6em;
382
+ min-height: 2.5em;
383
+ padding: 0.45em 0.65em;
384
+
385
+ &:hover {
386
+ border-color: var(--accent-color, #4caf50);
387
+ }
388
+
389
+ input {
390
+ accent-color: var(--accent-color, #4caf50);
391
+ flex: 0 0 auto;
392
+ margin: 0;
393
+ width: auto;
394
+ }
395
+ }
396
+
349
397
  .input-section-list {
350
398
  margin: 16px 0;
351
399
  .input-section-title {
@@ -465,6 +513,57 @@
465
513
  }
466
514
  }
467
515
 
516
+ .nav-input-clearable {
517
+ position: relative;
518
+ width: 100%;
519
+ min-width: 130px;
520
+ max-width: 170px;
521
+ margin-bottom: 8px;
522
+
523
+ input.nav-input {
524
+ min-width: 0;
525
+ max-width: none;
526
+ margin-bottom: 0;
527
+ }
528
+
529
+ .nav-input-clear {
530
+ position: absolute;
531
+ top: 50%;
532
+ right: 0.25em;
533
+ display: flex;
534
+ align-items: center;
535
+ justify-content: center;
536
+ width: 1.7em;
537
+ height: 1.7em;
538
+ padding: 0;
539
+ color: inherit;
540
+ opacity: 0.55;
541
+ background: transparent;
542
+ border: 0;
543
+ border-radius: 50%;
544
+ cursor: pointer;
545
+ transform: translateY(-50%);
546
+
547
+ &:hover,
548
+ &:focus-visible {
549
+ opacity: 1;
550
+ background: rgba(128, 128, 128, 0.16);
551
+ outline: none;
552
+ }
553
+
554
+ &.is-hidden {
555
+ display: none;
556
+ }
557
+
558
+ .close-icon,
559
+ svg {
560
+ display: flex;
561
+ width: 1.15em !important;
562
+ height: 1.15em !important;
563
+ }
564
+ }
565
+ }
566
+
468
567
  .nav-input-file {
469
568
  border: 2px solid color.adjust(grey, $alpha: -0.3);
470
569
  border-radius: 6px;
@@ -2,6 +2,22 @@
2
2
  @use "abstracts/functions" as *;
3
3
 
4
4
  .capibara {
5
+ .cell-indicator {
6
+ position: absolute;
7
+ top: 2px;
8
+ right: 2px;
9
+ width: 12px;
10
+ height: 12px;
11
+ color: #ff9800;
12
+ pointer-events: none;
13
+
14
+ svg {
15
+ width: 100%;
16
+ height: 100%;
17
+ fill: currentColor;
18
+ }
19
+ }
20
+
5
21
  nav.right {
6
22
  position: absolute;
7
23
  right: 0px;
@@ -137,6 +153,7 @@
137
153
  flex: 0 0 var(--nav-item-col-width);
138
154
  text-align: center;
139
155
  padding: 4px 8px;
156
+
140
157
  &.has-input {
141
158
  padding: 0px;
142
159
 
@@ -193,6 +210,14 @@
193
210
  display: flex;
194
211
  line-height: 1.75rem;
195
212
 
213
+ &.valvula-row {
214
+ background: rgba(76, 175, 80, 0.08);
215
+
216
+ &:hover {
217
+ background: rgba(76, 175, 80, 0.14);
218
+ }
219
+ }
220
+
196
221
  .item-title {
197
222
  flex: 1 0 auto;
198
223
  padding: 4px 8px;
@@ -256,6 +281,19 @@
256
281
  }
257
282
 
258
283
  nav {
284
+ // Mantiene el indicador de válvula al abrir cualquiera de las columnas
285
+ // laterales, no solo en el listado de nombres.
286
+ .initial-nav-list .valvula-row,
287
+ .extend-nav-list .valvula-row,
288
+ .cap-btn-nav-list .valvula-row {
289
+ background: rgba(76, 175, 80, 0.08);
290
+
291
+ &:hover {
292
+ background: rgba(76, 175, 80, 0.14);
293
+ }
294
+
295
+ }
296
+
259
297
  .nav-item-container,
260
298
  .initial-nav-item,
261
299
  .ex-nav-item,
@@ -273,9 +311,24 @@
273
311
  }
274
312
 
275
313
  .nav-item-list {
314
+ .nested-children-items {
315
+ .grandchild-nav-item {
316
+ width: var(--nav-width);
317
+ padding-left: 34px;
318
+ box-sizing: border-box;
319
+ }
320
+ }
276
321
  .child-nav-item {
277
322
  //border-top: 1px solid #b0bec5 !important; // blue grey 200
278
323
  }
324
+
325
+ .valvula-row {
326
+ background: rgba(76, 175, 80, 0.08);
327
+
328
+ &:hover {
329
+ background: rgba(76, 175, 80, 0.14);
330
+ }
331
+ }
279
332
  .nav-item {
280
333
  //border-bottom: 1px solid #b0bec5 !important; // blue grey 200
281
334
  }
@@ -51,6 +51,10 @@
51
51
  &.plot-parent {
52
52
  background: rgba(25, 118, 210, 0.1);
53
53
  }
54
+
55
+ &.valvula-row {
56
+ background: rgba(76, 175, 80, 0.08);
57
+ }
54
58
  }
55
59
  }
56
60