Update code formatting and implementation

Author: coenttb

.gitignore

@@ -1,32 +1,23 @@
-# Swift Package Manager
-.build/
-.swiftpm/
-Package.resolved
+*~
 
-# Xcode
-*.xcodeproj/
-*.xcworkspace/
-xcuserdata/
+Package.resolved
 DerivedData/
-*.hmap
-*.ipa
-*.dSYM.zip
-*.dSYM
-
-# macOS
-.DS_Store
-
-# AI tools
-CLAUDE.md
-.claude
-.cursor/
-.aider*
+Thumbs.db
 
-# IDE
-.vscode/
-.idea/
+# Dot files/directories (opt-in only)
+/.*
+!/.github
+!/.gitignore
+!/.spi.yml
+!/.swift-format
+!/.swiftformat
+!/.swiftlint.yml
 
-# Temporary files
-*.tmp
-*.swp
-*~
+# Documentation (opt-in for top-level .md files only)
+/*.md
+!README.md
+!LICENSE.md
+!CHANGELOG.md
+!CONTRIBUTING.md
+!CODE_OF_CONDUCT.md
+!SECURITY.md

README.md

@@ -59,7 +59,7 @@ print(email.domain.name) // "example.com"
 // Parse with display name
 let named = try RFC_5322.EmailAddress("John Doe <[email protected]>")
 print(named.displayName) // "John Doe"
-print(named.addressValue) // "[email protected]"
+print(named.address) // "[email protected]"
 
 // Create from components
 let addr = try RFC_5322.EmailAddress(
@@ -149,7 +149,7 @@ public struct EmailAddress: Hashable, Sendable {
     public init(_ string: String) throws
 
     public var stringValue: String      // Full format with display name
-    public var addressValue: String     // Just the email address part
+    public var address: String     // Just the email address part
     public func toRFC5321() throws -> RFC_5321.EmailAddress
 }
 ```

Tests/RFC_5322 Tests/RFC_5322.EmailAddress Tests.swift

@@ -27,14 +27,14 @@ struct `RFC_5322.EmailAddress Tests` {
         #expect(email.displayName == "John Doe")
         #expect(email.localPart.description == "john")
         #expect(email.domain.name == "example.com")
-        #expect(email.addressValue == "[email protected]")
+        #expect(email.address == "[email protected]")
     }
 
     @Test
     func `Parse email with quoted display name`() throws {
         let email = try RFC_5322.EmailAddress("\"Doe, John\" <[email protected]>")
         #expect(email.displayName == "Doe, John")
-        #expect(email.addressValue == "[email protected]")
+        #expect(email.address == "[email protected]")
     }
 
     // MARK: - Creation from Components
@@ -83,14 +83,14 @@ struct `RFC_5322.EmailAddress Tests` {
     func `Exclamation mark (!) is accepted in local-part`() throws {
         let email = try RFC_5322.EmailAddress("[email protected]")
         #expect(email.localPart.description == "user!tag")
-        #expect(email.addressValue == "[email protected]")
+        #expect(email.address == "[email protected]")
     }
 
     @Test
     func `Pipe character (|) is accepted in local-part`() throws {
         let email = try RFC_5322.EmailAddress("user|[email protected]")
         #expect(email.localPart.description == "user|tag")
-        #expect(email.addressValue == "user|[email protected]")
+        #expect(email.address == "user|[email protected]")
     }
 
     @Test
@@ -114,7 +114,7 @@ struct `RFC_5322.EmailAddress Tests` {
 
         for address in testAddresses {
             let email = try RFC_5322.EmailAddress(address)
-            #expect(email.addressValue == address)
+            #expect(email.address == address)
         }
     }
 
@@ -149,16 +149,16 @@ struct `RFC_5322.EmailAddress Tests` {
         #expect(formatted == "\"Doe, John\" <[email protected]>")
     }
 
-    // MARK: - addressValue Property
+    // MARK: - address Property
 
     @Test
-    func `addressValue returns email without display name`() throws {
+    func `address returns email without display name`() throws {
         let email = try RFC_5322.EmailAddress(
             displayName: "John Doe",
             localPart: .init("john"),
             domain: .init("example.com")
         )
-        #expect(email.addressValue == "[email protected]")
+        #expect(email.address == "[email protected]")
     }
 
     // MARK: - Validation Errors

Tests/RFC_5322 Tests/RFC_5322.Message Tests.swift

@@ -27,9 +27,9 @@ struct `RFC_5322.Message Tests` {
             body: .init("Hello, World!".utf8)
         )
 
-        #expect(message.from.addressValue == "[email protected]")
+        #expect(message.from.address == "[email protected]")
         #expect(message.to.count == 1)
-        #expect(message.to[0].addressValue == "[email protected]")
+        #expect(message.to[0].address == "[email protected]")
         #expect(message.subject == "Test Message")
         #expect(message.messageId == "<[email protected]>")
         #expect(String(decoding: message.body, as: UTF8.self) == "Hello, World!")
@@ -51,9 +51,9 @@ struct `RFC_5322.Message Tests` {
         )
 
         #expect(message.to.count == 3)
-        #expect(message.to[0].addressValue == "[email protected]")
-        #expect(message.to[1].addressValue == "[email protected]")
-        #expect(message.to[2].addressValue == "[email protected]")
+        #expect(message.to[0].address == "[email protected]")
+        #expect(message.to[1].address == "[email protected]")
+        #expect(message.to[2].address == "[email protected]")
     }
 
     @Test
@@ -69,7 +69,7 @@ struct `RFC_5322.Message Tests` {
         )
 
         #expect(message.cc?.count == 1)
-        #expect(message.cc?[0].addressValue == "[email protected]")
+        #expect(message.cc?[0].address == "[email protected]")
     }
 
     @Test
@@ -85,7 +85,7 @@ struct `RFC_5322.Message Tests` {
         )
 
         #expect(message.bcc?.count == 1)
-        #expect(message.bcc?[0].addressValue == "[email protected]")
+        #expect(message.bcc?[0].address == "[email protected]")
     }
 
     @Test
@@ -100,7 +100,7 @@ struct `RFC_5322.Message Tests` {
             body: .init(utf8: "Test")
         )
 
-        #expect(message.replyTo?.addressValue == "[email protected]")
+        #expect(message.replyTo?.address == "[email protected]")
     }
 
     // MARK: - Additional Headers

Tests/RFC_5322 Tests/ReadmeVerificationTests.swift

@@ -22,7 +22,7 @@ struct `README Verification Tests` {
     func `README Line 59-62: Parse with display name`() throws {
         let named = try RFC_5322.EmailAddress("John Doe <[email protected]>")
         #expect(named.displayName == "John Doe")
-        #expect(named.addressValue == "[email protected]")
+        #expect(named.address == "[email protected]")
     }
 
     @Test
@@ -104,7 +104,7 @@ struct `README Verification Tests` {
 
         #expect(message.cc?.count == 1)
         #expect(message.bcc?.count == 1)
-        #expect(message.replyTo?.addressValue == "[email protected]")
+        #expect(message.replyTo?.address == "[email protected]")
         #expect(message.additionalHeaders.count == 2)
     }