:sig
function dir_list(path : string) dval

:params
path : the directory path to list

:returns
A `dval` list of entry maps.

:content
`dir_list()` returns one map for each directory entry.

Each map has `name`, `type`, `size`, and `mtime`. The `type` value is `file`, `dir`, `symlink`, or `other`.

:example capy render
var root := file_temp("/tmp/capy-doc-dir-list-")
file_unlink(root)
mkdir(root)
file_put_contents(path_join(root, "note.txt"), "hi")
for item, key := dir_list(root) { print(string(item.name), "\n") }
dir_remove(root, true)

:see-group
directories

:see
file_stat
