@khipu/design-system 0.2.0-alpha.4 → 0.2.0-alpha.41

package/dist/beercss/khipu-beercss.css

@@ -11,7 +11,7 @@
  *
  * AUTO-GENERATED FILE - DO NOT EDIT MANUALLY
  * Source: design-system/src/tokens/tokens.json
- * Generated: 2026-05-14T19:34:35.577Z
+ * Generated: 2026-06-11T18:38:45.718Z
  *
  * To regenerate:
  *   cd design-system && npm run tokens:generate
@@ -48,15 +48,21 @@
   --kds-color-success-main: #2E7D32;
   --kds-color-success-light: #4CAF50;
   --kds-color-success-dark: #1B5E20;
+  --kds-color-success-contrast: #FFFFFF;
   --kds-color-warning-main: #EF6C00;
   --kds-color-warning-light: #FF9800;
   --kds-color-warning-dark: #E65100;
+  --kds-color-warning-contrast: #FFFFFF;
+  --kds-color-warning-warm: #8A6D1A;
   --kds-color-error-main: #D32F2F;
   --kds-color-error-light: #EF5350;
   --kds-color-error-dark: #C62828;
+  --kds-color-error-contrast: #FFFFFF;
   --kds-color-info-main: #0288D1;
   --kds-color-info-light: #03A9F4;
   --kds-color-info-dark: #01579B;
+  --kds-color-info-contrast: #FFFFFF;
+  --kds-color-info-blue: #5A5FE0;
 
   /* Text colors */
   --kds-color-text-primary: #333333;
@@ -134,6 +140,8 @@
   --kds-font-weight-bold: 700;
 
   /* Font sizes (base scale xs–4xl: see responsive section below) */
+  --kds-font-size-decimal-sup: 0.5em;
+
   /* Line heights */
   --kds-line-height-tight: 1.2;
   --kds-line-height-snug: 1.375;
