turbo-native-initializer 0.0.1

data/lib/turbo_native_initializer/templates/ios_tabs/TurboNativeProject/Controllers/TurboNavigationController.swift

@@ -0,0 +1,123 @@
+import Foundation
+import UIKit
+import Turbo
+
+class TurboNavigationController : UINavigationController {
+
+    var session: Session!
+    var modalSession: Session!
+
+    func push(url: URL) {
+        let properties = session.pathConfiguration?.properties(for: url) ?? [:]
+        route(url: url, options: VisitOptions(action: .advance), properties: properties)
+    }
+
+    func route(url: URL, options: VisitOptions, properties: PathProperties) {
+        // This is a simplified version of how you might build out the routing
+        // and navigation functions of your app. In a real app, these would be separate objects
+
+        // Dismiss any modals when receiving a new navigation
+        if presentedViewController != nil {
+            dismiss(animated: true)
+        }
+
+        // - Create view controller appropriate for url/properties
+        // - Navigate to that with the correct presentation
+        let viewController = makeViewController(for: url, properties: properties)
+        navigate(to: viewController, action: options.action, properties: properties)
+
+        // - Initiate the visit with Turbo
+        if isVisitable(properties) {
+            visit(viewController: viewController, with: options)
+        }
+    }
+}
+
+extension TurboNavigationController {
+    private func isModal(_ properties: PathProperties) -> Bool {
+        return properties["presentation"] as? String == "modal"
+    }
+
+    private func isClearAll(_ properties: PathProperties) -> Bool {
+        return properties["presentation"] as? String == "clear-all"
+    }
+
+    private func isPop(_ properties: PathProperties) -> Bool {
+        return properties["presentation"] as? String == "pop"
+    }
+
+    private func isRefresh(_ properties: PathProperties) -> Bool {
+        return properties["presentation"] as? String == "refresh"
+    }
+
+    private func isNone(_ properties: PathProperties) -> Bool {
+        return properties["presentation"] as? String == "none"
+    }
+
+    private func isReplaceAll(_ properties: PathProperties) -> Bool {
+        return properties["presentation"] as? String == "replace-all"
+    }
+
+    private func isReplace(_ properties: PathProperties) -> Bool {
+        return properties["presentation"] as? String == "replace"
+    }
+
+    private func isVisitable(_ properties: PathProperties) -> Bool {
+        return properties["visitable"] as? Bool ?? true
+    }
+
+    private func makeViewController(for url: URL, properties: PathProperties = [:]) -> UIViewController {
+        // There are many options for determining how to map urls to view controllers
+        // The demo uses the path configuration for determining which view controller and presentation
+        // to use, but that's completely optional. You can use whatever logic you prefer to determine
+        // how you navigate and route different URLs.
+
+        if let viewController = properties["view-controller"] as? String {
+            switch viewController {
+            case "numbers":
+                assertionFailure("NumbersViewController is not implemented")
+            default:
+                assertionFailure("Invalid view controller, defaulting to WebView")
+            }
+        }
+
+        return ViewController(url: url)
+    }
+
+    private func navigate(to viewController: UIViewController, action: VisitAction, properties: PathProperties = [:], animated: Bool = true) {
+        let modalNavController = UINavigationController(rootViewController: viewController)
+        modalNavController.modalPresentationStyle = .fullScreen
+        
+        if isModal(properties) {
+            present(modalNavController, animated: animated)
+        } else if isClearAll(properties) {
+            popToRootViewController(animated: true)
+        } else if isPop(properties) {
+            popViewController(animated: true)
+        } else if isRefresh(properties) {
+            session.reload()
+        } else if isNone(properties) {
+            // Will result in no navigation action being taken
+        } else if isReplaceAll(properties) {
+            setViewControllers([viewController], animated: false)
+        } else if isReplace(properties) || action == .replace {
+            setViewControllers(Array(viewControllers.dropLast()) + [viewController], animated: false)
+        } else {
+            pushViewController(viewController, animated: animated)
+        }
+    }
+
+    private func visit(viewController: UIViewController, with options: VisitOptions, modal: Bool = false) {
+        guard let visitable = viewController as? Visitable else { return }
+
+        // Each Session corresponds to a single web view. A good rule of thumb
+        // is to use a session per navigation stack. Here we're using a different session
+        // when presenting a modal. We keep that around for any modal presentations so
+        // we don't have to create more than we need since each new session incurs a cold boot visit cost
+        if modal {
+            modalSession.visit(visitable, options: options)
+        } else {
+            session.visit(visitable, options: options)
+        }
+    }
+}

