@use-voltra/ios-client 2.3.2 → 2.4.0

package/ios/shared/dynamic-live-activity/VoltraDynamicLiveActivityRenderer.swift

@@ -21,7 +21,10 @@ public enum VoltraDynamicLiveActivityRenderer {
     definitionId: String,
     context: ActivityViewContext<Attributes>
   ) -> DynamicIsland {
-    DynamicIsland {
+    // Set once on the Dynamic Island, which makes it the default for every region; the regions
+    // only drop the tree's own widgetURL so the configured link takes precedence.
+    let deepLinkURL = context.attributes.deepLinkUrl.flatMap(VoltraDeepLinkResolver.resolveUrl)
+    let dynamicIsland = DynamicIsland {
       DynamicIslandExpandedRegion(.leading) {
         VoltraDynamicLiveActivityDynamicIslandRegionView(
           definitionId: definitionId,
@@ -73,6 +76,7 @@ public enum VoltraDynamicLiveActivityRenderer {
     // DynamicIsland itself is not a View and cannot read SwiftUI Environment.
     // Do not execute a definition against fabricated values solely to obtain a
     // keyline tint; its region views below read the actual environment.
+    return deepLinkURL.map { dynamicIsland.widgetURL($0) } ?? dynamicIsland
   }
 
   fileprivate static func resolve<Attributes: VoltraDynamicLiveActivityDefinition>(
@@ -81,6 +85,7 @@ public enum VoltraDynamicLiveActivityRenderer {
     activityFamily: String?,
     colorScheme: ColorScheme? = nil,
     locale: Locale = .current,
+    layoutDirection: LayoutDirection? = nil,
     widgetRenderingMode: WidgetRenderingMode = .fullColor
   ) -> VoltraDynamicLiveActivityResolvedContent {
     guard VoltraDynamicLiveActivityRegistry.shared.contains(definitionId) else {
@@ -91,6 +96,13 @@ public enum VoltraDynamicLiveActivityRenderer {
       logFailure(definitionId: definitionId, activityName: context.attributes.name, message: "Could not encode content-state props")
       return .empty
     }
+    // Captured once so every region shares it and the cache key covers every locale field,
+    // including the app's `setDynamicWidgetLocale` override (ADR 0009).
+    let localeEnvironment = VoltraLocaleEnvironment.capture(
+      locale: locale,
+      isRightToLeft: layoutDirection.map { $0 == .rightToLeft },
+      appLocale: VoltraWidgetDefaults.dynamicWidgetLocale()
+    )
     // WidgetKit asks each Dynamic Island region (and each presentation) to render
     // independently, all with identical state/environment. Cache the resolved
     // variants shape so those siblings share one bundle load, one JS evaluation,
@@ -103,7 +115,7 @@ public enum VoltraDynamicLiveActivityRenderer {
       props: propsJSON,
       activityFamily: activityFamily,
       colorScheme: String(describing: colorScheme ?? .light),
-      locale: locale.identifier,
+      locale: localeEnvironment,
       widgetRenderingMode: String(describing: widgetRenderingMode),
       isStale: context.isStale
     )
@@ -114,7 +126,7 @@ public enum VoltraDynamicLiveActivityRenderer {
         propsJSON: propsJSON,
         activityFamily: activityFamily,
         colorScheme: colorScheme,
-        locale: locale,
+        localeEnvironment: localeEnvironment,
         widgetRenderingMode: widgetRenderingMode
       )
     }
@@ -126,13 +138,13 @@ public enum VoltraDynamicLiveActivityRenderer {
     propsJSON: String,
     activityFamily: String?,
     colorScheme: ColorScheme?,
-    locale: Locale,
+    localeEnvironment: VoltraLocaleEnvironment,
     widgetRenderingMode: WidgetRenderingMode
   ) -> VoltraDynamicLiveActivityResolvedContent {
     let environmentJSON = VoltraDynamicLiveActivityEnvironmentBuilder.build(
       date: Date(),
       colorScheme: colorScheme,
-      locale: locale,
+      localeEnvironment: localeEnvironment,
       widgetRenderingMode: widgetRenderingMode,
       isStale: context.isStale,
       activityFamily: activityFamily
@@ -176,18 +188,23 @@ private struct VoltraDynamicLiveActivityDynamicIslandRegionView<Attributes: Volt
 
   @Environment(\.colorScheme) private var colorScheme
   @Environment(\.locale) private var locale
+  @Environment(\.layoutDirection) private var layoutDirection
   @Environment(\.widgetRenderingMode) private var widgetRenderingMode
 
   var body: some View {
-    VoltraDynamicLiveActivityRenderer.resolve(
+    let deepLinkURL = context.attributes.deepLinkUrl.flatMap(VoltraDeepLinkResolver.resolveUrl)
+    let content = VoltraDynamicLiveActivityRenderer.resolve(
       definitionId: definitionId,
       context: context,
       activityFamily: nil,
       colorScheme: colorScheme,
       locale: locale,
+      layoutDirection: layoutDirection,
       widgetRenderingMode: widgetRenderingMode
     )
-    .view(for: region, activityId: context.activityID, deepLink: context.attributes.deepLinkUrl)
+    let _ = VoltraRootModifiers.warnIfIslandIgnoresWidgetURL(in: region, root: content.root(for: region), configured: deepLinkURL)
+    content.view(for: region, activityId: context.activityID)
+      .voltraDeferringWidgetURL(to: deepLinkURL)
   }
 }
 
@@ -197,6 +214,7 @@ private struct VoltraDynamicLiveActivityLockScreenView<Attributes: VoltraDynamic
 
   @Environment(\.colorScheme) private var colorScheme
   @Environment(\.locale) private var locale
+  @Environment(\.layoutDirection) private var layoutDirection
   @Environment(\.widgetRenderingMode) private var widgetRenderingMode
 
   var body: some View {
@@ -206,14 +224,12 @@ private struct VoltraDynamicLiveActivityLockScreenView<Attributes: VoltraDynamic
       activityFamily: nil,
       colorScheme: colorScheme,
       locale: locale,
+      layoutDirection: layoutDirection,
       widgetRenderingMode: widgetRenderingMode
     )
-    if let tint = content.payload?.activityBackgroundTint, let color = JSColorParser.parse(tint) {
-      content.view(for: .lockScreen, activityId: context.activityID, deepLink: context.attributes.deepLinkUrl)
-        .activityBackgroundTint(color)
-    } else {
-      content.view(for: .lockScreen, activityId: context.activityID, deepLink: context.attributes.deepLinkUrl)
-    }
+    content.view(for: .lockScreen, activityId: context.activityID)
+      .voltraWidgetURL(configured: context.attributes.deepLinkUrl.flatMap(VoltraDeepLinkResolver.resolveUrl))
+      .voltraActivityBackgroundTint(configured: content.payload?.activityBackgroundTint.flatMap { JSColorParser.parse($0) })
   }
 }
 
@@ -225,6 +241,7 @@ private struct VoltraDynamicLiveActivityAdaptiveLockScreenView<Attributes: Voltr
   @Environment(\.activityFamily) private var activityFamily
   @Environment(\.colorScheme) private var colorScheme
   @Environment(\.locale) private var locale
+  @Environment(\.layoutDirection) private var layoutDirection
   @Environment(\.widgetRenderingMode) private var widgetRenderingMode
 
   var body: some View {
@@ -234,12 +251,14 @@ private struct VoltraDynamicLiveActivityAdaptiveLockScreenView<Attributes: Voltr
       activityFamily: String(describing: activityFamily),
       colorScheme: colorScheme,
       locale: locale,
+      layoutDirection: layoutDirection,
       widgetRenderingMode: widgetRenderingMode
     )
+    // One widgetURL for the whole presentation, including the small family that shows two
+    // regions side by side.
     familyContent(content: content)
-      .voltraIfLet(content.payload?.activityBackgroundTint.flatMap { JSColorParser.parse($0) }) { view, color in
-        view.activityBackgroundTint(color)
-      }
+      .voltraWidgetURL(configured: context.attributes.deepLinkUrl.flatMap(VoltraDeepLinkResolver.resolveUrl))
+      .voltraActivityBackgroundTint(configured: content.payload?.activityBackgroundTint.flatMap { JSColorParser.parse($0) })
   }
 
   @ViewBuilder
@@ -247,7 +266,7 @@ private struct VoltraDynamicLiveActivityAdaptiveLockScreenView<Attributes: Voltr
     if activityFamily == .small {
       smallFamilyContent(content: content)
     } else {
-      content.view(for: .lockScreen, activityId: context.activityID, deepLink: context.attributes.deepLinkUrl)
+      content.view(for: .lockScreen, activityId: context.activityID)
     }
   }
 
@@ -256,14 +275,13 @@ private struct VoltraDynamicLiveActivityAdaptiveLockScreenView<Attributes: Voltr
     if content.hasContent(for: .supplementalActivityFamiliesSmall) {
       content.view(
         for: .supplementalActivityFamiliesSmall,
-        activityId: context.activityID,
-        deepLink: context.attributes.deepLinkUrl
+        activityId: context.activityID
       )
     } else if content.hasContent(for: .islandCompactLeading) || content.hasContent(for: .islandCompactTrailing) {
       HStack(spacing: 0) {
-        content.view(for: .islandCompactLeading, activityId: context.activityID, deepLink: context.attributes.deepLinkUrl)
+        content.view(for: .islandCompactLeading, activityId: context.activityID)
         Spacer()
-        content.view(for: .islandCompactTrailing, activityId: context.activityID, deepLink: context.attributes.deepLinkUrl)
+        content.view(for: .islandCompactTrailing, activityId: context.activityID)
       }
       .frame(maxWidth: .infinity)
     }
@@ -279,12 +297,15 @@ private struct VoltraDynamicLiveActivityResolvedContent {
     !(payload?.regions[region] ?? []).isEmpty
   }
 
+  func root(for region: VoltraRegion) -> VoltraNode? {
+    guard let nodes = payload?.regions[region], !nodes.isEmpty else { return nil }
+    return nodes.count == 1 ? nodes[0] : .array(nodes)
+  }
+
   @ViewBuilder
-  func view(for region: VoltraRegion, activityId: String, deepLink: String?) -> some View {
-    if let nodes = payload?.regions[region], !nodes.isEmpty {
-      let root: VoltraNode = nodes.count == 1 ? nodes[0] : .array(nodes)
+  func view(for region: VoltraRegion, activityId: String) -> some View {
+    if let root = root(for: region) {
       Voltra(root: root, activityId: activityId)
-        .voltraIfLet(deepLink.flatMap(VoltraDeepLinkResolver.resolveUrl)) { view, url in view.widgetURL(url) }
     }
   }
 }
@@ -302,7 +323,7 @@ private final class VoltraDynamicLiveActivityRenderCache: @unchecked Sendable {
     let props: String
     let activityFamily: String?
     let colorScheme: String
-    let locale: String
+    let locale: VoltraLocaleEnvironment
     let widgetRenderingMode: String
     let isStale: Bool
   }
@@ -330,7 +351,7 @@ private enum VoltraDynamicLiveActivityEnvironmentBuilder {
   static func build(
     date: Date,
     colorScheme: ColorScheme?,
-    locale: Locale,
+    localeEnvironment: VoltraLocaleEnvironment,
     widgetRenderingMode: WidgetRenderingMode,
     isStale: Bool,
     activityFamily: String?
@@ -351,11 +372,12 @@ private enum VoltraDynamicLiveActivityEnvironmentBuilder {
     var environment: [String: Any] = [
       "date": Int(date.timeIntervalSince1970 * 1000),
       "colorScheme": String(describing: colorScheme ?? .light),
-      "locale": locale.identifier,
       "widgetRenderingMode": String(describing: widgetRenderingMode),
       "build": build,
       "isStale": isStale,
     ]
+    // BCP-47 `locale` and the rest of the ADR 0009 locale fields.
+    environment.merge(localeEnvironment.dictionary) { current, _ in current }
     if let activityFamily {
       environment["activityFamily"] = activityFamily
     }

package/ios/target/VoltraClientWidgetRuntime.swift

@@ -255,6 +255,7 @@ public enum VoltraClientWidgetEnvBuilder {
     widgetRenderingMode: WidgetRenderingMode,
     showsWidgetContainerBackground: Bool,
     locale: Locale,
+    layoutDirection: LayoutDirection? = nil,
     configuration: [String: String],
     serverUpdateJSON: String? = nil
   ) -> String {
@@ -299,12 +300,20 @@ public enum VoltraClientWidgetEnvBuilder {
     // sends and what WidgetScope.of(widgetId, configuration:) resolves to.
     let instanceEntry = WidgetCanonicalConfiguration.key(configuration).map { ",\n  \"instance\": \(jsonString($0))" } ?? ""
 
+    // Locale fields (ADR 0009 §1). `locale` is BCP-47 (`pl-PL`), never the ICU `pl_PL` that
+    // `Locale.identifier` gives and `Intl` rejects.
+    let localeEnvironment = VoltraLocaleEnvironment.capture(
+      locale: locale,
+      isRightToLeft: layoutDirection.map { $0 == .rightToLeft },
+      appLocale: VoltraWidgetDefaults.dynamicWidgetLocale()
+    )
+
     return """
     {
       "date": \(timestampMs),
       "widgetFamily": \(jsonString(familyString(widgetFamily))),
       "colorScheme": \(jsonString(schemeString(colorScheme))),
-      "locale": \(jsonString(locale.identifier)),
+      \(localeEnvironment.jsonFields),
       "widgetRenderingMode": \(jsonString(renderingModeString(widgetRenderingMode))),
       "showsWidgetContainerBackground": \(showsWidgetContainerBackground),
       "configuration": \(configurationJSON),
@@ -355,6 +364,7 @@ public struct VoltraClientWidgetContentView: View {
   @Environment(\.widgetRenderingMode) private var widgetRenderingMode
   @Environment(\.showsWidgetContainerBackground) private var showsWidgetContainerBackground
   @Environment(\.locale) private var locale
+  @Environment(\.layoutDirection) private var layoutDirection
 
   public init(entry: VoltraClientWidgetEntry, initialState: Data?) {
     self.entry = entry
@@ -381,6 +391,7 @@ public struct VoltraClientWidgetContentView: View {
         widgetRenderingMode: widgetRenderingMode,
         showsWidgetContainerBackground: showsWidgetContainerBackground,
         locale: locale,
+        layoutDirection: layoutDirection,
         configuration: entry.configuration,
         serverUpdateJSON: entry.serverUpdateJSON
       )

package/ios/target/VoltraHomeWidget.swift

@@ -284,6 +284,7 @@ public struct VoltraHomeWidgetView: View {
 
   public var body: some View {
     let mappedRenderingMode = mapWidgetRenderingMode(widgetRenderingMode)
+    let rootModifiers = VoltraRootModifiers(root: entry.rootNode)
 
     Group {
       if let root = entry.rootNode {
@@ -298,7 +299,7 @@ public struct VoltraHomeWidgetView: View {
           )
         )
         .frame(maxWidth: .infinity, maxHeight: .infinity, alignment: .topLeading)
-        .widgetURL(resolveDeepLinkURL(entry))
+        .voltraWidgetURL(configured: configuredDeepLinkURL(entry), tree: rootModifiers) { defaultDeepLinkURL(entry) }
 
         if showRefreshButton {
           content.overlay(alignment: .topTrailing) {
@@ -311,7 +312,7 @@ public struct VoltraHomeWidgetView: View {
         placeholderView(widgetId: entry.widgetId)
       }
     }
-    .disableWidgetMarginsIfAvailable()
+    .voltraDefaultContainerBackground(tree: rootModifiers)
   }
 
   private func mapWidgetRenderingMode(_ mode: WidgetRenderingMode) -> VoltraWidgetRenderingMode {
@@ -442,18 +443,8 @@ private func reconstructWithSharedData(content: Any, root: [String: Any]) -> Dat
 
 // MARK: - Deep link helpers
 
-private extension View {
-  @ViewBuilder
-  func disableWidgetMarginsIfAvailable() -> some View {
-    if #available(iOSApplicationExtension 17.0, *) {
-      containerBackground(.clear, for: .widget)
-    } else {
-      self
-    }
-  }
-}
-
-private func resolveDeepLinkURL(_ entry: VoltraHomeWidgetEntry) -> URL? {
+/// The deep link configured for the widget: the timeline entry's, else the stored static one.
+private func configuredDeepLinkURL(_ entry: VoltraHomeWidgetEntry) -> URL? {
   // Prefer the timeline entry's deep link URL if available
   if let entryUrl = entry.deepLinkUrl, !entryUrl.isEmpty {
     if entryUrl.contains("://"), let url = URL(string: entryUrl) {
@@ -476,7 +467,11 @@ private func resolveDeepLinkURL(_ entry: VoltraHomeWidgetEntry) -> URL? {
     }
   }
 
-  // Default deep link with widget info
+  return nil
+}
+
+/// The synthetic deep link used when nothing is configured.
+private func defaultDeepLinkURL(_ entry: VoltraHomeWidgetEntry) -> URL? {
   guard let scheme = VoltraDeepLinkResolver.deepLinkScheme() else { return nil }
 
   var tag = "unknown"

package/ios/target/VoltraWidget.swift

@@ -29,11 +29,8 @@ public struct VoltraWidget: Widget {
   private func adaptiveConfig() -> some WidgetConfiguration {
     ActivityConfiguration(for: VoltraAttributes.self) { context in
       adaptiveLocksScreenView(context: context)
-        .widgetURL(VoltraDeepLinkResolver.resolve(context.attributes))
-        .voltraIfLet(context.state.activityBackgroundTint) { view, tint in
-          let color = JSColorParser.parse(tint)
-          view.activityBackgroundTint(color)
-        }
+        .voltraWidgetURL(configured: VoltraDeepLinkResolver.resolve(context.attributes))
+        .voltraActivityBackgroundTint(configured: context.state.activityBackgroundTint.flatMap { JSColorParser.parse($0) })
     } dynamicIsland: { context in
       dynamicIslandContent(context: context)
     }
@@ -45,11 +42,8 @@ public struct VoltraWidget: Widget {
   private func defaultConfig() -> some WidgetConfiguration {
     ActivityConfiguration(for: VoltraAttributes.self) { context in
       Voltra(root: rootNode(for: .lockScreen, from: context.state), activityId: context.activityID)
-        .widgetURL(VoltraDeepLinkResolver.resolve(context.attributes))
-        .voltraIfLet(context.state.activityBackgroundTint) { view, tint in
-          let color = JSColorParser.parse(tint)
-          view.activityBackgroundTint(color)
-        }
+        .voltraWidgetURL(configured: VoltraDeepLinkResolver.resolve(context.attributes))
+        .voltraActivityBackgroundTint(configured: context.state.activityBackgroundTint.flatMap { JSColorParser.parse($0) })
     } dynamicIsland: { context in
       dynamicIslandContent(context: context)
     }
@@ -65,32 +59,46 @@ public struct VoltraWidget: Widget {
   // MARK: - Dynamic Island (shared between iOS versions)
 
   private func dynamicIslandContent(context: ActivityViewContext<VoltraAttributes>) -> DynamicIsland {
-    let dynamicIsland = DynamicIsland {
+    // Set once on the Dynamic Island, which makes it the default for every region; the regions
+    // only drop the tree's own widgetURL so the configured link takes precedence.
+    let deepLinkURL = VoltraDeepLinkResolver.resolve(context.attributes)
+    for region in VoltraRootModifiers.islandTapRegions {
+      VoltraRootModifiers.warnIfIslandIgnoresWidgetURL(
+        in: region,
+        root: rootNode(for: region, from: context.state),
+        configured: deepLinkURL
+      )
+    }
+    var dynamicIsland = DynamicIsland {
       DynamicIslandExpandedRegion(.leading) {
         Voltra(root: rootNode(for: .islandExpandedLeading, from: context.state), activityId: context.activityID)
-          .widgetURL(VoltraDeepLinkResolver.resolve(context.attributes))
+          .voltraDeferringWidgetURL(to: deepLinkURL)
       }
       DynamicIslandExpandedRegion(.trailing) {
         Voltra(root: rootNode(for: .islandExpandedTrailing, from: context.state), activityId: context.activityID)
-          .widgetURL(VoltraDeepLinkResolver.resolve(context.attributes))
+          .voltraDeferringWidgetURL(to: deepLinkURL)
       }
       DynamicIslandExpandedRegion(.center) {
         Voltra(root: rootNode(for: .islandExpandedCenter, from: context.state), activityId: context.activityID)
-          .widgetURL(VoltraDeepLinkResolver.resolve(context.attributes))
+          .voltraDeferringWidgetURL(to: deepLinkURL)
       }
       DynamicIslandExpandedRegion(.bottom) {
         Voltra(root: rootNode(for: .islandExpandedBottom, from: context.state), activityId: context.activityID)
-          .widgetURL(VoltraDeepLinkResolver.resolve(context.attributes))
+          .voltraDeferringWidgetURL(to: deepLinkURL)
       }
     } compactLeading: {
       Voltra(root: rootNode(for: .islandCompactLeading, from: context.state), activityId: context.activityID)
-        .widgetURL(VoltraDeepLinkResolver.resolve(context.attributes))
+        .voltraDeferringWidgetURL(to: deepLinkURL)
     } compactTrailing: {
       Voltra(root: rootNode(for: .islandCompactTrailing, from: context.state), activityId: context.activityID)
-        .widgetURL(VoltraDeepLinkResolver.resolve(context.attributes))
+        .voltraDeferringWidgetURL(to: deepLinkURL)
     } minimal: {
       Voltra(root: rootNode(for: .islandMinimal, from: context.state), activityId: context.activityID)
-        .widgetURL(VoltraDeepLinkResolver.resolve(context.attributes))
+        .voltraDeferringWidgetURL(to: deepLinkURL)
+    }
+
+    if let deepLinkURL {
+      dynamicIsland = dynamicIsland.widgetURL(deepLinkURL)
     }
 
     // Apply keylineTint if specified

package/ios/ui/Extensions/VoltraNode+View.swift

@@ -37,6 +37,13 @@ struct VoltraElementView: View {
   let element: VoltraElement
 
   var body: some View {
+    // Native modifiers wrap the finished, styled component (ADR 0005).
+    component
+      .applyNativeModifiers(element.nativeModifiers)
+  }
+
+  @ViewBuilder
+  private var component: some View {
     switch element.type {
     case "Button":
       VoltraButton(element)

package/ios/ui/Helpers/VoltraDeepLinkResolver+URL.swift

@@ -0,0 +1,37 @@
+import Foundation
+
+/// Turns the deep link strings Voltra accepts into URLs. The ActivityKit-specific entry point is
+/// in `VoltraDeepLinkResolver.swift`; this half only needs Foundation, so native modifiers such as
+/// `widgetURL` resolve links the same way.
+public enum VoltraDeepLinkResolver {
+  static func deepLinkScheme() -> String? {
+    if let types = Bundle.main.object(forInfoDictionaryKey: "CFBundleURLTypes") as? [[String: Any]] {
+      for t in types {
+        if let schemes = t["CFBundleURLSchemes"] as? [String], let s = schemes.first, !s.isEmpty {
+          return s
+        }
+      }
+    }
+    return Bundle.main.bundleIdentifier
+  }
+
+  /// Resolves a URL string, supporting both absolute and relative paths
+  /// - Parameter raw: The URL string (e.g., "myapp://path", "/path", or "path")
+  /// - Returns: A resolved URL, or nil if invalid
+  public static func resolveUrl(_ raw: String) -> URL? {
+    guard !raw.isEmpty else { return nil }
+
+    // If it's already an absolute URL, use it as-is
+    if raw.contains("://"), let url = URL(string: raw) {
+      return url
+    }
+
+    // Otherwise, prepend the app's URL scheme
+    if let scheme = deepLinkScheme() {
+      let path = raw.hasPrefix("/") ? raw : "/\(raw)"
+      return URL(string: "\(scheme)://\(path.trimmingCharacters(in: CharacterSet(charactersIn: "/")))")
+    }
+
+    return nil
+  }
+}

package/ios/ui/Helpers/VoltraDeepLinkResolver.swift

@@ -2,18 +2,7 @@ import ActivityKit
 import Foundation
 import SwiftUI
 
-public enum VoltraDeepLinkResolver {
-  static func deepLinkScheme() -> String? {
-    if let types = Bundle.main.object(forInfoDictionaryKey: "CFBundleURLTypes") as? [[String: Any]] {
-      for t in types {
-        if let schemes = t["CFBundleURLSchemes"] as? [String], let s = schemes.first, !s.isEmpty {
-          return s
-        }
-      }
-    }
-    return Bundle.main.bundleIdentifier
-  }
-
+extension VoltraDeepLinkResolver {
   static func resolve(
     _ attributes: VoltraAttributes
   ) -> URL? {
@@ -22,24 +11,4 @@ public enum VoltraDeepLinkResolver {
     }
     return nil
   }
-
-  /// Resolves a URL string, supporting both absolute and relative paths
-  /// - Parameter raw: The URL string (e.g., "myapp://path", "/path", or "path")
-  /// - Returns: A resolved URL, or nil if invalid
-  public static func resolveUrl(_ raw: String) -> URL? {
-    guard !raw.isEmpty else { return nil }
-
-    // If it's already an absolute URL, use it as-is
-    if raw.contains("://"), let url = URL(string: raw) {
-      return url
-    }
-
-    // Otherwise, prepend the app's URL scheme
-    if let scheme = deepLinkScheme() {
-      let path = raw.hasPrefix("/") ? raw : "/\(raw)"
-      return URL(string: "\(scheme)://\(path.trimmingCharacters(in: CharacterSet(charactersIn: "/")))")
-    }
-
-    return nil
-  }
 }