@use-voltra/ios-client 1.4.0 → 2.0.0-rc.1

package/ios/target/VoltraWidget.swift

@@ -0,0 +1,158 @@
+import ActivityKit
+import Foundation
+import SwiftUI
+import WidgetKit
+
+public struct VoltraWidget: Widget {
+  public init() {}
+
+  /// 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 }
+    return nodes.count == 1 ? nodes[0] : .array(nodes)
+  }
+
+  public var body: some WidgetConfiguration {
+    if #available(iOS 18.0, *) {
+      return adaptiveConfig()
+    } else {
+      return defaultConfig()
+    }
+  }
+
+  // MARK: - iOS 18+ Configuration (with supplemental activity families)
+
+  @available(iOS 18.0, *)
+  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)
+        }
+    } dynamicIsland: { context in
+      dynamicIslandContent(context: context)
+    }
+    .supplementalActivityFamilies([.small, .medium])
+  }
+
+  // MARK: - Default Configuration (iOS 16.2 - 17.x)
+
+  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)
+        }
+    } dynamicIsland: { context in
+      dynamicIslandContent(context: context)
+    }
+  }
+
+  // MARK: - Adaptive Lock Screen View (iOS 18+)
+
+  @available(iOS 18.0, *)
+  private func adaptiveLocksScreenView(context: ActivityViewContext<VoltraAttributes>) -> some View {
+    VoltraAdaptiveLockScreenView(context: context, rootNodeProvider: rootNode)
+  }
+
+  // MARK: - Dynamic Island (shared between iOS versions)
+
+  private func dynamicIslandContent(context: ActivityViewContext<VoltraAttributes>) -> DynamicIsland {
+    let dynamicIsland = DynamicIsland {
+      DynamicIslandExpandedRegion(.leading) {
+        Voltra(root: rootNode(for: .islandExpandedLeading, from: context.state), activityId: context.activityID)
+          .widgetURL(VoltraDeepLinkResolver.resolve(context.attributes))
+      }
+      DynamicIslandExpandedRegion(.trailing) {
+        Voltra(root: rootNode(for: .islandExpandedTrailing, from: context.state), activityId: context.activityID)
+          .widgetURL(VoltraDeepLinkResolver.resolve(context.attributes))
+      }
+      DynamicIslandExpandedRegion(.center) {
+        Voltra(root: rootNode(for: .islandExpandedCenter, from: context.state), activityId: context.activityID)
+          .widgetURL(VoltraDeepLinkResolver.resolve(context.attributes))
+      }
+      DynamicIslandExpandedRegion(.bottom) {
+        Voltra(root: rootNode(for: .islandExpandedBottom, from: context.state), activityId: context.activityID)
+          .widgetURL(VoltraDeepLinkResolver.resolve(context.attributes))
+      }
+    } compactLeading: {
+      Voltra(root: rootNode(for: .islandCompactLeading, from: context.state), activityId: context.activityID)
+        .widgetURL(VoltraDeepLinkResolver.resolve(context.attributes))
+    } compactTrailing: {
+      Voltra(root: rootNode(for: .islandCompactTrailing, from: context.state), activityId: context.activityID)
+        .widgetURL(VoltraDeepLinkResolver.resolve(context.attributes))
+    } minimal: {
+      Voltra(root: rootNode(for: .islandMinimal, from: context.state), activityId: context.activityID)
+        .widgetURL(VoltraDeepLinkResolver.resolve(context.attributes))
+    }
+
+    // Apply keylineTint if specified
+    if let keylineTint = context.state.keylineTint,
+       let color = JSColorParser.parse(keylineTint)
+    {
+      return dynamicIsland.keylineTint(color)
+    } else {
+      return dynamicIsland
+    }
+  }
+}
+
+// MARK: - Adaptive Lock Screen View Helper
+
+@available(iOS 18.0, *)
+private struct VoltraAdaptiveLockScreenView: View {
+  let context: ActivityViewContext<VoltraAttributes>
+  let rootNodeProvider: (VoltraRegion, VoltraAttributes.ContentState) -> VoltraNode
+
+  @Environment(\.activityFamily) private var activityFamily
+
+  var body: some View {
+    switch activityFamily {
+    case .small:
+      watchContent()
+    case .medium:
+      defaultContent()
+    @unknown default:
+      defaultContent()
+    }
+  }
+
+  @ViewBuilder
+  private func watchContent() -> some View {
+    let leading = context.state.regions[.islandCompactLeading] ?? []
+    let trailing = context.state.regions[.islandCompactTrailing] ?? []
+    let hasCompactContent = !leading.isEmpty || !trailing.isEmpty
+
+    // 1. Try dedicated Watch region
+    if let nodes = context.state.regions[.supplementalActivityFamiliesSmall], !nodes.isEmpty {
+      Voltra(root: rootNodeProvider(.supplementalActivityFamiliesSmall, context.state), activityId: context.activityID)
+    }
+    // 2. Compose from compact Dynamic Island regions
+    else if hasCompactContent {
+      HStack(spacing: 0) {
+        if !leading.isEmpty {
+          Voltra(root: rootNodeProvider(.islandCompactLeading, context.state), activityId: context.activityID)
+        }
+        Spacer()
+        if !trailing.isEmpty {
+          Voltra(root: rootNodeProvider(.islandCompactTrailing, context.state), activityId: context.activityID)
+        }
+      }
+      .frame(maxWidth: .infinity)
+    }
+    // 3. No content available for Watch
+    else {
+      EmptyView()
+    }
+  }
+
+  private func defaultContent() -> some View {
+    // Default content for both StandBy (.medium) and unknown activity families
+    Voltra(root: rootNodeProvider(.lockScreen, context.state), activityId: context.activityID)
+  }
+}