data/lib/turbo_native_initializer/templates/ios_tabs/TurboNativeProject/Controllers/ViewController.swift

@@ -0,0 +1,20 @@
+import UIKit
+import Turbo
+
+final class ViewController: VisitableViewController, ErrorPresenter {
+    override func viewDidLoad() {
+        super.viewDidLoad()
+
+        view.backgroundColor = .systemBackground
+
+        navigationItem.backButtonDisplayMode = .minimal
+
+        if presentingViewController != nil {
+            navigationItem.leftBarButtonItem = UIBarButtonItem(barButtonSystemItem: .stop, target: self, action: #selector(dismissModal))
+        }
+    }
+
+    @objc func dismissModal() {
+        dismiss(animated: true)
+    }
+}

data/lib/turbo_native_initializer/templates/ios_tabs/TurboNativeProject/Delegates/AppDelegate.swift

@@ -0,0 +1,8 @@
+import UIKit
+
+@main
+class AppDelegate: UIResponder, UIApplicationDelegate {
+    func application(_ application: UIApplication, configurationForConnecting connectingSceneSession: UISceneSession, options: UIScene.ConnectionOptions) -> UISceneConfiguration {
+        return UISceneConfiguration(name: "Default Configuration", sessionRole: connectingSceneSession.role)
+    }
+}

data/lib/turbo_native_initializer/templates/ios_tabs/TurboNativeProject/Delegates/SceneDelegate.swift.tt

@@ -0,0 +1,156 @@
+import UIKit
+import WebKit
+import SafariServices
+import Turbo
+
+final class SceneDelegate: UIResponder {
+    private static var sharedProcessPool = WKProcessPool()
+
+    var window: UIWindow?
+
+    private let baseURL  = <%= name %>.baseURL
+    private let rootURL1 = <%= name %>.homeURL1
+    private let rootURL2 = <%= name %>.homeURL2
+
+    private var tabBarController: UITabBarController!
+
+    private lazy var navigationController1 = {
+        tabBarController.viewControllers![0] as! TurboNavigationController
+    }()
+
+    private lazy var navigationController2 = {
+        tabBarController.viewControllers![1] as! TurboNavigationController
+    }()
+
+    // MARK: - Setup
+
+    private func configureRootViewController() {
+        guard let window = window else { fatalError() }
+
+        window.tintColor = UIColor(named: "Tint")
+
+        tabBarController = (window.rootViewController as! UITabBarController)
+
+        navigationController1.session = session1
+        navigationController1.modalSession = modalSession
+
+        navigationController2.session = session2
+        navigationController2.modalSession = modalSession
+    }
+
+    private func navigationController() -> TurboNavigationController {
+        tabBarController.selectedViewController as! TurboNavigationController
+    }
+
+    private func session() -> Session {
+        navigationController().session
+    }
+
+    // MARK: - Sessions
+
+    private lazy var session1 = makeSession()
+    private lazy var session2 = makeSession()
+    private lazy var modalSession = makeSession()
+
+    private func makeSession() -> Session {
+        let configuration = WKWebViewConfiguration()
+        configuration.applicationNameForUserAgent = "Turbo Native iOS"
+        configuration.processPool = Self.sharedProcessPool
+
+        let webView = WKWebView(frame: .zero, configuration: configuration)
+        webView.uiDelegate = self
+
+        let session = Session(webView: webView)
+        session.delegate = self
+        session.pathConfiguration = pathConfiguration
+        return session
+    }
+
+    // MARK: - Path Configuration
+
+    private lazy var pathConfiguration = PathConfiguration(sources: [
+        .file(Bundle.main.url(forResource: "path-configuration", withExtension: "json")!),
+    ])
+}
+
+extension SceneDelegate: UIWindowSceneDelegate {
+    func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
+        guard let _ = scene as? UIWindowScene else { return }
+
+        configureRootViewController()
+
+        navigationController1.route(url: rootURL1, options: VisitOptions(action: .replace), properties: [:])
+        navigationController2.route(url: rootURL2, options: VisitOptions(action: .replace), properties: [:])
+    }
+}
+
+extension SceneDelegate: SessionDelegate {
+    func session(_ session: Session, didProposeVisit proposal: VisitProposal) {
+        navigationController().route(url: proposal.url, options: proposal.options, properties: proposal.properties)
+    }
+
+    func session(_ session: Session, didFailRequestForVisitable visitable: Visitable, error: Error) {
+        if let errorPresenter = visitable as? ErrorPresenter {
+            errorPresenter.presentError(error) { [weak self] in
+                self?.session().reload()
+            }
+        } else {
+            assertionFailure("Visit failed!")
+        }
+    }
+
+    // When a form submission completes in the modal session, we need to
+    // manually clear the snapshot cache in the default session, since we
+    // don't want potentially stale cached snapshots to be used
+    func sessionDidFinishFormSubmission(_ session: Session) {
+        if (session == modalSession) {
+            self.session().clearSnapshotCache()
+        }
+    }
+
+    func sessionDidLoadWebView(_ session: Session) {
+        session.webView.navigationDelegate = self
+    }
+
+    func sessionWebViewProcessDidTerminate(_ session: Session) {
+        session.reload()
+    }
+}
+
+extension SceneDelegate: WKNavigationDelegate {
+    func webView(_ webView: WKWebView, decidePolicyFor navigationAction: WKNavigationAction, decisionHandler: @escaping (WKNavigationActionPolicy) -> Void) {
+        if navigationAction.navigationType == .linkActivated {
+            // Any link that's not on the same domain as the Turbo root url will go through here
+            // Other links on the domain, but that have an extension that is non-html will also go here
+            // You can decide how to handle those, by default if you're not the navigationDelegate
+            // the Session will open them in the default browser
+
+            let url = navigationAction.request.url!
+
+            // For this demo, we'll load files from our domain in a SafariViewController so you
+            // don't need to leave the app. You might expand this in your app
+            // to open all audio/video/images in a native media viewer
+            if url.host == baseURL.host, !url.pathExtension.isEmpty {
+                let safariViewController = SFSafariViewController(url: url)
+                navigationController().present(safariViewController, animated: true)
+            } else {
+                UIApplication.shared.open(url)
+            }
+
+            decisionHandler(.cancel)
+        } else {
+            decisionHandler(.allow)
+        }
+    }
+}
+
+extension SceneDelegate: WKUIDelegate {
+    func webView(_ webView: WKWebView, runJavaScriptConfirmPanelWithMessage message: String, initiatedByFrame frame: WKFrameInfo, completionHandler: @escaping (Bool) -> Void) {
+        let confirm = UIAlertController(title: nil, message: message, preferredStyle: .alert)
+        confirm.addAction(UIAlertAction(title: "Cancel", style: .cancel) { _ in completionHandler(false) })
+        confirm.addAction(UIAlertAction(title: "OK", style: .default) { _ in completionHandler(true) })
+
+        // JavaScript alerts in Turbo Native
+        navigationController().present(confirm, animated: true)
+    }
+}

