Formatierter Text mit Werkzeugleiste und HTML-Ansicht (Schema v12)

Textblöcke dürfen ab v12 Auszeichnung tragen: fett, kursiv,
unterstrichen, durchgestrichen, Code, hervorgehoben, hoch- und
tiefgestellt, Absätze, Listen und Links.

Die Entscheidung, was erlaubt ist, fällt auf dem Server beim
Speichern - nicht im Editor und nicht beim Rendern. Was in der
Datenbank landet, ist damit schon sicher, also kann kein Renderer das
Filtern vergessen, und eine manipulierte Anfrage speichert nichts,
was der Editor nicht anbietet.

Nicht erlaubte Elemente werden ausgepackt, nicht gelöscht: der Text
bleibt, nur die Auszeichnung geht. script, style, iframe und
Verwandte verschwinden samt Inhalt, weil Auspacken ihren Code als
Text sichtbar machen würde. Attribute fallen weg außer href an a,
und auch das nur nach Adressprüfung.

Ausgegeben wird formatierter Text nur ab v12, dann in einem div statt
einem p, weil die Positivliste Absätze und Listen enthält. Ältere
Dokumente behalten Klartextsemantik und werden weiter maskiert.

Eine Inkonsistenz nebenbei behoben: ein Text mit einem < behielt
echte Zeilenumbrüche, während alles andere <br> benutzte.

Geprüft: 182 PHP-Tests / 685 Assertions unter PHP 8.2.12 und 8.4.22,
darunter dreizehn Fälle durch den Filter mit acht Angriffen, dazu
Editortest mit axe und öffentliche Browserprüfung. Die Werkzeugleiste
selbst ist nicht bedient und nicht mit einem Screenreader geprüft.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

src/Content/PartialRepository.php

@@ -23,7 +23,7 @@ final class PartialRepository
     /** A linked section may itself link one, but not deeper – and never in a circle. */
     public const MAX_NESTING = 3;
 
-    public function __construct(private Connection $db, private DocumentValidator $validator)
+    public function __construct(private Connection $db, private DocumentValidator $validator, private RichText $richText = new RichText())
     {
     }
 
@@ -79,6 +79,7 @@ final class PartialRepository
         if ('section' !== $kind && null !== $this->findByKind($kind, 'default', $locale)) {
             throw new InvalidPage(sprintf('Es gibt bereits einen %s.', self::KINDS[$kind]));
         }
+        $document = $this->richText->normaliseDocument($document);
         $this->validator->validate($document, false);
         if (null !== $this->findByKind($kind, $slug, $locale)) {
             throw new InvalidPage(sprintf('„%s“ ist als Adresse bereits vergeben.', $slug));
@@ -96,6 +97,7 @@ final class PartialRepository
 
     public function save(string $id, array $document, int $expectedVersion): void
     {
+        $document = $this->richText->normaliseDocument($document);
         $this->validator->validate($document, false);
         $this->db->transactional(function () use ($id, $document, $expectedVersion): void {
             // A section must not end up containing itself, directly or through another section.