feat(navigation): TaskStackBuilder support

Useful extension method to support a `Destination`

Assisted-by: Claude Opus 4.7

Author: david-allison

anki-common/src/main/kotlin/com/ichi2/anki/common/destinations/Navigator.kt

@@ -6,6 +6,7 @@ import android.app.Activity
 import android.content.Intent
 import androidx.activity.result.ActivityResultLauncher
 import androidx.annotation.CheckResult
+import androidx.core.app.TaskStackBuilder
 import androidx.fragment.app.Fragment
 
 // TODO: Move this into anki-common:android after libanki becomes a java-library
@@ -57,6 +58,13 @@ fun ActivityResultLauncher<Intent>.navigate(destination: Destination) {
     launch(navigatorInstance.toIntent(destination))
 }
 
+/**
+ * Adds the Intent for [destination] to this [TaskStackBuilder]'s stack.
+ *
+ * @see TaskStackBuilder.addNextIntent
+ */
+fun TaskStackBuilder.addNextIntent(destination: Destination): TaskStackBuilder = addNextIntent(navigatorInstance.toIntent(destination))
+
 /**
  * Opt-in marker for callers that are not launching navigation immediately, but
  * handing an [Intent] to the framework to launch later ([android.app.PendingIntent] etc...).