RubyGems - ruby_everywhere - Versions diffs - 0.1.15 → 0.2.0 - Mend

ruby_everywhere 0.1.15 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (59) hide show

checksums.yaml +4 -4
data/bridge/README.md +57 -2
data/bridge/everywhere/bridge.js +803 -9
data/bridge/package.json +1 -1
data/lib/everywhere/builders/ios.rb +364 -0
data/lib/everywhere/cli.rb +2 -0
data/lib/everywhere/commands/build.rb +17 -1
data/lib/everywhere/commands/clean.rb +19 -10
data/lib/everywhere/commands/dev.rb +182 -19
data/lib/everywhere/commands/doctor.rb +45 -3
data/lib/everywhere/commands/icon.rb +14 -0
data/lib/everywhere/commands/install.rb +37 -6
data/lib/everywhere/commands/logs.rb +56 -0
data/lib/everywhere/commands/platform/build.rb +3 -3
data/lib/everywhere/commands/platform/runner.rb +1 -1
data/lib/everywhere/commands/release.rb +1 -1
data/lib/everywhere/commands/shell_dir.rb +11 -4
data/lib/everywhere/config.rb +366 -1
data/lib/everywhere/engine.rb +33 -1
data/lib/everywhere/icon.rb +50 -0
data/lib/everywhere/log_filter.rb +28 -2
data/lib/everywhere/mobile_config_endpoint.rb +75 -0
data/lib/everywhere/mobile_configs_controller.rb +46 -0
data/lib/everywhere/native_helper.rb +156 -0
data/lib/everywhere/paths.rb +41 -0
data/lib/everywhere/raster.rb +17 -0
data/lib/everywhere/shellout.rb +3 -1
data/lib/everywhere/simulator.rb +74 -0
data/lib/everywhere/ui.rb +18 -0
data/lib/everywhere/version.rb +1 -1
data/support/mobile/ios/App/App.xcconfig +6 -0
data/support/mobile/ios/App/AppDelegate.swift +163 -0
data/support/mobile/ios/App/Assets.xcassets/AccentColor.colorset/Contents.json +20 -0
data/support/mobile/ios/App/Assets.xcassets/AppIcon.appiconset/AppIcon.png +0 -0
data/support/mobile/ios/App/Assets.xcassets/AppIcon.appiconset/Contents.json +14 -0
data/support/mobile/ios/App/Assets.xcassets/Contents.json +6 -0
data/support/mobile/ios/App/Assets.xcassets/LaunchBackground.colorset/Contents.json +38 -0
data/support/mobile/ios/App/Base.lproj/LaunchScreen.storyboard +32 -0
data/support/mobile/ios/App/Bridge/BiometricsComponent.swift +276 -0
data/support/mobile/ios/App/Bridge/HapticsComponent.swift +47 -0
data/support/mobile/ios/App/Bridge/NotificationComponent.swift +56 -0
data/support/mobile/ios/App/Bridge/PermissionsComponent.swift +142 -0
data/support/mobile/ios/App/Bridge/StorageComponent.swift +63 -0
data/support/mobile/ios/App/ErrorViewController.swift +64 -0
data/support/mobile/ios/App/EverywhereConfig.swift +268 -0
data/support/mobile/ios/App/EverywhereHost.swift +34 -0
data/support/mobile/ios/App/Extensions/EverywhereExtensions.swift +32 -0
data/support/mobile/ios/App/Info.plist +28 -0
data/support/mobile/ios/App/Resources/everywhere.json +8 -0
data/support/mobile/ios/App/Resources/path-configuration.json +19 -0
data/support/mobile/ios/App/SceneDelegate.swift +443 -0
data/support/mobile/ios/App.xcodeproj/project.pbxproj +454 -0
data/support/mobile/ios/App.xcodeproj/project.xcworkspace/contents.xcworkspacedata +7 -0
data/support/mobile/ios/App.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +14 -0
data/support/mobile/ios/App.xcodeproj/xcshareddata/xcschemes/App.xcscheme +77 -0
data/support/mobile/ios/NativeExtensions/Package.swift +26 -0
data/support/mobile/ios/NativeExtensions/Sources/NativeExtensions/Exports.swift +5 -0
data/support/mobile/ios/README.md +66 -0
metadata +35 -1

data/lib/everywhere/native_helper.rb ADDED Viewed

