feat: toggle hidden directories in cd-browser with . key

src/app/filesystem.py

@@ -13,28 +13,41 @@ class DirectoryEntry:
     has_children: bool
 
 
-def list_directories(path: Path) -> list[DirectoryEntry]:
+def list_directories(path: Path, show_hidden: bool = False) -> list[DirectoryEntry]:
     """Return direct child directories sorted by name."""
 
     directory_path = path.expanduser().resolve()
     entries: list[DirectoryEntry] = []
 
     for child in directory_path.iterdir():
-        if child.is_dir():
-            entries.append(
-                DirectoryEntry(
-                    name=child.name,
-                    path=child,
-                    has_children=has_subdirectories(child),
-                )
+        if not child.is_dir():
+            continue
+        if not show_hidden and child.name.startswith("."):
+            continue
+
+        entries.append(
+            DirectoryEntry(
+                name=child.name,
+                path=child,
+                has_children=has_subdirectories(child, show_hidden=show_hidden),
             )
+        )
 
     return sorted(entries, key=lambda entry: entry.name.casefold())
 
 
-def has_subdirectories(path: Path) -> bool:
+def has_subdirectories(path: Path, show_hidden: bool = False) -> bool:
     """Return whether the directory contains at least one subdirectory."""
 
     directory_path = path.expanduser().resolve()
 
-    return any(child.is_dir() for child in directory_path.iterdir())
+    for child in directory_path.iterdir():
+        if not child.is_dir():
+            continue
+
+        if not show_hidden and child.name.startswith("."):
+            continue
+
+        return True
+
+    return False

src/app/navigator.py

@@ -28,6 +28,7 @@ class Navigator:
     current_path: Path = field(init=False)
     selected_index: int = field(init=False, default=0)
     _expanded_paths: set[Path] = field(init=False, default_factory=set)
+    show_hidden: bool = False
 
     def __post_init__(self) -> None:
         self.current_path = self.start_path.expanduser().resolve()
@@ -144,6 +145,13 @@ class Navigator:
         self._set_current_path(path)
         return path
 
+    def toggle_hidden(self) -> None:
+        """Toggle showing/hiding hidden directory entries."""
+
+        self.show_hidden = not self.show_hidden
+        self.selected_index = 0
+        self._expanded_paths.clear()
+
     def select_history_entry(self, index: int) -> Path:
         """Jump to a directory stored in session history."""
 
@@ -154,7 +162,7 @@ class Navigator:
     def _build_entries(self, path: Path, depth: int) -> list[VisibleEntry]:
         entries: list[VisibleEntry] = []
 
-        for directory in list_directories(path):
+        for directory in list_directories(path, show_hidden=self.show_hidden):
             is_expanded = directory.path in self._expanded_paths
             entries.append(
                 VisibleEntry(

src/app/ui.py

@@ -145,7 +145,8 @@ class TerminalUI:
             stdscr.refresh()
             return
 
-        path_text = str(navigator.current_path)
+        hidden_status = "on" if navigator.show_hidden else "off"
+        path_text = f"{navigator.current_path} [hidden: {hidden_status}]"
         stdscr.addnstr(0, 0, path_text, width - 1)
 
         lines = build_render_lines(navigator)
@@ -282,6 +283,11 @@ class TerminalUI:
             self._tree_scroll_offset = 0
             return None
 
+        if key == ord("."):
+            navigator.toggle_hidden()
+            self._tree_scroll_offset = 0
+            return None
+
         if key in (curses.KEY_ENTER, 10, 13):
             return navigator.selected_entry.path