ADFA-1377 diagnostic tooltip (#323)

* refactor: use fixed tooltip tags for sidebar actions

This commit introduces a `tooltipTag` property to `SidebarActionItem`
and updates all sidebar actions to use fixed string values for their
tooltips instead of dynamically generating them based on the label.

This change simplifies the tooltip setup logic in `EditorSidebarActions`
by removing the `tooltipTag()` extension function and directly using the
new property.

* ADFA-1381 | Refactor: Move tooltipTag to ActionItem

Move the `tooltipTag` property from `SidebarActionItem` to the base `ActionItem` class. This makes the property available to all action item types.

Update various action classes to initialize `tooltipTag`.

In `EditorActionsMenu`, implement long-press listeners on action buttons to display tooltips using the `TooltipManager`.

* Refactor: Use TooltipTag for sidebar actions

This commit refactors the sidebar actions to use the newly introduced `TooltipTag` object for managing tooltip tags.

The following sidebar actions were updated:
- TerminalSidebarAction
- HelpSideBarAction
- FileTreeSidebarAction
- PreferencesSidebarAction
- CloseProjectSidebarAction
- BuildVariantsSidebarAction

A new file `idetooltips/src/main/java/com/itsaky/androidide/idetooltips/TooltipTag.kt` was created to define the tooltip tags.

* Use constants for tooltip categories

This commit replaces hardcoded string values for tooltip categories with constants defined in the new `TooltipCategory` object. This improves code maintainability and reduces the risk of typos.

The following files were modified to use these constants:
- `app/src/main/java/com/itsaky/androidide/fragments/MainFragment.kt`
- `app/src/main/java/com/itsaky/androidide/utils/EditorSidebarActions.kt`
- `app/src/main/java/com/itsaky/androidide/ui/EditorBottomSheet.kt`
- `app/src/main/java/com/itsaky/androidide/actions/file/ShowTooltipAction.kt`

* Refactor: Use TooltipTag for editor actions

This commit refactors the editor actions to use the `TooltipTag` constants for tooltip tags.

The following changes were made:
- Added new `TooltipTag` constants for editor toolbar actions in `idetooltips/src/main/java/com/itsaky/androidide/idetooltips/TooltipTag.kt`.
- Updated editor actions in `app/src/main/java/com/itsaky/androidide/actions/editor/` to use the new `TooltipTag` constants.
- Updated `actions/src/main/java/com/itsaky/androidide/actions/locations/CodeActionsMenu.kt` to use the new `TooltipTag` constant.
- Added `idetooltips` project as a dependency to the `actions` module in `actions/build.gradle.kts`.

* Refactor: Use TooltipCategory constants

Updated `EditorCompletionWindow` and `EditorActionsMenu` to use constants from `TooltipCategory` for tooltip categories.
Added `CATEGORY_XML` to `TooltipCategory`.

* Refactor: Show tooltip for output tabs

This commit refactors the tooltip display logic for the output tabs in `EditorBottomSheet.kt`.

Instead of directly creating `IDETooltipItem` objects, it now:
- Uses a `tooltipTag` to identify the relevant tooltip.
- Fetches tooltip data using `TooltipManager.getTooltip`.
- Displays the tooltip using the fetched data.
- Adds error handling for tooltip display.
- Leverages coroutines and `lifecycleScope` for asynchronous operations.

* Refactor: Use TooltipTag constants for EditorBottomSheet tabs

This commit refactors the `EditorBottomSheet` to use constants from `TooltipTag` for setting tooltip tags on its tabs.

Specifically, the following changes were made:
- Added new constants to `TooltipTag.kt` for project-specific tooltips:
    - `PROJECT_APP_LOGS`
    - `PROJECT_IDE_LOGS`
    - `PROJECT_SEARCH_RESULTS`
    - `PROJECT_DIAGNOSTICS`
- Modified `EditorBottomSheet.kt` to:
    - Retrieve tooltip tags using `pagerAdapter.getTooltipTag(position)`.
    - Use `TooltipCategory.CATEGORY_IDE` when fetching tooltips.
- Updated `EditorBottomSheetTabAdapter.java` to:
    - Add a `tooltipTag` field to the inner `Tab` class.
    - Initialize `tooltipTag` in the `Tab` constructor.
    - Add a `getTooltipTag(int position)` method to retrieve the tooltip tag for a given tab position.
    - Assign the new `TooltipTag` constants to the respective tabs.
    - Swapped tooltip tags for "Diagnostics" and "Search Results" tabs to match their functionality.

* Refactor: Show IDE tooltips on long press

- Add long press gesture recognizer to `RecyclerViewFragment` to show IDE tooltips.
- Add tooltip tag for `SearchResultFragment`.
- Remove unused Activity context from `EditorCompletionWindow`.
- Enable test code for `TooltipManager.getTooltip`.

* Merge conflcits

* ADFA-1377 | Add tooltip tag to DiagnosticsListFragment

The `fragmentTooltipTag` in `DiagnosticsListFragment.kt` was updated to use the `PROJECT_DIAGNOSTICS` constant from `TooltipTag`.

* Merge conflicts

Author: jatezzz

app/src/main/java/com/itsaky/androidide/adapters/EditorBottomSheetTabAdapter.kt

@@ -26,6 +26,7 @@ import com.itsaky.androidide.fragments.debug.DebuggerFragment
 import com.itsaky.androidide.fragments.output.AppLogFragment
 import com.itsaky.androidide.fragments.output.BuildOutputFragment
 import com.itsaky.androidide.fragments.output.IDELogFragment
+import com.itsaky.androidide.idetooltips.TooltipTag
 import com.itsaky.androidide.resources.R
 import org.slf4j.Logger
 import org.slf4j.LoggerFactory
@@ -41,7 +42,7 @@ class EditorBottomSheetTabAdapter(
 				Tab(
 					title = fragmentActivity.getString(R.string.build_output),
 					fragmentClass = BuildOutputFragment::class.java,
-					itemId = size.toLong(),
+					itemId = size.toLong()
 				),
 			)
 
@@ -50,6 +51,7 @@ class EditorBottomSheetTabAdapter(
 					title = fragmentActivity.getString(R.string.app_logs),
 					fragmentClass = AppLogFragment::class.java,
 					itemId = size.toLong(),
+					tooltipTag = TooltipTag.PROJECT_APP_LOGS
 				),
 			)
 
