@klu_dev/ui-klu-green 1.2.13 → 1.2.15

package/README.md

@@ -998,4 +998,61 @@ export default BadgeContainer;
 | Prop | Tipo | Por Defecto | Descripción |
 | :--- | :--- | :--- | :--- |
 | `icon` | `React.ReactElement<{ className?: string }>` | *Requerido* | El elemento del icono a renderizar en formato JSX (ej: `<Icons.SEAL />`). Recibe de forma transparente las utilidades de tamaño asignadas por el contenedor. |
-| `size` | `'sm' \| 'md' \| 'lg'` | `'sm'` | Define las dimensiones fijas en píxeles tanto del contenedor circular como del icono interior (`sm`: 24px/14px, `md`: 30px/20px, `lg`: 36px/26px). |
+| `size` | `'sm' \| 'md' \| 'lg'` | `'sm'` | Define las dimensiones fijas en píxeles tanto del contenedor circular como del icono interior (`sm`: 24px/14px, `md`: 30px/20px, `lg`: 36px/26px). |
+
+
+
+## Uso de DetailCard
+El componente DetailCard es una tarjeta de estado versátil y responsiva diseñada para mostrar resúmenes detallados de transacciones financieras o flujos operativos, soportando de forma dinámica los estados de éxito (Success) y error. Modifica su estructura visual de manera inteligente: en caso de éxito, oculta la descripción secundaria e integra una sección de "Comprobante de la transacción" con una liga de seguimiento copiable y un botón de descarga; en caso de error, renderiza un mensaje descriptivo formateado y adapta las acciones primarias para reintentar el proceso.
+
+```tsx
+import React from 'react';
+import { DetailCard } from './components/DetailCard';
+
+const MyTransactionScreen = () => {
+  const handlePrimary = () => console.log('Acción primaria ejecutada');
+  const handleSecondary = () => console.log('Regresando al inicio');
+
+  const summaryData = [
+    { label: 'Categoría:', value: 'Telefonía' },
+    { label: 'Servicio:', value: 'Telcel' },
+    { label: 'Comisión:', value: '$0.00' },
+    { label: 'Monto total:', value: '$100.00' },
+    { label: 'Fecha y Hora:', value: '24/06/2026 - 19:15 hrs' },
+    { label: 'Número:', value: '+52 55 0000 0000' },
+  ];
+
+  return (
+    <div className="uiklu-p-6">
+      {/* Ejemplo en Estado de Error */}
+      <DetailCard
+        type="error"
+        title="¡Error de pago de servicio!"
+        amount="$100.00"
+        message={`Por el momento no pudimos realizar el pago del servicio solicitado.\nPor favor, inténtalo de nuevo.`}
+        summaryItems={summaryData}
+        onPrimaryAction={handlePrimary}
+        onSecondaryAction={handleSecondary}
+      />
+    </div>
+  );
+};
+
+export default MyTransactionScreen;
+```
+
+### Props de DetailCard
+
+| Prop | Tipo | Por Defecto | Descripción |
+| :--- | :--- | :--- | :--- |
+| `type` | `'success' \| 'error'` | *Requerido* | Define el estado operativo del componente. Cambia el color del avatar circular superior, los textos por defecto de las acciones y habilita de forma condicionada los bloques de mensaje o liga de seguimiento. |
+| `title` | `string` | *Requerido* | Encabezado principal del estado del servicio que se renderiza debajo del icono (ej: "¡Pago de servicio realizado!"). |
+| `amount` | `string` | *Requerido* | El monto numérico formateado con divisa que protagoniza la tarjeta, destacado visualmente en un tamaño tipográfico dominante (40px). |
+| `message` | `string` | `undefined` | *Opcional.* Descripción detallada del suceso. Se muestra únicamente cuando `type="error"`. Soporta saltos de línea físicos mediante la propiedad de renderizado `pre-line`. |
+| `summaryTitle` | `string` | `'Resumen'` | Título secundario para la sección que encabeza el recuadro contenedor de datos descriptivos. |
+| `summaryItems` | `DetailCardItem[]` | *Requerido* | Colección de objetos con estructura `{ label: string; value: string }` que se listan ordenadamente dentro del contenedor asimétrico central. |
+| `trackingUrl` | `string` | `undefined` | *Opcional.* URL de la pasarela o folio de seguimiento de la operación. Habilita de manera condicionada el bloque interactivo de "Comprobante de la transacción" y la acción de copiar al portapapeles solo si `type="success"`. |
+| `primaryButtonText` | `string` | *Dinámico* | Texto del botón de acción principal. Si no se provee, se autoajusta a "Descargar comprobante" para casos exitosos o "Intentarlo nuevamente" para flujos con error. |
+| `secondaryButtonText`| `string` | `'Ir al inicio'` | Texto del botón secundario de contorno que permite la navegación de retorno o salida del flujo. |
+| `onPrimaryAction` | `() => void` | *Requerido* | Función callback disparada al hacer clic en el botón de acción principal (Descarga / Reintento). |
+| `onSecondaryAction` | `() => void` | *Requerido* | Función callback disparada al hacer clic en el botón de salida secundario. |

