New option: file comparator

Author: ComputerDaddyGuy

src/main/java/io/github/computerdaddyguy/jfiletreeprettyprinter/PrettyPrintOptions.java

@@ -3,6 +3,7 @@
 import io.github.computerdaddyguy.jfiletreeprettyprinter.renderer.RenderingOptions;
 import io.github.computerdaddyguy.jfiletreeprettyprinter.scanner.ScanningOptions;
 import java.nio.file.Path;
+import java.util.Comparator;
 import java.util.Objects;
 import java.util.function.ToIntFunction;
 import org.jspecify.annotations.NullMarked;
@@ -129,4 +130,11 @@ public PrettyPrintOptions withMaxDepth(int maxDepth) {
 		return this;
 	}
 
+	// ----------------------------------------------
+
+	@Override
+	public Comparator<Path> fileComparator() {
+		return Comparator.comparing(Path::toString);
+	}
+
 }

src/main/java/io/github/computerdaddyguy/jfiletreeprettyprinter/scanner/DefaultPathToTreeScanner.java

@@ -13,6 +13,7 @@
 import java.util.ArrayList;
 import java.util.List;
 import java.util.Objects;
+import java.util.stream.StreamSupport;
 import org.jspecify.annotations.NullMarked;
 
 @NullMarked
@@ -46,7 +47,9 @@ private TreeEntry handleDirectory(int depth, Path dir) {
 		int maxChildrenEntries = options.getChildrenLimitFunction().applyAsInt(dir);
 
 		try (var childrenStream = Files.newDirectoryStream(dir)) {
-			var it = childrenStream.iterator();
+			var it = StreamSupport.stream(childrenStream.spliterator(), false)
+				.sorted(options.fileComparator())
+				.iterator();
 			var childCount = 0;
 			while (it.hasNext()) {
 				childCount++;

src/main/java/io/github/computerdaddyguy/jfiletreeprettyprinter/scanner/ScanningOptions.java

@@ -1,6 +1,7 @@
 package io.github.computerdaddyguy.jfiletreeprettyprinter.scanner;
 
 import java.nio.file.Path;
+import java.util.Comparator;
 import java.util.function.ToIntFunction;
 import org.jspecify.annotations.NullMarked;
 
@@ -11,4 +12,6 @@ public interface ScanningOptions {
 
 	ToIntFunction<Path> getChildrenLimitFunction();
 
+	Comparator<Path> fileComparator();
+
 }