Release v9.1.1: Rename filter and add GlobalErrorFilter

Improvements:
- Renamed FirstLocalThenGlobalErrorFilter to GlobalIfNoLocalErrorFilter for better clarity
- Name now clearly indicates "global if no local handler" behavior

New Features:
- Added GlobalErrorFilter that routes errors ONLY to global handler
- Returns ErrorReaction.globalHandler (not firstLocalThenGlobal)
- Useful when you want all errors to go global regardless of local listeners

Fixes:
- Removed incorrectly deprecated GlobalErrorFilter from v9.1.0
- Replaced with correct implementation

Tests:
- Added test for GlobalErrorFilter behavior
- All 38 tests passing

Author: escamoteur

CHANGELOG.md

@@ -1,3 +1,17 @@
+[9.1.1] - 2025-11-21
+
+### Improvements
+
+- **Renamed GlobalIfNoLocalErrorFilter**: Renamed `FirstLocalThenGlobalErrorFilter` to `GlobalIfNoLocalErrorFilter` for better clarity. The name now clearly indicates "global if no local handler".
+
+### New Features
+
+- **Added GlobalErrorFilter**: New filter that routes errors ONLY to the global handler, regardless of local listeners. Returns `ErrorReaction.globalHandler`.
+
+### Fixes
+
+- **Removed incorrectly named GlobalErrorFilter**: The previous `GlobalErrorFilter` that was deprecated in v9.1.0 has been removed and replaced with the correct implementation.
+
 [9.1.0] - 2025-11-21
 
 ### New Features
