SPB Git

Repository Public

SP_BROWSER_3.md 11.5 KB 100 lines markdown

1# SP Browser 3.0 — AURA23SP 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`.45## Où vit le code67| Dossier | Contenu | Plateformes |8|---|---|---|9| `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`) |10| `SPBrowser/Shared/Aura` | AURA UI : jetons, Material Engine, Motion Engine, composants, fonds ambiants, lecteur | macOS + iOS |11| `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 |12| `SPBrowser/Features/Aura` | branchement dans la fenêtre Mac (`BrowserWindowState+Aura`, hôtes des surfaces, Peek au survol, morphing) | macOS |13| `Mobile/` | branchement dans l'app iPhone / iPad | iOS |1415Principe tenu : **une fonctionnalité = un modèle commun + une vue commune ; chaque plateforme ne fournit que ses données et ses gestes.**1617## Ce que la 3.0 apporte1819### Nouveau2021| Fonction | Ce qu'elle fait | Sur quoi elle s'appuie |22|---|---|---|23| **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 |24| **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 ») |25| **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 » |26| **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** |27| **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) |28| **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 |2930### Amélioré (existait en 2.0)3132| Fonction | Avant | Maintenant |33|---|---|---|34| 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) |35| 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 |36| 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 |37| 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 |38| 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 |39| 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 |40| Chrome | densité fixe | barre d'outils compacte sous 980 pt de large ; barre flottante qui se contracte au défilement sur iPhone |41| 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 |4243## Flow : comment le parcours est construit4445À chaque navigation validée (`didCommit`), le moteur dit comment la page a été atteinte :4647| Transition | Origine | Effet sur l'arbre |48|---|---|---|49| `typed` | adresse ou recherche saisie, signet, favori | nouveau parcours (nouvelle racine) |50| `link` | lien suivi dans le même onglet | enfant de l'étape courante ; suivre deux fois le même lien réutilise la branche |51| `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** |52| `opened(from:)` | première page d'un onglet ouvert depuis un autre | enfant de l'étape où se trouvait l'onglet d'origine |5354Le 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).5556## Vie privée et sécurité5758Rien 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 :5960| Sujet | Règle | Vérification |61|---|---|---|62| **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` |63| 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` |64| 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** | — |65| 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` |66| **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` |67| **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 |68| **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` |69| **Transfert** | jamais depuis une fenêtre privée ; seules les pages web (pas `file:`, pas les pages internes) ; expire après 24 h | `testHandoffReachesOnlyItsTargetExpiresAndIsConsumed` |70| Serveur | deux noms de collection de plus (`canvas`, `handoff`) ; toujours des identifiants opaques et des charges chiffrées | test du backend |7172## SP Sync : ce qui change7374- 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.75- **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… »).7677## Migration depuis la 2.07879| Donnée | Traitement |80|---|---|81| 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 |82| Session, onglets, groupes, espaces | inchangés ; `openerID` est un champ facultatif, absent des sessions 2.0 |83| Historique, signets, notes, permissions | inchangés (aucune migration de base) |84| Miroir de synchronisation, compte, clés | inchangés |85| Nouveaux fichiers par profil | `flow.json`, `Canvas/` |8687Tests : `AuraMigrationTests` (réglages 2.0, session 2.0).8889## Limites connues9091| Sujet | Limite |92|---|---|93| 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 |94| 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) |95| 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 |96| 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 |97| Résumé / traduction par IA | macOS seulement, par SP Intelligence et son écran de consentement ; iOS n'a pas SP Intelligence |98| Portal | dépend de la cadence de SP Sync ; jamais exercé entre deux appareils physiques (voir `TEST_REPORT.md`) |99| 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 |100
Files main
Menu

Theme