data/lib/turbo_native_initializer/templates/ios_tabs/TurboNativeProject/Resources/Assets.xcassets/AccentColor.colorset/Contents.json

@@ -0,0 +1,11 @@
+{
+  "colors" : [
+    {
+      "idiom" : "universal"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

data/lib/turbo_native_initializer/templates/ios_tabs/TurboNativeProject/Resources/Assets.xcassets/AppIcon.appiconset/Contents.json

@@ -0,0 +1,14 @@
+{
+  "images" : [
+    {
+      "filename" : "turbo.png",
+      "idiom" : "universal",
+      "platform" : "ios",
+      "size" : "1024x1024"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

data/lib/turbo_native_initializer/templates/ios_tabs/TurboNativeProject/Resources/Assets.xcassets/Contents.json

@@ -0,0 +1,6 @@
+{
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

data/lib/turbo_native_initializer/templates/ios_tabs/TurboNativeProject/Resources/Assets.xcassets/SplashIcon.imageset/Contents.json

@@ -0,0 +1,21 @@
+{
+  "images" : [
+    {
+      "filename" : "turbo.png",
+      "idiom" : "universal",
+      "scale" : "1x"
+    },
+    {
+      "idiom" : "universal",
+      "scale" : "2x"
+    },
+    {
+      "idiom" : "universal",
+      "scale" : "3x"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

data/lib/turbo_native_initializer/templates/ios_tabs/TurboNativeProject/Resources/Base.lproj/LaunchScreen.storyboard

@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="21701" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" launchScreen="YES" useTraitCollections="YES" useSafeAreas="YES" colorMatched="YES" initialViewController="01J-lp-oVM">
+    <device id="retina5_9" orientation="portrait" appearance="light"/>
+    <dependencies>
+        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="21679"/>
+        <capability name="Safe area layout guides" minToolsVersion="9.0"/>
+        <capability name="System colors in document resources" minToolsVersion="11.0"/>
+        <capability name="documents saved in the Xcode 8 format" minToolsVersion="8.0"/>
+    </dependencies>
+    <scenes>
+        <!--View Controller-->
+        <scene sceneID="EHf-IW-A2E">
+            <objects>
+                <viewController id="01J-lp-oVM" sceneMemberID="viewController">
+                    <view key="view" contentMode="scaleToFill" id="Ze5-6b-2t3">
+                        <rect key="frame" x="0.0" y="0.0" width="375" height="812"/>
+                        <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
+                        <subviews>
+                            <imageView clipsSubviews="YES" userInteractionEnabled="NO" contentMode="scaleAspectFit" fixedFrame="YES" image="SplashIcon" translatesAutoresizingMaskIntoConstraints="NO" id="eXr-0W-qZz">
+                                <rect key="frame" x="137" y="356" width="100" height="100"/>
+                                <autoresizingMask key="autoresizingMask" flexibleMinX="YES" flexibleMaxX="YES" flexibleMinY="YES" flexibleMaxY="YES"/>
+                            </imageView>
+                        </subviews>
+                        <viewLayoutGuide key="safeArea" id="6Tk-OE-BBY"/>
+                        <color key="backgroundColor" systemColor="systemBackgroundColor"/>
+                    </view>
+                </viewController>
+                <placeholder placeholderIdentifier="IBFirstResponder" id="iYj-Kq-Ea1" userLabel="First Responder" sceneMemberID="firstResponder"/>
+            </objects>
+            <point key="canvasLocation" x="50.399999999999999" y="373.89162561576359"/>
+        </scene>
+    </scenes>
+    <resources>
+        <image name="SplashIcon" width="1024" height="1024"/>
+        <systemColor name="systemBackgroundColor">
+            <color white="1" alpha="1" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
+        </systemColor>
+    </resources>
+</document>

data/lib/turbo_native_initializer/templates/ios_tabs/TurboNativeProject/Resources/Base.lproj/Main.storyboard

@@ -0,0 +1,69 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="21701" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" useTraitCollections="YES" useSafeAreas="YES" colorMatched="YES" initialViewController="33v-ad-2dz">
+    <device id="retina6_12" orientation="portrait" appearance="light"/>
+    <dependencies>
+        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="21679"/>
+        <capability name="Safe area layout guides" minToolsVersion="9.0"/>
+        <capability name="System colors in document resources" minToolsVersion="11.0"/>
+        <capability name="documents saved in the Xcode 8 format" minToolsVersion="8.0"/>
+    </dependencies>
+    <scenes>
+        <!--Item 2-->
+        <scene sceneID="GwE-Ch-DRP">
+            <objects>
+                <viewController id="cXb-wA-NUs" customClass="TurboNavigationController" customModule="ContactsIOS" customModuleProvider="target" sceneMemberID="viewController">
+                    <view key="view" contentMode="scaleToFill" id="WTF-II-zfk">
+                        <rect key="frame" x="0.0" y="0.0" width="393" height="852"/>
+                        <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
+                        <viewLayoutGuide key="safeArea" id="CoL-dA-Hxa"/>
+                        <color key="backgroundColor" systemColor="systemBackgroundColor"/>
+                    </view>
+                    <tabBarItem key="tabBarItem" title="Item 2" image="gear" catalog="system" id="rhZ-zi-yeq"/>
+                </viewController>
+                <placeholder placeholderIdentifier="IBFirstResponder" id="ife-PY-okT" userLabel="First Responder" customClass="UIResponder" sceneMemberID="firstResponder"/>
+            </objects>
+            <point key="canvasLocation" x="1271" y="-647"/>
+        </scene>
+        <!--Item 1-->
+        <scene sceneID="pAD-IL-Hdw">
+            <objects>
+                <viewController id="0en-nE-vJA" customClass="TurboNavigationController" customModule="ContactsIOS" customModuleProvider="target" sceneMemberID="viewController">
+                    <view key="view" contentMode="scaleToFill" id="bFn-PZ-ClM">
+                        <rect key="frame" x="0.0" y="0.0" width="393" height="852"/>
+                        <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
+                        <viewLayoutGuide key="safeArea" id="K5f-nY-Cgh"/>
+                        <color key="backgroundColor" systemColor="systemBackgroundColor"/>
+                    </view>
+                    <tabBarItem key="tabBarItem" title="Item 1" image="house" catalog="system" id="ZWo-HO-m4a"/>
+                </viewController>
+                <placeholder placeholderIdentifier="IBFirstResponder" id="GRr-XE-fAM" userLabel="First Responder" customClass="UIResponder" sceneMemberID="firstResponder"/>
+            </objects>
+            <point key="canvasLocation" x="1270" y="-1254"/>
+        </scene>
+        <!--Tab Bar Controller-->
+        <scene sceneID="So3-hc-mhH">
+            <objects>
+                <tabBarController id="33v-ad-2dz" sceneMemberID="viewController">
+                    <tabBar key="tabBar" contentMode="scaleToFill" insetsLayoutMarginsFromSafeArea="NO" id="fR1-GM-qEi">
+                        <rect key="frame" x="0.0" y="0.0" width="393" height="49"/>
+                        <autoresizingMask key="autoresizingMask"/>
+                        <color key="backgroundColor" white="0.0" alpha="0.0" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
+                    </tabBar>
+                    <connections>
+                        <segue destination="0en-nE-vJA" kind="relationship" relationship="viewControllers" id="z0u-hS-Voh"/>
+                        <segue destination="cXb-wA-NUs" kind="relationship" relationship="viewControllers" id="eJZ-00-JTF"/>
+                    </connections>
+                </tabBarController>
+                <placeholder placeholderIdentifier="IBFirstResponder" id="KRh-ez-iFz" userLabel="First Responder" customClass="UIResponder" sceneMemberID="firstResponder"/>
+            </objects>
+            <point key="canvasLocation" x="364" y="-951"/>
+        </scene>
+    </scenes>
+    <resources>
+        <image name="gear" catalog="system" width="128" height="122"/>
+        <image name="house" catalog="system" width="128" height="93"/>
+        <systemColor name="systemBackgroundColor">
+            <color white="1" alpha="1" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
+        </systemColor>
+    </resources>
+</document>

data/lib/turbo_native_initializer/templates/ios_tabs/TurboNativeProject/TurboNativeProject.swift.tt

@@ -0,0 +1,10 @@
+import Foundation
+
+struct <%= name %> {
+    private static let developmentURL = URL(string: "http://localhost:3000")!
+    private static let productionURL  = URL(string: "https://turbo-native-demo.glitch.me")!
+
+    static var baseURL:   URL { productionURL }
+    static var homeURL1:  URL { baseURL.appendingPathComponent("/") }
+    static var homeURL2:  URL { baseURL.appendingPathComponent("/") }
+}