update

MVMCoreUI.xcodeproj/project.pbxproj

@@ -290,6 +290,7 @@
 		BBC0C4FF24811DCA0087C44F /* TagModel.swift in Sources */ = {isa = PBXBuildFile; fileRef = BBC0C4FE24811DCA0087C44F /* TagModel.swift */; };
 		C003506123AA94CD00B6AC29 /* Button.swift in Sources */ = {isa = PBXBuildFile; fileRef = C003506023AA94CD00B6AC29 /* Button.swift */; };
 		C07065C42395677300FBF997 /* Link.swift in Sources */ = {isa = PBXBuildFile; fileRef = C07065C32395677300FBF997 /* Link.swift */; };
+		C6687441259D92D400F32D13 /* ActionTopNotificationModel.swift in Sources */ = {isa = PBXBuildFile; fileRef = C6687440259D92D400F32D13 /* ActionTopNotificationModel.swift */; };
 		C695A67F23C9830600BFB94E /* UnOrderedListModel.swift in Sources */ = {isa = PBXBuildFile; fileRef = C695A67E23C9830600BFB94E /* UnOrderedListModel.swift */; };
 		C695A68123C9830D00BFB94E /* NumberedListModel.swift in Sources */ = {isa = PBXBuildFile; fileRef = C695A68023C9830D00BFB94E /* NumberedListModel.swift */; };
 		C695A69423C9909000BFB94E /* DoughnutChartModel.swift in Sources */ = {isa = PBXBuildFile; fileRef = C695A69323C9909000BFB94E /* DoughnutChartModel.swift */; };
@@ -833,6 +834,7 @@
 		BBC0C4FE24811DCA0087C44F /* TagModel.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = TagModel.swift; sourceTree = "<group>"; };
 		C003506023AA94CD00B6AC29 /* Button.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Button.swift; sourceTree = "<group>"; };
 		C07065C32395677300FBF997 /* Link.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = Link.swift; sourceTree = "<group>"; };
+		C6687440259D92D400F32D13 /* ActionTopNotificationModel.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ActionTopNotificationModel.swift; sourceTree = "<group>"; };
 		C695A67E23C9830600BFB94E /* UnOrderedListModel.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = UnOrderedListModel.swift; sourceTree = "<group>"; };
 		C695A68023C9830D00BFB94E /* NumberedListModel.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = NumberedListModel.swift; sourceTree = "<group>"; };
 		C695A69323C9909000BFB94E /* DoughnutChartModel.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = DoughnutChartModel.swift; sourceTree = "<group>"; };
@@ -1308,6 +1310,7 @@
 				D2ED27E9254B0CE600A1C293 /* ActionAlertModel.swift */,
 				D2ED27EA254B0CE700A1C293 /* AlertModel.swift */,
 				D2ED27E8254B0CE600A1C293 /* ActionPopupModel.swift */,
+				C6687440259D92D400F32D13 /* ActionTopNotificationModel.swift */,
 			);
 			path = Actions;
 			sourceTree = "<group>";
@@ -2432,6 +2435,7 @@
 				32F8804824765C8400C2ACB3 /* ListLeftVariableNumberedListAllTextAndLinks.swift in Sources */,
 				D2CAC7CF2511052300C75681 /* CollapsableNotificationModel.swift in Sources */,
 				DBC4391822442197001AB423 /* CaretView.swift in Sources */,
+				C6687441259D92D400F32D13 /* ActionTopNotificationModel.swift in Sources */,
 				C07065C42395677300FBF997 /* Link.swift in Sources */,
 				0A69F611241BDEA700F7231B /* RuleAnyRequiredModel.swift in Sources */,
 				D29B771022C281F400D6ACE0 /* ModuleMolecule.swift in Sources */,

MVMCoreUI/Atomic/Actions/ActionTopNotificationModel.swift

@@ -0,0 +1,24 @@
+//
+//  ActionTopNotificationModel.swift
+//  MVMCoreUI
+//
+//  Created by Murugan, Vimal on 31/12/20.
+//  Copyright © 2020 Verizon Wireless. All rights reserved.
+//
+
+import UIKit
+
+@objcMembers public class ActionTopNotificationModel: ActionModelProtocol {
+
+    public static var identifier: String = "topNotification"
+    public var actionType: String = ActionTopNotificationModel.identifier
+    public var topNotification: TopNotificationModel
+    public var extraParameters: JSONValueDictionary?
+    public var analyticsData: JSONValueDictionary?
+    
+    public init(topNotification: TopNotificationModel, _ extraParameters: JSONValueDictionary? = nil, _ analyticsData: JSONValueDictionary? = nil) {
+        self.topNotification = topNotification
+        self.extraParameters = extraParameters
+        self.analyticsData = analyticsData
+    }
+}

