Refactor generator extensions and improve code organization

- Consolidated methods into extensions for better grouping and readability.
- Reintroduced `Get(int count)` method into `Faker` base class.
- Adjusted username data file loading to simplify format.
- Added `ToString` override for `Generator` to provide readable outputs.
- Minor visibility updates to `Token` records.

Author: Atulin

Forged.Core/Core/TemplateCompiler.cs

@@ -73,6 +73,6 @@ public static string Render(List<Token> tokens, Dictionary<string, Func<string>>
 	}
 
 	internal abstract record Token;
-	internal sealed record Literal(string Value) : Token;
-	internal sealed record Placeholder(string Key) : Token;
+	private sealed record Literal(string Value) : Token;
+	private sealed record Placeholder(string Key) : Token;
 }

Forged.Core/Faker.cs

@@ -25,9 +25,14 @@ public abstract class Faker<TModel>(Random? random = null, CultureInfo? locale =
     /// </summary>
     /// <param name="count">The number of instances to generate.</param>
     /// <returns>An enumerable of fake model instances.</returns>
-    public abstract IEnumerable<TModel> Get(int count);
-
-
+    public IEnumerable<TModel> Get(int count)
+    {
+	    for (var i = 0; i < count; i++)
+	    {
+		    yield return Get();
+	    }
+    }
+	
     /// <summary>
     /// Generates a random number of fake model instances within a specified range.
     /// </summary>

Forged.Core/Generators/Generator.cs

@@ -131,4 +131,10 @@ public Generator<HashSet<T>> HashSet(int length)
 	/// <returns>A generator that produces hash sets of generated values.</returns>
 	public Generator<HashSet<T>> HashSet(int minLength, int maxLength)
 		=> new EnumerableGenerator<T>(this, minLength, maxLength, Forge).Refine<HashSet<T>>(static e => e.ToHashSet());
+
+	/// <summary>
+	/// Returns a string representation of the generated value.
+	/// </summary>
+	/// <returns>A string representation of the value generated by this generator, or null if the generated value is null.</returns>
+	public override string? ToString() => Generate()?.ToString();
 }

Forged.Core/Generators/GeneratorExtensions.cs

@@ -157,32 +157,24 @@ public static Generator<string> ToString<T>(this Generator<T> generator, string
 	public static Generator<List<T>> AsList<T>(this Generator<IEnumerable<T>> generator)
 		=> new RefineGenerator<IEnumerable<T>, List<T>>(generator, static e => e.ToList(), generator.Forge);
 
-	/// <summary>
-	/// Converts collections from a generator to lists.
-	/// </summary>
-	/// <typeparam name="T">The type of items in the collection.</typeparam>
 	/// <param name="generator">The generator to convert.</param>
-	/// <returns>A generator that produces lists.</returns>
-	public static Generator<List<T>> AsList<T>(this Generator<ICollection<T>> generator)
-		=> new RefineGenerator<ICollection<T>, List<T>>(generator, static c => c.ToList(), generator.Forge);
-
-	/// <summary>
-	/// Converts enumerables from a generator to hash sets.
-	/// </summary>
-	/// <typeparam name="T">The type of items in the enumerable.</typeparam>
-	/// <param name="generator">The generator to convert.</param>
-	/// <returns>A generator that produces hash sets.</returns>
-	public static Generator<HashSet<T>> AsHashSet<T>(this Generator<IEnumerable<T>> generator)
-		=> new RefineGenerator<IEnumerable<T>, HashSet<T>>(generator, static e => e.ToHashSet(), generator.Forge);
-
-	/// <summary>
-	/// Converts collections from a generator to hash sets.
-	/// </summary>
 	/// <typeparam name="T">The type of items in the collection.</typeparam>
-	/// <param name="generator">The generator to convert.</param>
-	/// <returns>A generator that produces hash sets.</returns>
-	public static Generator<HashSet<T>> AsHashSet<T>(this Generator<ICollection<T>> generator)
-		=> new RefineGenerator<ICollection<T>, HashSet<T>>(generator, static c => c.ToHashSet(), generator.Forge);
+	extension<T>(Generator<ICollection<T>> generator)
+	{
+		/// <summary>
+		/// Converts collections from a generator to lists.
+		/// </summary>
+		/// <returns>A generator that produces lists.</returns>
+		public Generator<List<T>> AsList()
+			=> new RefineGenerator<ICollection<T>, List<T>>(generator, static c => c.ToList(), generator.Forge);
+		
+		/// <summary>
+		/// Converts collections from a generator to hash sets.
+		/// </summary>
+		/// <returns>A generator that produces hash sets.</returns>
+		public Generator<HashSet<T>> AsHashSet()
+			=> new RefineGenerator<ICollection<T>, HashSet<T>>(generator, static c => c.ToHashSet(), generator.Forge);
+	}
 
 	/// <param name="generator">The generator to convert.</param>
 	/// <typeparam name="T">The type of items in the enumerable.</typeparam>
@@ -200,15 +192,21 @@ public Generator<Dictionary<TKey, TValue>> AsDictionary<TKey, TValue>(Func<T, TK
 			Func<T, TValue> valueSelector
 		) where TKey : notnull
 			=> generator.Refine(e => e.ToDictionary(keySelector, valueSelector));
-
-
+		
 		/// <summary>
 		/// Creates a generator that produces shuffled versions of the enumerable generated by the given generator.
 		/// </summary>
 		/// <typeparam name="T">The type of elements in the enumerable being shuffled.</typeparam>
 		/// <returns>A generator that produces shuffled enumerables.</returns>
 		public Generator<IEnumerable<T>> Shuffle()
 			=> new ShuffleGenerator<T>(generator, generator.Forge);
+		
+		/// <summary>
+		/// Converts enumerables from a generator to hash sets.
+		/// </summary>
+		/// <returns>A generator that produces hash sets.</returns>
+		public Generator<HashSet<T>> AsHashSet()
+			=> new RefineGenerator<IEnumerable<T>, HashSet<T>>(generator, static e => e.ToHashSet(), generator.Forge);
 	}
 
 }

Forged.Core/Generators/Person/UsernameGenerator.cs

@@ -50,7 +50,7 @@ public sealed class UsernameGenerator(float prefixChance, float suffixChance, fl
 	/// <returns>A randomly generated username that may include a prefix, suffix, and leet-speak substitutions based on the configured probabilities.</returns>
 	public override string Generate()
 	{
-		var data = FileLoader.LoadData(Locale.Name, "username.json5", UserDataContext.Default.UserData);
+		var data = FileLoader.LoadData(Locale.Name, "username", UserDataContext.Default.UserData);
 
 		var usePrefix = Rng.NextSingle() < prefixChance;
 		var useSuffix = Rng.NextSingle() < suffixChance;

Forged.Generator/ForgedGenerator.cs

@@ -125,15 +125,6 @@ private static void Execute(SourceProductionContext context, TypeToGenerate? typ
 
 		sb.AppendLine("        };");
 		sb.AppendLine("    }");
-
-		sb.AppendLine();
-		sb.AppendLine($"    public override IEnumerable<{typeToGenerate.Name}> Get(int count)");
-		sb.AppendLine("    {");
-		sb.AppendLine("        for (var i = 0; i < count; i++)");
-		sb.AppendLine("        {");
-		sb.AppendLine("            yield return Get();");
-		sb.AppendLine("        }");
-		sb.AppendLine("    }");
 		sb.AppendLine("}");
 
 		context.AddSource($"{typeToGenerate.Name}Faker.g.cs", SourceText.From(sb.ToString(), Encoding.UTF8));