Saltar al contenido
Índice de Documentación
Documentación Distribución

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

CanalUsoActualización
Paquete @cis/design-systemNext.js y ViteLockfile y pull request
CDN inmutableHTML estático, SSR y embedsCambiar URL versionada y SRI
Registry shadcnComponentes React complejosCopiar código y revisar diff
API de contratosManifest, catálogo, compatibilidad y deprecaciónNo 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.

Código de referencia
npm install ./cis-design-system-10.0.0-candidate.46.tgz

Descargar el paquete candidato

Next.js o Vite

Código de referencia
# 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

Código de referencia
<html data-society="cis" data-brand="usaia">
  <!-- kit → sociedad → marca → contenido del producto -->
</html>

HTML o render de servidor

Código de referencia
<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

Código de referencia
npx shadcn add   https://tmp.innovacionsantiago.cl/style-v10/registry/v10/button-primary.json

Punteros 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

PasoGate
Descubrircandidate o stable nuevo
ProponerPR con lockfile, componentes y changelog
ValidarContratos, build, accesibilidad y comparación visual
DesplegarHealthcheck y logs
RevertirLockfile 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.