[IMP] choose-files: allow selecting files and directories

Add a new mode `all` to select either a file or a directory.

docs/changelog.rst

@@ -200,6 +200,8 @@ Detailed list of changes
 
 - Fix superfluous margin visible to the left and right of the tab bar when :opt:`background_opacity` is less than one and the window width is not a multiple of the cell width (:iss:`10212`)
 
+- choose-files kitten: Add an ``all`` mode to select either an existing file or directory (:iss:`10208`)
+
 
 0.47.4 [2026-06-15]
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

docs/kittens/choose-files.rst

@@ -120,6 +120,16 @@ directory you can select a descendant directory by pressing :kbd:`Enter`, the
 same as you would for selecting a file to open.
 
 
+Selecting files or directories
+--------------------------------
+
+To select any existing path, whether it is a file or a directory, use
+:option:`--mode <kitty +kitten choose_files --mode>`:code:`=all`. Press
+:kbd:`Enter` to select the highlighted path. You can still use :kbd:`Tab` to
+change into a highlighted directory and :kbd:`Ctrl+Enter` to select the
+current directory itself.
+
+
 Configuration
 ------------------------