Adjust indent

Author: danielsaidi

RELEASE_NOTES.md

@@ -10,13 +10,11 @@ Until then, minor updates may remove deprecated features and introduce breaking
 
 This version makes a first step towards removing library-specific types in favor of native types, to avoid having to add custom types and logic to the library, where native alternatives exist.
 
-This version deprecates the `RichTextAlignment` type and instead   
-
-This version adds key path-based paragraph functions to the `RichTextViewComponent`. This means that you can now get and set the following values with a single set of functions, pickers, steppers and toggles:
+This version starts with `NSParagraphStyle` and its nested types, and makes it possible to get, set, pick, step and toggle the following values with a single set of functions, pickers, steppers and toggles:
 
 `alignment`, `allowsDefaultTighteningForTruncation`, `baseWritingDirection`, `defaultTabInterval`, `firstLineHeadIndent`, `headIndent`, `hyphenationFactor`, `lineBreakMode`, `lineBreakStrategy`, `lineHeightMultiple`, `lineSpacing`, `maximumLineHeight`, `minimumLineHeight`, `paragraphSpacing`, `paragraphSpacingBefore`, `tabStops`, `tailIndent`, `usesDefaultHyphenation`.
 
-As a result, all parts of the library that handled individual value types have been deprecated. This makes the library tighter, and a lot more capable with less code. 
+As a result, this version deprecates the `RichTextAlignment` and `RichTextLine` type. This makes the library tighter, and a lot more capable with less code that does more.
 
 ### ✨ Features
 

Sources/RichTextKit/Colors/ColorRepresentable.swift

@@ -9,19 +9,13 @@
 #if macOS
 import AppKit
 
-/**
- This typealias bridges platform-specific colors to simplify
- multi-platform support.
- */
+/// This typealias bridges platform-specific colors.
 public typealias ColorRepresentable = NSColor
 #endif
 
 #if iOS || os(tvOS) || os(watchOS) || os(visionOS)
 import UIKit
 
-/**
- This typealias bridges platform-specific colors to simplify
- multi-platform support.
- */
+/// This typealias bridges platform-specific colors.
 public typealias ColorRepresentable = UIColor
 #endif

Sources/RichTextKit/Colors/RichTextColor+Picker.swift

