Helper property for UID

Author: keybuk

Sources/FifthEdition/Bestiary.swift

@@ -319,6 +319,15 @@ public struct Creature: Equatable, Sendable {
     // TODO: _versions, array /creatureVersion
     // TODO: _isCopy, _copy
 
+    /// Returns the uid used to reference this creature.
+    public var uid: String? {
+        guard let name, let source else {
+            return nil
+        }
+
+        return "\(name.localizedLowercase)|\(source.localizedLowercase)"
+    }
+
     /// Returns the expected token path.
     public var tokenPath: String? {
         guard let name = token?.name ?? name,

Tests/FifthEditionTests/BestiaryTests.swift

@@ -447,6 +447,35 @@ struct CreatureCodableTests {
 
 }
 
+struct CreatureUidTests {
+
+    @Test("UID")
+    func uid() throws {
+        let creature = Creature(
+            name: "Blink Dog",
+            source: "XMM"
+        )
+        #expect(creature.uid == "blink dog|xmm")
+    }
+
+    @Test("No UID if no name")
+    func noName() throws {
+        let creature = Creature(
+            source: "XMM"
+        )
+        #expect(creature.uid == nil)
+    }
+
+    @Test("No UID if no source")
+    func noSource() throws {
+        let creature = Creature(
+            name: "Blink Dog",
+        )
+        #expect(creature.uid == nil)
+    }
+
+}
+
 struct CreatureTokenPathTests {
 
     @Test("Token path")