@wpmoo/toolkit 0.9.5 → 0.9.7

package/dist/cockpit/daily-prompts.js

@@ -1,9 +1,11 @@
+import { listEnvironmentDatabases, normalizeDatabaseListResult, } from '../databases.js';
 import { listModulesInSourceRepo } from '../module-actions.js';
 import { listModuleRepos } from '../repo-actions.js';
 import { listSources } from '../source-actions.js';
 import { handlePromptCancel, menuPromptMessage, } from '../menu-navigation.js';
 import { isPromptCancel, selectPrompt, textPrompt } from '../prompts/index.js';
 const manualModuleValue = '__wpmoo_manual_module_entry__';
+const manualDatabaseValue = '__wpmoo_manual_database_entry__';
 function defaultCancelHandler(value, action) {
     handlePromptCancel(isPromptCancel(value), action);
 }
@@ -12,6 +14,7 @@ function promptDeps(deps = {}) {
         select: deps.select ?? ((options) => selectPrompt(options)),
         text: deps.text ?? ((options) => textPrompt(options)),
         list: deps.list ?? ((options) => selectPrompt(options)),
+        databases: deps.databases ?? ((cwd, options) => listEnvironmentDatabases(cwd, options)),
         handleCancel: deps.handleCancel ?? defaultCancelHandler,
     };
 }
@@ -80,6 +83,25 @@ async function optionalTextArg(deps, message, fallback) {
         placeholder: fallback,
     }), fallback, deps);
 }
