@karmaniverous/stan-cli 0.10.3 → 0.11.0

package/dist/cli/{index-BO3K2S0m.js → index-CoyGQCX9.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import * as readline$1 from 'node:readline';
 import readline__default from 'node:readline';
-import { g as getDefaultExportFromCjs, r as requireEmojiRegex, a as requireColorConvert, o as onExit } from './stan.js';
+import { g as getDefaultExportFromCjs, r as requireIsFullwidthCodePoint, a as requireEmojiRegex, b as requireColorConvert, o as onExit } from './stan.js';
 import R from 'stream';
-import tty from 'node:tty';
+import { createRequire } from 'node:module';
 import process$1 from 'node:process';
 import { AsyncLocalStorage, AsyncResource } from 'node:async_hooks';
 import { stripVTControlCharacters } from 'node:util';
@@ -15,22 +15,33 @@ import os from 'node:os';
 import { randomUUID } from 'node:crypto';
 import require$$0$2 from 'buffer';
 import require$$1$1 from 'string_decoder';
-import 'node:events';
-import 'node:child_process';
 import 'node:fs';
 import 'node:fs/promises';
 import 'fs-extra';
 import 'node:url';
 import 'process';
+import 'node:child_process';
 import 'os';
 import 'path';
 import 'util';
 import 'events';
+import 'node:tty';
 import 'clipboardy';
-import 'node:module';
 
-const isUpKey = (key) => key.name === 'up';
-const isDownKey = (key) => key.name === 'down';
+const isUpKey = (key, keybindings = []) => 
+// The up key
+key.name === 'up' ||
+    // Vim keybinding: hjkl keys map to left/down/up/right
+    (keybindings.includes('vim') && key.name === 'k') ||
+    // Emacs keybinding: Ctrl+P means "previous" in Emacs navigation conventions
+    (keybindings.includes('emacs') && key.ctrl && key.name === 'p');
+const isDownKey = (key, keybindings = []) => 
+// The down key
+key.name === 'down' ||
+    // Vim keybinding: hjkl keys map to left/down/up/right
+    (keybindings.includes('vim') && key.name === 'j') ||
+    // Emacs keybinding: Ctrl+N means "next" in Emacs navigation conventions
+    (keybindings.includes('emacs') && key.ctrl && key.name === 'n');
 const isSpaceKey = (key) => key.name === 'space';
 const isBackspaceKey = (key) => key.name === 'backspace';
 const isTabKey = (key) => key.name === 'tab';
@@ -198,18 +209,21 @@ function useEffect(cb, depArray) {
     });
 }
 