package/ios/ui/Extensions/View.modifiers.swift

@@ -0,0 +1,28 @@
+import SwiftUI
+
+extension View {
+  /// Conditionally apply a modifier if the value is not nil
+  ///
+  /// - Parameters:
+  ///   - value: The optional value to check
+  ///   - transform: The transformation to apply if value is not nil
+  /// - Returns: The modified view or the original view if value is nil
+  @ViewBuilder
+  func voltraIfLet<Value, Content: View>(_ value: Value?, @ViewBuilder _ transform: (Self, Value) -> Content) -> some View {
+    if let value {
+      transform(self, value)
+    } else {
+      self
+    }
+  }
+
+  /// Conditionally applies a transformation to the view.
+  @ViewBuilder
+  func voltraIf<Content: View>(_ condition: Bool, @ViewBuilder _ transform: (Self) -> Content) -> some View {
+    if condition {
+      transform(self)
+    } else {
+      self
+    }
+  }
+}

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

@@ -0,0 +1,18 @@
+import Foundation
+
+public extension VoltraNode {
+  /// Generic type-safe parameter accessor
+  /// Only works on element cases, delegates to VoltraElement.parameters
+  /// - Parameter type: The parameter struct type to decode
+  /// - Returns: Decoded parameters (uses empty dict if props is nil)
+  func parameters<T: ComponentParameters>(_ type: T.Type) -> T {
+    // Only element cases have parameters
+    guard case let .element(element) = self else {
+      // For non-element cases, return default instance
+      // Safe to force-unwrap: decoding an empty JSON object always succeeds for ComponentParameters
+      return try! JSONDecoder().decode(T.self, from: Data("{}".utf8))
+    }
+    // Delegate to VoltraElement's parameters method
+    return element.parameters(type)
+  }
+}

package/ios/ui/Generated/Parameters/.generated

@@ -0,0 +1,8 @@
+This directory contains auto-generated Swift parameter files.
+DO NOT EDIT MANUALLY.
+
+Generated from: data/components.json
+Schema version: 1.0.0
+
+To regenerate these files, run:
+  npm run generate