@@ -58,6 +60,7 @@ class EditorBottomSheetTabAdapter(
 					title = fragmentActivity.getString(R.string.ide_logs),
 					fragmentClass = IDELogFragment::class.java,
 					itemId = size.toLong(),
+					tooltipTag = TooltipTag.PROJECT_IDE_LOGS
 				),
 			)
 
@@ -66,6 +69,7 @@ class EditorBottomSheetTabAdapter(
 					title = fragmentActivity.getString(R.string.view_diags),
 					fragmentClass = DiagnosticsListFragment::class.java,
 					itemId = size.toLong(),
+					tooltipTag = TooltipTag.PROJECT_SEARCH_RESULTS
 				),
 			)
 
@@ -74,14 +78,15 @@ class EditorBottomSheetTabAdapter(
 					title = fragmentActivity.getString(R.string.view_search_results),
 					fragmentClass = SearchResultFragment::class.java,
 					itemId = size.toLong(),
+					tooltipTag = TooltipTag.PROJECT_DIAGNOSTICS
 				),
 			)
 
 			add(
 				Tab(
 					title = fragmentActivity.getString(R.string.debugger_title),
 					fragmentClass = DebuggerFragment::class.java,
-					itemId = size.toLong(),
+					itemId = size.toLong()
 				),
 			)
 		}
@@ -223,10 +228,15 @@ class EditorBottomSheetTabAdapter(
 		val title: String,
 		val fragmentClass: Class<out Fragment>,
 		val itemId: Long,
+		val tooltipTag: String? = null
 	)
 
 	companion object {
 		private val logger: Logger =
 			LoggerFactory.getLogger(EditorBottomSheetTabAdapter::class.java)
 	}