+const require$1 = createRequire(import.meta.url);
+function __require() { return require$1("node:tty"); }
+
 var yoctocolorsCjs;
 var hasRequiredYoctocolorsCjs;
 
 function requireYoctocolorsCjs () {
 	if (hasRequiredYoctocolorsCjs) return yoctocolorsCjs;
 	hasRequiredYoctocolorsCjs = 1;
-	const tty$1 = tty; // eslint-disable-line unicorn/prefer-module
+	const tty = __require(); // eslint-disable-line unicorn/prefer-module
 
 	// eslint-disable-next-line no-warning-comments
 	// TODO: Use a better method when it's added to Node.js (https://github.com/nodejs/node/pull/40240)
 	// Lots of optionals here to support Deno.
-	const hasColors = tty$1?.WriteStream?.prototype?.hasColors?.() ?? false;
+	const hasColors = tty?.WriteStream?.prototype?.hasColors?.() ?? false;
 
 	const format = (open, close) => {
 		if (!hasColors) {
@@ -814,66 +828,6 @@ function requireStripAnsi () {
 	return stripAnsi;
 }
 
-var isFullwidthCodePoint = {exports: {}};
-
-/* eslint-disable yoda */
-
-var hasRequiredIsFullwidthCodePoint;
-
-function requireIsFullwidthCodePoint () {
-	if (hasRequiredIsFullwidthCodePoint) return isFullwidthCodePoint.exports;
-	hasRequiredIsFullwidthCodePoint = 1;
-
-	const isFullwidthCodePoint$1 = codePoint => {
-		if (Number.isNaN(codePoint)) {
-			return false;
-		}
-
-		// Code points are derived from:
-		// http://www.unix.org/Public/UNIDATA/EastAsianWidth.txt
-		if (
-			codePoint >= 0x1100 && (
-				codePoint <= 0x115F || // Hangul Jamo
-				codePoint === 0x2329 || // LEFT-POINTING ANGLE BRACKET
-				codePoint === 0x232A || // RIGHT-POINTING ANGLE BRACKET
-				// CJK Radicals Supplement .. Enclosed CJK Letters and Months
-				(0x2E80 <= codePoint && codePoint <= 0x3247 && codePoint !== 0x303F) ||
-				// Enclosed CJK Letters and Months .. CJK Unified Ideographs Extension A
-				(0x3250 <= codePoint && codePoint <= 0x4DBF) ||
-				// CJK Unified Ideographs .. Yi Radicals
-				(0x4E00 <= codePoint && codePoint <= 0xA4C6) ||
-				// Hangul Jamo Extended-A
-				(0xA960 <= codePoint && codePoint <= 0xA97C) ||
-				// Hangul Syllables
-				(0xAC00 <= codePoint && codePoint <= 0xD7A3) ||
-				// CJK Compatibility Ideographs
-				(0xF900 <= codePoint && codePoint <= 0xFAFF) ||
-				// Vertical Forms
-				(0xFE10 <= codePoint && codePoint <= 0xFE19) ||
-				// CJK Compatibility Forms .. Small Form Variants
-				(0xFE30 <= codePoint && codePoint <= 0xFE6B) ||
-				// Halfwidth and Fullwidth Forms
-				(0xFF01 <= codePoint && codePoint <= 0xFF60) ||
-				(0xFFE0 <= codePoint && codePoint <= 0xFFE6) ||
-				// Kana Supplement
-				(0x1B000 <= codePoint && codePoint <= 0x1B001) ||
-				// Enclosed Ideographic Supplement
-				(0x1F200 <= codePoint && codePoint <= 0x1F251) ||
-				// CJK Unified Ideographs Extension B .. Tertiary Ideographic Plane
-				(0x20000 <= codePoint && codePoint <= 0x3FFFD)
-			)
-		) {
-			return true;
-		}
-
-		return false;
-	};
-
-	isFullwidthCodePoint.exports = isFullwidthCodePoint$1;
-	isFullwidthCodePoint.exports.default = isFullwidthCodePoint$1;
-	return isFullwidthCodePoint.exports;
-}
-
 var hasRequiredStringWidth;
 
 function requireStringWidth () {
@@ -1849,8 +1803,12 @@ const checkboxTheme = {
         disabledChoice: (text) => colors.dim(`- ${text}`),
         renderSelectedChoices: (selectedChoices) => selectedChoices.map((choice) => choice.short).join(', '),
         description: (text) => colors.cyan(text),
+        keysHelpTip: (keys) => keys
+            .map(([key, action]) => `${colors.bold(key)} ${colors.dim(action)}`)
+            .join(colors.dim(' • ')),
     },
-    helpMode: 'auto',
+    helpMode: 'always',
+    keybindings: [],
 };
 function isSelectable$2(item) {
     return !Separator.isSeparator(item) && !item.disabled;
@@ -1875,6 +1833,7 @@ function normalizeChoices$4(choices) {
                 value: choice,
                 name: choice,
                 short: choice,
+                checkedName: choice,
                 disabled: false,
                 checked: false,
             };
@@ -1884,6 +1843,7 @@ function normalizeChoices$4(choices) {
             value: choice.value,
             name,
             short: choice.short ?? name,
+            checkedName: choice.checkedName ?? name,
             disabled: choice.disabled ?? false,
             checked: choice.checked ?? false,
         };
@@ -1894,10 +1854,12 @@ function normalizeChoices$4(choices) {
     });
 }
 var checkbox = createPrompt((config, done) => {
-    const { instructions, pageSize = 7, loop = true, required, validate = () => true, } = config;
+    const { 
+    // eslint-disable-next-line @typescript-eslint/no-deprecated
+    instructions, pageSize = 7, loop = true, required, validate = () => true, } = config;
     const shortcuts = { all: 'a', invert: 'i', ...config.shortcuts };
     const theme = makeTheme(checkboxTheme, config.theme);
-    const firstRender = useRef(true);
+    const { keybindings } = theme;
     const [status, setStatus] = useState('idle');
     const prefix = usePrefix({ status, theme });
     const [items, setItems] = useState(normalizeChoices$4(config.choices));
@@ -1910,7 +1872,6 @@ var checkbox = createPrompt((config, done) => {
         return { first, last };
     }, [items]);
     const [active, setActive] = useState(bounds.first);
-    const [showHelpTip, setShowHelpTip] = useState(true);
     const [errorMsg, setError] = useState();
     useKeypress(async (key) => {
         if (isEnterKey(key)) {
@@ -1927,11 +1888,11 @@ var checkbox = createPrompt((config, done) => {
                 setError(isValid || 'You must select a valid value');
             }
         }
-        else if (isUpKey(key) || isDownKey(key)) {
+        else if (isUpKey(key, keybindings) || isDownKey(key, keybindings)) {
             if (loop ||
-                (isUpKey(key) && active !== bounds.first) ||
-                (isDownKey(key) && active !== bounds.last)) {
-                const offset = isUpKey(key) ? -1 : 1;
+                (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;
@@ -1941,7 +1902,6 @@ var checkbox = createPrompt((config, done) => {
         }
         else if (isSpaceKey(key)) {
             setError(undefined);
-            setShowHelpTip(false);
             setItems(items.map((choice, i) => (i === active ? toggle(choice) : choice)));
         }
         else if (key.name === shortcuts.all) {
@@ -1985,9 +1945,10 @@ var checkbox = createPrompt((config, done) => {
                 description = item.description;
             }
             const checkbox = item.checked ? theme.icon.checked : theme.icon.unchecked;
+            const name = item.checked ? item.checkedName : item.name;
             const color = isActive ? theme.style.highlight : (x) => x;
             const cursor = isActive ? theme.icon.cursor : ' ';
-            return color(`${cursor}${checkbox} ${item.name}`);
+            return color(`${cursor}${checkbox} ${name}`);
         },
         pageSize,
         loop,
@@ -1995,44 +1956,39 @@ var checkbox = createPrompt((config, done) => {
     if (status === 'done') {
         const selection = items.filter(isChecked);
         const answer = theme.style.answer(theme.style.renderSelectedChoices(selection, items));
-        return `${prefix} ${message} ${answer}`;
+        return [prefix, message, answer].filter(Boolean).join(' ');
     }
-    let helpTipTop = '';
-    let helpTipBottom = '';
-    if (theme.helpMode === 'always' ||
-        (theme.helpMode === 'auto' &&
-            showHelpTip &&
-            (instructions === undefined || instructions))) {
+    let helpLine;
+    // eslint-disable-next-line @typescript-eslint/no-deprecated
+    if (theme.helpMode !== 'never' && instructions !== false) {
         if (typeof instructions === 'string') {
-            helpTipTop = instructions;
+            helpLine = instructions;
         }
         else {
             const keys = [
-                `${theme.style.key('space')} to select`,
-                shortcuts.all ? `${theme.style.key(shortcuts.all)} to toggle all` : '',
-                shortcuts.invert
-                    ? `${theme.style.key(shortcuts.invert)} to invert selection`
-                    : '',
-                `and ${theme.style.key('enter')} to proceed`,
+                ['↑↓', 'navigate'],
+                ['space', 'select'],
             ];
-            helpTipTop = ` (Press ${keys.filter((key) => key !== '').join(', ')})`;
-        }
-        if (items.length > pageSize &&
-            (theme.helpMode === 'always' ||
-                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
-                (theme.helpMode === 'auto' && firstRender.current))) {
-            helpTipBottom = `\n${theme.style.help('(Use arrow keys to reveal more choices)')}`;
-            firstRender.current = false;
+            if (shortcuts.all)
+                keys.push([shortcuts.all, 'all']);
+            if (shortcuts.invert)
+                keys.push([shortcuts.invert, 'invert']);
+            keys.push(['⏎', 'submit']);
+            helpLine = theme.style.keysHelpTip(keys);
         }
     }
-    const choiceDescription = description
-        ? `\n${theme.style.description(description)}`
-        : ``;
-    let error = '';
-    if (errorMsg) {
-        error = `\n${theme.style.error(errorMsg)}`;
-    }
-    return `${prefix} ${message}${helpTipTop}\n${page}${helpTipBottom}${choiceDescription}${error}${cursorHide}`;
+    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}`;
 });
 
 var lib$1 = {};
@@ -15833,8 +15789,11 @@ const searchTheme = {
         disabled: (text) => colors.dim(`- ${text}`),
         searchTerm: (text) => colors.cyan(text),
         description: (text) => colors.cyan(text),
+        keysHelpTip: (keys) => keys
+            .map(([key, action]) => `${colors.bold(key)} ${colors.dim(action)}`)
+            .join(colors.dim(' • ')),
     },
-    helpMode: 'auto',
+    helpMode: 'always',
 };
 function isSelectable$1(item) {
     return !Separator.isSeparator(item) && !item.disabled;
@@ -15867,7 +15826,6 @@ function normalizeChoices$1(choices) {
 var search = createPrompt((config, done) => {
     const { pageSize = 7, validate = () => true } = config;
     const theme = makeTheme(searchTheme, config.theme);
-    const firstRender = useRef(true);
     const [status, setStatus] = useState('loading');
     const [searchTerm, setSearchTerm] = useState('');
     const [searchResults, setSearchResults] = useState([]);
@@ -15956,18 +15914,22 @@ var search = createPrompt((config, done) => {
         }
     });
     const message = theme.style.message(config.message, status);
-    if (active > 0) {
-        firstRender.current = false;
-    }
-    let helpTip = '';
-    if (searchResults.length > 1 &&
-        (theme.helpMode === 'always' || (theme.helpMode === 'auto' && firstRender.current))) {
-        helpTip =
-            searchResults.length > pageSize
-                ? `\n${theme.style.help(`(${config.instructions?.pager ?? 'Use arrow keys to reveal more choices'})`)}`
-                : `\n${theme.style.help(`(${config.instructions?.navigation ?? 'Use arrow keys'})`)}`;
+    let helpLine;
+    // eslint-disable-next-line @typescript-eslint/no-deprecated
+    if (theme.helpMode !== 'never') {
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
+        if (config.instructions) {
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
+            const { pager, navigation } = config.instructions;
+            helpLine = theme.style.help(searchResults.length > pageSize ? pager : navigation);
+        }
+        else {
+            helpLine = theme.style.keysHelpTip([
+                ['↑↓', 'navigate'],
+                ['⏎', 'select'],
+            ]);
+        }
     }
-    // TODO: What to do if no results are found? Should we display a message?
     const page = usePagination({
         items: searchResults,
         active,
@@ -15995,19 +15957,26 @@ var search = createPrompt((config, done) => {
     }
     let searchStr;
     if (status === 'done' && selectedChoice) {
-        const answer = selectedChoice.short;
-        return `${prefix} ${message} ${theme.style.answer(answer)}`;
+        return [prefix, message, theme.style.answer(selectedChoice.short)]
+            .filter(Boolean)
+            .join(' ')
+            .trimEnd();
     }
     else {
         searchStr = theme.style.searchTerm(searchTerm);
     }
-    const choiceDescription = selectedChoice?.description
-        ? `\n${theme.style.description(selectedChoice.description)}`
-        : ``;
-    return [
-        [prefix, message, searchStr].filter(Boolean).join(' '),
-        `${error ?? page}${helpTip}${choiceDescription}`,
-    ];
+    const description = selectedChoice?.description;
+    const header = [prefix, message, searchStr].filter(Boolean).join(' ').trimEnd();
+    const body = [
+        error ?? page,
+        ' ',
+        description ? theme.style.description(description) : '',
+        helpLine,
+    ]
+        .filter(Boolean)
+        .join('\n')
+        .trimEnd();
+    return [header, body];
 });
 
 const selectTheme = {
@@ -16015,9 +15984,13 @@ const selectTheme = {
     style: {
         disabled: (text) => colors.dim(`- ${text}`),
         description: (text) => colors.cyan(text),
+        keysHelpTip: (keys) => keys
+            .map(([key, action]) => `${colors.bold(key)} ${colors.dim(action)}`)
+            .join(colors.dim(' • ')),
     },
-    helpMode: 'auto',
+    helpMode: 'always',
     indexMode: 'hidden',
+    keybindings: [],
 };
 function isSelectable(item) {
     return !Separator.isSeparator(item) && !item.disabled;
@@ -16049,11 +16022,14 @@ function normalizeChoices(choices) {
 }
 var select = createPrompt((config, done) => {
     const { loop = true, pageSize = 7 } = config;
-    const firstRender = useRef(true);
     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(isSelectable);
@@ -16077,12 +16053,12 @@ var select = createPrompt((config, done) => {
             setStatus('done');
             done(selectedChoice.value);
         }
-        else if (isUpKey(key) || isDownKey(key)) {
+        else if (isUpKey(key, keybindings) || isDownKey(key, keybindings)) {
             rl.clearLine(0);
             if (loop ||
-                (isUpKey(key) && active !== bounds.first) ||
-                (isDownKey(key) && active !== bounds.last)) {
-                const offset = isUpKey(key) ? -1 : 1;
+                (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;
@@ -16111,8 +16087,7 @@ var select = createPrompt((config, done) => {
         else if (isBackspaceKey(key)) {
             rl.clearLine(0);
         }
-        else {
-            // Default to search
+        else if (searchEnabled) {
             const searchTerm = rl.line.toLowerCase();
             const matchIndex = items.findIndex((item) => {
                 if (Separator.isSeparator(item) || !isSelectable(item))
@@ -16131,16 +16106,20 @@ var select = createPrompt((config, done) => {
         clearTimeout(searchTimeoutRef.current);
     }, []);
     const message = theme.style.message(config.message, status);
-    let helpTipTop = '';
-    let helpTipBottom = '';
-    if (theme.helpMode === 'always' ||
-        (theme.helpMode === 'auto' && firstRender.current)) {
-        firstRender.current = false;
-        if (items.length > pageSize) {
-            helpTipBottom = `\n${theme.style.help(`(${config.instructions?.pager ?? 'Use arrow keys to reveal more choices'})`)}`;
+    let helpLine;
+    // eslint-disable-next-line @typescript-eslint/no-deprecated
+    if (theme.helpMode !== 'never') {
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
+        if (config.instructions) {
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
+            const { pager, navigation } = config.instructions;
+            helpLine = theme.style.help(items.length > pageSize ? pager : navigation);
         }
         else {
-            helpTipTop = theme.style.help(`(${config.instructions?.navigation ?? 'Use arrow keys'})`);
+            helpLine = theme.style.keysHelpTip([
+                ['↑↓', 'navigate'],
+                ['⏎', 'select'],
+            ]);
         }
     }
     let separatorCount = 0;
@@ -16165,12 +16144,22 @@ var select = createPrompt((config, done) => {
         loop,
     });
     if (status === 'done') {
-        return `${prefix} ${message} ${theme.style.answer(selectedChoice.short)}`;
+        return [prefix, message, theme.style.answer(selectedChoice.short)]
+            .filter(Boolean)
+            .join(' ');
     }
-    const choiceDescription = selectedChoice.description
-        ? `\n${theme.style.description(selectedChoice.description)}`
-        : ``;
-    return `${[prefix, message, helpTipTop].filter(Boolean).join(' ')}\n${page}${helpTipBottom}${choiceDescription}${cursorHide}`;
+    const { description } = selectedChoice;
+    const lines = [
+        [prefix, message].filter(Boolean).join(' '),
+        page,
+        ' ',
+        description ? theme.style.description(description) : '',
+        helpLine,
+    ]
+        .filter(Boolean)
+        .join('\n')
+        .trimEnd();
+    return `${lines}${cursorHide}`;
 });
 
 var cjs = {};