@reliverse/rempts 1.7.52 → 1.7.53

package/bin/libs/select/select-prompt.js

@@ -0,0 +1,308 @@
+import { stdin as input, stdout as output } from "node:process";
+import readline from "node:readline";
+import { re } from "@reliverse/relico";
+import { relinka } from "@reliverse/relinka";
+import { msg, symbols } from "../msg-fmt/messages.js";
+import { deleteLastLine } from "../msg-fmt/terminal.js";
+import { completePrompt } from "../utils/prompt-end.js";
+import { streamText } from "../utils/stream-text.js";
+function isSelectOption(option) {
+  return !("separator" in option);
+}
+async function renderPromptUI(params) {
+  const {
+    title,
+    content,
+    options,
+    selectedIndex,
+    errorMessage,
+    displayInstructions,
+    allDisabled,
+    instructions,
+    titleColor,
+    contentColor,
+    contentTypography,
+    debug,
+    titleVariant,
+    titleTypography,
+    isRerender = false,
+    shouldStream = false,
+    streamDelay = 20
+  } = params;
+  if (!isRerender) {
+    if (shouldStream) {
+      deleteLastLine();
+      msg({ type: "M_BAR", title: "" });
+      await streamText({
+        text: title,
+        delay: streamDelay,
+        color: titleColor,
+        newline: false,
+        clearLine: true
+      });
+      process.stdout.write("\r");
+      msg({
+        type: "M_GENERAL",
+        title,
+        titleColor,
+        titleVariant,
+        titleTypography
+      });
+      if (content) {
+        msg({
+          type: "M_NULL",
+          content,
+          contentColor,
+          contentTypography
+        });
+      }
+    } else {
+      msg({ type: "M_GENERAL", title, titleColor });
+      if (content) {
+        msg({
+          type: "M_NULL",
+          content,
+          contentColor,
+          contentTypography
+        });
+      }
+    }
+  }
+  let uiLineCount = 0;
+  if (errorMessage) {
+    msg({
+      type: "M_ERROR",
+      title: `${re.redBright(symbols.step_error)} ${re.redBright(errorMessage)}`
+    });
+    uiLineCount++;
+  } else if (allDisabled) {
+    msg({ type: "M_ERROR", title: re.redBright("All options are disabled.") });
+    uiLineCount++;
+  } else if (displayInstructions && !isRerender) {
+    msg({ type: "M_NULL", title: re.blue(instructions) });
+    uiLineCount++;
+  }
+  for (let index = 0; index < options.length; index++) {
+    const option = options[index];
+    if (!option) continue;
+    if (!isSelectOption(option)) {
+      const width = option.width ?? 20;
+      const symbolKey = option.symbol ?? "line";
+      const lineSymbol = symbolKey in symbols ? symbols[symbolKey] : "\u2500";
+      msg({ type: "M_NULL", title: re.dim(lineSymbol.repeat(width)) });
+      uiLineCount++;
+      continue;
+    }
+    const isSelected = index === selectedIndex;
+    const isDisabled = option.disabled;
+    const prefix = isSelected ? re.dim(re.reset("> ")) : "  ";
+    const labelColor = isDisabled ? re.dim(re.reset(option.label)) : isSelected ? re.reset(re.yellow(option.label)) : re.reset(option.label);
+    const hint = option.hint ? re.reset(` (${isDisabled ? re.dim(option.hint) : re.italic(re.dim(option.hint))})`) : "";
+    msg({ type: "M_NULL", title: `${prefix}${labelColor}${hint}` });
+    uiLineCount++;
+  }
+  if (debug) {
+    relinka("log", "", { optionsCount: options.length });
+  }
+  return uiLineCount;
+}
+export async function selectPrompt(params) {
+  const {
+    title = "",
+    message,
+    content = "",
+    options,
+    optionsArray,
+    defaultValue,
+    initialValue,
+    required = false,
+    borderColor = "dim",
+    titleColor = "cyan",
+    titleTypography = "none",
+    titleVariant,
+    contentColor = "dim",
+    contentTypography = "italic",
+    border = true,
+    endTitle = "",
+    endTitleColor = "dim",
+    debug = false,
+    terminalWidth: customTerminalWidth = 90,
+    displayInstructions = false,
+    shouldStream = false,
+    streamDelay = 20
+  } = params;
+  const finalTitle = message && title ? `${title}: ${message}` : message ?? title ?? "Select option";
+  const finalDefaultValue = defaultValue ?? initialValue;
+  const finalOptions = options ?? optionsArray?.map((opt) => ({
+    value: opt.value,
+    label: opt.label ?? opt.value,
+    hint: opt.hint,
+    disabled: false
+  })) ?? [];
+  let selectedIndex = finalDefaultValue ? finalOptions.findIndex(
+    (option) => isSelectOption(option) && option.value === finalDefaultValue && !option.disabled
+  ) : -1;
+  if (selectedIndex === -1) {
+    selectedIndex = finalOptions.findIndex((option) => isSelectOption(option) && !option.disabled);
+  }
+  if (selectedIndex === -1) {
+    selectedIndex = 0;
+  }
+  const rl = readline.createInterface({ input, output });
+  readline.emitKeypressEvents(input, rl);
+  if (typeof input.setRawMode === "function") {
+    input.setRawMode(true);
+  }
+  const instructions = "Use <\u2191/\u2193> or <k/j> to navigate, <Enter> to select, <Ctrl+C> to exit";
+  let errorMessage = "";
+  const allDisabled = finalOptions.every((option) => isSelectOption(option) && option.disabled);
+  let lastUILineCount = 0;
+  function renderOptions() {
+    if (lastUILineCount > 0) {
+      for (let i = 0; i < lastUILineCount; i++) {
+        process.stdout.write("\x1B[1A\x1B[2K");
+      }
+    }
+    void renderPromptUI({
+      title: finalTitle,
+      content,
+      options: finalOptions,
+      selectedIndex,
+      errorMessage,
+      displayInstructions,
+      allDisabled,
+      instructions,
+      borderColor,
+      titleColor,
+      contentColor,
+      contentTypography,
+      debug,
+      titleVariant,
+      titleTypography,
+      terminalWidth: customTerminalWidth,
+      isRerender: true,
+      shouldStream,
+      streamDelay
+    }).then((count) => {
+      lastUILineCount = count;
+    });
+  }
+  lastUILineCount = await renderPromptUI({
+    title: finalTitle,
+    content,
+    options: finalOptions,
+    selectedIndex,
+    errorMessage,
+    displayInstructions,
+    allDisabled,
+    instructions,
+    borderColor,
+    titleColor,
+    contentColor,
+    contentTypography,
+    debug,
+    titleVariant,
+    titleTypography,
+    terminalWidth: customTerminalWidth,
+    isRerender: false,
+    shouldStream,
+    streamDelay
+  });
+  return new Promise((resolve) => {
+    function handleKeypress(_str, key) {
+      if (allDisabled) {
+        if (key.name === "c" && key.ctrl) {
+          void endPrompt(true);
+          return;
+        }
+        return;
+      }
+      if (key.name === "up" || key.name === "k") {
+        moveSelectionUp();
+      } else if (key.name === "down" || key.name === "j") {
+        moveSelectionDown();
+      } else if (key.name === "return") {
+        void confirmSelection();
+      } else if (key.name === "c" && key.ctrl) {
+        void endPrompt(true);
+      }
+    }
+    function moveSelectionUp() {
+      const originalPointer = selectedIndex;
+      do {
+        selectedIndex = (selectedIndex - 1 + finalOptions.length) % finalOptions.length;
+        const option = finalOptions[selectedIndex];
+        if (option && isSelectOption(option) && !option.disabled) break;
+      } while (selectedIndex !== originalPointer);
+      renderOptions();
+    }
+    function moveSelectionDown() {
+      const originalPointer = selectedIndex;
+      do {
+        selectedIndex = (selectedIndex + 1) % finalOptions.length;
+        const option = finalOptions[selectedIndex];
+        if (option && isSelectOption(option) && !option.disabled) break;
+      } while (selectedIndex !== originalPointer);
+      renderOptions();
+    }
+    async function confirmSelection() {
+      const option = finalOptions[selectedIndex];
+      if (!option || !isSelectOption(option)) {
+        errorMessage = "This option is not selectable.";
+        renderOptions();
+        return;
+      }
+      if (option.disabled) {
+        errorMessage = "This option is disabled";
+        renderOptions();
+        return;
+      }
+      if (required && (!option.value || option.value === "")) {
+        errorMessage = "You must select a valid option.";
+        renderOptions();
+        return;
+      }
+      cleanup();
+      resolve(option.value);
+      deleteLastLine();
+      await completePrompt(
+        "select",
+        false,
+        endTitle,
+        endTitleColor,
+        titleTypography,
+        titleVariant ? titleVariant : void 0,
+        border,
+        borderColor,
+        void 0,
+        true
+      );
+    }
+    async function endPrompt(isCtrlC = false) {
+      await completePrompt(
+        "select",
+        isCtrlC,
+        endTitle,
+        endTitleColor,
+        titleTypography,
+        titleVariant ? titleVariant : void 0,
+        border,
+        borderColor,
+        void 0,
+        false
+      );
+      cleanup(isCtrlC);
+    }
+    function cleanup(isCtrlC = false) {
+      if (typeof input.setRawMode === "function") {
+        input.setRawMode(false);
+      }
+      rl.close();
+      input.removeListener("keypress", handleKeypress);
+      if (isCtrlC) {
+        process.exit(0);
+      }
+    }
+    input.on("keypress", handleKeypress);
+  });
+}

