Découverte de Vercel UI SDK

Disponible dans 1 jour

Devenir premium
Résumé Support

Vercel a récemment annoncé une nouvelle bibliothèque de composants : UI SDK. Dans un écosystème déjà pas mal saturé (Base UI, Radix ou React Aria...), on peut se demander ce qu'elle peut apporter de plus. Derrière la promesse d’un outil "pensé pour les agents" se cache un système permettant de créer des composants sur plusieurs frameworks en séparant le comportement du rendu.

Installation

La bibliothèque est séparée en 2 parties avec un paquet générique @ui-sdk/core et un paquet spécifique au framework utilisé (par exemple @ui-sdk/react) :

npm install @ui-sdk/core @ui-sdk/react

Le SDK propose des composants headless qui fournissent le comportement et la structure de base tout en nous laissant le choix sur le style à appliquer. Si on souhaite changer l'élément sous-jacent, on peut utiliser la propriété render (le principe est similaire à celui de BaseUI).

function App() { return <Button render={<a href="https://grafikart.fr" />}>Voir le site</Button>; }

Ce n'est pas forcément la partie la plus intéressante de la bibliothèque car c'est quelque chose que l'on a déjà vu et revu...

Les primitives

Les primitives permettent de définir la logique d’un composant indépendamment du framework. On peut ensuite adapter cette logique à React ou à un autre framework pris en charge. Par exemple, voici la primitive pour un bouton permettant de copier du texte.

import { definePrimitive } from "@ui-sdk/core"; type CopyButtonOptions = { text?: string; onCopy?: (text: string) => void }; const copyButtonPrimitive = definePrimitive({ name: "copy-button", options: { text: "string", onCopy: "callback" }, state: (options: CopyButtonOptions) => ({ copied: false }), api: (context) => ({ async copy() { const { text = "", onCopy } = context.options(); await navigator.clipboard.writeText(text); context.store.set({ copied: true }); onCopy?.(text); }, }), slots: (slot) => ({ root: slot<{}, { copied: boolean }>({ state: (state) => ({ copied: state.copied }), attrs: () => ({ type: "button" }), press: ({ api }) => api.copy(), }), }), }); export { copyButton };

On retrouve à l'intérieur de cette primitive des logiques similaires à ce que l'on connaît déjà :

  • options est l'équivalent des propriétés pour un composant.
  • state permet de définir l'état du composant.
  • api pour définir les méthodes qui seront utilisables par les composants.
  • slots permet de lister les composants qui formeront notre interface.

Ensuite, on peut utiliser cette primitive pour créer un composant dans notre framework de choix :

import { createParts } from "@ui-sdk/react/primitive"; export const CopyButton = createParts(copyButtonPrimitive, { root: "button" });

Et on pourra ensuite utiliser ce composant dans le reste de notre application.

function App() { return <CopyButton.Root text="sudo apt update">Copier</CopyButton.Root>; }

C'est un exemple simple mais c'est cette structure qui est utilisée en interne pour définir l'ensemble des composants de la bibliothèque (exemple avec le Popover).

Les comportements

Les behaviors sont des blocs de logique réutilisables que l’on peut associer à une primitive pour gérer des comportements réutilisables. Par exemple, si on souhaite créer une grille navigable au clavier, on peut utiliser createGridFocus.

state: () => ({ active: null as GridCell | null }), api: (context) => ({ grid: createGridFocus(context, { key: "active", rows: () => 3, cols: () => 6, }), }),

Utilisation avec les agents

Un des arguments donnés en introduction est le support des agents mais, dans les faits, on peut se demander de quoi il s'agit vraiment.

Des instructions et des skills

La documentation propose une installation destinée aux agents, avec des instructions pour le fichier AGENTS.md et un skill consacré au SDK.

npx skills@latest add vercel-labs/ui --skill ui-sdk

Ce skill décrit le processus à suivre pour construire un composant avec la bibliothèque et permet à l'agent de comprendre les outils disponibles et le principe de primitive directement.

Une interface pour les agents

Le SDK permet aussi de décrire les composants et leurs actions pour qu’un agent puisse interagir avec l’interface de manière simplifiée. Lorsque l'on définit un composant via le système de primitives, on peut ajouter une clef agent permettant de décrire les actions possibles. L'agent peut ensuite avoir un snapshot des composants de la page.

[ { ref: "c1", component: "rating", actions: ["rate"], label: "Your rating", value: 0, }, ];

De cette manière-là, il peut interagir plus simplement avec les composants directement plutôt que de chercher à comprendre la structure du DOM et les interactions nécessaires.

Ce n’est pas forcément un besoin dans tous les projets, notamment lorsqu’un MCP dédié existe déjà, mais cette approche peut faciliter l’utilisation d’une interface par des agents et des outils automatisés.

Mon avis

Pour être honnête, je suis un peu mitigé vis-à-vis de cette nouvelle bibliothèque. Je trouve dommage de voir apparaître une nouvelle version plutôt que de contribuer à des outils existants (comme Base UI ou React Aria par exemple). Aussi, le système de primitives, même s'il est intéressant pour le côté multi-framework, nécessite d'écrire des composants en utilisant une approche propre à la bibliothèque (qui risque de changer avec le temps).

En revanche, le système de comportements permet à UI SDK d'être assez flexible pour la création de composants spécifiques qui ne correspondent pas aux composants classiques.

Enfin, il faut savoir que la bibliothèque est en bêta et qu'avant la sortie de la v1 les méthodes peuvent encore changer. Personnellement, j’attendrais une version stable avant de l’adopter.