@use-voltra/ios-client 2.1.0 → 2.2.0

package/expo-plugin/src/ios-widget/xcode/target.ts

@@ -6,18 +6,9 @@ import { IOS } from '../../constants'
 // Types
 // ============================================================================
 
-export interface ConfigureTargetOptions {
+export interface CreateTargetSkeletonOptions {
   targetName: string
   targetUuid: string
-  productFile: { fileRef: string }
-  xCConfigurationList: { uuid: string }
-}
-
-interface AddNativeTargetOptions {
-  targetName: string
-  targetUuid: string
-  productFile: { fileRef: string }
-  xCConfigurationList: { uuid: string }
 }
 
 // ============================================================================
@@ -25,19 +16,39 @@ interface AddNativeTargetOptions {
 // ============================================================================
 
 /**
- * Configures the widget extension target in the Xcode project.
+ * Creates the minimal widget-extension native target and registers it with the project.
+ *
+ * A target cannot be "ensured" into existence, so this is the one create-only step in
+ * {@link applyXcodeChanges}: it adds an empty `PBXNativeTarget` (no product reference, configuration
+ * list or build phases yet) to the `PBXNativeTarget` and `PBXProject` sections. The shared ensure
+ * pipeline then fills in the configuration list, product file, group, build phases, attributes and
+ * dependency — the same code that reconciles an already-existing target.
  *
- * This:
- * - Adds the target to PBXNativeTarget section
- * - Adds the target to PBXProject section
- * - Adds a dependency from the main app to the widget extension
+ * @returns The freshly created native-target object (the value stored in the `PBXNativeTarget`
+ * section under `targetUuid`).
  */
-export function configureTarget(xcodeProject: XcodeProject, options: ConfigureTargetOptions) {
-  const target = addToPbxNativeTargetSection(xcodeProject, options)
-  addToPbxProjectSection(xcodeProject, target)
-  addTargetDependency(xcodeProject, target)
+export function createTargetSkeleton(xcodeProject: XcodeProject, options: CreateTargetSkeletonOptions) {
+  const { targetName, targetUuid } = options
+
+  const target = {
+    uuid: targetUuid,
+    pbxNativeTarget: {
+      isa: 'PBXNativeTarget',
+      name: targetName,
+      productName: targetName,
+      productType: `"com.apple.product-type.app-extension"`,
+      buildConfigurationList: '',
+      productReference: '',
+      buildPhases: [],
+      buildRules: [],
+      dependencies: [],
+    },
+  }
 
-  return target
+  xcodeProject.addToPbxNativeTargetSection(target)
+  xcodeProject.addToPbxProjectSection(target)
+
+  return xcodeProject.pbxNativeTargetSection()[targetUuid]
 }
 
 /**
@@ -83,66 +94,3 @@ export function ensureTargetDependency(xcodeProject: XcodeProject, targetUuid: s
     xcodeProject.addTargetDependency(mainTargetUuid, [targetUuid])
   }
 }
-
-// ============================================================================
-// Helper Functions
-// ============================================================================
-
-/**
- * Adds the widget extension target to the PBXNativeTarget section.
- */
-function addToPbxNativeTargetSection(xcodeProject: XcodeProject, options: AddNativeTargetOptions) {
-  const { targetName, targetUuid, productFile, xCConfigurationList } = options
-
-  const target = {
-    uuid: targetUuid,
-    pbxNativeTarget: {
-      isa: 'PBXNativeTarget',
-      name: targetName,
-      productName: targetName,
-      productReference: productFile.fileRef,
-      productType: `"com.apple.product-type.app-extension"`,
-      buildConfigurationList: xCConfigurationList.uuid,
-      buildPhases: [],
-      buildRules: [],
-      dependencies: [],
-    },
-  }
-
-  xcodeProject.addToPbxNativeTargetSection(target)
-
-  return target
-}
-
-/**
- * Adds the target to the PBXProject section.
- */
-function addToPbxProjectSection(xcodeProject: XcodeProject, target: { uuid: string }): void {
-  xcodeProject.addToPbxProjectSection(target)
-
-  // Add target attributes to project section
-  const projectSection = xcodeProject.pbxProjectSection()
-  const firstProject = xcodeProject.getFirstProject()
-
-  if (!projectSection[firstProject.uuid].attributes.TargetAttributes) {
-    projectSection[firstProject.uuid].attributes.TargetAttributes = {}
-  }
-
-  projectSection[firstProject.uuid].attributes.TargetAttributes[target.uuid] = {
-    LastSwiftMigration: IOS.LAST_SWIFT_MIGRATION,
-  }
-}
-
-/**
- * Adds a target dependency so the main app depends on the widget extension.
- */
-function addTargetDependency(xcodeProject: XcodeProject, target: { uuid: string }): void {
-  if (!xcodeProject.hash.project.objects['PBXTargetDependency']) {
-    xcodeProject.hash.project.objects['PBXTargetDependency'] = {}
-  }
-  if (!xcodeProject.hash.project.objects['PBXContainerItemProxy']) {
-    xcodeProject.hash.project.objects['PBXContainerItemProxy'] = {}
-  }
-
-  xcodeProject.addTargetDependency(xcodeProject.getFirstTarget().uuid, [target.uuid])
-}

package/ios/Package.swift

@@ -27,7 +27,6 @@ let package = Package(
         "Date+toTimerInterval.swift",
         "ShortNames.swift",
         "VoltraAttributes.swift",
-        "VoltraConfig.swift",
         "VoltraElement.swift",
         "VoltraEvent.swift",
         "VoltraEventBus.swift",
@@ -38,7 +37,14 @@ let package = Package(
         "VoltraPersistentEventQueue.swift",
       ],
       sources: [
+        "DynamicWidgetPropsCodec.swift",
+        "DynamicWidgetPropsStorage.swift",
+        "DynamicWidgetPropsStore.swift",
+        "DynamicWidgetRenderCoordinator.swift",
+        "DynamicWidgetUpdater.swift",
         "JSONValue.swift",
+        "VoltraConfig.swift",
+        "VoltraConstants.swift",
         "VoltraPayloadMigrator.swift",
         "VoltraRegion.swift",
         "ComponentTypeID.swift",

package/ios/app/NativeVoltra.mm

@@ -289,6 +289,25 @@
   }];
 }
 
+- (void)updateDynamicWidget:(NSString *)dynamicWidgetId
+     dynamicWidgetPropsJson:(NSString *)dynamicWidgetPropsJson
+                    resolve:(RCTPromiseResolveBlock)resolve
+                     reject:(RCTPromiseRejectBlock)reject
+{
+  [self.module updateDynamicWidget:dynamicWidgetId
+            dynamicWidgetPropsJson:dynamicWidgetPropsJson
+                         completion:^(NSError *error) {
+    if (error) {
+      NSString *message = [NSString stringWithFormat:@"Failed to update Dynamic Widget '%@': %@",
+                                                     dynamicWidgetId,
+                                                     error.localizedDescription];
+      reject(@"updateDynamicWidget", message, error);
+    } else {
+      resolve(nil);
+    }
+  }];
+}
+
 - (void)scheduleWidget:(NSString *)widgetId
           timelineJson:(NSString *)timelineJson
                resolve:(RCTPromiseResolveBlock)resolve

package/ios/app/VoltraModule.swift

@@ -145,6 +145,24 @@ public enum VoltraErrors: Error {
 
   // MARK: - Home Screen Widgets
 
+  @objc public func updateDynamicWidget(
+    _ dynamicWidgetId: String,
+    dynamicWidgetPropsJson: String,
+    completion: @escaping (Error?) -> Void
+  ) {
+    Task {
+      do {
+        try await impl.updateDynamicWidget(
+          dynamicWidgetId: dynamicWidgetId,
+          dynamicWidgetPropsJson: dynamicWidgetPropsJson
+        )
+        completion(nil)
+      } catch {
+        completion(error)
+      }
+    }
+  }
+
   @objc public func updateWidget(
     _ widgetId: String,
     jsonString: String,

package/ios/app/VoltraModuleImpl.swift

@@ -257,6 +257,22 @@ public class VoltraModuleImpl {
 
   // MARK: - Widgets
 
+  func updateDynamicWidget(
+    dynamicWidgetId: String,
+    dynamicWidgetPropsJson: String
+  ) async throws {
+    let dynamicWidgetUpdater = DynamicWidgetUpdater(
+      dynamicWidgetPropsPersistence: DynamicWidgetPropsStore(),
+      dynamicWidgetTimelineReload: { dynamicWidgetId in
+        VoltraWidgetService.reloadTimeline(for: dynamicWidgetId)
+      }
+    )
+    try await dynamicWidgetUpdater.updateDynamicWidget(
+      dynamicWidgetID: dynamicWidgetId,
+      dynamicWidgetPropsJSON: dynamicWidgetPropsJson
+    )
+  }
+
   func updateWidget(widgetId: String, jsonString: String, options: UpdateWidgetOptions?) async throws {
     try VoltraWidgetService.setWidgetData(widgetId: widgetId, jsonString: jsonString, deepLinkUrl: options?.deepLinkUrl)
 

package/ios/shared/DynamicWidgetPropsCodec.swift

@@ -0,0 +1,51 @@
+import Foundation
+
+enum DynamicWidgetPropsCodec {
+  static let emptyDynamicWidgetPropsJSON = "{}"
+
+  private static let currentStorageVersion = 1
+
+  static func encodeStorageEntry(dynamicWidgetPropsJSON: String) throws -> String {
+    let dynamicWidgetProps: JSONValue
+    do {
+      dynamicWidgetProps = try JSONValue.parse(from: dynamicWidgetPropsJSON)
+    } catch {
+      throw DynamicWidgetPropsStoreError.invalidJSON
+    }
+
+    guard case .object = dynamicWidgetProps else {
+      throw DynamicWidgetPropsStoreError.topLevelValueMustBeObject
+    }
+
+    let entry = DynamicWidgetPropsStorageEntry(
+      dynamicWidgetPropsStorageVersion: currentStorageVersion,
+      dynamicWidgetProps: dynamicWidgetProps
+    )
+    let data = try JSONEncoder().encode(entry)
+    guard let json = String(data: data, encoding: .utf8) else {
+      throw DynamicWidgetPropsStoreError.invalidJSON
+    }
+    return json
+  }
+
+  static func decodeDynamicWidgetProps(storageEntryJSON: String?) -> String {
+    guard
+      let storageEntryJSON,
+      let data = storageEntryJSON.data(using: .utf8),
+      let entry = try? JSONDecoder().decode(DynamicWidgetPropsStorageEntry.self, from: data),
+      entry.dynamicWidgetPropsStorageVersion == currentStorageVersion,
+      case .object = entry.dynamicWidgetProps,
+      let dynamicWidgetPropsData = try? JSONEncoder().encode(entry.dynamicWidgetProps),
+      let dynamicWidgetPropsJSON = String(data: dynamicWidgetPropsData, encoding: .utf8)
+    else {
+      return emptyDynamicWidgetPropsJSON
+    }
+
+    return dynamicWidgetPropsJSON
+  }
+}
+
+private struct DynamicWidgetPropsStorageEntry: Codable {
+  let dynamicWidgetPropsStorageVersion: Int
+  let dynamicWidgetProps: JSONValue
+}

package/ios/shared/DynamicWidgetPropsStorage.swift

@@ -0,0 +1,53 @@
+import Foundation
+
+enum DynamicWidgetPropsStoreError: Error, Equatable, LocalizedError {
+  case appGroupNotConfigured
+  case userDefaultsUnavailable
+  case persistenceFailed
+  case invalidJSON
+  case topLevelValueMustBeObject
+
+  var errorDescription: String? {
+    switch self {
+    case .appGroupNotConfigured:
+      return "App Group not configured. Set 'groupIdentifier' in the Voltra config plugin to use Dynamic Widgets."
+    case .userDefaultsUnavailable:
+      return "Unable to access UserDefaults for the Dynamic Widget App Group."
+    case .persistenceFailed:
+      return "Failed to persist Dynamic Widget props to the App Group."
+    case .invalidJSON:
+      return "Dynamic Widget props must be valid JSON."
+    case .topLevelValueMustBeObject:
+      return "Dynamic Widget props must be a top-level JSON object."
+    }
+  }
+}
+
+protocol DynamicWidgetPropsStorage {
+  func string(forKey key: String) throws -> String?
+  func set(_ value: String, forKey key: String) throws
+  func removeObject(forKey key: String) throws
+}
+
+struct DynamicWidgetPropsUserDefaultsStorage: DynamicWidgetPropsStorage {
+  private let userDefaults: UserDefaults
+
+  init(userDefaults: UserDefaults) {
+    self.userDefaults = userDefaults
+  }
+
+  func string(forKey key: String) throws -> String? {
+    userDefaults.string(forKey: key)
+  }
+
+  func set(_ value: String, forKey key: String) throws {
+    userDefaults.set(value, forKey: key)
+    guard userDefaults.synchronize() else {
+      throw DynamicWidgetPropsStoreError.persistenceFailed
+    }
+  }
+
+  func removeObject(forKey key: String) throws {
+    userDefaults.removeObject(forKey: key)
+  }
+}

package/ios/shared/DynamicWidgetPropsStore.swift

@@ -0,0 +1,50 @@
+import Foundation
+
+/// Versioned, per-ID Dynamic Widget props shared by the app and widget extension processes.
+struct DynamicWidgetPropsStore {
+  private let storage: Result<any DynamicWidgetPropsStorage, Error>
+
+  init() {
+    guard let groupIdentifier = VoltraConfig.groupIdentifier() else {
+      storage = .failure(DynamicWidgetPropsStoreError.appGroupNotConfigured)
+      return
+    }
+    guard let userDefaults = UserDefaults(suiteName: groupIdentifier) else {
+      storage = .failure(DynamicWidgetPropsStoreError.userDefaultsUnavailable)
+      return
+    }
+    storage = .success(DynamicWidgetPropsUserDefaultsStorage(userDefaults: userDefaults))
+  }
+
+  init(storage: any DynamicWidgetPropsStorage) {
+    self.storage = .success(storage)
+  }
+
+  func persistDynamicWidgetProps(_ dynamicWidgetPropsJSON: String, for dynamicWidgetID: String) throws {
+    let storageEntryJSON = try DynamicWidgetPropsCodec.encodeStorageEntry(
+      dynamicWidgetPropsJSON: dynamicWidgetPropsJSON
+    )
+    let resolvedStorage = try storage.get()
+    try resolvedStorage.set(storageEntryJSON, forKey: Self.storageKey(for: dynamicWidgetID))
+  }
+
+  func dynamicWidgetProps(for dynamicWidgetID: String) -> String {
+    guard
+      case let .success(resolvedStorage) = storage,
+      let storageEntryJSON = try? resolvedStorage.string(forKey: Self.storageKey(for: dynamicWidgetID))
+    else {
+      return DynamicWidgetPropsCodec.emptyDynamicWidgetPropsJSON
+    }
+
+    return DynamicWidgetPropsCodec.decodeDynamicWidgetProps(storageEntryJSON: storageEntryJSON)
+  }
+
+  func clearDynamicWidgetProps(for dynamicWidgetID: String) throws {
+    let resolvedStorage = try storage.get()
+    try resolvedStorage.removeObject(forKey: Self.storageKey(for: dynamicWidgetID))
+  }
+
+  static func storageKey(for dynamicWidgetID: String) -> String {
+    VoltraStorageKeys.dynamicWidgetPropsV1(dynamicWidgetID)
+  }
+}

package/ios/shared/DynamicWidgetRenderCoordinator.swift

@@ -0,0 +1,31 @@
+/// Routes a Dynamic Widget's current persisted props and environment to its runtime boundary.
+struct DynamicWidgetRenderCoordinator {
+  typealias DynamicWidgetPropsProvider = (_ dynamicWidgetID: String) -> String
+  typealias DynamicWidgetRuntimeBoundary = (
+    _ dynamicWidgetID: String,
+    _ dynamicWidgetPropsJSON: String,
+    _ dynamicWidgetEnvironmentJSON: String
+  ) -> String?
+
+  private let dynamicWidgetPropsProvider: DynamicWidgetPropsProvider
+  private let dynamicWidgetRuntimeBoundary: DynamicWidgetRuntimeBoundary
+
+  init(
+    dynamicWidgetPropsProvider: @escaping DynamicWidgetPropsProvider,
+    dynamicWidgetRuntimeBoundary: @escaping DynamicWidgetRuntimeBoundary
+  ) {
+    self.dynamicWidgetPropsProvider = dynamicWidgetPropsProvider
+    self.dynamicWidgetRuntimeBoundary = dynamicWidgetRuntimeBoundary
+  }
+
+  func renderDynamicWidget(
+    dynamicWidgetID: String,
+    dynamicWidgetEnvironmentJSON: String
+  ) -> String? {
+    dynamicWidgetRuntimeBoundary(
+      dynamicWidgetID,
+      dynamicWidgetPropsProvider(dynamicWidgetID),
+      dynamicWidgetEnvironmentJSON
+    )
+  }
+}

package/ios/shared/DynamicWidgetUpdater.swift

@@ -0,0 +1,30 @@
+protocol DynamicWidgetPropsPersistence {
+  func persistDynamicWidgetProps(_ dynamicWidgetPropsJSON: String, for dynamicWidgetID: String) throws
+}
+
+extension DynamicWidgetPropsStore: DynamicWidgetPropsPersistence {}
+
+/// Persists runtime props before requesting a targeted Dynamic Widget timeline reload.
+struct DynamicWidgetUpdater {
+  private let dynamicWidgetPropsPersistence: any DynamicWidgetPropsPersistence
+  private let dynamicWidgetTimelineReload: (String) async throws -> Void
+
+  init(
+    dynamicWidgetPropsPersistence: any DynamicWidgetPropsPersistence,
+    dynamicWidgetTimelineReload: @escaping (String) async throws -> Void
+  ) {
+    self.dynamicWidgetPropsPersistence = dynamicWidgetPropsPersistence
+    self.dynamicWidgetTimelineReload = dynamicWidgetTimelineReload
+  }
+
+  func updateDynamicWidget(
+    dynamicWidgetID: String,
+    dynamicWidgetPropsJSON: String
+  ) async throws {
+    try dynamicWidgetPropsPersistence.persistDynamicWidgetProps(
+      dynamicWidgetPropsJSON,
+      for: dynamicWidgetID
+    )
+    try await dynamicWidgetTimelineReload(dynamicWidgetID)
+  }
+}

package/ios/shared/VoltraConstants.swift

@@ -28,6 +28,10 @@ public enum VoltraStorageKeys {
     "Voltra_Widget_ServerUrl_\(widgetId)"
   }
 
+  public static func dynamicWidgetPropsV1(_ dynamicWidgetId: String) -> String {
+    "Voltra_DynamicWidget_Props_v1_\(dynamicWidgetId)"
+  }
+
   // MARK: - Prefixes / kind identifiers
 
   public static let widgetKindPrefix = "Voltra_Widget_"

package/ios/shared/VoltraJSRenderer.swift

@@ -155,7 +155,9 @@ public enum VoltraJSRenderer {
   // MARK: - Lifecycle
 
   private static func context() -> JSContext? {
-    if let existing = _context { return existing }
+    if let existing = _context {
+      return existing
+    }
     guard let ctx = JSContext() else {
       VoltraLogger.widget.error("[\(TAG)] Failed to create JSContext")
       return nil

package/ios/shared/VoltraNode.swift

@@ -55,7 +55,9 @@ public indirect enum VoltraNode: Hashable, View {
 
   /// Check if node represents nothing
   public var isEmpty: Bool {
-    if case .empty = self { return true }
+    if case .empty = self {
+      return true
+    }
     return false
   }
 
@@ -72,7 +74,9 @@ public indirect enum VoltraNode: Hashable, View {
       // Extract stylesheet (key "s")
       if case let .array(stylesheetArray) = rootObject["s"] {
         stylesheet = stylesheetArray.compactMap { item in
-          if case let .object(dict) = item { return dict }
+          if case let .object(dict) = item {
+            return dict
+          }
           return nil
         }
       }

package/ios/shared/VoltraWidgetDefaults.swift

@@ -86,13 +86,17 @@ public enum VoltraWidgetDefaults {
 
   // MARK: - Remove
 
-  /// Removes all persisted data (json, deepLinkUrl, timeline) for a single widget.
+  /// Removes all persisted data (json, deepLinkUrl, timeline, Dynamic Widget props) for a single widget.
   /// This is the single source of truth for which keys exist per widget.
   public static func removeAllData(for widgetId: String) {
     guard let defaults = try? resolvedDefaults() else { return }
     defaults.removeObject(forKey: VoltraStorageKeys.widgetJson(widgetId))
     defaults.removeObject(forKey: VoltraStorageKeys.widgetDeepLinkUrl(widgetId))
     defaults.removeObject(forKey: VoltraStorageKeys.widgetTimeline(widgetId))
+    let dynamicWidgetPropsStore = DynamicWidgetPropsStore(
+      storage: DynamicWidgetPropsUserDefaultsStorage(userDefaults: defaults)
+    )
+    try? dynamicWidgetPropsStore.clearDynamicWidgetProps(for: widgetId)
     defaults.synchronize()
   }
 
@@ -105,11 +109,15 @@ public enum VoltraWidgetDefaults {
   /// Removes all persisted data for every widget listed in the app's Info.plist.
   public static func removeAllWidgets() {
     guard let defaults = try? resolvedDefaults() else { return }
+    let dynamicWidgetPropsStore = DynamicWidgetPropsStore(
+      storage: DynamicWidgetPropsUserDefaultsStorage(userDefaults: defaults)
+    )
     let widgetIds = Bundle.main.object(forInfoDictionaryKey: VoltraStorageKeys.widgetIds) as? [String] ?? []
     for widgetId in widgetIds {
       defaults.removeObject(forKey: VoltraStorageKeys.widgetJson(widgetId))
       defaults.removeObject(forKey: VoltraStorageKeys.widgetDeepLinkUrl(widgetId))
       defaults.removeObject(forKey: VoltraStorageKeys.widgetTimeline(widgetId))
+      try? dynamicWidgetPropsStore.clearDynamicWidgetProps(for: widgetId)
     }
     defaults.synchronize()
   }

package/ios/target/VoltraClientWidgetRuntime.swift

@@ -351,10 +351,20 @@ public struct VoltraClientWidgetContentView: View {
         locale: locale,
         configuration: entry.configuration
       )
-      if let resolved = VoltraJSRenderer.render(
-        widgetId: entry.widgetId,
-        propsJSON: "{}",
-        envJSON: envJSON
+      let dynamicWidgetPropsStore = DynamicWidgetPropsStore()
+      let dynamicWidgetRenderCoordinator = DynamicWidgetRenderCoordinator(
+        dynamicWidgetPropsProvider: dynamicWidgetPropsStore.dynamicWidgetProps(for:),
+        dynamicWidgetRuntimeBoundary: { dynamicWidgetID, dynamicWidgetPropsJSON, dynamicWidgetEnvironmentJSON in
+          VoltraJSRenderer.render(
+            widgetId: dynamicWidgetID,
+            propsJSON: dynamicWidgetPropsJSON,
+            envJSON: dynamicWidgetEnvironmentJSON
+          )
+        }
+      )
+      if let resolved = dynamicWidgetRenderCoordinator.renderDynamicWidget(
+        dynamicWidgetID: entry.widgetId,
+        dynamicWidgetEnvironmentJSON: envJSON
       ), let node = parseResolvedNode(jsonString: resolved) {
         return VoltraHomeWidgetEntry(date: entry.date, rootNode: node, widgetId: entry.widgetId)
       }
@@ -368,7 +378,9 @@ public struct VoltraClientWidgetContentView: View {
   private func parseResolvedNode(jsonString: String) -> VoltraNode? {
     guard let json = try? JSONValue.parse(from: jsonString) else { return nil }
     let node = VoltraNode.parse(from: json)
-    if case .empty = node { return nil }
+    if case .empty = node {
+      return nil
+    }
     return node
   }
 

package/ios/target/VoltraHomeWidget.swift

@@ -461,7 +461,9 @@ private extension View {
 private func resolveDeepLinkURL(_ 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) { return url }
+    if entryUrl.contains("://"), let url = URL(string: entryUrl) {
+      return url
+    }
     if let scheme = VoltraDeepLinkResolver.deepLinkScheme() {
       let path = entryUrl.hasPrefix("/") ? entryUrl : "/\(entryUrl)"
       return URL(string: "\(scheme)://\(path.trimmingCharacters(in: CharacterSet(charactersIn: "/")))")
@@ -470,7 +472,9 @@ private func resolveDeepLinkURL(_ entry: VoltraHomeWidgetEntry) -> URL? {
 
   // Fallback to static deep link URL from UserDefaults
   if let raw = VoltraHomeWidgetStore.readDeepLinkUrl(widgetId: entry.widgetId), !raw.isEmpty {
-    if raw.contains("://"), let url = URL(string: raw) { return url }
+    if raw.contains("://"), let url = URL(string: raw) {
+      return url
+    }
     if let scheme = VoltraDeepLinkResolver.deepLinkScheme() {
       let path = raw.hasPrefix("/") ? raw : "/\(raw)"
       return URL(string: "\(scheme)://\(path.trimmingCharacters(in: CharacterSet(charactersIn: "/")))")

package/ios/target/VoltraWidget.swift

@@ -9,7 +9,9 @@ public struct VoltraWidget: Widget {
   /// Convert an array of nodes to a single root node for rendering
   private func rootNode(for region: VoltraRegion, from state: VoltraAttributes.ContentState) -> VoltraNode {
     let nodes = state.regions[region] ?? []
-    if nodes.isEmpty { return .empty }
+    if nodes.isEmpty {
+      return .empty
+    }
     return nodes.count == 1 ? nodes[0] : .array(nodes)
   }
 

package/ios/ui/Helpers/VoltraDeepLinkResolver.swift

@@ -30,7 +30,9 @@ enum VoltraDeepLinkResolver {
     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 }
+    if raw.contains("://"), let url = URL(string: raw) {
+      return url
+    }
 
     // Otherwise, prepend the app's URL scheme
     if let scheme = deepLinkScheme() {

package/ios/ui/Helpers/VoltraProgressDriver.swift

@@ -43,10 +43,14 @@ enum VoltraProgressDriver {
   /// The progress value is clamped to `[0, 1]` unless `clamp` is `false`.
   static func progress(for range: ClosedRange<Date>, at date: Date = Date(), clamp: Bool = true) -> Double {
     let total = range.upperBound.timeIntervalSince(range.lowerBound)
-    if total <= 0 { return clamp ? 1 : 0 }
+    if total <= 0 {
+      return clamp ? 1 : 0
+    }
     let elapsed = date.timeIntervalSince(range.lowerBound)
     let ratio = elapsed / total
-    if !clamp { return ratio }
+    if !clamp {
+      return ratio
+    }
     return min(max(ratio, 0), 1)
   }
 }

package/ios/ui/Layout/VoltraFlexStackLayout.swift

@@ -250,7 +250,9 @@ struct VoltraFlexStackLayout: Layout {
       }
     }
     // If stretch and no explicit cross size, use full cross axis (only finite values)
-    if let proposal = proposal, proposal.isFinite { return proposal }
+    if let proposal = proposal, proposal.isFinite {
+      return proposal
+    }
     // Otherwise, measure intrinsic
     let size = subview.sizeThatFits(ProposedViewSize(width: nil, height: nil))
     return crossAxis(size)
@@ -266,8 +268,12 @@ struct VoltraFlexStackLayout: Layout {
 
   private func clamp(_ value: CGFloat, min: CGFloat?, max: CGFloat?) -> CGFloat {
     var result = value
-    if let min = min { result = Swift.max(result, min) }
-    if let max = max { result = Swift.min(result, max) }
+    if let min = min {
+      result = Swift.max(result, min)
+    }
+    if let max = max {
+      result = Swift.min(result, max)
+    }
     return result
   }