package/ios/ui/Generated/Parameters/ButtonParameters.swift

@@ -0,0 +1,15 @@
+//
+//  ButtonParameters.swift
+
+//  AUTO-GENERATED from data/components.json
+//  DO NOT EDIT MANUALLY - Changes will be overwritten
+//  Schema version: 1.0.0
+
+import Foundation
+
+/// Parameters for Button component
+/// Interactive button component
+public struct ButtonParameters: ComponentParameters {
+  /// Visual style of the button
+  public let buttonStyle: String?
+}

package/ios/ui/Generated/Parameters/ChartParameters.swift

@@ -0,0 +1,33 @@
+//
+//  ChartParameters.swift
+
+//  AUTO-GENERATED from data/components.json
+//  DO NOT EDIT MANUALLY - Changes will be overwritten
+//  Schema version: 1.0.0
+
+import Foundation
+
+/// Parameters for Chart component
+/// Charts component for data visualization
+public struct ChartParameters: ComponentParameters {
+  /// Compact mark data encoded from children by toJSON
+  public let marks: String?
+
+  /// Show or hide the x-axis
+  public let xAxisVisibility: String?
+
+  /// Configure x-axis grid line style
+  public let xAxisGridStyle: String?
+
+  /// Show or hide the y-axis
+  public let yAxisVisibility: String?
+
+  /// Configure y-axis grid line style
+  public let yAxisGridStyle: String?
+
+  /// Show or hide the chart legend
+  public let legendVisibility: String?
+
+  /// Map of series name to color string
+  public let foregroundStyleScale: String?
+}

package/ios/ui/Generated/Parameters/CircularProgressViewParameters.swift

@@ -0,0 +1,59 @@
+//
+//  CircularProgressViewParameters.swift
+
+//  AUTO-GENERATED from data/components.json
+//  DO NOT EDIT MANUALLY - Changes will be overwritten
+//  Schema version: 1.0.0
+
+import Foundation
+
+/// Parameters for CircularProgressView component
+/// Circular progress indicator (determinate or timer-based)
+public struct CircularProgressViewParameters: ComponentParameters {
+  /// Current progress value
+  public let value: Double?
+
+  /// Whether to count down instead of up
+  public let countDown: Bool?
+
+  /// Maximum progress value
+  public let maximumValue: Double
+
+  /// End time in milliseconds since epoch
+  public let endAtMs: Double?
+
+  /// Start time in milliseconds since epoch
+  public let startAtMs: Double?
+
+  /// Color for the track (background) of the circular progress indicator
+  public let trackColor: String?
+
+  /// Color for the progress fill
+  public let progressColor: String?
+
+  /// Width of the stroke line
+  public let lineWidth: Double?
+
+  enum CodingKeys: String, CodingKey {
+    case value
+    case countDown
+    case maximumValue
+    case endAtMs
+    case startAtMs
+    case trackColor
+    case progressColor
+    case lineWidth
+  }
+
+  public init(from decoder: Decoder) throws {
+    let container = try decoder.container(keyedBy: CodingKeys.self)
+    value = try container.decodeIfPresent(Double.self, forKey: .value)
+    countDown = try container.decodeIfPresent(Bool.self, forKey: .countDown)
+    maximumValue = try container.decodeIfPresent(Double.self, forKey: .maximumValue) ?? 100
+    endAtMs = try container.decodeIfPresent(Double.self, forKey: .endAtMs)
+    startAtMs = try container.decodeIfPresent(Double.self, forKey: .startAtMs)
+    trackColor = try container.decodeIfPresent(String.self, forKey: .trackColor)
+    progressColor = try container.decodeIfPresent(String.self, forKey: .progressColor)
+    lineWidth = try container.decodeIfPresent(Double.self, forKey: .lineWidth)
+  }
+}

package/ios/ui/Generated/Parameters/ComponentParameters.swift