package/dist/index.css

@@ -161,6 +161,7 @@
     --uiklu-warningbg: 44 100% 96%;
     --uiklu-warningborder: 4 98% 89%;
     --uiklu-warningtext: 32 92% 53%;
+    --uiklu-errorbg: 4 100% 68%;
 
   }
 .uiklu-mask-content {
@@ -219,6 +220,10 @@ button,
 .uiklu-bottom-full{
     bottom: 100%;
 
+}
+.uiklu-left-0{
+    left: 0px;
+
 }
 .uiklu-left-3{
     left: 0.75rem;
@@ -302,6 +307,11 @@ button,
     margin-top: 0.5rem;
     margin-bottom: 0.5rem;
 
+}
+.uiklu-my-\[20px\]{
+    margin-top: 20px;
+    margin-bottom: 20px;
+
 }
 .uiklu-mb-1{
     margin-bottom: 0.25rem;
@@ -338,6 +348,10 @@ button,
 .uiklu-mb-\[18px\]{
     margin-bottom: 18px;
 
+}
+.uiklu-mb-\[20px\]{
+    margin-bottom: 20px;
+
 }
 .uiklu-mb-\[8px\]{
     margin-bottom: 8px;
@@ -482,6 +496,10 @@ button,
 .uiklu-h-\[26px\]{
     height: 26px;
 
+}
+.uiklu-h-\[28px\]{
+    height: 28px;
+
 }
 .uiklu-h-\[30px\]{
     height: 30px;
@@ -506,6 +524,10 @@ button,
 .uiklu-h-\[44px\]{
     height: 44px;
 
+}
+.uiklu-h-\[45\.5px\]{
+    height: 45.5px;
+
 }
 .uiklu-h-\[4px\]{
     height: 4px;
@@ -514,6 +536,10 @@ button,
 .uiklu-h-\[50px\]{
     height: 50px;
 
+}
+.uiklu-h-\[56px\]{
+    height: 56px;
+
 }
 .uiklu-h-\[60px\]{
     height: 60px;
@@ -526,6 +552,10 @@ button,
 .uiklu-h-\[70px\]{
     height: 70px;
 
+}
+.uiklu-h-\[80px\]{
+    height: 80px;
+
 }
 .uiklu-h-auto{
     height: auto;
@@ -602,6 +632,10 @@ button,
 .uiklu-w-8{
     width: 2rem;
 
+}
+.uiklu-w-\[140px\]{
+    width: 140px;
+
 }
 .uiklu-w-\[141px\]{
     width: 141px;
@@ -674,14 +708,26 @@ button,
 .uiklu-w-\[40px\]{
     width: 40px;
 
+}
+.uiklu-w-\[45\.5px\]{
+    width: 45.5px;
+
 }
 .uiklu-w-\[450px\]{
     width: 450px;
 
+}
+.uiklu-w-\[516px\]{
+    width: 516px;
+
 }
 .uiklu-w-\[550px\]{
     width: 550px;
 
+}
+.uiklu-w-\[56px\]{
+    width: 56px;
+
 }
 .uiklu-w-\[600px\]{
     width: 600px;
@@ -694,10 +740,18 @@ button,
 .uiklu-w-\[75px\]{
     width: 75px;
 
+}
+.uiklu-w-\[80px\]{
+    width: 80px;
+
 }
 .uiklu-w-\[var\(--radix-select-trigger-width\)\]{
     width: var(--radix-select-trigger-width);
 
+}
+.uiklu-w-auto{
+    width: auto;
+
 }
 .uiklu-w-fit{
     width: -moz-fit-content;
@@ -967,6 +1021,10 @@ button,
 .uiklu-gap-8{
     gap: 2rem;
 
+}
+.uiklu-gap-\[10px\]{
+    gap: 10px;
+
 }
 .uiklu-gap-\[14px\]{
     gap: 14px;
@@ -979,6 +1037,10 @@ button,
 .uiklu-gap-\[2px\]{
     gap: 2px;
 
+}
+.uiklu-gap-\[8px\]{
+    gap: 8px;
+
 }
 .uiklu-gap-x-1\.5{
     -moz-column-gap: 0.375rem;
@@ -1033,6 +1095,10 @@ button,
 .uiklu-self-center{
     align-self: center;
 
+}
+.uiklu-self-stretch{
+    align-self: stretch;
+
 }
 .uiklu-overflow-hidden{
     overflow: hidden;
@@ -1240,6 +1306,11 @@ button,
     --tw-border-opacity: 1;
     border-color: hsl(var(--uiklu-primary-50) / var(--tw-border-opacity, 1));
 
+}
+.uiklu-border-primary500{
+    --tw-border-opacity: 1;
+    border-color: hsl(var(--uiklu-primary-500) / var(--tw-border-opacity, 1));
+
 }
 .uiklu-border-primary900{
     --tw-border-opacity: 1;
@@ -1326,6 +1397,11 @@ button,
     --tw-bg-opacity: 1;
     background-color: hsl(var(--uiklu-destructive) / var(--tw-bg-opacity, 1));
 
+}
+.uiklu-bg-errorbg{
+    --tw-bg-opacity: 1;
+    background-color: hsl(var(--uiklu-errorbg) / var(--tw-bg-opacity, 1));
+
 }
 .uiklu-bg-gray-200{
     --tw-bg-opacity: 1;
@@ -1549,6 +1625,10 @@ button,
 .uiklu-p-\[14px\]{
     padding: 14px;
 
+}
+.uiklu-p-\[16px\]{
+    padding: 16px;
+
 }
 .uiklu-p-\[6px\]{
     padding: 6px;
@@ -1598,6 +1678,11 @@ button,
     padding-left: 10px;
     padding-right: 10px;
 
+}
+.uiklu-px-\[12px\]{
+    padding-left: 12px;
+    padding-right: 12px;
+
 }
 .uiklu-px-\[16px\]{
     padding-left: 16px;
@@ -1643,6 +1728,11 @@ button,
     padding-top: 0.75rem;
     padding-bottom: 0.75rem;
 
+}
+.uiklu-py-\[4px\]{
+    padding-top: 4px;
+    padding-bottom: 4px;
+
 }
 .uiklu-pb-4{
     padding-bottom: 1rem;
@@ -1778,6 +1868,10 @@ button,
 .uiklu-text-\[32px\]{
     font-size: 32px;
 
+}
+.uiklu-text-\[40px\]{
+    font-size: 40px;
+
 }
 .uiklu-text-\[8px\]{
     font-size: 8px;
@@ -2006,6 +2100,11 @@ button,
     --tw-text-opacity: 1;
     color: hsl(var(--uiklu-primary-400) / var(--tw-text-opacity, 1));
 
+}
+.uiklu-text-primary500{
+    --tw-text-opacity: 1;
+    color: hsl(var(--uiklu-primary-500) / var(--tw-text-opacity, 1));
+
 }
 .uiklu-text-primary600{
     --tw-text-opacity: 1;
@@ -2135,6 +2234,16 @@ button,
 .uiklu-ring-foreground\/10{
     --tw-ring-color: hsl(var(--uiklu-foreground) / 0.1);
 
+}
+.uiklu-brightness-0{
+    --tw-brightness: brightness(0);
+    filter: var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);
+
+}
+.uiklu-invert{
+    --tw-invert: invert(100%);
+    filter: var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);
+
 }
 .uiklu-backdrop-blur-md{
     --tw-backdrop-blur: blur(12px);
@@ -2276,6 +2385,12 @@ input.uiklu-flex:not(:placeholder-shown) {
 
 }
 
+.hover\:uiklu-bg-basewhite:hover{
+    --tw-bg-opacity: 1;
+    background-color: hsl(var(--uiklu-basewhite) / var(--tw-bg-opacity, 1));
+
+}
+
 .hover\:uiklu-bg-gray-100:hover{
     --tw-bg-opacity: 1;
     background-color: rgb(243 244 246 / var(--tw-bg-opacity, 1));

package/dist/index.d.ts

@@ -179,6 +179,25 @@ declare const Icons: {
     BOOKMARK: react_jsx_runtime.JSX.Element;
     EDIT: react_jsx_runtime.JSX.Element;
     DELETE: react_jsx_runtime.JSX.Element;
+    TELCEL: react_jsx_runtime.JSX.Element;
+    ATT: react_jsx_runtime.JSX.Element;
+    MOVISTAR: react_jsx_runtime.JSX.Element;
+    IAVE: react_jsx_runtime.JSX.Element;
+    PASE: react_jsx_runtime.JSX.Element;
+    MCIUDAD: react_jsx_runtime.JSX.Element;
+    CFE: react_jsx_runtime.JSX.Element;
+    GASN: react_jsx_runtime.JSX.Element;
+    TELMEX: react_jsx_runtime.JSX.Element;
+    DISH: react_jsx_runtime.JSX.Element;
+    SKY: react_jsx_runtime.JSX.Element;
+    MEGA: react_jsx_runtime.JSX.Element;
+    TOTALP: react_jsx_runtime.JSX.Element;
+    IZZI: react_jsx_runtime.JSX.Element;
+    XBOX: react_jsx_runtime.JSX.Element;
+    CALIENTE: react_jsx_runtime.JSX.Element;
+    WARNING: react_jsx_runtime.JSX.Element;
+    CHECK: react_jsx_runtime.JSX.Element;
+    DOWNLOAD: react_jsx_runtime.JSX.Element;
 };
 
 declare const searchSelectTriggerVariants: (props?: ({
@@ -252,4 +271,23 @@ interface IconBadgeProps {
 }
 declare const IconBadge: React.FC<IconBadgeProps>;
 
-export { BackButton, BalanceInfo, Button, Checkbox, type CheckboxProps, GridCard, IconBadge, type IconBadgeProps, Icons, Input, InputCode, InputPhone, type InputPhoneProps, type LadaOption, LoadingScreen, MobileMenuDrawer, Modal, PromoBanner, SearchSelect, Select, SidebarTabs, ToastAction, Toaster, Typography, useToast };
+interface DetailCardItem {
+    label: string;
+    value: string;
+}
+interface DetailCardProps {
+    type: 'success' | 'error';
+    title: string;
+    amount: string;
+    message?: string;
+    summaryTitle?: string;
+    summaryItems: DetailCardItem[];
+    trackingUrl?: string;
+    primaryButtonText?: string;
+    secondaryButtonText?: string;
+    onPrimaryAction: () => void;
+    onSecondaryAction: () => void;
+}
+declare const DetailCard: React__default.FC<DetailCardProps>;
+
+export { BackButton, BalanceInfo, Button, Checkbox, type CheckboxProps, DetailCard, type DetailCardItem, type DetailCardProps, GridCard, IconBadge, type IconBadgeProps, Icons, Input, InputCode, InputPhone, type InputPhoneProps, type LadaOption, LoadingScreen, MobileMenuDrawer, Modal, PromoBanner, SearchSelect, Select, SidebarTabs, ToastAction, Toaster, Typography, useToast };