v9.0.2: Fix deprecation of ExecuteInsteadHandler and ifRestrictedExecuteInstead

Properly deprecated ExecuteInsteadHandler typedef and ifRestrictedExecuteInstead
parameters instead of breaking renames. Both old and new names now work during v9.x
with deprecation warnings.

Changes:
- Added deprecated ExecuteInsteadHandler typedef pointing to RunInsteadHandler
- Updated all 12 factory methods to accept both old and new parameter names
- Updated all command constructors to support both parameters
- Added assertions to prevent both parameters being provided simultaneously
- Added comprehensive test coverage for all deprecated variants (19 tests)
- Updated fix_data.yaml with note about typedef migration
- Added file-level ignore for deprecated_member_use_from_same_package

Migration: Users can run `dart fix --apply` to auto-migrate to new parameter names.

Author: escamoteur

CHANGELOG.md

@@ -1,3 +1,9 @@
+[9.0.2] - 2025-11-15
+
+### Fixes
+
+- **Properly deprecated ExecuteInsteadHandler and ifRestrictedExecuteInstead**: Added proper deprecation instead of breaking renames. Both old (`ExecuteInsteadHandler`, `ifRestrictedExecuteInstead`) and new (`RunInsteadHandler`, `ifRestrictedRunInstead`) names now work during v9.x. Added comprehensive tests for deprecated variants to maintain coverage. Updated fix_data.yaml to auto-migrate users via `dart fix`.
+
 [9.0.1] - 2025-11-14
 
 ### Fixes

lib/async_command.dart

@@ -9,6 +9,12 @@ class CommandAsync<TParam, TResult> extends Command<TParam, TResult> {
     Future<TResult> Function()? funcNoParam,
     required super.initialValue,
     required super.restriction,
+    required super.ifRestrictedRunInstead,
+    @Deprecated(
+      'Use ifRestrictedRunInstead instead. '
+      'This will be removed in v10.0.0. '
+      'See BREAKING_CHANGE_EXECUTE_TO_RUN.md for migration guide.',
+    )
     required super.ifRestrictedExecuteInstead,
     required super.includeLastResultInCommandResults,
     required super.noReturnValue,

lib/command_it.dart

@@ -3,6 +3,10 @@
 # Usage: dart fix --apply
 #
 # See: https://github.com/flutter/flutter/blob/master/docs/contributing/Data-driven-Fixes.md
+#
+# Note: Typedef renames (ExecuteInsteadHandler → RunInsteadHandler) cannot be
+# automatically fixed by dart fix. The @Deprecated annotation will guide users
+# to use the new RunInsteadHandler type. Parameter renames will be auto-fixed.
 
 version: 1
 transforms:

lib/fix_data.yaml

@@ -18,6 +18,12 @@ class MockCommand<TParam, TResult> extends Command<TParam, TResult> {
     super.noParamValue = false,
     super.noReturnValue = false,
     super.restriction,
+    super.ifRestrictedRunInstead,
+    @Deprecated(
+      'Use ifRestrictedRunInstead instead. '
+      'This will be removed in v10.0.0. '
+      'See BREAKING_CHANGE_EXECUTE_TO_RUN.md for migration guide.',
+    )
     super.ifRestrictedExecuteInstead,
     super.includeLastResultInCommandResults = false,
     super.errorFilter,

lib/mock_command.dart

@@ -15,6 +15,12 @@ class CommandSync<TParam, TResult> extends Command<TParam, TResult> {
     TResult Function()? funcNoParam,
     required super.initialValue,
     required super.restriction,
+    required super.ifRestrictedRunInstead,
+    @Deprecated(
+      'Use ifRestrictedRunInstead instead. '
+      'This will be removed in v10.0.0. '
+      'See BREAKING_CHANGE_EXECUTE_TO_RUN.md for migration guide.',
+    )
     required super.ifRestrictedExecuteInstead,
     required super.includeLastResultInCommandResults,
     required super.noReturnValue,

lib/sync_command.dart

@@ -55,6 +55,12 @@ class UndoableCommand<TParam, TResult, TUndoState>
     required UndoFn<TUndoState, TResult> undo,
     required super.initialValue,
     required super.restriction,
+    required super.ifRestrictedRunInstead,
+    @Deprecated(
+      'Use ifRestrictedRunInstead instead. '
+      'This will be removed in v10.0.0. '
+      'See BREAKING_CHANGE_EXECUTE_TO_RUN.md for migration guide.',
+    )
     required super.ifRestrictedExecuteInstead,
     required bool undoOnExecutionFailure,
     required super.includeLastResultInCommandResults,

lib/undoable_command.dart

@@ -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.0.1
+version: 9.0.2
 homepage: https://github.com/flutter-it/command_it
 
 screenshots: