Package.swift

@@ -1,23 +1,26 @@
-// swift-tools-version:5.4
-// The swift-tools-version declares the minimum version of Swift required to build this package.
+// swift-tools-version:5.9
 
 import PackageDescription
 
 let package = Package(
     name: "SwiftyChords",
     platforms: [.iOS(.v13), .macOS(.v11)],
     products: [
-        // Products define the executables and libraries produced by a package, and make them visible to other packages.
         .library(
             name: "SwiftyChords",
-            targets: ["SwiftyChords"]),
+            targets: ["SwiftyChords"]
+        ),
     ],
-    dependencies: [],
     targets: [
         .target(
             name: "SwiftyChords",
-            dependencies: [],
             resources: [.process("Resources")]
         ),
+        .testTarget(
+            name: "SwiftyChordsTests",
+            dependencies: [
+                "SwiftyChords"
+            ]
+        )
     ]
 )

README.md

@@ -60,6 +60,14 @@ Returns all suspended chords in the database along with their variants such as s
 Chords.guitar.matching(group: .suspended)
 ```
 
+#### Filter by String Keyword
+Returns all Dsus4 chords. This works the same as filtering by key and suffix.
+
+```swift
+Chords.guitar.matching(keyword: "Dsus4") // same as Chords.guitar.matching(key: .d).matching(suffix: .sus4)
+```
+
+
 ## Display
 Swifty Chords suports a number of alternative texts you can use in your UI including an accessibility text-to-speech friendly variant.
 Display texts from both Key and Suffix properties can be combined to complete the chord name.

Sources/SwiftyChords/Aliasses.swift

@@ -0,0 +1,43 @@
+//
+//  File.swift
+//  
+//
+//  Created by Nick Berendsen on 07/09/2023.
+//
+
+#if os(macOS)
+import AppKit
+#else
+import UIKit
+#endif
+
+
+#if os(macOS)
+
+/// Alias for NSImage
+public typealias SWIFTImage = NSImage
+
+/// Alias for NSColor
+public typealias SWIFTColor = NSColor
+
+let primaryColor = NSColor.labelColor
+let backgroundColor = NSColor.windowBackgroundColor
+
+/// Alias for NSFont
+public typealias SWIFTFont = NSFont
+
+#else
+
+/// Alias for UIImage
+public typealias SWIFTImage = UIImage
+
+/// Alias for UIColor
+public typealias SWIFTColor = UIColor
+
+/// Alias for UIFont
+public typealias SWIFTFont = UIFont
+
+let primaryColor = UIColor.label
+let backgroundColor = UIColor.systemBackground
+
+#endif

Sources/SwiftyChords/Array+Chords.swift

@@ -29,4 +29,41 @@ public extension Array where Element == ChordPosition {
         return self.filter { $0.suffix.group == group }
     }
 
+    func matching(keyword: String) -> [ChordPosition] {
+        // check keyword invalidation...
+        let trimmedKeyword = keyword.trimmingCharacters(in: .whitespaces)
+        if trimmedKeyword.isEmpty { return [] }
+
+        // If the keyword has 1 or 0 character, returns the matching `ChordPosition`s immediately
+        if trimmedKeyword.count < 2 {
+            guard let key = Chords.Key(rawValue: trimmedKeyword) else { return [] }
+            return self.matching(key: key)
+        }
+
+        // Get second character
+        let sharpOrFlat = trimmedKeyword[trimmedKeyword.index(trimmedKeyword.startIndex, offsetBy: 1)]
+        let hasSharpOrFlat = (sharpOrFlat == "b") || (sharpOrFlat == "#") // C#, Bb, Eb, D#, ...
+
+        // Get string for key
+        let keyString = String(trimmedKeyword.prefix(hasSharpOrFlat ? 2 : 1))
+
+        // If the string for key is invalid, returns immediately
+        guard let key = Chords.Key(rawValue: keyString) else { return [] }
+
+        // Get string for suffix
+        var suffixString = String(trimmedKeyword.dropFirst(hasSharpOrFlat ? 2 : 1))
+
+        // If the string for suffix is empty, assigns "major" instead.
+        // If the string for suffix is "m", assigns "minor" instead.
+        if suffixString.isEmpty {
+            suffixString = "major"
+        } else if suffixString == "m" {
+            suffixString = "minor"
+        }
+
+        guard let suffix = Chords.Suffix(rawValue: suffixString) else { return [] }
+
+        // Returns the matching chord positions
+        return self.matching(key: key).matching(suffix: suffix)
+    }
 }