doc: Comments Val extensions

Author: NeedleInAJayStack

Sources/Haystack/Coord.swift

@@ -26,6 +26,7 @@ public struct Coord: Val {
     }
 }
 
+// Coord + Codable
 extension Coord: Codable {
     static let kindValue = "coord"
 

Sources/Haystack/Date.swift

@@ -61,13 +61,7 @@ public struct Date: Val {
     }
 }
 
-/// Singleton Haystack Date formatter
-var dateFormatter: ISO8601DateFormatter {
-    let formatter = ISO8601DateFormatter()
-    formatter.formatOptions = [.withFullDate, .withColonSeparatorInTime]
-    return formatter
-}
-
+// Date + Codable
 extension Date {
     static let kindValue = "date"
 

Sources/Haystack/DateTime.swift

@@ -193,6 +193,7 @@ public struct DateTime: Val {
 
 var calendar = Calendar(identifier: .gregorian)
 
+// DateTime + Codable
 extension DateTime {
     static let kindValue = "dateTime"
 

Sources/Haystack/Dict.swift

@@ -40,6 +40,7 @@ public struct Dict: Val {
     }
 }
 
+// Dict + Codable
 extension Dict {
     static let kindValue = "dateTime"
 
@@ -156,8 +157,8 @@ extension Dict {
     }
 }
 
-// Dict + ExpressibleByDictionaryLiteral
 extension Dict: ExpressibleByDictionaryLiteral {
+    /// Creates an instance initialized with the given key-value pairs.
     public init(dictionaryLiteral elementLiterals: (String, any Val)...) {
         var elements = [String: any Val](minimumCapacity: elementLiterals.count)
         for (key, value) in elementLiterals {

Sources/Haystack/Grid.swift

@@ -51,6 +51,7 @@ public struct Grid: Val {
     }
 }
 
+// Grid + Codable
 extension Grid {
     static let kindValue = "grid"
 
@@ -100,7 +101,7 @@ extension Grid {
     }
 }
 
-// Dict + Equatable
+// Grid + Equatable
 extension Grid {
     public static func == (lhs: Grid, rhs: Grid) -> Bool {
         guard lhs.meta == rhs.meta else {
@@ -132,7 +133,7 @@ extension Grid {
     }
 }
 
-// Dict + Hashable
+// Grid + Hashable
 extension Grid {
     public func hash(into hasher: inout Hasher) {
         hasher.combine(meta)

Sources/Haystack/List.swift

@@ -21,6 +21,7 @@ public struct List: Val {
     }
 }
 
+// List + Codable
 extension List {
 
     /// Read from decodable data
@@ -84,8 +85,8 @@ extension List {
     }
 }
 
-// List + ExpressibleByDictionaryLiteral
 extension List: ExpressibleByArrayLiteral {
+    /// Creates an instance initialized with the given elements.
     public init(arrayLiteral: any Val...) {
         self.elements = arrayLiteral
     }

Sources/Haystack/Marker.swift

@@ -22,6 +22,7 @@ public struct Marker: Val {
     }
 }
 
+// Marker + Codable
 extension Marker {
     static let kindValue = "marker"
 

Sources/Haystack/NA.swift

@@ -22,6 +22,7 @@ public struct NA: Val {
     }
 }
 
+// NA + Codable
 extension NA {
     static let kindValue = "na"
 

Sources/Haystack/Null.swift

@@ -20,6 +20,7 @@ public struct Null: Val {
     }
 }
 
+// Null + Codable
 extension Null {
 
     /// Read from decodable data

Sources/Haystack/Number.swift

@@ -53,6 +53,7 @@ public struct Number: Val {
     }
 }
 
+// Number + Codable
 extension Number {
     static let kindValue = "number"
 
@@ -146,7 +147,7 @@ extension Number {
     }
 }
 
-// List + Equatable
+// Number + Equatable
 extension Number {
     public static func == (lhs: Number, rhs: Number) -> Bool {
         guard lhs.unit == rhs.unit else {