package/bin/libs/select/toggle-prompt.d.ts

@@ -0,0 +1,5 @@
+import type { TogglePromptParams } from "../../types";
+/**
+ * A toggle prompt that lets the user choose between two options (Yes/No style).
+ */
+export declare function togglePrompt<T extends string>(params: TogglePromptParams<T>): Promise<boolean>;

package/bin/libs/select/toggle-prompt.js

@@ -0,0 +1,207 @@
+import { stdin as input, stdout as output } from "node:process";
+import readline from "node:readline";
+import { re } from "@reliverse/relico";
+import { relinka } from "@reliverse/relinka";
+import { msg } from "../msg-fmt/messages.js";
+import { deleteLastLine } from "../msg-fmt/terminal.js";
+import { completePrompt } from "../utils/prompt-end.js";
+function renderTogglePrompt(params) {
+  const {
+    title,
+    content,
+    options,
+    selectedIndex,
+    errorMessage,
+    instructions,
+    titleColor,
+    titleTypography,
+    titleVariant,
+    contentColor,
+    contentTypography,
+    displayInstructions,
+    debug,
+    isRerender = false
+  } = params;
+  if (!isRerender) {
+    msg({
+      type: "M_GENERAL",
+      title,
+      titleColor,
+      titleTypography,
+      ...titleVariant ? { titleVariant } : {}
+    });
+    if (content) {
+      msg({
+        type: "M_NULL",
+        content: content.split("\n").map((line) => line.trim()).join("\n"),
+        contentColor,
+        contentTypography
+      });
+    }
+  }
+  let uiLineCount = 0;
+  if (errorMessage) {
+    msg({
+      type: "M_NULL",
+      title: re.redBright(errorMessage)
+    });
+    uiLineCount++;
+  } else if (displayInstructions && !isRerender) {
+    msg({
+      type: "M_NULL",
+      title: re.yellow(instructions)
+    });
+    uiLineCount++;
+  }
+  const displayString = options.map((option, index) => index === selectedIndex ? re.yellow(option) : re.reset(option)).join(re.dim(re.reset(" / ")));
+  msg({ type: "M_NULL", title: displayString });
+  uiLineCount++;
+  if (debug) {
+    relinka("log", "", {
+      selectedIndex,
+      displayOptions: options
+    });
+  }
+  return uiLineCount;
+}
+export async function togglePrompt(params) {
+  const {
+    title = "",
+    content = "",
+    options = ["Yes", "No"],
+    defaultValue = "Yes",
+    borderColor = "dim",
+    titleColor = "cyan",
+    titleTypography = "none",
+    titleVariant,
+    contentColor = "dim",
+    contentTypography = "italic",
+    border = true,
+    endTitle = "",
+    endTitleColor = "dim",
+    displayInstructions = false,
+    debug = false
+  } = params;
+  if (options.length !== 2) {
+    throw new Error("togglePrompt requires exactly two options.");
+  }
+  let selectedIndex = options.indexOf(defaultValue);
+  if (selectedIndex === -1) {
+    selectedIndex = 0;
+  }
+  const rl = readline.createInterface({ input, output });
+  readline.emitKeypressEvents(input, rl);
+  if (typeof input.setRawMode === "function") {
+    input.setRawMode(true);
+  }
+  const instructions = "Use <\u2190/\u2192> or <h/l> to navigate, <Enter> to select, <Ctrl+C> to exit";
+  let errorMessage = "";
+  let lastUILineCount = 0;
+  function renderOptions() {
+    if (lastUILineCount > 0) {
+      for (let i = 0; i < lastUILineCount; i++) {
+        process.stdout.write("\x1B[1A\x1B[2K");
+      }
+    }
+    lastUILineCount = renderTogglePrompt({
+      title,
+      content,
+      options,
+      selectedIndex,
+      errorMessage,
+      instructions,
+      borderColor,
+      titleColor,
+      titleTypography,
+      ...titleVariant ? { titleVariant } : {},
+      contentColor,
+      contentTypography,
+      border,
+      displayInstructions,
+      debug,
+      isRerender: true
+    });
+  }
+  lastUILineCount = renderTogglePrompt({
+    title,
+    content,
+    options,
+    selectedIndex,
+    errorMessage,
+    instructions,
+    borderColor,
+    titleColor,
+    titleTypography,
+    ...titleVariant ? { titleVariant } : {},
+    contentColor,
+    contentTypography,
+    border,
+    displayInstructions,
+    debug,
+    isRerender: false
+  });
+  return new Promise((resolve) => {
+    function cleanup(isCtrlC = false) {
+      if (typeof input.setRawMode === "function") {
+        input.setRawMode(false);
+      }
+      rl.close();
+      input.removeListener("keypress", handleKeypress);
+      if (isCtrlC) {
+        process.exit(0);
+      }
+    }
+    function endPrompt(isCtrlC = false) {
+      if (endTitle !== "") {
+        msg({
+          type: "M_END",
+          title: endTitle,
+          titleColor: endTitleColor,
+          titleTypography,
+          ...titleVariant ? { titleVariant } : {},
+          border,
+          borderColor
+        });
+      }
+      cleanup(isCtrlC);
+    }
+    function handleKeypress(_str, key) {
+      if (key.name === "left" || key.name === "h") {
+        selectedIndex = (selectedIndex - 1 + options.length) % options.length;
+        errorMessage = "";
+        renderOptions();
+      } else if (key.name === "right" || key.name === "l") {
+        selectedIndex = (selectedIndex + 1) % options.length;
+        errorMessage = "";
+        renderOptions();
+      } else if (key.name === "return") {
+        const selectedOption = options[selectedIndex];
+        if (!selectedOption) {
+          errorMessage = "You must select an option.";
+          renderOptions();
+        } else {
+          cleanup();
+          const booleanValue = selectedIndex === 0;
+          void completePrompt(
+            "toggle",
+            false,
+            endTitle,
+            endTitleColor,
+            titleTypography,
+            titleVariant ? titleVariant : void 0,
+            border,
+            borderColor,
+            void 0,
+            booleanValue
+          );
+          resolve(booleanValue);
+          deleteLastLine();
+          msg({ type: "M_BAR", borderColor });
+        }
+      } else if (key.name === "c" && key.ctrl) {
+        endPrompt(true);
+      }
+    }
+    input.on("keypress", handleKeypress);
+  });
+}

