ruby_everywhere 0.2.0 → 0.3.0

data/support/mobile/ios/App/EverywhereConfig.swift

@@ -46,6 +46,7 @@ struct EverywhereConfig: Decodable {
     let permissions: [String]?
     let splashMinSeconds: Double?
     let lazyLoadTabs: Bool?
+    let universalLinkHosts: [String]?
 
     private enum CodingKeys: String, CodingKey {
         case name
@@ -59,6 +60,7 @@ struct EverywhereConfig: Decodable {
         case permissions
         case splashMinSeconds = "splash_min_seconds"
         case lazyLoadTabs = "lazy_load_tabs"
+        case universalLinkHosts = "universal_link_hosts"
     }
 
     /// Whether the tab bar defers each non-selected tab's initial visit until
@@ -197,6 +199,25 @@ struct EverywhereConfig: Decodable {
         ]
     }
 
+    /// Whether an incoming universal link belongs to this app: https, and its
+    /// host is the app's own root host or one of the associated domains
+    /// (everywhere.yml deep_linking, injected as `universal_link_hosts`). A link
+    /// to some other site is left to Safari.
+    func handlesUniversalLink(_ url: URL) -> Bool {
+        guard url.scheme?.lowercased() == "https", let host = url.host?.lowercased() else { return false }
+        if rootURL.host?.lowercased() == host { return true }
+        return (universalLinkHosts ?? []).contains { $0.lowercased() == host }
+    }
+
+    /// The path (plus query) of an absolute URL, for re-routing a universal link
+    /// through the app's own effective root (dev override / picked instance).
+    func pathAndQuery(of url: URL) -> String {
+        guard let components = URLComponents(url: url, resolvingAgainstBaseURL: false) else { return "/" }
+        let path = components.path.isEmpty ? "/" : components.path
+        if let query = components.query, !query.isEmpty { return "\(path)?\(query)" }
+        return path
+    }
+
     /// rootURL joined with an absolute-style path (leading `/` optional).
     func url(forPath path: String) -> URL {
         let root = rootURL

data/support/mobile/ios/App/SceneDelegate.swift

@@ -39,6 +39,10 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate {
     /// The path the shell treats as the "reset the app" signal.
     private static let resetPath = "/everywhere/reset"
 
+    /// A universal link that arrived before the root existed (cold launch), held
+    /// until the first navigator/tab bar is built, then routed.
+    private var pendingUniversalLinkURL: URL?
+
     func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
         guard let windowScene = scene as? UIWindowScene else { return }
 
@@ -79,13 +83,50 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate {
         // hydration — the splash covers the wait — and the same pass mirrors
         // cookies for the auth-aware config fetch, which adds the tab bar for
         // a signed-in user.
+        // A universal link that launched the app (cold start): capture it now,
+        // route it once the root exists (below).
+        captureUniversalLink(from: connectionOptions.userActivities)
+
         syncWebViewCookiesToSharedStore { [weak self] in
             guard let self else { return }
             self.applyPathConfiguration()
+            self.routePendingUniversalLink()
             Hotwire.loadPathConfiguration(from: EverywhereConfig.pathConfigurationSources(serverOnly: true))
         }
     }
 
+    // MARK: Universal links (deep linking)
+
+    /// A universal link tapped while the app is running: route it straight to
+    /// its in-app path. Links to other sites fall through to the system.
+    func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
+        guard let url = webpageURL(from: userActivity) else { return }
+        activeNavigator.route(config.url(forPath: config.pathAndQuery(of: url)))
+    }
+
+    private func captureUniversalLink(from activities: Set<NSUserActivity>) {
+        guard let activity = activities.first(where: { $0.activityType == NSUserActivityTypeBrowsingWeb }),
+              let url = webpageURL(from: activity)
+        else { return }
+        pendingUniversalLinkURL = config.url(forPath: config.pathAndQuery(of: url))
+    }
+
+    /// The webpage URL of a browsing-web activity, but only if this app claims
+    /// its host (the associated domains) — never route someone else's link.
+    private func webpageURL(from userActivity: NSUserActivity) -> URL? {
+        guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
+              let url = userActivity.webpageURL,
+              config.handlesUniversalLink(url)
+        else { return nil }
+        return url
+    }
+
+    private func routePendingUniversalLink() {
+        guard let url = pendingUniversalLinkURL else { return }
+        pendingUniversalLinkURL = nil
+        activeNavigator.route(url)
+    }
+
     /// Refetch the server path configuration on every foreground — so a config
     /// change lands without a relaunch (the dev endpoint is uncached). Uses the
     /// server-only sources: the auth-aware source of truth, no baked flash.

data/support/mobile/ios/App.xcodeproj/project.pbxproj

@@ -16,6 +16,7 @@
 		EBE000000000000000000046 /* PermissionsComponent.swift in Sources */ = {isa = PBXBuildFile; fileRef = EBE000000000000000000045 /* PermissionsComponent.swift */; };
 		EBE000000000000000000058 /* BiometricsComponent.swift in Sources */ = {isa = PBXBuildFile; fileRef = EBE000000000000000000057 /* BiometricsComponent.swift */; };
 		EBE000000000000000000060 /* StorageComponent.swift in Sources */ = {isa = PBXBuildFile; fileRef = EBE000000000000000000059 /* StorageComponent.swift */; };
+		EBE000000000000000000068 /* MenuComponent.swift in Sources */ = {isa = PBXBuildFile; fileRef = EBE000000000000000000067 /* MenuComponent.swift */; };
 		EBE000000000000000000063 /* EverywhereHost.swift in Sources */ = {isa = PBXBuildFile; fileRef = EBE000000000000000000062 /* EverywhereHost.swift */; };
 		EBE000000000000000000036 /* everywhere.json in Resources */ = {isa = PBXBuildFile; fileRef = EBE000000000000000000018 /* everywhere.json */; };
 		EBE000000000000000000037 /* path-configuration.json in Resources */ = {isa = PBXBuildFile; fileRef = EBE000000000000000000019 /* path-configuration.json */; };
@@ -38,6 +39,7 @@
 		EBE000000000000000000045 /* PermissionsComponent.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PermissionsComponent.swift; sourceTree = "<group>"; };
 		EBE000000000000000000057 /* BiometricsComponent.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = BiometricsComponent.swift; sourceTree = "<group>"; };
 		EBE000000000000000000059 /* StorageComponent.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = StorageComponent.swift; sourceTree = "<group>"; };
+		EBE000000000000000000067 /* MenuComponent.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MenuComponent.swift; sourceTree = "<group>"; };
 		EBE000000000000000000018 /* everywhere.json */ = {isa = PBXFileReference; lastKnownFileType = text.json; path = everywhere.json; sourceTree = "<group>"; };
 		EBE000000000000000000019 /* path-configuration.json */ = {isa = PBXFileReference; lastKnownFileType = text.json; path = "path-configuration.json"; sourceTree = "<group>"; };
 		EBE000000000000000000020 /* Assets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; path = Assets.xcassets; sourceTree = "<group>"; };
@@ -105,6 +107,7 @@
 				EBE000000000000000000045 /* PermissionsComponent.swift */,
 				EBE000000000000000000057 /* BiometricsComponent.swift */,
 				EBE000000000000000000059 /* StorageComponent.swift */,
+				EBE000000000000000000067 /* MenuComponent.swift */,
 			);
 			path = Bridge;
 			sourceTree = "<group>";
@@ -210,6 +213,7 @@
 				EBE000000000000000000046 /* PermissionsComponent.swift in Sources */,
 				EBE000000000000000000058 /* BiometricsComponent.swift in Sources */,
 				EBE000000000000000000060 /* StorageComponent.swift in Sources */,
+				EBE000000000000000000068 /* MenuComponent.swift in Sources */,
 				EBE000000000000000000063 /* EverywhereHost.swift in Sources */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;

data/support/mobile/ios/README.md

@@ -19,6 +19,13 @@ this template, it overwrites **exactly** these files and nothing else:
 4. `App/Assets.xcassets/AppIcon.appiconset/AppIcon.png` — the app icon (1024×1024 opaque PNG)
 5. *(optionally)* `App/Assets.xcassets/AccentColor.colorset/Contents.json` and
    `App/Assets.xcassets/LaunchBackground.colorset/Contents.json` — brand colors
+6. *(optionally)* `App/App.entitlements` — the Associated Domains entitlement,
+   written **only** when `deep_linking:` is set in `everywhere.yml`. The matching
+   `CODE_SIGN_ENTITLEMENTS` is added to the xcconfig in the same case, so the
+   default build stays entitlement-free and the frozen template still compiles
+   unchanged. The gem serves the `/.well-known/apple-app-site-association` file
+   these domains point at; `SceneDelegate` routes an incoming universal link to
+   its in-app path.
 
 Everything the CLI needs to vary per app flows through those files. The product
 is always `App.app` (`PRODUCT_NAME = App` is hardcoded); identity comes from the

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_everywhere
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Andrea Fomera
@@ -79,6 +79,7 @@ files:
 - bridge/LICENSE
 - bridge/README.md
 - bridge/everywhere/bridge.js
+- bridge/everywhere/native.css
 - bridge/package.json
 - config/importmap.rb
 - exe/every
@@ -146,6 +147,7 @@ files:
 - support/mobile/ios/App/Base.lproj/LaunchScreen.storyboard
 - support/mobile/ios/App/Bridge/BiometricsComponent.swift
 - support/mobile/ios/App/Bridge/HapticsComponent.swift
+- support/mobile/ios/App/Bridge/MenuComponent.swift
 - support/mobile/ios/App/Bridge/NotificationComponent.swift
 - support/mobile/ios/App/Bridge/PermissionsComponent.swift
 - support/mobile/ios/App/Bridge/StorageComponent.swift