@@ -0,0 +1,156 @@
+# frozen_string_literal: true
+require "erb"
+require "json"
+module Everywhere
+  # Server-side view helpers mirroring the JS bridge's platform detection, so
+  # ERB can branch on the native shell the same way `Everywhere.platform`
+  # does on the client:
+  #
+  #   <%= link_to "Install the app", … unless native_app? %>
+  #   <div class="<%= "native-inset" if native_app? %>">
+  #   <% if native_version && native_version >= Gem::Version.new("1.2") %>
+  #
+  # Detection is by User-Agent: the RubyEverywhere shells prepend
+  # "RubyEverywhere/<version> (<os>)" to Hotwire Native's own
+  # "Hotwire Native iOS/Android" marker. Included into all Rails views by
+  # Everywhere::Engine.
+  module NativeHelper
+    # True inside any RubyEverywhere native shell (iOS or Android).
+    def native_app?
+      !native_platform.nil?
+    end
+    # :ios, :android, or nil in a plain browser. Reads Hotwire Native's UA
+    # marker, so it's correct even before the JS bridge has booted.
+    def native_platform
+      ua = _everywhere_user_agent or return nil
+      return :ios if ua.include?("Hotwire Native iOS")
+      return :android if ua.include?("Hotwire Native Android")
+      nil
+    end
+    # The shell's version as a Gem::Version (from the "RubyEverywhere/<ver>"
+    # UA prefix), or nil outside the shell / when unparseable. Use it to gate
+    # features that need a newer shell than some users have installed.
+    def native_version
+      ua = _everywhere_user_agent or return nil
+      match = ua.match(%r{RubyEverywhere/([\w.\-]+)}) or return nil
+      Gem::Version.new(match[1])
+    rescue ArgumentError
+      nil
+    end
+    # Where to send the user after an auth change. In a native shell, route
+    # through the reset page (/everywhere/reset) so the app rebuilds cleanly —
+    # fresh web views, re-fetched tabs — then lands on `to`. In a browser it's
+    # just `to`. Use it in controllers:
+    #
+    #   redirect_to everywhere_auth_redirect(after_authentication_url)
+    #
+    # `to` may be a full URL or a path; only the same-origin path is forwarded.
+    def everywhere_auth_redirect(to)
+      return to unless native_app? && respond_to?(:everywhere_reset_path)
+      path = to.to_s.sub(%r{\Ahttps?://[^/]+}, "")
+      path = "/" if path.empty? || !path.start_with?("/")
+      everywhere_reset_path(to: path)
+    end
+    # App icon badge count, server-rendered. Emits a meta tag the JS bridge
+    # applies on every Turbo visit — CSP-safe (no inline script) and correct
+    # on the first paint. 0 clears the badge. Put it in the layout <head>:
+    #
+    #   <%= everywhere_badge Current.user.unread_count %>
+    #
+    # In the mobile shell this badges the app icon; in an installed PWA the
+    # Badging API; elsewhere it renders inert metadata.
+    def everywhere_badge(count)
+      tag.meta(name: "everywhere:badge", content: count.to_i)
+    end
+    # Native tab bar badge for the tab whose everywhere.yml path is `path`.
+    # Same delivery as everywhere_badge; 0 clears. Mobile shell only.
+    #
+    #   <%= everywhere_tab_badge "/inbox", Current.user.unread_count %>
+    def everywhere_tab_badge(path, count)
+      tag.meta(name: "everywhere:tab-badge",
+               content: JSON.generate({ path: path, count: count.to_i }))
+    end
+    # Biometric gate: wraps sensitive markup so the mobile shell keeps it
+    # hidden until Face ID / Touch ID passes — but only when the user has the
+    # device-local lock turned on (everywhere_biometric_toggle, or
+    # Everywhere.biometrics.setLockEnabled). Browsers and the desktop shell
+    # render the content plainly. Requires `biometrics` in everywhere.yml's
+    # permissions.
+    #
+    #   <%= everywhere_biometric_lock reason: "Unlock account settings" do %>
+    #     ...profile, password, sessions...
+    #   <% end %>
+    #
+    # `name` keys the once-per-session unlock (defaults to the page path).
+    # For a fully custom overlay, hand-write the contract this emits:
+    #
+    #   <div data-everywhere-biometric-lock="<name>"
+    #        data-everywhere-biometric-reason="…" data-everywhere-biometric-passcode>
+    #     <div data-everywhere-biometric-content hidden>…</div>
+    #     <div data-everywhere-biometric-locked hidden>
+    #       <button data-everywhere-biometric-unlock>Unlock</button>
+    #     </div>
+    #   </div>
+    def everywhere_biometric_lock(reason: nil, name: nil, allow_passcode: true,
+                                  unlock_label: "Unlock", locked_message: nil,
+                                  wrapper_class: nil, locked_class: nil,
+                                  message_class: nil, unlock_class: nil, &block)
+      content = respond_to?(:capture) ? capture(&block) : block.call
+      return content unless native_app?
+      attrs = [%(data-everywhere-biometric-lock="#{_everywhere_attr(name)}")]
+      attrs << %(data-everywhere-biometric-reason="#{_everywhere_attr(reason)}") if reason
+      attrs << "data-everywhere-biometric-passcode" if allow_passcode
+      attrs << %(class="#{_everywhere_attr(wrapper_class)}") if wrapper_class
+      html = +"<div #{attrs.join(" ")}>"
+      html << %(<div data-everywhere-biometric-content hidden>#{content}</div>)
+      html << %(<div data-everywhere-biometric-locked hidden#{%( class="#{_everywhere_attr(locked_class)}") if locked_class}>)
+      html << %(<p#{%( class="#{_everywhere_attr(message_class)}") if message_class}>#{_everywhere_attr(locked_message)}</p>) if locked_message
+      html << %(<button type="button" data-everywhere-biometric-unlock#{%( class="#{_everywhere_attr(unlock_class)}") if unlock_class}>#{_everywhere_attr(unlock_label)}</button>)
+      html << "</div></div>"
+      html.respond_to?(:html_safe) ? html.html_safe : html
+    end
+    # The settings switch for the device-local biometric lock. Renders hidden
+    # and disabled; the bridge reveals and enables it only in the mobile shell
+    # with working biometrics (toggling runs the biometric check first). Put
+    # `data-everywhere-biometric-toggle-row` + `hidden` on the surrounding row
+    # to reveal the whole thing together:
+    #
+    #   <div data-everywhere-biometric-toggle-row hidden>
+    #     <label>Require Face ID <%= everywhere_biometric_toggle %></label>
+    #   </div>
+    def everywhere_biometric_toggle(css_class: nil, id: nil)
+      attrs = +""
+      attrs << %( id="#{_everywhere_attr(id)}") if id
+      attrs << %( class="#{_everywhere_attr(css_class)}") if css_class
+      html = %(<input type="checkbox" hidden disabled data-everywhere-biometric-toggle#{attrs}>)
+      html.respond_to?(:html_safe) ? html.html_safe : html
+    end
+    private
+    def _everywhere_attr(value)
+      ERB::Util.html_escape(value.to_s)
+    end
+    def _everywhere_user_agent
+      return unless respond_to?(:request) && request
+      ua = request.user_agent
+      ua unless ua.nil? || ua.empty?
+    end
+  end
+end

data/lib/everywhere/paths.rb CHANGED Viewed

@@ -33,11 +33,52 @@ module Everywhere
                            "reinstall ruby_everywhere or pass --shell-dir")
     end
+    # The Hotwire Native iOS shell template bundled inside the gem:
+    # support/mobile/ios/ holds a frozen Xcode project the CLI stamps per-app
+    # (xcconfig + everywhere.json + AppIcon — never the pbxproj). The mobile/
+    # parent leaves room for support/mobile/android later.
+    def bundled_ios_dir
+      File.join(gem_root, "support", "mobile", "ios")
+    end
+    # Absolute path to the iOS template, or nil if the bundled copy is missing
+    # (a corrupt/partial install).
+    def ios_dir
+      bundled_ios_dir if File.exist?(File.join(bundled_ios_dir, "App.xcodeproj", "project.pbxproj"))
+    end
+    # Like #ios_dir but aborts with a helpful message when the template is
+    # missing. The --template-dir hint covers dev on a modified template.
+    def ios_dir!
+      ios_dir or UI.die!("couldn't find the bundled iOS template at #{bundled_ios_dir}; " \
+                         "reinstall ruby_everywhere or pass --template-dir")
+    end
     # Per-user cache dir. Keeps heavy build state out of the gem and the app.
     def cache_dir
       File.expand_path(ENV["RUBYEVERYWHERE_HOME"] || "~/.rubyeverywhere")
     end
+    # The stamped copy of the iOS template for one app. Persistent (not a
+    # tmpdir) on purpose: a stable project path keeps Xcode's incremental state
+    # valid across builds, and users can open the stamped project in Xcode.
+    def ios_work_dir(bundle_id)
+      File.join(cache_dir, "ios", bundle_id)
+    end
+    # Where xcodebuild writes DerivedData for iOS shell builds. Shared across
+    # apps like cargo_target_dir — safe because the product is always App.app;
+    # worst case a mismatch is a cache miss, never a wrong artifact.
+    def ios_derived_data_dir
+      File.join(cache_dir, "ios-derived-data")
+    end
+    # Where SPM clones the shell's package dependencies (hotwire-native-ios),
+    # so resolution is warm/offline after the first build.
+    def ios_packages_dir
+      File.join(cache_dir, "ios-packages")
+    end
     # Where cargo writes the shell's build output (CARGO_TARGET_DIR). Redirected
     # here so cargo never dumps a multi-GB target/ into the installed gem, and so
     # the shell compiles warm across projects — the shell source is identical for

data/lib/everywhere/raster.rb CHANGED Viewed

@@ -25,6 +25,23 @@ module Everywhere
       new(width, height)
     end
+    # A copy composited over an opaque background color ([r, g, b] bytes) —
+    # straight alpha blend, result fully opaque. Flattens icons for stores
+    # that reject alpha channels (the iOS App Store).
+    def flatten_onto(rgb)
+      out = "\x00".b * (width * height * 4)
+      (width * height).times do |p|
+        i = p * 4
+        a = pixels.getbyte(i + 3)
+        3.times do |c|
+          out.setbyte(i + c, a == 255 ? pixels.getbyte(i + c)
+                             : ((pixels.getbyte(i + c) * a + rgb[c] * (255 - a)) / 255.0).round)
+        end
+        out.setbyte(i + 3, 255)
+      end
+      self.class.new(width, height, out)
+    end
     # Decode a PNG file into a Raster, or nil if it's a flavor PNG.decode_rgba
     # can't read (palette, 16-bit, interlaced, grayscale).
     def self.decode_png(path)

data/lib/everywhere/shellout.rb CHANGED Viewed

@@ -72,8 +72,10 @@ module Everywhere
     end
     private_class_method :emit
+    # pgroup: the child leads its own process group so teardown can TERM the
+    # whole tree (foreman + watchers) without signalling the CLI itself.
     def spawn(env, cmd, chdir:)
-      unbundled { Process.spawn(env, cmd, chdir: chdir) }
+      unbundled { Process.spawn(env, cmd, chdir: chdir, pgroup: true) }
     end
   end
 end

data/lib/everywhere/simulator.rb ADDED Viewed

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+require "json"
+require_relative "shellout"
+require_relative "ui"
+module Everywhere
+  # Thin wrappers around `xcrun simctl` — just enough to boot a Simulator,
+  # install the stamped shell and launch it. Anything fancier (choosing
+  # devices, multiple simulators) belongs in the user's own Xcode workflow.
+  module Simulator
+    module_function
+    # UDID of a booted iPhone Simulator, or nil.
+    def booted_udid
+      devices.find { |d| d["state"] == "Booted" }&.fetch("udid", nil)
+    end
+    # Boot the newest available iPhone (or reuse a booted one) and bring the
+    # Simulator app to the foreground. Returns the UDID.
+    def boot_default!
+      if (udid = booted_udid)
+        Shellout.run?("open", "-a", "Simulator", quiet: true)
+        return udid
+      end
+      device = devices.reverse.find { |d| d["name"].to_s.match?(/\AiPhone/) } || devices.last
+      UI.die!("no iOS Simulator devices — open Xcode once to install a Simulator runtime") unless device
+      UI.step("booting simulator #{UI.bold(device["name"])}")
+      Shellout.run?("xcrun", "simctl", "boot", device["udid"], quiet: true) # races `open` starting it; harmless
+      Shellout.run?("open", "-a", "Simulator", quiet: true)
+      wait_until_booted(device["udid"])
+      device["udid"]
+    end
+    def install(udid, app_path)
+      out, status = Shellout.capture("xcrun", "simctl", "install", udid, app_path)
+      UI.die!("simctl install failed: #{out.strip}") unless status&.success?
+    end
+    # Launch (relaunching if already running). Env vars are forwarded into the
+    # app's process via simctl's SIMCTL_CHILD_ prefix — how the dev URL
+    # reaches the shell without restamping the bundle.
+    def launch(udid, bundle_id, env: {})
+      child_env = env.transform_keys { |k| "SIMCTL_CHILD_#{k}" }
+      out, status = Shellout.capture(child_env,
+                                     "xcrun", "simctl", "launch",
+                                     "--terminate-running-process", udid, bundle_id)
+      UI.die!("simctl launch failed: #{out.strip}") unless status&.success?
+    end
+    # Available devices of the current runtime set, oldest runtime first —
+    # `.last` / `reverse.find` therefore prefer the newest.
+    def devices
+      out, status = Shellout.capture("xcrun", "simctl", "list", "devices", "available", "-j")
+      return [] unless status&.success?
+      JSON.parse(out).fetch("devices", {}).sort.flat_map { |_runtime, list| list }
+    rescue JSON::ParserError
+      []
+    end
+    def wait_until_booted(udid, timeout: 60)
+      deadline = Time.now + timeout
+      until Time.now > deadline
+        return if devices.any? { |d| d["udid"] == udid && d["state"] == "Booted" }
+        sleep 1
+      end
+      UI.die!("simulator never finished booting")
+    end
+  end
+end

data/lib/everywhere/ui.rb CHANGED Viewed

@@ -31,6 +31,24 @@ module Everywhere
     def cyan(t)    = paint(t, 36)
     def gray(t)    = paint(t, 90) # bright black — dimmer than dim() on most themes
+    # Display casing for os tokens. Target IDs ("macos-arm64") stay lowercase
+    # wherever they're typed or stored; use these only in human-facing output.
+    OS_LABELS = {
+      "macos"   => "macOS",
+      "ios"     => "iOS",
+      "android" => "Android",
+      "windows" => "Windows",
+      "linux"   => "Linux"
+    }.freeze
+    def os_label(os) = OS_LABELS.fetch(os.to_s, os.to_s)
+    # "macos-arm64" → "macOS-arm64"
+    def target_label(target)
+      os, arch = target.to_s.split("-", 2)
+      [ os_label(os), arch ].compact.join("-")
+    end
     # --- output levels --------------------------------------------------------
     #
     #   phase   ●  a major phase boundary (build / sign / notarize)

data/lib/everywhere/version.rb CHANGED Viewed

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 module Everywhere
-  VERSION = "0.1.15"
+  VERSION = "0.2.0"
   # Version of the @rubyeverywhere/bridge JS this gem ships. bridge/ in the
   # gem IS the npm package (served to Rails apps by Everywhere::Engine,

data/support/mobile/ios/App/App.xcconfig ADDED Viewed

@@ -0,0 +1,6 @@
+// Overwritten by `every build --target ios-*` on every stamp — do not edit by hand.
+PRODUCT_BUNDLE_IDENTIFIER = com.rubyeverywhere.app
+MARKETING_VERSION = 0.1.0
+CURRENT_PROJECT_VERSION = 1
+INFOPLIST_KEY_CFBundleDisplayName = RubyEverywhere
+DEVELOPMENT_TEAM =

data/support/mobile/ios/App/AppDelegate.swift ADDED Viewed

@@ -0,0 +1,163 @@
+import HotwireNative
+import UIKit
+import UserNotifications
+import WebKit
+@main
+class AppDelegate: UIResponder, UIApplicationDelegate {
+    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
+        configureAppearance()
+        configureHotwire()
+        UNUserNotificationCenter.current().delegate = self
+        return true
+    }
+    // MARK: UISceneSession Lifecycle
+    func application(_ application: UIApplication, configurationForConnecting connectingSceneSession: UISceneSession, options: UIScene.ConnectionOptions) -> UISceneConfiguration {
+        UISceneConfiguration(name: "Default", sessionRole: connectingSceneSession.role)
+    }
+    // MARK: Configuration
+    private func configureAppearance() {
+        // Make navigation bars opaque.
+        UINavigationBar.appearance().scrollEdgeAppearance = .init()
+    }
+    private func configureHotwire() {
+        let config = EverywhereConfig.shared
+        // The path configuration (rules + auth-gated tabs) is loaded by the
+        // SceneDelegate once a scene connects — it mirrors the web view's
+        // cookies into the shared store first, so the auth-gated tab list is
+        // fetched as the signed-in user (see SceneDelegate.loadPathConfiguration).
+        Hotwire.config.applicationUserAgentPrefix = config.userAgentPrefix
+        Hotwire.config.backButtonDisplayMode = .minimal
+        Hotwire.config.showDoneButtonOnModals = true
+        #if DEBUG
+        Hotwire.config.debugLoggingEnabled = true
+        #endif
+        Hotwire.registerBridgeComponents([
+            NotificationComponent.self,
+            HapticsComponent.self,
+            PermissionsComponent.self,
+            BiometricsComponent.self,
+            StorageComponent.self
+        ] + EverywhereExtensions.components)
+        // Handles Everywhere.reloadTabs() from the page (a dedicated message
+        // handler, so it works regardless of which bridge components are
+        // mounted). Posts a notification the SceneDelegate acts on.
+        let controlHandler = WebControlHandler()
+        // Mirrors the framework's default web view factory (WKWebView.debugInspectable):
+        // the configuration we receive already carries Hotwire's process pool and
+        // user agent, so we only add our user script before creating the web view.
+        Hotwire.config.makeCustomWebView = { configuration in
+            // Expose the app's identity to the page before any of its scripts
+            // run. Built here, per web view: webConfigJSON carries the
+            // instance override, which changes when a picker re-roots the app.
+            let configScript = WKUserScript(
+                source: "window.__EVERYWHERE_CONFIG__ = \(config.webConfigJSON);",
+                injectionTime: .atDocumentStart,
+                forMainFrameOnly: true
+            )
+            configuration.userContentController.addUserScript(configScript)
+            // Re-add defensively: a reused configuration would throw on a
+            // duplicate handler name.
+            configuration.userContentController.removeScriptMessageHandler(forName: "everywhereControl")
+            configuration.userContentController.add(controlHandler, name: "everywhereControl")
+            let webView = WKWebView(frame: .zero, configuration: configuration)
+            #if DEBUG
+            if #available(iOS 16.4, *) {
+                webView.isInspectable = true
+            }
+            #endif
+            return webView
+        }
+    }
+}
+// MARK: - Page → shell control messages
+extension Notification.Name {
+    static let everywhereReloadConfig = Notification.Name("EverywhereReloadConfig")
+    static let everywhereResetApp = Notification.Name("EverywhereResetApp")
+    static let everywhereSetTabBadge = Notification.Name("EverywhereSetTabBadge")
+    static let everywhereSetInstance = Notification.Name("EverywhereSetInstance")
+    static let everywhereClearInstance = Notification.Name("EverywhereClearInstance")
+    /// Posted by `everywhereVisit(_:)` from native extension code.
+    static let everywhereNativeVisit = Notification.Name("EverywhereNativeVisit")
+}
+/// Receives `window.webkit.messageHandlers.everywhereControl` messages and
+/// turns them into app-wide notifications. Holds no references to the web view
+/// or delegates, so retaining it on the content controller can't cycle.
+///   { action: "reloadConfig" }                    → refresh tabs/path config
+///   { action: "reset", to: "/path" }              → full app reset, then land on `to`
+///   { action: "setBadge", count: 3 }              → app icon badge (0 clears)
+///   { action: "setTabBadge", path: "/x", count: 3 } → tab bar badge (0 clears)
+///   { action: "setInstance", url: "https://…", to: "/path"? } → persist instance root + reset
+///   { action: "clearInstance", to: "/path"? }     → back to the stamped root + reset
+final class WebControlHandler: NSObject, WKScriptMessageHandler {
+    func userContentController(_ controller: WKUserContentController, didReceive message: WKScriptMessage) {
+        guard let body = message.body as? [String: Any],
+              let action = body["action"] as? String
+        else { return }
+        #if DEBUG
+        NSLog("everywhereControl: %@", String(describing: body))
+        #endif
+        switch action {
+        case "reloadConfig":
+            NotificationCenter.default.post(name: .everywhereReloadConfig, object: nil)
+        case "reset":
+            let info = (body["to"] as? String).map { ["to": $0] }
+            NotificationCenter.default.post(name: .everywhereResetApp, object: nil, userInfo: info)
+        case "setBadge":
+            setAppBadge((body["count"] as? NSNumber)?.intValue ?? 0)
+        case "setTabBadge":
+            guard let path = body["path"] as? String else { return }
+            NotificationCenter.default.post(
+                name: .everywhereSetTabBadge, object: nil,
+                userInfo: ["path": path, "count": (body["count"] as? NSNumber)?.intValue ?? 0])
+        case "setInstance":
+            guard let url = body["url"] as? String else { return }
+            var info: [String: Any] = ["url": url]
+            if let to = body["to"] as? String { info["to"] = to }
+            NotificationCenter.default.post(name: .everywhereSetInstance, object: nil, userInfo: info)
+        case "clearInstance":
+            let info = (body["to"] as? String).map { ["to": $0] }
+            NotificationCenter.default.post(name: .everywhereClearInstance, object: nil, userInfo: info)
+        default:
+            break
+        }
+    }
+    /// Provisional authorization is silent — no permission prompt for a badge.
+    private func setAppBadge(_ count: Int) {
+        let center = UNUserNotificationCenter.current()
+        center.requestAuthorization(options: [.badge, .provisional]) { granted, _ in
+            guard granted else { return }
+            if #available(iOS 16.0, *) {
+                center.setBadgeCount(count)
+            } else {
+                DispatchQueue.main.async {
+                    UIApplication.shared.applicationIconBadgeNumber = count
+                }
+            }
+        }
+    }
+}
+// MARK: - UNUserNotificationCenterDelegate
+extension AppDelegate: UNUserNotificationCenterDelegate {
+    func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
+        completionHandler([.banner, .sound])
+    }
+}

data/support/mobile/ios/App/Assets.xcassets/AccentColor.colorset/Contents.json ADDED Viewed

@@ -0,0 +1,20 @@
+{
+  "colors" : [
+    {
+      "color" : {
+        "color-space" : "srgb",
+        "components" : {
+          "alpha" : "1.000",
+          "blue" : "0x2D",
+          "green" : "0x34",
+          "red" : "0xCC"
+        }
+      },
+      "idiom" : "universal"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

data/support/mobile/ios/App/Assets.xcassets/AppIcon.appiconset/AppIcon.png ADDED Viewed

Binary file

data/support/mobile/ios/App/Assets.xcassets/AppIcon.appiconset/Contents.json ADDED Viewed

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

data/support/mobile/ios/App/Assets.xcassets/Contents.json ADDED Viewed

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

data/support/mobile/ios/App/Assets.xcassets/LaunchBackground.colorset/Contents.json ADDED Viewed

@@ -0,0 +1,38 @@
+{
+  "colors" : [
+    {
+      "color" : {
+        "color-space" : "srgb",
+        "components" : {
+          "alpha" : "1.000",
+          "blue" : "0xF7",
+          "green" : "0xF9",
+          "red" : "0xFA"
+        }
+      },
+      "idiom" : "universal"
+    },
+    {
+      "appearances" : [
+        {
+          "appearance" : "luminosity",
+          "value" : "dark"
+        }
+      ],
+      "color" : {
+        "color-space" : "srgb",
+        "components" : {
+          "alpha" : "1.000",
+          "blue" : "0x1A",
+          "green" : "0x1B",
+          "red" : "0x1C"
+        }
+      },
+      "idiom" : "universal"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

data/support/mobile/ios/App/Base.lproj/LaunchScreen.storyboard ADDED Viewed

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="22505" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" launchScreen="YES" useTraitCollections="YES" useSafeAreas="YES" colorMatched="YES" initialViewController="01J-lp-oVM">
+    <device id="retina6_12" orientation="portrait" appearance="light"/>
+    <dependencies>
+        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="22504"/>
+        <capability name="Named colors" minToolsVersion="9.0"/>
+        <capability name="Safe area layout guides" minToolsVersion="9.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="393" height="852"/>
+                        <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
+                        <viewLayoutGuide key="safeArea" id="6Tk-OE-BBY"/>
+                        <color key="backgroundColor" name="LaunchBackground"/>
+                    </view>
+                </viewController>
+                <placeholder placeholderIdentifier="IBFirstResponder" id="iYj-Kq-Ea1" userLabel="First Responder" sceneMemberID="firstResponder"/>
+            </objects>
+            <point key="canvasLocation" x="53" y="375"/>
+        </scene>
+    </scenes>
+    <resources>
+        <namedColor name="LaunchBackground">
+            <color red="0.98039215686274506" green="0.97647058823529409" blue="0.96862745098039216" alpha="1" colorSpace="custom" customColorSpace="sRGB"/>
+        </namedColor>
+    </resources>
+</document>