convoker 0.3.2 → 0.3.4

package/dist/log.js

@@ -1,216 +0,0 @@
-import { DEFAULT_THEME } from "./color";
-import { merge, isNode, isDeno, isBun } from "./utils";
-/**
- * Gets the default stdout, in a cross-runtime way.
- * @returns The default stdout.
- */
-async function getDefaultStdout() {
-    if (isNode && process.stdout?.writable) {
-        const { Writable } = await import("node:stream");
-        return Writable.toWeb(process.stdout);
-    }
-    if (isDeno && Deno.stdout?.writable) {
-        return Deno.stdout.writable;
-    }
-    if (isBun && Bun.stdout) {
-        return Bun.stdout;
-    }
-    // Workers: emulate with console.log
-    return new WritableStream({
-        write(chunk) {
-            console.log(String(chunk));
-        },
-    });
-}
-/**
- * Gets the default stderr, in a cross-runtime way.
- * @returns The default stderr.
- */
-async function getDefaultStderr() {
-    if (isNode && process.stderr?.writable) {
-        const { Writable } = await import("node:stream");
-        return Writable.toWeb(process.stderr);
-    }
-    if (isDeno && Deno.stderr?.writable) {
-        return Deno.stderr.writable;
-    }
-    if (isBun && Bun.stderr) {
-        return Bun.stderr;
-    }
-    // Workers: emulate with console.error
-    return new WritableStream({
-        write(chunk) {
-            console.error(String(chunk));
-        },
-    });
-}
-/**
- * Gets the default stdin, in a cross-runtime way.
- * @returns The default stdin.
- */
-async function getDefaultStdin() {
-    if (isNode && process.stdin?.readable) {
-        const { Readable } = await import("node:stream");
-        return Readable.toWeb(process.stdin);
-    }
-    if (isDeno && Deno.stdin?.readable) {
-        return Deno.stdin.readable;
-    }
-    if (isBun) {
-        return Bun.stdin.stream();
-    }
-    // Workers don't support stdin
-    return new ReadableStream({
-        start(controller) {
-            controller.close();
-        },
-    });
-}
-let theme = DEFAULT_THEME;
-let config = undefined;
-/**
- * Sets a new theme.
- * @param t The theme.
- */
-export function setTheme(t) {
-    theme = t;
-}
-/**
- * Sets new configuration.
- * @param c The config.
- */
-export async function setConfig(c) {
-    config = merge({
-        format: "text",
-        stdout: await getDefaultStdout(),
-        stderr: await getDefaultStderr(),
-        stdin: await getDefaultStdin(),
-    }, c);
-}
-/**
- * Sets default configuration.
- */
-export async function setup() {
-    await setConfig({});
-}
-/**
- * Formats a message to the correct format.
- * @param level The level of mesage.
- * @param msgs The messages to format.
- * @returns The formatted message.
- */
-function formatMessages(level, ...msgs) {
-    const timestamp = new Date().toISOString();
-    const msg = msgs
-        .map((m) => (typeof m === "string" ? m : JSON.stringify(m, null, 2)))
-        .join(" ");
-    switch (config.format) {
-        case "json":
-            return JSON.stringify({ timestamp, level, message: msg }) + "\n";
-        case "xml":
-            return `<log>
-  <timestamp>${timestamp}</timestamp>
-  <level>${level}</level>
-  <message>${msg}</message>
-</log>\n`;
-        case "yaml":
-            return `- timestamp: ${timestamp}
-  level: ${level}
-  message: "${msg.replace(/"/g, '\\"')}"\n`;
-        case "csv":
-            return `"${timestamp}","${level}","${msg.replace(/"/g, '""')}"\n`;
-        case "text":
-        default:
-            return `[${timestamp}] [${level.toUpperCase()}] ${msg}\n`;
-    }
-}
-/**
- * Colorizes text.
- * @param level The log level.
- * @param text The text to colorize.
- * @returns The colorized text.
- */
-function colorize(level, text) {
-    switch (level) {
-        case "trace":
-            return theme.secondary ? theme.secondary(text) : text;
-        case "info":
-            return theme.info ? theme.info(text) : text;
-        case "warn":
-            return theme.warning ? theme.warning(text) : text;
-        case "error":
-            return theme.error ? theme.error(text) : text;
-        case "fatal":
-            return theme.error
-                ? theme.error(theme.styles?.bold?.(text) ?? text)
-                : text;
-        default:
-            return text;
-    }
-}
-/**
- * Writes to a stream.
- * @param stream The stream to write to.
- * @param msg The message to write.
- */
-async function writeToStream(stream, msg) {
-    const writer = stream.getWriter();
-    try {
-        await writer.write(msg);
-    }
-    finally {
-        writer.releaseLock();
-    }
-}
-/**
- * Prints debug information.
- * @param msgs The messages to write.
- */
-export async function trace(...msgs) {
-    const formatted = formatMessages("trace", ...msgs);
-    const colored = colorize("trace", formatted);
-    await writeToStream(config.stdout, colored);
-}
-/**
- * Prints information.
- * @param msgs The messages to write.
- */
-export async function info(...msgs) {
-    const formatted = formatMessages("info", ...msgs);
-    const colored = colorize("info", formatted);
-    await writeToStream(config.stdout, colored);
-}
-/**
- * Prints warnings.
- * @param msgs The messages to write.
- */
-export async function warn(...msgs) {
-    const formatted = formatMessages("warn", ...msgs);
-    const colored = colorize("warn", formatted);
-    await writeToStream(config.stdout, colored);
-}
-/**
- * Prints errors.
- * @param msgs The messages to write.
- */
-export async function error(...msgs) {
-    const formatted = formatMessages("error", ...msgs);
-    const colored = colorize("error", formatted);
-    await writeToStream(config.stderr, colored);
-}
-/**
- * Prints errors and exits.
- * @param msgs The messages to write.
- */
-export async function fatal(...msgs) {
-    const formatted = formatMessages("fatal", ...msgs);
-    const colored = colorize("fatal", formatted);
-    await writeToStream(config.stderr, colored);
-    // Exit depending on runtime
-    if (isDeno) {
-        Deno.exit(-1);
-    }
-    else if (isNode || isBun) {
-        process.exit(-1);
-    }
-}