+
+	fun getTooltipTag(position: Int): String? {
+		return allTabs[position].tooltipTag
+	}
 }

app/src/main/java/com/itsaky/androidide/fragments/DiagnosticsListFragment.kt

@@ -21,9 +21,10 @@ import android.view.View
 import androidx.recyclerview.widget.RecyclerView
 import com.itsaky.androidide.R
 import com.itsaky.androidide.adapters.DiagnosticsAdapter
+import com.itsaky.androidide.idetooltips.TooltipTag
 
 class DiagnosticsListFragment : RecyclerViewFragment<DiagnosticsAdapter>() {
-
+  override val fragmentTooltipTag: String? = TooltipTag.PROJECT_DIAGNOSTICS
   override fun onCreateAdapter(): RecyclerView.Adapter<*> {
     return DiagnosticsAdapter(ArrayList(), null)
   }

app/src/main/java/com/itsaky/androidide/fragments/RecyclerViewFragment.kt

@@ -17,12 +17,23 @@
 
 package com.itsaky.androidide.fragments
 
+import android.annotation.SuppressLint
 import android.os.Bundle
+import android.util.Log
+import android.view.GestureDetector
+import android.view.MotionEvent
 import android.view.View
+import androidx.lifecycle.lifecycleScope
 import androidx.recyclerview.widget.LinearLayoutManager
 import androidx.recyclerview.widget.RecyclerView
 import androidx.recyclerview.widget.RecyclerView.LayoutManager
 import com.itsaky.androidide.databinding.FragmentRecyclerviewBinding
+import com.itsaky.androidide.idetooltips.TooltipCategory
+import com.itsaky.androidide.idetooltips.TooltipManager
+import com.itsaky.androidide.utils.TooltipUtils
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.launch
+import kotlinx.coroutines.withContext
 
 /**
  * A fragment which shows a [RecyclerView].
@@ -31,9 +42,32 @@ import com.itsaky.androidide.databinding.FragmentRecyclerviewBinding
  */
 abstract class RecyclerViewFragment<A : RecyclerView.Adapter<*>> :
   EmptyStateFragment<FragmentRecyclerviewBinding>(FragmentRecyclerviewBinding::inflate) {
+  protected abstract val fragmentTooltipTag: String?
 
   private var unsavedAdapter: A? = null
 
+  private lateinit var gestureDetector: GestureDetector
+
+  private val gestureListener =
+    object : GestureDetector.SimpleOnGestureListener() {
+      override fun onLongPress(e: MotionEvent) {
+        showFragmentTooltip()
+      }
+    }
+
+  private val touchListener =
+    object : RecyclerView.OnItemTouchListener {
+      override fun onInterceptTouchEvent(rv: RecyclerView, e: MotionEvent): Boolean {
+        // Pass the event to our gesture detector
+        gestureDetector.onTouchEvent(e)
+        // Always return false so we don't consume the event
+        return false
+      }
+
+      override fun onTouchEvent(rv: RecyclerView, e: MotionEvent) {}
+      override fun onRequestDisallowInterceptTouchEvent(disallowIntercept: Boolean) {}
+    }
+
   /**
    * Creates the adapter for the [RecyclerView].
    */
@@ -56,10 +90,20 @@ abstract class RecyclerViewFragment<A : RecyclerView.Adapter<*>> :
     }
   }
 
+  @SuppressLint("ClickableViewAccessibility")
   override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
     super.onViewCreated(view, savedInstanceState)
+
+    gestureDetector = GestureDetector(requireContext(), gestureListener)
+    emptyStateBinding?.root?.setOnTouchListener { _, event ->
+      gestureDetector.onTouchEvent(event)
+      false
+    }
+
     onSetupRecyclerView()
 