@@ -10,26 +10,19 @@ import SwiftUI
 
 public extension RichTextColor {
 
-    /**
-     This picker can be used to select a rich text color.
-
-     This picker renders an icon next to the color picker as
-     well as an optional list of quick colors.
-
-     The quick color list is empty by default. You can add a
-     custom set of colors, for instance `.quickPickerColors`.
-     */
+    /// This picker can be used to select a rich text color.
+    ///
+    /// This picker renders an icon next to the color picker
+    /// as well as an optional list of custom quick colors.
     struct Picker: View {
 
-        /**
-         Create a rich text color picker that binds to a color.
-
-         - Parameters:
-          - type: The type of color to pick.
-          - icon: The icon to show, if any, by default the `type` icon.
-          - value: The value to bind to.
-          - quickColors: Colors to show in the trailing list, by default no colors.
-         */
+        /// Create a rich text color picker.
+        ///
+        /// - Parameters:
+        ///   - type: The type of color to pick.
+        ///   - icon: The icon to show, if any, by default the `type` icon.
+        ///   - value: The value to bind to.
+        ///   - quickColors: Colors to show in the trailing list, by default no colors.
         public init(
             type: RichTextColor,
             icon: Image? = nil,

Sources/RichTextKit/Colors/RichTextColor.swift

@@ -8,11 +8,7 @@
 
 import SwiftUI
 
-/**
- This enum defines supported rich text color types.
-
- The enum makes the colors identifiable and diffable.
- */
+/// This enum defines supported rich text color types.
 public enum RichTextColor: String, CaseIterable, Codable, Equatable, Identifiable {
 
     /// Foreground color.

Sources/RichTextKit/Commands/RichTextCommand+ActionButton.swift

@@ -10,21 +10,17 @@ import SwiftUI
 
 public extension RichTextCommand {
 
-    /**
-     This button can trigger any ``RichTextAction`` from the
-     main menu.
-
-     This view requires that a ``RichTextContext`` is set as
-     a focused value, otherwise it will be disabled.
-     */
+    /// This button can trigger ``RichTextAction``s from the
+    /// main menu.
+    ///
+    /// This view requires that a ``RichTextContext`` is set
+    /// as a focused value, otherwise it will be disabled.
     struct ActionButton: View {
 
-        /**
-         Create a command button.
-
-         - Parameters:
-         - action: The action to trigger.
-         */
+        /// Create a command button.
+        ///
+        /// - Parameters:
+        ///   - action: The action to trigger.
         public init(
             action: RichTextAction
         ) {

Sources/RichTextKit/Commands/RichTextCommand+ActionButtonGroup.swift

@@ -10,13 +10,11 @@ import SwiftUI
 
 public extension RichTextCommand {
 
-    /**
-     This view can add list of ``RichTextAction`` buttons to
-     the main menu.
-
-     This view requires that a ``RichTextContext`` is set as
-     a focused value, otherwise it will be disabled.
-     */
+    /// This view can add list of ``RichTextAction`` buttons
+    /// to the main menu.
+    ///
+    /// This view requires that a ``RichTextContext`` is set
+    /// as a focused value, otherwise it will be disabled. 
     struct ActionButtonGroup: View {
 
         /**

Sources/RichTextKit/Commands/RichTextCommand+FormatMenu.swift

@@ -11,16 +11,13 @@ import SwiftUI
 
 public extension RichTextCommand {
 
-    /**
-     This menu adds standard rich text format options to the
-     main menu, using `CommandGroup`.
-
-     You can apply this to a `WindowGroup` or `DocumentGroup`
-     to make it appear in the app's main menu.
-
-     This menu requires that a ``RichTextContext`` is set as
-     a focused value, otherwise it will be disabled.
-     */
+    /// This menu adds format options to the main menu.
+    ///
+    /// You can add it to a `WindowGroup` or `DocumentGroup`,
+    /// to make it appear in the app's main menu.
+    ///
+    /// This view requires that a ``RichTextContext`` is set
+    /// as a focused value, otherwise it will be disabled.
     struct FormatMenu: Commands {
 
         /// Create a rich text format command menu.

Sources/RichTextKit/Commands/RichTextCommand+ShareMenu.swift

@@ -11,32 +11,26 @@ import SwiftUI
 
 public extension RichTextCommand {
 
-    /**
-     This menu view can add a list of sharing options to the
-     main menu.
-
-     The menu will try to add options for share, export, and
-     print, if applicable to the current platform. Selecting
-     an option will trigger a corresponding, provided action.
-
-     The macOS exclusive `nsSharing` commands require you to
-     return a share url, after which a command takes care of
-     the sharing. Also note that the `formatNSSharingAction`
-     and `pdfNSSharingAction` will only have effect on macOS,
-     where they add ``RichTextNSSharingMenu`` options.
-
-     Note that a pdf action menu will only be included if it
-     has a corresponding action. Also note that you must use
-     `isEnabled: false` to disable the menu, since you can't
-     add `.disabled` to the command menu.
-
-     Setting actions to `nil` removes the related menu items.
-     */
+    /// This menu adds share options to the main menu.
+    ///
+    /// This menu will attempt to add menu options for share,
+    /// export, and print, if applicable to the platform.
+    ///
+    /// The macOS exclusive `nsSharing` commands require you
+    /// to return a share url, after which the command takes
+    /// care of the sharing. The `formatNSSharingAction` and
+    /// `pdfNSSharingAction` only works on macOS, where they
+    /// add ``RichTextNSSharingMenu`` options.
+    ///
+    /// Note that a pdf action menu will only be included if
+    /// it has an action. You must use `isEnabled: false` to
+    /// disable the menu, since you can't add `.disabled` to
+    /// the command menu.
+    ///
+    /// Setting an action to `nil` removes the related menu.
     struct ShareMenu: Commands {
 
-        /**
-         Create a rich text share command menu.
-         */
+        /// Create a rich text share command menu.
         public init(
             isEnabled: Bool = true,
             shareFormats: [RichTextDataFormat],

Sources/RichTextKit/Commands/RichTextCommand.swift

@@ -8,11 +8,9 @@
 
 import Foundation
 
-/**
- This type is used as a namespace for command-specific types,
- like command menus and buttons.
-
- > Important: Most rich text commands require that there's a
- ``RichTextContext`` set as a focused value.
- */
+/// This is a namespace for command-specific types like menu
+/// and buttons commands.
+///
+/// > Important: The rich text-related commands require that
+/// there's a ``RichTextContext`` set as a focused value.
 public struct RichTextCommand {}

Sources/RichTextKit/Data/NSAttributedString+Init.swift

@@ -10,13 +10,11 @@ import Foundation
 
 public extension NSAttributedString {
 
-    /**
-     Try to parse ``RichTextDataFormat`` formatted data.
-
-     - Parameters:
-       - data: The data to initialize the string with.
-       - format: The data format to use.
-     */
+    /// Try to parse ``RichTextDataFormat`` formatted data.
+    ///
+    /// - Parameters:
+    ///   - data: The data to initialize the string with.
+    ///   - format: The data format to use.
     convenience init(
         data: Data,
         format: RichTextDataFormat