Clés typées

Le concept

Sonenta étend la notion de clé. Au-delà de son chemin (plat ou imbriqué), chaque clé porte un type qui décrit son rôle dans l'interface. Le type est un axe à part entière, distinct de la structure : une clé checkout.pay (chemin imbriqué) peut être de type button.

Le type d'une clé informe trois choses :

• La traduction : le type donne le contexte. Un button se traduit court et à l'impératif, un heading est nominal, un error_message reste clair et actionnable.
• L'accessibilité : le type décide quelles surfaces d'accessibilité la clé porte. Un button appelle un aria_label, une image un alt_text, un text / heading / label du plain_language et du screen_reader.
• L'outillage : les agents et le tableau de bord adaptent leurs recommandations au type.

Les types de clés

Sonenta définit 17 types. Le type par défaut est text.

Type	Usage
text	texte courant (défaut)
heading	titre
label	libellé de champ ou d'élément
caption	légende
badge	pastille / étiquette courte
tooltip	infobulle
error_message	message d'erreur
toast	notification éphémère
button	bouton
link	lien
menu_item	entrée de menu
input_placeholder	texte indicatif de champ
input_label	libellé de champ de saisie
image	image
icon	icône
meta_title	titre de métadonnées (SEO)
meta_description	description de métadonnées (SEO)

Type et structure : deux axes distincts

Le type décrit le rôle d'une clé. La structure (chemin plat ou imbriqué) décrit comment vous l'organisez. Les deux sont indépendants : vous choisissez librement l'imbrication, et chaque clé garde son type. Pour l'axe structurel, voir Imbrication des clés.

Configuration

Assignez un type à chaque clé, manuellement dans le tableau de bord ou via la recommandation des agents. Sans type explicite, une clé est text. Le type est porté par la clé, dans la couche de contenu, et suit la clé partout (traduction, surfaces, CDN).