+feat: Add more annotations

Author: robmllze

lib/src/annotations/must_await_all_futures_annotation.dart

@@ -10,6 +10,13 @@
 // ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
 //.title~
 
+const mustAwaitAllFuturesOrError = MustAwaitAllFuturesOrErrorAnnotation();
+
+/// The class that enables the `@mustAwaitAllFuturesOrError` annotation.
+final class MustAwaitAllFuturesOrErrorAnnotation {
+  const MustAwaitAllFuturesOrErrorAnnotation();
+}
+
 const mustAwaitAllFutures = MustAwaitAllFuturesAnnotation();
 
 /// The class that enables the `@mustAwaitAllFutures` annotation.

lib/src/annotations/must_be_anonymous_annotation.dart

@@ -10,9 +10,16 @@
 // ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
 //.title~
 
-const mustBeAnonymousAnnotation = MustBeAnonymousAnnotation();
+const mustBeAnonymous = MustBeAnonymousAnnotation();
 
-/// The class that enables the `@mustBeAnonymousAnnotation` annotation.
+/// The class that enables the `@mustBeAnonymous` annotation.
 final class MustBeAnonymousAnnotation {
   const MustBeAnonymousAnnotation();
 }
+
+const mustBeAnonymousOrError = MustBeAnonymousOrErrorAnnotation();
+
+/// The class that enables the `@mustBeAnonymousOrError` annotation.
+final class MustBeAnonymousOrErrorAnnotation {
+  const MustBeAnonymousOrErrorAnnotation();
+}

lib/src/annotations/must_be_strict_annotation.dart

@@ -10,9 +10,16 @@
 // ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
 //.title~
 
-const mustBeStrictAnnotation = MustBeStrictAnnotation();
+const mustBeStrictOrError = MustBeStrictOrErrorAnnotation();
 
-/// The class that enables the `@mustBeStrictAnnotation` annotation.
+/// The class that enables the `@mustBeStrictOrError` annotation.
+final class MustBeStrictOrErrorAnnotation {
+  const MustBeStrictOrErrorAnnotation();
+}
+
+const mustBeStrict = MustBeStrictAnnotation();
+
+/// The class that enables the `@mustBeStrict` annotation.
 final class MustBeStrictAnnotation {
   const MustBeStrictAnnotation();
 }

lib/src/annotations/must_handle_return_annotation.dart

@@ -10,42 +10,16 @@
 // ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
 //.title~
 
-/// An annotation used to mark a function whose return value must be handled.
-///
-/// When a function is annotated with `@mustHandleReturn`, the Dart static
-/// analyzer will issue a warning if the function is called and its return value
-/// is not used (i.e., not assigned to a variable, passed to another function,
-/// or used in an expression).
-///
-/// This is particularly useful for functions that return a `Result`, `Option`,
-/// or `Resolvable` where ignoring the result can lead to unhandled errors or
-/// unexpected behavior.
-///
-/// ### Example
-///
-/// ```dart
-/// @mustHandleReturn
-/// Result<int> safeDivide(int a, int b) {
-///   if (b == 0) {
-///     return Err('Cannot divide by zero');
-///   }
-///   return Ok(a ~/ b);
-/// }
-///
-/// void main() {
-///   // GOOD: The result is handled.
-///   final result = safeDivide(10, 2);
-///   result.ifOk((ok) => print('Result: ${ok.value}'));
-///
-///   // BAD: This will trigger a lint warning because the Result is discarded.
-///   safeDivide(10, 0);
-/// }
-/// ```
-@Deprecated('Use @useResult instead.')
+const mustHandleReturnOrError = MustHandleReturnAnnotation();
+
+/// The class that enables the `@mustHandleReturnOrError` annotation.
+final class MustHandleReturnOrErrorAnnotation {
+  const MustHandleReturnOrErrorAnnotation();
+}
+
 const mustHandleReturn = MustHandleReturnAnnotation();
 
 /// The class that enables the `@mustHandleReturn` annotation.
-@Deprecated('Use @useResult instead.')
 final class MustHandleReturnAnnotation {
   const MustHandleReturnAnnotation();
 }

lib/src/annotations/no_futures_allowed_annotation.dart

@@ -10,6 +10,13 @@
 // ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
 //.title~
 
+const noFuturesAllowedOrError = NoFuturesAllowedOrErrorAnnotation();
+
+/// The class that enables the `@noFuturesAllowedOrError` annotation.
+final class NoFuturesAllowedOrErrorAnnotation {
+  const NoFuturesAllowedOrErrorAnnotation();
+}
+
 const noFuturesAllowed = NoFuturesAllowedAnnotation();
 
 /// The class that enables the `@noFuturesAllowed` annotation.

pubspec.yaml

@@ -12,7 +12,7 @@
 
 name: df_safer_dart_annotations
 description: Annotations for the df_safer_dart_lints package.
-version: 0.1.2
+version: 0.1.3
 homepage: https://dev-cetera.com/
 repository: https://github.com/dev-cetera/df_safer_dart_annotations
 funding: