dart-language

Dart Language Patterns

Priority: P0 (CRITICAL)

Implementation Guidelines

• Null Safety: Avoid !. Use ?., ??, or short-circuiting. Use late only if necessary.
• Immutability: Use final for all variables. Use @freezed for data classes.
• Pattern Matching (3.x): Use switch (value) with patterns and destructuring.
• Records: Use a Record (e.g., (String, int)) for multiple values; use named fields when meaning matters. Destructure at call sites: final (error, data) = fetchUser();.
• Sealed Classes: Use sealed class for exhaustive state handling in domain logic.
• Extensions: Use extension to add utility methods to third-party types.
• Wildcards (3.7+): Use _ for unused variables in declarations and patterns.
• Tear-offs: Prefer using tear-offs (e.g., list.forEach(print)) over anonymous lambdas (e.g., list.forEach((e) => print(e))).
• Asynchrony: Prefer async/await over raw Future.then. Use unawaited for fire-and-forget logic if necessary.
• Encapsulation: Use _ prefix for library-private members. Prefer final properties.
• Collections: Use collection-if, collection-for, and spread operators ....
• Safe List Access: Prefer .firstOrNull, .lastOrNull, or .elementAtOrNull(i).
• No dynamic: Use Object or generics instead of dynamic.
• Type Aliases: Use typedef for complex IDs or callbacks.

Anti-Patterns

• No ! Operator: not use bang operator ! unless you can prove value non-null via if or assert.
• No var for members: not use var for class members; use final or explicit types.
• No logic in constructors: not perform complex calculations or async work inside constructors.
• No zero-arg methods for pure computations: Use a getter. int get invoiceType => not int toInvoiceType().
• No generic conversion names: Name value-object converters for their target context: get apiFilterType not get invoiceType.

Code