@@ -0,0 +1,12 @@
+//
+//  ComponentParameters.swift
+//
+//  AUTO-GENERATED from data/components.json
+//  DO NOT EDIT MANUALLY - Changes will be overwritten
+//  Schema version: 1.0.0
+
+import Foundation
+
+/// Protocol marker for all component parameter types
+/// All component-specific parameter structs conform to this protocol
+public protocol ComponentParameters: Codable, Hashable {}

package/ios/ui/Generated/Parameters/DividerParameters.swift

@@ -0,0 +1,12 @@
+//
+//  DividerParameters.swift
+
+//  AUTO-GENERATED from data/components.json
+//  DO NOT EDIT MANUALLY - Changes will be overwritten
+//  Schema version: 1.0.0
+
+import Foundation
+
+/// Parameters for Divider component
+/// Visual divider
+public struct DividerParameters: ComponentParameters {}

package/ios/ui/Generated/Parameters/GaugeParameters.swift

@@ -0,0 +1,54 @@
+//
+//  GaugeParameters.swift
+
+//  AUTO-GENERATED from data/components.json
+//  DO NOT EDIT MANUALLY - Changes will be overwritten
+//  Schema version: 1.0.0
+
+import Foundation
+
+/// Parameters for Gauge component
+/// Gauge indicator for progress visualization
+public struct GaugeParameters: ComponentParameters {
+  /// Current gauge value
+  public let value: Double?
+
+  /// Minimum value of the gauge range
+  public let minimumValue: Double
+
+  /// Maximum value of the gauge range
+  public let maximumValue: Double
+
+  /// End time in milliseconds since epoch
+  public let endAtMs: Double?
+
+  /// Start time in milliseconds since epoch
+  public let startAtMs: Double?
+
+  /// Tint color for the gauge
+  public let tintColor: String?
+
+  /// Visual style of the gauge
+  public let gaugeStyle: String?
+
+  enum CodingKeys: String, CodingKey {
+    case value
+    case minimumValue
+    case maximumValue
+    case endAtMs
+    case startAtMs
+    case tintColor
+    case gaugeStyle
+  }
+
+  public init(from decoder: Decoder) throws {
+    let container = try decoder.container(keyedBy: CodingKeys.self)
+    value = try container.decodeIfPresent(Double.self, forKey: .value)
+    minimumValue = try container.decodeIfPresent(Double.self, forKey: .minimumValue) ?? 0
+    maximumValue = try container.decodeIfPresent(Double.self, forKey: .maximumValue) ?? 1
+    endAtMs = try container.decodeIfPresent(Double.self, forKey: .endAtMs)
+    startAtMs = try container.decodeIfPresent(Double.self, forKey: .startAtMs)
+    tintColor = try container.decodeIfPresent(String.self, forKey: .tintColor)
+    gaugeStyle = try container.decodeIfPresent(String.self, forKey: .gaugeStyle)
+  }
+}

package/ios/ui/Generated/Parameters/GlassContainerParameters.swift

@@ -0,0 +1,15 @@
+//
+//  GlassContainerParameters.swift
+
+//  AUTO-GENERATED from data/components.json
+//  DO NOT EDIT MANUALLY - Changes will be overwritten
+//  Schema version: 1.0.0
+
+import Foundation
+
+/// Parameters for GlassContainer component
+/// iOS 26+ Liquid Glass container
+public struct GlassContainerParameters: ComponentParameters {
+  /// Spacing between glass elements
+  public let spacing: Double?
+}

package/ios/ui/Generated/Parameters/GroupBoxParameters.swift

@@ -0,0 +1,12 @@
+//
+//  GroupBoxParameters.swift
+
+//  AUTO-GENERATED from data/components.json
+//  DO NOT EDIT MANUALLY - Changes will be overwritten
+//  Schema version: 1.0.0
+
+import Foundation
+
+/// Parameters for GroupBox component
+/// Grouped content container
+public struct GroupBoxParameters: ComponentParameters {}

package/ios/ui/Generated/Parameters/HStackParameters.swift

