Adds Swift MTHClient to match Kotlin mth-client

Author: powerje

Package.swift

@@ -3,6 +3,7 @@ import PackageDescription
 
 var products: [Product] = [
     .library(name: "MTH", targets: ["MTH"]),
+    .library(name: "MTHClient", targets: ["MTHClient"]),
     .library(name: "MTHColor", targets: ["MTHColor"]),
 ]
 
@@ -15,14 +16,26 @@ var targets: [Target] = [
         publicHeadersPath: "include",
         linkerSettings: [.linkedLibrary("z")]
     ),
-    // New Swift targets
+    // Shared telnet constants, compression, and MTTS flags used by both server and client.
     .target(
-        name: "MTH",
+        name: "MTHCore",
         dependencies: [
-            .target(name: "CZlib", condition: .when(platforms: [.macOS, .linux])),
+            .target(name: "CZlib", condition: .when(platforms: [.macOS, .linux, .iOS, .visionOS])),
         ],
+        path: "Sources/SwiftMTHCore"
+    ),
+    // Server-side telnet session, MSDP, MSSP, and related protocols.
+    .target(
+        name: "MTH",
+        dependencies: ["MTHCore"],
         path: "Sources/SwiftMTH"
     ),
+    // Client-side telnet session for MUD clients.
+    .target(
+        name: "MTHClient",
+        dependencies: ["MTHCore"],
+        path: "Sources/SwiftMTHClient"
+    ),
     .target(
         name: "MTHColor",
         dependencies: [],
@@ -55,7 +68,7 @@ targets += [
     ),
     .testTarget(
         name: "MTHTests",
-        dependencies: ["MTH", "Cmth"]
+        dependencies: ["MTH", "MTHClient", "Cmth"]
     ),
     .testTarget(
         name: "MTHColorTests",
@@ -66,7 +79,7 @@ targets += [
 targets += [
     .testTarget(
         name: "MTHTests",
-        dependencies: ["MTH"]
+        dependencies: ["MTH", "MTHClient"]
     ),
     .testTarget(
         name: "MTHColorTests",

Sources/SwiftMTH/MTH.swift

@@ -1,2 +1,2 @@
 // MTH — Mud Telopt Handler (Swift)
-// All phases complete.
+@_exported import MTHCore

Sources/SwiftMTHClient/TelnetClientDelegate.swift

@@ -0,0 +1,33 @@
+public protocol TelnetClientDelegate: AnyObject {
+    /// Write raw bytes to the server connection.
+    func write(data: [UInt8])
+
+    /// Called when the server changes echo mode.
+    /// When `enabled` is true, the client should echo locally.
+    /// When false, the server is echoing (password mode).
+    func onLocalEchoChanged(enabled: Bool)
+
+    /// Called when GMCP subnegotiation completes.
+    func onGMCPNegotiated()
+
+    /// Called when a GMCP message is received from the server.
+    func onGMCPReceived(module: String, json: String)
+
+    /// Called when an MSDP variable is received from the server.
+    func onMSDPVariable(name: String, value: String)
+
+    /// Called when a prompt marker (GA or EOR) is received.
+    func onPromptReceived()
+
+    /// Called when a BEL character is received.
+    func onBellReceived()
+
+    /// Log a diagnostic message.
+    func log(message: String)
+}
+
+public extension TelnetClientDelegate {
+    func onGMCPNegotiated() {}
+    func onBellReceived() {}
+    func log(message: String) {}
+}