SP Browser 3.0 « AURA » — audit du projet existant
Audit fait le 2026-11-19 sur main @ 9f3cc48 (SP Browser 2.0.0, build 2) et sur le backend sp-browser-backend @ a8274ad, avant toute modification. Il fixe ce qui existe, ce qui doit seulement être amélioré, et ce qui est réellement nouveau. Rien de ce qui est classé EXISTING ou ENHANCE ne sera présenté comme une nouveauté de la 3.0.
Classes : EXISTING à préserver tel quel · ENHANCE existe, à améliorer · NEW n'existe sur aucune plateforme · PARITY existe sur une plateforme seulement · EXPERIMENTAL demande une validation technique.
1. Ce qui a été inspecté
| Élément | Constat |
|---|---|
| Dépôt | 28 476 lignes suivies ; Swift 6 strict ; projet généré par xcodegen (project.yml) ; paquet SwiftPM SPBrowserCore pour les tests du cœur |
SPBrowser/Core |
logique sans interface, compilée dans l'app macOS, l'app iOS et le paquet (sauf BrowserEngine/, WebKit + AppKit, macOS seulement) |
SPBrowser/Shared |
SwiftUI commun aux deux apps : résultats SP Search, compte, BrowserServices, Platform.swift (SPTheme, images distantes) |
SPBrowser/Features, App, DesignSystem |
app macOS (AppKit + SwiftUI) ; Theme.swift = jetons 1.0 (couleurs, rayons, une seule animation snappy 0,22 s) |
Mobile/ |
app iPhone / iPad : BrowserModel, MobileTab, BrowserView (barre d'adresse en bas, vue des onglets, barre latérale iPad) |
| Backend | Node 26 + SQLite ; SP Search, SP Identity (WebAuthn), SP Sync (flux chiffré) ; liste fermée de 8 collections dans src/sync.ts |
| Docs | SP_BROWSER_2.md, FEATURE_MATRIX.md, ARCHITECTURE.md, TEST_REPORT.md, captures macOS (6) et iOS |
| Animations existantes | Theme.animation (une seule courbe), transitions move/opacity de la barre latérale, de la palette et des toasts, barre de progression, squelettes de chargement. Aucun jeton de mouvement, aucune matchedGeometry, aucun geste interactif hormis le glissement de la barre d'adresse iPhone |
| Onglets | macOS : BrowserWindowState (onglets, groupes, espaces, vue scindée, suspension, vignettes) ; iOS : BrowserModel (onglets ordinaires / privés, vignettes). Aucune relation parent → enfant n'est conservée (un onglet ouvert depuis un lien hérite seulement du groupe et de l'espace) |
2. Composants réellement communs
| Composant | macOS | iOS / iPadOS | Remarque |
|---|---|---|---|
Cœur (Core/* hors BrowserEngine) |
oui | oui | même source |
Catalogue de commandes CommandID |
exécuté par BrowserWindowState.perform |
non exécuté : les actions iOS sont câblées à la main dans les vues | la 3.0 ajoute un exécuteur iOS pour le sous-ensemble pertinent |
| Jetons de design | Theme (AppKit) |
SPTheme (copie des mêmes valeurs) |
deux copies → un seul système AURA |
Extraction du lecteur (PageScripts.reader) |
oui | non (fichier dans BrowserEngine/) |
à déplacer dans le cœur partagé |
| Moteur d'onglet | BrowserTab |
MobileTab |
deux classes, mêmes principes ; conservées |
3. Classement des fonctionnalités du mandat
| § | Fonctionnalité demandée | Classe | Existant | Travail 3.0 |
|---|---|---|---|---|
| 2 | AURA Design System (surfaces, composants, Material Engine) | NEW (système) / ENHANCE (jetons) | Theme, SPTheme, IconButton, HoverRow, cardSurface, VisualEffect |
nouveau système partagé Shared/Aura ; Theme et SPTheme deviennent des alias des jetons AURA |
| 3 | AURA Motion Engine (jetons, Reduce Motion, économie d'énergie) | NEW | une courbe unique, reduceMotion consulté au cas par cas |
jetons centraux instant … cinematic, spring, interactive ; politique unique Reduce Motion / mode économie |
| 3A | Tab Morphing | NEW / EXPERIMENTAL | onglet créé sans transition | apparition depuis le point du clic quand il est connu (script de survol), sinon depuis la barre d'onglets ; fermeture par contraction |
| 3B | Address Bar Transformation | ENHANCE | barre d'adresse + liste de suggestions (apparition sèche) | transformation continue, suggestions en profondeur |
| 3C | Floating Navigation iPhone | ENHANCE | barre d'adresse en bas, fixe | barre flottante qui se contracte au défilement |
| 3D | Sidebar Fluidity | ENHANCE | barre latérale macOS / iPad, transition move |
réorganisation animée des sections et des rangées |
| 3E | Interactive Gestures | ENHANCE | glissement de la barre d'adresse iPhone | gestes qui suivent le doigt, retour naturel à l'état précédent |
| 3F | Page Transition | NEW | aucune | transitions natives autour du contenu, jamais dans la page |
| 4 | Tab Constellation | NEW | bande d'onglets, liste verticale, grille iOS (conservées) | vue spatiale alternative, liens domaine / groupe / parent / espace |
| 5 | Peek (aperçu de lien) | NEW | aperçu d'onglet au survol (macOS) — autre fonction, EXISTING | carte d'aperçu de lien, chargée sans cookies ni scripts |
| 6 | Flow (parcours) | NEW, s'appuie sur l'historique EXISTING | historique chronologique, liste précédent/suivant par onglet | graphe de parcours (parent → enfant, branches) ; l'historique n'est pas recréé |
| 7 | Canvas | NEW | notes liées à une URL (macOS) — autre fonction, EXISTING | tableau de cartes, même format sur les trois plateformes |
| 8 | Command Orbit | ENHANCE (macOS) / PARITY (iOS) | palette ⌘K macOS ; rien sur iOS | panneau contextuel près de l'élément actif, même catalogue ; palette compacte sur iOS |
| 9 | Focus Mode | ENHANCE (macOS) / PARITY (iOS) | mode Concentration et lecteur sur macOS ; ni l'un ni l'autre sur iOS | chrome qui s'efface, Focus Trail, lecteur porté sur iOS |
| 10 | Portal | ENHANCE | panneau « Autres appareils », section de la page de démarrage, SP Sync | vue des appareils, reprise rapide, dernière synchro, transfert explicite (nouvelle collection de synchro) |
| 11 | Ambient Home | ENHANCE | page de démarrage 2.0, 5 arrière-plans statiques | 5 thèmes ambiants, cartes, animations d'apparition |
| 12 | Microinteractions | ENHANCE | survols, toasts, haptique ponctuelle iOS | pression, confirmations, états de chargement et d'erreur |
| 13 | Smart Chrome | ENHANCE | chrome macOS, iPhone, iPad | densité adaptative, surfaces flottantes, lecture condensée |
| 14 | Parité | PARITY | lecteur, palette, mode Concentration absents d'iOS | voir matrice ci-dessous |
| 16 | Sécurité / vie privée | EXISTING | WebKit, passkeys, E2EE, privé, profils, bloqueur | inchangé ; règles ajoutées pour Peek, Flow, Canvas |
Parité visée
| Fonctionnalité | macOS | iPhone | iPad |
|---|---|---|---|
| AURA Design, Motion Engine | oui | oui | oui |
| Tab Constellation | pointeur, trackpad, clavier | adapté (pincer, glisser) | oui |
| Peek | ⌥ + survol, raccourci | appui prolongé (menu contextuel système) | appui prolongé, clic secondaire |
| Flow | carte | vue simplifiée | carte |
| Canvas | complet | cartes verticales + canvas simplifié | tactile ; Pencil = pointeur (voir limites) |
| Command Orbit | panneau ancré | palette compacte | panneau ancré |
| Focus Mode | oui | oui | oui |
| Portal | oui | oui | oui |
| Ambient Home | oui | oui | oui |
4. Limites des API Apple vérifiées
| Sujet | Réalité | Conséquence |
|---|---|---|
Survol d'un lien dans WKWebView (macOS) |
aucun délégué public ne donne le lien survolé ni sa position | script interne dans le monde isolé SPBrowserInternal qui signale le lien, son rectangle et les touches de modification |
| Origine d'un nouvel onglet | WebKit ne donne pas la position du clic dans createWebViewWith |
origine = dernier lien signalé par le script ; sinon repli sur la barre d'onglets (« lorsque techniquement réalisable ») |
| Aperçu de lien iOS | contextMenuConfigurationForElement fournit l'URL et accepte un aperçu personnalisé |
carte AURA comme aperçu du menu contextuel système |
MeshGradient |
macOS 15 / iOS 18 ; la cible macOS est 14 | thèmes ambiants dessinés en Canvas + TimelineView, sans dépendance à macOS 15 |
| Mode économie d'énergie | ProcessInfo.isLowPowerModeEnabled (iOS, et macOS 12+) |
les animations décoratives s'arrêtent |
| 120 Hz | décidé par le système ; sur iPhone il faut CADisableMinimumFrameDurationOnPhone |
clé ajoutée à l'Info.plist iOS ; aucune promesse au-delà |
| Apple Pencil | UIPencilInteraction, PencilKit |
le canvas traite le Pencil comme un pointeur précis ; pas d'encre manuscrite en 3.0 (documenté) |
| Animations dans les pages | hors de portée et hors mandat | aucune injection d'animation dans les sites |
5. Backend : contrats touchés
| Contrat | État | Besoin 3.0 |
|---|---|---|
POST /api/search |
EXISTING | aucun changement |
| Identité (WebAuthn, sessions, appareils) | EXISTING | aucun changement |
POST /api/sync/push, GET /api/sync/pull |
EXISTING ; COLLECTIONS fermée à 8 noms |
ajout de canvas et handoff (changement additif, rétrocompatible : un client 2.0 ignore les collections qu'il ne connaît pas — à vérifier par test) |
Le serveur ne voit toujours que des noms de collection, des identifiants opaques et des charges chiffrées.
6. Risques relevés avant de commencer
- Deux copies des jetons (
Theme,SPTheme) : toute retouche visuelle faite d'un seul côté crée une divergence → unifier d'abord. - Tests hébergés macOS (35) et iOS (7 + 3 UI) reposent sur des identifiants d'accessibilité (
start-search-field,address-bar,tabs-button,tab-card…) : à conserver. - Réglage
StartPageBackground: valeursaurora, plain, dusk, forest, graphiteenregistrées chez les utilisateurs 2.0 → migration de schéma 3 → 4 sans perte de fichier. - Navigation privée : Flow, Canvas (ajout automatique), vignettes de Constellation et aperçus ne doivent rien écrire depuis un contexte privé.
scripts/perf.shtue tout processus SP Browser (pkill -f), y compris l'application installée de l'utilisateur → à corriger avant de mesurer.- Cérémonies biométriques et synchro entre deux machines physiques : toujours impossibles à exécuter sans le propriétaire ; l'état « non vérifié » de la 2.0 demeure.