Prompts

bun add @crustjs/prompts

import { input, confirm, select, multiselect } from "@crustjs/prompts";

const name = await input({ message: "Project name?" });
const useTS = await confirm({ message: "Use TypeScript?" });

const framework = await select({
  message: "Framework",
  choices: ["react", "vue", "svelte"],
});

const features = await multiselect({
  message: "Features",
  choices: ["linting", "testing", "ci"],
  required: true,
});

const name = await input({
  message: "What is your name?",
  placeholder: "John Doe",
  default: "anonymous",
  validate: (v) => v.length > 0 || "Name is required",
});

const secret = await password({
  message: "Enter your password:",
  validate: (v) => v.length >= 8 || "Must be at least 8 characters",
});

const proceed = await confirm({
  message: "Accept the license?",
  active: "Accept",
  inactive: "Decline",
  default: false,
});

const port = await select({
  message: "Choose a port",
  choices: [
    { label: "HTTP", value: 80 },
    { label: "HTTPS", value: 443, hint: "recommended" },
  ],
  default: 443,
});

const features = await multiselect({
  message: "Enable features",
  choices: [
    { label: "TypeScript", value: "ts", hint: "recommended" },
    { label: "ESLint", value: "eslint" },
    { label: "Prettier", value: "prettier" },
  ],
  default: ["ts"],
  required: true,
  max: 2,
});

const lang = await filter({
  message: "Search for a language",
  choices: ["TypeScript", "JavaScript", "Rust", "Python", "Go"],
  placeholder: "Type to filter...",
});

const data = await spinner({
  message: "Fetching data...",
  task: async () => {
    const res = await fetch("https://api.example.com/data");
    return res.json();
  },
  spinner: "arc",
});

await spinner({
  message: "Installing dependencies...",
  task: async ({ updateMessage }) => {
    await installDeps();
    updateMessage("Building project...");
    await buildProject();
    updateMessage("Running checks...");
    await runChecks();
  },
});

import { setTheme, createTheme } from "@crustjs/prompts";
import { magenta, cyan, italic } from "@crustjs/style";

// Set a global theme — applies to all prompts
setTheme({ prefix: magenta, success: cyan });

// Or create a reusable theme object
const myTheme = createTheme({ prefix: magenta, success: cyan });
setTheme(myTheme);

// Per-prompt overrides (highest priority)
const name = await input({
  message: "Name?",
  theme: { message: italic },
});

import { input, NonInteractiveError, CancelledError } from "@crustjs/prompts";

try {
  const name = await input({
    message: "Name?",
    initial: process.env.CI ? "ci-user" : undefined,
  });
} catch (err) {
  if (err instanceof NonInteractiveError) {
    // Not a TTY and no initial value
  }
  if (err instanceof CancelledError) {
    // User pressed Ctrl+C
  }
}

import { runPrompt, submit } from "@crustjs/prompts";
import type { KeypressEvent } from "@crustjs/prompts";
import { getTheme } from "@crustjs/prompts";

interface CounterState {
  count: number;
}

const result = await runPrompt<CounterState, number>({
  initialState: { count: 0 },
  theme: getTheme(),
  render: (state, theme) => `${theme.prefix("○")} Count: ${state.count}`,
  handleKey: (key, state) => {
    if (key.name === "return") return submit(state.count);
    if (key.name === "up") return { count: state.count + 1 };
    if (key.name === "down") return { count: state.count - 1 };
    return state;
  },
  renderSubmitted: (state, value, theme) =>
    `${theme.prefix("○")} Count: ${theme.success(String(value))}`,
});

import { handleTextEdit, CURSOR_CHAR } from "@crustjs/prompts";

// In your handleKey function:
const edit = handleTextEdit(key, currentText, cursorPos);
if (edit) {
  // edit.text and edit.cursorPos are updated
  return { ...state, text: edit.text, cursorPos: edit.cursorPos };
}
// null means not a text-editing key — handle other keys