Add convenience overloads for Logger & correct doc sample code

Author: Jeehut

README.md

@@ -122,7 +122,7 @@ When using `Throwable` with the `Catching` protocol, you get powerful error chai
 do {
     try await updateUserProfile()
 } catch {
-    Logger().error("\(ErrorKit.errorChainDescription(for: error))")
+    print(ErrorKit.errorChainDescription(for: error))
 
     // Output shows the complete error path:
     // ProfileError

Sources/ErrorKit/ErrorKit.docc/Guides/Error-Chain-Debugging.md

@@ -69,15 +69,28 @@ ErrorKit enhances string interpolation for error chain debugging. Use either `ch
 
 ```swift
 // Instead of:
-Logger().error("Update failed: \(ErrorKit.errorChainDescription(for: error))")
+print("Update failed:\n\(ErrorKit.errorChainDescription(for: error))")
 
 // You can simply use either:
-Logger().error("Update failed:\n\(chain: error)")
-Logger().error("Update failed:\n\(debug: error)")
+print("Update failed:\n\(chain: error)")
+print("Update failed:\n\(debug: error)")
 ```
 
 Use `\(error)` for user-facing messages, `\(chain: error)` or `\(debug: error)` for debugging.
 
+For `OSLog`/`Logger` there are dedicated convenience overloads taking a second `error` parameter:
+
+```swift
+// Instead of:
+Logger().error("Update failed:\n\(ErrorKit.errorChainDescription(for: error))")
+
+// You can simply use overloads like:
+Logger().error("Update failed", error: error)
+Logger().warning("Update failed", error: error)
+```
+
+There's no need to add a colon (`:`) or newline (`\n`) to the message, they will be added automatically.
+
 ### Error Analytics with Grouping IDs
 
 To help prioritize which errors to fix, ErrorKit provides `groupingID(for:)` that generates stable identifiers for errors sharing the exact same type structure and enum cases:

Sources/ErrorKit/Helpers/Logger+ErrorKit.swift

@@ -0,0 +1,104 @@
+#if canImport(OSLog)
+import OSLog
+
+extension Logger {
+   /// Logs a debug message with complete error chain description
+   ///
+   /// ```swift
+   /// Logger().debug("Operation failed", error: error)
+   /// ```
+   ///
+   /// - Parameters:
+   ///   - message: The main log message
+   ///   - error: The error to include using its complete chain description for debugging
+   public func debug(_ message: String, error: some Error) {
+      let normalizedMessage = self.normalizeMessage(message)
+      self.debug("\(normalizedMessage):\n\(ErrorKit.errorChainDescription(for: error))")
+   }
+
+   /// Logs an info message with complete error chain description
+   ///
+   /// ```swift
+   /// Logger().info("User action failed", error: error)
+   /// ```
+   ///
+   /// - Parameters:
+   ///   - message: The main log message
+   ///   - error: The error to include using its complete chain description for debugging
+   public func info(_ message: String, error: some Error) {
+      let normalizedMessage = self.normalizeMessage(message)
+      self.info("\(normalizedMessage):\n\(ErrorKit.errorChainDescription(for: error))")
+   }
+
+   /// Logs a notice with complete error chain description
+   ///
+   /// ```swift
+   /// Logger().notice("Important operation failed", error: error)
+   /// ```
+   ///
+   /// - Parameters:
+   ///   - message: The main log message
+   ///   - error: The error to include using its complete chain description for debugging
+   public func notice(_ message: String, error: some Error) {
+      let normalizedMessage = self.normalizeMessage(message)
+      self.notice("\(normalizedMessage):\n\(ErrorKit.errorChainDescription(for: error))")
+   }
+
+   /// Logs a warning with complete error chain description
+   ///
+   /// ```swift
+   /// Logger().warning("Recoverable error occurred", error: error)
+   /// ```
+   ///
+   /// - Parameters:
+   ///   - message: The main log message
+   ///   - error: The error to include using its complete chain description for debugging
+   public func warning(_ message: String, error: some Error) {
+      let normalizedMessage = self.normalizeMessage(message)
+      self.warning("\(normalizedMessage):\n\(ErrorKit.errorChainDescription(for: error))")
+   }
+
+   /// Logs an error message with complete error chain description
+   ///
+   /// ```swift
+   /// Logger().error("Upload failed", error: error)
+   /// ```
+   ///
+   /// - Parameters:
+   ///   - message: The main log message
+   ///   - error: The error to include using its complete chain description for debugging
+   public func error(_ message: String, error: some Error) {
+      let normalizedMessage = self.normalizeMessage(message)
+      self.error("\(normalizedMessage):\n\(ErrorKit.errorChainDescription(for: error))")
+   }
+
+   /// Logs a fault with complete error chain description
+   ///
+   /// ```swift
+   /// Logger().fault("Critical system error", error: error)
+   /// ```
+   ///
+   /// - Parameters:
+   ///   - message: The main log message
+   ///   - error: The error to include using its complete chain description for debugging
+   public func fault(_ message: String, error: some Error) {
+      let normalizedMessage = self.normalizeMessage(message)
+      self.fault("\(normalizedMessage):\n\(ErrorKit.errorChainDescription(for: error))")
+   }
+
+   /// Normalizes a log message by removing trailing punctuation and whitespace
+   ///
+   /// This ensures consistent formatting regardless of how the user writes the message:
+   /// - "Upload failed" → "Upload failed"
+   /// - "Upload failed:" → "Upload failed"
+   /// - "Upload failed: " → "Upload failed"
+   /// - "Upload failed." → "Upload failed"
+   ///
+   /// - Parameter message: The original message to normalize
+   /// - Returns: The normalized message without trailing punctuation or whitespace
+   private func normalizeMessage(_ message: String) -> String {
+      return message.trimmingCharacters(in: .whitespacesAndNewlines)
+         .trimmingCharacters(in: CharacterSet(charactersIn: ":"))
+   }
+}
+#endif

Sources/ErrorKit/Helpers/String+ErrorKit.swift

@@ -39,7 +39,7 @@ extension String.StringInterpolation {
    /// type information, and nested structure. Ideal for logging and debugging.
    ///
    /// ```swift
-   /// Logger().error("Operation failed with:\n\(chain: error)")
+   /// print("Operation failed with:\n\(chain: error)")
    /// // Operation failed with:
    /// // DatabaseError
    /// // └─ FileError
@@ -58,7 +58,7 @@ extension String.StringInterpolation {
    /// type information, and nested structure. Ideal for logging and debugging.
    ///
    /// ```swift
-   /// Logger().error("Operation failed with:\n\(chain: error)")
+   /// print("Operation failed with:\n\(chain: error)")
    /// // Operation failed with:
    /// // DatabaseError
    /// // └─ FileError