@@ -0,0 +1,34 @@
+//
+//  HStackParameters.swift
+
+//  AUTO-GENERATED from data/components.json
+//  DO NOT EDIT MANUALLY - Changes will be overwritten
+//  Schema version: 1.0.0
+
+import Foundation
+
+/// Parameters for HStack component
+/// Horizontal stack container
+public struct HStackParameters: ComponentParameters {
+  /// Vertical alignment
+  public let alignment: String
+
+  /// Layout mode. 'stack' uses native SwiftUI stacks. 'flex' uses RN-like flexbox.
+  public let layout: String
+
+  /// Spacing between children. Takes precedence over gap style property.
+  public let spacing: Double?
+
+  enum CodingKeys: String, CodingKey {
+    case alignment
+    case layout
+    case spacing
+  }
+
+  public init(from decoder: Decoder) throws {
+    let container = try decoder.container(keyedBy: CodingKeys.self)
+    alignment = try container.decodeIfPresent(String.self, forKey: .alignment) ?? "center"
+    layout = try container.decodeIfPresent(String.self, forKey: .layout) ?? "stack"
+    spacing = try container.decodeIfPresent(Double.self, forKey: .spacing)
+  }
+}

package/ios/ui/Generated/Parameters/ImageParameters.swift

@@ -0,0 +1,29 @@
+//
+//  ImageParameters.swift
+
+//  AUTO-GENERATED from data/components.json
+//  DO NOT EDIT MANUALLY - Changes will be overwritten
+//  Schema version: 1.0.0
+
+import Foundation
+
+/// Parameters for Image component
+/// Display images from asset catalog or base64 data
+public struct ImageParameters: ComponentParameters {
+  /// Image source - either { assetName: string } for asset catalog images or { base64: string } for base64 encoded images
+  public let source: String?
+
+  /// How the image should be resized to fit its container
+  public let resizeMode: String
+
+  enum CodingKeys: String, CodingKey {
+    case source
+    case resizeMode
+  }
+
+  public init(from decoder: Decoder) throws {
+    let container = try decoder.container(keyedBy: CodingKeys.self)
+    source = try container.decodeIfPresent(String.self, forKey: .source)
+    resizeMode = try container.decodeIfPresent(String.self, forKey: .resizeMode) ?? "cover"
+  }
+}

package/ios/ui/Generated/Parameters/LabelParameters.swift

@@ -0,0 +1,18 @@
+//
+//  LabelParameters.swift
+
+//  AUTO-GENERATED from data/components.json
+//  DO NOT EDIT MANUALLY - Changes will be overwritten
+//  Schema version: 1.0.0
+
+import Foundation
+
+/// Parameters for Label component
+/// Label with optional icon
+public struct LabelParameters: ComponentParameters {
+  /// Text content for the label
+  public let title: String?
+
+  /// SF Symbol name for the label icon
+  public let systemImage: String?
+}

package/ios/ui/Generated/Parameters/LinearGradientParameters.swift

@@ -0,0 +1,27 @@
+//
+//  LinearGradientParameters.swift
+
+//  AUTO-GENERATED from data/components.json
+//  DO NOT EDIT MANUALLY - Changes will be overwritten
+//  Schema version: 1.0.0
+
+import Foundation
+
+/// Parameters for LinearGradient component
+/// Linear gradient background with children
+public struct LinearGradientParameters: ComponentParameters {
+  /// Pipe-separated color list (e.g., '#ff0000|#00ff00|#0000ff')
+  public let colors: String?
+
+  /// Pipe-separated gradient stops (e.g., 'red@0|orange@0.5|yellow@1')
+  public let stops: String?
+
+  /// Start point (e.g., 'topLeading', 'center', or 'x,y')
+  public let startPoint: String?
+
+  /// End point (e.g., 'bottomTrailing', 'center', or 'x,y')
+  public let endPoint: String?
+
+  /// Enable dithering (system-controlled)
+  public let dither: Bool?
+}

