Add import-tree.new

Author: vic

README.md

@@ -292,6 +292,11 @@ import-tree.pipeTo lib.id # equivalent to  `.leafs`
 import-tree.leafs
 ```
 
+### `import-tree.new`
+
+Returns a fresh import-tree with empty state. If you previously had any path, lib, filter, etc,
+you might need to set them on the new empty tree.
+
 ### `import-tree.result`
 
 Exactly the same as calling the import-tree object with an empty list `[ ]`.

checkmate.nix

@@ -113,6 +113,18 @@ in
           ];
         };
 
+        reset."test `new` returns a clear state" = {
+          expr = lib.pipe lit [
+            (i: i.addPath ./tree/x)
+            (i: i.addPath ./tree/a/b)
+            (i: i.new)
+            (i: i.addPath ./tree/modules/hello-world)
+            (i: i.withLib lib)
+            (i: i.leafs.result)
+          ];
+          expected = [ ./tree/modules/hello-world/mod.nix ];
+        };
+
         addAPI."test extends the API available on an import-tree object" = {
           expr =
             let

default.nix

@@ -110,6 +110,9 @@ let
 
             # Applies empty (for already path-configured trees)
             result = (self f) [ ];
+
+            # returns the original empty state
+            new = callable;
           };
       };
     in