Consumir y actualizar Style v10.
Los clientes eligen un canal según su arquitectura. El estilo entra durante el build o desde una URL inmutable; la API sólo descubre y verifica contratos.
Cuatro canales, una versión
| Canal | Uso | Actualización |
|---|---|---|
| Paquete @cis/design-system | Next.js y Vite | Lockfile y pull request |
| CDN inmutable | HTML estático, SSR y embeds | Cambiar URL versionada y SRI |
| Registry shadcn | Componentes React complejos | Copiar código y revisar diff |
| API de contratos | Manifest, catálogo, compatibilidad y deprecación | No renderiza la interfaz |
Candidato temporal
El paquete todavía no está publicado en un registry npm. Descarga el tarball desde esta revisión autenticada, guárdalo en el repositorio cliente e instálalo por archivo para conservar el lockfile.
npm install ./cis-design-system-10.0.0-candidate.46.tgzNext.js o Vite
# Canal estable futuro, después de publicar el paquete
npm install @cis/design-system@10.0.0-candidate.46
// entrada global del sitio
import "@cis/design-system/style.css";
// Tailwind 4 debe observar los componentes exportados
@source "../node_modules/@cis/design-system/react";Herencia
<html data-society="cis" data-brand="usaia">
<!-- kit → sociedad → marca → contenido del producto -->
</html>HTML o render de servidor
<link rel="stylesheet"
href="https://kit.innovacionsantiago.cl/releases/10.0.0/<digest>/style.css"
integrity="sha384-<digest-publicado>"
crossorigin="anonymous">Registry de código
npx shadcn add https://tmp.innovacionsantiago.cl/style-v10/registry/v10/button-primary.jsonPunteros y API
Los punteros current y stable no son dependencias de runtime. Sirven para que CI descubra una versión nueva y abra un pull request; producción conserva una versión exacta hasta aprobarla.
- Manifest y OpenAPI describen integridad y compatibilidad.
- Una API nunca entrega navbar, botón o formulario para ejecutar en el navegador.
- Los componentes copiados se actualizan mediante diff, no overwrite.
- Un producto no crea una hoja de marca adicional.
Promoción y rollback
| Paso | Gate |
|---|---|
| Descubrir | candidate o stable nuevo |
| Proponer | PR con lockfile, componentes y changelog |
| Validar | Contratos, build, accesibilidad y comparación visual |
| Desplegar | Healthcheck y logs |
| Revertir | Lockfile o URL inmutable anterior |
Decisiones
Usa el identificador para confirmar, modificar o rechazar una regla.
DIST-01Regla vigenteEl paquete es el canal preferente para aplicaciones compiladas.
DIST-02Regla vigenteEl CDN de producción se fija por versión y digest.
DIST-03Regla vigenteLas APIs descubren contratos y nunca renderizan componentes.
DIST-04Regla vigenteNo hay actualización automática de estilos en producción.