Rules

// entweder entfernen, privat machen oder
// mit Begründung unterdrücken:
// loam-ignore: unused-public-exports – re-exported via barrel

// genutzt und behalten:
class ActiveHelper {
  static String format(String s) => s.trim();
}

// Gemeinsame Typen in eine dritte Bibliothek auslagern:
// lib/shared.dart  (importiert weder a noch b)
// lib/a.dart  importiert shared.dart
// lib/b.dart  importiert shared.dart

// lib/shared/date_format.dart
String formatDate(DateTime d) =>
    '${d.day}.${d.month}.${d.year}';

// beide Features importieren den gemeinsamen Helper
// loam-ignore: code-duplicates – bewusste Symmetrie

// aufgeteilt in fokussierte, testbare Helpers
Future<void> syncData(List<Item> items) async {
  final candidates = items.where(_needsSync);
  await Future.wait(candidates.map(_syncOne));
}

Future<void> _syncOne(Item item) async { … }

// labelText liefert das primäre zugängliche Label
TextField(
  decoration: InputDecoration(labelText: 'E-Mail-Adresse'),
)

// hintText als Fallback (z. B. Suchfelder)
TextField(
  decoration: InputDecoration(hintText: 'Suchen…'),
)

// oder mit Semantics umschließen
Semantics(
  label: 'E-Mail-Adresse',
  child: TextField(),
)

// beschreibt, was das Bild vermittelt
Image.asset('assets/hero.png',
  semanticLabel: 'App-Hero-Illustration')

// rein dekorativ: explizit ausschließen
Image.asset('assets/divider.png',
  excludeFromSemantics: true)

// tooltip liefert den zugänglichen Namen
IconButton(
  icon: Icon(Icons.close),
  tooltip: 'Schließen',
  onPressed: () => Navigator.pop(context),
)

// oder mit Semantics für GestureDetector/InkWell wrappen
Semantics(
  label: 'Element löschen',
  child: GestureDetector(
    child: Icon(Icons.delete),
    onTap: () => deleteItem(),
  ),
)

// mit Semantics umschließen, um einen zugänglichen Namen zu geben
Semantics(
  label: 'Details anzeigen',
  button: true,
  child: CustomCard(
    onTap: () => showDetails(item),
  ),
)

// oder ein Widget wählen, das label nativ unterstützt
ActionChip(
  label: Text('Aktion ausführen'),
  onPressed: () => doAction(),
)

// loggen und weiterwerfen — Kontext bleibt erhalten
try {
  await fetchData();
} catch (e, st) {
  log('fetchData fehlgeschlagen', error: e, stackTrace: st);
  rethrow;
}

// oder in einen Domain-Error einwickeln
try {
  await fetchData();
} catch (e) {
  throw DataLoadException(cause: e);
}

// Inline-Begründung: erklärt Reviewern, warum die Unterdrückung beabsichtigt ist
// ignore: avoid_print – CLI-Ausgabepfad, kein Debug-Statement
print('done.');

// Begründung in der Zeile darüber wird ebenfalls akzeptiert
// Unterdrückung: Diese Datei stammt aus vor Null-Safety und ist für die Migration vorgesehen.
// ignore_for_file: avoid_print

class MyWidget extends StatelessWidget {
  // Rendert als Platzhalter mit der Größe 0 während der Ladephase.
  @override
  Widget build(BuildContext context) => const SizedBox();

  const MyWidget();
}