4. Directory Listing & Walkers

FSHelper.List.flat(dir, baseDir)

Recursively lists files and directories in a flat structure.

          
            1const files = await FSHelper.List.flat('.', '.');
          
        

Output:

          
            1[{ type: 'file'|'directory', name: 'relative/path', size?: number }]
          
        

---

FSHelper.List.tree(dir)

Recursively lists files and directories as a tree structure.

          
            1const tree = await FSHelper.List.tree('.');
          
        

Output:

          
            1{2  folder1: { file1: 'file', subfolder: { file2: 'file' } },3  file3: 'file'4}
          
        

---

FSHelper.List.directories(dir)

Lists immediate directory contents (non-recursive).

          
            1const dirs = await FSHelper.List.directories('.');
          
        

Output:

          
            1[{ name: 'folder1', type: 'directory' }, { name: 'file.txt', type: 'file' }]
          
        

---