feat(widgets): add tip for the new recommendations widget on home

PocketKit/Sources/Localization/Resources/en.lproj/Localizable.strings

@@ -364,3 +364,5 @@
 "tips.swipeToArchive.message" = "Swipe left on an article to archive it quickly.";
 "tips.swipeHighlights.title" = "Swipe Highlights";
 "tips.swipeHighlights.message" = "Swipe left on a paragraph to highlight it. Alternatively, swipe and select 'Delete Highlights' to remove any existing highlighting.";
+"tips.recommendationsWidget.selectTopic.title" = "New Recommendations Widget!";
+"tips.recommendationsWidget.selectTopic.message" = "Long-press on the Recommendations Widget to choose a topic of interest.\nInstall multiple widgets to keep track of all your favorite topics.";

PocketKit/Sources/Localization/Strings.swift

@@ -698,6 +698,15 @@ public enum Localization {
     }
   }
   public enum Tips {
+    public enum RecommendationsWidget {
+      public enum SelectTopic {
+        /// Long-press on the Recommendations Widget to choose a topic of interest.
+        /// Install multiple widgets to keep track of all your favorite topics.
+        public static let message = Localization.tr("Localizable", "tips.recommendationsWidget.selectTopic.message", fallback: "Long-press on the Recommendations Widget to choose a topic of interest.\nInstall multiple widgets to keep track of all your favorite topics.")
+        /// New Recommendations Widget!
+        public static let title = Localization.tr("Localizable", "tips.recommendationsWidget.selectTopic.title", fallback: "New Recommendations Widget!")
+      }
+    }
     public enum SwipeHighlights {
       /// Swipe left on a paragraph to highlight it. Alternatively, swipe and select 'Delete Highlights' to remove any existing highlighting.
       public static let message = Localization.tr("Localizable", "tips.swipeHighlights.message", fallback: "Swipe left on a paragraph to highlight it. Alternatively, swipe and select 'Delete Highlights' to remove any existing highlighting.")

PocketKit/Sources/PocketKit/Article/ReadableViewController.swift

@@ -42,7 +42,7 @@ class ReadableViewController: UIViewController {
     private var isReloading = false
 
     private var userScrollProgress: IndexPath?
-
+    // Tippable view controller properties
     var tipObservationTask: Task<Void, Error>?
     weak var tipViewController: UIViewController?
 

PocketKit/Sources/PocketKit/Home/HomeViewController.swift

@@ -41,6 +41,10 @@ class HomeViewController: UIViewController {
 
     private var collectionSubscriptions = SubscriptionsStack()
 
+    // Tippable view controller properties
+    var tipObservationTask: Task<Void, Error>?
+    weak var tipViewController: UIViewController?
+
     private lazy var layout = UICollectionViewCompositionalLayout { [weak self] sectionIndex, env in
         guard let self = self,
               let section = self.dataSource.sectionIdentifier(for: sectionIndex) else {
@@ -165,6 +169,17 @@ class HomeViewController: UIViewController {
         handleRefresh()
     }
 
+    override func viewDidAppear(_ animated: Bool) {
+        super.viewDidAppear(animated)
+        if #available(iOS 17.0, *), let sourceView = navigationController?.view ?? view {
+            let x = view.bounds.width / 2
+            let y: CGFloat = 0
+            let sourceRect = CGRect(x: x, y: y, width: 0, height: 0)
+            let configuration = TipUIConfiguration(sourceRect: sourceRect, permittedArrowDirections: .init(rawValue: 0), backgroundColor: nil, tintColor: nil)
+            displayTip(NewRecommendationsWidgetTip(), configuration: configuration, sourceView: sourceView)
+        }
+    }
+
     private func handleRefresh(isForced: Bool = false) {
         model.refresh(isForced: isForced) { [weak self] in
             DispatchQueue.main.async {
@@ -744,6 +759,8 @@ extension HomeViewController: SFSafariViewControllerDelegate {
     }
 }
 
+extension HomeViewController: TippableViewController {}
+
 private extension Style {
     static let overscroll = Style.header.sansSerif.p3.with { $0.with(alignment: .center) }
 }

PocketKit/Sources/PocketKit/MyList/ItemsList/UIKit/ItemsListViewController.swift

@@ -18,7 +18,7 @@ class ItemsListViewController<ViewModel: ItemsListViewModel>: UIViewController,
     private var progressView: UIProgressView!
     private var dataSource: UICollectionViewDiffableDataSource<ItemsListSection, ItemsListCell<ViewModel.ItemIdentifier>>!
     private var itemSectionLayout: NSCollectionLayoutSection!
-
+    // Tippable view controller properties
     var tipObservationTask: Task<Void, Error>?
     weak var tipViewController: UIViewController?
 

PocketKit/Sources/PocketKit/Tips/PocketTips.swift

@@ -28,3 +28,13 @@ struct SwipeArchiveTip: Tip {
     let image: Image? = Image(uiImage: UIImage(asset: .archive))
     let options = [Tips.MaxDisplayCount(3)]
 }
+
+/// New Recommendation Widget, Home
+@available(iOS 17.0, *)
+struct NewRecommendationsWidgetTip: Tip {
+    var id = UUID()
+    let title = Text(Localization.Tips.RecommendationsWidget.SelectTopic.title)
+    let message: Text? = Text(Localization.Tips.RecommendationsWidget.SelectTopic.message)
+    let image: Image? = nil
+    let options = [Tips.MaxDisplayCount(1)]
+}