Promptberry

dependencies: [
    .package(
        url: "https://github.com/onmyway133/Promptberry", 
        from: "1.0.0"
    )
],
targets: [
    .executableTarget(
        name: "MyApp",
        dependencies: [
            .product(name: "Promptberry", package: "Promptberry")
        ]
    )
]

import Promptberry

Promptberry.intro("My App v1.0")

let name = try Promptberry.text("What's your name?", placeholder: "e.g. Ada")
let pass = try Promptberry.password("Choose a password:")
let go   = try Promptberry.confirm("Continue?")

Promptberry.outro("All done, \(name)!")

do {
    let name = try Promptberry.text("Name?")
} catch is PromptCancelled {
    Promptberry.cancel("Aborted.")
    exit(0)
}

let name = try Promptberry.text(
    "What's your name?",
    placeholder: "e.g. Ada Lovelace",   // shown when empty
    defaultValue: "Anonymous",           // returned on empty Enter
    validate: { value in
        value.count < 2 ? "Too short." : nil
    }
)

let secret = try Promptberry.password("Password:", mask: "•")

let ok = try Promptberry.confirm(
    "Continue?",
    active: "Yes",
    inactive: "No",
    initialValue: true
)

let choice = try Promptberry.select("Pick one:", options: ["a", "b", "c"])

let type_ = try Promptberry.select(
    "Project type:",
    options: ["Executable", "Library", "Plugin"],
    allowOther: true
)

let lang = try Promptberry.select(
    "Preferred language:",
    options: [
        SelectOption(value: "swift",  label: "Swift",  hint: "recommended"),
        SelectOption(value: "kotlin", label: "Kotlin"),
        SelectOption(value: "python", label: "Python"),
    ],
    initialValue: "swift",
    maxItems: 5          // how many options to show at once
)

enum Language: String, CaseIterable, Promptable {
    case swift, kotlin, python, rust
}

let lang = try Promptberry.select("Language:", from: Language.self)
// returns Language.swift, .kotlin, etc.

let server = try Promptberry.select(
    "Target server:",
    from: servers,
    label: { $0.hostname }
)

// Simple string array
let features = try Promptberry.multiselect(
    "Features:",
    options: ["tests", "ci", "docs"],
    initialValues: ["tests"]   // pre-selected
)

let extras = try Promptberry.multiselect(
    "Include extras:",
    options: ["Tests", "CI workflow", "README", "SwiftLint"],
    allowOther: true
)

// Or with SelectOption for hints
let tools = try Promptberry.multiselect(
    "Build tools:",
    options: [
        SelectOption(value: "spm",   label: "Swift Package Manager"),
        SelectOption(value: "cmake", label: "CMake"),
        SelectOption(value: "bazel", label: "Bazel", hint: "large-scale"),
    ],
    initialValues: ["spm"],
    required: true       // at least one must be selected
)
// returns [String]

enum Feature: String, CaseIterable, Promptable {
    case tests, ci, docs, linting
}

let features = try Promptberry.multiselect("Features:", from: Feature.self)
// returns [Feature]

let description = try Promptberry.multiline(
    "Describe your project:",
    placeholder: "What does it do?",
    validate: { $0.isEmpty ? "Description required." : nil }
)

let pkg = try Promptberry.autocomplete(
    "Find package:",
    options: ["ArgumentParser", "AsyncHTTPClient", "Crypto", "NIO", "Vapor"],
    placeholder: "Type to filter..."
)

let server = try Promptberry.autocomplete(
    "Select server:",
    options: servers.map { SelectOption(value: $0, label: $0.hostname) }
)

let s = Promptberry.spinner()
await s.start("Installing packages...")

try await installPackages()    // your async work runs concurrently

await s.stop("Packages installed!")    // or s.error("Failed.")

await s.update("Almost there...")

let p = Promptberry.progress(total: files.count, message: "Copying files...")
for file in files {
    try await copy(file)
    await p.advance()
}
await p.complete("All files copied!")

await p.update(42, message: "Step 42...")

try await tasks([
    PromptTask("Scaffolding project structure") {
        try await scaffold()
    },
    PromptTask("Writing Package.swift") {
        try await writeManifest()
    },
    PromptTask("Installing dependencies") {
        try await installDeps()
    },
])

// Bordered info box
Promptberry.note("Line 1\nLine 2", title: "Important")

// Cancellation message
Promptberry.cancel("Setup aborted.")

// Semantic log lines (non-interactive)
log.info("Reading config...")
log.success("Build passed in 1.2s")
log.warning("Deprecated API used")
log.step("Running post-install hooks")
log.error("Connection refused (non-fatal)")

let profile = try Promptberry.group(
    onCancel: { _ in
        Promptberry.cancel("Cancelled.")
        exit(0)
    }
) {
    let email = try Promptberry.text("Email?")
    let age   = try Promptberry.text("Age?",
        validate: { Int($0) == nil ? "Enter a number." : nil })
    return (email: email, age: age)
}

"success".green.bold
"warning".yellow
"error".red
"hint".dim
"label".cyan.underline
"bg".onBlue

ColorSupport.enabled = false

ColorSupport.enabled = true
// or set FORCE_COLOR=1 in the environment