voltra 1.4.1 → 2.0.0-rc.3

package/ios/target/VoltraWidget.swift

@@ -1,158 +0,0 @@
-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

@@ -1,28 +0,0 @@
-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

@@ -1,18 +0,0 @@
-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

@@ -1,8 +0,0 @@
-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/AndroidCheckBoxParameters.swift

@@ -1,29 +0,0 @@
-//
-//  AndroidCheckBoxParameters.swift
-
-//  AUTO-GENERATED from data/components.json
-//  DO NOT EDIT MANUALLY - Changes will be overwritten
-//  Schema version: 1.0.0
-
-import Foundation
-
-/// Parameters for AndroidCheckBox component
-/// Android Material Design checkbox component for widgets
-public struct AndroidCheckBoxParameters: ComponentParameters {
-  /// Unique identifier for this checkbox (required for interaction events)
-  public let id: String?
-
-  /// Initial checked state
-  public let checked: Bool
-
-  enum CodingKeys: String, CodingKey {
-    case id
-    case checked
-  }
-
-  public init(from decoder: Decoder) throws {
-    let container = try decoder.container(keyedBy: CodingKeys.self)
-    id = try container.decodeIfPresent(String.self, forKey: .id)
-    checked = try container.decodeIfPresent(Bool.self, forKey: .checked) ?? false
-  }
-}

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

@@ -1,29 +0,0 @@
-//
-//  AndroidRadioButtonParameters.swift
-
-//  AUTO-GENERATED from data/components.json
-//  DO NOT EDIT MANUALLY - Changes will be overwritten
-//  Schema version: 1.0.0
-
-import Foundation
-
-/// Parameters for AndroidRadioButton component
-/// Android Material Design radio button component for widgets
-public struct AndroidRadioButtonParameters: ComponentParameters {
-  /// Unique identifier for this radio button (required for interaction events)
-  public let id: String?
-
-  /// Initial checked state
-  public let checked: Bool
-
-  enum CodingKeys: String, CodingKey {
-    case id
-    case checked
-  }
-
-  public init(from decoder: Decoder) throws {
-    let container = try decoder.container(keyedBy: CodingKeys.self)
-    id = try container.decodeIfPresent(String.self, forKey: .id)
-    checked = try container.decodeIfPresent(Bool.self, forKey: .checked) ?? false
-  }
-}

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

@@ -1,29 +0,0 @@
-//
-//  AndroidSwitchParameters.swift
-
-//  AUTO-GENERATED from data/components.json
-//  DO NOT EDIT MANUALLY - Changes will be overwritten
-//  Schema version: 1.0.0
-
-import Foundation
-
-/// Parameters for AndroidSwitch component
-/// Android Material Design switch component for widgets
-public struct AndroidSwitchParameters: ComponentParameters {
-  /// Unique identifier for this switch (required for interaction events)
-  public let id: String?
-
-  /// Initial checked state
-  public let checked: Bool
-
-  enum CodingKeys: String, CodingKey {
-    case id
-    case checked
-  }
-
-  public init(from decoder: Decoder) throws {
-    let container = try decoder.container(keyedBy: CodingKeys.self)
-    id = try container.decodeIfPresent(String.self, forKey: .id)
-    checked = try container.decodeIfPresent(Bool.self, forKey: .checked) ?? false
-  }
-}

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

@@ -1,24 +0,0 @@
-//
-//  BoxParameters.swift
-
-//  AUTO-GENERATED from data/components.json
-//  DO NOT EDIT MANUALLY - Changes will be overwritten
-//  Schema version: 1.0.0
-
-import Foundation
-
-/// Parameters for Box component
-/// Flex container with configurable direction. Always uses flexbox layout.
-public struct BoxParameters: ComponentParameters {
-  /// Spacing between children
-  public let spacing: Double
-
-  enum CodingKeys: String, CodingKey {
-    case spacing
-  }
-
-  public init(from decoder: Decoder) throws {
-    let container = try decoder.container(keyedBy: CodingKeys.self)
-    spacing = try container.decodeIfPresent(Double.self, forKey: .spacing) ?? 0
-  }
-}

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

@@ -1,15 +0,0 @@
-//
-//  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

@@ -1,33 +0,0 @@
-//
-//  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

@@ -1,59 +0,0 @@
-//
-//  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

@@ -1,12 +0,0 @@
-//
-//  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/DisclosureGroupParameters.swift

@@ -1,15 +0,0 @@
-//
-//  DisclosureGroupParameters.swift
-
-//  AUTO-GENERATED from data/components.json
-//  DO NOT EDIT MANUALLY - Changes will be overwritten
-//  Schema version: 1.0.0
-
-import Foundation
-
-/// Parameters for DisclosureGroup component
-/// Collapsible disclosure group
-public struct DisclosureGroupParameters: ComponentParameters {
-  /// Initial expanded state
-  public let isExpanded: Bool?
-}

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

@@ -1,12 +0,0 @@
-//
-//  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/FilledButtonParameters.swift

@@ -1,29 +0,0 @@
-//
-//  FilledButtonParameters.swift
-
-//  AUTO-GENERATED from data/components.json
-//  DO NOT EDIT MANUALLY - Changes will be overwritten
-//  Schema version: 1.0.0
-
-import Foundation
-
-/// Parameters for FilledButton component
-/// Android Material Design filled button component for widgets
-public struct FilledButtonParameters: ComponentParameters {
-  /// Text to display on the button
-  public let text: String?
-
-  /// Whether the button is enabled
-  public let enabled: Bool
-
-  enum CodingKeys: String, CodingKey {
-    case text
-    case enabled
-  }
-
-  public init(from decoder: Decoder) throws {
-    let container = try decoder.container(keyedBy: CodingKeys.self)
-    text = try container.decodeIfPresent(String.self, forKey: .text)
-    enabled = try container.decodeIfPresent(Bool.self, forKey: .enabled) ?? true
-  }
-}

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

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

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

@@ -1,54 +0,0 @@
-//
-//  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

@@ -1,15 +0,0 @@
-//
-//  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

@@ -1,12 +0,0 @@
-//
-//  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/HSplitViewParameters.swift

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

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

@@ -1,34 +0,0 @@
-//
-//  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)
-  }
-}