feat(device): add current type helper and platform labels

Author: backslash-f

README.md

@@ -84,6 +84,13 @@ case .unknown:
 }
 ```
 
+### Current Platform Label
+```swift
+let currentType = Device.currentType()
+let platformLabel = currentType.platformDisplayName
+// Example: "iOS", "tvOS", "macOS"
+```
+
 ## Available Properties
 Property | Description
 -------- | -----------
@@ -97,6 +104,8 @@ API | Description
 `enableLogging()` | Enables logging output via [AppLogger](https://github.com/thatfactory/applogger).
 `os()` | Returns the operating system version based on `-[NSProcessInfo operatingSystemVersionString]` and `-[NSProcessInfo operatingSystemVersion]`.
 `type()` | Returns the type of the device based on the result of the `os()` and `targetEnvironment()` functions.
+`currentType()` | Returns the current `DeviceType` without manually creating a `Device` instance.
+`platformDisplayName` | Returns a stable user-facing platform label from a `DeviceType`.
 
 ## Integration
 ### Xcode

Sources/Device/Device+Type.swift

@@ -11,8 +11,36 @@ public enum DeviceType: Equatable {
     case unknown
 }
 
+public extension DeviceType {
+
+    /// Returns a stable user-facing label for the platform.
+    var platformDisplayName: String {
+        switch self {
+        case .iPhone, .iPad:
+            return "iOS"
+        case .mac(isCatalyst: false):
+            return "macOS"
+        case .mac(isCatalyst: true):
+            return "Mac Catalyst"
+        case .tv:
+            return "tvOS"
+        case .watch:
+            return "watchOS"
+        case .vision:
+            return "visionOS"
+        case .unknown:
+            return "Unknown"
+        }
+    }
+}
+
 public extension Device {
 
+    /// Returns the current host device type.
+    static func currentType() -> DeviceType {
+        Device().type()
+    }
+
     /// Returns the `DeviceType`, based on the result of the `os()` and `targetEnvironment()` functions.
     ///
     /// Originally, the documentation for the `os()` function and `Preprocessor Directives` (AKA *Conditional

Tests/DeviceTests/DeviceTests.swift

@@ -24,4 +24,23 @@ import XCTest
         XCTAssertTrue(osVersion.minor >= 0, "The minor version isn't equal or greater than zero.")
         XCTAssertTrue(osVersion.patch >= 0, "The patchVersion version isn't equal or greater than zero.")
     }
+
+    func testCurrentTypeReturnsKnownCase() {
+        let currentType = Device.currentType()
+        switch currentType {
+        case .iPhone, .iPad, .mac, .tv, .watch, .vision, .unknown:
+            XCTAssertTrue(true)
+        }
+    }
+
+    func testPlatformDisplayNameMapping() {
+        XCTAssertEqual(DeviceType.iPhone.platformDisplayName, "iOS")
+        XCTAssertEqual(DeviceType.iPad.platformDisplayName, "iOS")
+        XCTAssertEqual(DeviceType.mac(isCatalyst: false).platformDisplayName, "macOS")
+        XCTAssertEqual(DeviceType.mac(isCatalyst: true).platformDisplayName, "Mac Catalyst")
+        XCTAssertEqual(DeviceType.tv.platformDisplayName, "tvOS")
+        XCTAssertEqual(DeviceType.watch.platformDisplayName, "watchOS")
+        XCTAssertEqual(DeviceType.vision.platformDisplayName, "visionOS")
+        XCTAssertEqual(DeviceType.unknown.platformDisplayName, "Unknown")
+    }
 }