Surfaces

Le concept

Une surface est une variante de contenu superposée à la valeur de base d'une clé. Là où la valeur de base est le texte principal, les surfaces portent des variantes servies selon le contexte. Elles vivent sur la clé, dans la couche de contenu, sont traduites comme les valeurs et servies par le CDN, donc reçues par votre app sans changement de code.

Sonenta gère deux dimensions de surfaces, orthogonales (une clé peut en porter des deux) :

1. Surfaces d'appareil / canal

Une variante du texte selon l'appareil ou le canal d'affichage. La valeur de base sert un contexte, des surplus la surchargent pour les autres.

• Intégrées : desktop, mobile, tablet.
• Personnalisées : vous pouvez créer vos propres surfaces (par exemple watch, tv, kiosk). Un slug de surface est en minuscules (lettres, chiffres, _, -), de 1 à 40 caractères. Les surfaces intégrées s'activent ou se renomment ; les personnalisées sont libres.

Exemple : un libellé long sur desktop, une version courte sur mobile. Le site Sonenta lui-même s'en sert (le texte du bouton de la barre supérieure a une variante mobile).

2. Surfaces d'accessibilité

Un ensemble fixe de 4 couches destinées aux technologies d'assistance, distinctes du texte visible :

• aria_label : le nom accessible d'un élément interactif.
• alt_text : le texte alternatif d'une image.
• screen_reader : un texte réservé aux lecteurs d'écran (sr-only).
• plain_language : une version en langage clair (FALC) de la valeur.

Le détail du modèle d'accessibilité (key-types, score cognitif, flux, conformité) est sur la page Accessibilité.

Configuration

• Surfaces d'accessibilité : déclarées dans SonentaConfig.a11ySurfaces.
• Surfaces d'appareil : déclarées dans la config du SDK (par exemple la liste surfaces de @sonenta/astro).
• Agent sonenta-surface : recommande et active les surfaces (appareil et accessibilité), config-only, 0 crédit, non destructif (create / update / delete_surface). Il configure les surfaces ; il ne rédige pas les valeurs d'accessibilité (il passe la main à sonenta-a11y) et ne gère pas les variantes régionales (ce sont des langues). Modes : audit, recommander+appliquer, passation.

Côté SDK

Les surfaces d'accessibilité se lisent via des accesseurs dédiés (t.aria, t.alt, t.a11y) et le toggle FALC global pour plain_language. Les surfaces d'appareil sont résolues par le SDK selon le contexte d'affichage.