MVMCoreUI/Atomic/Atoms/FormFields/TextFields/EntryField.swift

@@ -71,13 +71,17 @@ import UIKit
     public var showError: Bool {
         get { return entryFieldContainer.showError }
         set (error) {
-            self.feedback = error ? entryFieldModel?.errorMessage : entryFieldModel?.feedback
+            self.feedback = error ? errorMessage : entryFieldModel?.feedback
             self.feedbackLabel.textColor = error ? entryFieldModel?.errorTextColor?.uiColor ?? .mvmBlack : .mvmBlack
             self.entryFieldContainer.showError = error
             self.entryFieldModel?.showError = error
         }
     }
     
+    var errorMessage: String? {
+        entryFieldModel?.dynamicErrorMessage ?? entryFieldModel?.errorMessage
+    }
+    
     /// Toggles original or locked UI.
     public var isLocked: Bool {
         get { return entryFieldContainer.isLocked }
@@ -306,16 +310,30 @@ import UIKit
                 
                 if self.isSelected {
                     self.updateValidation(model.isValid ?? true)
+                    
                 } else if model.isValid ?? true && self.showError {
                     self.showError = false
                 }
             })
         }
         
+        model.updateUIDynamicError = { [weak self] in
+            MVMCoreDispatchUtility.performBlock(onMainThread: {
+                guard let self = self else { return }
+                let validState = model.isValid ?? false
+                self.updateValidation(validState)
+                if !validState && model.shouldClearText {
+                    self.text = ""
+                    model.shouldClearText = false
+                }
+            })
+        }
+        
         title = model.title
         feedback = model.feedback
         isEnabled = model.enabled
         entryFieldContainer.disableAllBorders = model.hideBorders