package/dist/prompt/index.d.ts

@@ -1,193 +0,0 @@
-import { type Theme } from "../color";
-import { type StandardSchemaV1 } from "../standard-schema";
-import * as raw from "./raw";
-/**
- * Sets the theme of the prompts.
- * @param t The new theme.
- */
-export declare function setTheme(t: Theme): void;
-/**
- * Base options for prompts.
- */
-export interface BaseOpts<T> {
-    /**
-     * The message of the prompt.
-     */
-    message: string;
-    /**
-     * An `AbortSignal` to cancel the prompt.
-     */
-    signal?: AbortSignal;
-    /**
-     * The default value.
-     */
-    default?: T;
-    /**
-     * The theme of the prompt.
-     */
-    theme?: Theme;
-    /**
-     * A validator function, or a Standard Schema validator.
-     */
-    validate?: StandardSchemaV1<any, T> | ((value: T) => boolean | T);
-}
-/**
- * Options for text input.
- */
-export interface TextOpts extends BaseOpts<string> {
-    /**
-     * A placeholder, displayed when the user hasn't typed anything yet.
-     */
-    placeholder?: string;
-    /**
-     * Minimum length of the input.
-     */
-    minLength?: number;
-    /**
-     * Maximum length of the input.
-     */
-    maxLength?: number;
-}
-/**
- * Prompts the user for text input.
- * @param opts Options for text input.
- * @returns The text the user typed in, or the default.
- */
-export declare function text(opts: TextOpts): Promise<string>;
-/**
- * Options for password input.
- */
-export interface PasswordOpts extends TextOpts {
-    /**
-     * The mask for the password input.
-     */
-    mask?: string;
-    /**
-     * If the user should be asked to confirm the password, by typing it again.
-     */
-    confirm?: boolean;
-}
-/**
- * Prompts the user for a password.
- * @param opts Options for password input.
- * @returns The password.
- */
-export declare function password(opts: PasswordOpts): Promise<string>;
-/**
- * An option for select input.
- */
-export interface SelectOption<T> {
-    /**
-     * The label (what gets displayed) of the select option.
-     */
-    label: string;
-    /**
-     * The value (what gets returned) of the select option.
-     */
-    value: T;
-    /**
-     * A description of the option.
-     */
-    hint?: string;
-    /**
-     * If this option is disabled.
-     */
-    disabled?: boolean;
-}
-/**
- * Options for select input.
- */
-export interface SelectOpts<T> extends BaseOpts<T> {
-    /**
-     * Every option the user can pick from.
-     */
-    options: SelectOption<T>[];
-    /**
-     * The initial option selected.
-     */
-    initialIndex?: number;
-}
-/**
- * Prompts the user to select a single option.
- * @param opts Options for select input.
- * @returns The selected option's value.
- */
-export declare function select<T>(opts: SelectOpts<T>): Promise<T>;
-/**
- * Prompts the user to select multiple options.
- * @param opts Options for select input.
- * @returns The selected options.
- */
-export declare function multiselect<T>(opts: SelectOpts<T>): Promise<T[]>;
-/**
- * Options for search input.
- */
-export interface SearchOpts<T> extends BaseOpts<T> {
-    /**
-     * Every option the user can search through.
-     */
-    options: SelectOption<T>[];
-    /**
-     * Placeholder for the search input.
-     */
-    placeholder?: string;
-    /**
-     * Minimum length for a query string.
-     */
-    minQueryLength?: number;
-    /**
-     * Filters a single option.
-     * @param query The search query.
-     * @param option The option to filter.
-     */
-    filter?(query: string, option: SelectOption<T>): boolean;
-}
-/**
- * Prompts the user to search through a list of options.
- * @param opts Options for search input.
- * @returns The selected option.
- */
-export declare function search<T>(opts: SearchOpts<T>): Promise<T>;
-/**
- * Options for confirm input.
- */
-export interface ConfirmOpts extends BaseOpts<boolean> {
-    /**
-     * What gets displayed for the Yes option.
-     */
-    yesLabel?: string;
-    /**
-     * What gets displayed for the No option.
-     */
-    noLabel?: string;
-}
-/**
- * Prompts the user to confirm an action.
- * @param opts Options for confirm input.
- * @returns If the user picked Yes.
- */
-export declare function confirm(opts: ConfirmOpts): Promise<boolean>;
-/**
- * Options for opening the system editor.
- */
-export interface EditorOpts extends BaseOpts<string> {
-    /**
-     * The initial value.
-     */
-    initial?: string;
-    /**
-     * The language of the value.
-     */
-    language?: string;
-    /**
-     * If the input is required for continuing or not.
-     */
-    required?: boolean;
-}
-/**
- * Opens the system editor, or asks for input in the terminal as fallback.
- * @param opts Options for opening the system editor.
- * @returns The result of the system editor.
- */
-export declare function editor(opts: EditorOpts): Promise<string>;
-export { raw };