+    binding.root.addOnItemTouchListener(touchListener)
+
     unsavedAdapter = null
 
     checkIsEmpty()
@@ -78,6 +122,29 @@ abstract class RecyclerViewFragment<A : RecyclerView.Adapter<*>> :
     checkIsEmpty()
   }
 
+  private fun showFragmentTooltip() {
+    val workingContext = context ?: return
+    val anchorView = this@RecyclerViewFragment.view ?: return
+    val tooltipTag = fragmentTooltipTag ?: return
+    viewLifecycleOwner.lifecycleScope.launch {
+      try {
+        val tooltipData = withContext(Dispatchers.IO) {
+          TooltipManager.getTooltip(workingContext, TooltipCategory.CATEGORY_IDE, tooltipTag)
+        }
+        tooltipData?.let {
+          TooltipUtils.showIDETooltip(
+            context = workingContext,
+            level = 0,
+            tooltipItem = tooltipData,
+            anchorView = anchorView,
+          )
+        }
+      } catch (e: Exception) {
+        Log.e("Tooltip", "Error showing tooltip for $tooltipTag", e)
+      }
+    }
+  }
+
   private fun checkIsEmpty() {
     emptyStateViewModel.isEmpty.value = _binding?.root?.adapter?.itemCount == 0
   }

app/src/main/java/com/itsaky/androidide/fragments/SearchResultFragment.kt

@@ -18,8 +18,10 @@ package com.itsaky.androidide.fragments
 
 import androidx.recyclerview.widget.RecyclerView
 import com.itsaky.androidide.adapters.SearchListAdapter
