Saltar al contenido
Índice de Kit UI
Kit UI Componentes

Error y reintento.

Patrón canónico de error y reintento para usaia, scribe, periodismo2 admin y claudia.

Verlo por niveles

Primero el componente, después la variación de marca y finalmente su uso dentro de una página.

Nivel 1Componente canónico
Nivel 2Compañía de Innovación de Santiago · variación
Nivel 3Dentro de una página
Sitio · sección
Ver y copiar el código de este render
HTML del nivel canónico
<section class="ui-sample ui-feedback ui-state ui-state--error" data-retry-error="true" role="alert"><svg class="ui-state__icon" viewBox="0 0 24 24" aria-hidden="true"><circle cx="12" cy="12" r="9"></circle><path d="M12 7v6M12 17h.01"></path></svg><div><h3>No se completó la consulta</h3><p>La fuente tardó más de 30 segundos. No se ejecutó ninguna acción externa.</p><p><code>source_timeout</code></p><div class="ui-actions"><button class="btn btn--primary" type="button">Reintentar</button><button class="btn btn--secondary" type="button">Usar última copia</button></div></div></section>

Variaciones por marca y sitio

Cada cambio visible declara su autoridad; lo que permanece canónico no se vuelve a inventar en el producto.

usaia.cl

usaia

Autoridad: CANON.md + decisión de producto usaia

Cambia en esta marca

  • Namebrand usaia en minúsculas y acento morado
  • Superficies para evidencia, herramientas y aprobación

Permanece canónico

  • Acciones explícitas y estados conectados
  • Misma anatomía, tipografía y navegación
innovacionsantiago.cl

Compañía de Innovación de Santiago

Autoridad: CONSTITUTION.md + LOGOS-CANONICOS.md

Cambia en esta marca

  • Navegación y contenido propios del servicio
  • Acento reservado para acciones y datos

Permanece canónico

  • Mark CIS y namebrand de tres líneas
  • IBM Plex Sans, foco, espaciado y anatomía

Comparación histórica recuperable

Compara la propuesta con cortes reales del repositorio. La ausencia de una muestra se declara y nunca se reconstruye de memoria.

Estado actual
Error y reintento no tiene una implementación vigente demostrada; sus ejemplos son material candidato.
Cambio propuesto
Publicar en r19 el contrato de Error y reintento para Patrón canónico de error y reintento para usaia, scribe, periodismo2 admin y claudia.
Qué ocurre si respondes No
Error y reintento queda fuera de r19 y sus ejemplos siguen sólo como evidencia pendiente de reformulación.

Preparando comparación histórica…

Antes / r19

La comparación convierte una regla abstracta en una diferencia visible y verificable.

r19 · correctoContrato canónico renderizado
  • Separa propuesta, evidencia, herramientas y aprobación humana.
  • Muestra procedencia, impacto y estado de cada tarea.
Antes · problema observadoAnti-ejemplo no interactivo
ListoLa tarea fue realizada correctamenteSin evidencia, herramientas, impacto ni aprobación
  • No presentes razonamiento sintético como evidencia.
  • No ejecutes mutaciones externas desde un control ambiguo.

Responsive

La misma anatomía debe conservar lectura, foco y acciones sin cortar contenido ni crear scroll horizontal en la página.

320 pxMóvil y zoom
1280 pxEscritorio

Cobertura

DimensiónContrato
Propietario canónicoSistema de diseño CIS y usaia · core/core-style
Consumidoresusaia, Scribe, Periodismo2 Admin y Claudia
DependenciasAI Elements adaptado, contrato de evidencia
Estadocandidato

Evidencia de adopción

Patrón propuesto. 0 implementaciones observadas en 0 repositorios.

La observación demuestra uso existente; la aceptación canónica sigue dependiendo de esta ficha y de su propietario.

DatoResultado
ClasificaciónPatrón propuesto
Implementaciones0 implementaciones observadas
RepositoriosNingún repositorio observado
Snapshotkit/componentes/componentes-observados.json

Consumidores observados

El inventario conserva repositorio, archivo fuente y criterio de asociación. Observar una implementación no la convierte automáticamente en canónica.

Estados

Estado requerido
idle
en curso
requiere aprobación
completo
error

Accesibilidad

  • Conserva nombre accesible, orden de lectura y foco visible.
  • Funciona a 320 px, con zoom de 200% y texto largo.
  • El color nunca es la única señal de estado o acción.
  • El contenido esencial permanece disponible sin JavaScript.

Código HTML

Copia el bloque completo; después cambia contenido y destinos, no su anatomía.

