SPB Git

Repository Public

SP_BROWSER_3.md 11.5 KB

# 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

# Flow : comment le parcours est construit

À 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
Files main
Menu

Theme