added popTo(item:orDismiss:)

README.md

@@ -190,9 +190,10 @@ The `BLTNItem` protocol exposes a `manager` property that is set when the item i
 
 You can use it to interact with the presented bulletin. Call:
 
+- `manager?.push(item:)` with a `BulletinItem` to present a new item
 - `manager?.popItem()` to go back to the previous item
 - `manager?.popToRootItem()` to go back to the first item
-- `manager?.push(item:)` with a `BulletinItem` to present a new item
+- `manager?.popTo(item:orDismiss:)` to go back to a specific item
 - `manager?.dismissBulletin(animated:)` to dismiss the bulletin
 - `manager?.displayNextItem()` to display the next item (see below)
 

Sources/BLTNItemManager.swift

@@ -330,6 +330,40 @@ extension BLTNItemManager {
 
     }
 
+    /**
+     * Removes items from the stack until a specific item is found.
+     * - parameter item: The item to seek.
+     * - parameter orDismiss: If true, dismiss bullein if not found. Otherwise popToRootItem()
+     */
+
+    @objc public func popTo(item: BLTNItem, orDismiss: Bool) {
+
+        assertIsPrepared()
+        assertIsMainThread()
+
+        for index in 0..<itemsStack.count  {
+
+            if itemsStack[index] === item {
+
+                self.currentItem = itemsStack[index]
+                shouldDisplayActivityIndicator = currentItem.shouldStartWithActivityIndicator
+                refreshCurrentItemInterface()
+
+                for removeIndex in (index+1..<itemsStack.count).reversed() {
+                    let removeItem = itemsStack.remove(at: removeIndex)
+                    tearDownItemsChain (startingAt: removeItem)
+                }
+                return
+            }
+        }
+
+        if item !== rootItem, orDismiss {
+            dismissBulletin(animated: true)
+        } else {
+            popToRootItem()
+        }
+    }
+
     /**
      * Removes all the items from the stack and displays the root item.
      */