@@ -756,7 +764,7 @@ footer {
    ======================================== */
 :root {
     /* Scroll-linked collapse range (mobile sticky invoice) */
-    --kds-scroll-collapse-end: 150px;
+    --kds-scroll-collapse-end: 60px;
 
     /* Merchant tile: normal and collapsed sizes (from source prototype) */
     --kds-merchant-size: 64px;
@@ -778,6 +786,10 @@ footer {
  * Source: design.khipu.com and Material Design 3 specifications
  */
 
+ * {
+    border-radius: 0;
+ }
+
 
 :has(>main) {
     background-color: transparent !important;
@@ -842,7 +854,10 @@ a.kds-btn {
 
     /* Interaction */
     cursor: pointer;
-    transition: background .15s, box-shadow .15s, transform .05s;
+    transition: background-color var(--kds-transition-shorter) var(--kds-easing-standard),
+                color var(--kds-transition-shorter) var(--kds-easing-standard),
+                box-shadow var(--kds-transition-shorter) var(--kds-easing-standard),
+                transform var(--kds-transition-shortest) var(--kds-easing-standard);
     box-sizing: border-box;
     vertical-align: middle;
 }
@@ -974,7 +989,7 @@ a.kds-btn-text {
 
 button.kds-btn-text:hover:not(:disabled),
 a.kds-btn-text:hover:not(:disabled) {
-    background: var(--kds-color-primary-hover);  /* rgba(131, 71, 173, 0.04) */
+    color: var(--kds-color-primary-dark);
 }
 
 button.kds-btn-text:disabled,
@@ -984,6 +999,30 @@ a.kds-btn-text:disabled {
     box-shadow: none;
 }
 
+/* Error text (destructive, ghost) — red text, no fill/border. Para acciones
+   destructivas secundarias que no deben competir con el CTA primario. */
+button.kds-btn-error-text,
+a.kds-btn-error-text {
+    background: transparent;
+    color: var(--kds-color-error-main);
+    border: none;
+    padding: 6px var(--kds-spacing-2);
+    min-height: 32px;
+    box-shadow: none;
+}
+
+button.kds-btn-error-text:hover:not(:disabled),
+a.kds-btn-error-text:hover:not(:disabled) {
+    color: var(--kds-color-error-dark);
+}
+
+button.kds-btn-error-text:disabled,
+a.kds-btn-error-text:disabled {
+    background: transparent;
+    color: var(--kds-color-action-disabled);
+    box-shadow: none;
+}
+
 /* Icon wrapper - control size via span container */
 button.kds-btn > .kds-icon,
 a.kds-btn > .kds-icon {
@@ -1046,6 +1085,7 @@ a.kds-btn.kds-btn-md {
     padding: var(--kds-spacing-2);
     box-shadow: var(--kds-shadow-card);
     transition: box-shadow 0.3s ease;
+    margin-block-start: 0 !important;
 }
 
 .kds-card-elevated:hover,
@@ -1068,63 +1108,90 @@ a.kds-btn.kds-btn-md {
     }
 }
 
-/* Selection card */
+/* Selection card.
+   IMPORTANTE: este componente se renderiza como `<button>`. BeerCSS aplica al
+   `button` base: `display: inline-flex; align-items: center; justify-content: center;
+   block-size: 2.5rem; padding: 0 1rem; background: var(--primary); color: on-primary`.
+   Todas esas reglas hay que sobreescribirlas para que el card-selector funcione como
+   un contenedor flex column de altura variable y alineado a la izquierda.
+
+   Convención del DS: spacing entre hijos via `gap` del flex padre + padding.
+   Los elementos internos (.kds-card-selector-icon/-title/-description) NO usan margin. */
 .kds-card-selector {
+    /* Reset BeerCSS button */
+    display: flex;
+    flex-direction: column;
+    align-items: stretch;
+    justify-content: flex-start;
+    block-size: auto;
+    inline-size: 100%;
+    text-align: left;
+    line-height: 1.5;
+    color: var(--kds-color-text-primary);
+    /* Estilos propios del card-selector */
     padding: var(--kds-spacing-3);
+    gap: var(--kds-spacing-1-5);
     border-radius: var(--kds-radius-md);
-    border: 2px solid var(--kds-border-light);
+    border: var(--kds-border-width-md) solid var(--kds-border-light);
     background: var(--kds-color-background-paper);
     transition: all 0.3s ease;
-    text-align: left;
     cursor: pointer;
-    display: flex;
-    flex-direction: column;
 }
 
-.kds-card-selector:hover {
-    border-color: #D1D5DB;  /* gray-300 */
+.kds-card-selector:hover:not(.selected) {
+    border-color: var(--kds-color-primary-light);
+    background: var(--kds-color-primary-hover);
+}
+
+/* Override del ripple/overlay default de BeerCSS:
+   `:is(.wave,.chip,.button,button,nav.tabbed>a,...):not([class*=ripple])::after`
+   tiene specificity (0,2,4) según DevTools (Chrome cuenta cada selector dentro
+   de :is() individualmente para algunos motores). Usamos !important — consistente
+   con cómo se overridean otros estilos de BeerCSS en este archivo (67 usos previos).
+   Antes pintaba negro porque `currentColor` resolvía a text-primary del card. */
+.kds-card-selector::after {
+    background-image: radial-gradient(circle, var(--kds-color-primary-main) 1%, transparent 1%) !important;
 }
 
 .kds-card-selector.selected {
-    border-color: #3B82F6;  /* blue-600 */
-    background: #EFF6FF;    /* blue-50 */
+    border-color: var(--kds-color-primary-main);
+    background: var(--kds-color-primary-faint);
     box-shadow: var(--kds-shadow-md);
 }
 
-/* Icon container */
+/* Icon container — spacing manejado por gap del padre, no margin */
 .kds-card-selector-icon {
-    width: 48px;
-    height: 48px;
-    background: #DBEAFE;  /* blue-100 */
-    border-radius: 8px;
+    width: var(--kds-spacing-6);
+    height: var(--kds-spacing-6);
+    background: var(--kds-color-primary-focus);
+    border-radius: var(--kds-radius-sm);
     display: flex;
     align-items: center;
     justify-content: center;
-    margin-bottom: 16px;
 }
 
 .kds-card-selector-icon i,
 .kds-card-selector-icon svg {
-    width: 24px;
-    height: 24px;
-    min-width: 24px;
-    min-height: 24px;
-    color: #3B82F6;  /* blue-600 */
+    width: var(--kds-spacing-3);
+    height: var(--kds-spacing-3);
+    min-width: var(--kds-spacing-3);
+    min-height: var(--kds-spacing-3);
+    font-size: var(--kds-spacing-3);
+    color: var(--kds-color-primary-main);
 }
 
-/* Title */
+/* Title — spacing manejado por gap del padre, no margin */
 .kds-card-selector-title {
-    font-weight: 600;
+    font-weight: var(--kds-font-weight-semibold);
     color: var(--kds-color-text-primary);
-    margin-bottom: 8px;
-    font-size: 16px;
+    font-size: var(--kds-font-size-lg);
 }
 
 /* Description */
 .kds-card-selector-description {
-    font-size: 14px;
-    color: #4B5563;  /* gray-600 */
-    line-height: 1.5;
+    font-size: var(--kds-font-size-sm);
+    color: var(--kds-color-text-secondary);
+    line-height: var(--kds-line-height-normal);
 }
 
 /* Selected state - visual feedback via border only */
@@ -1136,14 +1203,22 @@ a.kds-btn.kds-btn-md {
     display: flex;
     flex-direction: column;
     gap: var(--kds-spacing-2);
-    padding: var(--kds-spacing-4);
+    padding: var(--kds-spacing-2);
     border-radius: var(--kds-radius-lg);
     border: 2px solid var(--kds-border-medium);
-    max-width: 400px; /* Increased from 365px for better text spacing */
+    /* Ancho mínimo aplicado a TODOS los planes — así un plan sin badge en una
+       grilla con un plan recomendado mantiene la misma anchura, y el badge nunca
+       se superpone al título por estrechez del card. */
+    min-width: 260px;
+    max-width: 400px;
     background: var(--kds-surface-base);
     transition: all 0.3s ease;
     cursor: pointer;
-    height: 100%; /* Ensure cards fill grid height */
+    /* Alto fijo: el card se estira al alto de su row del grid (align-items stretch
+       es el default) — todas las cards de la misma fila quedan a la misma altura
+       sin importar el contenido. `align-self: stretch` lo hace explícito. */
+    height: 100%;
+    align-self: stretch;
 }
 
 .kds-card-plan:hover {
@@ -1163,18 +1238,19 @@ a.kds-btn.kds-btn-md {
     box-shadow: var(--kds-shadow-elevation-4);
 }
 
-/* Recommended Badge */
+/* Recommended Badge — inline dentro del card (no flotante).
+   Es el primer hijo del .kds-card-plan, así que aparece arriba de todo
+   el contenido, alineado a la izquierda. */
 .kds-card-plan-badge {
-    position: absolute;
-    top: -12px;
-    right: var(--kds-spacing-6);
-    padding: var(--kds-spacing-1) var(--kds-spacing-4);
+    align-self: flex-start;
+    padding: var(--kds-spacing-0-5) var(--kds-spacing-1-5);
     background: var(--primary);
     color: white;
-    font-size: var(--kds-font-size-sm);
+    font-size: var(--kds-font-size-xs);
     font-weight: var(--kds-font-weight-semibold);
+    line-height: 1;
     border-radius: var(--kds-radius-full);
-    box-shadow: var(--kds-shadow-elevation-1);
+    white-space: nowrap;
 }
 
 /* Plan Header */
@@ -1202,13 +1278,11 @@ a.kds-btn.kds-btn-md {
     display: flex;
     align-items: baseline;
     gap: var(--kds-spacing-2);
-    padding: var(--kds-spacing-4) 0;
     border-bottom: 1px solid var(--kds-border-light);
-    min-height: 88px; /* Standardize price area height */
 }
 
 .kds-price {
-    font-size: 42px;
+    font-size: var(--kds-font-size-4xl);
     font-weight: var(--kds-font-weight-bold);
     color: var(--primary);
     line-height: 1.1;
@@ -1722,53 +1796,108 @@ a.kds-btn.kds-btn-md {
 }
 
 /* ========================================
-   Snackbar Positioning
+   Snackbar Positioning & Styling
    ======================================== */
 
 .snackbar {
     position: fixed;
-    bottom: var(--kds-spacing-3);
-    left: 50%;
-    transform: translateX(-50%);
     z-index: var(--kds-z-index-snackbar);
     min-width: 344px;
     max-width: var(--kds-snackbar-max-width);
     box-shadow: var(--kds-shadow-8);
+    border-radius: var(--kds-radius-md);
+    padding: var(--kds-spacing-1-5) var(--kds-spacing-2);
+    gap: var(--kds-spacing-1);
+    font-family: var(--kds-font-family-primary);
+    font-size: var(--kds-font-size-body2);
+    font-weight: var(--kds-font-weight-medium);
+    line-height: var(--kds-line-height-normal);
+    letter-spacing: var(--kds-letter-spacing-normal);
+    overflow: hidden;
 }
 
 /* Snackbar active state - ensure visibility when toggled via JS */
 .snackbar.active {
     visibility: visible !important;
     opacity: 1 !important;
-    transform: translateX(-50%) !important;
 }
 
-/* Snackbar semantic variants - background + text/icon color */
+/* Snackbar semantic variants
+   All use white text (--kds-color-primary-contrast) on solid semantic backgrounds */
 .snackbar.error {
     background-color: var(--kds-color-error-main) !important;
-    color: var(--on-error, var(--kds-color-primary-contrast)) !important;
+    color: var(--kds-color-primary-contrast) !important;
 }
 
 .snackbar.error i {
-    color: var(--on-error, var(--kds-color-primary-contrast)) !important;
+    color: var(--kds-color-primary-contrast) !important;
 }
 
 .snackbar.info {
     background-color: var(--kds-color-info-main) !important;
-    color: var(--on-info, var(--kds-color-primary-contrast)) !important;
+    color: var(--kds-color-primary-contrast) !important;
 }
 
 .snackbar.info i {
-    color: var(--on-info, var(--kds-color-primary-contrast)) !important;
+    color: var(--kds-color-primary-contrast) !important;
 }
 
 .snackbar.success {
     background-color: var(--kds-color-success-main) !important;
-    color: var(--on-success, var(--kds-color-primary-contrast)) !important;
+    color: var(--kds-color-primary-contrast) !important;
 }
 
 .snackbar.success i {
-    color: var(--on-success, var(--kds-color-primary-contrast)) !important;
+    color: var(--kds-color-primary-contrast) !important;
+}
+
+/* Snackbar progress bar — animated timer for auto-dismiss */
+.snackbar[data-auto-dismiss]::after {
+    content: '';
+    position: absolute;
+    bottom: 0;
+    left: 0;
+    height: 3px;
+    width: 100%;
+    background: rgba(255, 255, 255, 0.35);
+    border-radius: 0 0 var(--kds-radius-md) var(--kds-radius-md);
+    animation: kds-snackbar-timer var(--kds-snackbar-duration, 5s) linear forwards;
+}
+
+@keyframes kds-snackbar-timer {
+    from { width: 100%; }
+    to { width: 0; }
+}
+
+/* Snackbar close button */
+.kds-snackbar-close {
+    background: none !important;
+    border: none !important;
+    color: var(--kds-color-primary-contrast) !important;
+    cursor: pointer;
+    padding: var(--kds-spacing-0-5) !important;
+    margin: calc(-1 * var(--kds-spacing-0-5)) !important;
+    margin-left: 0 !important;
+    border-radius: var(--kds-radius-full) !important;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    flex-shrink: 0;
+    opacity: 0.7;
+    transition: opacity 150ms;
+    min-width: auto !important;
+    width: auto !important;
+    height: auto !important;
+}
+
+.kds-snackbar-close:hover {
+    opacity: 1;
+    background: rgba(255, 255, 255, 0.15) !important;
+}
+
+.kds-snackbar-close i {
+    font-size: 18px !important;
+    color: var(--kds-color-primary-contrast) !important;
 }
 
 /* ========================================
@@ -1969,6 +2098,106 @@ a.kds-btn-google:disabled {
     height: var(--kds-spacing-button-icon-size);
 }
 
+/* ========================================
+   KDS LINEAR PROGRESS
+   Native <progress> (KdsLinearProgress). Additive over BeerCSS `progress`,
+   scoped to .kds-progress so other consumers are unaffected.
+   ======================================== */
+
+/* `progress` is inline-block by default → leaves a baseline (descender) gap
+   below the bar. Block removes that gap so it sits flush with siblings. */
+.kds-progress {
+    display: block;
+}
+
+/* Animate the filled value when it changes (e.g. advancing a step). BeerCSS
+   sets the value background but no transition, so the width jumps abruptly. */
+.kds-progress::-webkit-progress-value {
+    transition: width var(--kds-transition-standard) var(--kds-easing-standard);
+}
+
+.kds-progress::-moz-progress-bar {
+    transition: width var(--kds-transition-standard) var(--kds-easing-standard);
+}
+
+/* ========================================
+   KDS SECURE LOADER
+   Loader de espera: anillo circular + candado centrado + frases opcionales.
+   El anillo reutiliza el spinner circular de BeerCSS, escalado.
+   ======================================== */
+
+.kds-secure-loader {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    gap: var(--kds-spacing-4);
+    text-align: center;
+}
+
+.kds-secure-loader-text {
+    display: flex;
+    flex-direction: column;
+    gap: var(--kds-spacing-1);
+}
+
+.kds-secure-loader-title {
+    margin: 0;
+    font-family: var(--kds-font-family-primary);
+    font-size: var(--kds-font-size-h6);
+    font-weight: var(--kds-font-weight-semibold);
+    line-height: var(--kds-line-height-snug);
+    color: var(--kds-color-text-primary);
+}
+
+.kds-secure-loader-message {
+    margin: 0;
+    font-family: var(--kds-font-family-secondary);
+    font-size: var(--kds-font-size-body1);
+    line-height: var(--kds-line-height-normal);
+    color: var(--kds-color-primary-main);
+}
+
+/* Caja del spinner con tamaño fijo: la animación no altera el layout */
+.kds-secure-loader-spinner {
+    position: relative;
+    display: inline-grid;
+    place-items: center;
+    inline-size: var(--kds-secure-loader-size, 7rem);
+    block-size: var(--kds-secure-loader-size, 7rem);
+}
+
+/* Anillo: SVG nativo con arco vía stroke-dasharray, rotando. Replica el
+   CircularProgress original (viewBox 44u, thickness 2, arco ~63%, disableShrink). */
+.kds-secure-loader-ring {
+    inline-size: var(--kds-secure-loader-size, 6.5rem);
+    block-size: var(--kds-secure-loader-size, 6.5rem);
+    animation: kds-secure-loader-spin 1.2s linear infinite;
+}
+
+.kds-secure-loader-ring circle {
+    fill: none;
+    stroke: var(--kds-color-primary-main);
+    stroke-width: 2;
+    stroke-linecap: round;
+    /* circunferencia ≈ 2π·20.2 ≈ 127; arco visible ≈ 80 (~63%) */
+    stroke-dasharray: 80 127;
+}
+
+@keyframes kds-secure-loader-spin {
+    to {
+        transform: rotate(360deg);
+    }
+}
+
+/* Candado centrado sobre el anillo */
+.kds-secure-loader-lock {
+    position: absolute;
+    color: var(--kds-color-text-secondary);
+    font-size: calc(var(--kds-secure-loader-size, 7rem) * 0.4);
+    pointer-events: none;
+}
+
 /* ========================================
    Link Styles
    ======================================== */
@@ -2101,6 +2330,17 @@ body.dark {
   transition: border-color 0.2s, box-shadow 0.2s, outline-color 0.2s;
 }
 
+/* === TEXTAREA FIX === */
+/* BeerCSS base sets minimal block padding; add breathing room for textarea */
+.field > textarea {
+  padding-block: 0.75rem;
+  resize: vertical;
+}
+
+.field.label > textarea {
+  padding-block-start: 1.5rem;
+}
+
 /* ==========================================
    NOTCH VISIBILITY (opacity)
    ========================================== */
@@ -2188,12 +2428,16 @@ body.dark {
    Asegurar que el dropdown arrow sea visible
    ========================================== */
 
-/* Select: mantener appearance nativa para mostrar el dropdown arrow */
+/* Select: reset nativo + arrow custom via SVG (iOS Safari ignora estilos con appearance:auto) */
 .field select {
-  /* BeerCSS puede estar ocultando el arrow, aseguramos que sea visible */
-  appearance: auto;
-  -webkit-appearance: auto;
-  -moz-appearance: auto;
+  -webkit-appearance: none;
+  -moz-appearance: none;
+  appearance: none;
+  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='24' height='24' viewBox='0 0 24 24'%3E%3Cpath fill='%23333' d='M7 10l5 5 5-5z'/%3E%3C/svg%3E");
+  background-repeat: no-repeat;
+  background-position: right var(--kds-spacing-1) center;
+  background-size: 20px;
+  padding-right: var(--kds-spacing-4) !important;
 }
 
 /* ==========================================
@@ -2325,6 +2569,71 @@ body.dark {
     display: inline-flex;
 }
 
+/* ========================================
+   Radix Tooltip (.kds-tooltip)
+   Espejo de `.tooltip` pero para popovers de Radix:
+   bg oscuro, texto blanco, sombra + animación fade/slide direccional.
+   ======================================== */
+
+.kds-tooltip {
+    background-color: var(--kds-color-text-primary);
+    color: var(--kds-color-background-paper);
+    font-family: var(--kds-font-family-primary);
+    font-size: var(--kds-font-size-xs);
+    font-weight: var(--kds-font-weight-medium);
+    line-height: var(--kds-line-height-normal);
+    border-radius: var(--kds-radius-sm);
+    padding: var(--kds-spacing-0-75) var(--kds-spacing-1-5);
+    box-shadow: var(--kds-shadow-4);
+    max-width: 280px;
+    z-index: var(--kds-z-index-tooltip, 1500);
+    user-select: none;
+    /* Animación direccional según Radix data-side — coordinada con copy-row
+       (cubic-bezier 0.2, 0.8, 0.2, 1) para un feel consistente del DS. */
+    animation-duration: 240ms;
+    animation-timing-function: cubic-bezier(0.2, 0.8, 0.2, 1);
+    will-change: transform, opacity;
+}
+
+.kds-tooltip[data-state='closed'] {
+    animation-duration: 140ms;
+    animation-timing-function: cubic-bezier(0.4, 0, 0.6, 1);
+}
+
+/* Direccional según data-side (Radix añade el attr en runtime).
+   Cada lado entra desde su dirección con ~8px de offset (más visible que 4px). */
+.kds-tooltip[data-side='top'][data-state='delayed-open'],
+.kds-tooltip[data-side='top'][data-state='instant-open']    { animation-name: kds-tooltip-in-top; }
+.kds-tooltip[data-side='bottom'][data-state='delayed-open'],
+.kds-tooltip[data-side='bottom'][data-state='instant-open'] { animation-name: kds-tooltip-in-bottom; }
+.kds-tooltip[data-side='left'][data-state='delayed-open'],
+.kds-tooltip[data-side='left'][data-state='instant-open']   { animation-name: kds-tooltip-in-left; }
+.kds-tooltip[data-side='right'][data-state='delayed-open'],
+.kds-tooltip[data-side='right'][data-state='instant-open']  { animation-name: kds-tooltip-in-right; }
+
+/* Fallback cuando no hay data-side resuelto aún */
+.kds-tooltip[data-state='delayed-open']:not([data-side]),
+.kds-tooltip[data-state='instant-open']:not([data-side]) {
+    animation-name: kds-tooltip-in-top;
+}
+
+.kds-tooltip[data-state='closed'] { animation-name: kds-tooltip-out; }
+
+@keyframes kds-tooltip-in-top    { from { opacity: 0; transform: translateY(8px)  scale(0.96); } to { opacity: 1; transform: none; } }
+@keyframes kds-tooltip-in-bottom { from { opacity: 0; transform: translateY(-8px) scale(0.96); } to { opacity: 1; transform: none; } }
+@keyframes kds-tooltip-in-left   { from { opacity: 0; transform: translateX(8px)  scale(0.96); } to { opacity: 1; transform: none; } }
+@keyframes kds-tooltip-in-right  { from { opacity: 0; transform: translateX(-8px) scale(0.96); } to { opacity: 1; transform: none; } }
+
+@keyframes kds-tooltip-out {
+    from { opacity: 1; transform: none; }
+    to   { opacity: 0; transform: scale(0.96); }
+}
+
+/* Arrow (SVG path generado por Radix) */
+.kds-tooltip-arrow {
+    fill: var(--kds-color-text-primary);
+}
+
 /* ========================================
    Material Symbols Icon Sizing
    ======================================== */
@@ -2741,7 +3050,8 @@ dialog.modal .field.border:focus-within {
         padding: var(--kds-spacing-2);
     }
 
-    .snackbar {
+    .snackbar,
+    .snackbar.active {
         min-width: calc(100% - 32px);
         left: 16px;
         right: 16px;
@@ -3040,6 +3350,32 @@ footer > .kds-container-center {
     color: var(--kds-color-error-dark);
 }
 
+/* Close button — icon-only, discreto, no usa kds-btn para no romper el flex layout del alert */
+.kds-alert-close {
+    flex-shrink: 0;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: 28px;
+    height: 28px;
+    padding: 0;
+    background: transparent;
+    border: 0;
+    border-radius: 50%;
+    color: inherit;
+    cursor: pointer;
+    transition: background-color 0.15s ease;
+}
+
+.kds-alert-close:hover {
+    background: rgba(0, 0, 0, 0.06);
+}
+
+.kds-alert-close i {
+    font-size: 18px;
+    line-height: 1;
+}
+
 /* Lists inside alerts */
 .kds-alert ul {
     padding-left: var(--kds-spacing-2);
@@ -4036,6 +4372,14 @@ dialog#surveyModal button.circle {
     text-align: center;
 }
 
+.kds-text-left {
+    text-align: left;
+}
+
+.kds-text-right {
+    text-align: right;
+}
+
 .kds-text-underline {
     text-decoration: underline;
 }
@@ -4052,6 +4396,54 @@ dialog#surveyModal button.circle {
     font-size: var(--kds-font-size-sm);
 }
 
+/* ── Font-size scale utilities (additive — opt-in companions to .kds-text-sm) ── */
+.kds-text-base {
+    font-size: var(--kds-font-size-base);
+}
+
+.kds-text-lg {
+    font-size: var(--kds-font-size-lg);
+}
+
+.kds-text-xl {
+    font-size: var(--kds-font-size-xl);
+}
+
+.kds-text-2xl {
+    font-size: var(--kds-font-size-2xl);
+}
+
+/* ── Font-weight utilities ── */
+.kds-fw-regular {
+    font-weight: var(--kds-font-weight-regular);
+}
+
+.kds-fw-medium {
+    font-weight: var(--kds-font-weight-medium);
+}
+
+.kds-fw-semibold {
+    font-weight: var(--kds-font-weight-semibold);
+}
+
+.kds-fw-bold {
+    font-weight: var(--kds-font-weight-bold);
+}
+
+/* ── Text-transform utilities ── */
+.kds-text-transform-none {
+    text-transform: none;
+}
+
+/* ── Soft background utilities (semantic muted backgrounds for callouts) ── */
+.kds-bg-warning-soft {
+    background-color: var(--kds-color-warning-soft);
+}
+
+.kds-bg-info-soft {
+    background-color: var(--kds-color-info-soft);
+}
+
 /* ── Typography variants ── */
 .kds-text-display1 {
     font-family: var(--kds-font-family-primary, 'Public Sans', sans-serif);
@@ -4262,7 +4654,9 @@ dialog#surveyModal button.circle {
    ======================================== */
 
 .kds-badge {
-    display: inline-block;
+    display: inline-flex;
+    align-items: center;
+    gap: 4px;
     padding: 2px 8px;
     border-radius: var(--kds-radius-sm);
     font-size: var(--kds-font-size-xs);
@@ -4270,6 +4664,40 @@ dialog#surveyModal button.circle {
     line-height: 1.5;
 }
 
+/* Icon prefix inside chip — small inline icon */
+.kds-badge > i.material-symbols-outlined {
+    font-size: 14px;
+    line-height: 1;
+}
+
+/* Deletable chip close button — discreto, sin kds-btn (eso lo agrandaba ridículo) */
+.kds-badge-close {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: 16px;
+    height: 16px;
+    margin-right: -2px;
+    padding: 0;
+    background: transparent;
+    border: 0;
+    border-radius: 50%;
+    color: inherit;
+    cursor: pointer;
+    opacity: 0.7;
+    transition: opacity 0.15s, background-color 0.15s;
+}
+
+.kds-badge-close:hover {
+    opacity: 1;
+    background: rgba(0, 0, 0, 0.1);
+}
+
+.kds-badge-close i {
+    font-size: 14px;
+    line-height: 1;
+}
+
 .kds-badge.success {
     background-color: var(--kds-color-success-container);
     color: var(--kds-color-success-dark);
@@ -4548,6 +4976,11 @@ dialog#surveyModal button.circle {
     color: var(--kds-color-text-primary);
 }
 
+/* Opt-in color modifier — switches the value to the LigoPay/khipu-blue tone */
+.kds-amount-value--info {
+    color: var(--kds-color-info-blue);  /* #5A5FE0 */
+}
+
 .kds-amount-value small {
     font-size: 18px;
     font-weight: 500;
@@ -4905,7 +5338,7 @@ dialog#surveyModal button.circle {
     display: flex;
     align-items: center;
     justify-content: center;
-    gap: var(--kds-spacing-1);
+    gap: var(--kds-spacing-0-5);
     color: var(--kds-color-gray-400);
     font-size: var(--kds-font-size-xs);
     letter-spacing: var(--kds-letter-spacing-wide);
@@ -4917,6 +5350,10 @@ dialog#surveyModal button.circle {
     display: none;
 }
 
+.kds-screen > form {
+    margin-block-start: 0 !important;
+}
+
 @media (max-width: 767px) {
     .kds-card-elevated > .kds-secure-footer {
         display: flex;
@@ -4966,14 +5403,20 @@ dialog#surveyModal button.circle {
     cursor: pointer;
     display: inline-flex;
     align-items: center;
-    gap: var(--kds-spacing-0-75);
+    gap: 0;
 }
 
-.kds-expand-toggle:hover {
+.kds-expand-toggle:hover,
+.kds-expand-toggle:focus,
+.kds-expand-toggle:active {
     background: transparent;
+    outline: none;
+    box-shadow: none;
 }
 
-.kds-expand-toggle:hover span {
+.kds-expand-toggle:hover span,
+.kds-expand-toggle:focus span,
+.kds-expand-toggle:active span {
     text-decoration: underline;
 }
 
@@ -5153,11 +5596,11 @@ dialog#surveyModal button.circle {
     color: var(--kds-color-success-main);
 }
 
-/* Variant: pending (animated spinner) */
+/* Variant: pending (animated blue spinner, sin icono interno) */
 .kds-status-block[data-status="pending"] .kds-status-block-icon {
     background: transparent;
     border: 3px solid var(--kds-color-divider);
-    border-top-color: var(--kds-color-primary-main);
+    border-top-color: var(--kds-color-info-main);
     animation: kds-spin 1s linear infinite;
 }
 
@@ -5175,12 +5618,21 @@ dialog#surveyModal button.circle {
     color: var(--kds-color-error-main);
 }
 
+/* Variant: info — usar SIEMPRE con icon "info_i" (i minúscula sin glyph circular)
+   para que solo se vea nuestro círculo decorativo. Iconos como "info" tienen
+   su propio círculo built-in → causarían doble círculo. */
+.kds-status-block[data-status="info"] .kds-status-block-icon {
+    background: var(--kds-color-info-soft);
+    border: var(--kds-border-width-md) solid var(--kds-color-info-main);
+    color: var(--kds-color-info-main);
+}
+
 /* Inline variant: icon left + text right */
 .kds-status-block.inline {
     text-align: left;
     display: flex;
     align-items: center;
-    gap: var(--kds-spacing-3);
+    gap: var(--kds-spacing-2);
     padding: var(--kds-spacing-1) 0;
 }
 
@@ -5242,6 +5694,40 @@ dialog#surveyModal button.circle {
     background: var(--kds-color-divider);
 }
 
+/* Close button — top-right discreto, NO usa kds-btn (rompía el flex layout) */
+.kds-bottom-sheet-close {
+    position: absolute;
+    top: var(--kds-spacing-1);
+    right: var(--kds-spacing-1);
+    width: 32px;
+    height: 32px;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    padding: 0;
+    background: transparent;
+    border: 0;
+    border-radius: 50%;
+    color: var(--kds-color-text-secondary);
+    cursor: pointer;
+    transition: background-color 0.15s ease;
+}
+
+.kds-bottom-sheet-close:hover {
+    background: rgba(0, 0, 0, 0.06);
+}
+
+.kds-bottom-sheet-close i {
+    font-size: 20px;
+    line-height: 1;
+}
+
+/* Body container — separa el content del title/actions */
+.kds-bottom-sheet-body {
+    text-align: left;
+    margin-top: var(--kds-spacing-1);
+}
+
 .kds-bottom-sheet-icon {
     font-size: var(--kds-font-size-4xl);
 }
@@ -5571,6 +6057,13 @@ div.kds-invoice-header,
     align-content: initial;
 }
 
+/* Mobile collapsed state: center-align so merchant tile aligns with the smaller amount */
+@media (max-width: 767px) {
+    .kds-invoice-sticky.is-collapsed .kds-invoice-header {
+        align-items: center;
+    }
+}
+
 /* Reset BeerCSS sibling margin on <p> inside invoice header — specificity (0,4,1) ties BeerCSS, wins by source order */
 .kds-card-elevated.kds-invoice-sticky .kds-invoice-header p.kds-invoice-amount,
 .kds-card-elevated.kds-invoice-sticky .kds-invoice-header p.kds-invoice-code {
@@ -5578,7 +6071,7 @@ div.kds-invoice-header,
 }
 
 .kds-invoice-amount {
-    font-weight: var(--kds-font-weight-bold);
+    font-weight: var(--kds-font-weight-semibold);
     font-size: var(--kds-font-size-3xl);
     line-height: var(--kds-line-height-tight);
     letter-spacing: var(--kds-letter-spacing-wide);
@@ -5599,10 +6092,16 @@ div.kds-invoice-header,
     color: var(--kds-color-gray-400);
     text-transform: uppercase;
     margin: 0;
-    margin-top: var(--kds-spacing-1);
+    margin-block: unset;
+    display: flex;
+    gap: var(--kds-spacing-1-5);
 }
 
 .kds-invoice-code-value {
+    color: var(--kds-color-gray-400);
+}
+
+.kds-invoice-code-value--lowercase {
     text-transform: lowercase;
 }
 
@@ -5615,6 +6114,9 @@ div.kds-invoice-header,
     place-items: center;
     color: #fff;
     flex-shrink: 0;
+    /* Clip the slightly-oversized logo (see `.kds-invoice-merchant img`) to the
+       rounded square so it can fully cover the deep-purple background. */
+    overflow: hidden;
 }
 
 .kds-invoice-merchant i {
@@ -5634,15 +6136,18 @@ div.kds-invoice-header,
 }
 
 .kds-invoice-merchant img {
-    width: 100%;
-    height: 100%;
+    /* Slightly larger than the container (+2px, centered by the grid) so the
+       logo overflows under the parent's rounded clip and the deep-purple
+       background never peeks through at the corners when the logo shrinks. */
+    width: calc(100% + 2px);
+    height: calc(100% + 2px);
     object-fit: cover;
     border-radius: var(--kds-radius-md);
 }
 
 /* -- Card Title -- */
 .kds-card-title {
-    font-weight: 700;
+    font-weight: var(--kds-font-weight-semibold);
     font-size: var(--kds-font-size-base);
     line-height: 1.5;
     letter-spacing: -0.31px;
@@ -5650,12 +6155,22 @@ div.kds-invoice-header,
     margin-bottom: var(--kds-spacing-2) !important;
 }
 
+/* Opt-in size modifiers (additive — do NOT change default 16/600) */
+.kds-card-title--lg {
+    font-size: var(--kds-font-size-xl);       /* 20px */
+    font-weight: var(--kds-font-weight-semibold);
+}
+
+.kds-card-title--xl {
+    font-size: var(--kds-font-size-2xl);      /* 24px */
+    font-weight: var(--kds-font-weight-semibold);
+}
+
 /* -- Key-Value Grid -- */
 .kds-kv {
     display: grid;
     grid-template-columns: auto 1fr;
-    row-gap: var(--kds-spacing-1);
-    column-gap: var(--kds-spacing-1-5);
+    column-gap: var(--kds-spacing-1);
     align-items: baseline;
 }
 
@@ -5672,7 +6187,7 @@ div.kds-invoice-header,
     margin: 0;
     font-size: var(--kds-font-size-sm);
     line-height: var(--kds-line-height-relaxed);
-    font-weight: var(--kds-font-weight-bold);
+    font-weight: var(--kds-font-weight-semibold);
     letter-spacing: normal;
     color: var(--kds-color-gray-800);
     min-width: 0;
@@ -5702,7 +6217,13 @@ div.kds-invoice-header,
     flex-direction: column;
     gap: var(--kds-spacing-1-5);
     margin: 0;
-    padding: 0 0 var(--kds-spacing-1);
+    padding: 0;
+}
+
+@media (max-width: 767px) {
+    .kds-detail-list {
+        padding-bottom: var(--kds-spacing-2);
+    }
 }
 
 .kds-detail-group {
@@ -5718,7 +6239,6 @@ div.kds-invoice-header,
     letter-spacing: var(--kds-letter-spacing-wide);
     color: var(--kds-color-text-hint);
     text-transform: uppercase;
-    margin: 0 0 var(--kds-spacing-0-5);
 }
 
 .kds-detail-group dd {
@@ -5787,16 +6307,16 @@ div.kds-invoice-header,
     font-size: var(--kds-font-size-sm);
 }
 
-.kds-recap-list .k {
+.kds-recap-list .kds-key {
     color: var(--kds-color-text-secondary);
 }
 
-.kds-recap-list .v {
+.kds-recap-list .kds-value {
     color: var(--kds-color-text-primary);
     font-weight: 500;
 }
 
-.kds-recap-list .v.placeholder {
+.kds-recap-list .kds-value.placeholder {
     color: var(--kds-color-text-hint);
 }
 
@@ -5823,6 +6343,72 @@ a.kds-btn-success:disabled {
     box-shadow: none;
 }
 
+/* -- Button Warning (amber CTA) -- */
+button.kds-btn-warning,
+a.kds-btn-warning {
+    background: var(--kds-color-warning-main);
+    color: var(--kds-color-warning-contrast);
+    border: none;
+}
+
+button.kds-btn-warning:hover:not(:disabled),
+a.kds-btn-warning:hover:not(:disabled) {
+    background: var(--kds-color-warning-dark);
+}
+
+button.kds-btn-warning:active:not(:disabled),
+button.kds-btn-warning:focus-visible:not(:disabled),
+a.kds-btn-warning:active:not(:disabled),
+a.kds-btn-warning:focus-visible:not(:disabled) {
+    background: var(--kds-color-warning-dark);
+    outline: 2px solid var(--kds-color-warning-main);
+    outline-offset: 2px;
+}
+
+button.kds-btn-warning:disabled,
+a.kds-btn-warning:disabled {
+    background-color: var(--kds-color-action-disabled-bg);
+    color: var(--kds-color-action-disabled);
+    box-shadow: none;
+}
+
+button.kds-btn-warning::after {
+    display: none;
+}
+
+/* -- Button Error (red / destructive CTA) -- */
+button.kds-btn-error,
+a.kds-btn-error {
+    background: var(--kds-color-error-main);
+    color: var(--kds-color-error-contrast);
+    border: none;
+}
+
+button.kds-btn-error:hover:not(:disabled),
+a.kds-btn-error:hover:not(:disabled) {
+    background: var(--kds-color-error-dark);
+}
+
+button.kds-btn-error:active:not(:disabled),
+button.kds-btn-error:focus-visible:not(:disabled),
+a.kds-btn-error:active:not(:disabled),
+a.kds-btn-error:focus-visible:not(:disabled) {
+    background: var(--kds-color-error-dark);
+    outline: 2px solid var(--kds-color-error-main);
+    outline-offset: 2px;
+}
+
+button.kds-btn-error:disabled,
+a.kds-btn-error:disabled {
+    background-color: var(--kds-color-action-disabled-bg);
+    color: var(--kds-color-action-disabled);
+    box-shadow: none;
+}
+
+button.kds-btn-error::after {
+    display: none;
+}
+
 /* -- Field Helper Text -- */
 .kds-field-helper {
     font-size: var(--kds-font-size-xs);
@@ -5865,6 +6451,8 @@ button.kds-btn-success::after {
 /* -- Alert inline (borderless, used inside cards) -- */
 .kds-alert-inline {
     border: none;
+    padding: var(--kds-spacing-1) var(--kds-spacing-1-5);
+    margin-bottom: var(--kds-spacing-1-5);
 }
 
 /* -- Card dimmed (behind overlays) -- */
@@ -5966,17 +6554,42 @@ button.kds-btn-success::after {
 }
 
 .kds-bill-description-picture {
-    width: 120px;
-    height: 120px;
+    max-width: 100px;
     object-fit: contain;
     background: var(--kds-color-background-paper);
-    padding: var(--kds-spacing-1-25);
-    border-radius: var(--kds-radius-md);
-    margin-top: var(--kds-spacing-1);
+    margin-top: var(--kds-spacing-1-25);
     display: block;
     box-sizing: content-box;
 }
 
+/* -- Bill Attachments -- */
+.kds-bill-attachments {
+    display: flex;
+    flex-direction: column;
+    gap: var(--kds-spacing-0-75);
+}
+
+.kds-bill-attachment {
+    display: inline-flex;
+    align-items: center;
+    justify-content: flex-start;
+    width: fit-content;
+    color: var(--kds-color-info-main);
+    font-size: var(--kds-font-size-sm);
+    font-weight: var(--kds-font-weight-medium);
+    text-decoration: none;
+}
+
+.kds-bill-attachment:hover span {
+    text-decoration: underline;
+}
+
+.kds-bill-attachment i {
+    font-size: var(--kds-font-size-lg);
+    min-width: unset;
+    justify-content: flex-start;
+}
+
 /* -- Share Card (mustContinue) -- */
 .kds-share-card {
     margin-top: var(--kds-spacing-2);
@@ -6089,6 +6702,14 @@ button.kds-btn-success::after {
     padding-top: 0;
     padding-bottom: 0;
 }
+
+/* Reset BeerCSS sibling margin on form/section inside payment cards.
+   BeerCSS sets `:not(.grid,nav,.row) > … + form/section { margin-block-start:1rem }`
+   which adds unwanted spacing inside cards that contain forms. */
+.kds-payment-flow .kds-card-elevated > form,
+.kds-payment-flow .kds-card-elevated > section {
+    margin-block-start: 0;
+}
 .kds-payment-flow .kds-card-elevated.kds-invoice-sticky {
     padding-top: var(--kds-spacing-1);
     padding-bottom: 0;
@@ -6138,10 +6759,17 @@ button.kds-btn-success::after {
         padding-bottom: var(--kds-spacing-2);
     }
 
-    /* Invoice sticky card: progressive padding-top (expanded 20px → collapsed 8px).
-       Overrides base rule at same specificity; source order wins here. */
+    /* Invoice sticky card padding (mobile).
+       Top: estático 12px. Bottom: progresivo 20px (expandido) → 8px (colapsado).
+       El padding-bottom animado da breathing room natural cuando expandido y se
+       reduce convencionalmente al colapsar — sin depender de que el clip-path
+       corte el padding abruptamente. */
     .kds-payment-flow .kds-card-elevated.kds-invoice-sticky {
         padding-top: var(--kds-spacing-1-5);
+        padding-bottom: calc(
+            var(--kds-spacing-2-5)
+            - var(--kds-spacing-1-5) * var(--collapse-progress, 0)
+        );
     }
 
 
@@ -6180,7 +6808,8 @@ button.kds-btn-success::after {
 }
 .kds-brand-inner svg,
 .kds-brand-inner img {
-    height: 22px;
+    width: calc(50px - 16px * var(--collapse-progress, 0));
+    height: auto;
     display: block;
 }
 
@@ -6399,7 +7028,7 @@ button.kds-btn-success::after {
     inset: 0;
     background: var(--kds-modal-backdrop);
     display: none;
-    align-items: center;
+    align-items: flex-start;
     justify-content: center;
     z-index: var(--kds-z-index-modal, 50);
     animation: kds-fade 0.2s ease both;
@@ -6427,7 +7056,7 @@ button.kds-btn-success::after {
     display: flex;
     align-items: center;
     justify-content: space-between;
-    padding: var(--kds-spacing-2) var(--kds-spacing-2) var(--kds-spacing-1);
+    padding: var(--kds-spacing-1) var(--kds-spacing-2) var(--kds-spacing-1);
 }
 
 .kds-bank-modal-header h3 {
@@ -6574,7 +7203,7 @@ button.kds-btn-success::after {
     min-width: 0;
 }
 
-.kds-qr-text .title {
+.kds-qr-text .kds-qr-title {
     font-family: var(--kds-font-family-primary);
     font-weight: 600;
     font-size: var(--kds-font-size-sm);
@@ -6582,10 +7211,15 @@ button.kds-btn-success::after {
     color: var(--kds-color-text-primary);
 }
 
-.kds-qr-text .sub {
+.kds-qr-text .kds-qr-subtitle {
     font-family: var(--kds-font-family-primary);
     font-size: var(--kds-font-size-caption);
     color: var(--kds-color-text-secondary);
+    /* Trunca con ellipsis en lugar de wrap a 2 líneas — evita apretar el row
+       cuando el contenedor es angosto (mobile o decorator constrained). */
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
 }
 
 /* QR Badge - "Rápido" indicator */
@@ -6608,46 +7242,26 @@ button.kds-btn-success::after {
     font-size: 20px;
 }
 
-/* Mobile responsive: Ajustes para pantallas pequeñas */
+/* Mobile responsive (≤480px): respira más — mantenemos padding/gap/avatar igual
+   que desktop y solo agregamos truncation al subtitle y `flex-shrink: 0` en los
+   ítems que deben mantener su tamaño (avatar, badge, chevron). */
 @media (max-width: 480px) {
-    .kds-qr-row {
-        gap: var(--kds-spacing-1-5);
-        padding: var(--kds-spacing-1-5);
-    }
-
     .kds-qr-avatar {
-        width: var(--kds-spacing-4-5);
-        height: var(--kds-spacing-4-5);
         flex-shrink: 0;
     }
 
-    .kds-qr-avatar .material-symbols-outlined,
-    .kds-qr-avatar .material-icons-round {
-        font-size: var(--kds-font-size-lg);
-    }
-
-    .kds-qr-text .title {
-        font-size: var(--kds-font-size-xs);
-        line-height: var(--kds-line-height-tight);
-    }
-
     .kds-qr-text .sub {
-        font-size: var(--kds-font-size-caption);
-        line-height: var(--kds-line-height-tight);
         overflow: hidden;
         text-overflow: ellipsis;
         white-space: nowrap;
     }
 
     .kds-qr-badge {
-        font-size: var(--kds-font-size-caption);
-        padding: var(--kds-spacing-0-25) var(--kds-spacing-0-75);
         flex-shrink: 0;
     }
 
     .kds-qr-row .material-symbols-outlined:last-child,
     .kds-qr-row .material-icons-round:last-child {
-        font-size: var(--kds-font-size-base);
         flex-shrink: 0;
     }
 }
@@ -6676,7 +7290,11 @@ button.kds-btn-success::after {
     border-radius: var(--kds-spacing-0-75);
     font-size: var(--kds-font-size-sm);
     cursor: pointer;
-    transition: background 0.12s ease;
+    /* Transición más amplia y suave: bg + color + border ease-out */
+    transition:
+        background-color 280ms cubic-bezier(0.2, 0.8, 0.2, 1),
+        color 280ms cubic-bezier(0.2, 0.8, 0.2, 1),
+        border-top-color 280ms ease-out;
     position: relative;
     user-select: none;
 }
@@ -6685,19 +7303,21 @@ button.kds-btn-success::after {
     border-top: 0;
 }
 
-.kds-copyable-table-row:hover {
+/* Hover NO aplica mientras la row esté en `.copied` o `.settling`
+   (evita el flicker del hover state al desaparecer el verde de "copiado") */
+.kds-copyable-table-row:not(.copied):not(.settling):hover {
     background: var(--kds-color-primary-faint);
 }
 
-.kds-copyable-table-row:hover + .kds-copyable-table-row {
+.kds-copyable-table-row:not(.copied):not(.settling):hover + .kds-copyable-table-row {
     border-top-color: transparent;
 }
 
-.kds-copyable-table-row:active {
+.kds-copyable-table-row:not(.copied):not(.settling):active {
     background: var(--kds-color-primary-selected);
 }
 
-.kds-copyable-table-row .k {
+.kds-copyable-table-row .kds-key {
     color: var(--kds-color-text-secondary);
     font-size: var(--kds-font-size-caption);
     letter-spacing: 0.3px;
@@ -6706,7 +7326,7 @@ button.kds-btn-success::after {
     flex: 0 0 auto;
 }
 
-.kds-copyable-table-row .v {
+.kds-copyable-table-row .kds-value {
     color: var(--kds-color-text-primary);
     font-family: 'JetBrains Mono', 'SF Mono', ui-monospace, Menlo, Consolas, monospace;
     font-weight: var(--kds-font-weight-medium);
@@ -6722,17 +7342,18 @@ button.kds-btn-success::after {
     flex: 1 1 auto;
 }
 
-.kds-copyable-table-row .v::after {
+.kds-copyable-table-row .kds-value::after {
     content: 'content_copy';
     font-family: 'Material Symbols Outlined';
     font-size: var(--kds-font-size-sm);
     color: var(--kds-color-primary-main);
     opacity: 0;
-    transition: opacity 0.12s ease;
+    /* Transición coordinada con la row */
+    transition: opacity 280ms cubic-bezier(0.2, 0.8, 0.2, 1);
     flex: 0 0 auto;
 }
 
-.kds-copyable-table-row:hover .v::after {
+.kds-copyable-table-row:not(.copied):not(.settling):hover .kds-value::after {
     opacity: 0.7;
 }
 
@@ -6740,17 +7361,25 @@ button.kds-btn-success::after {
     background: var(--kds-color-success-soft);
 }
 
-.kds-copyable-table-row.copied .v {
+.kds-copyable-table-row.copied .kds-value {
     color: var(--kds-color-success-dark);
 }
 
-.kds-copyable-table-row.copied .v::after {
+.kds-copyable-table-row.copied .kds-value::after {
     content: 'check';
     font-family: 'Material Symbols Outlined';
     color: var(--kds-color-success-dark);
     opacity: 1;
 }
 
+/* `.settling`: estado de "recién copiado" — la row vuelve al normal sin
+   activar hover. Dura lo mismo que la transición (~300ms) y se aplica
+   desde React tras quitar `.copied`. */
+.kds-copyable-table-row.settling .kds-value::after {
+    /* Mantén el check con opacity 0 mientras settling, fade out suave */
+    opacity: 0;
+}
+
 /* Disable BeerCSS ripple on copyable table rows */
 .kds-copyable-table-row::after {
     display: none;
@@ -6813,6 +7442,14 @@ a.kds-copy-all-btn.copied:hover {
     min-height: unset;
 }
 
+/* Severity variants — default stays warning (backward-compatible) */
+.kds-section-note.kds-info          { color: var(--kds-color-info-dark); }
+.kds-section-note.kds-info > i      { color: var(--kds-color-info-dark); }
+.kds-section-note.kds-success       { color: var(--kds-color-success-dark); }
+.kds-section-note.kds-success > i   { color: var(--kds-color-success-dark); }
+.kds-section-note.kds-error         { color: var(--kds-color-error-dark); }
+.kds-section-note.kds-error > i     { color: var(--kds-color-error-dark); }
+
 /* ========================================
    INFO TOOLTIP (.kds-info-tip)
    Inline info button with hover/click tooltip bubble.
@@ -6908,7 +7545,7 @@ a.kds-copy-all-btn.copied:hover {
 .kds-monto-row {
     display: flex;
     justify-content: space-between;
-    align-items: flex-end;
+    align-items: flex-start;
     padding: var(--kds-spacing-1-75) 0 var(--kds-spacing-1);
     border-top: 1px dashed var(--kds-color-divider);
     margin-top: var(--kds-spacing-1-75);
@@ -6932,3 +7569,191 @@ a.kds-copy-all-btn.copied:hover {
     color: var(--kds-color-text-primary);
 }
 
+/* ========================================
+   PAYMENT TOTAL (.kds-payment-total)
+   Bloque "monto a pagar" para QR view y email templates.
+   Portado desde paylink-ligopay → <kh:paymentTotal> + materialize-config.css.
+   Variantes:
+     - default: amount grande (3rem) en color primario Khipu.
+     - email:   amount compacto (1.5rem) en color texto primario.
+   Responsive (default): mobile (≤ 1024px) centra y oculta titleMobile.
+   ======================================== */
+
+.kds-payment-total {
+    /* Component-scoped tokens — overrideables sin tocar el CSS global. */
+    --kds-payment-total-title-size: var(--kds-font-size-2xl);    /* 24px */
+    --kds-payment-total-label-size: var(--kds-font-size-xl);     /* 20px */
+    --kds-payment-amount-size: 3rem;                              /* 48px — destacado */
+    --kds-payment-amount-line-height: var(--kds-line-height-snug);
+    --kds-payment-amount-color: var(--kds-color-primary-main);
+    --kds-payment-amount-weight: var(--kds-font-weight-medium);
+
+    text-align: left;
+}
+
+.kds-payment-total-title,
+.kds-payment-total-title-mobile {
+    font-size: var(--kds-payment-total-title-size);
+    font-weight: var(--kds-font-weight-semibold);
+    color: var(--kds-color-text-primary);
+    margin-bottom: var(--kds-spacing-4);
+}
+
+.kds-payment-total-title-mobile {
+    display: none;
+}
+
+.kds-payment-total .kds-payment-label {
+    font-size: var(--kds-payment-total-label-size);
+    font-weight: var(--kds-font-weight-semibold);
+    color: var(--kds-color-text-primary);
+    margin-bottom: var(--kds-spacing-1);
+    padding-top: 0;
+}
+
+.kds-payment-total .kds-payment-amount {
+    font-size: var(--kds-payment-amount-size);
+    font-weight: var(--kds-payment-amount-weight);
+    line-height: var(--kds-payment-amount-line-height);
+    color: var(--kds-payment-amount-color);
+    margin-bottom: var(--kds-spacing-4);
+}
+
+.kds-payment-total .kds-payment-amount .kds-payment-total-decimal-sup,
+.kds-invoice-amount .kds-payment-total-decimal-sup {
+    font-size: var(--kds-font-size-decimal-sup);
+    font-weight: var(--kds-font-weight-semibold);
+    position: relative;
+    top: 0;
+}
+
+/* Variante email: amount compacto en color texto primario, alineación izquierda fija */
+.kds-payment-total--email {
+    --kds-payment-amount-size: var(--kds-font-size-2xl);  /* 24px */
+    --kds-payment-amount-line-height: var(--kds-line-height-snug);
+    --kds-payment-amount-color: var(--kds-color-text-primary);
+    --kds-payment-amount-weight: var(--kds-font-weight-semibold);
+}
+
+/* Tone modifier: swaps the amount color to the khipu-blue / LigoPay info blue.
+   Combinable with --email or with the default variant. */
+.kds-payment-total--tone-info {
+    --kds-payment-amount-color: var(--kds-color-info-blue);  /* #5A5FE0 */
+}
+
+/* Centered modifier: removes the asymmetric desktop padding (which exists for
+   LigoPay QR view) and centers all internal text. Composable with --email and
+   --tone-info. */
+.kds-payment-total--centered {
+    padding-left: 0;
+    padding-top: 0;
+    text-align: center;
+}
+.kds-payment-total--centered .kds-payment-total-title,
+.kds-payment-total--centered .kds-payment-total-title-mobile,
+.kds-payment-total--centered .kds-payment-label,
+.kds-payment-total--centered .kds-payment-amount {
+    text-align: center;
+}
+
+/* Responsive: mobile ≤ 1024px — centra y conmuta los títulos (sólo variante default) */
+@media (max-width: 1024px) {
+    .kds-payment-total {
+        text-align: center;
+    }
+
+    .kds-payment-total .kds-payment-total-title {
+        display: none;
+    }
+
+    .kds-payment-total .kds-payment-total-title-mobile {
+        display: block;
+        text-align: center;
+    }
+
+    .kds-payment-total .kds-payment-label,
+    .kds-payment-total .kds-payment-amount {
+        text-align: center;
+    }
+
+    /* Email mantiene alineación izquierda incluso en mobile (matchea email clients) */
+    .kds-payment-total--email,
+    .kds-payment-total--email .kds-payment-label,
+    .kds-payment-total--email .kds-payment-amount {
+        text-align: left;
+    }
+}
+
+/* ==========================================================================
+   GRID UTILITIES — semantic aliases for BeerCSS .grid / .s* / .m* / .l*
+
+   Estas utilidades son ALIAS de las clases cortas de BeerCSS para que
+   consumers (payment, LigoPay, Grails legacy) puedan escribir markup con
+   nombres descriptivos sin renunciar al grid de 12 columnas de BeerCSS.
+
+   Convención (estilo Bootstrap responsive):
+   - kds-grid              → .grid (12-col CSS grid + 1rem gap)
+   - kds-col-sm-{1..12}    → .s{1..12}  (mobile, siempre aplica)
+   - kds-col-md-{1..12}    → .m{1..12}  (>=601px)
+   - kds-col-lg-{1..12}    → .l{1..12}  (>=993px)
+
+   Las definiciones originales de BeerCSS NO se tocan; estas son aditivas.
+   ========================================================================== */
+
+.kds-grid {
+    --_gap: 1rem;
+    display: grid;
+    grid-template-columns: repeat(12, 1fr);
+    gap: var(--_gap);
+    block-size: auto;
+}
+
+.kds-grid.kds-grid-no-space { --_gap: 0rem; }
+.kds-grid.kds-grid-medium-space { --_gap: 1.5rem; }
+.kds-grid.kds-grid-large-space { --_gap: 2rem; }
+
+.kds-grid > * { margin: 0; }
+
+.kds-col-sm-1  { grid-area: auto/span 1; }
+.kds-col-sm-2  { grid-area: auto/span 2; }
+.kds-col-sm-3  { grid-area: auto/span 3; }
+.kds-col-sm-4  { grid-area: auto/span 4; }
+.kds-col-sm-5  { grid-area: auto/span 5; }
+.kds-col-sm-6  { grid-area: auto/span 6; }
+.kds-col-sm-7  { grid-area: auto/span 7; }
+.kds-col-sm-8  { grid-area: auto/span 8; }
+.kds-col-sm-9  { grid-area: auto/span 9; }
+.kds-col-sm-10 { grid-area: auto/span 10; }
+.kds-col-sm-11 { grid-area: auto/span 11; }
+.kds-col-sm-12 { grid-area: auto/span 12; }
+
+@media only screen and (min-width: 601px) {
+    .kds-col-md-1  { grid-area: auto/span 1; }
+    .kds-col-md-2  { grid-area: auto/span 2; }
+    .kds-col-md-3  { grid-area: auto/span 3; }
+    .kds-col-md-4  { grid-area: auto/span 4; }
+    .kds-col-md-5  { grid-area: auto/span 5; }
+    .kds-col-md-6  { grid-area: auto/span 6; }
+    .kds-col-md-7  { grid-area: auto/span 7; }
+    .kds-col-md-8  { grid-area: auto/span 8; }
+    .kds-col-md-9  { grid-area: auto/span 9; }
+    .kds-col-md-10 { grid-area: auto/span 10; }
+    .kds-col-md-11 { grid-area: auto/span 11; }
+    .kds-col-md-12 { grid-area: auto/span 12; }
+}
+
+@media only screen and (min-width: 993px) {
+    .kds-col-lg-1  { grid-area: auto/span 1; }
+    .kds-col-lg-2  { grid-area: auto/span 2; }
+    .kds-col-lg-3  { grid-area: auto/span 3; }
+    .kds-col-lg-4  { grid-area: auto/span 4; }
+    .kds-col-lg-5  { grid-area: auto/span 5; }
+    .kds-col-lg-6  { grid-area: auto/span 6; }
+    .kds-col-lg-7  { grid-area: auto/span 7; }
+    .kds-col-lg-8  { grid-area: auto/span 8; }
+    .kds-col-lg-9  { grid-area: auto/span 9; }
+    .kds-col-lg-10 { grid-area: auto/span 10; }
+    .kds-col-lg-11 { grid-area: auto/span 11; }
+    .kds-col-lg-12 { grid-area: auto/span 12; }
+}
+