package/bin/libs/spinner/spinner-alias.d.ts

@@ -0,0 +1,2 @@
+import { useSpinner } from "../spinner/spinner-mod";
+export declare const spinner: typeof useSpinner;

package/bin/libs/spinner/spinner-alias.js

@@ -0,0 +1,2 @@
+import { useSpinner } from "../spinner/spinner-mod.js";
+export const spinner = useSpinner;

package/bin/libs/spinner/spinner-mod.d.ts

@@ -0,0 +1,106 @@
+interface SpinnerOptions {
+    cancelMessage?: string;
+    color?: string;
+    delay?: number;
+    errorMessage?: string;
+    failText?: string;
+    frames?: string[];
+    hideCursor?: boolean;
+    indicator?: "dots" | "timer";
+    onCancel?: () => void;
+    prefixText?: string;
+    signal?: AbortSignal;
+    silent?: boolean;
+    spinner?: string;
+    successText?: string;
+    text: string;
+}
+interface ProgressOptions {
+    current: number;
+    total: number;
+    format?: "percentage" | "count" | "both";
+}
+interface SpinnerControls {
+    start: (text?: string) => SpinnerControls;
+    stop: (text?: string, code?: number) => void;
+    setText: (text: string) => void;
+    setProgress: (progress: ProgressOptions) => void;
+    succeed: (text?: string) => void;
+    fail: (text?: string) => void;
+    warn: (text?: string) => void;
+    info: (text?: string) => void;
+    isSpinning: () => boolean;
+    clear: () => void;
+    getElapsedTime: () => number;
+    pause: () => void;
+    resume: () => void;
+    dispose: () => void;
+    isCancelled: boolean;
+}
+/**
+ * Creates a terminal spinner with enhanced controls and styling options.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const spinner = useSpinner({ text: "Loading..." }).start();
+ * spinner.stop();
+ *
+ * // With progress tracking
+ * const spinner = useSpinner({ text: "Processing files..." }).start();
+ * for (let i = 0; i < files.length; i++) {
+ *   spinner.setProgress({ current: i + 1, total: files.length });
+ *   await processFile(files[i]);
+ * }
+ * spinner.succeed();
+ *
+ * // With custom color and spinner
+ * const spinner = useSpinner({
+ *   text: "Processing...",
+ *   color: "cyan",
+ *   spinner: "dots"
+ * }).start();
+ *
+ * // With success/failure states
+ * const spinner = useSpinner({
+ *   text: "Uploading...",
+ *   successText: "Upload complete!",
+ *   failText: "Upload failed!"
+ * }).start();
+ * try {
+ *   await uploadFile();
+ *   spinner.succeed();
+ * } catch (error) {
+ *   spinner.fail();
+ * }
+ *
+ * // Using the wrapper for async operations
+ * await useSpinner.promise(
+ *   async (spinner) => {
+ *     await longOperation();
+ *     spinner.setProgress({ current: 50, total: 100 });
+ *   },
+ *   {
+ *     text: "Working...",
+ *     successText: "Done!",
+ *     failText: "Failed!"
+ *   }
+ * );
+ * ```
+ */
+export declare function useSpinner(options: SpinnerOptions): SpinnerControls;
+export declare namespace useSpinner {
+    var promise: <T>(operation: (spinner: SpinnerControls) => Promise<T>, options: SpinnerOptions) => Promise<T>;
+    var nested: (parentOptions: SpinnerOptions) => {
+        start: () => {
+            child: (childOptions: SpinnerOptions) => SpinnerControls;
+            finish: (success: boolean, text?: string) => void;
+            dispose: () => void;
+        };
+    };
+    var withTiming: <T>(operation: (spinner: SpinnerControls) => Promise<T>, options: SpinnerOptions) => Promise<{
+        result: T;
+        duration: number;
+    }>;
+}
+export {};