feat(core, prompts): add DatePrompt for date input with customizable formats (#448)

Author: dreyfus92

.changeset/tangy-mirrors-hug.md

@@ -0,0 +1,6 @@
+---
+"@clack/prompts": minor
+"@clack/core": minor
+---
+
+Adds `date` prompt with format support (YYYY/MM/DD, MM/DD/YYYY, DD/MM/YYYY).

examples/basic/date.ts

@@ -0,0 +1,21 @@
+import * as p from '@clack/prompts';
+import color from 'picocolors';
+
+async function main() {
+	const result = (await p.date({
+		message: color.magenta('Pick a date'),
+		format: 'YYYY/MM/DD',
+		minDate: new Date('2025-01-01'),
+		maxDate: new Date('2025-12-31'),
+	})) as Date;
+
+	if (p.isCancel(result)) {
+		p.cancel('Operation cancelled.');
+		process.exit(0);
+	}
+
+	const fmt = (d: Date) => d.toISOString().slice(0, 10);
+	p.outro(`Selected date: ${color.cyan(fmt(result))}`);
+}
+
+main().catch(console.error);

examples/basic/package.json

@@ -14,7 +14,8 @@
     "progress": "jiti ./progress.ts",
     "spinner": "jiti ./spinner.ts",
     "path": "jiti ./path.ts",
-    "spinner-ci": "npx cross-env CI=\"true\" jiti ./spinner-ci.ts",
+		"date": "jiti ./date.ts",
+		"spinner-ci": "npx cross-env CI=\"true\" jiti ./spinner-ci.ts",
     "spinner-timer": "jiti ./spinner-timer.ts",
     "task-log": "jiti ./task-log.ts"
   },

packages/core/src/index.ts

@@ -2,6 +2,8 @@ export type { AutocompleteOptions } from './prompts/autocomplete.js';
 export { default as AutocompletePrompt } from './prompts/autocomplete.js';
 export type { ConfirmOptions } from './prompts/confirm.js';
 export { default as ConfirmPrompt } from './prompts/confirm.js';
+export type { DateFormatConfig, DateOptions, DateParts } from './prompts/date.js';
+export { default as DatePrompt } from './prompts/date.js';
 export type { GroupMultiSelectOptions } from './prompts/group-multiselect.js';
 export { default as GroupMultiSelectPrompt } from './prompts/group-multiselect.js';
 export type { MultiSelectOptions } from './prompts/multi-select.js';