@skillcap/gdh 3.2.1 → 3.2.3

package/node_modules/@clack/prompts/README.md

@@ -11,7 +11,7 @@ Effortlessly build beautiful command-line apps 🪄 [Try the demo](https://stack
 - 🤏 80% smaller than other options
 - 💎 Beautiful, minimal UI
 - ✅ Simple API
-- 🧱 Comes with `text`, `confirm`, `select`, `multiselect`, and `spinner` components
+- 🧱 Comes with `text`, `password`, `confirm`, `date`, `select`, `autocomplete`, `selectKey`, `multiselect`, `path`, and `spinner` components
 
 ## Basics
 
@@ -63,6 +63,22 @@ const meaning = await text({
 });
 ```
 
+### Password
+
+The password component behaves like `text`, but masks the input as the user types.
+
+```js
+import { password } from '@clack/prompts';
+
+const secret = await password({
+  message: 'Set a password.',
+  mask: '*',
+  validate(value) {
+    if (!value || value.length < 8) return 'Password must be at least 8 characters.';
+  },
+});
+```
+
 ### Confirm
 
 The confirm component accepts a yes or no answer. The result is a boolean value of `true` or `false`.
@@ -75,6 +91,21 @@ const shouldContinue = await confirm({
 });
 ```
 
+### Date
+
+The date component accepts a calendar date and returns a `Date` value.
+
+```js
+import { date } from '@clack/prompts';
+
+const dueDate = await date({
+  message: 'Pick a due date.',
+  format: 'YMD',
+  minDate: new Date(Date.UTC(2026, 0, 1)),
+  maxDate: new Date(Date.UTC(2026, 11, 31)),
+});
+```
+
 ### Select
 
 The select component allows a user to choose one value from a list of options. The result is the `value` prop of a given option.
@@ -92,6 +123,42 @@ const projectType = await select({
 });
 ```
 
+### Autocomplete
+
+The autocomplete component lets a user filter a list by typing, then choose one option from the matching results. By default, matching uses each option's `label`, `hint`, and `value`. The result is the selected option's `value`.
+
+```js
+import { autocomplete } from '@clack/prompts';
+
+const framework = await autocomplete({
+  message: 'Pick a framework.',
+  placeholder: 'Type to search...',
+  options: [
+    { value: 'next', label: 'Next.js' },
+    { value: 'nuxt', label: 'Nuxt' },
+    { value: 'sveltekit', label: 'SvelteKit' },
+    { value: 'remix', label: 'Remix' },
+  ],
+});
+```
+
+### Select Key
+
+The `selectKey` component lets a user choose an option by pressing its single-character string `value` key directly.
+
+```js
+import { selectKey } from '@clack/prompts';
+
+const action = await selectKey({
+  message: 'Pick an action.',
+  options: [
+    { value: 'd', label: 'Deploy' },
+    { value: 't', label: 'Run tests' },
+    { value: 'q', label: 'Quit' },
+  ],
+});
+```
+
 ### Multi-Select
 
 The `multiselect` component allows a user to choose many values from a list of options. The result is an array with all selected `value` props.
@@ -132,6 +199,44 @@ const basket = await groupMultiselect({
 });
 ```
 
+### Multi-Line Text
+
+The multi-line text component accepts multiple lines of text input. By default, pressing `Enter` twice submits the input.
+
+```js
+import { multiline } from '@clack/prompts';
+
+const bio = await multiline({
+  message: 'Tell us about yourself.',
+  placeholder: 'Start typing...',
+  validate(value) {
+    if (value.length === 0) return `value is required`;
+  },
+});
+```
+
+Set `showSubmit` to display an explicit submit button instead of double `Enter` submission:
+
+```js
+const bio = await multiline({
+  message: 'Tell us about yourself.',
+  showSubmit: true,
+});
+```
+
+### Path
+
+The path component offers filesystem path suggestions and returns the selected path as a string. When `directory: true` is set, only directories can be selected.
+
+```js
+import { path } from '@clack/prompts';
+
+const targetDir = await path({
+  message: 'Select an existing directory.',
+  directory: true,
+});
+```
+
 ### Spinner
 
 The spinner component surfaces a pending action, such as a long-running download or dependency installation.
@@ -157,7 +262,7 @@ p.start('Downloading archive');
 // Do download here
 p.advance(3, 'Downloading (30%)');
 // ...
-p.advance(8, 'Downloading (80%)');
+p.advance(5, 'Downloading (80%)');
 // ...
 p.stop('Archive downloaded');
 ```

package/node_modules/@clack/prompts/dist/index.d.mts

@@ -251,6 +251,20 @@ declare const cancel: (message?: string, opts?: CommonOptions) => void;
 declare const intro: (title?: string, opts?: CommonOptions) => void;
 declare const outro: (message?: string, opts?: CommonOptions) => void;
 
+interface TextOptions extends CommonOptions {
+    message: string;
+    placeholder?: string;
+    defaultValue?: string;
+    initialValue?: string;
+    validate?: (value: string | undefined) => string | Error | undefined;
+}
+declare const text: (opts: TextOptions) => Promise<string | symbol>;
+
+interface MultiLineOptions extends TextOptions {
+    showSubmit?: boolean;
+}
+declare const multiline: (opts: MultiLineOptions) => Promise<string | symbol>;
+
 interface MultiSelectOptions<Value> extends CommonOptions {
     message: string;
     options: Option<Value>[];
@@ -378,14 +392,5 @@ declare const taskLog: (opts: TaskLogOptions) => {
     success(message: string, opts?: TaskLogCompletionOptions): void;
 };
 
-interface TextOptions extends CommonOptions {
-    message: string;
-    placeholder?: string;
-    defaultValue?: string;
-    initialValue?: string;
-    validate?: (value: string | undefined) => string | Error | undefined;
-}
-declare const text: (opts: TextOptions) => Promise<string | symbol>;
-
-export { S_BAR, S_BAR_END, S_BAR_END_RIGHT, S_BAR_H, S_BAR_START, S_BAR_START_RIGHT, S_CHECKBOX_ACTIVE, S_CHECKBOX_INACTIVE, S_CHECKBOX_SELECTED, S_CONNECT_LEFT, S_CORNER_BOTTOM_LEFT, S_CORNER_BOTTOM_RIGHT, S_CORNER_TOP_LEFT, S_CORNER_TOP_RIGHT, S_ERROR, S_INFO, S_PASSWORD_MASK, S_RADIO_ACTIVE, S_RADIO_INACTIVE, S_STEP_ACTIVE, S_STEP_CANCEL, S_STEP_ERROR, S_STEP_SUBMIT, S_SUCCESS, S_WARN, autocomplete, autocompleteMultiselect, box, cancel, confirm, date, group, groupMultiselect, intro, isCI, isTTY, limitOptions, log, multiselect, note, outro, password, path, progress, select, selectKey, spinner, stream, symbol, symbolBar, taskLog, tasks, text, unicode, unicodeOr };
-export type { AutocompleteMultiSelectOptions, AutocompleteOptions, BoxAlignment, BoxOptions, CommonOptions, ConfirmOptions, DateOptions, GroupMultiSelectOptions, LimitOptionsParams, LogMessageOptions, MultiSelectOptions, NoteOptions, Option, PasswordOptions, PathOptions, ProgressOptions, ProgressResult, PromptGroup, PromptGroupAwaitedReturn, PromptGroupOptions, SelectKeyOptions, SelectOptions, SpinnerOptions, SpinnerResult, Task, TaskLogCompletionOptions, TaskLogMessageOptions, TaskLogOptions, TextOptions };
+export { S_BAR, S_BAR_END, S_BAR_END_RIGHT, S_BAR_H, S_BAR_START, S_BAR_START_RIGHT, S_CHECKBOX_ACTIVE, S_CHECKBOX_INACTIVE, S_CHECKBOX_SELECTED, S_CONNECT_LEFT, S_CORNER_BOTTOM_LEFT, S_CORNER_BOTTOM_RIGHT, S_CORNER_TOP_LEFT, S_CORNER_TOP_RIGHT, S_ERROR, S_INFO, S_PASSWORD_MASK, S_RADIO_ACTIVE, S_RADIO_INACTIVE, S_STEP_ACTIVE, S_STEP_CANCEL, S_STEP_ERROR, S_STEP_SUBMIT, S_SUCCESS, S_WARN, autocomplete, autocompleteMultiselect, box, cancel, confirm, date, group, groupMultiselect, intro, isCI, isTTY, limitOptions, log, multiline, multiselect, note, outro, password, path, progress, select, selectKey, spinner, stream, symbol, symbolBar, taskLog, tasks, text, unicode, unicodeOr };
+export type { AutocompleteMultiSelectOptions, AutocompleteOptions, BoxAlignment, BoxOptions, CommonOptions, ConfirmOptions, DateOptions, GroupMultiSelectOptions, LimitOptionsParams, LogMessageOptions, MultiLineOptions, MultiSelectOptions, NoteOptions, Option, PasswordOptions, PathOptions, ProgressOptions, ProgressResult, PromptGroup, PromptGroupAwaitedReturn, PromptGroupOptions, SelectKeyOptions, SelectOptions, SpinnerOptions, SpinnerResult, Task, TaskLogCompletionOptions, TaskLogMessageOptions, TaskLogOptions, TextOptions };