Rules

// either remove it, make it private, or add
// a loam-ignore directive with a reason:
// loam-ignore: unused-public-exports – re-exported via barrel

// kept and used:
class ActiveHelper {
  static String format(String s) => s.trim();
}

// Extract shared types into a third library
// lib/shared.dart  (no imports from a or b)
// lib/a.dart  imports shared.dart
// lib/b.dart  imports shared.dart

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

// both features import the shared helper
// loam-ignore: code-duplicates – intentional symmetry

// split into focused, testable 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 provides the primary accessible label
TextField(
  decoration: InputDecoration(labelText: 'Email address'),
)

// hintText accepted as fallback (e.g. search fields)
TextField(
  decoration: InputDecoration(hintText: 'Search…'),
)

// or wrap with Semantics for custom label delivery
Semantics(
  label: 'Email address',
  child: TextField(),
)

// describe what the image conveys
Image.asset('assets/hero.png',
  semanticLabel: 'App hero illustration')

// purely decorative: opt out explicitly
Image.asset('assets/divider.png',
  excludeFromSemantics: true)

// tooltip provides the accessible name
IconButton(
  icon: Icon(Icons.close),
  tooltip: 'Close',
  onPressed: () => Navigator.pop(context),
)

// or wrap with Semantics for GestureDetector/InkWell
Semantics(
  label: 'Delete item',
  child: GestureDetector(
    child: Icon(Icons.delete),
    onTap: () => deleteItem(),
  ),
)

// wrap with Semantics to give it an accessible name
Semantics(
  label: 'Show item details',
  button: true,
  child: CustomCard(
    onTap: () => showDetails(item),
  ),
)

// or ensure the widget carries a label-providing property
ActionChip(
  label: Text('Do action'),
  onPressed: () => doAction(),
)

// log and rethrow — preserves context
try {
  await fetchData();
} catch (e, st) {
  log('fetchData failed', error: e, stackTrace: st);
  rethrow;
}

// or wrap in a domain error
try {
  await fetchData();
} catch (e) {
  throw DataLoadException(cause: e);
}

// inline reason: tells reviewers why the suppress is intentional
// ignore: avoid_print – CLI output path, not a debug statement
print('done.');

// reason on the line above is also accepted
// Suppress: this file predates null-safety and is scheduled for migration.
// ignore_for_file: avoid_print

class MyWidget extends StatelessWidget {
  // Renders as a zero-size placeholder during the loading phase.
  @override
  Widget build(BuildContext context) => const SizedBox();

  const MyWidget();
}