# SP Browser 3.0 — AURA
SP Browser 3.0 est une évolution de la 2.0, pas une réécriture : le moteur (WebKit), SP Search, SP Identity, SP Sync, les profils, les espaces de travail, les onglets et le backend sont ceux de la 2.0. La 3.0 ajoute un design system (AURA UI), un moteur d'animation, et des surfaces nouvelles construites sur l'existant. Ce qui existait, ce qui a été amélioré et ce qui est nouveau est détaillé dans SP_BROWSER_3_AUDIT.md ; le design system dans AURA_DESIGN_SYSTEM.md.
# Où vit le code
| Dossier |
Contenu |
Plateformes |
SPBrowser/Core/Aura |
modèles sans interface : jetons de mouvement et politique, FlowTrail, ConstellationMap, CanvasBoard / CanvasStore / CanvasSyncBridge, aperçu de lien (analyse, politique, chargeur), hand-off Portal, catalogue Orbit, scripts de lecture |
macOS + iOS, paquet SwiftPM (testé par swift test) |
SPBrowser/Shared/Aura |
AURA UI : jetons, Material Engine, Motion Engine, composants, fonds ambiants, lecteur |
macOS + iOS |
SPBrowser/Shared/Aura/Features |
les surfaces : Constellation, Flow, Canvas, Peek, Portal, Orbit, Focus Trail — une seule implémentation, qui s'adapte à la classe de taille |
macOS + iOS |
SPBrowser/Features/Aura |
branchement dans la fenêtre Mac (BrowserWindowState+Aura, hôtes des surfaces, Peek au survol, morphing) |
macOS |
Mobile/ |
branchement dans l'app iPhone / iPad |
iOS |
Principe tenu : une fonctionnalité = un modèle commun + une vue commune ; chaque plateforme ne fournit que ses données et ses gestes.
# Ce que la 3.0 apporte
# Nouveau
| Fonction |
Ce qu'elle fait |
Sur quoi elle s'appuie |
| Tab Constellation (⇧⌘E) |
les onglets de l'espace actif en cartes flottantes ; une constellation par groupe d'onglets, une par site ouvert dans plusieurs onglets ; traits pointillés cyan pour « ouvert depuis » ; zoom, panoramique, recherche, sélection multiple, regroupement, fermeture, glisser une carte sur une constellation pour la joindre ; clavier complet. Au-delà de 60 onglets : vue allégée (sans vignettes ni traits secondaires) |
onglets, groupes et vignettes existants. La bande d'onglets et la liste verticale restent le mode normal |
| Peek (⌥ + survol, ⌥⌘P ; appui prolongé sur iOS) |
carte d'aperçu d'un lien : titre, site, image, description, extrait, avertissement si le lien mène à un autre site ; actions Ouvrir, Nouvel onglet, Comparer (vue scindée, Mac), Lire plus tard, Au canvas, Résumer (Mac, via SP Intelligence), Copier |
chargeur dédié (voir « Vie privée ») |
| Flow (⇧⌘Y) |
le parcours entre les pages en arbre : recherche → résultat → article → référence. Revenir à une étape, bifurquer dans un nouvel onglet, liste des parcours, oubli d'un parcours |
l'historique reste l'historique ; Flow ne garde que « quelle page a mené à quelle autre » |
| Canvas (⇧⌘B ; ⌃⌘B ajoute la page) |
tableau libre de cartes : liens, onglets, notes, extraits, images, captures, PDF. Alignement magnétique avec guides, liens entre cartes, groupes, recherche, export Markdown, plusieurs tableaux |
stockage local par profil ; synchronisation optionnelle, par tableau |
| Morphing d'onglet |
un onglet ouvert depuis un lien grandit à partir de ce lien ; dans la bande, un onglet apparaît et se contracte à la fermeture ; la sélection glisse d'un onglet à l'autre |
script de survol interne (position du lien) |
| Transfert explicite (Portal) |
envoyer les onglets d'une fenêtre à un autre appareil, qui propose de les ouvrir |
nouvelle collection SP Sync handoff, chiffrée de bout en bout |
# Amélioré (existait en 2.0)
| Fonction |
Avant |
Maintenant |
| Palette de commandes → Command Orbit (⌘J) |
palette ⌘K, macOS seulement |
Orbit : anneau des 8 commandes qui conviennent au contexte, ouvert sous le pointeur ; taper bascule vers la palette. Même catalogue, même exécuteur (CommandID, perform). Palette et Orbit sur iPhone et iPad (grille en bas d'écran sur iPhone) |
| Mode Concentration → Focus Mode |
masquait le chrome (Mac) |
la page prend toute la fenêtre ; Focus Trail (progression de lecture) ; pastille discrète pour sortir ; avis du navigateur masqués (les erreurs restent). Porté sur iOS |
| Lecteur |
Mac seulement |
lecteur commun aux trois plateformes : mesure qui suit la taille du texte, thèmes Automatique / Papier / Sombre, temps de lecture, Focus Trail |
| Autres appareils → Portal (⇧⌘P) |
liste d'onglets |
cartes d'appareils (icône, fraîcheur, « onglets en date de… »), ouvrir tout, onglets fermés, dernière synchronisation, transfert explicite dans les deux sens |
| Page de démarrage → Ambient Home |
5 arrière-plans fixes |
5 thèmes ambiants (Obsidian, Aurora, Liquid, Cosmos, Minimal), cartes en verre, espaces de travail, sessions récentes, appareils, apparition échelonnée |
| Barre d'adresse |
apparition sèche des suggestions |
la barre s'arrondit en champ de recherche, s'allume, la page recule, les suggestions viennent en profondeur |
| Chrome |
densité fixe |
barre d'outils compacte sous 980 pt de large ; barre flottante qui se contracte au défilement sur iPhone |
| Micro-interactions |
survols |
pression des boutons, symboles qui se transforment (recharger ↔ arrêter), anneau de progression dans les onglets, toasts à icône, haptique iOS, tic d'alignement au trackpad |
À chaque navigation validée (didCommit), le moteur dit comment la page a été atteinte :
| Transition |
Origine |
Effet sur l'arbre |
typed |
adresse ou recherche saisie, signet, favori |
nouveau parcours (nouvelle racine) |
link |
lien suivi dans le même onglet |
enfant de l'étape courante ; suivre deux fois le même lien réutilise la branche |
revisit |
précédent, suivant, recharger |
le curseur de l'onglet revient sur l'étape existante — rien n'est dupliqué ; un nouveau lien depuis là crée une bifurcation |
opened(from:) |
première page d'un onglet ouvert depuis un autre |
enfant de l'étape où se trouvait l'onglet d'origine |
Le parcours est borné à 500 étapes (les parcours les plus anciens partent en entier ; celui d'un onglet ouvert n'est jamais coupé). Il est effacé avec l'historique (tout, période, site, visite).
# Vie privée et sécurité
Rien de ce qui existait n'est affaibli : WebKit, passkeys, chiffrement de bout en bout, isolement des profils, navigation privée, bloqueur, permissions. Règles ajoutées pour les nouvelles surfaces :
| Sujet |
Règle |
Vérification |
| Peek |
une seule requête GET, sans cookies, sans identifiants, sans référent, sans exécuter la page (c'est une lecture de texte, pas un rendu) ; 600 Ko et 8 s au plus ; 5 redirections au plus, chacune revalidée ; cache en mémoire seulement, jamais en navigation privée |
AuraPeekTests |
| Peek et réseau local |
une page publique ne peut pas faire sonder le réseau local : localhost, adresses privées, lien-local, .local, noms sans point sont refusés (sauf si la page elle-même est locale) ; les adresses avec identifiants et tout schéma autre que http(s) sont refusés |
testPolicyRefusesLocalNetworkCredentialsAndOtherSchemes, testPeekStateFollowsTheHoveredLinkAndRefusesLocalTargets |
| Peek : ce que le site voit |
une requête venant de l'adresse IP de l'utilisateur, au moment où il demande l'aperçu. C'est dit dans les réglages. L'aperçu au simple survol est désactivé par défaut |
— |
| Script de survol |
exécuté dans le monde isolé SPBrowserInternal, cadre principal seulement ; il lit (lien survolé, position, défilement) et ne modifie rien ; ses messages sont validés (HoveredLink.parse) |
testHoveredLinkMessagesAreValidated, testThePageBridgeIsInstalledOnceAndReportsRealScrolling |
| Flow en privé |
le parcours d'une fenêtre privée vit en mémoire et disparaît avec elle ; rien n'atteint le fichier du profil |
testPrivateWindowsKeepTheirPathInMemoryOnly |
| Captures |
aucune capture de page n'est prise automatiquement. « Capture de la page actuelle » dans le Canvas est une action explicite, absente des fenêtres privées. Les vignettes de Constellation sont celles, en mémoire, que la 2.0 prenait déjà pour l'aperçu d'onglet |
idem |
| Canvas |
local par profil. Un tableau n'est synchronisé que si l'utilisateur le demande ; une carte = un enregistrement chiffré ; les images ne quittent jamais l'appareil |
testOnlyOptedInBoardsReachTheSyncMirrorAndAssetsNeverDo, testAddingThePageToTheCanvasPersistsACardAndNothingIsSyncedByDefault |
| Transfert |
jamais depuis une fenêtre privée ; seules les pages web (pas file:, pas les pages internes) ; expire après 24 h |
testHandoffReachesOnlyItsTargetExpiresAndIsConsumed |
| Serveur |
deux noms de collection de plus (canvas, handoff) ; toujours des identifiants opaques et des charges chiffrées |
test du backend |
# SP Sync : ce qui change
- Backend
sp-browser-backend @ 5b28f8d : canvas et handoff ajoutés à la liste des collections acceptées. Changement additif ; un client 2.0 ne les envoie pas et range sans les lire celles qu'il reçoit.
- Portal n'est pas instantané. La synchronisation reste celle de la 2.0 : peu après un changement, au retour au premier plan, toutes les 5 minutes. Un transfert part dans la seconde depuis l'appareil qui envoie, et arrive à la prochaine synchronisation de l'appareil qui reçoit. L'interface le dit (« Ils y apparaîtront à sa prochaine synchronisation », « Onglets en date de… », « Synchronisé il y a… »).
# Migration depuis la 2.0
| Donnée |
Traitement |
Réglages (settings.json, schéma 3 → 4) |
l'arrière-plan choisi devient un thème ambiant ; tout le reste est conservé ; les nouveaux réglages prennent leur valeur par défaut |
| Session, onglets, groupes, espaces |
inchangés ; openerID est un champ facultatif, absent des sessions 2.0 |
| Historique, signets, notes, permissions |
inchangés (aucune migration de base) |
| Miroir de synchronisation, compte, clés |
inchangés |
| Nouveaux fichiers par profil |
flow.json, Canvas/ |
Tests : AuraMigrationTests (réglages 2.0, session 2.0).
# Limites connues
| Sujet |
Limite |
| Morphing d'onglet |
l'origine est connue quand le lien a été pressé dans le cadre principal dans la seconde et demie précédente ; sinon l'onglet apparaît simplement dans la bande. Les liens dans des cadres tiers ne sont pas suivis |
| Peek |
texte seulement : une page entièrement construite par JavaScript donne un aperçu réduit au titre. Pas d'aperçu des liens dans les cadres tiers (Mac) |
| Constellation |
la disposition est calculée (déterministe) : une carte ne peut pas être laissée à un endroit arbitraire, elle rejoint une constellation ou revient à sa place. iOS n'a pas de groupes d'onglets : le regroupement n'y a pas d'effet |
| Canvas |
pas d'encre manuscrite : l'Apple Pencil y est un pointeur précis. Les images ne se synchronisent pas (l'autre appareil affiche un emplacement). Deux modifications simultanées d'une même carte : la dernière gagne |
| Résumé / traduction par IA |
macOS seulement, par SP Intelligence et son écran de consentement ; iOS n'a pas SP Intelligence |
| Portal |
dépend de la cadence de SP Sync ; jamais exercé entre deux appareils physiques (voir TEST_REPORT.md) |
| Fluidité |
mesurée par le temps de lancement, la mémoire et le processeur au repos ; aucune session Instruments (fréquence d'images, énergie) n'a été enregistrée |