package/dist/prompt/index.js

@@ -1,273 +0,0 @@
-import { DEFAULT_THEME } from "../color";
-import { validate } from "../standard-schema";
-import { InputValidationError } from "../error";
-import { isDeno, isNode, isBun } from "../utils";
-import * as raw from "./raw";
-let theme = DEFAULT_THEME;
-/**
- * Sets the theme of the prompts.
- * @param t The new theme.
- */
-export function setTheme(t) {
-    theme = t;
-}
-/**
- * Prompts the user for text input.
- * @param opts Options for text input.
- * @returns The text the user typed in, or the default.
- */
-export async function text(opts) {
-    const th = opts.theme ?? theme;
-    const message = th.primary(opts.message) + " ";
-    const answer = await raw.readLine(message, opts.default);
-    if (opts.minLength && answer.length < opts.minLength)
-        throw new InputValidationError([
-            `Must be at least ${opts.minLength} characters`,
-        ]);
-    if (opts.maxLength && answer.length > opts.maxLength)
-        throw new InputValidationError([
-            `Must be at most ${opts.maxLength} characters`,
-        ]);
-    if (typeof opts.validate === "function") {
-        if (!opts.validate(answer))
-            throw new InputValidationError([
-                "Validation function returned a falsy value",
-            ]);
-    }
-    else if (opts.validate) {
-        validate(opts.validate, answer);
-    }
-    return answer;
-}
-/**
- * Prompts the user for a password.
- * @param opts Options for password input.
- * @returns The password.
- */
-export async function password(opts) {
-    const th = opts.theme ?? theme;
-    const first = await raw.readLine(th.primary(opts.message) + " ", undefined, {
-        masked: true,
-        maskChar: opts.mask ?? "*",
-    });
-    if (opts.confirm) {
-        const second = await raw.readLine(th.secondary("Confirm password: "), undefined, {
-            masked: true,
-            maskChar: opts.mask ?? "*",
-        });
-        if (first !== second)
-            throw new Error(th.error("Passwords do not match"));
-    }
-    return first;
-}
-/**
- * Prompts the user to select a single option.
- * @param opts Options for select input.
- * @returns The selected option's value.
- */
-export async function select(opts) {
-    const th = opts.theme ?? theme;
-    const options = opts.options;
-    let index = opts.initialIndex ?? 0;
-    const render = () => {
-        raw.clearLines(options.length + 1);
-        console.log(th.primary(opts.message));
-        for (let i = 0; i < options.length; i++) {
-            const o = options[i];
-            const prefix = i === index ? (th.accent?.("> ") ?? "> ") : "  ";
-            const label = o.disabled
-                ? th.secondary(o.label)
-                : (th.foreground?.(o.label) ?? o.label);
-            console.log(prefix + label);
-        }
-    };
-    console.log(th.primary(opts.message));
-    options.forEach((o, i) => console.log(`${i === index ? "> " : "  "}${o.label}`));
-    while (true) {
-        const key = await raw.readKey();
-        if (key === "up" && index > 0)
-            index--;
-        else if (key === "down" && index < options.length - 1)
-            index++;
-        else if (key === "enter") {
-            const choice = options[index];
-            if (choice.disabled)
-                continue;
-            raw.clearLines(options.length + 1);
-            console.log(th.success(`${th.symbols?.success ?? "✔"} ${choice.label}`));
-            return choice.value;
-        }
-        render();
-    }
-}
-/**
- * Prompts the user to select multiple options.
- * @param opts Options for select input.
- * @returns The selected options.
- */
-export async function multiselect(opts) {
-    const th = opts.theme ?? theme;
-    const options = opts.options;
-    let index = opts.initialIndex ?? 0;
-    const selected = new Set();
-    const render = () => {
-        raw.clearLines();
-        console.log(th.primary(opts.message));
-        options.forEach((opt, i) => {
-            const prefix = i === index ? (th.accent?.("> ") ?? "> ") : "  ";
-            const mark = selected.has(i) ? th.success("[x]") : "[ ]";
-            console.log(prefix + mark + " " + opt.label);
-        });
-    };
-    render();
-    while (true) {
-        const key = await raw.readKey();
-        if (key === "up" && index > 0)
-            index--;
-        else if (key === "down" && index < options.length - 1)
-            index++;
-        else if (key === "space") {
-            if (selected.has(index))
-                selected.delete(index);
-            else
-                selected.add(index);
-        }
-        else if (key === "return") {
-            const chosen = Array.from(selected).map((i) => options[i].value);
-            raw.clearLines(options.length + 1);
-            console.log(th.success(`${opts.message} ${chosen.length} selected`));
-            return chosen;
-        }
-        raw.cursorUp(options.length);
-        render();
-    }
-}
-/**
- * Prompts the user to search through a list of options.
- * @param opts Options for search input.
- * @returns The selected option.
- */
-export async function search(opts) {
-    const th = opts.theme ?? theme;
-    let query = "";
-    const filter = opts.filter ?? ((q, o) => o.label.toLowerCase().includes(q.toLowerCase()));
-    while (true) {
-        raw.clearLines();
-        console.log(th.primary(opts.message));
-        const matches = opts.options.filter((o) => filter(query, o));
-        matches.forEach((o) => console.log("  " + (th.foreground?.(o.label) ?? o.label)));
-        const input = await raw.readLine(th.secondary(`Search: ${query}`));
-        if (input === "")
-            continue;
-        query = input;
-        if (matches.length === 1)
-            return matches[0].value;
-    }
-}
-/**
- * Prompts the user to confirm an action.
- * @param opts Options for confirm input.
- * @returns If the user picked Yes.
- */
-export async function confirm(opts) {
-    const th = opts.theme ?? theme;
-    const yes = opts.yesLabel ?? "y";
-    const no = opts.noLabel ?? "n";
-    const def = opts.default ? yes : no;
-    const res = await raw.readLine(`${th.primary(opts.message)} ${th.secondary(`[${yes}/${no}] (default: ${def})`)} `);
-    if (!res)
-        return !!opts.default;
-    return /^y/i.test(res.trim());
-}
-/**
- * Opens the system editor, or asks for input in the terminal as fallback.
- * @param opts Options for opening the system editor.
- * @returns The result of the system editor.
- */
-export async function editor(opts) {
-    const th = opts.theme ?? {
-        primary: (s) => s,
-        secondary: (s) => s,
-    };
-    console.log(th.primary(opts.message ?? "Please enter text:"));
-    console.log(th.secondary("Press Ctrl+D (or save & close editor) when done."));
-    try {
-        const result = await openSystemEditor(opts.initial ?? "");
-        if (opts.required && !result.trim())
-            throw new Error("Input required.");
-        return result;
-    }
-    catch {
-        // fallback: cross-runtime multiline input
-        const value = await raw.readLine("", opts.initial, { multiline: true });
-        if (opts.required && !value.trim())
-            throw new Error("Input required.");
-        return value;
-    }
-}
-/**
- * Opens the system editor on a temporary file.
- * @param initial Initial contents of the file.
- * @returns The contents of the file after saving.
- */
-async function openSystemEditor(initial) {
-    const tmpFile = `edit-${Date.now()}.txt`;
-    if (isDeno) {
-        const tmpDir = Deno.env.get("TMPDIR") ?? "/tmp";
-        const path = `${tmpDir}/${tmpFile}`;
-        await Deno.writeTextFile(path, initial ?? "");
-        const editor = Deno.env.get("EDITOR") ?? "vi";
-        const p = new Deno.Command(editor, {
-            args: [path],
-            stdin: "inherit",
-            stdout: "inherit",
-            stderr: "inherit",
-        }).spawn();
-        const status = await p.status;
-        if (!status.success)
-            throw new Error(`${editor} exited with ${status.code}`);
-        const text = await Deno.readTextFile(path);
-        await Deno.remove(path).catch(() => { });
-        return text;
-    }
-    if (isBun) {
-        const { $ } = await import("bun");
-        const path = `/tmp/${tmpFile}`;
-        await Bun.write(path, initial ?? "");
-        const editor = process.env.EDITOR ?? "vi";
-        await $ `${editor} ${path}`;
-        const text = await Bun.file(path).text();
-        await Bun.write(path, ""); // or remove if supported
-        return text;
-    }
-    if (isNode) {
-        const { tmpdir } = await import("node:os");
-        const { join } = await import("node:path");
-        const { promises: fs } = await import("node:fs");
-        const { spawn } = await import("node:child_process");
-        const path = join(tmpdir(), tmpFile);
-        await fs.writeFile(path, initial ?? "", "utf8");
-        const editor = process.env.EDITOR ||
-            process.env.VISUAL ||
-            (process.platform === "win32" ? "notepad" : "vi");
-        return new Promise((resolve, reject) => {
-            const child = spawn(editor, [path], { stdio: "inherit" });
-            child.on("exit", async (code) => {
-                if (code !== 0) {
-                    reject(new Error(`${editor} exited with code ${code}`));
-                    return;
-                }
-                try {
-                    const data = await fs.readFile(path, "utf8");
-                    await fs.unlink(path).catch(() => { });
-                    resolve(data);
-                }
-                catch (err) {
-                    reject(err);
-                }
-            });
-        });
-    }
-    throw new Error("Unsupported runtime for system editor.");
-}
-export { raw };

package/dist/prompt/raw.d.ts

@@ -1,32 +0,0 @@
-/**
- * Reads a line from standard input.
- * @param message The message.
- * @param def Default value.
- * @param opts Options for reading a line.
- * @returns The line that was read.
- */
-export declare function readLine(message?: string, def?: string, opts?: {
-    masked?: boolean;
-    maskChar?: string;
-    multiline?: boolean;
-}): Promise<string>;
-/**
- * Reads a single key from stdin.
- * @returns The key that was read.
- */
-export declare function readKey(): Promise<string>;
-/**
- * Clears `lines` amount of lines.
- * @param lines Amount of lines to clear.
- */
-export declare function clearLines(lines?: number): void;
-/**
- * Moves the cursor up `n` times.
- * @param n The amount of steps to move.
- */
-export declare function cursorUp(n?: number): void;
-/**
- * Moves the cursor down `n` times.
- * @param n The amount of steps to move.
- */
-export declare function cursorDown(n?: number): void;