@@ -45,9 +59,9 @@ class MyApp extends WatchingWidget {
 - **Improved ErrorFilter class naming consistency**: Renamed `ErrorHandler*` classes to simpler `*ErrorFilter` pattern to better align with existing filters. Old names remain functional with deprecation warnings until v10.0.0.
 
 **Class name changes:**
-- `ErrorHandlerGlobalIfNoLocal` → `GlobalErrorFilter` (deprecated)
+- `ErrorHandlerGlobalIfNoLocal` → `GlobalIfNoLocalErrorFilter` (deprecated)
 - `ErrorHandlerLocal` → `LocalErrorFilter` (deprecated)
-- `ErrorHandlerLocalAndGlobal` → `LocalAndGlobalErrorFilter` (deprecated)
+- `ErrorHandlerLocalAndGlobal` → `LocalAndGlobalIfNoLocalErrorFilter` (deprecated)
 
 **Why this change:**
 - Better naming consistency: matches `TableErrorFilter` and `PredicatesErrorFilter` pattern
@@ -62,7 +76,7 @@ Command.errorFilterDefault = const ErrorHandlerGlobalIfNoLocal();
 errorFilter: const ErrorHandlerLocal()
 
 // New
-Command.errorFilterDefault = const GlobalErrorFilter();
+Command.errorFilterDefault = const GlobalIfNoLocalErrorFilter();
 errorFilter: const LocalErrorFilter()
 ```
 

CLAUDE.md

@@ -133,16 +133,16 @@ Every Command exposes multiple `ValueListenable` interfaces for different aspect
 - `throwIfNoLocalHandler`: Throw if no local listeners
 
 **Built-in ErrorFilter implementations**:
-- `ErrorHandlerGlobalIfNoLocal`: Default behavior
-- `ErrorHandlerLocal`: Local only
-- `ErrorHandlerLocalAndGlobal`: Both handlers
+- `GlobalIfNoLocalErrorFilter`: Default behavior
+- `LocalErrorFilter`: Local only
+- `LocalAndGlobalIfNoLocalErrorFilter`: Both handlers
 - `TableErrorFilter`: Map error types to reactions
 - `PredicatesErrorFilter`: Chain of predicate functions
 - `ErrorFilterExcemption<T>`: Special handling for specific type
 
 **Global configuration**:
 ```dart
-Command.errorFilterDefault = const ErrorHandlerGlobalIfNoLocal();
+Command.errorFilterDefault = const GlobalIfNoLocalErrorFilter();
 Command.globalExceptionHandler = (error, stackTrace) { /* log */ };
 Command.assertionsAlwaysThrow = true; // AssertionErrors bypass filters
 Command.reportAllExceptions = false; // Override filters, report everything

README.md

@@ -159,7 +159,7 @@ Declarative error routing with filters:
 - **[Global Handler](https://flutter-it.dev/documentation/command_it/error_handling#global-handler)** — App-wide error handling
 - **[Global Errors Stream](https://flutter-it.dev/documentation/command_it/global_configuration#globalerrors)** — Reactive monitoring of all globally-routed errors
 - **[Error Filters](https://flutter-it.dev/documentation/command_it/error_filters)** — Route errors by type or predicate
-- **[Built-in Filters](https://flutter-it.dev/documentation/command_it/error_filters#built-in-filters)** — GlobalErrorFilter, PredicatesErrorFilter, etc.
+- **[Built-in Filters](https://flutter-it.dev/documentation/command_it/error_filters#built-in-filters)** — GlobalIfNoLocalErrorFilter, PredicatesErrorFilter, etc.
 
 ### Advanced Features
 

example/pubspec.lock

@@ -39,7 +39,7 @@ packages:
       path: ".."
       relative: true
     source: path
-    version: "9.0.2"
+    version: "9.1.1"
   flutter:
     dependency: "direct main"
     description: flutter

lib/command_it.dart

@@ -554,7 +554,7 @@ abstract class Command<TParam, TResult> extends CustomValueNotifier<TResult> {
 
   /// if no individual ErrorFilter is set when creating a Command
   /// this filter is used in case of an error
-  static ErrorFilter errorFilterDefault = const GlobalErrorFilter();
+  static ErrorFilter errorFilterDefault = const GlobalIfNoLocalErrorFilter();
 
   /// `AssertionErrors` are almost never wanted in production, so by default
   /// they will dirextly be rethrown, so that they are found early in development

lib/error_filters.dart

@@ -64,8 +64,8 @@ class ErrorFilerConstant implements ErrorFilter {
 
 /// Error filter that routes errors to global handler if no local handler is present.
 /// This is the default error filter for all commands.
-class GlobalErrorFilter implements ErrorFilter {
-  const GlobalErrorFilter();
+class GlobalIfNoLocalErrorFilter implements ErrorFilter {
+  const GlobalIfNoLocalErrorFilter();
   @override
   ErrorReaction filter(Object error, StackTrace stackTrace) {
     return ErrorReaction.firstLocalThenGlobalHandler;
@@ -91,10 +91,10 @@ class LocalAndGlobalErrorFilter implements ErrorFilter {
 }
 
 /// @nodoc
-/// Deprecated: Use [GlobalErrorFilter] instead.
+/// Deprecated: Use [GlobalIfNoLocalErrorFilter] instead.
 /// Will be removed in v10.0.0
 @Deprecated(
-  'Use GlobalErrorFilter instead. '
+  'Use GlobalIfNoLocalErrorFilter instead. '
   'Will be removed in v10.0.0',
 )
 class ErrorHandlerGlobalIfNoLocal implements ErrorFilter {
@@ -105,6 +105,17 @@ class ErrorHandlerGlobalIfNoLocal implements ErrorFilter {
   }
 }
 
+/// Error filter that routes errors only to the global handler.
+/// Use this when you want all errors to go to the global handler,
+/// regardless of whether there are local listeners.
+class GlobalErrorFilter implements ErrorFilter {
+  const GlobalErrorFilter();
+  @override
+  ErrorReaction filter(Object error, StackTrace stackTrace) {
+    return ErrorReaction.globalHandler;
+  }
+}
+
 /// @nodoc
 /// Deprecated: Use [LocalErrorFilter] instead.
 /// Will be removed in v10.0.0

pubspec.yaml

@@ -1,6 +1,6 @@
 name: command_it
 description: command_it is a way to manage your state based on `ValueListenable` and the `Command` design pattern. It is a rebranding of flutter_command.
-version: 9.1.0
+version: 9.1.1
 homepage: https://github.com/flutter-it/command_it
 
 screenshots:

test/error_test.dart

@@ -140,8 +140,8 @@ void main() {
     });
 
     // Tests for new ErrorFilter classes
-    test('GlobalErrorFilter', () {
-      const filter = GlobalErrorFilter();
+    test('GlobalIfNoLocalErrorFilter', () {
+      const filter = GlobalIfNoLocalErrorFilter();
 
       expect(
         filter.filter(Error(), StackTrace.current),
@@ -153,6 +153,19 @@ void main() {
       );
     });
 
+    test('GlobalErrorFilter', () {
+      const filter = GlobalErrorFilter();
+
+      expect(
+        filter.filter(Error(), StackTrace.current),
+        ErrorReaction.globalHandler,
+      );
+      expect(
+        filter.filter(Exception(), StackTrace.current),
+        ErrorReaction.globalHandler,
+      );
+    });
+
     test('LocalErrorFilter', () {
       const filter = LocalErrorFilter();
 
@@ -708,7 +721,7 @@ void main() {
       final cmd = Command.createAsyncNoParam(
         () async => throw Exception('Test error'),
         initialValue: null,
-        errorFilter: const GlobalErrorFilter(),
+        errorFilter: const GlobalIfNoLocalErrorFilter(),
       );
 
       await cmd.runAsync().catchError((_) {});
@@ -774,7 +787,7 @@ void main() {
       final globalCmd = Command.createAsyncNoParam(
         () async => throw Exception('Global error'),
         initialValue: null,
-        errorFilter: const GlobalErrorFilter(),
+        errorFilter: const GlobalIfNoLocalErrorFilter(),
       );
 
       await globalCmd.runAsync().catchError((_) {});