+import com.itsaky.androidide.idetooltips.TooltipTag
 
 class SearchResultFragment : RecyclerViewFragment<SearchListAdapter>() {
+  override val fragmentTooltipTag: String? = TooltipTag.PROJECT_SEARCH_RESULTS
 
   override fun onCreateAdapter(): RecyclerView.Adapter<*> {
     val noOp: (Any) -> Unit = {}

app/src/main/java/com/itsaky/androidide/fragments/debug/CallStackFragment.kt

@@ -22,7 +22,7 @@ import kotlinx.coroutines.withContext
  * @author Akash Yadav
  */
 class CallStackFragment : RecyclerViewFragment<CallStackAdapter>() {
-
+    override val fragmentTooltipTag: String? = null// Tooltip pending to be defined
     private val viewHolder by activityViewModels<DebuggerViewModel>()
 
     override fun onViewCreated(view: View, savedInstanceState: Bundle?) {

app/src/main/java/com/itsaky/androidide/ui/EditorBottomSheet.kt

@@ -21,6 +21,7 @@ import android.app.Activity
 import android.content.Context
 import android.text.TextUtils
 import android.util.AttributeSet
+import android.util.Log
 import android.view.LayoutInflater
 import android.view.View
 import android.view.ViewGroup
@@ -35,6 +36,8 @@ import androidx.core.view.updateLayoutParams
 import androidx.core.view.updatePadding
 import androidx.core.view.updatePaddingRelative
 import androidx.fragment.app.FragmentActivity
+import androidx.lifecycle.LifecycleOwner
+import androidx.lifecycle.lifecycleScope
 import androidx.transition.TransitionManager
 import com.blankj.utilcode.util.KeyboardUtils
 import com.blankj.utilcode.util.SizeUtils
@@ -50,8 +53,8 @@ import com.itsaky.androidide.adapters.EditorBottomSheetTabAdapter
 import com.itsaky.androidide.adapters.SearchListAdapter
 import com.itsaky.androidide.databinding.LayoutEditorBottomSheetBinding
 import com.itsaky.androidide.fragments.output.ShareableOutputFragment
-import com.itsaky.androidide.idetooltips.IDETooltipItem
 import com.itsaky.androidide.idetooltips.TooltipCategory
+import com.itsaky.androidide.idetooltips.TooltipManager
 import com.itsaky.androidide.models.LogLine
 import com.itsaky.androidide.resources.R.string
 import com.itsaky.androidide.tasks.TaskExecutor.CallbackWithError
@@ -61,6 +64,9 @@ import com.itsaky.androidide.utils.IntentUtils.shareFile
 import com.itsaky.androidide.utils.Symbols.forFile
 import com.itsaky.androidide.utils.TooltipUtils
 import com.itsaky.androidide.utils.flashError
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.launch
+import kotlinx.coroutines.withContext
 import org.slf4j.LoggerFactory
 import java.io.File
 import java.io.IOException
@@ -115,49 +121,45 @@ class EditorBottomSheet
 			const val CHILD_ACTION = 2
 		}
 
-		private fun initialize(context: FragmentActivity) {
-			val mediator =
-				TabLayoutMediator(binding.tabs, binding.pager, true, true) { tab, position ->
-					tab.text = pagerAdapter.getTitle(position)
-				}
+  private fun initialize(context: FragmentActivity) {
+
+    val mediator =
+      TabLayoutMediator(binding.tabs, binding.pager, true, true) { tab, position ->
+        tab.text = pagerAdapter.getTitle(position)
+        tab.view.setOnLongClickListener { view ->
+          val tooltipTag =
+            pagerAdapter.getTooltipTag(position) ?: return@setOnLongClickListener true
+          val lifecycleOwner = context as? LifecycleOwner ?: return@setOnLongClickListener true
+          lifecycleOwner.lifecycleScope.launch {
+            try {
+              val tooltipData = withContext(Dispatchers.IO) {
+                TooltipManager.getTooltip(context, TooltipCategory.CATEGORY_IDE, tooltipTag)
+              }
+              tooltipData?.let {
+                TooltipUtils.showIDETooltip(
+                  context = context,
+                  level = 0,
+                  tooltipItem = tooltipData,
+                  anchorView = view
+                )
+              }
+							} catch (e: Exception) {
+              Log.e("Tooltip", "Error showing tooltip for $tooltipTag", e)
+            }
+          }
+
+          true
+        }
+      }
 
 			mediator.attach()
-			binding.pager.isUserInputEnabled = false
-			binding.pager.offscreenPageLimit = pagerAdapter.itemCount - 1 // Do not remove any views
-
-			for (i in 0 until binding.tabs.tabCount) {
-				val tab = binding.tabs.getTabAt(i) ?: continue
-				val tabView = tab.view
-
-				tabView.setOnLongClickListener {
-					val title = pagerAdapter.getTitle(i)
-					val tooltipMessage =
-						when (title) {
-							context.getString(R.string.app_logs) -> context.getString(R.string.app_logs)
-							context.getString(R.string.ide_logs) -> context.getString(R.string.ide_logs)
-							else -> context.getString(R.string.default_tooltip)
-						}
-					TooltipUtils.showIDETooltip(
-						context,
-						tabView,
-						0,
-						IDETooltipItem(
-							tooltipCategory = TooltipCategory.CATEGORY_IDE,
-							tooltipTag = tooltipMessage,
-							detail = tooltipMessage,
-							summary = context.getString(R.string.more_information_about, title),
-							buttons = arrayListOf(Pair(context.getString(R.string.learn_more), "~/help_top.html")),
-						),
-					)
-
-					true
-				}
-			}
+    binding.pager.isUserInputEnabled = false
+    binding.pager.offscreenPageLimit = pagerAdapter.itemCount - 1
 
-			binding.tabs.addOnTabSelectedListener(
-				object : OnTabSelectedListener {
-					override fun onTabSelected(tab: Tab) {
-						val fragment = pagerAdapter.getFragmentAtIndex(tab.position)
+    binding.tabs.addOnTabSelectedListener(
+      object : OnTabSelectedListener {
+        override fun onTabSelected(tab: Tab) {
+          val fragment = pagerAdapter.getFragmentAtIndex(tab.position)
 						if (fragment is ShareableOutputFragment) {
 							binding.clearFab.show()
 							binding.shareOutputFab.show()