SPB Git

Repository Public

SP_BROWSER_3_AUDIT.md 10.2 KB

# 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

  1. Deux copies des jetons (Theme, SPTheme) : toute retouche visuelle faite d'un seul côté crée une divergence → unifier d'abord.
  2. 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.
  3. Réglage StartPageBackground : valeurs aurora, plain, dusk, forest, graphite enregistrées chez les utilisateurs 2.0 → migration de schéma 3 → 4 sans perte de fichier.
  4. Navigation privée : Flow, Canvas (ajout automatique), vignettes de Constellation et aperçus ne doivent rien écrire depuis un contexte privé.
  5. scripts/perf.sh tue tout processus SP Browser (pkill -f), y compris l'application installée de l'utilisateur → à corriger avant de mesurer.
  6. 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.
Files main
Menu

Theme