@alejandrochaves/devflow-cli 1.3.2 → 1.4.0

package/dist/prompts.d.ts

@@ -0,0 +1,62 @@
+export declare const BACK_VALUE = "__BACK__";
+interface SelectChoice<T> {
+    value: T;
+    name: string;
+    description?: string;
+}
+interface SelectWithBackOptions<T> {
+    message: string;
+    choices: SelectChoice<T>[];
+    default?: T;
+    showBack?: boolean;
+}
+export declare function selectWithBack<T>(options: SelectWithBackOptions<T>): Promise<T | typeof BACK_VALUE>;
+interface InputWithBackOptions {
+    message: string;
+    default?: string;
+    validate?: (value: string) => boolean | string;
+    showBack?: boolean;
+}
+export declare function inputWithBack(options: InputWithBackOptions): Promise<string | typeof BACK_VALUE>;
+interface ConfirmWithBackOptions {
+    message: string;
+    default?: boolean;
+    showBack?: boolean;
+}
+export declare function confirmWithBack(options: ConfirmWithBackOptions): Promise<boolean | typeof BACK_VALUE>;
+interface CheckboxChoice<T> {
+    value: T;
+    name: string;
+    checked?: boolean;
+}
+interface CheckboxWithBackOptions<T> {
+    message: string;
+    choices: CheckboxChoice<T>[];
+    required?: boolean;
+    showBack?: boolean;
+}
+export declare function checkboxWithBack<T>(options: CheckboxWithBackOptions<T>): Promise<T[] | typeof BACK_VALUE>;
+interface SearchChoice<T> {
+    value: T;
+    name: string;
+}
+interface SearchWithBackOptions<T> {
+    message: string;
+    source: (term: string | undefined) => SearchChoice<T>[] | Promise<SearchChoice<T>[]>;
+    showBack?: boolean;
+}
+export declare function searchWithBack<T>(options: SearchWithBackOptions<T>): Promise<T | typeof BACK_VALUE>;
+export type StepResult<T> = {
+    action: "next";
+    value: T;
+} | {
+    action: "back";
+};
+export interface Step<TState> {
+    id: string;
+    run: (state: TState, isFirst: boolean) => Promise<StepResult<Partial<TState>>>;
+    skip?: (state: TState) => boolean;
+}
+export declare function runSteps<TState extends Record<string, unknown>>(steps: Step<TState>[], initialState: TState): Promise<TState>;
+export {};
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"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"}

package/dist/prompts.js

@@ -0,0 +1,130 @@
+import { select, input, confirm, checkbox, search } from "@inquirer/prompts";
+import * as readline from "readline";
+export const BACK_VALUE = "__BACK__";
+// Track the current abort controller for escape key handling
+let currentAbortController = null;
+let escapeListenerSetup = false;
+/**
+ * Sets up a global keypress listener for the Escape key.
+ * When Escape is pressed during a prompt with showBack enabled,
+ * it aborts the prompt and returns BACK_VALUE.
+ */
+function setupEscapeListener() {
+    if (escapeListenerSetup)
+        return;
+    escapeListenerSetup = true;
+    // Enable keypress events on stdin
+    readline.emitKeypressEvents(process.stdin);
+    process.stdin.on("keypress", (_str, key) => {
+        if (key && key.name === "escape" && currentAbortController) {
+            currentAbortController.abort();
+        }
+    });
+}
+/**
+ * Wraps a prompt function to support Escape key for back navigation.
+ * When showBack is true, pressing Escape will abort the prompt and return BACK_VALUE.
+ */
+async function withEscapeBack(showBack, promptFn) {
+    if (!showBack) {
+        return promptFn();
+    }
+    setupEscapeListener();
+    const controller = new AbortController();
+    currentAbortController = controller;
+    try {
+        const result = await promptFn(controller.signal);
+        currentAbortController = null;
+        return result;
+    }
+    catch (error) {
+        currentAbortController = null;
+        // Check if this was an abort (Escape key pressed)
+        // @inquirer/prompts throws AbortPromptError when aborted
+        if (error instanceof Error && (error.name === "AbortPromptError" || error.name === "AbortError")) {
+            return BACK_VALUE;
+        }
+        throw error;
+    }
+}
+export async function selectWithBack(options) {
+    const message = options.showBack
+        ? `${options.message} ${dim("(Esc to go back)")}`
+        : options.message;
+    return withEscapeBack(options.showBack ?? false, (signal) => select({
+        message,
+        choices: options.choices,
+        default: options.default,
+    }, { signal }));
+}
+export async function inputWithBack(options) {
+    const message = options.showBack
+        ? `${options.message} ${dim("(Esc to go back)")}`
+        : options.message;
+    return withEscapeBack(options.showBack ?? false, (signal) => input({
+        message,
+        default: options.default,
+        validate: options.validate,
+    }, { signal }));
+}
+export async function confirmWithBack(options) {
+    const message = options.showBack
+        ? `${options.message} ${dim("(Esc to go back)")}`
+        : options.message;
+    return withEscapeBack(options.showBack ?? false, (signal) => confirm({
+        message,
+        default: options.default,
+    }, { signal }));
+}
+export async function checkboxWithBack(options) {
+    const message = options.showBack
+        ? `${options.message} ${dim("(Esc to go back)")}`
+        : options.message;
+    return withEscapeBack(options.showBack ?? false, (signal) => checkbox({
+        message,
+        choices: options.choices,
+        required: options.required,
+    }, { signal }));
+}
+export async function searchWithBack(options) {
+    const message = options.showBack
+        ? `${options.message} ${dim("(Esc to go back)")}`
+        : options.message;
+    return withEscapeBack(options.showBack ?? false, (signal) => search({
+        message,
+        source: options.source,
+    }, { signal }));
+}
+// Helper for dim text (used in prompts)
+function dim(text) {
+    return `\x1b[2m${text}\x1b[22m`;
+}
+export async function runSteps(steps, initialState) {
+    let state = { ...initialState };
+    let stepIndex = 0;
+    while (stepIndex < steps.length) {
+        const step = steps[stepIndex];
+        // Check if step should be skipped
+        if (step.skip && step.skip(state)) {
+            stepIndex++;
+            continue;
+        }
+        const isFirst = stepIndex === 0;
+        const result = await step.run(state, isFirst);
+        if (result.action === "back") {
+            // Go back to previous non-skipped step
+            stepIndex--;
+            while (stepIndex > 0 && steps[stepIndex].skip && steps[stepIndex].skip(state)) {
+                stepIndex--;
+            }
+            if (stepIndex < 0)
+                stepIndex = 0;
+        }
+        else {
+            state = { ...state, ...result.value };
+            stepIndex++;
+        }
+    }
+    return state;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alejandrochaves/devflow-cli",
-  "version": "1.3.2",
+  "version": "1.4.0",
   "description": "Interactive CLI for branch creation, conventional commits, and PR management",
   "type": "module",
   "bin": {
@@ -8,7 +8,8 @@
   },
   "scripts": {
     "build": "tsc",
-    "dev": "tsc --watch",
+    "predev": "npm run build && npm link",
+    "dev": "trap 'npm unlink 2>/dev/null' EXIT && tsc --watch",
     "test": "vitest run",
     "test:watch": "vitest",
     "prepublishOnly": "npm run build",