@inquirer/rawlist 5.1.0 → 5.2.1

package/README.md

@@ -72,7 +72,7 @@ const answer = await rawlist({
 | message  | `string`                | yes      | The question to ask                                                                                                               |
 | choices  | `Choice[]`              | yes      | List of the available choices.                                                                                                    |
 | loop     | `boolean`               | no       | Defaults to `true`. When set to `false`, the cursor will be constrained to the top and bottom of the choice list without looping. |
-| default  | `Value`                 | no       | The value of the choice to preselect. If the value is not found, no choice is preselected.                                       |
+| default  | `Value`                 | no       | The value of the choice to preselect. If the value is not found, no choice is preselected.                                        |
 | theme    | [See Theming](#Theming) | no       | Customize look of the prompt.                                                                                                     |
 
 `Separator` objects can be used in the `choices` array to render non-selectable lines in the choice list. By default it'll render a line, but you can provide the text as argument (`new Separator('-- Dependencies --')`). This option is often used to add labels to groups within long list of options.
@@ -87,6 +87,7 @@ type Choice<Value> = {
   name?: string;
   short?: string;
   key?: string;
+  description?: string;
 };
 ```
 
@@ -96,6 +97,7 @@ Here's each property:
 - `name`: This is the string displayed in the choice list.
 - `short`: Once the prompt is done (press enter), we'll use `short` if defined to render next to the question. By default we'll use `name`.
 - `key`: The key of the choice. Displayed as `key) name`.
+- `description`: Option description which appears below the list when the choice is selected.
 
 `choices` can also be an array of string, in which case the string will be used both as the `value` and the `name`.
 
@@ -115,6 +117,7 @@ type Theme = {
     message: (text: string, status: 'idle' | 'done' | 'loading') => string;
     error: (text: string) => string;
     highlight: (text: string) => string;
+    description: (text: string) => string;
   };
 };
 ```

package/dist/index.d.ts

@@ -1,16 +1,22 @@
 import { Separator, type Theme } from '@inquirer/core';
 import type { PartialDeep } from '@inquirer/type';
+type RawlistTheme = {
+    style: {
+        description: (text: string) => string;
+    };
+};
 type Choice<Value> = {
     value: Value;
     name?: string;
     short?: string;
     key?: string;
+    description?: string;
 };
 declare const _default: <Value>(config: {
     message: string;
     choices: readonly (Separator | Value | Choice<Value>)[];
     loop?: boolean | undefined;
-    theme?: PartialDeep<Theme> | undefined;
+    theme?: PartialDeep<Theme<RawlistTheme>> | undefined;
     default?: NoInfer<Value> | undefined;
 }, context?: import("@inquirer/type").Context) => Promise<Value>;
 export default _default;

package/dist/index.js

@@ -1,6 +1,11 @@
 import { createPrompt, useMemo, useState, useKeypress, usePrefix, isDownKey, isEnterKey, isUpKey, Separator, makeTheme, ValidationError, } from '@inquirer/core';
 import { styleText } from 'node:util';
 const numberRegex = /\d+/;
+const rawlistTheme = {
+    style: {
+        description: (text) => styleText('cyan', text),
+    },
+};
 function isSelectableChoice(choice) {
     return choice != null && !Separator.isSeparator(choice);
 }
@@ -25,6 +30,7 @@ function normalizeChoices(choices) {
             name,
             short: choice.short ?? name,
             key: choice.key ?? String(index),
+            description: choice.description,
         };
     });
 }
@@ -53,7 +59,7 @@ export default createPrompt((config, done) => {
         return defaultChoice?.key ?? '';
     });
     const [errorMsg, setError] = useState();
-    const theme = makeTheme(config.theme);
+    const theme = makeTheme(rawlistTheme, config.theme);
     const prefix = usePrefix({ status, theme });
     const bounds = useMemo(() => {
         const first = choices.findIndex(isSelectableChoice);
@@ -113,7 +119,7 @@ export default createPrompt((config, done) => {
             return ` ${choice.separator}`;
         }
         const line = `  ${choice.key}) ${choice.name}`;
-        if (choice.key === value.toLowerCase()) {
+        if (choice.key === value) {
             return theme.style.highlight(line);
         }
         return line;
@@ -123,9 +129,14 @@ export default createPrompt((config, done) => {
     if (errorMsg) {
         error = theme.style.error(errorMsg);
     }
+    const [selectedChoice] = getSelectedChoice(value, choices);
+    let description = '';
+    if (!errorMsg && selectedChoice?.description) {
+        description = theme.style.description(selectedChoice.description);
+    }
     return [
         `${prefix} ${message} ${value}`,
-        [choicesStr, error].filter(Boolean).join('\n'),
+        [choicesStr, error, description].filter(Boolean).join('\n'),
     ];
 });
 export { Separator } from '@inquirer/core';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inquirer/rawlist",
-  "version": "5.1.0",
+  "version": "5.2.1",
   "description": "Inquirer rawlist prompt",
   "keywords": [
     "answer",
@@ -42,42 +42,38 @@
     "zsh"
   ],
   "homepage": "https://github.com/SBoudrias/Inquirer.js/blob/main/packages/rawlist/README.md",
+  "license": "MIT",
+  "author": "Simon Boudrias <admin@simonboudrias.com>",
   "repository": {
     "type": "git",
     "url": "https://github.com/SBoudrias/Inquirer.js.git"
   },
-  "license": "MIT",
-  "author": "Simon Boudrias <admin@simonboudrias.com>",
-  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
   "type": "module",
+  "sideEffects": false,
   "exports": {
-    "./package.json": "./package.json",
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
-    }
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
   },
-  "files": [
-    "dist"
-  ],
   "scripts": {
     "tsc": "tsc"
   },
   "dependencies": {
-    "@inquirer/core": "^11.1.0",
-    "@inquirer/type": "^4.0.2"
+    "@inquirer/core": "^11.1.2",
+    "@inquirer/type": "^4.0.3"
   },
   "devDependencies": {
-    "@inquirer/testing": "^3.0.3",
-    "@repo/tsconfig": "0.0.0",
+    "@inquirer/testing": "^3.1.0",
     "typescript": "^5.9.3"
   },
-  "engines": {
-    "node": ">=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
   "peerDependencies": {
     "@types/node": ">=18"
   },
@@ -86,7 +82,10 @@
       "optional": true
     }
   },
+  "engines": {
+    "node": ">=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0"
+  },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "gitHead": "7eedd8e1de71764d0d30e762c97992ceb9f68ed3"
+  "gitHead": "53dbf6c492883546f6f9f2d5b9a78cbc00bd434c"
 }