fix(prompts): submit initial directory value in path prompt (#484)

Co-authored-by: James Garbutt <43081j@users.noreply.github.com>

Author: dreyfus92

.changeset/tricky-states-tease.md

@@ -0,0 +1,5 @@
+---
+"@clack/prompts": patch
+---
+
+Fix `path` directory mode so pressing Enter with an existing directory `initialValue` submits that current directory instead of the first child option, and add regression coverage for immediate submit and child-directory navigation.

packages/prompts/src/path.ts

@@ -44,13 +44,17 @@ export const path = (opts: PathOptions) => {
 					searchPath = dirname(userInput);
 				} else {
 					const stat = lstatSync(userInput);
-					if (stat.isDirectory()) {
+					if (stat.isDirectory() && (!opts.directory || userInput.endsWith('/'))) {
 						searchPath = userInput;
 					} else {
 						searchPath = dirname(userInput);
 					}
 				}
 
+				// Strip trailing slash so startsWith matches the directory itself among its siblings
+				const prefix =
+					userInput.length > 1 && userInput.endsWith('/') ? userInput.slice(0, -1) : userInput;
+
 				const items = readdirSync(searchPath)
 					.map((item) => {
 						const path = join(searchPath, item);
@@ -62,9 +66,9 @@ export const path = (opts: PathOptions) => {
 						};
 					})
 					.filter(
-						({ path, isDirectory }) =>
-							path.startsWith(userInput) && (isDirectory || !opts.directory)
+						({ path, isDirectory }) => path.startsWith(prefix) && (isDirectory || !opts.directory)
 					);
+
 				return items.map((item) => ({
 					value: item.path,
 				}));

packages/prompts/test/path.test.ts

@@ -163,6 +163,59 @@ describe.each(['true', 'false'])('text (isCI = %s)', (isCI) => {
 		expect(value).toBe('/tmp/foo');
 	});
 
+	test('directory mode submits initial directory value on enter', async () => {
+		const result = prompts.path({
+			message: 'foo',
+			root: '/tmp/',
+			initialValue: '/tmp',
+			directory: true,
+			input,
+			output,
+		});
+
+		input.emit('keypress', '', { name: 'return' });
+
+		const value = await result;
+
+		expect(value).toBe('/tmp');
+	});
+
+	test('directory mode traverses into child when trailing slash entered', async () => {
+		const result = prompts.path({
+			message: 'foo',
+			root: '/tmp/',
+			initialValue: '/tmp',
+			directory: true,
+			input,
+			output,
+		});
+
+		input.emit('keypress', '/', { name: '/' });
+		input.emit('keypress', '', { name: 'return' });
+
+		const value = await result;
+
+		expect(value).toBe('/tmp/foo');
+	});
+
+	test('directory mode can navigate from initial directory to child directory', async () => {
+		const result = prompts.path({
+			message: 'foo',
+			root: '/tmp/',
+			initialValue: '/tmp/',
+			directory: true,
+			input,
+			output,
+		});
+
+		input.emit('keypress', 'f', { name: 'f' });
+		input.emit('keypress', '', { name: 'return' });
+
+		const value = await result;
+
+		expect(value).toBe('/tmp/foo');
+	});
+
 	test('default mode allows selecting files', async () => {
 		const result = prompts.path({
 			message: 'foo',