@inquirer/select 5.1.1 → 5.1.2

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+import { Separator, type Theme, type Keybinding } from '@inquirer/core';
+import type { PartialDeep } from '@inquirer/type';
+type SelectTheme = {
+    icon: {
+        cursor: string;
+    };
+    style: {
+        disabled: (text: string) => string;
+        description: (text: string) => string;
+        keysHelpTip: (keys: [key: string, action: string][]) => string | undefined;
+    };
+    i18n: {
+        disabledError: string;
+    };
+    indexMode: 'hidden' | 'number';
+    keybindings: ReadonlyArray<Keybinding>;
+};
+type Choice<Value> = {
+    value: Value;
+    name?: string;
+    description?: string;
+    short?: string;
+    disabled?: boolean | string;
+    type?: never;
+};
+declare const _default: <Value>(config: {
+    message: string;
+    choices: readonly (Separator | Value | Choice<Value>)[];
+    pageSize?: number | undefined;
+    loop?: boolean | undefined;
+    default?: NoInfer<Value> | undefined;
+    theme?: PartialDeep<Theme<SelectTheme>> | undefined;
+}, context?: import("@inquirer/type").Context) => Promise<Value>;
+export default _default;
+export { Separator } from '@inquirer/core';

package/dist/index.js

@@ -0,0 +1,191 @@
+import { createPrompt, useState, useKeypress, usePrefix, usePagination, useRef, useMemo, useEffect, isBackspaceKey, isEnterKey, isUpKey, isDownKey, isNumberKey, Separator, ValidationError, makeTheme, } from '@inquirer/core';
+import { cursorHide } from '@inquirer/ansi';
+import { styleText } from 'node:util';
+import figures from '@inquirer/figures';
+const selectTheme = {
+    icon: { cursor: figures.pointer },
+    style: {
+        disabled: (text) => styleText('dim', text),
+        description: (text) => styleText('cyan', text),
+        keysHelpTip: (keys) => keys
+            .map(([key, action]) => `${styleText('bold', key)} ${styleText('dim', action)}`)
+            .join(styleText('dim', ' • ')),
+    },
+    i18n: { disabledError: 'This option is disabled and cannot be selected.' },
+    indexMode: 'hidden',
+    keybindings: [],
+};
+function isSelectable(item) {
+    return !Separator.isSeparator(item) && !item.disabled;
+}
+function isNavigable(item) {
+    return !Separator.isSeparator(item);
+}
+function normalizeChoices(choices) {
+    return choices.map((choice) => {
+        if (Separator.isSeparator(choice))
+            return choice;
+        if (typeof choice !== 'object' || choice === null || !('value' in choice)) {
+            // It's a raw value (string, number, etc.)
+            const name = String(choice);
+            return {
+                value: choice,
+                name,
+                short: name,
+                disabled: false,
+            };
+        }
+        const name = choice.name ?? String(choice.value);
+        const normalizedChoice = {
+            value: choice.value,
+            name,
+            short: choice.short ?? name,
+            disabled: choice.disabled ?? false,
+        };
+        if (choice.description) {
+            normalizedChoice.description = choice.description;
+        }
+        return normalizedChoice;
+    });
+}
+export default createPrompt((config, done) => {
+    const { loop = true, pageSize = 7 } = config;
+    const theme = makeTheme(selectTheme, config.theme);
+    const { keybindings } = theme;
+    const [status, setStatus] = useState('idle');
+    const prefix = usePrefix({ status, theme });
+    const searchTimeoutRef = useRef();
+    // Vim keybindings (j/k) conflict with typing those letters in search,
+    // so search must be disabled when vim bindings are enabled
+    const searchEnabled = !keybindings.includes('vim');
+    const items = useMemo(() => normalizeChoices(config.choices), [config.choices]);
+    const bounds = useMemo(() => {
+        const first = items.findIndex(isNavigable);
+        const last = items.findLastIndex(isNavigable);
+        if (first === -1) {
+            throw new ValidationError('[select prompt] No selectable choices. All choices are disabled.');
+        }
+        return { first, last };
+    }, [items]);
+    const defaultItemIndex = useMemo(() => {
+        if (!('default' in config))
+            return -1;
+        return items.findIndex((item) => isSelectable(item) && item.value === config.default);
+    }, [config.default, items]);
+    const [active, setActive] = useState(defaultItemIndex === -1 ? bounds.first : defaultItemIndex);
+    // Safe to assume the cursor position always point to a Choice.
+    const selectedChoice = items[active];
+    const [errorMsg, setError] = useState();
+    useKeypress((key, rl) => {
+        clearTimeout(searchTimeoutRef.current);
+        if (errorMsg) {
+            setError(undefined);
+        }
+        if (isEnterKey(key)) {
+            if (selectedChoice.disabled) {
+                setError(theme.i18n.disabledError);
+            }
+            else {
+                setStatus('done');
+                done(selectedChoice.value);
+            }
+        }
+        else if (isUpKey(key, keybindings) || isDownKey(key, keybindings)) {
+            rl.clearLine(0);
+            if (loop ||
+                (isUpKey(key, keybindings) && active !== bounds.first) ||
+                (isDownKey(key, keybindings) && active !== bounds.last)) {
+                const offset = isUpKey(key, keybindings) ? -1 : 1;
+                let next = active;
+                do {
+                    next = (next + offset + items.length) % items.length;
+                } while (!isNavigable(items[next]));
+                setActive(next);
+            }
+        }
+        else if (isNumberKey(key) && !Number.isNaN(Number(rl.line))) {
+            const selectedIndex = Number(rl.line) - 1;
+            // Find the nth item (ignoring separators)
+            let selectableIndex = -1;
+            const position = items.findIndex((item) => {
+                if (Separator.isSeparator(item))
+                    return false;
+                selectableIndex++;
+                return selectableIndex === selectedIndex;
+            });
+            const item = items[position];
+            if (item != null && isSelectable(item)) {
+                setActive(position);
+            }
+            searchTimeoutRef.current = setTimeout(() => {
+                rl.clearLine(0);
+            }, 700);
+        }
+        else if (isBackspaceKey(key)) {
+            rl.clearLine(0);
+        }
+        else if (searchEnabled) {
+            const searchTerm = rl.line.toLowerCase();
+            const matchIndex = items.findIndex((item) => {
+                if (Separator.isSeparator(item) || !isSelectable(item))
+                    return false;
+                return item.name.toLowerCase().startsWith(searchTerm);
+            });
+            if (matchIndex !== -1) {
+                setActive(matchIndex);
+            }
+            searchTimeoutRef.current = setTimeout(() => {
+                rl.clearLine(0);
+            }, 700);
+        }
+    });
+    useEffect(() => () => {
+        clearTimeout(searchTimeoutRef.current);
+    }, []);
+    const message = theme.style.message(config.message, status);
+    const helpLine = theme.style.keysHelpTip([
+        ['↑↓', 'navigate'],
+        ['⏎', 'select'],
+    ]);
+    let separatorCount = 0;
+    const page = usePagination({
+        items,
+        active,
+        renderItem({ item, isActive, index }) {
+            if (Separator.isSeparator(item)) {
+                separatorCount++;
+                return ` ${item.separator}`;
+            }
+            const cursor = isActive ? theme.icon.cursor : ' ';
+            const indexLabel = theme.indexMode === 'number' ? `${index + 1 - separatorCount}. ` : '';
+            if (item.disabled) {
+                const disabledLabel = typeof item.disabled === 'string' ? item.disabled : '(disabled)';
+                const disabledCursor = isActive ? theme.icon.cursor : '-';
+                return theme.style.disabled(`${disabledCursor} ${indexLabel}${item.name} ${disabledLabel}`);
+            }
+            const color = isActive ? theme.style.highlight : (x) => x;
+            return color(`${cursor} ${indexLabel}${item.name}`);
+        },
+        pageSize,
+        loop,
+    });
+    if (status === 'done') {
+        return [prefix, message, theme.style.answer(selectedChoice.short)]
+            .filter(Boolean)
+            .join(' ');
+    }
+    const { description } = selectedChoice;
+    const lines = [
+        [prefix, message].filter(Boolean).join(' '),
+        page,
+        ' ',
+        description ? theme.style.description(description) : '',
+        errorMsg ? theme.style.error(errorMsg) : '',
+        helpLine,
+    ]
+        .filter(Boolean)
+        .join('\n')
+        .trimEnd();
+    return `${lines}${cursorHide}`;
+});
+export { Separator } from '@inquirer/core';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inquirer/select",
-  "version": "5.1.1",
+  "version": "5.1.2",
   "description": "Inquirer select/list prompt",
   "keywords": [
     "answer",
@@ -67,10 +67,10 @@
     "tsc": "tsc"
   },
   "dependencies": {
-    "@inquirer/ansi": "^2.0.3",
-    "@inquirer/core": "^11.1.6",
-    "@inquirer/figures": "^2.0.3",
-    "@inquirer/type": "^4.0.3"
+    "@inquirer/ansi": "^2.0.4",
+    "@inquirer/core": "^11.1.7",
+    "@inquirer/figures": "^2.0.4",
+    "@inquirer/type": "^4.0.4"
   },
   "devDependencies": {
     "typescript": "^5.9.3"
@@ -88,5 +88,5 @@
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "gitHead": "1ce03199b82b4a5fb6f7c97ce374c6da5087444f"
+  "gitHead": "b218fcc4afe888a58957aa78c9a032f9bd2d60cb"
 }