Updated: Snapshot comment. Cleanup.

Author: oscbyspro

Sources/DiffableTextKit/Models/Snapshot.swift

@@ -20,12 +20,13 @@
 ///
 /// **Selection**
 ///
-/// Selection is done by differentiation, but it can also be done manually. It
-/// may be appropriate on snapshots containing only formatting characters. A pattern
-/// text style can manually select its first placeholder character, for example.
+/// Selection is done by differentiation, but it can also be done manually.
+/// Snapshots containing only passthrough characters should always provide
+/// a manual selection, however. A pattern text style may select its first
+/// placeholder, as illustrated:
 ///
 /// ```
-///    ↓ == selection
+///   ↓ == selection
 /// |+|#|#|_|(|#|#|#|)|_|#|#|#|-|#|#|-|#|#|~
 /// |x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|~
 /// ```

Sources/DiffableTextKit/Styles/Prefix.swift

@@ -49,7 +49,7 @@ public struct PrefixTextStyle<Base: DiffableTextStyle>: WrapperTextStyle {
     }
 
     //=------------------------------------------------------------------------=
-    // MARK: Utilities
+    // MARK: Helpers
     //=------------------------------------------------------------------------=
 
     @inlinable func label(_ text: inout String) {

Sources/DiffableTextKit/Styles/Suffix.swift

@@ -49,7 +49,7 @@ public struct SuffixTextStyle<Base: DiffableTextStyle>: WrapperTextStyle {
     }
 
     //=------------------------------------------------------------------------=
-    // MARK: Utilities
+    // MARK: Helpers
     //=------------------------------------------------------------------------=
 
     @inlinable func label(_ text: inout String) {

Sources/DiffableTextKitXPattern/Placeholders.swift

@@ -73,7 +73,7 @@ extension Placeholders {
 
         //=--------------------------------------------------------------------=
 
-        @usableFromInline let elements: (character: Character, predicate: Predicate)
+        @usableFromInline let elements: (Character, Predicate)
 
         //=--------------------------------------------------------------------=
 
@@ -82,11 +82,11 @@ extension Placeholders {
         }
 
         @inlinable subscript(character: Character) -> Predicate? {
-            elements.character == character ? elements.predicate : nil
+            elements.0 == character ? elements.1 : nil
         }
 
         @inlinable static func == (lhs: Self, rhs: Self) -> Bool {
-            lhs.elements.character == rhs.elements.character
+            lhs.elements.0 == rhs.elements.0
         }
     }
 

Sources/DiffableTextKitXPattern/Style.swift

@@ -109,7 +109,7 @@ extension PatternTextStyle {
 
     /// - Mismatches are removed.
     @inlinable public func interpret(_ value: Value, with cache: inout Void) -> Commit<Value> {
-        reduce(with: value, into:  Commit()) {
+        reduce(with: value, into: Commit()) {
             commit, virtuals, nonvirtual in
             commit.snapshot.append(contentsOf: virtuals, as: .phantom)
             commit.snapshot.append(nonvirtual)