+        accessibilityIdentifier = model.accessibilityIdentifier ?? model.fieldKey
         
         if let isLocked = model.locked {
             self.isLocked = isLocked

MVMCoreUI/Atomic/Atoms/FormFields/TextFields/EntryFieldModel.swift

@@ -20,6 +20,13 @@ import Foundation
     public var accessibilityIdentifier: String?
     public var title: String?
     public var feedback: String?
+    public var shouldClearText: Bool = false
+    public var dynamicErrorMessage: String? {
+        didSet {
+            isValid = dynamicErrorMessage?.isEmpty ?? true
+            updateUIDynamicError?()
+        }
+    }
     public var errorMessage: String?
     public var errorTextColor: Color?
     public var enabled: Bool = true
@@ -40,6 +47,9 @@ import Foundation
     /// Temporary binding mechanism for the view to update on enable changes.
     public var updateUI: ActionBlock?
 
+    // TODO: Remove once updateUI is fixed with isSelected
+    public var updateUIDynamicError: ActionBlock?
+    
     //--------------------------------------------------
     // MARK: - Keys
     //--------------------------------------------------
@@ -66,7 +76,12 @@ import Foundation
     // MARK: - Validation Methods
     //--------------------------------------------------
     
-    public func formFieldValue() -> AnyHashable? { text }
+    public func formFieldValue() -> AnyHashable? {
+        if dynamicErrorMessage != nil {
+            dynamicErrorMessage = nil
+        }
+        return text
+    }
     
     public func setValidity(_ valid: Bool, rule: RulesProtocol) {
         

MVMCoreUI/Atomic/MoleculeObjectMapping.swift

@@ -259,6 +259,7 @@ import Foundation
         try? ModelRegistry.register(ActionTopAlertModel.self)
         try? ModelRegistry.register(ActionCollapseNotificationModel.self)
         try? ModelRegistry.register(ActionOpenPanelModel.self)
+        try? ModelRegistry.register(ActionTopNotificationModel.self)
         
         // MARK:- Behaviors
         try? ModelRegistry.register(ScreenBrightnessModifierBehavior.self)

MVMCoreUI/Atomic/Molecules/Items/CarouselItemModel.swift

@@ -9,12 +9,12 @@
 import Foundation
 
 
-@objcMembers public class CarouselItemModel: MoleculeCollectionItemModel, CarouselItemModelProtocol {
+@objcMembers open class CarouselItemModel: MoleculeCollectionItemModel, CarouselItemModelProtocol {
     //--------------------------------------------------
     // MARK: - Properties
     //--------------------------------------------------
     
-    public override class var identifier: String {
+    open override class var identifier: String {
         return "carouselItem"
     }
     
@@ -44,7 +44,7 @@ import Foundation
         try super.init(from: decoder)
     }
 
-    public override func encode(to encoder: Encoder) throws {
+    open override func encode(to encoder: Encoder) throws {
         try super.encode(to: encoder)
         var container = encoder.container(keyedBy: CodingKeys.self)
         try container.encodeIfPresent(peakingUI, forKey: .peakingUI)

MVMCoreUI/Atomic/Molecules/Items/MoleculeCollectionItemModel.swift

@@ -9,7 +9,7 @@
 import Foundation
 
 /// A model for a collection item that is a container for any molecule.
-@objcMembers public class MoleculeCollectionItemModel: MoleculeContainerModel, CollectionItemModelProtocol {
+@objcMembers open class MoleculeCollectionItemModel: MoleculeContainerModel, CollectionItemModelProtocol {
     open override class var identifier: String {
         return "collectionItem"
     }

MVMCoreUI/Atomic/Molecules/TopNotification/NotificationXButton.swift

@@ -26,6 +26,8 @@ import Foundation
         adjustsImageWhenHighlighted = false
         accessibilityLabel = MVMCoreUIUtility.hardcodedString(withKey: "AccCloseButton")
         setContentCompressionResistancePriority(.defaultHigh, for: .horizontal)
+        heightAnchor.constraint(equalToConstant: 16.0).isActive = true
+        widthAnchor.constraint(equalToConstant: 16.0).isActive = true
     }
     
     open override func set(with model: MoleculeModelProtocol, _ delegateObject: MVMCoreUIDelegateObject?, _ additionalData: [AnyHashable : Any]?) {

MVMCoreUI/BaseClasses/UICollectionViewLeftAlignedLayout.swift

@@ -9,8 +9,8 @@
 
 import Foundation
 
-class UICollectionViewLeftAlignedLayout: UICollectionViewFlowLayout {
+public class UICollectionViewLeftAlignedLayout: UICollectionViewFlowLayout {
-    override func layoutAttributesForElements(in rect: CGRect) -> [UICollectionViewLayoutAttributes]? {
+    public override func layoutAttributesForElements(in rect: CGRect) -> [UICollectionViewLayoutAttributes]? {
         guard let attributes = super.layoutAttributesForElements(in: rect) else { return nil }
         var newAttributesForElementsInRect = [UICollectionViewLayoutAttributes]()
         for attribute in attributes {

MVMCoreUI/BaseControllers/ViewController.swift

@@ -18,12 +18,8 @@ import UIKit
     @objc public var loadObject: MVMCoreLoadObject?
     public var model: MVMControllerModelProtocol?
     public var pageModel: PageModelProtocol? {
-        get {
+        get { model }
-            return model
+        set { model = newValue as? MVMControllerModelProtocol }
-        }
-        set {
-            model = newValue as? MVMControllerModelProtocol
-        }
     }
     
     /// Set if this page is containted in a manager.
@@ -31,19 +27,17 @@ import UIKit
     
     /// A temporary iVar backer for delegateObject() until we change the protocol
     public lazy var delegateObjectIVar: MVMCoreUIDelegateObject = {
-        return MVMCoreUIDelegateObject.create(withDelegateForAll: self)
+        MVMCoreUIDelegateObject.create(withDelegateForAll: self)
     }()
     
-    public func delegateObject() -> DelegateObject? {
+    public func delegateObject() -> DelegateObject? { delegateObjectIVar }
-        return delegateObjectIVar
-    }
     
     public var formValidator: FormValidator?
     
     public var needsUpdateUI = false
     private var observingForResponses = false
     private var initialLoadFinished = false
-    private var previousScreenSize = CGSize.zero
+    public var previousScreenSize = CGSize.zero
     
     public var selectedField: UIView?
     
@@ -52,7 +46,7 @@ import UIKit
     
     /// Checks if the screen width has changed
     open func screenSizeChanged() -> Bool {
-        return !MVMCoreGetterUtility.cgfequalwiththreshold(previousScreenSize.width, view.bounds.size.width, 0.1)
+        !MVMCoreGetterUtility.cgfequalwiththreshold(previousScreenSize.width, view.bounds.size.width, 0.1)
     }
     
     //--------------------------------------------------
@@ -80,7 +74,7 @@ import UIKit
     }
     
     open func modulesToListenFor() -> [String]? {
-        return loadObject?.requestParameters?.modules as? [String]
+        loadObject?.requestParameters?.modules as? [String]
     }
     
     @objc open func responseJSONUpdated(notification: Notification) {
@@ -405,7 +399,7 @@ import UIKit
     }
     
     open override var supportedInterfaceOrientations: UIInterfaceOrientationMask {
-        return MVMCoreGetterUtility.isOnIPad() ? UIInterfaceOrientationMask.all : UIInterfaceOrientationMask.portrait
+        MVMCoreGetterUtility.isOnIPad() ? UIInterfaceOrientationMask.all : UIInterfaceOrientationMask.portrait
     }
     
     open override func viewWillTransition(to size: CGSize, with coordinator: UIViewControllerTransitionCoordinator) {
@@ -424,6 +418,7 @@ import UIKit
     open func viewControllerReady(inManager manager: UIViewController & MVMCoreViewManagerProtocol) {
         pageShown()
     }
+    
     //--------------------------------------------------
     // MARK: - MVMCoreLoadDelegateProtocol
     //--------------------------------------------------
@@ -444,6 +439,21 @@ import UIKit
     open func addFormParams(_ requestParameters: MVMCoreRequestParameters) {
         formValidator?.addFormParams(requestParameters: requestParameters)
     }
+    
+    public func handleFieldErrors(_ fieldErrors: [Any]?, loadObject: MVMCoreLoadObject) {
+        
+        for case let fieldError as [AnyHashable: Any] in fieldErrors ?? [] {
+            
+            guard let fieldName = fieldError["fieldName"] as? String,
+                  let userError = fieldError["userMessage"] as? String,
+                  let entryFieldModel = formValidator?.fields[fieldName] as? EntryFieldModel
+            else { continue }
+            
+            entryFieldModel.shouldClearText = fieldError["clearText"] as? Bool ?? true
+            entryFieldModel.dynamicErrorMessage = userError
+        }
+    }
+    
     //--------------------------------------------------
     // MARK: - MVMCoreActionDelegateProtocol
     //--------------------------------------------------
@@ -484,7 +494,7 @@ import UIKit
     
     // Needed otherwise when subclassed, the extension gets called.
     open func moleculeLayoutUpdated(_ molecule: MoleculeViewProtocol) { }
-    open func getIndexPath(for molecule: ListItemModelProtocol & MoleculeModelProtocol) -> IndexPath? { return nil }
+    open func getIndexPath(for molecule: ListItemModelProtocol & MoleculeModelProtocol) -> IndexPath? { nil }
     open func addMolecules(_ molecules: [ListItemModelProtocol & MoleculeModelProtocol], indexPath: IndexPath, animation: UITableView.RowAnimation) { }
     open func removeMolecules(_ molecules: [ListItemModelProtocol & MoleculeModelProtocol], animation: UITableView.RowAnimation) { }
     
@@ -514,7 +524,7 @@ import UIKit
     }
     
     open func showRightPanelForScreenBeforeLaunchApp() -> Bool {
-        return loadObject?.pageJSON?.lenientBoolForKey("showRightPanel") ?? false
+        loadObject?.pageJSON?.lenientBoolForKey("showRightPanel") ?? false
     }
     
     // TODO: make molecular
@@ -610,6 +620,6 @@ import UIKit
     //--------------------------------------------------
     
     func executeBehaviors<T>(_ behaviorBlock:(_ behavior:T)->Void) {
-        model?.behaviors?.compactMap({ $0 as? T }).forEach { behaviorBlock($0) }
+        model?.behaviors?.compactMap { $0 as? T }.forEach { behaviorBlock($0) }
     }
 }

MVMCoreUI/Containers/Views/Container.swift

@@ -15,9 +15,9 @@ open class Container: View, ContainerProtocol {
     //--------------------------------------------------
     
     public var view: UIView?
-    let containerHelper = ContainerHelper()
+    public let containerHelper = ContainerHelper()
     
-    var containerModel: ContainerModelProtocol? {
+    public var containerModel: ContainerModelProtocol? {
         get { return model as? ContainerModelProtocol }
     }
     

MVMCoreUI/Containers/Views/ContainerHelper.swift

@@ -15,23 +15,23 @@ open class ContainerHelper: NSObject {
     // MARK: - Constraints
     //--------------------------------------------------
     
-    var leftConstraint: NSLayoutConstraint?
+    open var leftConstraint: NSLayoutConstraint?
-    var topConstraint: NSLayoutConstraint?
+    open var topConstraint: NSLayoutConstraint?
-    var bottomConstraint: NSLayoutConstraint?
+    open var bottomConstraint: NSLayoutConstraint?
-    var rightConstraint: NSLayoutConstraint?
+    open var rightConstraint: NSLayoutConstraint?
     
-    var alignCenterHorizontalConstraint: NSLayoutConstraint?
+    open var alignCenterHorizontalConstraint: NSLayoutConstraint?
-    var alignCenterLeftConstraint: NSLayoutConstraint?
+    open var alignCenterLeftConstraint: NSLayoutConstraint?
-    var alignCenterRightConstraint: NSLayoutConstraint?
+    open var alignCenterRightConstraint: NSLayoutConstraint?
     
-    var alignCenterVerticalConstraint: NSLayoutConstraint?
+    open var alignCenterVerticalConstraint: NSLayoutConstraint?
-    var alignCenterTopConstraint: NSLayoutConstraint?
+    open var alignCenterTopConstraint: NSLayoutConstraint?
-    var alignCenterBottomConstraint: NSLayoutConstraint?
+    open var alignCenterBottomConstraint: NSLayoutConstraint?
 
-    var leftLowConstraint: NSLayoutConstraint?
+    open var leftLowConstraint: NSLayoutConstraint?
-    var topLowConstraint: NSLayoutConstraint?
+    open var topLowConstraint: NSLayoutConstraint?
-    var bottomLowConstraint: NSLayoutConstraint?
+    open var bottomLowConstraint: NSLayoutConstraint?
-    var rightLowConstraint: NSLayoutConstraint?
+    open var rightLowConstraint: NSLayoutConstraint?
     
     //--------------------------------------------------
     // MARK: - Methods

MVMCoreUI/FormUIHelpers/FormFieldProtocol.swift

@@ -22,7 +22,6 @@ public protocol FormFieldProtocol: FormItemProtocol {
 }
 
 extension FormFieldProtocol {
-    var baseValue: AnyHashable? {
+    
-        return nil
+    var baseValue: AnyHashable? { nil }
-    }
 }

MVMCoreUI/OtherHandlers/MVMCoreUIActionHandler.h

@@ -24,6 +24,9 @@ NS_ASSUME_NONNULL_BEGIN
 // Collapses the current top notification
 - (void)collapseNotificationAction:(nullable NSDictionary *)actionInformation additionalData:(nullable NSDictionary *)additionalData delegateObject:(nullable DelegateObject *)delegateObject;
 
+// Shows a topnotification new molecular
+- (void)topNotificationAction:(nullable NSDictionary *)actionInformation additionalData:(nullable NSDictionary *)additionalData delegateObject:(nullable DelegateObject *)delegateObject;
+
 #pragma mark - Deprecated
 
 // Shows a popup
@@ -32,6 +35,9 @@ NS_ASSUME_NONNULL_BEGIN
 // Shows a top alert
 - (void)topAlertAction:(nullable NSDictionary *)actionInformation additionalData:(nullable NSDictionary *)additionalData delegate:(nullable NSObject <MVMCoreLoadDelegateProtocol, MVMCorePresentationDelegateProtocol,MVMCoreActionDelegateProtocol>*)delegate __deprecated;
 
+// Shows a molecular top alert
+- (void)topNotificationAction:(nullable NSDictionary *)actionInformation additionalData:(nullable NSDictionary *)additionalData delegate:(nullable NSObject <MVMCoreLoadDelegateProtocol, MVMCorePresentationDelegateProtocol,MVMCoreActionDelegateProtocol>*)delegate __deprecated;
+
 // Collapses the current top notification
 - (void)collapseNotificationAction:(nullable NSDictionary *)actionInformation additionalData:(nullable NSDictionary *)additionalData delegate:(nullable NSObject <MVMCoreLoadDelegateProtocol, MVMCorePresentationDelegateProtocol,MVMCoreActionDelegateProtocol>*)delegate __deprecated;
 

MVMCoreUI/OtherHandlers/MVMCoreUIActionHandler.m

@@ -31,6 +31,9 @@
     } else if ([actionType isEqualToString:KeyActionTypeAlert]) {
         [self showAlert:actionInformation additionalData:additionalData delegateObject:delegateObject];
         return YES;
+    } else if ([actionType isEqualToString:KeyActionTypeTopNotification]) {
+        [self topNotificationAction:actionInformation additionalData:additionalData delegateObject:delegateObject];
+        return YES;
     }
     return NO;
 }
@@ -102,6 +105,11 @@
     }
 }
 
+- (void)topNotificationAction:(nullable NSDictionary *)actionInformation additionalData:(nullable NSDictionary *)additionalData delegateObject:(nullable DelegateObject *)delegateObject {
+    //Handle molecular topnotification
+    [[MVMCoreUITopAlertView sharedGlobal] showTopAlertWith:[actionInformation dict:@"topNotification"] ?: @{}];
+}
+
 - (void)defaultHandleActionError:(nonnull MVMCoreErrorObject *)error additionalData:(nullable NSDictionary *)additionalData {
     [super defaultHandleActionError:error additionalData:additionalData];
     if (!error.silentError) {
@@ -126,6 +134,9 @@
     } else if ([actionType isEqualToString:KeyActionTypeCollapseNotification]) {
         [self collapseNotificationAction:actionInformation additionalData:additionalData delegate:delegate];
         return YES;
+    } else if ([actionType isEqualToString:KeyActionTypeTopNotification]) {
+        [self topNotificationAction:actionInformation additionalData:additionalData delegate:delegate];
+        return YES;
     }
     return NO;
 }
@@ -172,4 +183,9 @@
     }
 }
 
+- (void)topNotificationAction:(nullable NSDictionary *)actionInformation additionalData:(nullable NSDictionary *)additionalData delegate:(nullable NSObject <MVMCoreLoadDelegateProtocol, MVMCorePresentationDelegateProtocol,MVMCoreActionDelegateProtocol>*)delegate {
+    //Handle molecular topnotification
+    [[MVMCoreUITopAlertView sharedGlobal] showTopAlertWith:[actionInformation dict:@"topNotification"] ?: @{}];
+}
+
 @end

MVMCoreUI/TopAlert/MVMCoreUITopAlertBaseView.m

@@ -77,6 +77,8 @@
             [[MVMCoreUISession sharedGlobal].topAlertView hideAlertView:YES completionHandler:nil];
         }
     } centeredVertically:YES];
+    [closeButton.heightAnchor constraintEqualToConstant:16.0].active = YES;
+    [closeButton.widthAnchor constraintEqualToConstant:16.0].active = YES;
     [MVMCoreUITopAlertBaseView amendAccesibilityLabelForView:closeButton];
     return closeButton;
 }

MVMCoreUI/TopAlert/MVMCoreUITopAlertView+Extension.swift

@@ -61,6 +61,12 @@ public extension MVMCoreUITopAlertView {
         MVMCoreAlertHandler.shared()?.add(operation)
     }
     
+    /// Shows the top alert with the json.
+    @objc func showTopAlert(with json: [AnyHashable: Any]) {
+        guard let model = decodeTopNotification(with: json, delegateObject: getDelegateObject()) else { return }
+        showTopAlert(with: model)
+    }
+    
     /// Checks for existing top alert object of same type and updates it. Only happens for molecular top alerts. Returns true if we updated.
     private func checkAndUpdateExisting(with topAlertObject: MVMCoreTopAlertObject) -> Bool {
         guard let queue = MVMCoreAlertHandler.shared()?.topAlertQueue.operations else { return false }

MVMCoreUI/Utility/MVMCoreUIConstants.h

@@ -48,6 +48,7 @@ extern NSString * const KeyActionTypePopup;
 extern NSString * const KeyActionTypeAlert;
 extern NSString * const KeyActionTypeTopAlert;
 extern NSString * const KeyActionTypeCollapseNotification;
+extern NSString * const KeyActionTypeTopNotification;
 
 /// Key for molecular top notification architecture.
 extern NSString * const KeyTopAlert;

MVMCoreUI/Utility/MVMCoreUIConstants.m

@@ -47,6 +47,7 @@ NSString * const KeyActionTypeAlert = @"alert";
 NSString * const KeyActionTypeTopAlert = @"topAlert";
 NSString * const KeyActionTypeCollapseNotification = @"collapseNotification";
 
+NSString * const KeyActionTypeTopNotification = @"topNotification";
 NSString * const KeyTopAlert = @"TopNotification";
 
 #pragma mark - Values