# 03. Éditeur SVG anatomique (`/svg-editor`) Périmètre : ce que l'éditeur SVG intégré permet réellement de faire aujourd'hui, opération par opération, avec les structures de données et les attributs qu'il écrit. ## Sources lues - `src/app/routes/SvgEditorRoute.tsx` (1858 lignes, composant React + fonction `initSvgEditor`) - `src/styles/svg-editor.css` - `src/i18n/fr.ts` et `src/i18n/en.ts` (clés `svg_editor.*`, 71 clés) - `src/domain/species/registry.ts` (source de la liste d'espèces) - `src/anatomy/svgConvention.ts` (parser côté application, pour la notion de champ obligatoire) - `public/species/equine/Horse.svg`, `public/species/equine/Horse_head.svg` - `.claude/memory/decisions.md` (BDR-017, BDR-022) ## 1. Nature de l'outil FACTUEL. L'éditeur est un outil vanilla JS d'environ 1600 lignes enveloppé dans un composant React (`SvgEditorRoute.tsx:13-245` pour le squelette JSX, `SvgEditorRoute.tsx:247-1858` pour `initSvgEditor`). Le composant monte la logique impérative dans un `useEffect` et la détruit via un `AbortController` (`SvgEditorRoute.tsx:254-256`, `SvgEditorRoute.tsx:1857`). Décision documentée en BDR-017 : enveloppe plutôt que réécriture React. FACTUEL. Le `useEffect` dépend de `[locale]` (`SvgEditorRoute.tsx:31-47`). Changer la langue réinitialise entièrement l'éditeur : le SVG chargé, les catégories et la sélection sont perdus. Aucun état n'est conservé en dehors du DOM. FACTUEL. Une balise `` est injectée au montage (`SvgEditorRoute.tsx:21-29`). FACTUEL. Il n'y a aucun modèle de données intermédiaire. L'état éditable est le DOM SVG lui-même, plus quelques variables de fermeture : `mode`, `selected`, `polygonPoints`, `dragging`, `draggingHandle`, `dragStart`, `zoom`, `svgRoot`, `CATEGORIES`, `loadedFileName`, `_polygonRestartMemo` (`SvgEditorRoute.tsx:257-325`, `SvgEditorRoute.tsx:1320-1329`). ## 2. Opérations demandées par le brief | Opération | Statut | Où | Comment | |---|---|---|---| | Charger un SVG | Implémenté | `SvgEditorRoute.tsx:333-507`, `SvgEditorRoute.tsx:522-570` | Écran d'accueil à deux onglets : SVG du projet ou import de fichier | | Afficher un SVG | Implémenté | `SvgEditorRoute.tsx:532-552` | `DOMParser` + `importNode`, insertion dans `canvasInner` | | Identifier une zone | Implémenté | `SvgEditorRoute.tsx:713-715`, `SvgEditorRoute.tsx:991-1010` | `closest('[data-anno-id]')` puis sélection de tous les frères de même id et même catégorie | | Créer un point | Implémenté | `SvgEditorRoute.tsx:1233-1293` | Mode `point`, paire de cercles hitbox + visible | | Créer une zone (polygone) | Implémenté | `SvgEditorRoute.tsx:1331-1388` | Mode `polygon`, clics successifs, validation Entrée | | Modifier un point | Implémenté | `SvgEditorRoute.tsx:729-830`, `SvgEditorRoute.tsx:1112-1214` | Drag (cx/cy), panneau d'édition (noms, catégorie, latéralité, rayon, opacité) | | Modifier une zone | Implémenté | `SvgEditorRoute.tsx:1721-1786` | Drag global, poignées de sommets, insertion/suppression de sommet, redessin | | Supprimer un point | Implémenté | `SvgEditorRoute.tsx:1216-1231` | Bouton ou touche Suppr, retire tous les frères de même id et catégorie | | Supprimer une zone | Implémenté | idem | Même fonction `deleteSelected` | | Définir une catégorie | Implémenté | `SvgEditorRoute.tsx:1567-1594`, `SvgEditorRoute.tsx:1112-1214` | Catégorie par défaut pour les nouveaux éléments, ou select dans le panneau d'édition | | Définir une latéralité | Implémenté | `SvgEditorRoute.tsx:167-171`, `SvgEditorRoute.tsx:1159-1163` | Select à deux valeurs : vide (unilatéral) ou `bilateral` | | Définir les attributs `data-anno-*` | Implémenté partiellement | `SvgEditorRoute.tsx:1134-1210` | Écrits par `applyEdit`, jamais édités librement (pas de champ "id", pas de champ "special" par élément) | | Créer un zoom | Implémenté, visuel seulement | `SvgEditorRoute.tsx:301-323`, `SvgEditorRoute.tsx:1851-1855` | Boutons +, −, ⌂ qui appliquent `transform: scale()` sur le ``. Rien n'est écrit dans le fichier | | Créer un SVG de détail à partir d'une partie du SVG | NON IMPLEMENTE | aucune occurrence | Voir `04-detail-svg-generation.md` | | Relier le détail au principal | Implémenté partiellement | `SvgEditorRoute.tsx:136-152`, `SvgEditorRoute.tsx:1131-1141` | Pose `data-anno-opens-detail=""` sur un polygone. Le mapping id → fichier reste manuel dans le manifeste d'espèce | | Gérer les vertèbres | NON IMPLEMENTE dans l'éditeur | `SvgEditorRoute.tsx:296-299`, `SvgEditorRoute.tsx:1535-1565` | Seule possibilité : attacher le comportement `vertebral-precision` à une catégorie. Aucune notion de vertèbre, de région ou de formule | | Gérer les zones bilatérales | Implémenté au niveau attribut | `SvgEditorRoute.tsx:1159-1163` | `data-anno-lateral="bilateral"`. Aucun dessin miroir, aucune paire gauche/droite | | Gérer les cas particuliers | Implémenté partiellement | `SvgEditorRoute.tsx:1535-1565` | `data-anno-special` libre, par catégorie, saisi via `prompt()` | | Sauvegarder le résultat | Implémenté, téléchargement uniquement | `SvgEditorRoute.tsx:1823-1849` | Sérialisation + téléchargement `_edited.svg`. Aucune écriture dans `public/` | ## 3. Chargement ### 3.1 Écran d'accueil FACTUEL `SvgEditorRoute.tsx:333-403`. Deux onglets : - `SVG du projet` (`buildProjectPicker`, `SvgEditorRoute.tsx:405-465`) : liste les espèces via `getAllSpecies()` du registre, puis pour l'espèce choisie une vue `Corps entier` (`mainSvg`) et une vue `Détail : ` par entrée de `details`. Le fichier est récupéré par `fetch(svgPath)`. Le nom de téléchargement devient `_edited.svg` (`SvgEditorRoute.tsx:452-453`). - `Importer un fichier` (`buildUploadPicker`, `SvgEditorRoute.tsx:467-481`) : input file `.svg` ou drag-and-drop sur le canvas (`SvgEditorRoute.tsx:483-507`). ### 3.2 `sanitizeSvg` FACTUEL `SvgEditorRoute.tsx:511-520`. Retire `