:sig
function ls(path : string) dval

:params
path : directory path to list

:returns
A `dval` list of entry names.

:content
`ls()` returns the names in a directory. It returns an empty list when it cannot list the directory.

:example capy render
var root := file_temp("/tmp/capy-doc-ls-")
file_unlink(root)
mkdir(root)
file_put_contents(path_join(root, "one.txt"), "1")
print(join(sort(ls(root)), ","), "\n")
dir_remove(root, true)

:see-group
directories

:see
path_join
