@reliverse/rempts-core 1.6.1

package/LICENSE

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2025 blefnk Nazar Kornienko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,102 @@
+# @reliverse/prompts
+
+[💖 GitHub Sponsors](https://github.com/sponsors/blefnk) • [💬 Discord](https://discord.gg/3GawfWfAPe) • [📦 NPM](https://npmjs.com/package/@reliverse/prompts) • [📚 Docs](https://docs.reliverse.org/reliverse/prompts) • [✨ GitHub](https://github.com/reliverse/prompts)
+
+**@reliverse/prompts** is your modern, type-safe toolkit for building delightful CLI experiences. It's fast, flexible, and built with developer joy in mind. Forget the clutter — this is how CLI should feel.
+
+## ⚡ Why It Rocks
+
+- ✨ **TypeScript-first** — fully typed prompts and helpers, with great DX
+- 🔧 **Flexible Prompt Types** — input, password, select, multiselect, confirm, toggle, number, spinner, and more
+- 🧠 **Smart validation** — works with Zod, TypeBox, or your own validators
+- 🌈 **Accessible & Adaptive** — meets WCAG AA, handles terminal resizing & color contrast
+- 🧯 **Crash-resistant** — gracefully exits on Ctrl+C or unexpected input
+- 🎨 **Custom theming** — make it match your CLI style
+- 🚀 **Zero boilerplate** — focus on the logic, not the wiring
+
+## 🛠️ Install
+
+```bash
+bun add @reliverse/prompts
+# or npm, pnpm, yarn
+```
+
+Make sure you have [Bun](https://bun.sh), [Node.js](https://nodejs.org), and [Git](https://git-scm.com/downloads) installed.
+
+## 🧪 Try It Out (Playground Mode)
+
+Wanna test drive before integrating? Clone the repo and run:
+
+```bash
+git clone https://github.com/reliverse/prompts.git
+cd prompts
+bun i
+bun dev
+```
+
+Then open `examples/launcher.ts` and explore different prompts.
+
+![example](./examples/main.png)
+
+## 🧩 Example Usage
+
+```ts
+import {
+  startPrompt, // Initialize prompt session (optional)
+  inputPrompt, // Ask for user input
+} from "@reliverse/prompts";
+
+await startPrompt({
+  clearConsole: true,
+  titleColor: "inverse",
+  packageName: "@reliverse/cli",
+  packageVersion: "1.0.0",
+});
+
+const username = await inputPrompt({
+  id: "username",
+  title: "Welcome!",
+  content: "What's your name?",
+});
+
+console.log(`Hey there, ${username}!`);
+```
+
+> 🔎 You can also use `selectPrompt`, `multiselectPrompt`, `confirmPrompt`, `numberPrompt`, `spinnerPrompt`, and more.
+
+## 🧠 Bonus Goodies
+
+- ⚙️ **Built-in argument parsing** — parse CLI args without a separate lib
+- 🧪 **Unit-test friendly** — prompts can be mocked/stubbed
+- 📚 **Minimal API surface** — easy to learn, hard to outgrow
+- 💅 **Custom styles** — tweak colors, formats, and transitions
+
+## 🔍 Why not Inquirer or Clack?
+
+While we love other tools, `@reliverse/prompts` was built for:
+
+- Dev-first ergonomics
+- Fully typed workflows
+- Configurable theming
+- Better crash handling & UX polish
+
+[See feature comparison →](https://docs.reliverse.org/reliverse/prompts/#prompts-library-comparison)
+
+## 💡 Contributing
+
+Wanna improve prompts or add something cool? PRs welcome!  
+This project favors functional programming over OOP — no classes, just clean, composable logic.
+
+Open a PR or discussion on [GitHub](https://github.com/reliverse/prompts).
+
+## 🙏 Shoutout
+
+This wouldn't exist without these gems:
+
+- [sboudrias/inquirer.js](https://github.com/sboudrias/inquirer.js)
+- [unjs/citty](https://github.com/unjs/citty)
+- [lukeed/mri](https://github.com/lukeed/mri)
+
+## 📄 License
+
+💖 MIT © 2025 [blefnk Nazar Kornienko](https://github.com/blefnk)

package/bin/core-impl/anykey/anykey-mod.d.ts

@@ -0,0 +1,12 @@
+import type { ColorName } from "../../core-types.js";
+type Options = {
+    ctrlC?: number | false | "reject";
+    preserveLog?: boolean;
+    hideMessage?: boolean;
+    shouldStream?: boolean;
+    streamDelay?: number;
+    color?: ColorName;
+    placeholderColor?: ColorName;
+};
+export declare function anykeyPrompt(message?: string, options?: Options): Promise<void>;
+export {};

package/bin/core-impl/anykey/anykey-mod.js

@@ -0,0 +1,125 @@
+import logUpdate from "log-update";
+import { cursor } from "sisteransi";
+import { fmt } from "../msg-fmt/messages.js";
+import { endPrompt } from "../st-end/end.js";
+import { streamText } from "../utils/stream-text.js";
+const DEFAULT_MESSAGE = "Press any key to continue...";
+const CTRL_C_CODE = 3;
+const terminal = {
+  /**
+   * Move cursor to start of line
+   */
+  moveToStart: () => process.stdout.write("\r"),
+  /**
+   * Clear current line and move cursor up
+   */
+  clearLineAndMoveUp: () => process.stdout.write("\x1B[1A\x1B[2K"),
+  /**
+   * Clear multiple lines above current position
+   */
+  clearLines: (count) => {
+    terminal.moveToStart();
+    process.stdout.write("\x1B[2K");
+    for (let i = 0; i < count; i++) {
+      terminal.clearLineAndMoveUp();
+    }
+  }
+};
+export async function anykeyPrompt(message = DEFAULT_MESSAGE, options = {}) {
+  const {
+    ctrlC = 1,
+    preserveLog = false,
+    hideMessage = false,
+    shouldStream = false,
+    streamDelay = 20,
+    color = "dim",
+    placeholderColor = "gray"
+  } = options;
+  if (message) {
+    if (!shouldStream) {
+      const { text } = fmt({
+        hintPlaceholderColor: placeholderColor,
+        type: "M_GENERAL",
+        title: message,
+        titleColor: color,
+        dontRemoveBar: true
+      });
+      message = text;
+    }
+  }
+  if (message && !hideMessage) {
+    if (shouldStream) {
+      await streamText({
+        text: `\u25C6  ${message}`,
+        delay: streamDelay,
+        newline: false,
+        clearLine: true,
+        color
+      });
+      const lineCount = message.split("\n").length;
+      terminal.clearLines(lineCount);
+      const { text } = fmt({
+        hintPlaceholderColor: placeholderColor,
+        type: "M_GENERAL",
+        title: message,
+        titleColor: color,
+        dontRemoveBar: true
+      });
+      terminal.moveToStart();
+      logUpdate(text);
+    } else {
+      logUpdate(message);
+    }
+  }
+  return new Promise((resolve, reject) => {
+    const cleanup = () => {
+      process.stdin.removeListener("data", handler);
+      if (process.stdin.isTTY && typeof process.stdin.setRawMode === "function") {
+        process.stdin.setRawMode(false);
+      }
+      process.stdin.pause();
+      process.stdout.write(cursor.show);
+    };
+    const handleCtrlC = () => {
+      cleanup();
+      void endPrompt({
+        title: "\u270B User pressed Ctrl+C, exiting...",
+        titleAnimation: "pulse",
+        titleColor: "redBright",
+        titleTypography: "bold",
+        endTitleColor: "redBright",
+        titleAnimationDelay: 400
+      }).then(() => {
+        if (ctrlC === "reject") {
+          reject(new Error("User pressed CTRL+C"));
+        } else if (ctrlC === false) {
+          resolve();
+        } else if (typeof ctrlC === "number") {
+          process.exit(0);
+        } else {
+          throw new TypeError("Invalid ctrlC option");
+        }
+      }).catch(reject);
+    };
+    const handler = (buffer) => {
+      cleanup();
+      if (message && !preserveLog) {
+        logUpdate.clear();
+      } else {
+        logUpdate.done();
+        process.stdout.write("\n");
+      }
+      const [firstByte] = buffer;
+      if (firstByte === CTRL_C_CODE) {
+        handleCtrlC();
+      } else {
+        resolve();
+      }
+    };
+    process.stdin.resume();
+    if (process.stdin.isTTY && typeof process.stdin.setRawMode === "function") {
+      process.stdin.setRawMode(true);
+    }
+    process.stdin.once("data", handler);
+  });
+}

package/bin/core-impl/date/date.d.ts

@@ -0,0 +1,2 @@
+import type { DatePromptOptions } from "../../core-types.js";
+export declare function datePrompt(opts: DatePromptOptions): Promise<string>;

package/bin/core-impl/date/date.js

@@ -0,0 +1,236 @@
+import { re } from "@reliverse/relico";
+import { stdin as input, stdout as output } from "node:process";
+import readline from "node:readline/promises";
+import {
+  buildRegExp,
+  digit,
+  endOfString,
+  repeat,
+  startOfString
+} from "ts-regex-builder";
+import { fmt, msg, symbols } from "../msg-fmt/messages.js";
+import {
+  countLines,
+  deleteLastLine,
+  deleteLastLines
+} from "../msg-fmt/terminal.js";
+const twoDigits = repeat(digit, 2);
+const fourDigits = repeat(digit, 4);
+const separatorDot = ".";
+const separatorSlash = "/";
+const regexDDMMYYYY = buildRegExp([
+  startOfString,
+  twoDigits,
+  // DD
+  separatorDot,
+  twoDigits,
+  // MM
+  separatorDot,
+  fourDigits,
+  // YYYY
+  endOfString
+]);
+const regexMMDDYYYY = buildRegExp([
+  startOfString,
+  twoDigits,
+  // MM
+  separatorSlash,
+  twoDigits,
+  // DD
+  separatorSlash,
+  fourDigits,
+  // YYYY
+  endOfString
+]);
+const regexYYYYMMDD = buildRegExp([
+  startOfString,
+  fourDigits,
+  // YYYY
+  separatorDot,
+  twoDigits,
+  // MM
+  separatorDot,
+  twoDigits,
+  // DD
+  endOfString
+]);
+export async function datePrompt(opts) {
+  const {
+    title = "",
+    dateFormat,
+    dateKind,
+    hint,
+    hintPlaceholderColor = "blue",
+    validate,
+    defaultValue = "",
+    titleColor = "cyan",
+    titleTypography = "none",
+    titleVariant,
+    content,
+    contentColor = "dim",
+    contentTypography = "italic",
+    contentVariant,
+    borderColor = "dim",
+    variantOptions,
+    endTitle = "",
+    endTitleColor = "dim",
+    border = true
+  } = opts;
+  const rl = readline.createInterface({ input, output });
+  rl.on("SIGINT", () => {
+    rl.close();
+    if (endTitle !== "") {
+      msg({
+        type: "M_END",
+        title: endTitle,
+        titleColor: endTitleColor,
+        titleTypography,
+        border,
+        borderColor
+      });
+    }
+    process.exit(0);
+  });
+  let linesToDelete = 0;
+  let errorMessage = "";
+  try {
+    while (true) {
+      if (linesToDelete > 0) {
+        deleteLastLines(linesToDelete);
+        linesToDelete = 0;
+      }
+      const { text: questionText } = fmt({
+        type: errorMessage !== "" ? "M_ERROR_NULL" : "M_GENERAL_NULL",
+        title: `${title} [${dateFormat}]`,
+        titleColor,
+        titleTypography,
+        titleVariant,
+        content,
+        contentColor,
+        contentTypography,
+        contentVariant,
+        borderColor,
+        hint: `${hint ? `${hint} ` : ""}${defaultValue ? `Default: ${defaultValue}` : ""}`,
+        hintPlaceholderColor,
+        variantOptions,
+        errorMessage
+      });
+      const questionLines = countLines(questionText);
+      linesToDelete = questionLines + 1;
+      msg({
+        type: errorMessage !== "" ? "M_ERROR" : "M_GENERAL",
+        title: questionText
+      });
+      if (errorMessage !== "") {
+        deleteLastLine();
+        deleteLastLine();
+      }
+      const answerInput = await rl.question(`${re.dim(symbols.middle)}  `);
+      if (answerInput === null) {
+        rl.close();
+        if (endTitle !== "") {
+          msg({
+            type: "M_END",
+            title: endTitle,
+            titleColor: endTitleColor,
+            titleTypography,
+            border,
+            borderColor
+          });
+        }
+        process.exit(0);
+      }
+      const answer = answerInput.trim() || defaultValue;
+      if (errorMessage !== "") {
+        deleteLastLine();
+      }
+      deleteLastLine();
+      msg({
+        type: "M_MIDDLE",
+        title: `  ${answer}`,
+        titleColor: "none"
+      });
+      if (!(regexDDMMYYYY.test(answer) || regexMMDDYYYY.test(answer) || regexYYYYMMDD.test(answer))) {
+        if (errorMessage !== "") {
+          deleteLastLine();
+          deleteLastLine();
+        }
+        errorMessage = `Please enter a valid date in ${dateFormat} format.`;
+        msg({ type: "M_ERROR", title: errorMessage });
+        linesToDelete = countLines(errorMessage) + 1;
+        continue;
+      }
+      let matchedFormat = null;
+      if (regexDDMMYYYY.test(answer)) {
+        matchedFormat = "DD.MM.YYYY";
+      } else if (regexMMDDYYYY.test(answer)) {
+        matchedFormat = "MM/DD/YYYY";
+      } else if (regexYYYYMMDD.test(answer)) {
+        matchedFormat = "YYYY.MM.DD";
+      }
+      if (dateKind === "birthday" && matchedFormat) {
+        const parts = answer.split(/[./-]/);
+        let date;
+        if (matchedFormat === "DD.MM.YYYY") {
+          date = new Date(
+            Number(parts[2]),
+            Number(parts[1]) - 1,
+            Number(parts[0])
+          );
+        } else if (matchedFormat === "MM/DD/YYYY") {
+          date = new Date(
+            Number(parts[2]),
+            Number(parts[0]) - 1,
+            Number(parts[1])
+          );
+        } else if (matchedFormat === "YYYY.MM.DD") {
+          date = new Date(
+            Number(parts[0]),
+            Number(parts[1]) - 1,
+            Number(parts[2])
+          );
+        } else {
+          date = new Date(answer);
+        }
+        if (Number.isNaN(date.getTime()) || date.getFullYear() < 1900 || date > /* @__PURE__ */ new Date()) {
+          errorMessage = "Please enter a valid birthday date (e.g., 14.09.1999).";
+          msg({ type: "M_ERROR", title: errorMessage });
+          linesToDelete = countLines(errorMessage) + 1;
+          continue;
+        }
+      }
+      let isValid = true;
+      let gotError = false;
+      if (errorMessage !== "") {
+        gotError = true;
+      }
+      errorMessage = "";
+      if (validate && isValid) {
+        const validation = await validate(answer);
+        if (validation !== true) {
+          isValid = false;
+          errorMessage = typeof validation === "string" ? validation : "Invalid input.";
+          msg({ type: "M_ERROR", title: errorMessage });
+          gotError = true;
+          linesToDelete = countLines(errorMessage) + 1;
+          continue;
+        }
+      }
+      if (isValid) {
+        if (gotError) {
+          deleteLastLine();
+          deleteLastLine();
+          msg({ type: "M_MIDDLE", title: `  ${answer}` });
+        }
+        msg({
+          type: "M_BAR",
+          borderColor
+        });
+        rl.close();
+        return answer;
+      }
+    }
+  } finally {
+    rl.close();
+  }
+}

package/bin/core-impl/editor/editor-mod.d.ts

@@ -0,0 +1,25 @@
+import type { EditorExitResult } from "../../core-types.js";
+type EditorConfig = {
+    syntaxHighlighting?: boolean;
+    theme?: "auto" | "light" | "dark";
+    defaultAllowSaveAs?: boolean;
+    defaultAllowOpen?: boolean;
+    defaultAutoCloseOnSave?: boolean;
+    defaultReturnContentOnSave?: boolean;
+    [key: string]: any;
+};
+type EditorOptions = {
+    filename?: string | null;
+    initialContent?: string | null;
+    onSave?: (content: string, filename: string | null) => Promise<string | boolean | undefined> | string | boolean | undefined;
+    onExit?: (content: string | null, saved: boolean, filename: string | null) => Promise<void> | void;
+    configOverrides?: Partial<EditorConfig>;
+    allowSaveAs?: boolean;
+    allowOpen?: boolean;
+    autoCloseOnSave?: boolean;
+    returnContentOnSave?: boolean;
+    mode?: string;
+    cwd?: string;
+};
+export declare function startEditor(options?: EditorOptions): Promise<EditorExitResult>;
+export {};