(Experimental)(#14) Added SearchRefactoring parameter to AssetUsageDetector (only useful while triggering the search via Scripting API). It allows getting notified of found references during the search (some references like Assembly Definition File references or Shader Graph references aren't supported) and in most cases, refactoring them (e.g. changing all usages of a searched object with something else or null). Disabling "Lazy Scene Search" is recommended while using this feature and it's advised to backup your project beforehand

Author: yasirkula

.github/README.md

@@ -37,6 +37,33 @@ There are 5 ways to install this plugin:
 
 ![SearchResults2](Images/SearchResults2Dark.png)
 
+## SEARCH REFACTORING
+
+While searching for references using the Scripting API, it's possible to get notified of the found references *during* the search (some references like *Assembly Definition File* references or *Shader Graph* references aren't supported) and in most cases, refactor them (e.g. changing all usages of a searched object with something else or *null*). Disabling *Lazy Scene Search* is recommended while using this feature and it's advised to backup your project beforehand.
+
+To initiate a search using the Scripting API, you need to put your script either in *Editor* folder or add `AssetUsageDetector.Editor` as reference to your *Assembly Definition File*. Then, you can either create a new instance of `AssetUsageDetectorNamespace.AssetUsageDetector` object and call its `Run` method, or call the `AssetUsageDetectorNamespace.AssetUsageDetectorWindow.ShowAndSearch` method. In either case, you'll be handling the search refactoring in the **searchRefactoring** callback:
+
+```csharp
+void ReplaceFontUsages( Font from, Font to )
+{
+	AssetUsageDetector assetUsageDetector = new AssetUsageDetector();
+	assetUsageDetector.Run( new AssetUsageDetector.Parameters()
+	{
+		objectsToSearch = new Object[] { from },
+		lazySceneSearch = false,
+		searchRefactoring = ( searchMatch ) =>
+		{
+			Debug.LogFormat( "Found a {0} reference from {1} to {2}", searchMatch.GetType().Name, searchMatch.Source, searchMatch.Value );
+			searchMatch.ChangeValue( to );
+		}
+	} );
+}
+```
+
+**NOTE:** Refactored references won't be reflected to the returned search results, old references will continue to be displayed. After saving the changes (modified scenes) and initiating another search, correct search results will be shown.
+
+**NOTE2:** After refactoring the references, consider performing a normal search to see if all references were correctly refactored. If some references weren't refactored (even though they could've been), feel free to report it.
+
 ## KNOWN LIMITATIONS
 
 - *Addressables* aren't supported

Plugins/AssetUsageDetector/Editor/AssetUsageDetector.cs

@@ -44,6 +44,8 @@ public class Parameters
 
 			public bool searchUnusedMaterialProperties = true;
 
+			public SearchRefactoring searchRefactoring = null;
+
 			public bool lazySceneSearch = true;
 			public bool calculateUnusedObjects = false;
 			public bool hideDuplicateRows = true;
@@ -53,6 +55,8 @@ public class Parameters
 		}
 		#endregion
 
+		private Parameters searchParameters;
+
 		// A set that contains the searched scene object(s), asset(s) and their sub-assets (if any)
 		private readonly HashSet<Object> objectsToSearchSet = new HashSet<Object>();
 		// Scenes of scene object(s) in objectsToSearchSet
@@ -78,14 +82,9 @@ public class Parameters
 		// Stack of SearchObject function parameters to avoid infinite loops (which happens when same object is passed as parameter to function)
 		private readonly List<object> callStack = new List<object>( 64 );
 
-		private int searchDepthLimit; // Depth limit for recursively searching variables of objects
-
 		private Object currentSearchedObject;
 		private int currentDepth;
 
-		private bool searchUnusedMaterialProperties;
-
-		private bool dontSearchInSourceAssets;
 		private bool searchingSourceAssets;
 		private bool isInPlayMode;
 
@@ -166,6 +165,8 @@ public SearchResult Run( Parameters searchParameters )
 
 			try
 			{
+				this.searchParameters = searchParameters;
+
 				// Initialize commonly used variables
 				searchResult = new List<SearchResultGroup>(); // Overall search results
 
@@ -174,10 +175,6 @@ public SearchResult Run( Parameters searchParameters )
 				searchedObjectsCount = 0;
 				searchStartTime = EditorApplication.timeSinceStartup;
 
-				searchDepthLimit = searchParameters.searchDepthLimit;
-				dontSearchInSourceAssets = searchParameters.dontSearchInSourceAssets;
-				searchUnusedMaterialProperties = searchParameters.searchUnusedMaterialProperties;
-
 				searchedObjects.Clear();
 				searchedUnityObjects.Clear();
 				animationClipUniqueBindings.Clear();
@@ -545,7 +542,7 @@ public SearchResult Run( Parameters searchParameters )
 				}
 
 				// Searching source assets last prevents some references from being excluded due to callStack.ContainsFast
-				if( !dontSearchInSourceAssets )
+				if( !searchParameters.dontSearchInSourceAssets )
 				{
 					searchingSourceAssets = true;
 
@@ -833,7 +830,7 @@ private void AddSearchedObjectToFilteredSets( Object obj, bool expandGameObjects
 				if( !string.IsNullOrEmpty( assetPath ) )
 				{
 					assetsToSearchPathsSet.Add( assetPath );
-					if( dontSearchInSourceAssets && AssetDatabase.IsMainAsset( obj ) )
+					if( searchParameters.dontSearchInSourceAssets && AssetDatabase.IsMainAsset( obj ) )
 						excludedAssetsPathsSet.Add( assetPath );
 				}
 
@@ -1062,7 +1059,7 @@ private ReferenceNode SearchObject( object obj )
 			else
 			{
 				// Comply with the recursive search limit
-				if( currentDepth >= searchDepthLimit )
+				if( currentDepth >= searchParameters.searchDepthLimit )
 					return null;
 
 				callStack.Add( obj );