more comments

Signed-off-by: Matt Bruce <matt.bruce@verizon.com>

VDS/Classes/Control.swift

@@ -95,7 +95,6 @@ open class Control: UIControl, ViewProtocol, UserInfoable, Clickable {
     // MARK: - Lifecycle
     //--------------------------------------------------
     
-    /// Executed on initialization for this Control.
     open func initialSetup() {
         if !initialSetupPerformed {
             initialSetupPerformed = true

VDS/Classes/SelectorBase.swift

@@ -81,6 +81,7 @@ open class SelectorBase: Control, SelectorControlable {
     /// The natural size for the receiving view, considering only properties of the view itself.
     open override var intrinsicContentSize: CGSize { size }
 
+    /// Executed on initialization for this View.
     open override func initialSetup() {
         super.initialSetup()
         onClick = { control in

VDS/Classes/SelectorItemBase.swift

@@ -158,6 +158,7 @@ open class SelectorItemBase<Selector: SelectorControlable>: Control, Errorable,
     //--------------------------------------------------
     // MARK: - Lifecycle
     //--------------------------------------------------
+    /// Executed on initialization for this View.
     open override func initialSetup() {
         super.initialSetup()
         onClick = { control in

VDS/Classes/View.swift

@@ -53,8 +53,6 @@ open class View: UIView, ViewProtocol, UserInfoable {
     //--------------------------------------------------
     // MARK: - Lifecycle
     //--------------------------------------------------
-    
-    /// Executed on initialization for this View.
     open func initialSetup() {
         if !initialSetupPerformed {
             initialSetupPerformed = true

VDS/Components/Badge/Badge.swift

@@ -109,7 +109,7 @@ open class Badge: View {
     //--------------------------------------------------
     // MARK: - Lifecycle
     //--------------------------------------------------
-    
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         

VDS/Components/BadgeIndicator/BadgeIndicator.swift

@@ -250,7 +250,7 @@ open class BadgeIndicator: View {
     //--------------------------------------------------
     // MARK: - Lifecycle
     //--------------------------------------------------
-
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
 
@@ -286,26 +286,7 @@ open class BadgeIndicator: View {
         shouldUpdateView = true
         setNeedsUpdate()
     }
-            
+                
-    public func updateTextColorConfig() {
-        textColorConfiguration.reset()
-        
-        switch fillColor {
-            
-        case .red, .black, .gray, .grayLowContrast:
-            textColorConfiguration.setSurfaceColors(VDSColor.elementsPrimaryOndark, VDSColor.elementsPrimaryOndark, forDisabled: false)
-            textColorConfiguration.setSurfaceColors(VDSColor.elementsPrimaryOndark, VDSColor.elementsPrimaryOndark, forDisabled: true)
-            
-        case .yellow, .white:
-            textColorConfiguration.setSurfaceColors(VDSColor.elementsPrimaryOnlight, VDSColor.elementsPrimaryOnlight, forDisabled: false)
-            textColorConfiguration.setSurfaceColors(VDSColor.elementsPrimaryOnlight, VDSColor.elementsPrimaryOnlight, forDisabled: true)
-            
-        case .orange, .green, .blue:
-            textColorConfiguration.setSurfaceColors(VDSColor.elementsPrimaryOndark, VDSColor.elementsPrimaryOnlight, forDisabled: false)
-            textColorConfiguration.setSurfaceColors(VDSColor.elementsPrimaryOndark, VDSColor.elementsPrimaryOnlight, forDisabled: true)
-        }
-    }
-    
     /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
@@ -347,6 +328,25 @@ open class BadgeIndicator: View {
         layoutIfNeeded()
     }
     
+    private func updateTextColorConfig() {
+        textColorConfiguration.reset()
+        
+        switch fillColor {
+            
+        case .red, .black, .gray, .grayLowContrast:
+            textColorConfiguration.setSurfaceColors(VDSColor.elementsPrimaryOndark, VDSColor.elementsPrimaryOndark, forDisabled: false)
+            textColorConfiguration.setSurfaceColors(VDSColor.elementsPrimaryOndark, VDSColor.elementsPrimaryOndark, forDisabled: true)
+            
+        case .yellow, .white:
+            textColorConfiguration.setSurfaceColors(VDSColor.elementsPrimaryOnlight, VDSColor.elementsPrimaryOnlight, forDisabled: false)
+            textColorConfiguration.setSurfaceColors(VDSColor.elementsPrimaryOnlight, VDSColor.elementsPrimaryOnlight, forDisabled: true)
+            
+        case .orange, .green, .blue:
+            textColorConfiguration.setSurfaceColors(VDSColor.elementsPrimaryOndark, VDSColor.elementsPrimaryOnlight, forDisabled: false)
+            textColorConfiguration.setSurfaceColors(VDSColor.elementsPrimaryOndark, VDSColor.elementsPrimaryOnlight, forDisabled: true)
+        }
+    }
+
     private func getText() -> String {
         let badgeCount = number ?? 0
         var text: String = ""

VDS/Components/Buttons/Button/Button.swift

@@ -124,7 +124,7 @@ open class Button: ButtonBase, Useable {
     //--------------------------------------------------
     // MARK: - Public Methods
     //--------------------------------------------------
-    
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         isAccessibilityElement = true

VDS/Components/Buttons/Button/ButtonBase.swift

@@ -139,7 +139,6 @@ open class ButtonBase: UIButton, Buttonable, ViewProtocol, UserInfoable, Clickab
 
     }
 
-    /// Resets to default settings.
     open func reset() {
         shouldUpdateView = false
         surface = .light

VDS/Components/Buttons/ButtonGroup/ButtonGroup.swift

@@ -127,7 +127,7 @@ open class ButtonGroup: View, UICollectionViewDataSource, UICollectionViewDelega
     //--------------------------------------------------
     // MARK: - Public Methods
     //--------------------------------------------------
-
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         addSubview(collectionView)

VDS/Components/Buttons/TextLink/TextLink.swift

@@ -72,6 +72,7 @@ open class TextLink: ButtonBase {
     //--------------------------------------------------
     // MARK: - Public Methods
     //--------------------------------------------------
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         isAccessibilityElement = true

VDS/Components/Buttons/TextLinkCaret/TextLinkCaret.swift

@@ -75,6 +75,7 @@ open class TextLinkCaret: ButtonBase {
     //--------------------------------------------------
     // MARK: - Public Methods
     //--------------------------------------------------
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         accessibilityTraits = .link

VDS/Components/Checkbox/Checkbox.swift

@@ -16,6 +16,7 @@ open class Checkbox: SelectorBase {
 
     open var isAnimated: Bool = false { didSet { setNeedsUpdate() }}
 
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         accessibilityLabel = "Checkbox"

VDS/Components/Checkbox/CheckboxGroup.swift

@@ -92,6 +92,7 @@ open class CheckboxGroup: SelectorGroupHandlerBase<CheckboxItem> {
     //--------------------------------------------------
     // MARK: - Overrides
     //--------------------------------------------------
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         

VDS/Components/Icon/ButtonIcon/ButtonIcon.swift

@@ -224,6 +224,7 @@ open class ButtonIcon: Control {
     //--------------------------------------------------
     // MARK: - Lifecycle
     //--------------------------------------------------
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         

VDS/Components/Icon/Icon.swift

@@ -47,6 +47,7 @@ open class Icon: View {
     // MARK: - Overrides
     //--------------------------------------------------
   
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
 

VDS/Components/Label/Label.swift

@@ -111,7 +111,6 @@ open class Label: UILabel, ViewProtocol, UserInfoable {
    
     open func setup() {}
     
-    /// Resets to default settings.
     open func reset() {
         shouldUpdateView = false
         surface = .light

VDS/Components/Line/Line.swift

@@ -59,6 +59,7 @@ open class Line: View {
         orientation = .horizontal
     }
     
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
     }

VDS/Components/Loader/Loader.swift

@@ -40,6 +40,7 @@ open class Loader: View {
     //--------------------------------------------------
     // MARK: - Lifecycle
     //--------------------------------------------------
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         addSubview(icon)        

VDS/Components/Notification/Notification.swift

@@ -206,6 +206,7 @@ open class Notification: View {
     // MARK: - Lifecycle
     //--------------------------------------------------
     
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         addSubview(mainStackView)

VDS/Components/RadioBox/RadioBoxGroup.swift

@@ -82,6 +82,7 @@ open class RadioBoxGroup: SelectorGroupSelectedHandlerBase<RadioBoxItem> {
         }
     }
     
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         addSubview(mainStackView)

VDS/Components/RadioBox/RadioBoxItem.swift

@@ -156,6 +156,7 @@ open class RadioBoxItem: Control, Changeable {
     //--------------------------------------------------
     // MARK: - Lifecycle
     //--------------------------------------------------
+    /// Executed on initialization for this View.
     open override func initialSetup() {
         super.initialSetup()
         onClick = { control in
@@ -163,6 +164,7 @@ open class RadioBoxItem: Control, Changeable {
         }
     }
 
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
 
@@ -271,6 +273,7 @@ open class RadioBoxItem: Control, Changeable {
         layoutIfNeeded()
     }
 
+    /// Used to update any Accessibility properties.
     open override func updateAccessibility() {
         super.updateAccessibility()
         if accessibilityLabel == nil {

VDS/Components/RadioButton/RadioButton.swift

@@ -16,6 +16,7 @@ open class RadioButton: SelectorBase {
     
     open var selectedSize = CGSize(width: 10, height: 10) { didSet { setNeedsUpdate() }}
     
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         

VDS/Components/RadioButton/RadioButtonGroup.swift

@@ -86,6 +86,7 @@ open class RadioButtonGroup: SelectorGroupSelectedHandlerBase<RadioButtonItem> {
     //--------------------------------------------------
     // MARK: - Overrides
     //--------------------------------------------------
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         

VDS/Components/RadioSwatch/RadioSwatch.swift

@@ -74,6 +74,7 @@ open class RadioSwatch: Control {
     //--------------------------------------------------
     // MARK: - Lifecycle
     //--------------------------------------------------
+    /// Executed on initialization for this View.
     open override func initialSetup() {
         super.initialSetup()
         onClick =  { control in
@@ -81,6 +82,7 @@ open class RadioSwatch: Control {
         }
     }
 
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         

VDS/Components/RadioSwatch/RadioSwatchGroup.swift

@@ -90,6 +90,7 @@ open class RadioSwatchGroup: SelectorGroupSelectedHandlerBase<RadioSwatch>, UICo
         }
     }
         
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
 

VDS/Components/Tabs/Tab.swift

@@ -122,7 +122,8 @@ extension Tabs {
         // MARK: - Overrides
         //--------------------------------------------------
 
-        open override func setup() {
+        /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
+    open override func setup() {
             super.setup()
             
             canHighlight = false
@@ -171,6 +172,7 @@ extension Tabs {
             
         }
         
+        /// Used to update any Accessibility properties.
         open override func updateAccessibility() {
             super.updateAccessibility()
             accessibilityLabel = text

VDS/Components/Tabs/Tabs.swift

@@ -166,6 +166,7 @@ open class Tabs: View {
     //--------------------------------------------------
     // MARK: - Overrides
     //--------------------------------------------------
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         scrollView = UIScrollView()

VDS/Components/Tabs/TabsContainer.swift

@@ -123,6 +123,7 @@ open class TabsContainer: View {
 
     private var tabMenuLayoutGuide = UILayoutGuide()
 
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         

VDS/Components/TextFields/EntryField/EntryField.swift

@@ -179,6 +179,7 @@ open class EntryField: Control, Changeable {
     //--------------------------------------------------
     // MARK: - Lifecycle
     //--------------------------------------------------
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
                 

VDS/Components/TextFields/InputField/InputField.swift

@@ -114,6 +114,7 @@ open class InputField: EntryField, UITextFieldDelegate {
     //--------------------------------------------------
     // MARK: - Overrides
     //--------------------------------------------------
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         

VDS/Components/TextFields/TextArea/TextArea.swift

@@ -64,6 +64,7 @@ open class TextArea: EntryField {
     //--------------------------------------------------
     // MARK: - Lifecycle
     //--------------------------------------------------
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         

VDS/Components/TileContainer/TileContainer.swift

@@ -149,6 +149,7 @@ open class TileContainer: Control {
     // MARK: - Lifecycle
     //--------------------------------------------------
     
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         addSubview(backgroundImageView)

VDS/Components/Tilelet/Tilelet.swift

@@ -199,6 +199,7 @@ open class Tilelet: TileContainer {
     // MARK: - Lifecycle
     //--------------------------------------------------
     
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         width = 100
@@ -376,6 +377,7 @@ open class Tilelet: TileContainer {
         layoutIfNeeded()
     }
     
+    /// Used to update any Accessibility properties.
     open override func updateAccessibility() {
         super.updateAccessibility()
         

VDS/Components/TitleLockup/TitleLockup.swift

@@ -254,6 +254,7 @@ open class TitleLockup: View {
     //--------------------------------------------------
     // MARK: - Lifecycle
     //--------------------------------------------------
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         

VDS/Components/Toggle/Toggle.swift

@@ -133,6 +133,7 @@ open class Toggle: Control, Changeable {
     //--------------------------------------------------
     // MARK: - Lifecycle
     //--------------------------------------------------
+    /// Executed on initialization for this View.
     open override func initialSetup() {
         super.initialSetup()
         onClick = { control in
@@ -140,6 +141,7 @@ open class Toggle: Control, Changeable {
         }
     }
     
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         
@@ -205,6 +207,7 @@ open class Toggle: Control, Changeable {
         toggleView.isOn = isOn
     }
     
+    /// Used to update any Accessibility properties.
     open override func updateAccessibility() {
         super.updateAccessibility()
         

VDS/Components/Toggle/ToggleView.swift

@@ -105,6 +105,7 @@ open class ToggleView: Control, Changeable {
     //--------------------------------------------------
     // MARK: - Lifecycle
     //--------------------------------------------------
+    /// Executed on initialization for this View.
     open override func initialSetup() {
         super.initialSetup()
         onClick = { control in
@@ -112,6 +113,7 @@ open class ToggleView: Control, Changeable {
         }
     }
     
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
 
@@ -172,6 +174,7 @@ open class ToggleView: Control, Changeable {
         updateToggle()
     }
     
+    /// Used to update any Accessibility properties.
     open override func updateAccessibility() {
         super.updateAccessibility()
         

VDS/Components/Tooltip/Tooltip.swift

@@ -108,6 +108,7 @@ open class Tooltip: Control, TooltipLaunchable {
     // MARK: - Lifecycle
     //--------------------------------------------------
     
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         
@@ -154,6 +155,7 @@ open class Tooltip: Control, TooltipLaunchable {
         icon.color = iconColorConfiguration.getColor(self)
     }
     
+    /// Used to update any Accessibility properties.
     open override func updateAccessibility() {
         super.updateAccessibility()
         

VDS/Components/Tooltip/TooltipDialog.swift

@@ -77,6 +77,7 @@ open class TooltipDialog: View, UIScrollViewDelegate {
     //--------------------------------------------------
     // MARK: - Lifecycle
     //--------------------------------------------------
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         
@@ -212,6 +213,7 @@ open class TooltipDialog: View, UIScrollViewDelegate {
         $0.accessibilityFrameInContainerSpace = .init(origin: .zero, size: .init(width: fullWidth, height: VDSLayout.Spacing.space1X.value))
     }
         
+    /// Used to update any Accessibility properties.
     open override func updateAccessibility() {
         super.updateAccessibility()
         

VDS/Components/Tooltip/TrailingTooltipLabel.swift

@@ -45,6 +45,7 @@ open class TrailingTooltipLabel: View, TooltipLaunchable {
     //--------------------------------------------------
     // MARK: - Overrides
     //--------------------------------------------------
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         

VDS/Protocols/ViewProtocol.swift

@@ -16,6 +16,9 @@ public protocol ViewProtocol: AnyObject, Initable, Resettable, Enabling, Surface
     /// Key of whether or not updateView() is called in setNeedsUpdate()
     var shouldUpdateView: Bool { get set }
 
+    /// Executed on initialization for this View.
+    func initialSetup()
+    
     /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     func setup()