fix: beim Gott-Datei-Split verlorene Erklärkommentare wiederhergestellt

Qualitäts-Review-Befund (a): Alle 6 part/part-of-Aufteilungen hatten Code
vollständig übernommen (Zeilen-Multiset-Vergleich Original vs. heutiger
Stand: keine Code-Zeile verloren, keine hinzugefügt), ABER erklärende
Kommentare über den Klassen gingen verloren (24 Blöcke, u. a. die
HTML-Subset-Doku über _MatrixHtmlText, die Selbst-Aussperr-Warnung über
updatePowerLevelsSafely, TURN-Verbrauchskarte, PDF-Cache/Viewer-Doku).
Alle an den richtigen Klassen wiederhergestellt; reine Trennlinien und
ALL-CAPS-Abschnittslabels bewusst nicht (Gott-Datei-Navigation, durch
die neuen Dateinamen ersetzt).

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

lib/features/chat/message/message_group_core.dart

@@ -6,6 +6,7 @@ String _formatMessageTime(DateTime t) {
   return '$h:$m';
 }
 
+// Wraps a group of consecutive messages from the same sender
 class MessageGroup extends StatefulWidget {
   final List<Event> events;
   final String currentUserId;
@@ -304,6 +305,8 @@ class _MessageGroupState extends State<MessageGroup> {
   }
 }
 
+// Shown under a message whose send failed (e.g. offline) — keeps the message
+// visible with retry / delete instead of letting it silently disappear.
 class _SendFailedRow extends StatelessWidget {
   final Event event;
   final PyramidTheme pt;
@@ -346,6 +349,7 @@ class _SendFailedRow extends StatelessWidget {
       );
 }
 
+// Single message (first in group) with full avatar + name shown
 class _MessageBody extends StatelessWidget {
   final Event event;
   final PyramidTheme pt;
@@ -374,6 +378,7 @@ class _MessageBody extends StatelessWidget {
   }
 }
 
+// Continuation message — no avatar, just indented text with timestamp on hover
 class _ContinuationMessage extends StatefulWidget {
   final Event event;
   final PyramidTheme pt;

lib/features/chat/message/message_media.dart

@@ -155,6 +155,7 @@ Size? _reservedImageSize(Event event, {required double maxW, required double max
   return Size(w * scale, h * scale);
 }
 
+// Downloads media bytes then hands off to PyramidAudioPlayer / PyramidVideoPlayer
 class _AudioContent extends ConsumerStatefulWidget {
   final Event event;
   final PyramidTheme pt;
@@ -433,6 +434,7 @@ class _MediaContentState extends ConsumerState<_MediaContent> {
       _mediaFallback(pt, error, widget.event.body);
 }
 
+// Downloads bytes for a PDF/SVG file and shows PdfInlinePreview or SvgImage.
 class _DocPreviewContent extends ConsumerStatefulWidget {
   final Event event;
   final PyramidTheme pt;
@@ -572,6 +574,8 @@ class _DocPreviewContentState extends ConsumerState<_DocPreviewContent> {
   }
 }
 
+// Inline card for proprietary formats — shows immediately from event metadata,
+// downloads lazily only when the user taps or hits the download button.
 class _ProprietaryInlineCard extends ConsumerStatefulWidget {
   final Event event;
   final PyramidTheme pt;
@@ -953,6 +957,9 @@ String _classifyMediaError(Object e) {
   return 'Download fehlgeschlagen';
 }
 
+// Thin wrapper over the shared MediaCache so document previews share the same
+// LRU byte budget as chat images (keeps the last-viewed media instantly
+// available, evicts the oldest).
 class _DocBytesCache {
   static Uint8List? get(String eventId) => MediaCache.instance.get(eventId);
   static void put(String eventId, Uint8List bytes) =>

lib/features/chat/message/message_shared.dart

@@ -89,6 +89,8 @@ class _InitialBox extends StatelessWidget {
   }
 }
 
+// Inline "Neue Nachrichten" divider rendered inside a MessageGroup when the
+// fullyRead event is in the middle of the group (same sender, <5 min window).
 class _InlineUnreadDivider extends StatelessWidget {
   final PyramidTheme pt;
   const _InlineUnreadDivider({required this.pt});
@@ -114,6 +116,7 @@ class _InlineUnreadDivider extends StatelessWidget {
   }
 }
 
+// Date divider between message groups
 class DateDivider extends StatelessWidget {
   final DateTime date;
 
@@ -183,6 +186,8 @@ class _MessageStatus extends StatelessWidget {
   }
 }
 
+// Read receipt: a ✓✓ shown at the partner's last-read message (any sender),
+// so it moves next to their own message when they reply.
 class _ReadMarker extends StatelessWidget {
   final PyramidTheme pt;
   const _ReadMarker({required this.pt});

lib/features/chat/message/message_text.dart

@@ -186,6 +186,18 @@ class _MessageContent extends StatelessWidget {
   }
 }
 
+// Handles the subset of HTML that Matrix clients emit in formatted_body:
+//   <b>/<strong>  → bold
+//   <i>/<em>      → italic
+//   <del>/<s>     → strikethrough
+//   <u>           → underline
+//   <code>        → monospace, slightly different background
+//   <a href>      → tappable link (url_launcher)
+//   <br>          → newline
+//   HTML entities → decoded
+//   Anything else → text content preserved, tags stripped
+//
+// Note: <pre> and <blockquote> are simplified (rendered as indented code/text).
 class _MatrixHtmlText extends StatelessWidget {
   final String html;
   final TextStyle baseStyle;