@isai_dev/data_table_lib 0.1.2 → 2.0.0-alpha.3

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.
package/README.md CHANGED
@@ -6,6 +6,8 @@ Creada por [Jaziel Isaí](https://isai-dev.com).
6
6
 
7
7
  Licencia [MIT](./LICENSE). Puedes usar, modificar y distribuir la librería conservando el aviso de copyright y la licencia.
8
8
 
9
+ > Este repositorio incluye una vista previa de la versión 2. Las funciones de fotos y nuevos iconos todavía no forman parte de la versión estable publicada en npm.
10
+
9
11
  ## Instalar y ejecutar
10
12
 
11
13
  Requiere React y React DOM 18 o 19 en la aplicación. Para desarrollar o compilar este repositorio se recomienda Node.js 22.12+ (también 24 o 26 LTS); [Vite 8 admite Node 20.19+ o 22.12+](https://vite.dev/guide/). La librería está publicada en npm como [`@isai_dev/data_table_lib`](https://www.npmjs.com/package/@isai_dev/data_table_lib).
@@ -36,7 +38,53 @@ También puedes instalar el archivo generado con `npm install /ruta/al/archivo.t
36
38
 
37
39
  ## Ejemplos ejecutables
38
40
 
39
- `npm run examples` compila la librería y sirve [tres ejemplos independientes](./examples/README.md) en `http://localhost:5173/examples/`: tabla local, edición con validación y consulta simulada del servidor. Cada ejemplo importa las entradas públicas del paquete, igual que una aplicación consumidora.
41
+ `npm run examples` compila la librería y sirve [cuatro ejemplos independientes](./examples/README.md) en `http://localhost:5173/examples/`: tabla local, edición con validación, consulta simulada del servidor y fotos con acciones. Cada ejemplo importa las entradas públicas del paquete, igual que una aplicación consumidora.
42
+
43
+ ## Fotos, galería y acciones (vista previa de la versión 2)
44
+
45
+ Usa `type: 'image'` para mostrar una URL o un objeto `{ src, alt }` en una columna. El desarrollador puede elegir la vista inicial: `avatar`, `thumbnail`, `large` o `hidden`. Con `allowImageViewChange`, quien usa la tabla puede cambiarla desde un selector. `imageView` y `onImageViewChange` permiten controlar la elección desde la aplicación; `defaultImageView` inicia el estado interno cuando no está controlado.
46
+
47
+ ```jsx
48
+ const [imageView, setImageView] = useState('avatar');
49
+ const columns = [
50
+ { field: 'photo', headerName: 'Foto', type: 'image', searchable: false,
51
+ imageFit: 'cover', imageFallback: 'Sin foto', previewable: true },
52
+ { field: 'name', headerName: 'Nombre', sortable: true, hideable: false },
53
+ { field: 'team', headerName: 'Equipo', filterable: true }
54
+ ];
55
+ const rows = [{ id: 1, name: 'Ana', team: 'Diseño', photo: {
56
+ src: '/photos/ana-800.jpg', alt: 'Retrato de Ana',
57
+ srcSet: '/photos/ana-400.jpg 400w, /photos/ana-800.jpg 800w',
58
+ sizes: '(max-width: 640px) 90vw, 33vw', width: 800, height: 600 } }];
59
+
60
+ <Table columns={columns} rows={rows}
61
+ defaultLayout="gallery" allowLayoutChange
62
+ layoutPreferencesKey="mi-tabla-vista"
63
+ gallery={{ imageField: 'photo', titleField: 'name',
64
+ descriptionField: 'team', aspectRatio: 'square' }}
65
+ imageView={imageView} onImageViewChange={setImageView}
66
+ allowImageViewChange searchable selectable
67
+ bulkActions={[{ label: 'Ver selección',
68
+ onClick: (loadedRows, ids) => showSelection(loadedRows, ids) }]}
69
+ allowColumnCustomization columnPreferencesKey="mi-tabla-personas"
70
+ actions={[{ label: 'Ver perfil', iconName: 'view', iconOnly: true,
71
+ variant: 'primary', onClick: (row) => openProfile(row) }]}
72
+ />;
73
+ ```
74
+
75
+ Los valores de imagen sin URL o con error de carga muestran `imageFallback` (por defecto, “Sin foto”). Usa un `alt` descriptivo para fotos con significado; también puedes definir `imageAlt(value, row)`. `imageFit` acepta `cover` o `contain` e `imagePosition` ajusta el recorte. La búsqueda global omite columnas de imagen por defecto; `searchable: true` permite buscar por el texto alternativo. Si tienes imágenes de varios tamaños, pasa `srcSet` y `sizes` para que el navegador elija la adecuada; `width` y `height` proporcionan sus dimensiones originales. Sin `srcSet`, la librería sigue usando `src` como antes.
76
+
77
+ `previewable: true` abre la foto en un diálogo modal con botones para recorrer las fotos de la página actual. El diálogo se cierra con su botón o con Escape. Si necesitas tu propio visor, define `onImageClick(value, row)` en la columna; esa función sustituye al diálogo integrado. Sólo se amplían imágenes que tienen URL.
78
+
79
+ Cuando las imágenes son el contenido principal, `defaultLayout="gallery"` muestra tarjetas con una foto grande y texto breve, siguiendo la [recomendación de Apple para colecciones con muchas imágenes](https://developer.apple.com/design/human-interface-guidelines/lists-and-tables). `allowLayoutChange` añade los botones **Tabla** y **Galería**. `layout` / `onLayoutChange` controlan la presentación desde la aplicación; `layoutPreferencesKey` guarda la elección en `localStorage` con una clave distinta de `columnPreferencesKey`.
80
+
81
+ `gallery.imageField` elige la columna de imagen; `titleField` y `descriptionField` eligen el texto. Si se omiten, se usa la primera columna de imagen y la primera columna de texto visible. `aspectRatio` acepta `landscape` (4:3), `square` (1:1) y `portrait` (3:4); `cardSize` acepta `comfortable` o `compact`. `renderDetails(row, rowIndex)` añade contenido personalizado debajo del texto. La galería permite ordenar columnas `sortable` y filtrar columnas `filterable`, además de usar búsqueda, paginación, selección, acciones y visor de fotos. **Sin ordenar** llama `onSortChange(null)` cuando el orden es controlado. El tamaño de avatar o miniatura y la personalización de columnas sólo afectan a la tabla. `TableEdit` sigue usando la tabla para conservar los controles de edición.
82
+
83
+ `bulkActions` muestra una barra cuando hay filas seleccionadas, en tabla o galería. Cada acción recibe `(loadedRows, selectedIds, event)`: `selectedIds` contiene toda la selección, incluso IDs de otras páginas; `loadedRows` contiene sólo las filas presentes en `rows`. El botón **Limpiar selección** borra la selección mediante `onSelectionChange` si está controlada.
84
+
85
+ `allowColumnCustomization` muestra un panel para ocultar y mover columnas con teclado o ratón. `hideable: false` y `reorderable: false` bloquean esos cambios para una columna; `hidden: true` la oculta siempre. El panel impide ocultar la última columna visible. `columnPreferencesKey` guarda el orden y la visibilidad en `localStorage` del navegador; usa una clave única por tabla. Si no pasas la clave, la elección sólo dura mientras la tabla está montada. La aplicación también puede controlar el estado con `columnOrder` / `onColumnOrderChange` y `columnVisibility` / `onColumnVisibilityChange`; `defaultColumnOrder` y `defaultColumnVisibility` definen los valores iniciales no controlados. Las columnas nuevas se añaden al final del orden guardado. La búsqueda global omite las columnas ocultas por el usuario.
86
+
87
+ Las acciones admiten `iconName`: `view`, `edit`, `delete`, `download`, `more`, `check` y `close`. También puedes pasar tu propio componente con `icon`. `iconOnly` oculta el texto visualmente, pero conserva el nombre accesible tomado de `label` o `ariaLabel`. `variant` acepta `default`, `primary` o `danger`; `iconPosition` acepta `start` o `end`. Los iconos integrados son SVG y no requieren una dependencia adicional.
40
88
 
41
89
  ## Página de presentación
42
90
 
@@ -197,12 +245,22 @@ Los tipos de celda son `text`, `date`, `number`, `file`, `select` y `button`. Lo
197
245
  | `getRowId` | `(row, index) => string \| number` | ID estable; por defecto `row.id` y luego índice. |
198
246
  | `caption` | `ReactNode` | Título semántico de la tabla. |
199
247
  | `actions` | `TableAction[]` | Botones por fila; `onClick(row, event)`. |
248
+ | `bulkActions` | `TableBulkAction[]` | Acciones de la selección; `onClick(loadedRows, selectedIds, event)`. |
200
249
  | `searchable`, `search`, `onSearchChange` | `boolean`, `string`, función | Búsqueda global opcional/controlada. |
201
250
  | `sortable`, `sort`, `onSortChange` | `boolean`, `{field, direction}`, función | Ordenamiento opcional/controlado. |
202
251
  | `filters`, `onFiltersChange` | objeto, función | Filtros de columnas controlados. |
203
252
  | `paginationEnabled`, `pagination`, `onPaginationChange` | `boolean`, `{pageIndex, pageSize}`, función | Paginación opcional/controlada; `pageIndex` empieza en 0. |
204
253
  | `manualSorting`, `manualFiltering`, `manualPagination`, `rowCount` | booleanos, número | Operaciones delegadas al servidor. |
205
254
  | `selectable`, `selectedRowIds`, `onSelectionChange` | `boolean`, IDs, función | Selección opcional/controlada. |
255
+ | `defaultImageView`, `imageView`, `onImageViewChange` | vista, vista, función | Vista de fotos inicial o controlada. |
256
+ | `allowImageViewChange` | `boolean` | Muestra el selector de vista a quien usa la tabla. |
257
+ | `defaultLayout`, `layout`, `onLayoutChange` | `'table' \| 'gallery'`, vista, función | Presentación inicial o controlada de `Table`. |
258
+ | `allowLayoutChange`, `layoutPreferencesKey` | `boolean`, `string` | Permite alternar vistas y recordar la elección. |
259
+ | `gallery` | `TableGalleryOptions` | Campos, proporción, tamaño y contenido adicional de las tarjetas. |
260
+ | `allowColumnCustomization` | `boolean` | Muestra el panel para ocultar y mover columnas. |
261
+ | `defaultColumnOrder`, `columnOrder`, `onColumnOrderChange` | `string[]`, `string[]`, función | Orden inicial o controlado de los campos. |
262
+ | `defaultColumnVisibility`, `columnVisibility`, `onColumnVisibilityChange` | objeto, objeto, función | Visibilidad inicial o controlada por campo; `false` oculta. |
263
+ | `columnPreferencesKey` | `string` | Guarda preferencias de columnas en `localStorage`. |
206
264
  | `loading`, `error` | `boolean`, `ReactNode` | Estado de carga y aviso de error. |
207
265
  | `emptyMessage`, `loadingMessage` | `ReactNode` | Textos de estado. |
208
266
  | `className` | `string` | Clase adicional del contenedor. |
@@ -221,7 +279,7 @@ Los tipos de celda son `text`, `date`, `number`, `file`, `select` y `button`. Lo
221
279
  }} />
222
280
  ```
223
281
 
224
- Cada columna acepta `field`, `headerName`, `hidden`, `sortable`, `filterable`, `searchable`, `sortFn`, `filterFn`, `type`, `options`, `placeholder`, `renderCell`, `validate`, `onChange`, `onClick`, `label`, `icon`, `ariaLabel` y `style`. Cada acción acepta `id`, `label`, `icon`, `ariaLabel`, `className`, `style`, `disabled` y `onClick`. Si sólo muestra un icono, proporciona `ariaLabel`.
282
+ Cada columna acepta `field`, `headerName`, `hidden`, `hideable`, `reorderable`, `sortable`, `filterable`, `searchable`, `sortFn`, `filterFn`, `type`, `options`, `placeholder`, `renderCell`, `validate`, `onChange`, `onClick`, `label`, `icon`, `ariaLabel` y `style`. Para `type: 'image'`, también acepta `imageAlt`, `imageFit`, `imagePosition`, `imageFallback`, `previewable` y `onImageClick`. Cada acción acepta `id`, `label`, `icon`, `iconName`, `iconOnly`, `iconPosition`, `variant`, `ariaLabel`, `className`, `style`, `disabled` y `onClick`. Si sólo muestra un icono, proporciona un `label` de texto o `ariaLabel`.
225
283
 
226
284
  Los nombres anteriores `getColumns`, `getRows`, `getButtons` y `onCaption` siguen disponibles. En `TableEdit`, `getButtons` conserva `onClick(event, row)`; el prop nuevo `actions` usa `onClick(row, event)`. Si pasas ambas versiones, prevalece el nombre nuevo.
227
285
 
package/dist/index.cjs CHANGED
@@ -1 +1 @@
1
- Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("react"),t=require("react/jsx-runtime");var n=e=>e==null?``:String(e);function r(e,t,r,i){let a=t.filter(e=>!e.hidden&&e.searchable!==!1),o=String(r??``).trim().toLocaleLowerCase();return e.filter(e=>o&&!a.some(t=>n(e[t.field]).toLocaleLowerCase().includes(o))?!1:Object.entries(i??{}).every(([r,i])=>{if(i==null||i===``)return!0;let a=t.find(e=>e.field===r);return a?a.filterFn?a.filterFn(e[r],i,e):n(e[r]).toLocaleLowerCase().includes(n(i).toLocaleLowerCase()):!0}))}function i(e,t,r){if(!t?.field||!t?.direction)return e;let i=r.find(e=>e.field===t.field);if(!i)return e;let a=t.direction===`desc`?-1:1,o=new Intl.Collator(void 0,{numeric:!0,sensitivity:`base`});return e.map((e,t)=>({row:e,index:t})).sort((e,r)=>{let s=e.row[t.field],c=r.row[t.field];return s==null&&c==null?e.index-r.index:s==null?1:c==null?-1:(i.sortFn?i.sortFn(s,c,e.row,r.row):typeof s==`number`&&typeof c==`number`?s-c:o.compare(n(s),n(c)))*a||e.index-r.index}).map(({row:e})=>e)}function a(e,t,n){return e.slice(t*n,(t+1)*n)}var o=(e,t)=>e?.id??t,s={pageIndex:0,pageSize:10};function c({checked:e,mixed:n,onChange:r,label:i}){return(0,t.jsx)(`input`,{type:`checkbox`,checked:e,"aria-checked":n?`mixed`:e,"aria-label":i,onChange:r,ref:e=>{e&&(e.indeterminate=n)}})}function l({row:n,column:r,rowIndex:i,editable:a,saveMode:o,onEdit:s,error:c,errorId:l,disabled:u,fileVersion:d,selectOptionLabel:f}){let p=n?.[r.field];if(typeof r.renderCell==`function`)return r.renderCell(p,n,i);if(!a)return p??null;let m={name:r.field,"aria-label":r.headerName||r.field,"aria-invalid":!!c||void 0,"aria-describedby":c?l:void 0,disabled:u,onChange:e=>s(e,n,r)};return r.type===`button`?(0,t.jsxs)(`button`,{type:`button`,className:`dt-button`,style:r.style,"aria-label":r.ariaLabel??(typeof r.label==`string`?r.label:void 0),disabled:u,onClick:e=>r.onClick?.(e,n),children:[r.label,` `,r.icon]}):r.type===`select`?(0,t.jsxs)(`select`,{...m,className:`dt-control`,value:p??``,disabled:u||!o&&!r.onChange,children:[p==null&&(0,t.jsx)(`option`,{value:``,disabled:!0,children:r.placeholder??f}),(r.options??[]).map(e=>(0,t.jsx)(`option`,{value:e.value,children:e.label},String(e.value)))]}):[`text`,`date`,`number`,`file`].includes(r.type)?r.type===`file`?(0,e.createElement)(`input`,{...m,key:d,className:`dt-control`,type:`file`}):(0,t.jsx)(`input`,{...m,className:`dt-control`,type:r.type,value:p??``,readOnly:!o&&!r.onChange}):p??null}function u({columns:n=[],rows:u=[],actions:d=[],caption:f,editable:p=!1,legacyEditActions:m=!1,getRowId:h=o,actionsHeader:g=`Acciones`,emptyMessage:ee=`No hay datos`,className:te=``,sortable:ne=!1,sort:_,onSortChange:re,searchable:ie=!1,search:v,onSearchChange:ae,searchPlaceholder:oe=`Buscar…`,filters:y,onFiltersChange:se,paginationEnabled:ce=!1,pagination:b,onPaginationChange:le,manualSorting:ue=!1,manualFiltering:x=!1,manualPagination:S=!1,rowCount:de,selectable:C=!1,selectedRowIds:w,onSelectionChange:fe,loading:T=!1,error:pe,loadingMessage:me=`Cargando…`,editMode:he=`immediate`,onSave:E,onCancel:ge,previousLabel:_e=`Anterior`,nextLabel:ve=`Siguiente`,saveLabel:ye=`Guardar`,cancelLabel:be=`Cancelar`,labels:xe={}}){let D={search:`Buscar en la tabla`,filter:e=>`Filtrar ${e}`,filterPlaceholder:`Filtrar…`,selectPage:`Seleccionar página`,selectRow:e=>`Seleccionar fila ${e}`,rowsPerPage:`Filas por página`,selectOption:`Selecciona una opción`,...xe},[Se,Ce]=(0,e.useState)(null),[we,Te]=(0,e.useState)(``),[Ee,De]=(0,e.useState)({}),[Oe,ke]=(0,e.useState)(s),[Ae,je]=(0,e.useState)([]),[O,k]=(0,e.useState)({}),[Me,A]=(0,e.useState)({}),[Ne,j]=(0,e.useState)({}),[M,N]=(0,e.useState)({}),[Pe,Fe]=(0,e.useState)({}),Ie=(0,e.useId)().replace(/:/g,``),P=_===void 0?Se:_,F=v===void 0?we:v,I=y===void 0?Ee:y,L=b??Oe,R=w===void 0?Ae:w,z=p&&he===`save`,B=n.filter(e=>!e.hidden),V=Array.isArray(d)?d:[],H=V.length>0||z,Le=ie||v!==void 0,U=ce||b!==void 0,Re=B.length+ +!!C+ +!!H,W=(0,e.useMemo)(()=>{let e=x?u:r(u,n,F,I);return ue?e:i(e,P,n)},[u,n,F,I,P,x,ue]),G=S?de??u.length:W.length,K=Math.max(1,Number(L.pageSize)||10),ze=Math.max(0,Math.ceil(G/K)-1),q=Math.max(0,Math.min(Number(L.pageIndex)||0,ze)),J=U&&!S?a(W,q,K):W,Y=new Set(R.map(String)),X=J.map((e,t)=>h(e,t)),Z=X.filter(e=>Y.has(String(e))).length,Q=e=>{let t={pageIndex:Math.max(0,e.pageIndex),pageSize:e.pageSize};b===void 0&&ke(t),le?.(t)},$=()=>{U&&q!==0&&Q({pageIndex:0,pageSize:K})},Be=e=>{let t={field:e.field,direction:P?.field===e.field&&P.direction===`asc`?`desc`:`asc`};_===void 0&&Ce(t),re?.(t),$()},Ve=e=>{v===void 0&&Te(e),ae?.(e),$()},He=(e,t)=>{let n={...I,[e]:t};y===void 0&&De(n),se?.(n),$()},Ue=e=>{w===void 0&&je(e),fe?.(e,u.filter((t,n)=>e.some(e=>String(e)===String(h(t,n)))))},We=()=>{let e=X.length>0&&Z===X.length?R.filter(e=>!X.some(t=>String(t)===String(e))):[...R,...X.filter(e=>!Y.has(String(e)))];Ue(e)},Ge=(e,t,n,r)=>{if(!z){n.onChange?.(e,t);return}let i=n.type===`file`?e.target.files?.[0]??null:e.target.value,a=String(r),o={...t,...O[a],[n.field]:i};if(k(e=>({...e,[a]:o})),N(e=>({...e,[a]:``})),n.validate){let e=n.validate(i,o)||``;A(t=>({...t,[a]:{...t[a],[n.field]:e}}))}},Ke=e=>{k(t=>{let n={...t};return delete n[e],n}),A(t=>{let n={...t};return delete n[e],n}),N(t=>{let n={...t};return delete n[e],n}),Fe(t=>({...t,[e]:(t[e]??0)+1}))},qe=async(e,t)=>{let r=String(e),i=O[r];if(!i||!E)return;let a={};for(let e of n)if(e.validate){let t=e.validate(i[e.field],i);t&&(a[e.field]=t)}if(Object.keys(a).length)A(e=>({...e,[r]:a}));else{j(e=>({...e,[r]:!0}));try{await E(i,t),Ke(r)}catch(e){N(t=>({...t,[r]:e?.message||`No se pudo guardar`}))}finally{j(e=>({...e,[r]:!1}))}}};return(0,t.jsxs)(`div`,{className:`dt-container ${te}`.trim(),children:[Le&&(0,t.jsx)(`div`,{className:`dt-toolbar`,children:(0,t.jsxs)(`label`,{className:`dt-search-label`,children:[(0,t.jsx)(`span`,{className:`dt-visually-hidden`,children:D.search}),(0,t.jsx)(`input`,{className:`dt-control dt-search`,type:`search`,value:F??``,placeholder:oe,onChange:e=>Ve(e.target.value)})]})}),pe&&(0,t.jsx)(`div`,{className:`dt-message dt-error`,role:`alert`,children:pe}),(0,t.jsx)(`div`,{className:`dt-scroll`,children:(0,t.jsxs)(`table`,{className:`dt-table`,"aria-busy":T,children:[f&&(0,t.jsx)(`caption`,{children:f}),(0,t.jsxs)(`thead`,{children:[(0,t.jsxs)(`tr`,{children:[C&&(0,t.jsx)(`th`,{scope:`col`,className:`dt-selection`,children:(0,t.jsx)(c,{checked:X.length>0&&Z===X.length,mixed:Z>0&&Z<X.length,onChange:We,label:D.selectPage})}),B.map(e=>{let n=(ne||e.sortable)&&e.sortable!==!1,r=P?.field===e.field?P.direction:null;return(0,t.jsx)(`th`,{scope:`col`,"aria-sort":r===`asc`?`ascending`:r===`desc`?`descending`:void 0,children:n?(0,t.jsxs)(`button`,{type:`button`,className:`dt-sort`,onClick:()=>Be(e),children:[e.headerName??e.field,(0,t.jsx)(`span`,{"aria-hidden":`true`,className:`dt-sort-icon`,children:r===`asc`?`↑`:r===`desc`?`↓`:`↕`})]}):e.headerName??e.field},e.field)}),H&&(0,t.jsx)(`th`,{scope:`col`,children:g})]}),B.some(e=>e.filterable)&&(0,t.jsxs)(`tr`,{className:`dt-filter-row`,children:[C&&(0,t.jsx)(`th`,{role:`presentation`}),B.map(e=>(0,t.jsx)(`th`,{role:`presentation`,children:e.filterable&&(0,t.jsx)(`input`,{className:`dt-control`,type:`search`,"aria-label":D.filter(e.headerName??e.field),value:I[e.field]??``,placeholder:D.filterPlaceholder,onChange:t=>He(e.field,t.target.value)})},e.field)),H&&(0,t.jsx)(`th`,{role:`presentation`})]})]}),(0,t.jsx)(`tbody`,{children:T?(0,t.jsx)(`tr`,{children:(0,t.jsx)(`td`,{className:`dt-empty`,colSpan:Math.max(Re,1),role:`status`,children:me})}):J.length===0?(0,t.jsx)(`tr`,{children:(0,t.jsx)(`td`,{className:`dt-empty`,colSpan:Math.max(Re,1),children:ee})}):J.map((e,n)=>{let r=h(e,n),i=String(r),a=z?O[i]??e:e,o=!!Ne[i];return(0,t.jsxs)(`tr`,{"aria-selected":C?Y.has(i):void 0,children:[C&&(0,t.jsx)(`td`,{className:`dt-selection`,children:(0,t.jsx)(`input`,{type:`checkbox`,checked:Y.has(i),"aria-label":D.selectRow(r),onChange:()=>Ue(Y.has(i)?R.filter(e=>String(e)!==i):[...R,r])})}),B.map(s=>{let c=Me[i]?.[s.field],u=`${Ie}-${i}-${s.field}`;return(0,t.jsxs)(`td`,{"data-label":s.headerName??s.field,children:[l({row:a,column:s,rowIndex:n,editable:p,saveMode:z,error:c,errorId:u,disabled:o,fileVersion:Pe[i]??0,selectOptionLabel:D.selectOption,onEdit:t=>Ge(t,e,s,r)}),c&&(0,t.jsx)(`span`,{className:`dt-field-error`,id:u,children:c})]},s.field)}),H&&(0,t.jsxs)(`td`,{"data-label":g,children:[(0,t.jsxs)(`div`,{className:`dt-actions`,children:[V.map((n,r)=>(0,t.jsxs)(`button`,{type:`button`,className:`dt-button ${n.className??``}`.trim(),style:n.style,disabled:o||n.disabled,"aria-label":n.ariaLabel??(typeof n.label==`string`?n.label:void 0),onClick:t=>m?n.onClick?.(t,e):n.onClick?.(e,t),children:[n.label,` `,n.icon]},n.id??r)),z&&O[i]&&(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(`button`,{type:`button`,className:`dt-button dt-primary`,disabled:o||!E,onClick:()=>qe(r,e),children:o?me:ye}),(0,t.jsx)(`button`,{type:`button`,className:`dt-button`,disabled:o,onClick:()=>{Ke(i),ge?.(e)},children:be})]})]}),M[i]&&(0,t.jsx)(`span`,{className:`dt-field-error`,role:`alert`,children:M[i]})]})]},r)})})]})}),U&&(0,t.jsxs)(`div`,{className:`dt-pagination`,children:[(0,t.jsxs)(`span`,{"aria-live":`polite`,children:[G===0?`0`:q*K+1,`–`,Math.min((q+1)*K,G),` de `,G]}),(0,t.jsxs)(`div`,{className:`dt-page-actions`,children:[(0,t.jsxs)(`label`,{children:[D.rowsPerPage,(0,t.jsx)(`select`,{className:`dt-control`,value:K,onChange:e=>Q({pageIndex:0,pageSize:Number(e.target.value)}),children:[10,25,50,100].includes(K)?[10,25,50,100].map(e=>(0,t.jsx)(`option`,{value:e,children:e},e)):[K,10,25,50,100].map(e=>(0,t.jsx)(`option`,{value:e,children:e},e))})]}),(0,t.jsx)(`button`,{type:`button`,className:`dt-button`,disabled:q===0||T,onClick:()=>Q({pageIndex:q-1,pageSize:K}),children:_e}),(0,t.jsx)(`button`,{type:`button`,className:`dt-button`,disabled:q>=ze||T,onClick:()=>Q({pageIndex:q+1,pageSize:K}),children:ve})]})]})]})}function d({getColumns:e,getRows:n,getButtons:r,onCaption:i,...a}){return(0,t.jsx)(u,{...a,columns:a.columns??e??[],rows:a.rows??n??[],actions:a.actions??r??[],caption:a.caption??i})}function f({getColumns:e,getRows:n,getButtons:r,onCaption:i,...a}){return(0,t.jsx)(u,{...a,editable:!0,columns:a.columns??e??[],rows:a.rows??n??[],actions:a.actions??r??[],legacyEditActions:a.actions==null&&r!=null,caption:a.caption??i})}exports.Table=d,exports.TableEdit=f;
1
+ Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("react"),t=require("react/jsx-runtime");var n=e=>e==null?``:String(e),r=(e,t,r)=>t.type===`image`?n((typeof t.imageAlt==`function`?t.imageAlt(e,r):t.imageAlt)??e?.alt):n(e);function i(e,t,i,a){let o=t.filter(e=>!e.hidden&&e.searchable!==!1&&(e.type!==`image`||e.searchable===!0)),s=String(i??``).trim().toLocaleLowerCase();return e.filter(e=>s&&!o.some(t=>r(e[t.field],t,e).toLocaleLowerCase().includes(s))?!1:Object.entries(a??{}).every(([i,a])=>{if(a==null||a===``)return!0;let o=t.find(e=>e.field===i);return o?o.filterFn?o.filterFn(e[i],a,e):r(e[i],o,e).toLocaleLowerCase().includes(n(a).toLocaleLowerCase()):!0}))}function a(e,t,n){if(!t?.field||!t?.direction)return e;let i=n.find(e=>e.field===t.field);if(!i)return e;let a=t.direction===`desc`?-1:1,o=new Intl.Collator(void 0,{numeric:!0,sensitivity:`base`});return e.map((e,t)=>({row:e,index:t})).sort((e,n)=>{let s=e.row[t.field],c=n.row[t.field];return s==null&&c==null?e.index-n.index:s==null?1:c==null?-1:(i.sortFn?i.sortFn(s,c,e.row,n.row):typeof s==`number`&&typeof c==`number`?s-c:o.compare(r(s,i,e.row),r(c,i,n.row)))*a||e.index-n.index}).map(({row:e})=>e)}function o(e,t,n){return e.slice(t*n,(t+1)*n)}var s={view:(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(`path`,{d:`M2 12s3.5-5 10-5 10 5 10 5-3.5 5-10 5S2 12 2 12Z`}),(0,t.jsx)(`circle`,{cx:`12`,cy:`12`,r:`2.5`})]}),edit:(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(`path`,{d:`M12 20h9`}),(0,t.jsx)(`path`,{d:`M16.5 3.5a2.1 2.1 0 0 1 3 3L8 18l-4 1 1-4L16.5 3.5Z`})]}),delete:(0,t.jsx)(t.Fragment,{children:(0,t.jsx)(`path`,{d:`M4 7h16M9 7V4h6v3M6 7l1 13h10l1-13M10 11v6M14 11v6`})}),download:(0,t.jsx)(t.Fragment,{children:(0,t.jsx)(`path`,{d:`M12 3v12m-4-4 4 4 4-4M4 17v4h16v-4`})}),more:(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(`circle`,{cx:`5`,cy:`12`,r:`1`}),(0,t.jsx)(`circle`,{cx:`12`,cy:`12`,r:`1`}),(0,t.jsx)(`circle`,{cx:`19`,cy:`12`,r:`1`})]}),check:(0,t.jsx)(`path`,{d:`m4 12 5 5L20 6`}),close:(0,t.jsx)(`path`,{d:`M5 5 19 19M19 5 5 19`})},c=e=>Object.hasOwn(s,e);function l({name:e}){return c(e)?(0,t.jsx)(`svg`,{className:`dt-action-icon`,width:`18`,height:`18`,viewBox:`0 0 24 24`,fill:`none`,stroke:`currentColor`,strokeWidth:`1.8`,strokeLinecap:`round`,strokeLinejoin:`round`,"aria-hidden":`true`,focusable:`false`,children:s[e]}):null}function u(e,t,n){return{source:typeof e==`string`?e:e?.src,alt:(typeof n.imageAlt==`function`?n.imageAlt(e,t):n.imageAlt)??e?.alt??(t?.name?`Foto de ${t.name}`:n.headerName??n.field),srcSet:typeof e==`string`?void 0:e?.srcSet,sizes:typeof e==`string`?void 0:e?.sizes,width:typeof e==`string`?void 0:e?.width,height:typeof e==`string`?void 0:e?.height}}function d({value:n,row:r,column:i,view:a,onOpen:o,openLabel:s}){let{source:c,alt:l,srcSet:d,sizes:f,width:p,height:m}=u(n,r,i),[h,g]=(0,e.useState)(!1);if((0,e.useEffect)(()=>g(!1),[c,d]),!c||h)return(0,t.jsx)(`span`,{className:`dt-image-placeholder dt-image-${a}`,children:i.imageFallback??`Sin foto`});let _=(0,t.jsx)(`img`,{className:`dt-image dt-image-${a}`,src:c,alt:l,srcSet:d,sizes:d?f??(a===`gallery`?`(max-width: 640px) 100vw, 33vw`:a===`avatar`?`42px`:a===`thumbnail`?`64px`:`96px`):void 0,width:p,height:m,loading:`lazy`,decoding:`async`,style:{objectFit:i.imageFit??`cover`,objectPosition:i.imagePosition??`center`},onError:()=>g(!0)});return o?(0,t.jsx)(`button`,{type:`button`,className:`dt-image-trigger`,"aria-label":s(l),onClick:o,children:_}):_}function f({entry:n,previous:r,next:i,onPrevious:a,onNext:o,onClose:s,labels:c}){let l=(0,e.useRef)(null);return(0,e.useEffect)(()=>{n&&l.current&&!l.current.open&&l.current.showModal?.()},[n]),n?(0,t.jsxs)(`dialog`,{ref:l,className:`dt-image-dialog`,"aria-label":c.imagePreview,onClose:s,children:[(0,t.jsxs)(`div`,{className:`dt-image-dialog-header`,children:[(0,t.jsx)(`strong`,{children:n.alt}),(0,t.jsx)(`button`,{type:`button`,className:`dt-button`,onClick:()=>{l.current?.open&&l.current.close(),s()},"aria-label":c.imageClose,children:`×`})]}),(0,t.jsx)(`img`,{src:n.source,srcSet:n.srcSet,sizes:n.srcSet?`(max-width: 760px) 92vw, 760px`:void 0,width:n.width,height:n.height,alt:n.alt}),(0,t.jsxs)(`div`,{className:`dt-image-dialog-actions`,children:[(0,t.jsx)(`button`,{type:`button`,className:`dt-button`,disabled:!r,onClick:a,children:c.imagePrevious}),(0,t.jsx)(`button`,{type:`button`,className:`dt-button`,disabled:!i,onClick:o,children:c.imageNext})]})]}):null}function p({columns:e,visibleFields:n,onMove:r,onToggle:i,onReset:a,orderReadOnly:o,visibilityReadOnly:s,labels:c}){let l=n.length;return(0,t.jsxs)(`details`,{className:`dt-column-controls`,children:[(0,t.jsx)(`summary`,{className:`dt-button`,children:c.columns}),(0,t.jsxs)(`div`,{className:`dt-column-panel`,children:[(0,t.jsxs)(`div`,{className:`dt-column-panel-heading`,children:[(0,t.jsx)(`strong`,{children:c.columns}),(0,t.jsx)(`button`,{type:`button`,className:`dt-column-reset`,onClick:a,disabled:o&&s,children:c.resetColumns})]}),(0,t.jsx)(`ul`,{children:e.map((a,u)=>{let d=a.headerName??a.field,f=n.includes(a.field),p=e[u-1],m=e[u+1];return(0,t.jsxs)(`li`,{children:[(0,t.jsxs)(`label`,{className:`dt-column-toggle`,children:[(0,t.jsx)(`input`,{type:`checkbox`,checked:f,disabled:s||a.hideable===!1||f&&l<=1,onChange:e=>i(a.field,e.target.checked)}),(0,t.jsx)(`span`,{children:d})]}),(0,t.jsxs)(`span`,{className:`dt-column-move`,children:[(0,t.jsx)(`button`,{type:`button`,className:`dt-button`,"aria-label":c.moveColumnUp(d),title:c.moveColumnUp(d),disabled:o||!p||a.reorderable===!1||p.reorderable===!1,onClick:()=>r(a.field,-1),children:`↑`}),(0,t.jsx)(`button`,{type:`button`,className:`dt-button`,"aria-label":c.moveColumnDown(d),title:c.moveColumnDown(d),disabled:o||!m||a.reorderable===!1||m.reorderable===!1,onClick:()=>r(a.field,1),children:`↓`})]})]},a.field)})})]})]})}function m({caption:e,rows:n,imageColumn:r,titleField:i,descriptionField:a,getRowId:o,selectedSet:s,selectable:c,onSelect:l,actions:u,renderAction:f,onImageOpen:p,sortColumns:m,filterColumns:h,sort:g,filters:_,onSortField:v,onSortDirection:ee,onFilter:te,sortReadOnly:ne,filterReadOnly:re,onTogglePage:ie,selectedPageCount:y,gallery:b,loading:x,loadingMessage:S,emptyMessage:ae,labels:C}){let oe=typeof e==`string`?e:C.gallery,se=[`square`,`landscape`,`portrait`].includes(b.aspectRatio)?b.aspectRatio:`landscape`,w=b.cardSize===`compact`?`compact`:`comfortable`,ce=m.length>0||h.length>0||c;return(0,t.jsxs)(`section`,{className:`dt-gallery`,"aria-label":oe,"aria-busy":x,children:[e&&(0,t.jsx)(`div`,{className:`dt-gallery-heading`,children:e}),ce&&(0,t.jsxs)(`div`,{className:`dt-gallery-controls`,children:[m.length>0&&(0,t.jsxs)(`div`,{className:`dt-gallery-sort`,children:[(0,t.jsxs)(`label`,{children:[C.gallerySort,(0,t.jsxs)(`select`,{className:`dt-control`,value:g?.field??``,disabled:ne,onChange:e=>v(e.target.value),children:[(0,t.jsx)(`option`,{value:``,children:C.galleryNoSort}),m.map(e=>(0,t.jsx)(`option`,{value:e.field,children:e.headerName??e.field},e.field))]})]}),(0,t.jsx)(`button`,{type:`button`,className:`dt-button`,disabled:!g||ne,"aria-label":g?.direction===`desc`?C.galleryAscending:C.galleryDescending,onClick:ee,children:g?.direction===`desc`?`↓`:`↑`})]}),h.map(e=>(0,t.jsxs)(`label`,{className:`dt-gallery-filter`,children:[C.filter(e.headerName??e.field),(0,t.jsx)(`input`,{className:`dt-control`,type:`search`,disabled:re,value:_[e.field]??``,placeholder:C.filterPlaceholder,onChange:t=>te(e.field,t.target.value)})]},e.field)),c&&(0,t.jsxs)(`label`,{className:`dt-gallery-select-page`,children:[(0,t.jsx)(`input`,{type:`checkbox`,checked:n.length>0&&y===n.length,disabled:x||n.length===0,ref:e=>{e&&(e.indeterminate=y>0&&y<n.length)},onChange:ie}),C.selectPage]})]}),x?(0,t.jsx)(`div`,{className:`dt-message`,role:`status`,children:S}):n.length===0?(0,t.jsx)(`div`,{className:`dt-message dt-gallery-empty`,children:ae}):(0,t.jsx)(`ul`,{className:`dt-gallery-grid dt-gallery-grid-${w}`,children:n.map((e,n)=>{let m=o(e,n),h=String(m),g=e?.[r.field],_=e?.[i],v=a?e?.[a]:null;return(0,t.jsx)(`li`,{className:`dt-gallery-item`,children:(0,t.jsxs)(`article`,{className:`dt-gallery-card`,"aria-label":String(_??m),children:[(0,t.jsx)(`div`,{className:`dt-gallery-media dt-gallery-media-${se}`,children:(0,t.jsx)(d,{value:g,row:e,column:r,view:`gallery`,openLabel:C.imageOpen,onOpen:r.previewable||r.onImageClick?()=>p(g,e,m):void 0})}),(0,t.jsxs)(`div`,{className:`dt-gallery-content`,children:[(0,t.jsxs)(`div`,{className:`dt-gallery-title-row`,children:[(0,t.jsx)(`h3`,{children:String(_??m)}),c&&(0,t.jsx)(`input`,{type:`checkbox`,checked:s.has(h),"aria-label":C.selectRow(m),onChange:()=>l(m)})]}),v!=null&&v!==``&&(0,t.jsx)(`p`,{children:String(v)}),b.renderDetails&&(0,t.jsx)(`div`,{className:`dt-gallery-details`,children:b.renderDetails(e,n)}),u.length>0&&(0,t.jsx)(`div`,{className:`dt-actions`,children:u.map((t,n)=>f(t,e,n))})]})]})},h)})})]})}function h(e,t){let n=t.filter(e=>!e.hidden).map(e=>e.field),r=new Set(n),i=[];for(let t of Array.isArray(e)?e:[])r.has(t)&&!i.includes(t)&&i.push(t);for(let e of n)i.includes(e)||i.push(e);return i}function g(e,t){if(!e||typeof window>`u`)return{key:e,...t};try{let n=JSON.parse(window.localStorage.getItem(e)??`null`);return{key:e,order:Array.isArray(n?.order)?n.order:t.order,visibility:n?.visibility&&typeof n.visibility==`object`&&!Array.isArray(n.visibility)?n.visibility:t.visibility}}catch{return{key:e,...t}}}function _(e,t,n){if(e&&typeof window<`u`)try{window.localStorage.setItem(e,JSON.stringify({order:t,visibility:n}))}catch{}}var v=new Set([`table`,`gallery`]);function ee(e,t){let n=v.has(t)?t:`table`;if(!e||typeof window>`u`)return{key:e,layout:n};try{let t=JSON.parse(window.localStorage.getItem(e)??`null`);return{key:e,layout:v.has(t?.layout)?t.layout:n}}catch{return{key:e,layout:n}}}function te(e,t){if(e&&typeof window<`u`&&v.has(t))try{window.localStorage.setItem(e,JSON.stringify({layout:t}))}catch{}}var ne=(e,t)=>e?.id??t,re={pageIndex:0,pageSize:10};function ie({checked:e,mixed:n,onChange:r,label:i}){return(0,t.jsx)(`input`,{type:`checkbox`,checked:e,"aria-checked":n?`mixed`:e,"aria-label":i,onChange:r,ref:e=>{e&&(e.indeterminate=n)}})}function y({action:e,onClick:n,disabled:r}){let i=e.icon??(c(e.iconName)?(0,t.jsx)(l,{name:e.iconName}):null),a=e.ariaLabel??(typeof e.label==`string`?e.label:void 0),o=!!(i&&a&&(e.iconOnly||e.label==null)),s=[`primary`,`danger`].includes(e.variant)?e.variant:`default`;return(0,t.jsxs)(`button`,{type:`button`,className:`dt-button dt-action-button dt-action-${s} ${o?`dt-icon-only`:``} ${e.className??``}`.trim(),style:e.style,disabled:r||e.disabled,"aria-label":a,title:o?a:void 0,onClick:n,children:[i&&e.iconPosition!==`end`&&(0,t.jsx)(`span`,{className:`dt-action-symbol`,children:i}),e.label!=null&&(0,t.jsx)(`span`,{className:o?`dt-visually-hidden`:`dt-action-label`,children:e.label}),i&&e.iconPosition===`end`&&(0,t.jsx)(`span`,{className:`dt-action-symbol`,children:i})]})}function b({row:n,column:r,rowIndex:i,imageView:a,imageOpenLabel:o,onImageOpen:s,editable:c,saveMode:l,onEdit:u,error:f,errorId:p,disabled:m,fileVersion:h,selectOptionLabel:g}){let _=n?.[r.field];if(typeof r.renderCell==`function`)return r.renderCell(_,n,i);if(r.type===`image`)return(0,t.jsx)(d,{value:_,row:n,column:r,view:a,openLabel:o,onOpen:r.previewable||r.onImageClick?()=>s(_,n,r):void 0});if(!c)return _??null;let v={name:r.field,"aria-label":r.headerName||r.field,"aria-invalid":!!f||void 0,"aria-describedby":f?p:void 0,disabled:m,onChange:e=>u(e,n,r)};return r.type===`button`?(0,t.jsx)(y,{action:r,disabled:m,onClick:e=>r.onClick?.(e,n)}):r.type===`select`?(0,t.jsxs)(`select`,{...v,className:`dt-control`,value:_??``,disabled:m||!l&&!r.onChange,children:[_==null&&(0,t.jsx)(`option`,{value:``,disabled:!0,children:r.placeholder??g}),(r.options??[]).map(e=>(0,t.jsx)(`option`,{value:e.value,children:e.label},String(e.value)))]}):[`text`,`date`,`number`,`file`].includes(r.type)?r.type===`file`?(0,e.createElement)(`input`,{...v,key:h,className:`dt-control`,type:`file`}):(0,t.jsx)(`input`,{...v,className:`dt-control`,type:r.type,value:_??``,readOnly:!l&&!r.onChange}):_??null}function x({columns:n=[],rows:r=[],actions:s=[],bulkActions:c=[],caption:d,editable:v=!1,legacyEditActions:x=!1,getRowId:S=ne,actionsHeader:ae=`Acciones`,emptyMessage:C=`No hay datos`,className:oe=``,sortable:se=!1,sort:w,onSortChange:ce,searchable:le=!1,search:ue,onSearchChange:de,searchPlaceholder:fe=`Buscar…`,filters:T,onFiltersChange:pe,paginationEnabled:me=!1,pagination:he,onPaginationChange:ge,manualSorting:_e=!1,manualFiltering:ve=!1,manualPagination:ye=!1,rowCount:be,selectable:E=!1,selectedRowIds:xe,onSelectionChange:Se,defaultImageView:Ce=`thumbnail`,imageView:we,onImageViewChange:Te,allowImageViewChange:Ee=!1,allowColumnCustomization:De=!1,columnOrder:Oe,defaultColumnOrder:ke,onColumnOrderChange:Ae,columnVisibility:je,defaultColumnVisibility:Me,onColumnVisibilityChange:Ne,columnPreferencesKey:D,defaultLayout:Pe=`table`,layout:Fe,onLayoutChange:Ie,allowLayoutChange:Le=!1,layoutPreferencesKey:O,gallery:Re={},loading:k=!1,error:ze,loadingMessage:Be=`Cargando…`,editMode:Ve=`immediate`,onSave:He,onCancel:Ue,previousLabel:We=`Anterior`,nextLabel:Ge=`Siguiente`,saveLabel:Ke=`Guardar`,cancelLabel:qe=`Cancelar`,labels:Je={}}){let A={search:`Buscar en la tabla`,filter:e=>`Filtrar ${e}`,filterPlaceholder:`Filtrar…`,selectPage:`Seleccionar página`,selectRow:e=>`Seleccionar fila ${e}`,rowsPerPage:`Filas por página`,selectOption:`Selecciona una opción`,imageView:`Vista de fotos`,imageAvatar:`Avatares`,imageThumbnail:`Miniaturas`,imageLarge:`Grandes`,imageHidden:`Ocultar fotos`,imageOpen:e=>`Ampliar ${e}`,imagePreview:`Vista ampliada de la foto`,imagePrevious:`Anterior foto`,imageNext:`Siguiente foto`,imageClose:`Cerrar foto`,columns:`Columnas`,resetColumns:`Restablecer`,moveColumnUp:e=>`Mover ${e} a la izquierda`,moveColumnDown:e=>`Mover ${e} a la derecha`,layout:`Presentación`,layoutTable:`Tabla`,layoutGallery:`Galería`,gallery:`Galería de fotos`,gallerySort:`Ordenar por`,galleryNoSort:`Sin ordenar`,galleryAscending:`Orden ascendente`,galleryDescending:`Orden descendente`,selectedCount:e=>`${e} ${e===1?`seleccionado`:`seleccionados`}`,bulkActions:`Acciones de selección`,clearSelection:`Limpiar selección`,...Je},[Ye,Xe]=(0,e.useState)(null),[Ze,Qe]=(0,e.useState)(``),[$e,et]=(0,e.useState)({}),[tt,nt]=(0,e.useState)(re),[rt,it]=(0,e.useState)([]),[at,ot]=(0,e.useState)(Ce),[st,ct]=(0,e.useState)(()=>ee(O,Pe)),lt=st.key===O?st.layout:ee(O,Pe).layout,j={order:ke??n.map(e=>e.field),visibility:Me??{}},[ut,dt]=(0,e.useState)(()=>g(D,j)),ft=ut.key===D?ut:g(D,j),[M,N]=(0,e.useState)(null),[P,pt]=(0,e.useState)({}),[mt,ht]=(0,e.useState)({}),[gt,_t]=(0,e.useState)({}),[vt,yt]=(0,e.useState)({}),[bt,xt]=(0,e.useState)({}),St=(0,e.useId)().replace(/:/g,``);(0,e.useEffect)(()=>{ut.key!==D&&dt(ft)},[D,ut.key]),(0,e.useEffect)(()=>{st.key!==O&&ct(ee(O,Pe))},[O,st.key]);let F=w===void 0?Ye:w,Ct=ue===void 0?Ze:ue,I=T===void 0?$e:T,wt=he??tt,L=xe===void 0?rt:xe,R=we??at,Tt=Fe??lt,Et=h(Oe??ft.order,n),z=je??ft.visibility,B=new Map(n.map(e=>[e.field,e])),Dt=Et.map(e=>B.get(e)),Ot=Dt.filter(e=>!e.hidden),kt=Ot.filter(e=>z[e.field]!==!1).map(e=>e.field),V=v&&Ve===`save`,At=n.some(e=>e.type===`image`&&!e.hidden),H=Dt.filter(e=>!e.hidden&&z[e.field]!==!1&&(e.type!==`image`||R!==`hidden`)),jt=n.find(e=>e.type===`image`&&e.field===Re.imageField)??n.find(e=>e.type===`image`&&!e.hidden),U=!v&&jt&&Tt===`gallery`?`gallery`:`table`,Mt=Re.titleField??H.find(e=>e.type!==`image`)?.field,Nt=Re.descriptionField,Pt=n.filter(e=>!e.hidden&&e.type!==`image`&&(se||e.sortable)&&e.sortable!==!1),Ft=n.filter(e=>!e.hidden&&e.type!==`image`&&e.filterable),It=Array.isArray(s)?s:[],Lt=Array.isArray(c)?c:[],Rt=It.length>0||V,zt=le||ue!==void 0,Bt=Ee&&At,Vt=De&&Ot.length>0,Ht=!v&&!!jt&&Le,Ut=Oe!==void 0&&!Ae,Wt=je!==void 0&&!Ne,Gt=me||he!==void 0,Kt=H.length+ +!!E+ +!!Rt,qt=(0,e.useMemo)(()=>{let e=n.map(e=>({...e,hidden:e.hidden||z[e.field]===!1||e.type===`image`&&R===`hidden`})),t=ve?r:i(r,e,Ct,I);return _e?t:a(t,F,n)},[r,n,z,R,Ct,I,F,ve,_e]),W=ye?be??r.length:qt.length,G=Math.max(1,Number(wt.pageSize)||10),Jt=Math.max(0,Math.ceil(W/G)-1),K=Math.max(0,Math.min(Number(wt.pageIndex)||0,Jt)),q=Gt&&!ye?o(qt,K,G):qt,Yt=M&&B.get(M.field),J=Yt?q.map((e,t)=>({...u(e?.[Yt.field],e,Yt),rowId:S(e,t)})).filter(e=>e.source):[],Y=J.findIndex(e=>String(e.rowId)===String(M?.rowId)),Xt=J[Y]??null,X=new Set(L.map(String)),Z=q.map((e,t)=>S(e,t)),Q=Z.filter(e=>X.has(String(e))).length,Zt=e=>{let t={pageIndex:Math.max(0,e.pageIndex),pageSize:e.pageSize};he===void 0&&nt(t),ge?.(t)},Qt=()=>{Gt&&K!==0&&Zt({pageIndex:0,pageSize:G})},$t=e=>{w===void 0&&Xe(e),ce?.(e),Qt()},en=e=>{let t={field:e.field,direction:F?.field===e.field&&F.direction===`asc`?`desc`:`asc`};$t(t)},tn=e=>{ue===void 0&&Qe(e),de?.(e),Qt()},nn=(e,t)=>{let n={...I,[e]:t};T===void 0&&et(n),pe?.(n),Qt()},$=e=>{xe===void 0&&it(e),Se?.(e,r.filter((t,n)=>e.some(e=>String(e)===String(S(t,n)))))},rn=e=>{we===void 0&&ot(e),Te?.(e)},an=e=>{Fe===void 0&&ct({key:O,layout:e}),Ie?.(e),te(O,e)},on=(e,t,n,r)=>{n.onImageClick?n.onImageClick(e,t):N({field:n.field,rowId:r})},sn=e=>{Oe===void 0&&dt(t=>({...t,key:D,order:e})),Ae?.(e),_(D,e,z)},cn=e=>{je===void 0&&dt(t=>({...t,key:D,visibility:e})),Ne?.(e),_(D,Et,e)},ln=(e,t)=>{let n=Ot.map(e=>e.field),r=n[n.indexOf(e)+t];if(!r||B.get(e)?.reorderable===!1||B.get(r)?.reorderable===!1)return;let i=[...Et],a=i.indexOf(e),o=i.indexOf(r);[i[a],i[o]]=[i[o],i[a]],sn(i)},un=(e,t)=>{B.get(e)?.hideable===!1||!t&&kt.length<=1||cn({...z,[e]:t})},dn=()=>{let e=h(j.order,n);Ut||sn(e),Wt||cn(j.visibility),_(D,Ut?Et:e,Wt?z:j.visibility)},fn=()=>{let e=Z.length>0&&Q===Z.length?L.filter(e=>!Z.some(t=>String(t)===String(e))):[...L,...Z.filter(e=>!X.has(String(e)))];$(e)},pn=(e,t,n,r)=>{if(!V){n.onChange?.(e,t);return}let i=n.type===`file`?e.target.files?.[0]??null:e.target.value,a=String(r),o={...t,...P[a],[n.field]:i};if(pt(e=>({...e,[a]:o})),yt(e=>({...e,[a]:``})),n.validate){let e=n.validate(i,o)||``;ht(t=>({...t,[a]:{...t[a],[n.field]:e}}))}},mn=e=>{pt(t=>{let n={...t};return delete n[e],n}),ht(t=>{let n={...t};return delete n[e],n}),yt(t=>{let n={...t};return delete n[e],n}),xt(t=>({...t,[e]:(t[e]??0)+1}))},hn=async(e,t)=>{let r=String(e),i=P[r];if(!i||!He)return;let a={};for(let e of n)if(e.validate){let t=e.validate(i[e.field],i);t&&(a[e.field]=t)}if(Object.keys(a).length)ht(e=>({...e,[r]:a}));else{_t(e=>({...e,[r]:!0}));try{await He(i,t),mn(r)}catch(e){yt(t=>({...t,[r]:e?.message||`No se pudo guardar`}))}finally{_t(e=>({...e,[r]:!1}))}}};return(0,t.jsxs)(`div`,{className:`dt-container ${oe}`.trim(),children:[(zt||Bt||Vt||Ht)&&(0,t.jsxs)(`div`,{className:`dt-toolbar`,children:[zt&&(0,t.jsxs)(`label`,{className:`dt-search-label`,children:[(0,t.jsx)(`span`,{className:`dt-visually-hidden`,children:A.search}),(0,t.jsx)(`input`,{className:`dt-control dt-search`,type:`search`,value:Ct??``,placeholder:fe,onChange:e=>tn(e.target.value)})]}),Ht&&(0,t.jsxs)(`div`,{className:`dt-layout-control`,role:`group`,"aria-label":A.layout,children:[(0,t.jsx)(`button`,{type:`button`,className:`dt-button`,"aria-pressed":U===`table`,disabled:Fe!==void 0&&!Ie,onClick:()=>an(`table`),children:A.layoutTable}),(0,t.jsx)(`button`,{type:`button`,className:`dt-button`,"aria-pressed":U===`gallery`,disabled:Fe!==void 0&&!Ie,onClick:()=>an(`gallery`),children:A.layoutGallery})]}),Bt&&U===`table`&&(0,t.jsxs)(`label`,{className:`dt-image-view-label`,children:[A.imageView,(0,t.jsxs)(`select`,{className:`dt-control`,value:R,disabled:we!==void 0&&!Te,onChange:e=>rn(e.target.value),children:[(0,t.jsx)(`option`,{value:`avatar`,children:A.imageAvatar}),(0,t.jsx)(`option`,{value:`thumbnail`,children:A.imageThumbnail}),(0,t.jsx)(`option`,{value:`large`,children:A.imageLarge}),(0,t.jsx)(`option`,{value:`hidden`,children:A.imageHidden})]})]}),Vt&&U===`table`&&(0,t.jsx)(p,{columns:Ot,visibleFields:kt,onMove:ln,onToggle:un,onReset:dn,orderReadOnly:Ut,visibilityReadOnly:Wt,labels:A})]}),ze&&(0,t.jsx)(`div`,{className:`dt-message dt-error`,role:`alert`,children:ze}),E&&L.length>0&&Lt.length>0&&(0,t.jsxs)(`div`,{className:`dt-bulk-bar`,role:`toolbar`,"aria-label":A.bulkActions,children:[(0,t.jsx)(`strong`,{"aria-live":`polite`,children:A.selectedCount(L.length)}),(0,t.jsxs)(`div`,{className:`dt-actions`,children:[Lt.map((e,n)=>(0,t.jsx)(y,{action:e,onClick:t=>e.onClick?.(r.filter((e,t)=>X.has(String(S(e,t)))),L,t)},e.id??n)),(0,t.jsx)(`button`,{type:`button`,className:`dt-button`,onClick:()=>$([]),children:A.clearSelection})]})]}),U===`gallery`&&(0,t.jsx)(m,{caption:d,rows:q,imageColumn:jt,titleField:Mt,descriptionField:Nt,getRowId:S,selectedSet:X,selectable:E,selectedPageCount:Q,onTogglePage:fn,onSelect:e=>{let t=String(e);$(X.has(t)?L.filter(e=>String(e)!==t):[...L,e])},actions:It,sortColumns:Pt,filterColumns:Ft,sort:F,filters:I,sortReadOnly:w!==void 0&&!ce,filterReadOnly:T!==void 0&&!pe,onSortField:e=>$t(e?{field:e,direction:`asc`}:null),onSortDirection:()=>{F&&$t({field:F.field,direction:F.direction===`asc`?`desc`:`asc`})},onFilter:nn,gallery:Re,renderAction:(e,n,r)=>(0,t.jsx)(y,{action:e,onClick:t=>e.onClick?.(n,t)},e.id??r),onImageOpen:(e,t,n)=>on(e,t,jt,n),loading:k,loadingMessage:Be,emptyMessage:C,labels:A}),U===`table`&&(0,t.jsx)(`div`,{className:`dt-scroll`,children:(0,t.jsxs)(`table`,{className:`dt-table`,"aria-busy":k,children:[d&&(0,t.jsx)(`caption`,{children:d}),(0,t.jsxs)(`thead`,{children:[(0,t.jsxs)(`tr`,{children:[E&&(0,t.jsx)(`th`,{scope:`col`,className:`dt-selection`,children:(0,t.jsx)(ie,{checked:Z.length>0&&Q===Z.length,mixed:Q>0&&Q<Z.length,onChange:fn,label:A.selectPage})}),H.map(e=>{let n=(se||e.sortable)&&e.sortable!==!1,r=F?.field===e.field?F.direction:null;return(0,t.jsx)(`th`,{scope:`col`,"aria-sort":r===`asc`?`ascending`:r===`desc`?`descending`:void 0,children:n?(0,t.jsxs)(`button`,{type:`button`,className:`dt-sort`,onClick:()=>en(e),children:[e.headerName??e.field,(0,t.jsx)(`span`,{"aria-hidden":`true`,className:`dt-sort-icon`,children:r===`asc`?`↑`:r===`desc`?`↓`:`↕`})]}):e.headerName??e.field},e.field)}),Rt&&(0,t.jsx)(`th`,{scope:`col`,children:ae})]}),H.some(e=>e.filterable)&&(0,t.jsxs)(`tr`,{className:`dt-filter-row`,children:[E&&(0,t.jsx)(`th`,{role:`presentation`}),H.map(e=>(0,t.jsx)(`th`,{role:`presentation`,children:e.filterable&&(0,t.jsx)(`input`,{className:`dt-control`,type:`search`,"aria-label":A.filter(e.headerName??e.field),value:I[e.field]??``,placeholder:A.filterPlaceholder,onChange:t=>nn(e.field,t.target.value)})},e.field)),Rt&&(0,t.jsx)(`th`,{role:`presentation`})]})]}),(0,t.jsx)(`tbody`,{children:k?(0,t.jsx)(`tr`,{children:(0,t.jsx)(`td`,{className:`dt-empty`,colSpan:Math.max(Kt,1),role:`status`,children:Be})}):q.length===0?(0,t.jsx)(`tr`,{children:(0,t.jsx)(`td`,{className:`dt-empty`,colSpan:Math.max(Kt,1),children:C})}):q.map((e,n)=>{let r=S(e,n),i=String(r),a=V?P[i]??e:e,o=!!gt[i];return(0,t.jsxs)(`tr`,{"aria-selected":E?X.has(i):void 0,children:[E&&(0,t.jsx)(`td`,{className:`dt-selection`,children:(0,t.jsx)(`input`,{type:`checkbox`,checked:X.has(i),"aria-label":A.selectRow(r),onChange:()=>$(X.has(i)?L.filter(e=>String(e)!==i):[...L,r])})}),H.map(s=>{let c=mt[i]?.[s.field],l=`${St}-${i}-${s.field}`;return(0,t.jsxs)(`td`,{"data-label":s.headerName??s.field,children:[b({row:a,column:s,rowIndex:n,imageView:R,imageOpenLabel:A.imageOpen,onImageOpen:(e,t,n)=>{on(e,t,n,r)},editable:v,saveMode:V,error:c,errorId:l,disabled:o,fileVersion:bt[i]??0,selectOptionLabel:A.selectOption,onEdit:t=>pn(t,e,s,r)}),c&&(0,t.jsx)(`span`,{className:`dt-field-error`,id:l,children:c})]},s.field)}),Rt&&(0,t.jsxs)(`td`,{"data-label":ae,children:[(0,t.jsxs)(`div`,{className:`dt-actions`,children:[It.map((n,r)=>(0,t.jsx)(y,{action:n,disabled:o,onClick:t=>x?n.onClick?.(t,e):n.onClick?.(e,t)},n.id??r)),V&&P[i]&&(0,t.jsxs)(t.Fragment,{children:[(0,t.jsxs)(`button`,{type:`button`,className:`dt-button dt-primary`,disabled:o||!He,onClick:()=>hn(r,e),children:[(0,t.jsx)(l,{name:`check`}),o?Be:Ke]}),(0,t.jsxs)(`button`,{type:`button`,className:`dt-button`,disabled:o,onClick:()=>{mn(i),Ue?.(e)},children:[(0,t.jsx)(l,{name:`close`}),qe]})]})]}),vt[i]&&(0,t.jsx)(`span`,{className:`dt-field-error`,role:`alert`,children:vt[i]})]})]},r)})})]})}),Gt&&(0,t.jsxs)(`div`,{className:`dt-pagination`,children:[(0,t.jsxs)(`span`,{"aria-live":`polite`,children:[W===0?`0`:K*G+1,`–`,Math.min((K+1)*G,W),` de `,W]}),(0,t.jsxs)(`div`,{className:`dt-page-actions`,children:[(0,t.jsxs)(`label`,{children:[A.rowsPerPage,(0,t.jsx)(`select`,{className:`dt-control`,value:G,onChange:e=>Zt({pageIndex:0,pageSize:Number(e.target.value)}),children:[10,25,50,100].includes(G)?[10,25,50,100].map(e=>(0,t.jsx)(`option`,{value:e,children:e},e)):[G,10,25,50,100].map(e=>(0,t.jsx)(`option`,{value:e,children:e},e))})]}),(0,t.jsx)(`button`,{type:`button`,className:`dt-button`,disabled:K===0||k,onClick:()=>Zt({pageIndex:K-1,pageSize:G}),children:We}),(0,t.jsx)(`button`,{type:`button`,className:`dt-button`,disabled:K>=Jt||k,onClick:()=>Zt({pageIndex:K+1,pageSize:G}),children:Ge})]})]}),(0,t.jsx)(f,{entry:Xt,previous:J[Y-1],next:J[Y+1],onPrevious:()=>N({...M,rowId:J[Y-1].rowId}),onNext:()=>N({...M,rowId:J[Y+1].rowId}),onClose:()=>N(null),labels:A})]})}function S({getColumns:e,getRows:n,getButtons:r,onCaption:i,...a}){return(0,t.jsx)(x,{...a,columns:a.columns??e??[],rows:a.rows??n??[],actions:a.actions??r??[],caption:a.caption??i})}function ae({getColumns:e,getRows:n,getButtons:r,onCaption:i,...a}){return(0,t.jsx)(x,{...a,editable:!0,columns:a.columns??e??[],rows:a.rows??n??[],actions:a.actions??r??[],legacyEditActions:a.actions==null&&r!=null,caption:a.caption??i})}exports.Table=S,exports.TableEdit=ae;
package/dist/index.d.ts CHANGED
@@ -1,21 +1,52 @@
1
1
  import type { CSSProperties, ReactNode, ChangeEvent, MouseEvent } from 'react';
2
2
 
3
3
  export type TableRow = object;
4
+ export type TableImageView = 'avatar' | 'thumbnail' | 'large' | 'hidden';
5
+ export type TableLayout = 'table' | 'gallery';
6
+ export interface TableGalleryOptions<Row extends TableRow = TableRow> {
7
+ imageField?: string;
8
+ titleField?: string;
9
+ descriptionField?: string;
10
+ aspectRatio?: 'square' | 'landscape' | 'portrait';
11
+ cardSize?: 'compact' | 'comfortable';
12
+ renderDetails?: (row: Row, rowIndex: number) => ReactNode;
13
+ }
14
+ export type TableActionIconName = 'view' | 'edit' | 'delete' | 'download' | 'more' | 'check' | 'close';
15
+ export interface TableImageValue {
16
+ src: string;
17
+ alt?: string;
18
+ srcSet?: string;
19
+ sizes?: string;
20
+ width?: number;
21
+ height?: number;
22
+ }
4
23
  export interface TableOption { value: string | number; label: ReactNode }
5
24
  export interface TableColumn<Row extends TableRow = TableRow> {
6
25
  field: string;
7
26
  headerName?: string;
8
27
  hidden?: boolean;
28
+ hideable?: boolean;
29
+ reorderable?: boolean;
9
30
  sortable?: boolean;
10
31
  filterable?: boolean;
11
32
  searchable?: boolean;
12
- type?: 'text' | 'date' | 'number' | 'file' | 'select' | 'button';
33
+ type?: 'text' | 'date' | 'number' | 'file' | 'select' | 'button' | 'image';
13
34
  options?: TableOption[];
14
35
  placeholder?: string;
15
36
  label?: ReactNode;
16
37
  ariaLabel?: string;
17
38
  icon?: ReactNode;
39
+ iconName?: TableActionIconName;
40
+ iconOnly?: boolean;
41
+ iconPosition?: 'start' | 'end';
42
+ variant?: 'default' | 'primary' | 'danger';
18
43
  style?: CSSProperties;
44
+ imageAlt?: string | ((value: unknown, row: Row) => string);
45
+ imageFit?: 'cover' | 'contain';
46
+ imagePosition?: CSSProperties['objectPosition'];
47
+ imageFallback?: ReactNode;
48
+ previewable?: boolean;
49
+ onImageClick?: (value: TableImageValue | string | null | undefined, row: Row) => void;
19
50
  renderCell?: (value: unknown, row: Row, rowIndex: number) => ReactNode;
20
51
  sortFn?: (left: unknown, right: unknown, leftRow: Row, rightRow: Row) => number;
21
52
  filterFn?: (value: unknown, filter: string, row: Row) => boolean;
@@ -27,12 +58,21 @@ export interface TableAction<Row extends TableRow = TableRow> {
27
58
  id?: string | number;
28
59
  label?: ReactNode;
29
60
  icon?: ReactNode;
61
+ iconName?: TableActionIconName;
62
+ iconOnly?: boolean;
63
+ iconPosition?: 'start' | 'end';
64
+ variant?: 'default' | 'primary' | 'danger';
30
65
  ariaLabel?: string;
31
66
  className?: string;
32
67
  style?: CSSProperties;
33
68
  disabled?: boolean;
34
69
  onClick?: (row: Row, event: MouseEvent<HTMLButtonElement>) => void;
35
70
  }
71
+ export interface TableBulkAction<Row extends TableRow = TableRow>
72
+ extends Omit<TableAction<Row>, 'onClick'> {
73
+ onClick?: (loadedRows: Row[], selectedIds: Array<string | number>,
74
+ event: MouseEvent<HTMLButtonElement>) => void;
75
+ }
36
76
  export interface LegacyEditAction<Row extends TableRow = TableRow>
37
77
  extends Omit<TableAction<Row>, 'onClick'> {
38
78
  onClick?: (event: MouseEvent<HTMLButtonElement>, row: Row) => void;
@@ -47,11 +87,37 @@ export interface TableLabels {
47
87
  selectRow?: (id: string | number) => string;
48
88
  rowsPerPage?: string;
49
89
  selectOption?: string;
90
+ imageView?: string;
91
+ imageAvatar?: string;
92
+ imageThumbnail?: string;
93
+ imageLarge?: string;
94
+ imageHidden?: string;
95
+ imageOpen?: (alt: string) => string;
96
+ imagePreview?: string;
97
+ imagePrevious?: string;
98
+ imageNext?: string;
99
+ imageClose?: string;
100
+ columns?: string;
101
+ resetColumns?: string;
102
+ moveColumnUp?: (header: string) => string;
103
+ moveColumnDown?: (header: string) => string;
104
+ layout?: string;
105
+ layoutTable?: string;
106
+ layoutGallery?: string;
107
+ gallery?: string;
108
+ gallerySort?: string;
109
+ galleryNoSort?: string;
110
+ galleryAscending?: string;
111
+ galleryDescending?: string;
112
+ selectedCount?: (count: number) => string;
113
+ bulkActions?: string;
114
+ clearSelection?: string;
50
115
  }
51
116
  interface BaseProps<Row extends TableRow> {
52
117
  columns?: TableColumn<Row>[];
53
118
  rows?: Row[];
54
119
  actions?: TableAction<Row>[];
120
+ bulkActions?: TableBulkAction<Row>[];
55
121
  caption?: ReactNode;
56
122
  actionsHeader?: ReactNode;
57
123
  getRowId?: (row: Row, index: number) => string | number;
@@ -59,7 +125,7 @@ interface BaseProps<Row extends TableRow> {
59
125
  className?: string;
60
126
  sortable?: boolean;
61
127
  sort?: TableSort | null;
62
- onSortChange?: (sort: TableSort) => void;
128
+ onSortChange?: (sort: TableSort | null) => void;
63
129
  searchable?: boolean;
64
130
  search?: string;
65
131
  onSearchChange?: (search: string) => void;
@@ -76,6 +142,19 @@ interface BaseProps<Row extends TableRow> {
76
142
  selectable?: boolean;
77
143
  selectedRowIds?: Array<string | number>;
78
144
  onSelectionChange?: (ids: Array<string | number>, loadedRows: Row[]) => void;
145
+ defaultImageView?: TableImageView;
146
+ imageView?: TableImageView;
147
+ onImageViewChange?: (view: TableImageView) => void;
148
+ allowImageViewChange?: boolean;
149
+ allowColumnCustomization?: boolean;
150
+ defaultColumnOrder?: string[];
151
+ columnOrder?: string[];
152
+ onColumnOrderChange?: (order: string[]) => void;
153
+ defaultColumnVisibility?: Record<string, boolean>;
154
+ columnVisibility?: Record<string, boolean>;
155
+ onColumnVisibilityChange?: (visibility: Record<string, boolean>) => void;
156
+ /** Optional localStorage key for the table's column order and visibility. */
157
+ columnPreferencesKey?: string;
79
158
  loading?: boolean;
80
159
  error?: ReactNode;
81
160
  loadingMessage?: ReactNode;
@@ -87,6 +166,14 @@ interface BaseProps<Row extends TableRow> {
87
166
  onCaption?: ReactNode;
88
167
  }
89
168
  export interface TableProps<Row extends TableRow = TableRow> extends BaseProps<Row> {
169
+ /** The gallery is available when an image column exists. */
170
+ defaultLayout?: TableLayout;
171
+ layout?: TableLayout;
172
+ onLayoutChange?: (layout: TableLayout) => void;
173
+ allowLayoutChange?: boolean;
174
+ /** Optional localStorage key for the preferred table/gallery layout. */
175
+ layoutPreferencesKey?: string;
176
+ gallery?: TableGalleryOptions<Row>;
90
177
  /** Legacy alias of actions. */
91
178
  getButtons?: TableAction<Row>[];
92
179
  }