package/ios/ui/Generated/Parameters/LinearProgressViewParameters.swift

@@ -0,0 +1,64 @@
+//
+//  LinearProgressViewParameters.swift
+
+//  AUTO-GENERATED from data/components.json
+//  DO NOT EDIT MANUALLY - Changes will be overwritten
+//  Schema version: 1.0.0
+
+import Foundation
+
+/// Parameters for LinearProgressView component
+/// Linear progress indicator (determinate or timer-based)
+public struct LinearProgressViewParameters: ComponentParameters {
+  /// Current progress value
+  public let value: Double?
+
+  /// Whether to count down instead of up
+  public let countDown: Bool?
+
+  /// Maximum progress value
+  public let maximumValue: Double
+
+  /// End time in milliseconds since epoch
+  public let endAtMs: Double?
+
+  /// Start time in milliseconds since epoch
+  public let startAtMs: Double?
+
+  /// Color for the track (background) of the progress bar
+  public let trackColor: String?
+
+  /// Color for the progress fill
+  public let progressColor: String?
+
+  /// Corner radius for the progress bar
+  public let cornerRadius: Double?
+
+  /// Explicit height for the progress bar
+  public let height: Double?
+
+  enum CodingKeys: String, CodingKey {
+    case value
+    case countDown
+    case maximumValue
+    case endAtMs
+    case startAtMs
+    case trackColor
+    case progressColor
+    case cornerRadius
+    case height
+  }
+
+  public init(from decoder: Decoder) throws {
+    let container = try decoder.container(keyedBy: CodingKeys.self)
+    value = try container.decodeIfPresent(Double.self, forKey: .value)
+    countDown = try container.decodeIfPresent(Bool.self, forKey: .countDown)
+    maximumValue = try container.decodeIfPresent(Double.self, forKey: .maximumValue) ?? 100
+    endAtMs = try container.decodeIfPresent(Double.self, forKey: .endAtMs)
+    startAtMs = try container.decodeIfPresent(Double.self, forKey: .startAtMs)
+    trackColor = try container.decodeIfPresent(String.self, forKey: .trackColor)
+    progressColor = try container.decodeIfPresent(String.self, forKey: .progressColor)
+    cornerRadius = try container.decodeIfPresent(Double.self, forKey: .cornerRadius)
+    height = try container.decodeIfPresent(Double.self, forKey: .height)
+  }
+}

package/ios/ui/Generated/Parameters/LinkParameters.swift

@@ -0,0 +1,15 @@
+//
+//  LinkParameters.swift
+
+//  AUTO-GENERATED from data/components.json
+//  DO NOT EDIT MANUALLY - Changes will be overwritten
+//  Schema version: 1.0.0
+
+import Foundation
+
+/// Parameters for Link component
+/// Navigable link that opens a URL when tapped
+public struct LinkParameters: ComponentParameters {
+  /// URL to navigate to when the link is tapped
+  public let destination: String?
+}

package/ios/ui/Generated/Parameters/MaskParameters.swift

@@ -0,0 +1,12 @@
+//
+//  MaskParameters.swift
+
+//  AUTO-GENERATED from data/components.json
+//  DO NOT EDIT MANUALLY - Changes will be overwritten
+//  Schema version: 1.0.0
+
+import Foundation
+
+/// Parameters for Mask component
+/// Mask content using any Voltra element as the mask shape
+public struct MaskParameters: ComponentParameters {}

package/ios/ui/Generated/Parameters/SpacerParameters.swift

@@ -0,0 +1,15 @@
+//
+//  SpacerParameters.swift
+
+//  AUTO-GENERATED from data/components.json
+//  DO NOT EDIT MANUALLY - Changes will be overwritten
+//  Schema version: 1.0.0
+
+import Foundation
+
+/// Parameters for Spacer component
+/// Flexible space
+public struct SpacerParameters: ComponentParameters {
+  /// Minimum length
+  public let minLength: Double?
+}