@emeryld/manager 0.6.6 → 0.7.0

package/dist/helper-cli/prompts.js

@@ -53,9 +53,16 @@ async function promptWithReadline(entries, title) {
         rl.close();
     }
 }
-function formatInteractiveLines(state, selectedIndex, title) {
+function formatInteractiveLines(state, selectedIndex, title, searchState) {
     const heading = pageHeading(title, state.page, state.pageCount);
     const lines = [heading];
+    if (searchState?.active) {
+        const queryLabel = searchState.query || '(type to filter)';
+        const statusLabel = searchState.hasResults
+            ? '(enter to run top match)'
+            : '(no matches yet)';
+        lines.push(colors.dim(`Search: ${queryLabel} ${statusLabel}`));
+    }
     state.options.forEach((option, index) => {
         const isSelected = index === selectedIndex;
         const pointer = isSelected ? `${colors.green('➤')} ` : '';
@@ -69,7 +76,12 @@ function formatInteractiveLines(state, selectedIndex, title) {
                 : isSelected
                     ? colors.green(option.entry.displayName)
                     : option.entry.displayName;
-            lines.push(`${pointer}${numberLabel}. ${option.entry.emoji} ${label} ${colors.dim(option.entry.metaLabel)}`);
+            const runHint = searchState?.active &&
+                searchState.hasResults &&
+                index === 0
+                ? colors.dim(' (enter to run)')
+                : '';
+            lines.push(`${pointer}${numberLabel}. ${option.entry.emoji} ${label} ${colors.dim(option.entry.metaLabel)}${runHint}`);
             return;
         }
         const icon = option.action === 'back'
@@ -85,8 +97,17 @@ function formatInteractiveLines(state, selectedIndex, title) {
         const navLabel = option.enabled ? baseLabel : colors.dim(baseLabel);
         lines.push(`${pointer}${numberLabel}. ${icon} ${navLabel}`);
     });
+    if (searchState?.active && !searchState.hasResults) {
+        lines.push(colors.yellow('No scripts match your search.'));
+    }
     lines.push('');
-    lines.push(colors.dim(`Use ↑/↓ (or j/k) to move, 1-${PAGE_SIZE} to run, ${PREVIOUS_KEY} prev page (when shown), ${NEXT_KEY} next page (when shown), ${BACK_KEY} back, Enter to confirm, Esc/Ctrl+C to exit.`));
+    lines.push(colors.dim(`Use ↑/↓ (or j/k) to move, 1-${PAGE_SIZE} to run, ${PREVIOUS_KEY} prev page (when shown), ${NEXT_KEY} next page (when shown), ${BACK_KEY} back, Enter to run, Space to filter, Esc/Ctrl+C to exit.`));
+    if (searchState?.active) {
+        lines.push(colors.dim('Search mode: type to filter, Backspace edits the query, Esc returns to navigation, Enter runs the highlighted entry.'));
+    }
+    else {
+        lines.push(colors.dim('Press Space to start typing a filter.'));
+    }
     return lines;
 }
 function renderInteractiveList(lines, previousLineCount) {
@@ -109,9 +130,15 @@ export async function promptForScript(entries, title) {
     }
     process.stdout.write('\x1b[?25l');
     return new Promise((resolve) => {
+        const baseEntries = entries;
+        let filteredEntries = baseEntries;
         let selectedIndex = 0;
         let renderedLines = 0;
-        let state = buildVisibleOptions(entries, 0);
+        let state = buildVisibleOptions(filteredEntries, 0);
+        let searchActive = false;
+        let searchQuery = '';
+        let pageBeforeSearch = 0;
+        let selectionBeforeSearch = 0;
         const cleanup = () => {
             if (renderedLines > 0) {
                 process.stdout.write(`\x1b[${renderedLines}A`);
@@ -135,10 +162,24 @@ export async function promptForScript(entries, title) {
             console.log();
             resolve(undefined);
         };
-        const setPage = (page) => {
-            state = buildVisibleOptions(entries, page);
+        const rebuildState = (page) => {
+            state = buildVisibleOptions(filteredEntries, page);
             selectedIndex = Math.min(selectedIndex, state.options.length - 1);
             selectedIndex = Math.max(0, selectedIndex);
+        };
+        const render = () => {
+            const searchState = searchActive
+                ? {
+                    active: true,
+                    query: searchQuery.trim(),
+                    hasResults: filteredEntries.length > 0,
+                }
+                : undefined;
+            const lines = formatInteractiveLines(state, selectedIndex, title, searchState);
+            renderedLines = renderInteractiveList(lines, renderedLines);
+        };
+        const setPage = (page) => {
+            rebuildState(page);
             render();
         };
         const handleNav = (option) => {
@@ -167,9 +208,47 @@ export async function promptForScript(entries, title) {
             }
             handleNav(option);
         };
-        const render = () => {
-            const lines = formatInteractiveLines(state, selectedIndex, title);
-            renderedLines = renderInteractiveList(lines, renderedLines);
+        const matchesSearchTerm = (entry, term) => {
+            const haystack = [
+                entry.displayName,
+                entry.metaLabel,
+                entry.script ?? '',
+                entry.description ?? '',
+            ]
+                .join(' ')
+                .toLowerCase();
+            return haystack.includes(term);
+        };
+        const applySearch = () => {
+            const normalized = searchQuery.trim().toLowerCase();
+            if (normalized.length > 0) {
+                filteredEntries = baseEntries.filter((entry) => matchesSearchTerm(entry, normalized));
+            }
+            else {
+                filteredEntries = baseEntries;
+            }
+            rebuildState(0);
+            selectedIndex = 0;
+            render();
+        };
+        const enterSearchMode = () => {
+            if (searchActive)
+                return;
+            pageBeforeSearch = state.page;
+            selectionBeforeSearch = selectedIndex;
+            searchActive = true;
+            searchQuery = '';
+            applySearch();
+        };
+        const exitSearchMode = () => {
+            if (!searchActive)
+                return;
+            searchActive = false;
+            searchQuery = '';
+            filteredEntries = baseEntries;
+            state = buildVisibleOptions(filteredEntries, pageBeforeSearch);
+            selectedIndex = Math.min(selectionBeforeSearch, state.options.length - 1);
+            render();
         };
         const onData = (buffer) => {
             const isArrowUp = buffer.equals(Buffer.from([0x1b, 0x5b, 0x41]));
@@ -177,10 +256,25 @@ export async function promptForScript(entries, title) {
             const isCtrlC = buffer.length === 1 && buffer[0] === 0x03;
             const isEnter = buffer.length === 1 && (buffer[0] === 0x0d || buffer[0] === 0x0a);
             const isEscape = buffer.length === 1 && buffer[0] === 0x1b;
-            if (isCtrlC || isEscape) {
+            const isBackspace = buffer.length === 1 && (buffer[0] === 0x7f || buffer[0] === 0x08);
+            const isPrintable = buffer.length === 1 && buffer[0] >= 0x20 && buffer[0] <= 0x7e;
+            const isSpace = buffer.length === 1 && buffer[0] === 0x20;
+            if (isCtrlC) {
                 cleanup();
                 process.exit(1);
             }
+            if (isEscape) {
+                if (searchActive) {
+                    exitSearchMode();
+                    return;
+                }
+                cleanup();
+                process.exit(1);
+            }
+            if (!searchActive && isSpace) {
+                enterSearchMode();
+                return;
+            }
             if (isArrowUp ||
                 (buffer.length === 1 && (buffer[0] === 0x6b || buffer[0] === 0x4b))) {
                 selectedIndex =
@@ -195,7 +289,29 @@ export async function promptForScript(entries, title) {
                 return;
             }
             if (isEnter) {
-                activateOption(state.options[selectedIndex]);
+                const option = state.options[selectedIndex];
+                if (option)
+                    activateOption(option);
+                else
+                    process.stdout.write('\x07');
+                return;
+            }
+            if (searchActive) {
+                if (isBackspace) {
+                    if (searchQuery.length > 0) {
+                        searchQuery = searchQuery.slice(0, -1);
+                        applySearch();
+                    }
+                    else {
+                        //exitSearchMode()
+                    }
+                    return;
+                }
+                if (isPrintable) {
+                    searchQuery += String.fromCharCode(buffer[0]);
+                    applySearch();
+                    return;
+                }
                 return;
             }
             if (buffer.length === 1 && buffer[0] >= 0x30 && buffer[0] <= 0x39) {
@@ -211,17 +327,19 @@ export async function promptForScript(entries, title) {
                 ((buffer[0] >= 0x41 && buffer[0] <= 0x5a) ||
                     (buffer[0] >= 0x61 && buffer[0] <= 0x7a))) {
                 const char = String.fromCharCode(buffer[0]).toLowerCase();
-                const foundIndex = entries.findIndex((entry) => entry.displayName.toLowerCase().startsWith(char));
+                const foundIndex = baseEntries.findIndex((entry) => entry.displayName.toLowerCase().startsWith(char));
                 if (foundIndex !== -1) {
                     const page = Math.floor(foundIndex / PAGE_SIZE);
-                    state = buildVisibleOptions(entries, page);
+                    state = buildVisibleOptions(filteredEntries, page);
                     selectedIndex = foundIndex % PAGE_SIZE;
                     render();
                 }
                 else {
                     process.stdout.write('\x07');
                 }
+                return;
             }
+            process.stdout.write('\x07');
         };
         input.on('data', onData);
         render();

package/dist/helper-cli.js

@@ -14,7 +14,7 @@ export async function runHelperCli({ scripts, title = 'Helper CLI', argv = proce
     const [firstArg, ...restArgs] = args;
     if (firstArg === '--list' || firstArg === '-l') {
         printScriptList(normalized, title);
-        return;
+        return false;
     }
     if (firstArg === '--help' || firstArg === '-h') {
         console.log(colors.magenta('Usage:'));
@@ -22,19 +22,21 @@ export async function runHelperCli({ scripts, title = 'Helper CLI', argv = proce
         console.log('\nFlags:');
         console.log('  --list  Show available scripts');
         console.log('  --help  Show this information');
-        return;
+        return false;
     }
     const argLooksLikeScript = firstArg && !firstArg.startsWith('-');
     if (argLooksLikeScript) {
         const requested = findScriptEntry(normalized, firstArg);
         if (requested) {
             await runEntry(requested, restArgs);
-            return;
+            return true;
         }
         console.log(colors.yellow(`Unknown script "${firstArg}". Falling back to interactive selection…`));
     }
     const selection = await promptForScript(normalized, title);
     if (selection) {
         await runEntry(selection, []);
+        return true;
     }
+    return false;
 }

package/dist/menu/script-helpers.js

@@ -191,26 +191,24 @@ export function makeBaseScriptEntries(pkg) {
     const scripts = pkg.json?.scripts ?? {};
     const dependencies = collectDependencies(pkg);
     const marker = getPackageMarker(pkg, dependencies);
-    return BASE_SCRIPT_KEYS.map((key) => {
+    return BASE_SCRIPT_KEYS.reduce((entries, key) => {
         const resolution = resolveBaseScript(pkg, key, scripts, dependencies, marker.kind);
-        const description = resolution.available
-            ? resolution.isDefault
-                ? `${resolution.description} (default)`
-                : resolution.description
-            : `No ${key} command detected`;
-        return {
+        const args = resolution.args;
+        if (!resolution.available || !args)
+            return entries;
+        const description = resolution.isDefault
+            ? `${resolution.description} (default)`
+            : resolution.description;
+        entries.push({
             name: key,
             emoji: '⚡️',
             description,
             handler: async () => {
-                if (!resolution.available || !resolution.args) {
-                    console.log(colors.yellow(`No ${key} command found for ${pkg.name}.`));
-                    return;
-                }
-                await run('pnpm', resolution.args, { cwd: pkg.path });
+                await run('pnpm', args, { cwd: pkg.path });
             },
-        };
-    });
+        });
+        return entries;
+    }, []);
 }
 export function getPackageMarker(pkg, dependencies = collectDependencies(pkg)) {
     const normalizedDeps = new Set([...dependencies].map((dep) => String(dep).toLowerCase().trim()));

package/dist/menu.js

@@ -14,8 +14,7 @@ function formatKindLabel(kind) {
         return 'CLI';
     return `${kind.charAt(0).toUpperCase()}${kind.slice(1)}`;
 }
-function makeManagerStepEntries(targets, packages, state, options) {
-    const includeBack = options?.includeBack ?? true;
+function makeManagerStepEntries(targets, packages, state) {
     return [
         {
             name: 'update dependencies',
@@ -103,18 +102,6 @@ function makeManagerStepEntries(targets, packages, state, options) {
                 state.lastStep = 'full';
             },
         },
-        ...(includeBack
-            ? [
-                {
-                    name: 'back',
-                    emoji: '↩️',
-                    description: 'Pick packages again',
-                    handler: async () => {
-                        state.lastStep = 'back';
-                    },
-                },
-            ]
-            : []),
     ];
 }
 function makeDockerEntry(pkg) {
@@ -158,17 +145,37 @@ export function buildPackageSelectionMenu(packages, onStepComplete) {
     const ordered = getOrderedPackages(packages);
     const entries = ordered.map((pkg) => {
         const marker = getPackageMarker(pkg);
-        const pkgColor = pkg.color ?? 'cyan';
-        const descriptionMeta = colors.dim(pkg.relativeDir ?? pkg.dirName);
-        const labelBadge = marker.label ? marker.colorize(marker.label) : '';
+        const primaryName = pkg.name ?? pkg.substitute ?? pkg.dirName;
+        const packageColorizer = colors[pkg.color ?? 'cyan'] ?? colors.cyan;
+        const highlightedName = packageColorizer(primaryName);
+        const tagParts = [];
+        const addTag = (value, colorizer) => {
+            if (!value)
+                return;
+            tagParts.push(colorizer(`[${value}]`));
+        };
+        const relativePath = pkg.relativeDir ?? pkg.dirName;
+        if (relativePath && relativePath !== '.') {
+            addTag(relativePath, colors.gray);
+        }
+        if (pkg.version) {
+            addTag(`v${pkg.version}`, colors.yellow);
+        }
+        if (pkg.substitute && pkg.substitute !== primaryName) {
+            const aliasTag = pkg.name ? `alias:${pkg.substitute}` : pkg.substitute;
+            addTag(aliasTag, colors.magenta);
+        }
+        if (pkg.dockerfilePath) {
+            addTag('docker', colors.green);
+        }
         const kindLabel = formatKindLabel(marker.kind);
-        const kindBadge = marker.kindColorize(kindLabel);
-        const badgeMeta = [labelBadge, kindBadge].filter(Boolean).join(' ');
+        addTag(kindLabel, marker.kindColorize);
+        const labelWord = marker.label ? ` ${marker.colorize(marker.label)}` : '';
+        const tags = tagParts.length ? ` ${tagParts.join(' ')}` : '';
         return {
-            name: pkg.name ?? pkg.substitute ?? pkg.dirName,
-            emoji: marker.colorize('●'),
-            description: [descriptionMeta, badgeMeta].filter(Boolean).join(' '),
-            color: pkgColor,
+            name: `${highlightedName}${tags}${labelWord}`,
+            emoji: '',
+            description: pkg.json?.description ?? pkg.relativeDir ?? pkg.dirName,
             handler: async () => {
                 const step = await runStepLoop([pkg], packages);
                 onStepComplete?.(step);
@@ -179,7 +186,6 @@ export function buildPackageSelectionMenu(packages, onStepComplete) {
         return entries;
     entries.push({
         name: 'All packages',
-        color: 'gray',
         emoji: globalEmoji,
         description: 'Select all packages',
         handler: async () => {
@@ -207,19 +213,7 @@ export async function runStepLoop(targets, packages) {
                     emoji: globalEmoji,
                     description: 'update/test/build/publish',
                     handler: async () => {
-                        const managerEntries = [
-                            ...makeManagerStepEntries(targets, packages, state, {
-                                includeBack: false,
-                            }),
-                            {
-                                name: 'back',
-                                emoji: '↩️',
-                                description: 'Return to package menu',
-                                handler: () => {
-                                    state.lastStep = undefined;
-                                },
-                            },
-                        ];
+                        const managerEntries = makeManagerStepEntries(targets, packages, state);
                         await runHelperCli({
                             title: `Manager actions for ${pkg.name}`,
                             scripts: managerEntries,
@@ -236,38 +230,23 @@ export async function runStepLoop(targets, packages) {
                             console.log(colors.yellow(`No package.json scripts found for ${pkg.name}.`));
                             return;
                         }
-                        const scriptsMenu = [
-                            ...scriptEntries,
-                            {
-                                name: 'back',
-                                emoji: '↩️',
-                                description: 'Return to package menu',
-                                handler: () => { },
-                            },
-                        ];
                         await runHelperCli({
                             title: `${pkg.name} scripts`,
-                            scripts: scriptsMenu,
+                            scripts: scriptEntries,
                             argv: [],
                         });
                     },
                 },
-                {
-                    name: 'back',
-                    emoji: '↩️',
-                    description: 'Pick packages again',
-                    handler: () => {
-                        state.lastStep = 'back';
-                    },
-                },
             ];
-            await runHelperCli({
+            const ranScript = await runHelperCli({
                 title: `Actions for ${pkg.name}`,
                 scripts: entries,
                 argv: [],
             });
-            if (state.lastStep === 'back')
+            if (!ranScript) {
+                state.lastStep = 'back';
                 return state.lastStep;
+            }
             // loop to keep showing menu
         }
     }
@@ -279,11 +258,15 @@ export async function runStepLoop(targets, packages) {
     while (true) {
         state.lastStep = undefined;
         const entries = makeManagerStepEntries(targets, packages, state);
-        await runHelperCli({
+        const ranScript = await runHelperCli({
             title: `Actions for ${targets.length === 1 ? targets[0].name : 'selected packages'}`,
             scripts: entries,
             argv: [], // <- key change
         });
+        if (!ranScript) {
+            state.lastStep = 'back';
+            return state.lastStep;
+        }
         if (state.lastStep === 'back')
             return state.lastStep;
         // keep looping to show menu again

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emeryld/manager",
-  "version": "0.6.6",
+  "version": "0.7.0",
   "description": "Interactive manager for pnpm monorepos (update/test/build/publish).",
   "license": "MIT",
   "type": "module",