AURA UI — le design system de SP Browser 3
AURA UI est écrit en SwiftUI natif, dans SPBrowser/Shared/Aura, et compilé dans l'application macOS et dans l'application iOS / iPadOS. Les règles (durées, courbes, politique Reduce Motion) vivent dans le cœur sans interface (SPBrowser/Core/Aura/MotionTokens.swift) pour être testées par swift test.
Identité
| Jeton | Valeur | Usage |
|---|---|---|
| Obsidian Black | #07080C |
fond de Constellation, thème Obsidian, lecteur sombre |
| Graphite | #14161C |
surface des pages en mode sombre |
| Deep Space Blue | #0B1530 |
profondeur des fonds (Constellation, Cosmos) |
| Electric Violet | #7C5CFF |
début du dégradé AURA, navigation privée |
| Aurora Cyan | #22D3EE |
fin du dégradé AURA, guides d'alignement, liens parent → enfant |
| Bleu électrique | #2F6BFF |
accent (couleur d'accent de l'application, inchangée depuis la 1.0) |
Le dégradé AURA (violet → bleu → cyan) est réservé à ce qui porte une information : anneau de focus d'un champ, progression de chargement, Focus Trail, étape courante dans Flow, sélection dans Constellation, bouton central d'Orbit. Il n'est jamais utilisé comme simple décor de panneau.
Les anciens noms (Theme.* côté Mac, SPTheme.* côté partagé) existent toujours : ce sont maintenant des alias des jetons AURA. Il n'y a plus deux copies des valeurs.
Material Engine
Une surface AURA (.auraSurface(level, radius:, tint:, interactive:, luminous:)) est composée de quatre couches :
- un matériau système (
.bar,.thinMaterial,.regularMaterial) — transparence, flou et vibrancy sont ceux d'Apple, donc gérés par le compositeur et conformes à « Réduire la transparence » ; - une teinte légère (
glassTint) pour que le verre garde la couleur d'AURA ; - un liseré lumineux : un trait d'un point en dégradé vertical (clair en haut, presque nul en bas) ;
- une ombre qui dépend seulement du niveau d'élévation.
| Niveau | Élévation | Exemples |
|---|---|---|
chrome |
flat (aucune ombre) |
barre d'outils, barres latérales |
panel |
raised |
cartes de la page de démarrage, étapes de Flow, cartes du Canvas |
floating |
floating |
barre flottante iPhone, barres d'outils du Canvas et de Constellation, toasts |
overlay |
overlay |
palette, Peek, feuilles Flow / Canvas / Portal, suggestions |
Réactions : une surface interactive suit le pointeur avec une lumière radiale (un seul dégradé, dessiné uniquement pendant le survol) ; les boutons cèdent légèrement sous la pression (AuraPressStyle) ; luminous allume le liseré en dégradé (focus, sélection). Aucun filtre de flou n'est calculé par l'application.
Composants
| Composant | Rôle | macOS | iPhone | iPad |
|---|---|---|---|---|
AuraSurface, .auraSurface |
surface matérielle | oui | oui | oui |
AuraFloatingPanel |
panneau flottant avec transition de profondeur | palette, Peek, suggestions | feuilles | feuilles |
AuraToolbar |
rangée de contrôles, densité compact / regular, variante flottante |
barre d'outils (compacte sous 980 pt) | barre flottante | barre supérieure |
AuraTab |
onglet ; la sélection est une forme unique qui glisse (matchedGeometryEffect) |
bande d'onglets | — (grille) | bande d'onglets |
AuraSearchField |
champ de recherche, anneau de focus en dégradé | palette, Constellation, Canvas | idem | idem |
.auraField |
habillage d'un champ existant | barre d'adresse, page de démarrage | barre d'adresse | barre d'adresse |
AuraCommandPalette |
coquille de palette (champ, liste au clavier, aide) | ⌘K | palette compacte | palette |
AuraContextMenu |
liste d’actions flottante, pour les endroits où un menu système ne peut pas être attaché | disponible | disponible | disponible |
AuraSidebar |
conteneur latéral avec transition | barre latérale, panneau droit | — | barre latérale |
AuraModal (.auraModal) |
modale centrée avec voile | disponible (les feuilles Flow, Canvas et Portal ont leur propre hôte) | — | — |
AuraToast |
confirmation brève, annoncée à VoiceOver | bas de fenêtre | haut d'écran | haut d'écran |
AuraProgressIndicator |
ligne ou anneau, déterminé ou non | chargement, onglets, Peek | chargement | chargement |
AuraTransition |
depth, rise, morph, tabChip, fade |
oui | oui | oui |
AuraIconButton, AuraPressStyle, AuraChip, AuraEmptyState, AuraSiteGlyph |
pièces communes | oui | oui | oui |
AURA Motion Engine
| Jeton | Durée nominale | Courbe | Usage |
|---|---|---|---|
motion.instant |
0,08 s | ease-out | teinte de survol, sélection |
motion.quick |
0,16 s | ease-out | icônes, puces, sortie d'un toast |
motion.standard |
0,26 s | ressort 0,30 / 0,90 | panneaux, barres latérales, suggestions |
motion.expressive |
0,42 s | ressort 0,42 / 0,80 | morphing d'onglet, transformation de la barre d'adresse, entrée de Constellation |
motion.cinematic |
0,62 s | ressort 0,60 / 0,86 | entrée d'une surface plein écran |
motion.spring |
0,36 s | ressort 0,36 / 0,74 | ce qui se pose (cartes, onglets) |
motion.interactive |
0,20 s | ressort 0,22 / 0,86 | ce qui suit le doigt ou le pointeur |
Toute animation de la 3.0 nomme un jeton : .auraAnimation(.standard, value:), AuraMotion.perform(.spring) { … }, AuraTransition.depth(policy).
Politique unique (MotionPolicy)
| Condition | Effet |
|---|---|
| Réduire les animations | aucun déplacement ni rebond : chaque jeton devient un fondu de 0,16 s au plus ; instant devient immédiat ; les transitions spatiales (depth, rise, morph) deviennent opacity ; les fonds ambiants s'arrêtent sur une image fixe |
| Mode économie d'énergie | expressive et cinematic passent à 0,24 s sans rebond ; tout mouvement décoratif s'arrête |
| Fenêtre ou scène en arrière-plan | tout mouvement décoratif s'arrête |
| Réglage « Animer l'arrière-plan » désactivé | mouvement décoratif arrêté, animations d'interaction conservées |
La politique est publiée dans l'environnement SwiftUI par .auraRoot() (une fois par fenêtre / scène). Tests : AuraMotionTests.
Gestes interactifs
GestureResolution.shouldCommit(progress:velocity:) décide de la fin de tout geste relâché (seuil à 50 %, ou coup sec) et rubberBand donne la résistance au-delà de la plage. AuraViewport porte le zoom et le déplacement de Constellation et du Canvas : pincement autour des doigts, défilement à deux doigts sur Mac (moniteur d'événements local, actif seulement quand la vue est à l'écran), ⌘ + défilement pour zoomer.
Thèmes ambiants
Dessinés dans un Canvas à 20 images par seconde au plus, avec une poignée de dégradés radiaux — aucun flou, aucune passe hors écran, aucun MeshGradient (la cible macOS reste 14).
| Thème | Mouvement | Clair / sombre |
|---|---|---|
| Obsidian | aucun | toujours sombre (le contenu de la page passe en clair sur sombre) |
| Aurora | trois halos lents | clair et sombre |
| Liquid | cinq lobes et une bande spéculaire | clair et sombre |
| Cosmos | trois couches d'étoiles en parallaxe | toujours sombre |
| Minimal | aucun, aucune décoration | clair et sombre |
Migration depuis la 2.0 (schéma de réglages 3 → 4) : aurora → Aurora, plain → Minimal, graphite → Obsidian, dusk et forest → Liquid. Test : testStartPageBackgroundBecomesAnAmbientTheme.
Accessibilité
- Chaque contrôle AURA a un libellé ; les surfaces plein écran sont des conteneurs avec le trait modal ; les fonds, lignes et halos sont masqués des technologies d'assistance.
- Constellation est entièrement utilisable au clavier (flèches, Retour, Espace, Suppr,
/, Échap) et chaque carte expose « Ouvrir » et « Fermer l'onglet » comme actions. - Focus Trail expose sa valeur (« Progression de lecture, 42 % »).
- Aucune information n'est portée par la seule couleur : l'étape courante de Flow a aussi une valeur « Étape actuelle », la fraîcheur d'un appareil dans Portal a un libellé.
- Non fait : audit VoiceOver complet des nouvelles surfaces sur appareil (voir
TEST_REPORT.md).