--- name: read_dir_autocomplete kind: function lang: go domain: tui version: "1.0.0" purity: impure signature: "func ReadDirAutocomplete(searchDir, prefix string) ([]AutocompleteCandidate, error)" description: "Lee entradas de un directorio filtradas por prefijo (case-insensitive). Retorna candidatos ordenados por nombre, utiles para autocompletado de rutas en TUIs." tags: [tui, autocomplete, directory, path, filter, completion, pendiente-usar] uses_functions: [] uses_types: [] returns: [] returns_optional: false error_type: "error_go_core" imports: [os, sort, strings] params: - name: searchDir desc: "directorio donde buscar entradas" - name: prefix desc: "prefijo para filtrar nombres (case-insensitive); vacio retorna todas" output: "slice de AutocompleteCandidate con Name y IsDir, ordenados alfabeticamente" tested: false tests: [] test_file_path: "" file_path: "functions/tui/read_dir_autocomplete.go" source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/egutierrez/DevLauncher.git" source_license: "MIT" source_file: "launcher/middleware/command_fs.go" --- ## Ejemplo ```go candidates, err := tui.ReadDirAutocomplete("/home/user", "doc") // candidates podria ser: [{Name:"Documents" IsDir:true}, {Name:"docker-compose.yml" IsDir:false}] // Sin prefijo retorna todas las entradas all, _ := tui.ReadDirAutocomplete("/tmp", "") ``` ## Notas El struct `AutocompleteCandidate` se define en el mismo archivo. El campo `IsDir` permite al caller diferenciar directorios de archivos para renderizar iconos o sufijos distintos.