#PromptX

#功能特性

• Input — 单行文本输入，支持默认值占位
• Confirm — 是 / 否确认
• Select — 单选列表（方向键移动，回车确认）
• Checkbox — 多选列表（空格勾选，回车确认）
• Password — 密码输入（不回显）

#安装

moon add wangmingfa/promptx

#快速开始

import "wangmingfa/promptx"

fn main {
  let name = @promptx.input("What is your name?", default_value="Guest")
  println("Hello, \{name}!")

  let ok = @promptx.confirm("Continue?")
  if ok {
    let color = @promptx.select("Pick a color:", ["Red", "Green", "Blue"])
    println("You picked: \{color}")
  }
}

#API 说明

#input

pub fn input(message : String, default_value~ : String = "") -> String

• message — 显示给用户的问题文本
• default_value~ — 可选的默认值（默认空字符串）

let name = @promptx.input("Your name?", default_value="Guest")

#confirm

pub fn confirm(message : String, default_value~ : Bool = false) -> Bool

• message — 显示给用户的问题文本
• default_value~ — 可选的高亮默认值（默认 false，即 "No"）

if @promptx.confirm("Save changes?") {
  println("Saving...")
}

#select

• ↑ / ↓ — 上下切换选项
• ↵ Enter — 确认选择

pub fn select(
  message : String,
  choices : Array[String],
  default_index~ : Int = 0,
) -> String

• message — 显示给用户的问题文本
• choices — 可选项数组
• default_index~ — 默认选中的索引（默认 0）

let color = @promptx.select("Pick a color:", ["Red", "Green", "Blue"])

#checkbox

• ↑ / ↓ — 上下切换选项
• 空格 — 勾选 / 取消当前项
• a — 全选
• i — 反选（已选变未选、未选变已选）
• ↵ Enter — 确认

pub fn checkbox(
  message : String,
  choices : Array[String],
  default_items~ : Array[String] = [],
) -> String

• message — 显示给用户的问题文本
• choices — 可选项数组
• default_items~ — 默认已勾选项（默认空）

let tops = @promptx.checkbox("Toppings:", ["Cheese", "Pepperoni", "Onion"])

#password

pub fn password(message : String) -> String

• message — 显示给用户的问题文本

let pwd = @promptx.password("Enter password:")

#本地运行示例

moon run cmd/main

#测试

moon test

#架构

• promptx — MoonBit 顶层 API，提供面向用户的友好函数。
• cprompt — 用 C 实现的终端交互内核（src/ 下的原生后端），负责原始模式切换、光标控制与各类控件的渲染。
• ffi — 桥接层，将 MoonBit String 转换为 C 期望的 null 结尾 Bytes（@ffi.string_to_c_bytes）。

#许可证

#贡献