Merge branch '949-load-a-resource-and-dependencies-instead-of-full-directory' of https://github.com/FirelyTeam/firely-cql-sdk into 949-load-a-resource-and-dependencies-instead-of-full-directory

Author: baseTwo

Cql/Cql.Invocation/Toolkit/Extensions/InvocationToolkitExtensions.FhirLibraryAdding.cs

@@ -235,7 +235,7 @@ IEnumerable<string> GetRelatedResources(FhirLibrary library)
             if (shouldInclude)
             {
                 if (!file.Exists)
-                    throw new ArgumentException($"No file exists '{file}' for FHIR library '{identifier}'.");
+                    throw new FileNotFoundException($"No file exists '{file}' for FHIR library '{identifier}'.", file.FullName);
                 return file;
             }
             logger.LogDebug("Skipped loading file '{file}' by predicate.", file);
@@ -245,7 +245,24 @@ IEnumerable<string> GetRelatedResources(FhirLibrary library)
 
     // Regex to extract "Library", "NCQAAdvancedIllnessandFrailty", and optional "1.0.0" from resource string
     // Example: https://fire.ly/fhir/Library/NCQAAdvancedIllnessandFrailty|1.0.0
-    // Groups: 1=resourceType, 2=libraryName, 3=version (optional)
+    /// <summary>
+    /// Regex to extract the resource type, library name, and optional version from a FHIR Library resource string.
+    /// 
+    /// Capture groups:
+    ///   1. <b>resourceType</b>: The FHIR resource type (e.g., "Library").
+    ///   2. <b>libraryName</b>: The name of the library (e.g., "NCQAAdvancedIllnessandFrailty").
+    ///   3. <b>version</b> (optional): The version of the library (e.g., "1.0.0").
+    /// 
+    /// Examples of valid input strings and their capture groups:
+    ///   - <c>https://fire.ly/fhir/Library/NCQAAdvancedIllnessandFrailty|1.0.0</c>
+    ///       1 = "Library", 2 = "NCQAAdvancedIllnessandFrailty", 3 = "1.0.0"
+    ///   - <c>/Library/SomeLibrary|2.3.4</c>
+    ///       1 = "Library", 2 = "SomeLibrary", 3 = "2.3.4"
+    ///   - <c>/Library/AnotherLibrary</c>
+    ///       1 = "Library", 2 = "AnotherLibrary", 3 = null
+    ///   - <c>https://example.com/fhir/Library/MyLib</c>
+    ///       1 = "Library", 2 = "MyLib", 3 = null
+    /// </summary>
     [GeneratedRegex(@"\/([A-Za-z]+)\/([^|\/]+)(?:\|([0-9A-Za-z\.\-\+]+))?$")]
     private static partial Regex FhirLibraryResourceRegex();