[docs] Update docs for 1.2

Author: kirb

Alderis/ColorPickerConfiguration.swift

@@ -9,7 +9,7 @@
 import UIKit
 
 /// An enumeration of the tabs `ColorPickerViewController` features. Use these enumeration values to
-/// set tab-related settings on ColorPickerConfiguration.
+/// set tab-related settings on `ColorPickerConfiguration`.
 @objc(HBColorPickerTab)
 public enum ColorPickerTab: Int, CaseIterable {
 	/// Tab 1: A grid of 9 variations of 11 colours, and a grayscale ramp. The first and default tab.
@@ -44,13 +44,13 @@ open class ColorPickerConfiguration: NSObject {
 	@objc open var color: UIColor
 
 	/// Whether to allow the user to set an alpha transparency value on the color. This controls the
-	/// visibility of an Alpha slider on the Sliders tab. When set to false, alpha values provided via
-	/// the `color` property, or by the user when entering a hexadecimal value on the Sliders tab,
+	/// visibility of an Alpha slider on the Sliders tab. When set to `false`, alpha values provided
+	/// via the `color` property, or by the user when entering a hexadecimal value on the Sliders tab,
 	/// will be discarded.
 	@objc open var supportsAlpha = true
 
-	/// The title to display at the top of the popup. If set to nil, no title will be displayed. The
-	/// default is nil.
+	/// The title to display at the top of the popup. If set to `nil`, no title will be displayed. The
+	/// default is `nil`.
 	@objc open var title: String?
 
 	/// The initial tab to select when the color picker is presented. The default is
@@ -62,21 +62,21 @@ open class ColorPickerConfiguration: NSObject {
 	@objc open var initialTab = ColorPickerTab.swatch
 
 	/// The tabs the user can select and switch between at the top of the window, if tabs are enabled
-	/// by showTabs.
+	/// by `showTabs`.
 	///
 	/// - see: `initialTab`
 	@nonobjc open var visibleTabs: [ColorPickerTab] = [.swatch, .map, .sliders, .accessibility]
 
-	/// Maps visibleTabs to Objective-C due to Swift limitations. This is an implementation detail.
-	/// Ignore this and use visibleTabs per usual.
+	/// Maps `visibleTabs` to Objective-C due to Swift limitations. This is an implementation detail.
+	/// Ignore this and use `visibleTabs` per usual.
 	@objc(visibleTabs)
 	open var _visibleTabsObjC: [ColorPickerTab.RawValue] {
 		get { visibleTabs.map(\.rawValue) }
 		set { visibleTabs = newValue.map { ColorPickerTab(rawValue: $0)! } }
 	}
 
-	/// Whether to display the tab selection at the top of the popup. The default is true. When set to
-	/// false, the user will only be able to access the tab specified in initialTab.
+	/// Whether to display the tab selection at the top of the popup. The default is `true`. When set
+	/// to `false`, the user will only be able to access the tab specified in initialTab.
 	@objc open var showTabs = true
 
 	/// When the Smart Invert accessibility feature is enabled, Alderis instructs the system to not
@@ -85,7 +85,7 @@ open class ColorPickerConfiguration: NSObject {
 	@objc open var overrideSmartInvert = true
 
 	/// Whether the user can end a drag interaction by dropping on the color picker window, allowing
-	/// them to drag a color from a supporting app. The default is true.
+	/// them to drag a color from a supporting app. The default is `true`.
 	@objc open var isDropInteractionEnabled = true
 
 }

Alderis/ColorPickerDelegate.swift

@@ -8,7 +8,7 @@
 
 import UIKit
 
-/// Use ColorPickerDelegate to handle the user’s response to `ColorPickerViewController`.
+/// Use `ColorPickerDelegate` to handle the user’s response to `ColorPickerViewController`.
 @objc(HBColorPickerDelegate)
 public protocol ColorPickerDelegate: NSObjectProtocol {
 

Alderis/ColorPickerInnerViewController.swift

@@ -414,14 +414,17 @@ extension ColorPickerInnerViewController: ColorPickerTabDelegate {
 
 extension ColorPickerInnerViewController: UIDropInteractionDelegate {
 
+	/// :nodoc:
 	public func dropInteraction(_ interaction: UIDropInteraction, canHandle session: UIDropSession) -> Bool {
 		return session.items.count == 1 && session.canLoadObjects(ofClass: UIColor.self)
 	}
 
+	/// :nodoc:
 	public func dropInteraction(_ interaction: UIDropInteraction, sessionDidUpdate session: UIDropSession) -> UIDropProposal {
 		return UIDropProposal(operation: .copy)
 	}
 
+	/// :nodoc:
 	public func dropInteraction(_ interaction: UIDropInteraction, performDrop session: UIDropSession) {
 		session.loadObjects(ofClass: UIColor.self) { items in
 			if let color = items.first as? UIColor {
@@ -434,6 +437,7 @@ extension ColorPickerInnerViewController: UIDropInteractionDelegate {
 
 extension ColorPickerInnerViewController: UIPopoverPresentationControllerDelegate {
 
+	/// :nodoc:
 	public func presentationControllerWillDismiss(_ presentationController: UIPresentationController) {
 		saveTapped()
 	}

Alderis/ColorPickerViewController.swift

@@ -16,14 +16,14 @@ import UIKit
 /// `sourceView` or other similar properties on the view controller’s `popoverPresentationController`
 /// before presentation.
 ///
-/// To review examples of ColorPickerViewController in use, run `pod try Alderis`.
+/// To review examples of `ColorPickerViewController` in use, run `pod try Alderis`.
 @objc(HBColorPickerViewController)
 open class ColorPickerViewController: UIViewController {
 
 	/// Do not rely on this fallback value - always specify a color!
 	private static let defaultColor = UIColor(white: 0.6, alpha: 1)
 
-	/// Initialise an instance of ColorPickerViewController with a configuration object.
+	/// Initialise an instance of `ColorPickerViewController` with a configuration object.
 	///
 	/// Remember to set the `delegate` before presenting the view controller.
 	@objc public init(configuration: ColorPickerConfiguration) {
@@ -47,13 +47,13 @@ open class ColorPickerViewController: UIViewController {
 	/// - see: `ColorPickerConfiguration`
 	@objc open var configuration: ColorPickerConfiguration!
 
-	/// Deprecated. Set overrideSmartInvert on the `ColorPickerConfiguration` instead.
+	/// Deprecated. Set `ColorPickerConfiguration.overrideSmartInvert` instead.
 	///
 	/// - see: `ColorPickerConfiguration.overrideSmartInvert`
 	@available(*, deprecated, message: "Use ColorPickerConfiguration instead")
 	@objc open var overrideSmartInvert = true
 
-	/// Deprecated. Set color on the `ColorPickerConfiguration` instead.
+	/// Deprecated. Set `ColorPickerConfiguration.color` instead.
 	///
 	/// - see: `ColorPickerConfiguration.color`
 	@available(*, deprecated, message: "Use ColorPickerConfiguration instead")

Alderis/ColorWell.swift

@@ -33,7 +33,7 @@ open class ColorWell: UIControl {
 	}
 
 	/// Whether the user can begin a drag interaction from this view, allowing them to drop the color
-	/// into a supporting app. The default is false.
+	/// into a supporting app. The default is `false`.
 	@objc open var isDragInteractionEnabled = false {
 		didSet { updateDragDropInteraction() }
 	}
@@ -51,6 +51,7 @@ open class ColorWell: UIControl {
 		didSet { updateDragDropInteraction() }
 	}
 
+	#if swift(>=5.3)
 	/// Whether the user can long press (iPhone) or right-click (Mac/iPad) the view, allowing them to
 	/// copy the color in various formats, or paste a color from another source.
 	///
@@ -62,7 +63,6 @@ open class ColorWell: UIControl {
 	/// ```
 	///
 	/// Requires iOS 14 or newer.
-	#if swift(>=5.3)
 	@available(iOS 14, *)
 	open override var isContextMenuInteractionEnabled: Bool {
 		didSet { updateDragDropInteraction() }
@@ -337,6 +337,7 @@ extension ColorWell: UIDropInteractionDelegate {
 @available(iOS 15, *)
 extension ColorWell: UIToolTipInteractionDelegate {
 
+	/// :nodoc:
 	public func toolTipInteraction(_ interaction: UIToolTipInteraction, configurationAt point: CGPoint) -> UIToolTipConfiguration? {
 		UIToolTipConfiguration(toolTip: contextMenuTitle)
 	}
@@ -349,6 +350,7 @@ extension ColorWell: UIToolTipInteractionDelegate {
 @available(iOS 13, *)
 extension ColorWell { // UIContextMenuInteractionDelegate
 
+	/// :nodoc:
 	open override func contextMenuInteraction(_ interaction: UIContextMenuInteraction, configurationForMenuAtLocation location: CGPoint) -> UIContextMenuConfiguration? {
 		return UIContextMenuConfiguration(identifier: color, previewProvider: nil) { items in
 			var children = [UIMenuElement]()
@@ -398,5 +400,4 @@ extension ColorWell { // UIContextMenuInteractionDelegate
 /// Deprecated. Use `ColorWell` instead.
 @available(*, deprecated, renamed: "ColorWell")
 @objc(HBColorPickerCircleView)
-open class ColorPickerCircleView: ColorWell {
-}
+open class ColorPickerCircleView: ColorWell {}

docs/Classes/ColorPickerConfiguration.html

@@ -17,20 +17,20 @@
     <a title="ColorPickerConfiguration Class Reference"></a>
     <header>
       <div class="content-wrapper">
-        <p><a href="../index.html">Alderis 1.1.2 Docs</a></p>
-        <p class="header-right"><a href="https://github.com/hbang/Alderis"><img src="../img/gh.png"/>View on GitHub</a></p>
-        <p class="header-right"><a href="dash-feed://https%3A%2F%2Fhbang.github.io%2FAlderis%2Fdocsets%2FAlderis.xml"><img src="../img/dash.png"/>Install in Dash</a></p>
-        <p class="header-right">
+        <p><a href="../index.html">Alderis 1.2 Docs</a></p>
+        <p class="header-right"><a href="https://github.com/hbang/Alderis"><img src="../img/gh.png" alt="GitHub"/>View on GitHub</a></p>
+        <p class="header-right"><a href="dash-feed://https%3A%2F%2Fhbang.github.io%2FAlderis%2Fdocsets%2FAlderis.xml"><img src="../img/dash.png" alt="Dash"/>Install in Dash</a></p>
+        <div class="header-right">
           <form role="search" action="../search.json">
             <input type="text" placeholder="Search documentation" data-typeahead>
           </form>
-        </p>
+        </div>
       </div>
     </header>
     <div class="content-wrapper">
       <p id="breadcrumbs">
         <a href="../index.html">Alderis Reference</a>
-        <img id="carat" src="../img/carat.png" />
+        <img id="carat" src="../img/carat.png" alt=""/>
         ColorPickerConfiguration Class Reference
       </p>
     </div>
@@ -107,7 +107,7 @@ <h1>ColorPickerConfiguration</h1>
               <div class="declaration">
                 <div class="language">
 
-                  <pre class="highlight swift"><code><span class="kd">@objc(HBColorPickerConfiguration)</span>
+                  <pre class="highlight swift"><code><span class="kd">@objc</span><span class="p">(</span><span class="kt">HBColorPickerConfiguration</span><span class="p">)</span>
 <span class="kd">open</span> <span class="kd">class</span> <span class="kt">ColorPickerConfiguration</span> <span class="p">:</span> <span class="kt">NSObject</span></code></pre>
 
                 </div>
@@ -189,8 +189,8 @@ <h4>Declaration</h4>
                       <div class="pointer"></div>
                       <div class="abstract">
                         <p>Whether to allow the user to set an alpha transparency value on the color. This controls the
-visibility of an Alpha slider on the Sliders tab. When set to false, alpha values provided via
-the <code><a href="../Classes/ColorPickerConfiguration.html#/c:@M@Alderis@objc(cs)HBColorPickerConfiguration(py)color">color</a></code> property, or by the user when entering a hexadecimal value on the Sliders tab,
+visibility of an Alpha slider on the Sliders tab. When set to <code>false</code>, alpha values provided
+via the <code><a href="../Classes/ColorPickerConfiguration.html#/c:@M@Alderis@objc(cs)HBColorPickerConfiguration(py)color">color</a></code> property, or by the user when entering a hexadecimal value on the Sliders tab,
 will be discarded.</p>
 
                       </div>
@@ -219,8 +219,8 @@ <h4>Declaration</h4>
                     <section class="section">
                       <div class="pointer"></div>
                       <div class="abstract">
-                        <p>The title to display at the top of the popup. If set to nil, no title will be displayed. The
-default is nil.</p>
+                        <p>The title to display at the top of the popup. If set to <code>nil</code>, no title will be displayed. The
+default is <code>nil</code>.</p>
 
                       </div>
                       <div class="declaration">
@@ -285,7 +285,7 @@ <h4>Declaration</h4>
                       <div class="pointer"></div>
                       <div class="abstract">
                         <p>The tabs the user can select and switch between at the top of the window, if tabs are enabled
-by showTabs.</p>
+by <code><a href="../Classes/ColorPickerConfiguration.html#/c:@M@Alderis@objc(cs)HBColorPickerConfiguration(py)showTabs">showTabs</a></code>.</p>
 <div class="aside aside-see">
     <p class="aside-title">See</p>
     <code><a href="../Classes/ColorPickerConfiguration.html#/c:@M@Alderis@objc(cs)HBColorPickerConfiguration(py)initialTab">initialTab</a></code>
@@ -318,15 +318,15 @@ <h4>Declaration</h4>
                     <section class="section">
                       <div class="pointer"></div>
                       <div class="abstract">
-                        <p>Maps visibleTabs to Objective-C due to Swift limitations. This is an implementation detail.
-Ignore this and use visibleTabs per usual.</p>
+                        <p>Maps <code><a href="../Classes/ColorPickerConfiguration.html#/s:7Alderis24ColorPickerConfigurationC11visibleTabsSayAA0bC3TabOGvp">visibleTabs</a></code> to Objective-C due to Swift limitations. This is an implementation detail.
+Ignore this and use <code><a href="../Classes/ColorPickerConfiguration.html#/s:7Alderis24ColorPickerConfigurationC11visibleTabsSayAA0bC3TabOGvp">visibleTabs</a></code> per usual.</p>
 
                       </div>
                       <div class="declaration">
                         <h4>Declaration</h4>
                         <div class="language">
                           <p class="aside-title">Swift</p>
-                          <pre class="highlight swift"><code><span class="kd">@objc(visibleTabs)</span>
+                          <pre class="highlight swift"><code><span class="kd">@objc</span><span class="p">(</span><span class="n"><a href="../Classes/ColorPickerConfiguration.html#/s:7Alderis24ColorPickerConfigurationC11visibleTabsSayAA0bC3TabOGvp">visibleTabs</a></span><span class="p">)</span>
 <span class="kd">open</span> <span class="k">var</span> <span class="nv">_visibleTabsObjC</span><span class="p">:</span> <span class="p">[</span><span class="kt"><a href="../Enums/ColorPickerTab.html">ColorPickerTab</a></span><span class="o">.</span><span class="kt">RawValue</span><span class="p">]</span> <span class="p">{</span> <span class="k">get</span> <span class="k">set</span> <span class="p">}</span></code></pre>
 
                         </div>
@@ -347,8 +347,8 @@ <h4>Declaration</h4>
                     <section class="section">
                       <div class="pointer"></div>
                       <div class="abstract">
-                        <p>Whether to display the tab selection at the top of the popup. The default is true. When set to
-false, the user will only be able to access the tab specified in initialTab.</p>
+                        <p>Whether to display the tab selection at the top of the popup. The default is <code>true</code>. When set
+to <code>false</code>, the user will only be able to access the tab specified in initialTab.</p>
 
                       </div>
                       <div class="declaration">
@@ -407,7 +407,7 @@ <h4>Declaration</h4>
                       <div class="pointer"></div>
                       <div class="abstract">
                         <p>Whether the user can end a drag interaction by dropping on the color picker window, allowing
-them to drag a color from a supporting app. The default is true.</p>
+them to drag a color from a supporting app. The default is <code>true</code>.</p>
 
                       </div>
                       <div class="declaration">
@@ -427,11 +427,10 @@ <h4>Declaration</h4>
           </section>
         </section>
         <section id="footer">
-          <p>&copy; 2021 <a class="link" href="https://hbang.github.io/" target="_blank" rel="external">HASHBANG Productions</a>. All rights reserved. (Last updated: 2021-03-10)</p>
-          <p>Generated by <a class="link" href="https://github.com/realm/jazzy" target="_blank" rel="external">jazzy ♪♫ v0.13.6</a>, a <a class="link" href="https://realm.io" target="_blank" rel="external">Realm</a> project.</p>
+          <p>&copy; 2022 <a class="link" href="https://hbang.github.io/" target="_blank" rel="external noopener">HASHBANG Productions</a>. All rights reserved. (Last updated: 2022-05-23)</p>
+          <p>Generated by <a class="link" href="https://github.com/realm/jazzy" target="_blank" rel="external noopener">jazzy ♪♫ v0.14.2</a>, a <a class="link" href="https://realm.io" target="_blank" rel="external noopener">Realm</a> project.</p>
         </section>
       </article>
     </div>
   </body>
-</div>
 </html>