SPB Git

Repository Public

SP_BROWSER_3_AUDIT.md 10.2 KB 101 lines markdown

1# SP Browser 3.0 « AURA » — audit du projet existant23Audit 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.**45Classes : **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.67## 1. Ce qui a été inspecté89| Élément | Constat |10|---|---|11| 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 |12| `SPBrowser/Core` | logique sans interface, compilée dans l'app macOS, l'app iOS et le paquet (sauf `BrowserEngine/`, WebKit + AppKit, macOS seulement) |13| `SPBrowser/Shared` | SwiftUI commun aux deux apps : résultats SP Search, compte, `BrowserServices`, `Platform.swift` (`SPTheme`, images distantes) |14| `SPBrowser/Features`, `App`, `DesignSystem` | app macOS (AppKit + SwiftUI) ; `Theme.swift` = jetons 1.0 (couleurs, rayons, une seule animation `snappy 0,22 s`) |15| `Mobile/` | app iPhone / iPad : `BrowserModel`, `MobileTab`, `BrowserView` (barre d'adresse en bas, vue des onglets, barre latérale iPad) |16| Backend | Node 26 + SQLite ; SP Search, SP Identity (WebAuthn), SP Sync (flux chiffré) ; **liste fermée de 8 collections** dans `src/sync.ts` |17| Docs | `SP_BROWSER_2.md`, `FEATURE_MATRIX.md`, `ARCHITECTURE.md`, `TEST_REPORT.md`, captures macOS (6) et iOS |18| 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 |19| 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) |2021## 2. Composants réellement communs2223| Composant | macOS | iOS / iPadOS | Remarque |24|---|---|---|---|25| Cœur (`Core/*` hors `BrowserEngine`) | oui | oui | même source |26| 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 |27| Jetons de design | `Theme` (AppKit) | `SPTheme` (copie des mêmes valeurs) | deux copies → un seul système AURA |28| Extraction du lecteur (`PageScripts.reader`) | oui | **non** (fichier dans `BrowserEngine/`) | à déplacer dans le cœur partagé |29| Moteur d'onglet | `BrowserTab` | `MobileTab` | deux classes, mêmes principes ; conservées |3031## 3. Classement des fonctionnalités du mandat3233| § | Fonctionnalité demandée | Classe | Existant | Travail 3.0 |34|---|---|---|---|---|35| 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 |36| 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 |37| 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 |38| 3B | Address Bar Transformation | **ENHANCE** | barre d'adresse + liste de suggestions (apparition sèche) | transformation continue, suggestions en profondeur |39| 3C | Floating Navigation iPhone | **ENHANCE** | barre d'adresse en bas, fixe | barre flottante qui se contracte au défilement |40| 3D | Sidebar Fluidity | **ENHANCE** | barre latérale macOS / iPad, transition `move` | réorganisation animée des sections et des rangées |41| 3E | Interactive Gestures | **ENHANCE** | glissement de la barre d'adresse iPhone | gestes qui suivent le doigt, retour naturel à l'état précédent |42| 3F | Page Transition | **NEW** | aucune | transitions natives autour du contenu, jamais dans la page |43| 4 | Tab Constellation | **NEW** | bande d'onglets, liste verticale, grille iOS (conservées) | vue spatiale alternative, liens domaine / groupe / parent / espace |44| 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 |45| 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éé |46| 7 | Canvas | **NEW** | notes liées à une URL (macOS) — autre fonction, EXISTING | tableau de cartes, même format sur les trois plateformes |47| 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 |48| 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 |49| 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**) |50| 11 | Ambient Home | **ENHANCE** | page de démarrage 2.0, 5 arrière-plans statiques | 5 thèmes ambiants, cartes, animations d'apparition |51| 12 | Microinteractions | **ENHANCE** | survols, toasts, haptique ponctuelle iOS | pression, confirmations, états de chargement et d'erreur |52| 13 | Smart Chrome | **ENHANCE** | chrome macOS, iPhone, iPad | densité adaptative, surfaces flottantes, lecture condensée |53| 14 | Parité | **PARITY** | lecteur, palette, mode Concentration absents d'iOS | voir matrice ci-dessous |54| 16 | Sécurité / vie privée | **EXISTING** | WebKit, passkeys, E2EE, privé, profils, bloqueur | inchangé ; règles ajoutées pour Peek, Flow, Canvas |5556### Parité visée5758| Fonctionnalité | macOS | iPhone | iPad |59|---|---|---|---|60| AURA Design, Motion Engine | oui | oui | oui |61| Tab Constellation | pointeur, trackpad, clavier | adapté (pincer, glisser) | oui |62| Peek | ⌥ + survol, raccourci | appui prolongé (menu contextuel système) | appui prolongé, clic secondaire |63| Flow | carte | vue simplifiée | carte |64| Canvas | complet | cartes verticales + canvas simplifié | tactile ; Pencil = pointeur (voir limites) |65| Command Orbit | panneau ancré | palette compacte | panneau ancré |66| Focus Mode | oui | oui | oui |67| Portal | oui | oui | oui |68| Ambient Home | oui | oui | oui |6970## 4. Limites des API Apple vérifiées7172| Sujet | Réalité | Conséquence |73|---|---|---|74| 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 |75| 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 ») |76| 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 |77| `MeshGradient` | macOS 15 / iOS 18 ; la cible macOS est 14 | thèmes ambiants dessinés en `Canvas` + `TimelineView`, sans dépendance à macOS 15 |78| Mode économie d'énergie | `ProcessInfo.isLowPowerModeEnabled` (iOS, et macOS 12+) | les animations décoratives s'arrêtent |79| 120 Hz | décidé par le système ; sur iPhone il faut `CADisableMinimumFrameDurationOnPhone` | clé ajoutée à l'Info.plist iOS ; aucune promesse au-delà |80| Apple Pencil | `UIPencilInteraction`, PencilKit | le canvas traite le Pencil comme un pointeur précis ; pas d'encre manuscrite en 3.0 (documenté) |81| Animations dans les pages | hors de portée et hors mandat | aucune injection d'animation dans les sites |8283## 5. Backend : contrats touchés8485| Contrat | État | Besoin 3.0 |86|---|---|---|87| `POST /api/search` | EXISTING | aucun changement |88| Identité (WebAuthn, sessions, appareils) | EXISTING | aucun changement |89| `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) |9091Le serveur ne voit toujours que des noms de collection, des identifiants opaques et des charges chiffrées.9293## 6. Risques relevés avant de commencer94951. **Deux copies des jetons** (`Theme`, `SPTheme`) : toute retouche visuelle faite d'un seul côté crée une divergence → unifier d'abord.962. **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.973. **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.984. **Navigation privée** : Flow, Canvas (ajout automatique), vignettes de Constellation et aperçus ne doivent rien écrire depuis un contexte privé.995. **`scripts/perf.sh` tue tout processus SP Browser** (`pkill -f`), y compris l'application installée de l'utilisateur → à corriger avant de mesurer.1006. **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.101
Files main
Menu

Theme