SPB Git

Repository Public

AURA_DESIGN_SYSTEM.md 8.1 KB

# 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 :

  1. 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 » ;
  2. une teinte légère (glassTint) pour que le verre garde la couleur d'AURA ;
  3. un liseré lumineux : un trait d'un point en dégradé vertical (clair en haut, presque nul en bas) ;
  4. 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).
Files main
Menu

Theme