@emeryld/manager 0.6.5 → 0.6.7

package/dist/helper-cli/display.js

@@ -45,5 +45,5 @@ export function printPaginatedScriptList(state, title) {
         const display = option.enabled ? label : colors.dim(label);
         console.log(`  ${numberLabel} ${icon} ${display}`);
     });
-    console.log(colors.dim(`Enter 1-${PAGE_SIZE} to run, ${PREVIOUS_KEY} for previous page, ${NEXT_KEY} for next page, ${BACK_KEY} to go back, or type a name.`));
+    console.log(colors.dim(`Enter 1-${PAGE_SIZE} to run, ${PREVIOUS_KEY} for previous page (if shown), ${NEXT_KEY} for next page (if shown), ${BACK_KEY} to go back, or type a name.`));
 }

package/dist/helper-cli/pagination.js

@@ -15,18 +15,22 @@ export function buildVisibleOptions(entries, page) {
     }));
     const hasPrevious = safePage > 0;
     const hasNext = safePage < pageCount - 1;
-    options.push({
-        type: 'nav',
-        action: 'previous',
-        hotkey: PREVIOUS_KEY,
-        enabled: hasPrevious,
-    });
-    options.push({
-        type: 'nav',
-        action: 'next',
-        hotkey: NEXT_KEY,
-        enabled: hasNext,
-    });
+    if (hasPrevious) {
+        options.push({
+            type: 'nav',
+            action: 'previous',
+            hotkey: PREVIOUS_KEY,
+            enabled: true,
+        });
+    }
+    if (hasNext) {
+        options.push({
+            type: 'nav',
+            action: 'next',
+            hotkey: NEXT_KEY,
+            enabled: true,
+        });
+    }
     options.push({
         type: 'nav',
         action: 'back',

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, ${NEXT_KEY} next page, ${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 confirm, Esc/Ctrl+C to exit.`));
+    if (searchState?.active) {
+        lines.push(colors.dim('Search mode: type to filter, Backspace clears query or exits, Enter runs the top match.'));
+    }
+    else {
+        lines.push(colors.dim('Press Enter to search scripts by name.'));
+    }
     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,39 @@ 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;
+            const isBackspace = buffer.length === 1 && (buffer[0] === 0x7f || buffer[0] === 0x08);
+            const isPrintable = buffer.length === 1 && buffer[0] >= 0x20 && buffer[0] <= 0x7e;
             if (isCtrlC || isEscape) {
                 cleanup();
                 process.exit(1);
             }
+            if (searchActive) {
+                if (isEnter) {
+                    if (filteredEntries.length > 0) {
+                        commitSelection(filteredEntries[0]);
+                    }
+                    else {
+                        process.stdout.write('\x07');
+                    }
+                    return;
+                }
+                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 (isArrowUp ||
                 (buffer.length === 1 && (buffer[0] === 0x6b || buffer[0] === 0x4b))) {
                 selectedIndex =
@@ -195,7 +303,7 @@ export async function promptForScript(entries, title) {
                 return;
             }
             if (isEnter) {
-                activateOption(state.options[selectedIndex]);
+                enterSearchMode();
                 return;
             }
             if (buffer.length === 1 && buffer[0] >= 0x30 && buffer[0] <= 0x39) {
@@ -211,10 +319,10 @@ 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();
                 }

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

@@ -1,5 +1,48 @@
 import { colors } from "../utils/log.js";
 import { run } from "../utils/run.js";
+const FRONTEND_INDICATORS = [
+    { dep: 'next', label: 'Next' },
+    { dep: 'remix', label: 'Remix' },
+    { dep: '@remix-run/node', label: 'Remix' },
+    { dep: 'expo', label: 'Expo' },
+    { dep: 'react-native', label: 'React Native' },
+    { dep: 'react', label: 'React' },
+    { dep: 'vite', label: 'Vite' },
+    { dep: '@vitejs/plugin-react', label: 'Vite' },
+    { dep: 'svelte', label: 'Svelte' },
+    { dep: '@sveltejs/vite-plugin-svelte', label: 'SvelteKit' },
+    { dep: '@angular/core', label: 'Angular' },
+    { dep: 'vue', label: 'Vue' },
+];
+const BACKEND_INDICATORS = [
+    { dep: 'express', label: 'Express' },
+    { dep: 'fastify', label: 'Fastify' },
+    { dep: 'koa', label: 'Koa' },
+    { dep: 'hono', label: 'Hono' },
+    { dep: '@nestjs/core', label: 'NestJS' },
+    { dep: '@trpc/server', label: 'tRPC' },
+];
+const CLI_INDICATORS = [
+    { dep: '@oclif/core', label: 'OClif' },
+    { dep: '@oclif/command', label: 'OClif' },
+    { dep: 'oclif', label: 'OClif' },
+    { dep: 'commander', label: 'Commander' },
+    { dep: 'yargs', label: 'Yargs' },
+    { dep: 'cac', label: 'CAC' },
+    { dep: 'clipanion', label: 'Clipanion' },
+    { dep: 'caporal', label: 'Caporal' },
+    { dep: 'ink', label: 'Ink' },
+    { dep: 'meow', label: 'Meow' },
+    { dep: 'enquirer', label: 'Enquirer' },
+    { dep: 'zx', label: 'ZX' },
+];
+const CLI_KEYWORDS = new Set(['cli', 'command-line', 'commandline', 'tooling']);
+const KIND_COLOR_MAP = {
+    frontend: colors.magenta,
+    backend: colors.green,
+    library: colors.cyan,
+    cli: colors.red,
+};
 export function collectDependencies(pkg) {
     return new Set([
         ...Object.keys(pkg.json?.dependencies ?? {}),
@@ -37,6 +80,7 @@ function resolveFormatScript(pkg, scripts, dependencies) {
             description: commandDescription(args),
             args,
             available: true,
+            isDefault: true,
         };
     }
     return {
@@ -56,6 +100,7 @@ function resolveTypecheckScript(pkg, scripts, dependencies) {
             description: commandDescription(args),
             args,
             available: true,
+            isDefault: true,
         };
     }
     return {
@@ -75,6 +120,7 @@ function resolveLintScript(pkg, scripts, dependencies) {
             description: commandDescription(args),
             args,
             available: true,
+            isDefault: true,
         };
     }
     return {
@@ -86,7 +132,7 @@ function resolveLintScript(pkg, scripts, dependencies) {
 function resolveDevScript(pkg, scripts, dependencies, kind) {
     const devCandidates = kind === 'frontend'
         ? ['dev', 'start', 'serve']
-        : kind === 'backend'
+        : kind === 'backend' || kind === 'cli'
             ? ['dev', 'start', 'watch', 'serve', 'start:dev']
             : ['dev', 'start'];
     const direct = resolveRunScript(scripts, devCandidates);
@@ -99,6 +145,7 @@ function resolveDevScript(pkg, scripts, dependencies, kind) {
             description: commandDescription(args),
             args,
             available: true,
+            isDefault: true,
         };
     }
     if (dependencies.has('vite')) {
@@ -108,6 +155,7 @@ function resolveDevScript(pkg, scripts, dependencies, kind) {
             description: commandDescription(args),
             args,
             available: true,
+            isDefault: true,
         };
     }
     if (dependencies.has('expo')) {
@@ -117,6 +165,7 @@ function resolveDevScript(pkg, scripts, dependencies, kind) {
             description: commandDescription(args),
             args,
             available: true,
+            isDefault: true,
         };
     }
     return {
@@ -145,7 +194,9 @@ export function makeBaseScriptEntries(pkg) {
     return BASE_SCRIPT_KEYS.map((key) => {
         const resolution = resolveBaseScript(pkg, key, scripts, dependencies, marker.kind);
         const description = resolution.available
-            ? resolution.description
+            ? resolution.isDefault
+                ? `${resolution.description} (default)`
+                : resolution.description
             : `No ${key} command detected`;
         return {
             name: key,
@@ -162,17 +213,73 @@ export function makeBaseScriptEntries(pkg) {
     });
 }
 export function getPackageMarker(pkg, dependencies = collectDependencies(pkg)) {
-    const hasFrontend = ['react', 'next', 'expo', 'react-native', 'vite'].some((dep) => dependencies.has(dep));
-    const hasBackend = ['express', 'fastify', 'hono', 'koa', '@nestjs/core'].some((dep) => dependencies.has(dep));
+    const normalizedDeps = new Set([...dependencies].map((dep) => String(dep).toLowerCase().trim()));
+    function findIndicator(indicators) {
+        for (const indicator of indicators) {
+            if (normalizedDeps.has(indicator.dep.toLowerCase())) {
+                return indicator;
+            }
+        }
+        return undefined;
+    }
     const pkgType = pkg.json?.type?.toLowerCase();
-    if (hasFrontend) {
-        return { label: 'frontend', colorize: colors.magenta, kind: 'frontend' };
+    const keywords = (() => {
+        const raw = pkg.json?.keywords;
+        if (typeof raw === 'string') {
+            return raw
+                .split(/\s*,\s*/)
+                .map((keyword) => keyword.trim())
+                .filter(Boolean);
+        }
+        if (Array.isArray(raw)) {
+            return raw
+                .map((keyword) => String(keyword).trim())
+                .filter(Boolean);
+        }
+        return [];
+    })();
+    const hasCliKeyword = keywords
+        .map((keyword) => keyword.toLowerCase())
+        .some((keyword) => CLI_KEYWORDS.has(keyword));
+    const hasBinField = !!pkg.json?.bin &&
+        (typeof pkg.json?.bin === 'string' ||
+            typeof pkg.json?.bin === 'object' ||
+            Array.isArray(pkg.json?.bin));
+    const frontendIndicator = findIndicator(FRONTEND_INDICATORS);
+    if (frontendIndicator) {
+        return {
+            label: frontendIndicator.label ?? frontendIndicator.dep,
+            colorize: KIND_COLOR_MAP.frontend,
+            kind: 'frontend',
+            kindColorize: KIND_COLOR_MAP.frontend,
+        };
     }
-    if (hasBackend) {
-        return { label: 'backend', colorize: colors.green, kind: 'backend' };
+    const backendIndicator = findIndicator(BACKEND_INDICATORS);
+    if (backendIndicator) {
+        return {
+            label: backendIndicator.label ?? backendIndicator.dep,
+            colorize: KIND_COLOR_MAP.backend,
+            kind: 'backend',
+            kindColorize: KIND_COLOR_MAP.backend,
+        };
     }
-    if (pkgType === 'module') {
-        return { label: 'esm', colorize: colors.yellow, kind: 'library' };
+    const cliIndicator = findIndicator(CLI_INDICATORS);
+    if (cliIndicator || hasCliKeyword || hasBinField) {
+        const label = cliIndicator?.label ?? 'CLI';
+        return {
+            label,
+            colorize: KIND_COLOR_MAP.cli,
+            kind: 'cli',
+            kindColorize: KIND_COLOR_MAP.cli,
+        };
     }
-    return { label: 'node', colorize: colors.cyan, kind: 'library' };
+    const isModule = pkgType === 'module';
+    const label = isModule ? 'ESM' : 'Node';
+    const labelColorizer = isModule ? colors.yellow : colors.cyan;
+    return {
+        label,
+        colorize: labelColorizer,
+        kind: 'library',
+        kindColorize: KIND_COLOR_MAP.library,
+    };
 }

package/dist/menu.js

@@ -9,8 +9,12 @@ import { ensureWorkingTreeCommitted } from './preflight.js';
 import { openDockerHelper } from './docker.js';
 import { run } from './utils/run.js';
 import { makeBaseScriptEntries, getPackageMarker } from './menu/script-helpers.js';
-function makeManagerStepEntries(targets, packages, state, options) {
-    const includeBack = options?.includeBack ?? true;
+function formatKindLabel(kind) {
+    if (kind === 'cli')
+        return 'CLI';
+    return `${kind.charAt(0).toUpperCase()}${kind.slice(1)}`;
+}
+function makeManagerStepEntries(targets, packages, state) {
     return [
         {
             name: 'update dependencies',
@@ -98,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) {
@@ -154,12 +146,15 @@ export function buildPackageSelectionMenu(packages, onStepComplete) {
     const entries = ordered.map((pkg) => {
         const marker = getPackageMarker(pkg);
         const pkgColor = pkg.color ?? 'cyan';
-        const descriptionMeta = pkg.relativeDir ?? pkg.dirName;
-        const markerHint = marker.label ? ` · ${marker.label}` : '';
+        const descriptionMeta = colors.dim(pkg.relativeDir ?? pkg.dirName);
+        const labelBadge = marker.label ? marker.colorize(marker.label) : '';
+        const kindLabel = formatKindLabel(marker.kind);
+        const kindBadge = marker.kindColorize(kindLabel);
+        const badgeMeta = [labelBadge, kindBadge].filter(Boolean).join(' ');
         return {
             name: pkg.name ?? pkg.substitute ?? pkg.dirName,
             emoji: marker.colorize('●'),
-            description: `${descriptionMeta}${colors.dim(markerHint)}`,
+            description: [descriptionMeta, badgeMeta].filter(Boolean).join(' '),
             color: pkgColor,
             handler: async () => {
                 const step = await runStepLoop([pkg], packages);
@@ -199,19 +194,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,
@@ -228,38 +211,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
         }
     }
@@ -271,11 +239,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.5",
+  "version": "0.6.7",
   "description": "Interactive manager for pnpm monorepos (update/test/build/publish).",
   "license": "MIT",
   "type": "module",