Audit complet de mise en forme — Image (2e élément du tableau)

Implémente toutes les options manquantes identifiées pour l'élément Image : dimensionnement/ratio/object-fit, filtres CSS, upload de fichier (en plus de l'URL), lien/plein écran au clic, chargement différé, légende, et tous les attributs de boîte partagés déjà créés pour Titre/Paragraphe (padding/margin/fond/bordure/ombre/opacité/ position du bloc). Système de pages : un support peut désormais avoir 0 page (un nouveau support démarre vide), suppression de toutes les pages en un clic, et la pagination automatique insère intelligemment la nouvelle page juste après celle qui déborde plutôt qu'en toute fin de liste. Bugs réels trouvés et corrigés en cours de route : le style de bloc (dont align-self) ciblait l'élément interne au lieu de son enveloppe (légende/lien) ; une image à sa taille native pouvait déclencher une pagination infinie ; upload/mise à jour d'attribut ne déclenchaient jamais le contrôle de débordement. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-26 12:06:44 +02:00
parent 6c7675fad0
commit 9ad50c58b8
27 changed files with 1299 additions and 174 deletions
@@ -0,0 +1,16 @@
+from db.supports import connect_support, ensure_document_pages_schema
+
+
+def delete_all_document_pages(slug: str) -> None:
+    """Supprime toutes les pages d'un support d'un coup (retour
+    utilisateur : "une option dans page pour supprimer toute les page
+    d'un coup") — CASCADE (contrainte FK, voir create_support.py) retire
+    aussi tous les éléments de contenu du support. Résultat : un support
+    à 0 page, état volontairement valide (voir list_document_pages.py) ;
+    l'utilisateur repart d'un éditeur vide comme un support neuf."""
+    ensure_document_pages_schema(slug)
+    conn = connect_support(slug)
+    conn.execute("DELETE FROM _document_elements")
+    conn.execute("DELETE FROM _document_pages")
+    conn.commit()
+    conn.close()
@@ -7,8 +7,9 @@ def list_document_pages(slug: str) -> list[dict[str, Any]]:
    """Toutes les pages d'un support, triées par order_index — la bande
    d'onglets du panneau Propriétés (voir static/document/js/
    document-editor.js) et le sélecteur de page du Mode Aperçu en dérivent
-    directement. Un support a toujours au moins une page (voir
-    db/supports/create_support.py / ensure_document_pages_schema)."""
+    directement. Peut renvoyer une liste VIDE (retour utilisateur : un
+    support neuf, ou vidé via "Supprimer toutes les pages", s'ouvre sans
+    aucune page — voir routes/document/document_edit.py, qui gère ce cas)."""
    ensure_document_pages_schema(slug)
    conn = connect_support(slug)
    rows = conn.execute("SELECT * FROM _document_pages ORDER BY order_index").fetchall()
@@ -4,13 +4,21 @@ CRUD des pages d'un support de formation (`_document_pages`, voir
 `db/supports/create_support.py`) — retour utilisateur du 21/09/2026:
 "il faut implémenter un système de page". Un support est désormais
 composé de plusieurs pages, chacune portant son propre flux d'éléments
-(voir `document_engine/elements/`, filtré par `page_id`). Un support a
-TOUJOURS au moins une page (`create_support` en crée une par défaut,
-`ensure_document_pages_schema` en garantit une pour les supports plus
-anciens) — la garde "jamais supprimer la dernière page" est un
-garde-fou métier posé par l'appelant (voir
-`routes/document/document_page_delete.py`), pas une contrainte de ce
-paquet.
+(voir `document_engine/elements/`, filtré par `page_id`).
+
+**Un support peut avoir 0 page** (retour utilisateur du 26/09/2026 :
+"l'éditeur ne dois plus etre obliger d'avoir une page active ou créer,
+il peut etre ouvert sans aucune page") — `create_support` n'en crée plus
+aucune par défaut, et `ensure_document_pages_schema` ne recrée plus
+"Page 1" dès que la table est vide (seule exception : la migration
+ponctuelle et historique d'un support pré-pages qui avait déjà des
+éléments sans `page_id`). `routes/document/document_edit.py` et le
+frontend (`static/document/js/document-editor.js`) gèrent explicitement
+cet état "aucune page" (pas de page active, canevas vide avec une
+invite à en créer une). La garde "jamais supprimer la dernière page" a
+été retirée du côté route (voir `delete_all_document_pages` ci-dessous
+et `routes/document/document_page_delete.py`) : ce paquet n'a jamais
+posé cette contrainte lui-même.

 ## `add_document_page(slug: str, title: str | None = None) -> int`
 Ajoute une page en fin de la bande d'onglets. `title` par défaut :
@@ -87,9 +95,18 @@ Supprime une page ET ses éléments (`DELETE FROM _document_elements
 WHERE page_id = ?` explicite — la contrainte `FOREIGN KEY ... ON DELETE
 CASCADE` n'existe que pour les supports créés après l'ajout des pages,
 voir `db/supports/ensure_document_pages_schema.py` pour les anciens).
-Ne refuse JAMAIS de supprimer la dernière page restante — cette règle
-est posée par l'appelant, pas par cette fonction bas niveau (même
-découpage que `routes/game/screens/screen_delete.py` côté jeu, où le
-garde-fou vit aussi dans la route).
+Ne refuse JAMAIS de supprimer la dernière page restante — un support à
+0 page est un état valide (voir plus haut).
+- **Retour** : aucun.
+- **Exceptions** : aucune.
+
+## `delete_all_document_pages(slug: str) -> None`
+Supprime TOUTES les pages du support d'un coup, et tous leurs éléments
+de contenu avec elles (retour utilisateur : "une option dans page pour
+supprimer toute les page d'un coup") — action destructive et
+irréversible côté serveur, jamais appelée sans confirmation explicite
+côté client (voir `static/document/js/document-editor.js`,
+`forgeDocDeleteAllPages`). Le support se retrouve à 0 page, exactement
+comme un support neuf.
 - **Retour** : aucun.
 - **Exceptions** : aucune.
@@ -29,11 +29,10 @@ def replace_document_content(slug: str, seed_pages: list[dict[str, Any]]) -> Non
    element_default_attributes(kind) (jamais un remplacement brut) pour
    rester valides même si `seed_pages` n'en précise qu'une partie."""
    # Les nouvelles pages sont créées AVANT de supprimer les anciennes
-    # (jamais l'inverse) : passer par zéro page, même un court instant,
-    # déclenche le filet de sécurité de ensure_document_pages_schema (un
-    # support a TOUJOURS au moins une page), qui recréerait une "Page 1"
-    # vide juste avant l'ajout de la première page du thème — bug réel
-    # rencontré en écrivant les tests de cette fonction.
+    # (jamais l'inverse) : ça évite que le support affiche un état "0 page"
+    # transitoire pendant le remplacement (même si 0 page est désormais un
+    # état par ailleurs valide, voir list_document_pages.py — ce n'est
+    # qu'une question d'ordre d'écriture ici, plus un filet de sécurité).
    old_page_ids = [page["id"] for page in list_document_pages(slug)]
    for seed_page in seed_pages:
        page_id = add_document_page(slug)