Código de referencia
<section class="ui-sample ui-feedback ui-state ui-state--error" data-retry-error="true" role="alert"><svg class="ui-state__icon" viewBox="0 0 24 24" aria-hidden="true"><circle cx="12" cy="12" r="9"></circle><path d="M12 7v6M12 17h.01"></path></svg><div><h3>No se completó la consulta</h3><p>La fuente tardó más de 30 segundos. No se ejecutó ninguna acción externa.</p><p><code>source_timeout</code></p><div class="ui-actions"><button class="btn btn--primary" type="button">Reintentar</button><button class="btn btn--secondary" type="button">Usar última copia</button></div></div></section>

Código TAILWIND

Copia el bloque completo; después cambia contenido y destinos, no su anatomía.

Código de referencia
<section class="ui-sample ui-feedback ui-state ui-state--error border border-slate-300 bg-white p-4 text-slate-950 grid gap-3" data-retry-error="true" role="alert"><svg class="ui-state__icon h-auto w-full" viewBox="0 0 24 24" aria-hidden="true"><circle cx="12" cy="12" r="9"></circle><path d="M12 7v6M12 17h.01"></path></svg><div><h3>No se completó la consulta</h3><p>La fuente tardó más de 30 segundos. No se ejecutó ninguna acción externa.</p><p><code>source_timeout</code></p><div class="ui-actions"><button class="btn btn--primary border border-slate-950 px-3 py-2 focus-visible:outline-2 focus-visible:outline-offset-2 disabled:cursor-not-allowed" type="button">Reintentar</button><button class="btn btn--secondary border border-slate-950 px-3 py-2 focus-visible:outline-2 focus-visible:outline-offset-2 disabled:cursor-not-allowed" type="button">Usar última copia</button></div></div></section>

Código REACT

Copia el bloque completo; después cambia contenido y destinos, no su anatomía.

Código de referencia
import type { MouseEventHandler } from "react";

export interface RetryErrorProps {
  /** Qué no se completó («No se completó la consulta»); vacío lo oculta. */
  title?: string;
  /** Código técnico del error, tal como lo entrega el sistema (`source_timeout`); vacío lo oculta. */
  code?: string;
  /** Causa del error y si se ejecutó alguna acción externa; vacío lo oculta. */
  description?: string;
  /** Texto del botón que repite la operación; vacío lo oculta. */
  retryLabel?: string;
  onRetry?: MouseEventHandler<HTMLButtonElement>;
  /** Texto del botón que usa un resultado alternativo, como la última copia guardada; vacío lo oculta. */
  fallbackLabel?: string;
  onFallback?: MouseEventHandler<HTMLButtonElement>;
  className?: string;
}

/**
 * Error de una operación de un asistente o agente de IA, con su código, la causa, si hubo acciones externas y los botones para reintentar o usar un resultado alternativo; se muestra cuando una consulta o acción falla y se puede repetir.
 *
 * Usa `role="alert"` y la misma estructura que `ErrorState`: icono de error, título, causa, código técnico en su propia línea y la fila de acciones. `description` debe decir si se ejecutó o no alguna acción externa. Reintentar es la acción principal (`btn--primary`); el resultado alternativo, la secundaria.
 *
 * @example <RetryError onRetry={reintentar} onFallback={usarCopia} />
 * @example <RetryError code="source_timeout" description="Segundo intento fallido. No se ejecutó ninguna acción externa." onRetry={reintentar} fallbackLabel="" />
 */
export function RetryError({
  title = "No se completó la consulta",
  code = "source_timeout",
  description = "La fuente tardó más de 30 segundos. No se ejecutó ninguna acción externa.",
  retryLabel = "Reintentar",
  onRetry,
  fallbackLabel = "Usar última copia",
  onFallback,
  className,
}: RetryErrorProps) {
  return (
    <section className={["ui-feedback ui-state ui-state--error", className].filter(Boolean).join(" ")} data-retry-error role="alert">
      <svg className="ui-state__icon" viewBox="0 0 24 24" aria-hidden="true"><circle cx="12" cy="12" r="9"></circle><path d="M12 7v6M12 17h.01"></path></svg>
      <div>
        {title ? <h3>{title}</h3> : null}
        {description ? <p>{description}</p> : null}
        {code ? <p><code>{code}</code></p> : null}
        {retryLabel || fallbackLabel ? (
          <div className="ui-actions">
            {retryLabel ? <button className="btn btn--primary" type="button" onClick={onRetry}>{retryLabel}</button> : null}
            {fallbackLabel ? <button className="btn btn--secondary" type="button" onClick={onFallback}>{fallbackLabel}</button> : null}
          </div>
        ) : null}
      </div>
    </section>
  );
}