progress

Author: blazeu

Demo/InertiaDemo/InertiaDemo.swift

@@ -0,0 +1,53 @@
+import UIKit
+import HotwireNative
+
+@main
+class AppDelegate: UIResponder, UIApplicationDelegate {
+    var window: UIWindow?
+    
+    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
+        // Configure Inertia
+        Inertia.config.showDoneButtonOnModals = true
+        Inertia.config.debugLoggingEnabled = true
+        
+        // Create window
+        window = UIWindow(frame: UIScreen.main.bounds)
+        
+        // Set up the root view controller
+        let url = URL(string: "https://your-inertia-app.com")!
+        let navigationController = Inertia.navigate(to: url)
+        
+        window?.rootViewController = navigationController
+        window?.makeKeyAndVisible()
+        
+        return true
+    }
+}
+
+// Custom Inertia web view controller
+class CustomInertiaViewController: InertiaWebViewController {
+    override func viewDidLoad() {
+        super.viewDidLoad()
+        
+        // Add a refresh control
+        let refreshControl = UIRefreshControl()
+        refreshControl.addTarget(self, action: #selector(refresh), for: .valueChanged)
+        session.webView.scrollView.refreshControl = refreshControl
+    }
+    
+    @objc func refresh() {
+        session.reload()
+        session.webView.scrollView.refreshControl?.endRefreshing()
+    }
+    
+    // Handle Inertia.js events
+    override func inertiaSession(_ session: InertiaSession, didNavigateToPage url: String, component: String, props: [String: Any]?) {
+        super.inertiaSession(session, didNavigateToPage: url, component: component, props: props)
+        
+        // Log navigation
+        print("Navigated to \(component) at \(url)")
+        if let props = props {
+            print("Props: \(props)")
+        }
+    }
+} 

Package.swift

@@ -24,7 +24,8 @@ let package = Package(
             path: "Source",
             resources: [
                 .copy("Turbo/WebView/turbo.js"),
-                .copy("Bridge/bridge.js")
+                .copy("Bridge/bridge.js"),
+                .copy("Inertia/inertia-bridge.js")
             ]
         ),
         .testTarget(

README.md

@@ -3,11 +3,16 @@
 ![Swift](https://img.shields.io/badge/Swift-5.3-blue)
 ![iOS](https://img.shields.io/badge/iOS-14+-green)
 ![Turbo](https://img.shields.io/badge/Turbo-7+-purple)
+![Inertia](https://img.shields.io/badge/Inertia-1.0+-orange)
 
 [Hotwire Native](https://native.hotwired.dev) is a high-level native framework, available for iOS and Android, that provides you with all the tools you need to leverage your web app and build great mobile apps.
 
 This native Swift library integrates with your [Hotwire](https://hotwired.dev) web app by wrapping it in a native iOS shell. It manages a single WKWebView instance across multiple view controllers, giving you native navigation UI with all the client-side performance benefits of Hotwire.
 
+## Inertia.js Support
+
+This fork adds support for [Inertia.js](https://inertiajs.com/) applications, allowing you to build single-page applications using server-side frameworks like Laravel, Rails, or Django with native iOS navigation and components. See the [Inertia.js integration documentation](Source/Inertia/README.md) for more details.
+
 Read more on [native.hotwired.dev](https://native.hotwired.dev).
 
 ## Contributing
@@ -16,6 +21,6 @@ Hotwire Native for iOS is open-source software, freely distributable under the t
 
 We welcome contributions in the form of bug reports, pull requests, or thoughtful discussions in the [GitHub issue tracker](https://github.com/hotwired/hotwire-native-bridge/issues).
 
----------
+---
 
 © 2024 37signals LLC

Source/Inertia/Inertia.swift

@@ -0,0 +1,39 @@
+import WebKit
+
+/// Main entry point for Inertia.js integration
+public enum Inertia {
+    /// Use this instance to configure Inertia.js integration
+    public static var config = InertiaConfig()
+    
+    /// Registers your bridge components to use with `InertiaWebViewController`.
+    ///
+    /// Use `Inertia.config.makeCustomWebView` to customize the web view or web view
+    /// configuration further.
+    public static func registerBridgeComponents(_ componentTypes: [BridgeComponent.Type]) {
+        bridgeComponentTypes = componentTypes
+    }
+    
+    /// Creates a new Inertia navigation controller with the given URL
+    /// - Parameter url: The URL to load
+    /// - Returns: A new InertiaNavigationController
+    public static func navigate(to url: URL) -> InertiaNavigationController {
+        return InertiaNavigationController(url: url)
+    }
+    
+    /// Injects the Inertia.js bridge script into a web view configuration
+    /// - Parameter configuration: The web view configuration to modify
+    /// - Returns: The modified configuration
+    public static func injectBridge(into configuration: WKWebViewConfiguration) -> WKWebViewConfiguration {
+        guard let bridgeURL = Bundle.module.url(forResource: "inertia-bridge", withExtension: "js"),
+              let bridgeScript = try? String(contentsOf: bridgeURL) else {
+            return configuration
+        }
+        
+        let userScript = WKUserScript(source: bridgeScript, injectionTime: .atDocumentStart, forMainFrameOnly: true)
+        configuration.userContentController.addUserScript(userScript)
+        return configuration
+    }
+    
+    /// Bridge component types registered with the Inertia.js integration
+    static var bridgeComponentTypes = [BridgeComponent.Type]()
+} 

Source/Inertia/InertiaConfig.swift

@@ -0,0 +1,93 @@
+import UIKit
+import WebKit
+
+/// Configuration for Inertia.js integration
+public struct InertiaConfig {
+    public typealias WebViewBlock = (_ configuration: WKWebViewConfiguration) -> WKWebView
+    
+    /// Set a custom user agent application prefix for every WKWebView instance.
+    ///
+    /// The library will automatically append a substring to your prefix
+    /// which includes:
+    /// - "Inertia Native iOS;"
+    /// - "bridge-components: [your bridge components];"
+    ///
+    /// WKWebView's default user agent string will also appear at the
+    /// beginning of the user agent.
+    public var applicationUserAgentPrefix: String? = nil
+    
+    /// When enabled, adds a `UIBarButtonItem` of type `.done` to the left
+    /// navigation bar button item on screens presented modally.
+    public var showDoneButtonOnModals = false
+    
+    /// Sets the back button display mode of `InertiaWebViewController`.
+    public var backButtonDisplayMode = UINavigationItem.BackButtonDisplayMode.default
+    
+    /// Enable or disable debug logging for Inertia visits and bridge elements
+    /// connecting, disconnecting, receiving/sending messages, and more.
+    public var debugLoggingEnabled = false {
+        didSet {
+            HotwireLogger.debugLoggingEnabled = debugLoggingEnabled
+        }
+    }
+    
+    /// Gets the user agent that the library builds to identify the app
+    /// and its registered bridge components.
+    ///
+    /// The user agent includes:
+    /// - Your (optional) custom `applicationUserAgentPrefix`
+    /// - "Native iOS; Inertia Native iOS;"
+    /// - "bridge-components: [your bridge components];"
+    public var userAgent: String {
+        get {
+            return UserAgent.build(
+                applicationPrefix: applicationUserAgentPrefix,
+                componentTypes: Inertia.bridgeComponentTypes
+            )
+        }
+    }
+    
+    /// Optionally customize the web views used by each Inertia Session.
+    /// Ensure you return a new instance each time.
+    public var makeCustomWebView: WebViewBlock = { (configuration: WKWebViewConfiguration) in
+        WKWebView.debugInspectable(configuration: configuration)
+    }
+    
+    /// Set a custom JSON encoder when parsing bridge payloads.
+    /// The custom encoder can be useful when you need to apply specific
+    /// encoding strategies, like snake case vs. camel case
+    public var jsonEncoder = JSONEncoder()
+    
+    /// Set a custom JSON decoder when parsing bridge payloads.
+    /// The custom decoder can be useful when you need to apply specific
+    /// decoding strategies, like snake case vs. camel case
+    public var jsonDecoder = JSONDecoder()
+    
+    // MARK: - Internal
+    
+    public func makeWebView() -> WKWebView {
+        let configuration = makeWebViewConfiguration()
+        let webView = makeCustomWebView(configuration)
+        
+        if !Inertia.bridgeComponentTypes.isEmpty {
+            Bridge.initialize(webView)
+        }
+        
+        return webView
+    }
+    
+    // MARK: - Private
+    
+    private let sharedProcessPool = WKProcessPool()
+    
+    // A method (not a property) because we need a new instance for each web view.
+    private func makeWebViewConfiguration() -> WKWebViewConfiguration {
+        let configuration = WKWebViewConfiguration()
+        configuration.defaultWebpagePreferences?.preferredContentMode = .mobile
+        configuration.applicationNameForUserAgent = userAgent
+        configuration.processPool = sharedProcessPool
+        
+        // Inject the Inertia bridge script
+        return Inertia.injectBridge(into: configuration)
+    }
+} 

Source/Inertia/InertiaNavigationController.swift

@@ -0,0 +1,55 @@
+import UIKit
+
+/// A navigation controller for Inertia.js web views
+open class InertiaNavigationController: UINavigationController {
+    /// The shared session for all view controllers in this navigation stack
+    public let session: InertiaSession
+    
+    /// Initialize with a root view controller and optional session
+    /// - Parameters:
+    ///   - rootViewController: The root view controller
+    ///   - session: An optional InertiaSession. If nil, a new session will be created.
+    public init(rootViewController: UIViewController, session: InertiaSession? = nil) {
+        self.session = session ?? InertiaSession(webView: Inertia.config.makeWebView())
+        super.init(rootViewController: rootViewController)
+    }
+    
+    /// Initialize with a URL to load
+    /// - Parameters:
+    ///   - url: The URL to load
+    ///   - session: An optional InertiaSession. If nil, a new session will be created.
+    public convenience init(url: URL, session: InertiaSession? = nil) {
+        let sharedSession = session ?? InertiaSession(webView: Inertia.config.makeWebView())
+        let rootViewController = InertiaWebViewController(url: url, session: sharedSession)
+        self.init(rootViewController: rootViewController, session: sharedSession)
+    }
+    
+    required public init?(coder aDecoder: NSCoder) {
+        fatalError("init(coder:) has not been implemented")
+    }
+    
+    /// Push a new Inertia web view controller onto the navigation stack
+    /// - Parameter url: The URL to load
+    /// - Returns: The pushed view controller
+    @discardableResult
+    public func push(url: URL) -> InertiaWebViewController {
+        let viewController = InertiaWebViewController(url: url, session: session)
+        pushViewController(viewController, animated: true)
+        return viewController
+    }
+    
+    /// Present a new Inertia web view controller modally
+    /// - Parameters:
+    ///   - url: The URL to load
+    ///   - animated: Whether to animate the presentation
+    ///   - completion: A completion handler
+    /// - Returns: The presented navigation controller
+    @discardableResult
+    public func present(url: URL, animated: Bool = true, completion: (() -> Void)? = nil) -> InertiaNavigationController {
+        // Create a new session for the modal
+        let modalSession = InertiaSession(webView: Inertia.config.makeWebView())
+        let navigationController = InertiaNavigationController(url: url, session: modalSession)
+        present(navigationController, animated: animated, completion: completion)
+        return navigationController
+    }
+}