SPB Git

Repository Public

AURA_DESIGN_SYSTEM.md 8.1 KB 107 lines markdown

1# AURA UI — le design system de SP Browser 323AURA 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`.45## Identité67| Jeton | Valeur | Usage |8|---|---|---|9| Obsidian Black | `#07080C` | fond de Constellation, thème Obsidian, lecteur sombre |10| Graphite | `#14161C` | surface des pages en mode sombre |11| Deep Space Blue | `#0B1530` | profondeur des fonds (Constellation, Cosmos) |12| Electric Violet | `#7C5CFF` | début du dégradé AURA, navigation privée |13| Aurora Cyan | `#22D3EE` | fin du dégradé AURA, guides d'alignement, liens parent → enfant |14| Bleu électrique | `#2F6BFF` | accent (couleur d'accent de l'application, inchangée depuis la 1.0) |1516Le **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.1718Les 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.1920## Material Engine2122Une surface AURA (`.auraSurface(level, radius:, tint:, interactive:, luminous:)`) est composée de quatre couches :23241. 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 » ;252. une **teinte** légère (`glassTint`) pour que le verre garde la couleur d'AURA ;263. un **liseré lumineux** : un trait d'un point en dégradé vertical (clair en haut, presque nul en bas) ;274. une **ombre** qui dépend seulement du niveau d'élévation.2829| Niveau | Élévation | Exemples |30|---|---|---|31| `chrome` | `flat` (aucune ombre) | barre d'outils, barres latérales |32| `panel` | `raised` | cartes de la page de démarrage, étapes de Flow, cartes du Canvas |33| `floating` | `floating` | barre flottante iPhone, barres d'outils du Canvas et de Constellation, toasts |34| `overlay` | `overlay` | palette, Peek, feuilles Flow / Canvas / Portal, suggestions |3536Ré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.3738## Composants3940| Composant | Rôle | macOS | iPhone | iPad |41|---|---|---|---|---|42| `AuraSurface`, `.auraSurface` | surface matérielle | oui | oui | oui |43| `AuraFloatingPanel` | panneau flottant avec transition de profondeur | palette, Peek, suggestions | feuilles | feuilles |44| `AuraToolbar` | rangée de contrôles, densité `compact` / `regular`, variante flottante | barre d'outils (compacte sous 980 pt) | barre flottante | barre supérieure |45| `AuraTab` | onglet ; la sélection est une forme unique qui glisse (`matchedGeometryEffect`) | bande d'onglets | — (grille) | bande d'onglets |46| `AuraSearchField` | champ de recherche, anneau de focus en dégradé | palette, Constellation, Canvas | idem | idem |47| `.auraField` | habillage d'un champ existant | barre d'adresse, page de démarrage | barre d'adresse | barre d'adresse |48| `AuraCommandPalette` | coquille de palette (champ, liste au clavier, aide) | ⌘K | palette compacte | palette |49| `AuraContextMenu` | liste d’actions flottante, pour les endroits où un menu système ne peut pas être attaché | disponible | disponible | disponible |50| `AuraSidebar` | conteneur latéral avec transition | barre latérale, panneau droit | — | barre latérale |51| `AuraModal` (`.auraModal`) | modale centrée avec voile | disponible (les feuilles Flow, Canvas et Portal ont leur propre hôte) | — | — |52| `AuraToast` | confirmation brève, annoncée à VoiceOver | bas de fenêtre | haut d'écran | haut d'écran |53| `AuraProgressIndicator` | ligne ou anneau, déterminé ou non | chargement, onglets, Peek | chargement | chargement |54| `AuraTransition` | `depth`, `rise`, `morph`, `tabChip`, `fade` | oui | oui | oui |55| `AuraIconButton`, `AuraPressStyle`, `AuraChip`, `AuraEmptyState`, `AuraSiteGlyph` | pièces communes | oui | oui | oui |5657## AURA Motion Engine5859| Jeton | Durée nominale | Courbe | Usage |60|---|---|---|---|61| `motion.instant` | 0,08 s | ease-out | teinte de survol, sélection |62| `motion.quick` | 0,16 s | ease-out | icônes, puces, sortie d'un toast |63| `motion.standard` | 0,26 s | ressort 0,30 / 0,90 | panneaux, barres latérales, suggestions |64| `motion.expressive` | 0,42 s | ressort 0,42 / 0,80 | morphing d'onglet, transformation de la barre d'adresse, entrée de Constellation |65| `motion.cinematic` | 0,62 s | ressort 0,60 / 0,86 | entrée d'une surface plein écran |66| `motion.spring` | 0,36 s | ressort 0,36 / 0,74 | ce qui se pose (cartes, onglets) |67| `motion.interactive` | 0,20 s | ressort 0,22 / 0,86 | ce qui suit le doigt ou le pointeur |6869Toute animation de la 3.0 nomme un jeton : `.auraAnimation(.standard, value:)`, `AuraMotion.perform(.spring) { … }`, `AuraTransition.depth(policy)`.7071### Politique unique (`MotionPolicy`)7273| Condition | Effet |74|---|---|75| **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 |76| **Mode économie d'énergie** | `expressive` et `cinematic` passent à 0,24 s sans rebond ; tout mouvement décoratif s'arrête |77| **Fenêtre ou scène en arrière-plan** | tout mouvement décoratif s'arrête |78| Réglage « Animer l'arrière-plan » désactivé | mouvement décoratif arrêté, animations d'interaction conservées |7980La politique est publiée dans l'environnement SwiftUI par `.auraRoot()` (une fois par fenêtre / scène). Tests : `AuraMotionTests`.8182### Gestes interactifs8384`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.8586## Thèmes ambiants8788Dessiné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).8990| Thème | Mouvement | Clair / sombre |91|---|---|---|92| Obsidian | aucun | toujours sombre (le contenu de la page passe en clair sur sombre) |93| Aurora | trois halos lents | clair et sombre |94| Liquid | cinq lobes et une bande spéculaire | clair et sombre |95| Cosmos | trois couches d'étoiles en parallaxe | toujours sombre |96| Minimal | aucun, aucune décoration | clair et sombre |9798Migration depuis la 2.0 (schéma de réglages 3 → 4) : `aurora` → Aurora, `plain` → Minimal, `graphite` → Obsidian, `dusk` et `forest` → Liquid. Test : `testStartPageBackgroundBecomesAnAmbientTheme`.99100## Accessibilité101102- 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.103- Constellation est entièrement utilisable au clavier (flèches, Retour, Espace, Suppr, `/`, Échap) et chaque carte expose « Ouvrir » et « Fermer l'onglet » comme actions.104- Focus Trail expose sa valeur (« Progression de lecture, 42 % »).105- 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é.106- Non fait : audit VoiceOver complet des nouvelles surfaces sur appareil (voir `TEST_REPORT.md`).107
Files main
Menu

Theme