+async function databaseArg(cwd, deps, message, fallback, options = {}) {
+    const databaseResult = normalizeDatabaseListResult(await deps.databases(cwd, options));
+    const databases = databaseResult.databases;
+    if (databases.length > 0) {
+        const selected = await deps.list({
+            message: menuPromptMessage(message, 'back'),
+            options: [
+                ...databases.map((database) => ({ value: database, label: database })),
+                { value: manualDatabaseValue, label: 'Manual entry' },
+            ],
+            initialValue: databases.includes(fallback) ? fallback : databases[0],
+        });
+        deps.handleCancel(selected, 'back');
+        if (selected !== manualDatabaseValue) {
+            return String(selected);
+        }
+    }
+    return optionalTextArg(deps, databaseResult.ok ? message : `${message} (database list unavailable; enter manually)`, fallback);
+}
 async function optionalModules(cwd, deps) {
     const modules = await detectedModules(cwd);
     if (modules.length === 0) {
@@ -120,19 +142,16 @@ export async function collectDailyActionArgs(command, cwd, promptDepsArg = {}) {
         return [await optionalTextArg(deps, 'Service', 'odoo')];
     }
     if (command === 'psql') {
-        return [await optionalTextArg(deps, 'Database', 'postgres')];
+        return [await databaseArg(cwd, deps, 'Database', 'postgres', { includeMaintenance: true })];
     }
     if (command === 'install' || command === 'update') {
         const modules = await moduleArg(cwd, deps);
-        const db = asString(await deps.text({
-            message: menuPromptMessage('Database (optional)', 'back'),
-            placeholder: 'devel',
-        }), '', deps);
-        return db ? [modules, db] : [modules];
+        const db = await databaseArg(cwd, deps, 'Odoo database', 'devel');
+        return [modules, db];
     }
     if (command === 'test') {
         const modules = await moduleArg(cwd, deps);
-        const db = await optionalTextArg(deps, 'Database', 'devel');
+        const db = await databaseArg(cwd, deps, 'Odoo database', 'devel');
         const mode = asString(await deps.list({
             message: menuPromptMessage('Mode', 'back'),
             options: [
@@ -151,17 +170,17 @@ export async function collectDailyActionArgs(command, cwd, promptDepsArg = {}) {
     }
     if (command === 'pot') {
         const modules = await moduleArg(cwd, deps);
-        const db = await optionalTextArg(deps, 'Database', 'devel');
+        const db = await databaseArg(cwd, deps, 'Odoo database', 'devel');
         const output = await optionalTextArg(deps, 'Output file', `i18n/${modules}.pot`);
         return [modules, db, output];
     }
     if (command === 'resetdb') {
-        const db = await optionalTextArg(deps, 'Database', 'devel');
+        const db = await databaseArg(cwd, deps, 'Odoo database', 'devel');
         const modules = await optionalModules(cwd, deps);
         return modules ? [db, modules] : [db];
     }
     if (command === 'snapshot') {
-        const db = await optionalTextArg(deps, 'Database', 'devel');
+        const db = await databaseArg(cwd, deps, 'Odoo database', 'devel');
         const snapshotName = await optionalTextArg(deps, 'Snapshot name', 'before-update');
         return [db, snapshotName];
     }
@@ -170,7 +189,7 @@ export async function collectDailyActionArgs(command, cwd, promptDepsArg = {}) {
             message: menuPromptMessage('Snapshot name', 'back'),
             validate: (value) => (value.trim() ? undefined : 'Enter the snapshot name.'),
         }), 'Snapshot name is required.', deps);
-        const db = await optionalTextArg(deps, 'Database', 'devel');
+        const db = await databaseArg(cwd, deps, 'Odoo database', 'devel');
         return [snapshotName, db];
     }
     return [];

package/dist/cockpit/menu.js

@@ -116,6 +116,7 @@ function defaultCommand(serviceStatus) {
 export async function selectCockpitTopLevelMenu(options = {}) {
     const deps = menuDeps(options);
     const choices = topLevelChoices(options.serviceStatus);
+    const cancelAction = 'back';
     const selected = await deps.select({
         message: '',
         choices: [...choices],
@@ -124,8 +125,10 @@ export async function selectCockpitTopLevelMenu(options = {}) {
         loop: false,
         hideMessage: true,
         disabledError: disabledError(options.serviceStatus),
+        navigationWarning: options.navigationWarning,
+        escapeBehavior: 'ignore',
     });
-    deps.handleCancel(selected, 'exit');
+    deps.handleCancel(selected, cancelAction);
     if (selected === 'exit') {
         return { kind: 'exit' };
     }

package/dist/cockpit/module-action-menu.js

@@ -0,0 +1,40 @@
+import { handlePromptCancel, } from '../menu-navigation.js';
+import { isPromptCancel, selectPrompt, } from '../prompts/index.js';
+const moduleActions = [
+    { id: 'delete', label: 'Delete module' },
+    { id: 'update', label: 'Update' },
+    { id: 'test', label: 'Test' },
+    { id: 'lint', label: 'Run environment lint' },
+];
+function defaultCancelHandler(value, action) {
+    handlePromptCancel(isPromptCancel(value), action);
+}
+function deps(options = {}) {
+    return {
+        select: options.select ?? ((options) => selectPrompt(options)),
+        handleCancel: options.handleCancel ?? defaultCancelHandler,
+    };
+}
+export function moduleActionChoices() {
+    return moduleActions.map(({ id, label }) => ({ value: id, name: label }));
+}
+function isModuleAction(value) {
+    return typeof value === 'string' && moduleActions.some((action) => action.id === value);
+}
+export async function selectModuleAction(module, options = {}) {
+    const promptDeps = deps(options);
+    const cancelAction = options.cancelAction ?? 'back';
+    const selected = await promptDeps.select({
+        message: `Module: ${module.moduleName}`,
+        choices: moduleActionChoices(),
+        default: 'update',
+        loop: false,
+        hideMessage: true,
+        navigationHelp: cancelAction === 'back' ? 'back' : 'exit',
+    });
+    promptDeps.handleCancel(selected, cancelAction);
+    if (isModuleAction(selected)) {
+        return selected;
+    }
+    return undefined;
+}

package/dist/cockpit/module-browser.js

@@ -0,0 +1,117 @@
+import { styleText } from 'node:util';
+import { listModulesInEnvironment, } from '../module-actions.js';
+import { handlePromptCancel, } from '../menu-navigation.js';
+import { isPromptCancel, promptSeparator, selectPrompt, } from '../prompts/index.js';
+const sourceTypeLabels = {
+    private: 'Private',
+    oca: 'OCA',
+    external: 'External',
+};
+const sourceTypeOrder = ['private', 'oca', 'external'];
+const minimumPageSize = 8;
+const reservedRows = 7;
+function rgb(red, green, blue, value) {
+    return `\u001B[38;2;${red};${green};${blue}m${value}\u001B[39m`;
+}
+function dim(value) {
+    return styleText('dim', value, { validateStream: false });
+}
+function categoryHeading(label) {
+    return `\u001B[1D${rgb(143, 211, 255, label)}`;
+}
+function repositoryHeading(repoLabel, repoContext, width) {
+    return `\u001B[1D${rgb(143, 211, 255, `📁 ${repoLabel.padEnd(width)}`)}${dim(`    ${repoContext}`)}`;
+}
+function repositoryContext(module) {
+    return module.repoSlug ?? module.repoPath;
+}
+function sourceContext(module) {
+    return `${module.sourceType}/${module.repoPath}`;
+}
+export function renderModuleDetails(module) {
+    return [
+        `Name: ${module.moduleName}`,
+        `Source: ${sourceContext(module)}`,
+        `Path: odoo/custom/src/${module.sourceType}/${module.repoPath}/${module.moduleName}`,
+    ].join('\n');
+}
+function moduleChoiceName(module, width) {
+    return `${rgb(226, 184, 96, ` ${module.moduleName.padEnd(width)}`)}${dim(`  ${sourceContext(module)}`)}`;
+}
+function pageSize(choiceCount) {
+    const terminalRows = process.stdout.rows;
+    if (!terminalRows || terminalRows <= 0) {
+        return Math.min(choiceCount, 12);
+    }
+    return Math.min(choiceCount, Math.max(minimumPageSize, terminalRows - reservedRows));
+}
+function defaultCancelHandler(value, action) {
+    handlePromptCancel(isPromptCancel(value), action);
+}
+function deps(options = {}) {
+    return {
+        select: options.select ?? ((selectOptions) => selectPrompt(selectOptions)),
+        handleCancel: options.handleCancel ?? defaultCancelHandler,
+    };
+}
+export function moduleBrowserChoices(modules) {
+    const moduleWidth = Math.max(...modules.map((module) => module.moduleName.length), 1);
+    const repositoryWidth = Math.max(...modules.map((module) => module.repoPath.length), 1);
+    const choices = [];
+    for (const sourceType of sourceTypeOrder) {
+        const sourceModules = modules
+            .filter((module) => module.sourceType === sourceType)
+            .sort((left, right) => left.repoPath.localeCompare(right.repoPath) || left.moduleName.localeCompare(right.moduleName));
+        if (sourceModules.length === 0) {
+            continue;
+        }
+        if (choices.length > 0) {
+            choices.push(promptSeparator(' '));
+        }
+        choices.push(promptSeparator(categoryHeading(sourceTypeLabels[sourceType])));
+        const modulesByRepo = new Map();
+        for (const module of sourceModules) {
+            const bucket = modulesByRepo.get(module.repoPath);
+            if (bucket) {
+                bucket.push(module);
+            }
+            else {
+                modulesByRepo.set(module.repoPath, [module]);
+            }
+        }
+        for (const [repoPath, repoModules] of modulesByRepo) {
+            const sortedRepoModules = [...repoModules].sort((left, right) => left.moduleName.localeCompare(right.moduleName));
+            const headingLabel = repositoryHeading(repoPath, repositoryContext(sortedRepoModules[0]), repositoryWidth);
+            choices.push(promptSeparator(headingLabel));
+            choices.push(...sortedRepoModules.map((module) => ({
+                value: module,
+                name: moduleChoiceName(module, moduleWidth),
+                short: module.moduleName,
+            })));
+        }
+    }
+    return choices;
+}
+export async function selectModuleFromBrowser(target, options = {}) {
+    const modules = await listModulesInEnvironment(target);
+    if (modules.length === 0) {
+        return undefined;
+    }
+    const moduleChoices = moduleBrowserChoices(modules);
+    const promptDeps = deps(options);
+    const cancelAction = options.cancelAction ?? 'back';
+    const selected = await promptDeps.select({
+        message: '',
+        choices: moduleChoices,
+        default: modules[0],
+        pageSize: pageSize(moduleChoices.length),
+        loop: false,
+        hideMessage: true,
+        navigationHelp: cancelAction === 'back' ? 'back' : 'exit',
+    });
+    promptDeps.handleCancel(selected, cancelAction);
+    if (typeof selected === 'object' && selected !== null && 'moduleName' in selected) {
+        return selected;
+    }
+    return undefined;
+}

package/dist/daily-actions.js

@@ -18,6 +18,10 @@ export const dailyActionCommands = [
     'lint',
     'pot',
 ];
+const ANSI_DIM_INFO = '\u001B[2m\u001B[38;2;120;157;181m';
+const ANSI_WARNING = '\u001B[33m';
+const ANSI_DEFAULT_FOREGROUND = '\u001B[39m';
+const ANSI_RESET = '\u001B[0m';
 const dailyActionCommandSet = new Set(dailyActionCommands);
 export const dailyActionScripts = {
     start: 'up.sh',
@@ -56,7 +60,7 @@ function usage(command) {
     if (command === 'update')
         return 'Usage: wpmoo update <module[,module]> [db]';
     if (command === 'test')
-        return 'Usage: wpmoo test <module[,module]> [--db <db>] [--mode init|update] [--tags <tags>]';
+        return 'Usage: wpmoo test <module[,module]> [--db <db>] [--mode auto|init|update] [--tags <tags>]';
     if (command === 'resetdb')
         return 'Usage: wpmoo resetdb [db] [module[,module]]';
     if (command === 'snapshot')
@@ -111,8 +115,8 @@ function testArgs(argv) {
         const value = rest[index + 1];
         if (!value || value.startsWith('--'))
             throw new Error(`Missing value for ${option}`);
-        if (option === '--mode' && value !== 'init' && value !== 'update') {
-            throw new Error('Invalid value for --mode: expected init or update');
+        if (option === '--mode' && value !== 'auto' && value !== 'init' && value !== 'update') {
+            throw new Error('Invalid value for --mode: expected auto, init, or update');
         }
         index += 1;
     }
@@ -185,6 +189,39 @@ async function spawnDailyAction(plan) {
         throw new Error(`Daily action script exited with code ${exitCode ?? 'unknown'}: ${plan.scriptPath}`);
     }
 }
+function renderDailyActionOutputLine(line) {
+    if (line.startsWith('WARNING:')) {
+        return `${ANSI_WARNING}WARNING:${ANSI_DEFAULT_FOREGROUND}${ANSI_DIM_INFO}${line.slice('WARNING:'.length)}${ANSI_RESET}`;
+    }
+    if (line === "Running as user 'root' is a security risk.") {
+        return `${ANSI_DIM_INFO}${line}${ANSI_RESET}`;
+    }
+    return line;
+}
+export function renderDailyActionOutput(output) {
+    return output
+        .split(/(\r?\n)/u)
+        .map((part) => (part === '\n' || part === '\r\n' ? part : renderDailyActionOutputLine(part)))
+        .join('');
+}
+async function spawnDailyActionWithStyledOutput(plan, writer) {
+    const child = spawn(plan.scriptPath, plan.args, {
+        cwd: plan.cwd,
+        stdio: ['inherit', 'pipe', 'pipe'],
+    });
+    child.stdout?.on('data', (chunk) => writer(renderDailyActionOutput(chunk.toString('utf8'))));
+    child.stderr?.on('data', (chunk) => writer(renderDailyActionOutput(chunk.toString('utf8'))));
+    const exitCode = await new Promise((resolve, reject) => {
+        child.on('error', reject);
+        child.on('close', resolve);
+    });
+    if (exitCode !== 0) {
+        throw new Error(`Daily action script exited with code ${exitCode ?? 'unknown'}: ${plan.scriptPath}`);
+    }
+}
 export async function runDailyAction(command, argv, cwd = process.cwd(), runner = spawnDailyAction) {
     await runner(await dailyActionPlan(command, argv, cwd));
 }
+export async function runDailyActionWithStyledOutput(command, argv, cwd = process.cwd(), writer = (chunk) => process.stdout.write(chunk)) {
+    await spawnDailyActionWithStyledOutput(await dailyActionPlan(command, argv, cwd), writer);
+}

package/dist/databases.js

@@ -0,0 +1,58 @@
+import { spawn } from 'node:child_process';
+const maintenanceDatabases = new Set(['postgres']);
+const listDatabasesQuery = [
+    'SELECT datname',
+    'FROM pg_database',
+    'WHERE datistemplate = false',
+    "ORDER BY CASE WHEN datname = 'devel' THEN 0 WHEN datname = current_database() THEN 1 ELSE 2 END, datname;",
+].join(' ');
+export function parseDatabaseListOutput(output, options = {}) {
+    const seen = new Set();
+    const databases = [];
+    for (const line of output.split(/\r?\n/u)) {
+        const database = line.trim();
+        if (!/^[A-Za-z0-9_.-]+$/u.test(database) ||
+            database.startsWith('-') ||
+            seen.has(database) ||
+            (!options.includeMaintenance && maintenanceDatabases.has(database))) {
+            continue;
+        }
+        seen.add(database);
+        databases.push(database);
+    }
+    return databases;
+}
+export function normalizeDatabaseListResult(result) {
+    if (Array.isArray(result)) {
+        return { ok: true, databases: result };
+    }
+    return result;
+}
+export async function listEnvironmentDatabases(cwd, options = {}) {
+    const queryLiteral = JSON.stringify(listDatabasesQuery);
+    const command = [
+        `query=${queryLiteral}`,
+        '. ./scripts/lib.sh >/dev/null',
+        'compose exec -T db psql -U "${POSTGRES_USER:-odoo}" -d "${POSTGRES_DB:-postgres}" -Atc "$query"',
+    ].join(' && ');
+    return new Promise((resolve) => {
+        const child = spawn('bash', ['-lc', command], {
+            cwd,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let output = '';
+        let errorOutput = '';
+        child.stdout?.on('data', (chunk) => {
+            output += chunk.toString('utf8');
+        });
+        child.stderr?.on('data', (chunk) => {
+            errorOutput += chunk.toString('utf8');
+        });
+        child.on('error', (error) => resolve({ ok: false, databases: [], error: error.message }));
+        child.on('close', (code) => {
+            resolve(code === 0
+                ? { ok: true, databases: parseDatabaseListOutput(output, options) }
+                : { ok: false, databases: [], error: errorOutput.trim() || `Database list command exited with ${code}` });
+        });
+    });
+}

package/dist/help.js

@@ -30,7 +30,7 @@ Usage:
   npx @wpmoo/toolkit psql [db]
   npx @wpmoo/toolkit install <module[,module]> [db]
   npx @wpmoo/toolkit update <module[,module]> [db]
-  npx @wpmoo/toolkit test <module[,module]> [--db <db>] [--mode init|update] [--tags <tags>]
+  npx @wpmoo/toolkit test <module[,module]> [--db <db>] [--mode auto|init|update] [--tags <tags>]
   npx @wpmoo/toolkit resetdb [db] [module[,module]]
   npx @wpmoo/toolkit snapshot [db] [snapshot-name]
   npx @wpmoo/toolkit restore-snapshot [--dry-run] <snapshot-name> [db]
@@ -91,6 +91,8 @@ Cockpit:
 
 Wizard local-only path:
   Run npx @wpmoo/toolkit from a workspace directory to open the create wizard.
+  Before setup starts, WPMoo checks Git, Docker, Docker Compose, and Docker Engine.
+  If required tools are missing, WPMoo offers installer guidance before writing files.
   Choose any environment folder; the default is ./<product>_dev.
   Skip Git/GitHub connection to create a local-only environment.
   Add source repos later from the cockpit or with add-repo.
@@ -118,7 +120,7 @@ Task recipes:
   Add OCA module:
     npx @wpmoo/toolkit add-module --repo sale-workflow --module sale_order_line_no_discount --source-type oca
   Run tests:
-    npx @wpmoo/toolkit test <module[,module]> [--db <db>] [--mode init|update] [--tags <tags>]
+    npx @wpmoo/toolkit test <module[,module]> [--db <db>] [--mode auto|init|update] [--tags <tags>]
   Safe reset and recover:
     npx @wpmoo/toolkit snapshot [db] [snapshot-name]
     npx @wpmoo/toolkit reset --dry-run

package/dist/menu-navigation.js

@@ -10,10 +10,10 @@ export function isMenuBackSignal(error) {
     return error instanceof MenuBackSignal;
 }
 export function menuIntroTitle(title, action) {
-    return action === 'back' ? `${title} · Back (Esc)` : title;
+    return title;
 }
 export function menuPromptMessage(message, action) {
-    return action === 'back' ? `${message} · Esc to go back` : message;
+    return message;
 }
 export function promptCancelOutcome(cancelled, action, key) {
     if (!cancelled) {

package/dist/module-actions.js

@@ -4,8 +4,27 @@ import { addModuleToSourceRepoInAddonsYaml, removeModuleFromSourceRepoInAddonsYa
 import { readEnvironmentMetadata } from './environment.js';
 import { realGit, stageAll } from './git.js';
 import { pathUnderBase, validateModuleName, validateRepoPath } from './path-validation.js';
-import { readAddonsYaml, writeAddonsYaml } from './repo-actions.js';
+import { listModuleRepos, readAddonsYaml, writeAddonsYaml } from './repo-actions.js';
+import { listSources } from './source-actions.js';
+const sourceTypeSortOrder = ['private', 'oca', 'external'];
+const githubRepoUrlPattern = /^(?:https?:\/\/|git@)github\.com[/:]([^/]+)\/([^/.#?]+)(?:\.git)?(?:[/?#].*)?$/i;
 const validSourceTypes = ['private', 'oca', 'external'];
+function deriveRepoSlug(repoUrl) {
+    if (!repoUrl) {
+        return undefined;
+    }
+    const normalized = repoUrl.trim().replace(/[?#].*$/, '');
+    const match = githubRepoUrlPattern.exec(normalized);
+    if (!match) {
+        return undefined;
+    }
+    const owner = match[1]?.trim();
+    const repo = match[2]?.trim();
+    if (!owner || !repo) {
+        return undefined;
+    }
+    return `${owner}/${repo}`;
+}
 function normalizeSourceType(value) {
     return validSourceTypes.includes(value) ? value : 'private';
 }
@@ -94,6 +113,36 @@ export async function listModulesInSourceRepo(target, repoPath, sourceType) {
         return [];
     }
 }
+export async function listModulesInEnvironment(target) {
+    const sources = await listSources(target);
+    const sourceRepos = sources.length > 0
+        ? sources.map((source) => ({
+            repoPath: source.path,
+            sourceType: source.type,
+            repoUrl: source.url,
+        }))
+        : (await listModuleRepos(target)).map((repoPath) => ({ repoPath, sourceType: 'private' }));
+    const listedModules = await Promise.all(sourceRepos.map(async ({ repoPath, sourceType, repoUrl }) => {
+        try {
+            const moduleNames = await listModulesInSourceRepo(target, repoPath, sourceType);
+            const repoSlug = deriveRepoSlug(repoUrl);
+            return moduleNames.map((moduleName) => ({
+                moduleName,
+                repoPath,
+                sourceType,
+                ...(repoUrl ? { repoUrl } : {}),
+                ...(repoSlug ? { repoSlug } : {}),
+            }));
+        }
+        catch {
+            return [];
+        }
+    }));
+    const sourceTypeOrder = new Map(sourceTypeSortOrder.map((sourceType, index) => [sourceType, index]));
+    return listedModules.flat().sort((left, right) => (sourceTypeOrder.get(left.sourceType) ?? 0) - (sourceTypeOrder.get(right.sourceType) ?? 0) ||
+        left.repoPath.localeCompare(right.repoPath) ||
+        left.moduleName.localeCompare(right.moduleName));
+}
 export async function removeModuleFromSourceRepo(options, git = realGit) {
     const repoPath = validateRepoPath(options.repoPath);
     const moduleName = validateModuleName(options.moduleName);

package/dist/prompts/index.js

@@ -3,7 +3,7 @@ import { styleText } from 'node:util';
 import inquirerSelect, { Separator as InquirerSeparator } from '@inquirer/select';
 import inquirerSearch from '@inquirer/search';
 import { confirm as inquirerConfirm, input as inquirerInput } from '@inquirer/prompts';
-import { recordPromptCancelKey } from '../menu-navigation.js';
+import { consumePromptCancelKey, recordPromptCancelKey } from '../menu-navigation.js';
 export const promptCancelled = Symbol.for('wpmoo.prompt.cancelled');
 export function promptSeparator(label) {
     return new InquirerSeparator(label);
@@ -46,10 +46,38 @@ function asInquirerSearchConfig(options) {
         pageSize: options.pageSize,
     };
 }
-function installEscapeAbortController(controller) {
+function isEscapeKey(key) {
+    if (typeof key !== 'object' || key === null) {
+        return false;
+    }
+    const candidate = key;
+    return candidate.name === 'escape' || candidate.sequence === '\u001B';
+}
+function installIgnoredEscapeFilter(options) {
     emitKeypressEvents(process.stdin);
+    const input = process.stdin;
+    const originalEmit = input.emit;
+    const patchedEmit = function patchedEmit(eventName, ...args) {
+        if (eventName === 'keypress' && isEscapeKey(args[1])) {
+            consumePromptCancelKey();
+            return true;
+        }
+        return Reflect.apply(originalEmit, this, [eventName, ...args]);
+    };
+    input.emit = patchedEmit;
+    return () => {
+        if (input.emit === patchedEmit) {
+            input.emit = originalEmit;
+        }
+    };
+}
+function installEscapeAbortController(controller, options = {}) {
+    emitKeypressEvents(process.stdin);
+    if (options.escapeBehavior === 'ignore') {
+        return installIgnoredEscapeFilter(options);
+    }
     const listener = (_value, key) => {
-        if (key.name !== 'escape' && key.sequence !== '\u001B') {
+        if (!isEscapeKey(key)) {
             return;
         }
         recordPromptCancelKey(key);
@@ -60,9 +88,9 @@ function installEscapeAbortController(controller) {
     process.stdin.on('keypress', listener);
     return () => process.stdin.off('keypress', listener);
 }
-async function withPromptCancelGuard(callback) {
+async function withPromptCancelGuard(callback, options = {}) {
     const controller = new AbortController();
-    const removeEscapeListener = installEscapeAbortController(controller);
+    const removeEscapeListener = installEscapeAbortController(controller, options);
     try {
         return await callback({ signal: controller.signal });
     }
@@ -92,32 +120,52 @@ function asInquirerSelectConfig(options) {
         loop: options.loop,
         hideMessage: options.hideMessage,
         disabledError: options.disabledError,
+        navigationHelp: options.navigationHelp,
+        navigationWarning: options.navigationWarning,
+        escapeBehavior: options.escapeBehavior,
     };
 }
-function hiddenSelectTheme(disabledError) {
+function renderedNavigationWarning(navigationWarning) {
+    const warning = typeof navigationWarning === 'function' ? navigationWarning() : navigationWarning;
+    return warning ? `\u001B[2m\u001B[38;2;226;184;96m${warning}\u001B[0m` : undefined;
+}
+function hiddenSelectTheme(disabledError, navigationHelp = 'exit', navigationWarning, hideMessage = true) {
+    const keysHelpTip = navigationHelp === 'back'
+        ? '↑↓ navigate • ⏎ select • Esc to go back'
+        : '↑↓ navigate • ⏎ select • Ctrl+C exit';
+    const style = {
+        highlight: (text) => text,
+        disabled: (text) => styleText('dim', text.replace(/ \(disabled\)$/u, ''), { validateStream: false }),
+        keysHelpTip: () => {
+            const warning = renderedNavigationWarning(navigationWarning);
+            return warning ? `${warning}\n${keysHelpTip}` : keysHelpTip;
+        },
+    };
+    if (hideMessage) {
+        style.message = () => '';
+    }
     return {
         prefix: '',
         icon: {
             cursor: '\u001B[38;2;226;184;96m❯\u001B[39m',
         },
-        style: {
-            message: () => '',
-            highlight: (text) => text,
-            disabled: (text) => styleText('dim', text.replace(/ \(disabled\)$/u, ''), { validateStream: false }),
-            keysHelpTip: () => '↑↓ navigate • ⏎ select • Ctrl+C exit',
-        },
+        style,
         i18n: disabledError ? { disabledError } : undefined,
     };
 }
 function withHiddenSelectMessage(config) {
-    if (!config.hideMessage) {
+    if (!config.hideMessage &&
+        !config.disabledError &&
+        !config.navigationHelp &&
+        !config.navigationWarning &&
+        !config.escapeBehavior) {
         return config;
     }
-    const { disabledError, hideMessage: _hideMessage, ...inquirerConfig } = config;
+    const { disabledError, hideMessage: _hideMessage, navigationHelp, navigationWarning, escapeBehavior: _escapeBehavior, ...inquirerConfig } = config;
     return {
         ...inquirerConfig,
-        message: '',
-        theme: hiddenSelectTheme(disabledError),
+        message: config.hideMessage ? '' : inquirerConfig.message,
+        theme: hiddenSelectTheme(disabledError, navigationHelp, navigationWarning, Boolean(config.hideMessage)),
     };
 }
 function asInquirerConfirmConfig(options) {
@@ -143,10 +191,13 @@ export function isPromptCancel(value) {
     return value === promptCancelled;
 }
 export async function selectPrompt(options) {
+    const guardOptions = {
+        escapeBehavior: options.escapeBehavior,
+    };
     if (isClackSelectOptions(options)) {
-        return withPromptCancelGuard((context) => inquirerSelect(withHiddenSelectMessage(asInquirerSelectConfig(options)), context));
+        return withPromptCancelGuard((context) => inquirerSelect(withHiddenSelectMessage(asInquirerSelectConfig(options)), context), guardOptions);
     }
-    return withPromptCancelGuard((context) => inquirerSelect(withHiddenSelectMessage(options), context));
+    return withPromptCancelGuard((context) => inquirerSelect(withHiddenSelectMessage(options), context), guardOptions);
 }
 export async function inputPrompt(options) {
     return withPromptCancelGuard((context) => inquirerInput(asInquirerInputConfig(options), context));