@axzydev/axzy_ui_system 1.2.7 → 1.2.9

package/src/showcases/DataShowcases.tsx

@@ -3,6 +3,11 @@ import {
   ITTable,
   ITDataTable,
   ITBadget,
+  ITAvatar,
+  ITButton,
+  ITFlex,
+  ITStack,
+  ITText,
   ITImage,
   ITInput,
   ITSelect,
@@ -12,49 +17,174 @@ import {
 } from "../index";
 import { ShowcaseLayout } from "./ShowcaseLayout";
 
+const TABLE_DATA: Record<string, unknown>[] = [
+  { id: 1, name: "Sofía Castillo", email: "sofia@axzy.dev", role: "Admin", status: "active", lastLogin: "2026-07-18T09:30:00", sales: 28400 },
+  { id: 2, name: "Daniela Klein", email: "daniela@axzy.dev", role: "Editor", status: "active", lastLogin: "2026-07-17T14:22:00", sales: 15200 },
+  { id: 3, name: "Mariana Reyes", email: "mariana@axzy.dev", role: "Viewer", status: "inactive", lastLogin: "2026-07-10T11:00:00", sales: 3200 },
+  { id: 4, name: "Camila Torres", email: "camila@axzy.dev", role: "Admin", status: "active", lastLogin: "2026-07-18T08:15:00", sales: 42100 },
+  { id: 5, name: "Valentina Méndez", email: "valentina@axzy.dev", role: "Editor", status: "active", lastLogin: "2026-07-16T19:45:00", sales: 9800 },
+  { id: 6, name: "Luciana Rivas", email: "luciana@axzy.dev", role: "Viewer", status: "inactive", lastLogin: "2026-06-28T16:30:00", sales: 1500 },
+  { id: 7, name: "Isabella Cruz", email: "isabella@axzy.dev", role: "Editor", status: "active", lastLogin: "2026-07-18T10:05:00", sales: 20300 },
+  { id: 8, name: "Gabriela Vargas", email: "gabriela@axzy.dev", role: "Admin", status: "active", lastLogin: "2026-07-15T22:10:00", sales: 35600 },
+  { id: 9, name: "Ana López", email: "ana@axzy.dev", role: "Editor", status: "pending", lastLogin: "2026-07-14T11:20:00", sales: 7500 },
+  { id: 10, name: "Carla Jiménez", email: "carla@axzy.dev", role: "Viewer", status: "active", lastLogin: "2026-07-13T16:45:00", sales: 4100 },
+  { id: 11, name: "Luisa Fernández", email: "luisa@axzy.dev", role: "Admin", status: "active", lastLogin: "2026-07-12T08:00:00", sales: 51200 },
+  { id: 12, name: "Renata Morales", email: "renata@axzy.dev", role: "Editor", status: "inactive", lastLogin: "2026-06-30T12:15:00", sales: 6800 },
+  { id: 13, name: "Paola Herrera", email: "paola@axzy.dev", role: "Viewer", status: "pending", lastLogin: "2026-07-11T09:30:00", sales: 900 },
+  { id: 14, name: "Ximena Ríos", email: "ximena@axzy.dev", role: "Editor", status: "active", lastLogin: "2026-07-17T15:50:00", sales: 16700 },
+  { id: 15, name: "Florencia Díaz", email: "florencia@axzy.dev", role: "Admin", status: "active", lastLogin: "2026-07-18T07:15:00", sales: 48900 },
+];
+
+const nameColumn = {
+  key: "name",
+  label: "Name",
+  type: "string" as const,
+  sortable: true,
+  filter: true,
+  render: (row: Record<string, unknown>) => {
+    const initials = (row.name as string).split(" ").map((w: string) => w[0]).join("");
+    return (
+      <div className="flex items-center gap-2.5">
+        <ITAvatar initials={initials} size="sm" />
+        <div>
+          <p className="font-semibold text-slate-800 dark:text-white text-sm leading-tight">{row.name as string}</p>
+          <p className="text-[10px] text-slate-400">{row.email as string}</p>
+        </div>
+      </div>
+    );
+  },
+};
+
+const statusColor = (s: string) =>
+  s === "active" ? "bg-emerald-100 text-emerald-700 dark:bg-emerald-950/30 dark:text-emerald-300" :
+  s === "pending" ? "bg-amber-100 text-amber-700 dark:bg-amber-950/30 dark:text-amber-300" :
+  "bg-slate-100 text-slate-600 dark:bg-slate-800 dark:text-slate-400";
+
+const roleColor = (r: string) =>
+  r === "Admin" ? "bg-primary-100 text-primary-700 dark:bg-primary-950/40 dark:text-primary-300" :
+  r === "Editor" ? "bg-blue-100 text-blue-700 dark:bg-blue-950/40 dark:text-blue-300" :
+  "bg-slate-100 text-slate-600 dark:bg-slate-800 dark:text-slate-400";
+
 // 1. ITTable Showcase
 export const TableShowcase = () => {
   const [variant, setVariant] = useState<any>("default");
-  const [size, setSize] = useState<any>("md");
+  const [size, setSize] = useState<any>("sm");
+  const [useCustomCard, setUseCustomCard] = useState(true);
+
+  const customCard = (row: Record<string, unknown>) => {
+    const initials = (row.name as string).split(" ").map((w: string) => w[0]).join("");
+    const status = row.status as string;
+    const role = row.role as string;
+    const date = new Date(row.lastLogin as string);
+    return (
+      <div className="group bg-white dark:bg-slate-800 rounded-xl border border-slate-200 dark:border-slate-700 p-4 transition-all duration-200 hover:-translate-y-0.5 hover:shadow-lg hover:border-slate-300 dark:hover:border-slate-600">
+        <div className="flex items-start justify-between mb-3">
+          <div className="flex items-center gap-3">
+            <ITAvatar initials={initials} size="md" />
+            <div>
+              <p className="font-bold text-slate-800 dark:text-white text-sm">{row.name as string}</p>
+              <p className="text-xs text-slate-400">{row.email as string}</p>
+            </div>
+          </div>
+          <span className={`px-2 py-0.5 text-[10px] font-bold uppercase tracking-wider rounded-md ${statusColor(status)}`}>
+            {status}
+          </span>
+        </div>
+        <div className="flex items-center gap-3 text-xs text-slate-500 mb-3">
+          <span className={`px-2 py-0.5 rounded-md font-semibold ${roleColor(role)}`}>{role}</span>
+          <span>Last login: {date.toLocaleDateString("en-US", { month: "short", day: "numeric" })}</span>
+        </div>
+        <div className="flex items-center justify-between pt-3 border-t border-slate-100 dark:border-slate-700">
+          <span className="text-xs text-slate-400">Sales: <strong className="text-slate-700 dark:text-slate-200">${(row.sales as number).toLocaleString()}</strong></span>
+          <div className="flex gap-1.5 opacity-0 group-hover:opacity-100 transition-opacity">
+            <button className="p-1.5 rounded-md hover:bg-slate-100 dark:hover:bg-slate-700 text-slate-400 hover:text-primary-600 transition-colors">
+              <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2"><path d="M1 12s4-8 11-8 11 8 11 8-4 8-11 8-11-8-11-8z"/><circle cx="12" cy="12" r="3"/></svg>
+            </button>
+            <button className="p-1.5 rounded-md hover:bg-slate-100 dark:hover:bg-slate-700 text-slate-400 hover:text-blue-600 transition-colors">
+              <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2"><path d="M11 4H4a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7"/><path d="M18.5 2.5a2.121 2.121 0 0 1 3 3L12 15l-4 1 1-4 9.5-9.5z"/></svg>
+            </button>
+          </div>
+        </div>
+      </div>
+    );
+  };
 
   const columns: any = [
-    { key: "id", label: "ID", type: "number" },
-    { key: "name", label: "Nombre", type: "string" },
-    { key: "role", label: "Rol", type: "string" },
+    nameColumn,
+    { key: "email", label: "Email", type: "string", sortable: true, filter: true, className: "hidden lg:table-cell" },
+    {
+      key: "role",
+      label: "Role",
+      type: "string",
+      sortable: true,
+      filter: true,
+      render: (row: any) => (
+        <span className={`px-2 py-0.5 text-[10px] font-bold uppercase tracking-wider rounded-md ${roleColor(row.role)}`}>
+          {row.role}
+        </span>
+      )
+    },
     {
       key: "status",
-      label: "Estado",
-      type: "actions",
+      label: "Status",
+      type: "string",
+      sortable: true,
+      filter: true,
       render: (row: any) => (
-        <ITBadget
-          label={row.status ? "Conectado" : "Inactivo"}
-          color={row.status ? "success" : "danger"}
-          size="small"
-        />
+        <span className={`px-2 py-0.5 text-[10px] font-bold uppercase tracking-wider rounded-md ${statusColor(row.status)}`}>
+          {row.status}
+        </span>
+      )
+    },
+    {
+      key: "sales",
+      label: "Sales",
+      type: "number",
+      sortable: true,
+      render: (row: any) => <span className="font-mono font-semibold text-slate-800 dark:text-white">${(row.sales as number).toLocaleString()}</span>
+    },
+    {
+      key: "actions",
+      label: "",
+      type: "actions",
+      actions: (row: any) => (
+        <div className="flex gap-1">
+          <button className="p-1.5 rounded-md hover:bg-slate-100 dark:hover:bg-slate-700 text-slate-400 hover:text-primary-600 transition-colors" title="View">
+            <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2"><path d="M1 12s4-8 11-8 11 8 11 8-4 8-11 8-11-8-11-8z"/><circle cx="12" cy="12" r="3"/></svg>
+          </button>
+          <button className="p-1.5 rounded-md hover:bg-slate-100 dark:hover:bg-slate-700 text-slate-400 hover:text-blue-600 transition-colors" title="Edit">
+            <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2"><path d="M11 4H4a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7"/><path d="M18.5 2.5a2.121 2.121 0 0 1 3 3L12 15l-4 1 1-4 9.5-9.5z"/></svg>
+          </button>
+        </div>
       )
     }
   ];
 
-  const data = [
-    { id: 101, name: "Esteban Dido", role: "Auditor", status: true },
-    { id: 102, name: "Elsa Pato", role: "Administrador", status: true },
-    { id: 103, name: "Aquiles Baeza", role: "Operador", status: false }
-  ];
-
-  const code = `<ITTable\n  columns={columns}\n  data={data}\n  variant="${variant}"\n  size="${size}"\n/>`;
+  const code = `<ITTable
+  columns={columns}
+  data={data}
+  title="Team members"
+  variant="${variant}"
+  size="${size}"
+  defaultItemsPerPage={5}
+  renderCard={(row) => <CustomCard row={row} />}
+/>`;
 
   return (
     <ShowcaseLayout
       title="ITTable"
-      description="Base de renderizado de tablas estructuradas con soporte de alineamiento y tipado estricto."
+      description="Tabla con vista responsive Table / Cards, paginación, filtros y template de card personalizable."
       code={code}
       demo={
-        <div className="w-full bg-white dark:bg-slate-900  rounded-xl overflow-hidden shadow-sm">
+        <div className="w-full bg-white dark:bg-slate-900 rounded-xl overflow-hidden shadow-sm">
           <ITTable
             columns={columns}
-            data={data}
+            data={TABLE_DATA}
+            title="Team members"
             variant={variant}
             size={size}
+            defaultItemsPerPage={5}
+            renderCard={useCustomCard ? customCard : undefined}
           />
         </div>
       }
@@ -62,19 +192,19 @@ export const TableShowcase = () => {
         <>
           <ITSelect
             name="var_ctrl"
-            label="Variante Estilo"
+            label="Table variant"
             value={variant}
             onChange={(e: any) => setVariant(e.target.value)}
             options={[
               { label: "Default", value: "default" },
-              { label: "Striped (Cebra)", value: "striped" },
-              { label: "Bordered (Bordes)", value: "bordered" },
-              { label: "Clean (Limpio)", value: "clean" }
+              { label: "Striped", value: "striped" },
+              { label: "Bordered", value: "bordered" },
+              { label: "Clean", value: "clean" }
             ]}
           />
           <ITSelect
             name="sz_ctrl"
-            label="Tamaño Filas"
+            label="Row size"
             value={size}
             onChange={(e: any) => setSize(e.target.value)}
             options={[
@@ -83,30 +213,169 @@ export const TableShowcase = () => {
               { label: "Large (lg)", value: "lg" }
             ]}
           />
+          <div className="flex items-center justify-between pt-2">
+            <span className="text-sm font-semibold text-gray-700 dark:text-slate-300">Custom card template</span>
+            <ITSlideToggle isOn={useCustomCard} onToggle={setUseCustomCard} size="sm" />
+          </div>
+          {!useCustomCard && (
+            <div className="p-2 bg-slate-100 dark:bg-slate-800 rounded text-xs text-slate-500">
+              Default card active — shows all columns as label-value pairs
+            </div>
+          )}
         </>
       }
+      gallery={
+        <div className="space-y-6">
+          <div>
+            <h4 className="text-sm font-bold text-slate-700 dark:text-slate-200 mb-3">Custom cards with hover</h4>
+            <div className="grid grid-cols-1 sm:grid-cols-2 gap-4">
+              {TABLE_DATA.slice(0, 4).map((row, i) => {
+                const initials = (row.name as string).split(" ").map((w: string) => w[0]).join("");
+                const status = row.status as string;
+                const role = row.role as string;
+                const date = new Date(row.lastLogin as string);
+                return (
+                  <div key={i} className="group bg-white dark:bg-slate-800 rounded-xl border border-slate-200 dark:border-slate-700 p-4 transition-all duration-200 hover:-translate-y-0.5 hover:shadow-lg hover:border-slate-300 dark:hover:border-slate-600 cursor-pointer">
+                    <div className="flex items-start justify-between mb-3">
+                      <div className="flex items-center gap-3">
+                        <ITAvatar initials={initials} size="md" />
+                        <div>
+                          <p className="font-bold text-slate-800 dark:text-white text-sm">{row.name as string}</p>
+                          <p className="text-xs text-slate-400">{row.email as string}</p>
+                        </div>
+                      </div>
+                      <span className={`px-2 py-0.5 text-[10px] font-bold uppercase tracking-wider rounded-md ${statusColor(status)}`}>{status}</span>
+                    </div>
+                    <div className="flex items-center gap-3 text-xs text-slate-500 mb-3">
+                      <span className={`px-2 py-0.5 rounded-md font-semibold ${roleColor(role)}`}>{role}</span>
+                      <span>Login: {date.toLocaleDateString("en-US", { month: "short", day: "numeric" })}</span>
+                    </div>
+                    <div className="flex items-center justify-between pt-3 border-t border-slate-100 dark:border-slate-700">
+                      <span className="text-xs text-slate-400">Sales: <strong className="text-slate-700 dark:text-slate-200">${(row.sales as number).toLocaleString()}</strong></span>
+                      <div className="flex gap-1.5 opacity-0 group-hover:opacity-100 transition-opacity">
+                        <button className="p-1.5 rounded-md hover:bg-slate-100 dark:hover:bg-slate-700 text-slate-400 hover:text-primary-600"><svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2"><path d="M1 12s4-8 11-8 11 8 11 8-4 8-11 8-11-8-11-8z"/><circle cx="12" cy="12" r="3"/></svg></button>
+                        <button className="p-1.5 rounded-md hover:bg-slate-100 dark:hover:bg-slate-700 text-slate-400 hover:text-blue-600"><svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2"><path d="M11 4H4a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7"/><path d="M18.5 2.5a2.121 2.121 0 0 1 3 3L12 15l-4 1 1-4 9.5-9.5z"/></svg></button>
+                      </div>
+                    </div>
+                  </div>
+                );
+              })}
+            </div>
+          </div>
+
+          <div>
+            <h4 className="text-sm font-bold text-slate-700 dark:text-slate-200 mb-3">ITTable with default cards</h4>
+            <div className="border border-slate-200 dark:border-slate-700 rounded-xl overflow-hidden">
+              <ITTable
+                columns={columns}
+                data={TABLE_DATA.slice(0, 6)}
+                size="sm"
+                defaultItemsPerPage={6}
+                defaultView="cards"
+              />
+            </div>
+          </div>
+
+          <div>
+            <h4 className="text-sm font-bold text-slate-700 dark:text-slate-200 mb-3">ITTable with custom cards + pagination</h4>
+            <div className="border border-slate-200 dark:border-slate-700 rounded-xl overflow-hidden">
+              <ITTable
+                columns={columns}
+                data={TABLE_DATA}
+                size="sm"
+                title="All members"
+                defaultItemsPerPage={4}
+                renderCard={(row: any) => {
+                  const initials = (row.name as string).split(" ").map((w: string) => w[0]).join("");
+                  return (
+                    <div className="group bg-white dark:bg-slate-800 rounded-lg border border-slate-200 dark:border-slate-700 p-3 transition-all duration-200 hover:-translate-y-0.5 hover:shadow-md hover:border-slate-300 dark:hover:border-slate-600 cursor-pointer">
+                      <div className="flex items-center gap-3 mb-2">
+                        <ITAvatar initials={initials} size="sm" />
+                        <div className="flex-1 min-w-0">
+                          <p className="font-semibold text-slate-800 dark:text-white text-sm truncate">{row.name as string}</p>
+                          <p className="text-[11px] text-slate-400 truncate">{row.email as string}</p>
+                        </div>
+                        <span className={`px-2 py-0.5 text-[9px] font-bold uppercase tracking-wider rounded-md ${statusColor(row.status as string)}`}>{row.status as string}</span>
+                      </div>
+                      <div className="flex items-center justify-between text-xs text-slate-500">
+                        <span className={`px-1.5 py-0.5 rounded font-semibold ${roleColor(row.role as string)}`}>{row.role as string}</span>
+                        <span>${(row.sales as number).toLocaleString()}</span>
+                      </div>
+                    </div>
+                  );
+                }}
+              />
+            </div>
+          </div>
+        </div>
+      }
     />
   );
 };
 
 // 2. ITDataTable Showcase
 export const DataTableShowcase = () => {
+  const [useCustomCard, setUseCustomCard] = useState(true);
+  const [apiState, setApiState] = useState<"normal" | "loading" | "empty" | "error">("normal");
+  const [reloadKey, setReloadKey] = useState(0);
+  const [showVBorder, setShowVBorder] = useState(true);
+  const [borderStyle, setBorderStyle] = useState<"default" | "blue" | "rose" | "none">("default");
+
   const userColumns = useMemo(() => [
     { key: "id", label: "ID", type: "number" as const },
-    { key: "name", label: "Nombre", type: "string" as const, filter: true },
-    { key: "role", label: "Rol", type: "string" as const, filter: true },
-    { key: "active", label: "Activo", type: "boolean" as const, filter: true }
+    { key: "name", label: "Name", type: "string" as const, filter: true, sortable: true,
+      render: (row: any) => (
+        <div className="flex items-center gap-2.5">
+          <ITAvatar initials={(row.name as string).split(" ").map((w: string) => w[0]).join("")} size="sm" />
+          <span className="font-semibold text-slate-800 dark:text-white">{row.name}</span>
+        </div>
+      )
+    },
+    {
+      key: "role",
+      label: "Role",
+      type: "string" as const,
+      filter: true,
+      sortable: true,
+      render: (row: any) => (
+        <span className={`px-2 py-0.5 text-[10px] font-bold uppercase tracking-wider rounded-md ${
+          row.role === "Admin" ? "bg-primary-100 text-primary-700 dark:bg-primary-950/40 dark:text-primary-300" :
+          row.role === "Editor" ? "bg-blue-100 text-blue-700 dark:bg-blue-950/40 dark:text-blue-300" :
+          "bg-slate-100 text-slate-600 dark:bg-slate-800 dark:text-slate-400"
+        }`}>{row.role}</span>
+      )
+    },
+    { key: "active", label: "Active", type: "boolean" as const, filter: true }
+  ], []);
+
+  const MOCK_USERS = useMemo(() => [
+    { id: 1, name: "Sofía Castillo", role: "Admin", active: true },
+    { id: 2, name: "Daniela Klein", role: "Editor", active: true },
+    { id: 3, name: "Mariana Reyes", role: "Viewer", active: false },
+    { id: 4, name: "Camila Torres", role: "Admin", active: true },
+    { id: 5, name: "Valentina Méndez", role: "Editor", active: true },
+    { id: 6, name: "Luciana Rivas", role: "Viewer", active: false },
+    { id: 7, name: "Isabella Cruz", role: "Editor", active: true },
+    { id: 8, name: "Gabriela Vargas", role: "Admin", active: true },
+    { id: 9, name: "Ana López", role: "Editor", active: false },
+    { id: 10, name: "Carla Jiménez", role: "Viewer", active: true },
+    { id: 11, name: "Luisa Fernández", role: "Admin", active: true },
+    { id: 12, name: "Renata Morales", role: "Viewer", active: false },
   ], []);
 
   const fetchData = useCallback(async (params: ITDataTableFetchParams): Promise<ITDataTableResponse<any>> => {
-    await new Promise(resolve => setTimeout(resolve, 600));
-    let mockData = [
-      { id: 1, name: "Juan Pérez", role: "Administrador", active: true },
-      { id: 2, name: "María García", role: "Usuario", active: true },
-      { id: 3, name: "Pedro López", role: "Usuario", active: false },
-      { id: 4, name: "Ana Torres", role: "Editor", active: true },
-      { id: 5, name: "Luis Gómez", role: "Administrador", active: false }
-    ];
+    const delay = apiState === "loading" ? 8000 : 400;
+    await new Promise(resolve => setTimeout(resolve, delay));
+
+    if (apiState === "error") {
+      throw new Error("Connection lost — server is not responding");
+    }
+
+    if (apiState === "empty") {
+      return { data: [], total: 0 };
+    }
+
+    let mockData = [...MOCK_USERS];
 
     if (params.filters) {
       Object.keys(params.filters).forEach(key => {
@@ -119,32 +388,188 @@ export const DataTableShowcase = () => {
       });
     }
 
+    if (params.sort) {
+      const { key, direction } = params.sort;
+      mockData.sort((a: any, b: any) => {
+        const av = a[key], bv = b[key];
+        if (typeof av === "string") return direction === "asc" ? av.localeCompare(bv) : bv.localeCompare(av);
+        return direction === "asc" ? av - bv : bv - av;
+      });
+    }
+
+    const start = (params.page - 1) * params.limit;
+    const paged = mockData.slice(start, start + params.limit);
+
     return {
-      data: mockData,
+      data: paged,
       total: mockData.length
     };
-  }, []);
+  }, [apiState, MOCK_USERS]);
+
+  const handleStateChange = (s: typeof apiState) => {
+    setApiState(s);
+    setReloadKey(k => k + 1);
+  };
 
-  const code = `<ITDataTable\n  columns={[\n    { key: 'id', label: 'ID', type: 'number' },\n    { key: 'name', label: 'Nombre', type: 'string', filter: true }\n  ]}\n  fetchData={api.fetchUsers}\n/>`;
+  const code = `<ITDataTable
+  columns={columns}
+  fetchData={api.fetchUsers}
+  title="Users"
+  defaultItemsPerPage={5}
+  showVerticalBorder={${showVBorder}}${borderStyle !== "default" ? `\n  verticalBorderClassname="${borderStyle === "blue" ? "[&_th]:border-blue-200 [&_td]:border-blue-100" : "[&_th]:border-rose-200 [&_td]:border-rose-100"}"` : ""}
+  renderCard={(row) => <CustomCard row={row} />}
+/>`;
+
+  const borderClass = borderStyle === "default" ? undefined : borderStyle === "blue" ? "[&_th]:border-blue-200 dark:[&_th]:border-blue-800/30 [&_td]:border-blue-100 dark:[&_td]:border-blue-800/20" : borderStyle === "rose" ? "[&_th]:border-rose-200 dark:[&_th]:border-rose-800/30 [&_td]:border-rose-100 dark:[&_td]:border-rose-800/20" : undefined;
 
   return (
     <ShowcaseLayout
       title="ITDataTable"
-      description="Tabla de datos auto-suficiente con carga dinámica, paginación integrada y filtros avanzados."
+      description="Tabla auto-suficiente con carga dinámica, filtros, paginación y vista responsive Cards/Table."
       code={code}
       demo={
         <div className="w-full bg-white dark:bg-slate-900 border border-slate-200 dark:border-slate-800 rounded-xl overflow-hidden shadow-md">
           <ITDataTable
+            key={reloadKey}
             columns={userColumns}
             fetchData={fetchData}
+            title={apiState === "error" ? "Connection error" : apiState === "empty" ? "No data" : "Users"}
+            defaultItemsPerPage={4}
+            showVerticalBorder={showVBorder}
+            verticalBorderClassname={borderClass}
+            renderCard={useCustomCard ? (row: any) => {
+              const initials = (row.name as string).split(" ").map((w: string) => w[0]).join("");
+              return (
+                <div className="group bg-white dark:bg-slate-800 rounded-lg border border-slate-200 dark:border-slate-700 p-3 transition-all duration-200 hover:-translate-y-0.5 hover:shadow-md hover:border-slate-300 dark:hover:border-slate-600">
+                  <div className="flex items-center gap-3 mb-2">
+                    <ITAvatar initials={initials} size="sm" />
+                    <div className="flex-1 min-w-0">
+                      <p className="font-semibold text-slate-800 dark:text-white text-sm truncate">{row.name}</p>
+                    </div>
+                    <span className={`px-2 py-0.5 text-[9px] font-bold uppercase tracking-wider rounded-md ${
+                      row.active ? "bg-emerald-100 text-emerald-700 dark:bg-emerald-950/30 dark:text-emerald-300" : "bg-slate-100 text-slate-600 dark:bg-slate-800 dark:text-slate-400"
+                    }`}>{row.active ? "Active" : "Inactive"}</span>
+                  </div>
+                  <div className="flex items-center justify-between">
+                    <span className={`px-1.5 py-0.5 text-[10px] font-bold rounded ${
+                      row.role === "Admin" ? "bg-primary-100 text-primary-700 dark:bg-primary-950/40 dark:text-primary-300" :
+                      row.role === "Editor" ? "bg-blue-100 text-blue-700 dark:bg-blue-950/40 dark:text-blue-300" :
+                      "bg-slate-100 text-slate-600 dark:bg-slate-800 dark:text-slate-400"
+                    }`}>{row.role}</span>
+                    <span className="text-[10px] text-slate-400">ID: #{row.id}</span>
+                  </div>
+                </div>
+              );
+            } : undefined}
           />
         </div>
       }
       controls={
-        <div className="p-2 bg-slate-50 dark:bg-slate-900 rounded-lg text-xs space-y-2">
-          <p className="text-slate-500">Esta tabla consume una función de carga de datos que se autogestiona en ordenamiento, paginado y filtros.</p>
-          <div className="p-2 bg-amber-50 dark:bg-amber-950/20 border border-amber-200 dark:border-amber-900 rounded text-amber-800 dark:text-amber-300">
-            Prueba a escribir en los inputs de filtro de la tabla!
+        <div className="space-y-3">
+          <div>
+            <p className="text-xs font-bold uppercase tracking-wider text-slate-400 dark:text-slate-500 mb-2">API state</p>
+            <div className="flex flex-wrap gap-2">
+              {(["normal", "loading", "empty", "error"] as const).map((s) => (
+                <button
+                  key={s}
+                  onClick={() => handleStateChange(s)}
+                  className={`px-3 py-1.5 text-xs font-bold rounded-lg transition-all ${
+                    apiState === s
+                      ? "bg-slate-900 text-white dark:bg-white dark:text-slate-900 shadow-sm"
+                      : "bg-slate-100 dark:bg-slate-800 text-slate-600 dark:text-slate-300 hover:bg-slate-200 dark:hover:bg-slate-700"
+                  }`}
+                >
+                  {s === "normal" ? "✅ Normal" : s === "loading" ? "⏳ Loading" : s === "empty" ? "📭 Empty" : "💥 Error"}
+                </button>
+              ))}
+            </div>
+          </div>
+          <div className="flex items-center justify-between pt-1">
+            <span className="text-sm font-semibold text-gray-700 dark:text-slate-300">Custom card template</span>
+            <ITSlideToggle isOn={useCustomCard} onToggle={setUseCustomCard} size="sm" />
+          </div>
+          {!useCustomCard && (
+            <div className="p-2 bg-slate-100 dark:bg-slate-800 rounded text-xs text-slate-500">
+              Default card active — shows all columns as label-value pairs
+            </div>
+          )}
+          <div>
+            <p className="text-xs font-bold uppercase tracking-wider text-slate-400 dark:text-slate-500 mb-2">Borders</p>
+            <div className="flex flex-wrap gap-2">
+              {(["default", "blue", "rose", "none"] as const).map((s) => (
+                <button
+                  key={s}
+                  onClick={() => {
+                    setBorderStyle(s);
+                    setShowVBorder(s !== "none");
+                  }}
+                  className={`px-3 py-1.5 text-xs font-bold rounded-lg transition-all ${
+                    borderStyle === s
+                      ? "bg-slate-900 text-white dark:bg-white dark:text-slate-900 shadow-sm"
+                      : "bg-slate-100 dark:bg-slate-800 text-slate-600 dark:text-slate-300 hover:bg-slate-200 dark:hover:bg-slate-700"
+                  }`}
+                >
+                  {s === "default" ? "Gray" : s === "blue" ? "Blue" : s === "rose" ? "Rose" : "None"}
+                </button>
+              ))}
+            </div>
+          </div>
+        </div>
+      }
+      gallery={
+        <div className="space-y-6">
+          <div>
+            <h4 className="text-sm font-bold text-slate-700 dark:text-slate-200 mb-3">Custom cards with hover</h4>
+            <div className="border border-slate-200 dark:border-slate-700 rounded-xl overflow-hidden">
+              <GalleryDataTable
+                title="Team members"
+                defaultItemsPerPage={4}
+                renderCard={(row: any) => {
+                  const initials = (row.name as string).split(" ").map((w: string) => w[0]).join("");
+                  return (
+                    <div className="group bg-white dark:bg-slate-800 rounded-xl border border-slate-200 dark:border-slate-700 p-4 transition-all duration-200 hover:-translate-y-0.5 hover:shadow-lg hover:border-slate-300 dark:hover:border-slate-600">
+                      <div className="flex items-start justify-between mb-3">
+                        <div className="flex items-center gap-3">
+                          <ITAvatar initials={initials} size="md" />
+                          <div>
+                            <p className="font-bold text-slate-800 dark:text-white text-sm">{row.name as string}</p>
+                            <p className="text-xs text-slate-400">{row.email as string}</p>
+                          </div>
+                        </div>
+                        <span className={`px-2 py-0.5 text-[10px] font-bold uppercase tracking-wider rounded-md ${
+                          row.active ? "bg-emerald-100 text-emerald-700 dark:bg-emerald-950/30 dark:text-emerald-300" : "bg-slate-100 text-slate-600 dark:bg-slate-800 dark:text-slate-400"
+                        }`}>{row.active ? "Active" : "Inactive"}</span>
+                      </div>
+                      <div className="flex items-center gap-2 text-xs text-slate-500 mb-3">
+                        <span className={`px-2 py-0.5 rounded-md font-semibold ${
+                          row.role === "Admin" ? "bg-primary-100 text-primary-700 dark:bg-primary-950/40 dark:text-primary-300" :
+                          row.role === "Editor" ? "bg-blue-100 text-blue-700 dark:bg-blue-950/40 dark:text-blue-300" :
+                          "bg-slate-100 text-slate-600 dark:bg-slate-800 dark:text-slate-400"
+                        }`}>{row.role as string}</span>
+                      </div>
+                      <div className="flex items-center justify-between pt-3 border-t border-slate-100 dark:border-slate-700">
+                        <span className="text-xs text-slate-400">ID: <strong className="text-slate-700 dark:text-slate-200">#{row.id}</strong></span>
+                        <div className="flex gap-1.5 opacity-0 group-hover:opacity-100 transition-opacity">
+                          <button className="p-1.5 rounded-md hover:bg-slate-100 dark:hover:bg-slate-700 text-slate-400 hover:text-primary-600"><svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2"><path d="M1 12s4-8 11-8 11 8 11 8-4 8-11 8-11-8-11-8z"/><circle cx="12" cy="12" r="3"/></svg></button>
+                          <button className="p-1.5 rounded-md hover:bg-slate-100 dark:hover:bg-slate-700 text-slate-400 hover:text-blue-600"><svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2"><path d="M11 4H4a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7"/><path d="M18.5 2.5a2.121 2.121 0 0 1 3 3L12 15l-4 1 1-4 9.5-9.5z"/></svg></button>
+                        </div>
+                      </div>
+                    </div>
+                  );
+                }}
+              />
+            </div>
+          </div>
+
+          <div>
+            <h4 className="text-sm font-bold text-slate-700 dark:text-slate-200 mb-3">Default cards with pagination</h4>
+            <div className="border border-slate-200 dark:border-slate-700 rounded-xl overflow-hidden">
+              <GalleryDataTable
+                size="sm"
+                defaultItemsPerPage={3}
+                defaultView="cards"
+              />
+            </div>
           </div>
         </div>
       }
@@ -152,6 +577,65 @@ export const DataTableShowcase = () => {
   );
 };
 
+function GalleryDataTable({ title, size, defaultItemsPerPage, defaultView, renderCard }: {
+  title?: string;
+  size?: string;
+  defaultItemsPerPage?: number;
+  defaultView?: "table" | "cards";
+  renderCard?: (row: any) => React.ReactNode;
+}) {
+  const columns = useMemo(() => [
+    { key: "id", label: "ID", type: "number" as const },
+    { key: "name", label: "Name", type: "string" as const, filter: true, sortable: true,
+      render: (row: any) => (
+        <div className="flex items-center gap-2.5">
+          <ITAvatar initials={(row.name as string).split(" ").map((w: string) => w[0]).join("")} size="sm" />
+          <span className="font-semibold text-slate-800 dark:text-white">{row.name}</span>
+        </div>
+      )
+    },
+    {
+      key: "role", label: "Role", type: "string" as const, filter: true, sortable: true,
+      render: (row: any) => (
+        <span className={`px-2 py-0.5 text-[10px] font-bold uppercase tracking-wider rounded-md ${
+          row.role === "Admin" ? "bg-primary-100 text-primary-700 dark:bg-primary-950/40 dark:text-primary-300" :
+          row.role === "Editor" ? "bg-blue-100 text-blue-700 dark:bg-blue-950/40 dark:text-blue-300" :
+          "bg-slate-100 text-slate-600 dark:bg-slate-800 dark:text-slate-400"
+        }`}>{row.role}</span>
+      )
+    },
+    { key: "active", label: "Active", type: "boolean" as const, filter: true }
+  ], []);
+
+  const fetchData = useCallback(async (params: ITDataTableFetchParams) => {
+    const all = [
+      { id: 1, name: "Sofía Castillo", email: "sofia@axzy.dev", role: "Admin", active: true },
+      { id: 2, name: "Daniela Klein", email: "daniela@axzy.dev", role: "Editor", active: true },
+      { id: 3, name: "Mariana Reyes", email: "mariana@axzy.dev", role: "Viewer", active: false },
+      { id: 4, name: "Camila Torres", email: "camila@axzy.dev", role: "Admin", active: true },
+      { id: 5, name: "Valentina Méndez", email: "valentina@axzy.dev", role: "Editor", active: true },
+      { id: 6, name: "Luciana Rivas", email: "luciana@axzy.dev", role: "Viewer", active: false },
+      { id: 7, name: "Isabella Cruz", email: "isabella@axzy.dev", role: "Editor", active: true },
+      { id: 8, name: "Gabriela Vargas", email: "gabriela@axzy.dev", role: "Admin", active: true },
+    ];
+    await new Promise(r => setTimeout(r, 200));
+    const start = (params.page - 1) * params.limit;
+    return { data: all.slice(start, start + params.limit), total: all.length };
+  }, []);
+
+  return (
+    <ITDataTable
+      columns={columns}
+      fetchData={fetchData}
+      title={title}
+      size={size as any}
+      defaultItemsPerPage={defaultItemsPerPage}
+      defaultView={defaultView}
+      renderCard={renderCard}
+    />
+  );
+}
+
 // 3. ITBadget Showcase
 export const BadgetShowcase = () => {
   const [color, setColor] = useState<any>("success");