feat(ios): add Icon and List element rendering for v4.1.0

VikrantSingh01 · VikrantSingh01 · commit 80a067403314 · 2026-03-19T16:10:09.000-07:00
diff --git a/apps/shared/OpenClawKit/Sources/OpenClawChatUI/AdaptiveCard/AdaptiveCardModels.swift b/apps/shared/OpenClawKit/Sources/OpenClawChatUI/AdaptiveCard/AdaptiveCardModels.swift
@@ -20,6 +20,8 @@ enum CardElement: Codable {
     case codeBlock(CodeBlock)
     case imageSet(ImageSet)
     case actionSet(ActionSet)
+    case icon(ACIcon)
+    case list(ACList)
     case unknown
 
     struct TextBlock: Codable {
@@ -107,6 +109,11 @@ enum CardElement: Codable {
         let actions: [CardAction]
     }
 
+    struct ACListItem: Codable {
+        let text: String
+        let icon: ACIcon?
+    }
+
     // Manual decoding keyed on "type"
     private enum CodingKeys: String, CodingKey {
         case type
@@ -137,6 +144,10 @@ enum CardElement: Codable {
             self = .imageSet(try ImageSet(from: decoder))
         case "ActionSet":
             self = .actionSet(try ActionSet(from: decoder))
+        case "Icon":
+            self = .icon(try ACIcon(from: decoder))
+        case "List":
+            self = .list(try ACList(from: decoder))
         default:
             self = .unknown
         }
@@ -175,12 +186,34 @@ enum CardElement: Codable {
         case .actionSet(let actSet):
             try container.encode("ActionSet", forKey: .type)
             try actSet.encode(to: encoder)
+        case .icon(let ico):
+            try container.encode("Icon", forKey: .type)
+            try ico.encode(to: encoder)
+        case .list(let lst):
+            try container.encode("List", forKey: .type)
+            try lst.encode(to: encoder)
         case .unknown:
             try container.encode("Unknown", forKey: .type)
         }
     }
 }
 
+// MARK: - Icon element (v4.1.0)
+
+struct ACIcon: Codable {
+    let name: String
+    let size: String?
+    let color: String?
+    let style: String? // "regular" or "filled"
+}
+
+// MARK: - List element (v4.1.0)
+
+struct ACList: Codable {
+    let items: [CardElement.ACListItem]
+    let style: String? // "ordered" or "unordered"
+}
+
 enum CardAction: Codable {
     case submit(SubmitAction)
     case execute(ExecuteAction)
diff --git a/apps/shared/OpenClawKit/Sources/OpenClawChatUI/AdaptiveCard/AdaptiveCardView.swift b/apps/shared/OpenClawKit/Sources/OpenClawChatUI/AdaptiveCard/AdaptiveCardView.swift
@@ -49,6 +49,10 @@ struct AdaptiveCardView: View {
             self.renderImageSet(imgSet)
         case .actionSet(let actSet):
             self.renderActions(actSet.actions)
+        case .icon(let ico):
+            self.renderIcon(ico)
+        case .list(let lst):
+            self.renderList(lst)
         case .unknown:
             EmptyView()
         }
@@ -239,6 +243,89 @@ struct AdaptiveCardView: View {
         }
     }
 
+    // MARK: - Icon rendering
+
+    @ViewBuilder
+    private func renderIcon(_ icon: ACIcon) -> some View {
+        self.iconView(icon)
+    }
+
+    /// Builds a view for an ACIcon: SF Symbol when the name matches, otherwise a text label.
+    @ViewBuilder
+    private func iconView(_ icon: ACIcon) -> some View {
+        let iconSize = self.iconFontSize(icon.size)
+        let iconColor = self.iconColor(icon.color)
+
+        // Attempt SF Symbol lookup; fall back to a text label
+        if self.sfSymbolExists(icon.name) {
+            Image(systemName: icon.name)
+                .font(.system(size: iconSize))
+                .foregroundStyle(iconColor)
+        } else {
+            Text(icon.name)
+                .font(.system(size: iconSize))
+                .foregroundStyle(iconColor)
+        }
+    }
+
+    /// Map Adaptive Card icon size tokens to point sizes.
+    private func iconFontSize(_ size: String?) -> CGFloat {
+        switch size?.lowercased() {
+        case "xxs": return 10
+        case "xs": return 12
+        case "sm", "small": return 14
+        case "md", "medium": return 18
+        case "lg", "large": return 24
+        case "xl": return 30
+        case "xxl": return 38
+        default: return 16
+        }
+    }
+
+    /// Resolve Adaptive Card color tokens to SwiftUI colors.
+    private func iconColor(_ color: String?) -> Color {
+        switch color?.lowercased() {
+        case "accent": return .accentColor
+        case "good": return .green
+        case "warning": return .orange
+        case "attention": return .red
+        case "light": return .secondary
+        case "dark": return .primary
+        default: return .primary
+        }
+    }
+
+    /// Check whether an SF Symbol name is valid at runtime.
+    private func sfSymbolExists(_ name: String) -> Bool {
+        #if canImport(UIKit)
+        return UIImage(systemName: name) != nil
+        #elseif canImport(AppKit)
+        return NSImage(systemSymbolName: name, accessibilityDescription: nil) != nil
+        #else
+        return false
+        #endif
+    }
+
+    // MARK: - List rendering
+
+    @ViewBuilder
+    private func renderList(_ list: ACList) -> some View {
+        let ordered = list.style?.lowercased() == "ordered"
+        VStack(alignment: .leading, spacing: 4) {
+            ForEach(list.items.indices, id: \.self) { idx in
+                HStack(alignment: .top, spacing: 4) {
+                    if let icon = list.items[idx].icon {
+                        self.iconView(icon)
+                    }
+                    let prefix = ordered ? "\(idx + 1)." : "\u{2022}"
+                    Text("\(prefix) \(list.items[idx].text)")
+                        .font(.subheadline)
+                        .fixedSize(horizontal: false, vertical: true)
+                }
+            }
+        }
+    }
+
     private func imageMaxHeight(_ size: String?) -> CGFloat {
         switch size?.lowercased() {
         case "small": return 60
