semola 0.5.2 → 0.5.4

package/dist/lib/prompts/index.d.cts

@@ -1,23 +1,89 @@
-import { PromptRuntime } from "../../prompts/core/types.cjs";
-import { ConfirmOptions, InputOptions, MultiselectOptions, NumberOptions, PasswordOptions, PromptErrorType, SelectChoice, SelectOptions } from "../../prompts/types.cjs";
+import { i as ok, t as err } from "../../index-DxSbeGP-.cjs";
 
+//#region src/lib/prompts/core/types.d.ts
+type PromptResultLike<T> = ReturnType<typeof err<string>> | ReturnType<typeof ok<T>>;
+type KeyName = "character" | "enter" | "backspace" | "delete" | "up" | "down" | "left" | "right" | "ctrl_left" | "ctrl_right" | "shift_left" | "shift_right" | "space" | "escape" | "ctrl_c" | "ctrl_backspace" | "ctrl_a" | "home" | "end" | "shift_ctrl_left" | "shift_ctrl_right" | "tab";
+type Key = {
+  name: KeyName;
+  value?: string;
+};
+type PromptRuntime = {
+  isInteractive: () => boolean;
+  init: () => PromptResultLike<void>;
+  readKey: () => Promise<PromptResultLike<Key>>;
+  render: (frame: string) => PromptResultLike<void>;
+  done: (frame: string) => PromptResultLike<void>;
+  close: () => PromptResultLike<void>;
+  interrupt?: (message: string) => PromptResultLike<undefined>;
+};
+//#endregion
+//#region src/lib/prompts/types.d.ts
+type PromptErrorType = "PromptEnvironmentError" | "PromptValidationError" | "PromptCancelledError" | "PromptIOError" | (string & {});
+type MaybePromise<T> = T | Promise<T>;
+type Validate<TValue> = ((value: TValue) => MaybePromise<string | null | undefined>) | undefined;
+type Transform<TValue> = ((value: TValue) => MaybePromise<TValue>) | undefined;
+type BasePromptOptions<TValue> = {
+  message: string;
+  validate?: Validate<TValue>;
+  transform?: Transform<TValue>;
+};
+type InputOptions = BasePromptOptions<string> & {
+  defaultValue?: string;
+  placeholder?: string;
+  required?: boolean;
+  requiredMessage?: string;
+};
+type PasswordOptions = InputOptions & {
+  mask?: string;
+};
+type ConfirmOptions = BasePromptOptions<boolean> & {
+  defaultValue?: boolean;
+  activeLabel?: string;
+  inactiveLabel?: string;
+};
+type NumberOptions = BasePromptOptions<number> & {
+  defaultValue?: number;
+  min?: number;
+  max?: number;
+  requiredMessage?: string;
+  invalidMessage?: string;
+  minMessage?: string;
+  maxMessage?: string;
+};
+type SelectChoice<TValue extends string> = {
+  value: TValue;
+  label?: string;
+  hint?: string;
+  disabled?: boolean;
+};
+type SelectOptions<TValue extends string> = BasePromptOptions<TValue> & {
+  choices: readonly [SelectChoice<TValue>, ...SelectChoice<TValue>[]];
+  defaultValue?: TValue;
+};
+type MultiselectOptions<TValue extends string> = BasePromptOptions<TValue[]> & {
+  choices: readonly [SelectChoice<TValue>, ...SelectChoice<TValue>[]];
+  defaultValue?: readonly TValue[];
+  min?: number;
+  max?: number;
+};
+//#endregion
 //#region src/lib/prompts/index.d.ts
-declare const input: (options: InputOptions, runtime?: PromptRuntime) => Promise<readonly [{
+declare const input: (options: InputOptions, runtime?: PromptRuntime) => Promise<readonly [null, string] | readonly [{
   readonly type: string;
   readonly message: string;
-}, null] | readonly [null, string]>;
-declare const password: (options: PasswordOptions, runtime?: PromptRuntime) => Promise<readonly [{
+}, null]>;
+declare const password: (options: PasswordOptions, runtime?: PromptRuntime) => Promise<readonly [null, string] | readonly [{
   readonly type: string;
   readonly message: string;
-}, null] | readonly [null, string]>;
-declare const confirm: (options: ConfirmOptions, runtime?: PromptRuntime) => Promise<readonly [{
+}, null]>;
+declare const confirm: (options: ConfirmOptions, runtime?: PromptRuntime) => Promise<readonly [null, boolean] | readonly [{
   readonly type: string;
   readonly message: string;
-}, null] | readonly [null, boolean]>;
-declare const number: (options: NumberOptions, runtime?: PromptRuntime) => Promise<readonly [{
+}, null]>;
+declare const number: (options: NumberOptions, runtime?: PromptRuntime) => Promise<readonly [null, number] | readonly [{
   readonly type: string;
   readonly message: string;
-}, null] | readonly [null, number]>;
+}, null]>;
 declare const select: <TValue extends string>(options: SelectOptions<TValue>, runtime?: PromptRuntime) => Promise<readonly [{
   readonly type: string;
   readonly message: string;
@@ -27,5 +93,4 @@ declare const multiselect: <TValue extends string>(options: MultiselectOptions<T
   readonly message: string;
 }, null] | readonly [null, TValue[]]>;
 //#endregion
-export { type ConfirmOptions, type InputOptions, type MultiselectOptions, type NumberOptions, type PasswordOptions, type PromptErrorType, type PromptRuntime, type SelectChoice, type SelectOptions, confirm, input, multiselect, number, password, select };
-//# sourceMappingURL=index.d.cts.map
+export { type ConfirmOptions, type InputOptions, type MultiselectOptions, type NumberOptions, type PasswordOptions, type PromptErrorType, type PromptRuntime, type SelectChoice, type SelectOptions, confirm, input, multiselect, number, password, select };

package/dist/lib/prompts/index.d.mts

@@ -1,23 +1,89 @@
-import { PromptRuntime } from "../../prompts/core/types.mjs";
-import { ConfirmOptions, InputOptions, MultiselectOptions, NumberOptions, PasswordOptions, PromptErrorType, SelectChoice, SelectOptions } from "../../prompts/types.mjs";
+import { i as ok, t as err } from "../../index-BhGNDjPq.mjs";
 
+//#region src/lib/prompts/core/types.d.ts
+type PromptResultLike<T> = ReturnType<typeof err<string>> | ReturnType<typeof ok<T>>;
+type KeyName = "character" | "enter" | "backspace" | "delete" | "up" | "down" | "left" | "right" | "ctrl_left" | "ctrl_right" | "shift_left" | "shift_right" | "space" | "escape" | "ctrl_c" | "ctrl_backspace" | "ctrl_a" | "home" | "end" | "shift_ctrl_left" | "shift_ctrl_right" | "tab";
+type Key = {
+  name: KeyName;
+  value?: string;
+};
+type PromptRuntime = {
+  isInteractive: () => boolean;
+  init: () => PromptResultLike<void>;
+  readKey: () => Promise<PromptResultLike<Key>>;
+  render: (frame: string) => PromptResultLike<void>;
+  done: (frame: string) => PromptResultLike<void>;
+  close: () => PromptResultLike<void>;
+  interrupt?: (message: string) => PromptResultLike<undefined>;
+};
+//#endregion
+//#region src/lib/prompts/types.d.ts
+type PromptErrorType = "PromptEnvironmentError" | "PromptValidationError" | "PromptCancelledError" | "PromptIOError" | (string & {});
+type MaybePromise<T> = T | Promise<T>;
+type Validate<TValue> = ((value: TValue) => MaybePromise<string | null | undefined>) | undefined;
+type Transform<TValue> = ((value: TValue) => MaybePromise<TValue>) | undefined;
+type BasePromptOptions<TValue> = {
+  message: string;
+  validate?: Validate<TValue>;
+  transform?: Transform<TValue>;
+};
+type InputOptions = BasePromptOptions<string> & {
+  defaultValue?: string;
+  placeholder?: string;
+  required?: boolean;
+  requiredMessage?: string;
+};
+type PasswordOptions = InputOptions & {
+  mask?: string;
+};
+type ConfirmOptions = BasePromptOptions<boolean> & {
+  defaultValue?: boolean;
+  activeLabel?: string;
+  inactiveLabel?: string;
+};
+type NumberOptions = BasePromptOptions<number> & {
+  defaultValue?: number;
+  min?: number;
+  max?: number;
+  requiredMessage?: string;
+  invalidMessage?: string;
+  minMessage?: string;
+  maxMessage?: string;
+};
+type SelectChoice<TValue extends string> = {
+  value: TValue;
+  label?: string;
+  hint?: string;
+  disabled?: boolean;
+};
+type SelectOptions<TValue extends string> = BasePromptOptions<TValue> & {
+  choices: readonly [SelectChoice<TValue>, ...SelectChoice<TValue>[]];
+  defaultValue?: TValue;
+};
+type MultiselectOptions<TValue extends string> = BasePromptOptions<TValue[]> & {
+  choices: readonly [SelectChoice<TValue>, ...SelectChoice<TValue>[]];
+  defaultValue?: readonly TValue[];
+  min?: number;
+  max?: number;
+};
+//#endregion
 //#region src/lib/prompts/index.d.ts
-declare const input: (options: InputOptions, runtime?: PromptRuntime) => Promise<readonly [{
+declare const input: (options: InputOptions, runtime?: PromptRuntime) => Promise<readonly [null, string] | readonly [{
   readonly type: string;
   readonly message: string;
-}, null] | readonly [null, string]>;
-declare const password: (options: PasswordOptions, runtime?: PromptRuntime) => Promise<readonly [{
+}, null]>;
+declare const password: (options: PasswordOptions, runtime?: PromptRuntime) => Promise<readonly [null, string] | readonly [{
   readonly type: string;
   readonly message: string;
-}, null] | readonly [null, string]>;
-declare const confirm: (options: ConfirmOptions, runtime?: PromptRuntime) => Promise<readonly [{
+}, null]>;
+declare const confirm: (options: ConfirmOptions, runtime?: PromptRuntime) => Promise<readonly [null, boolean] | readonly [{
   readonly type: string;
   readonly message: string;
-}, null] | readonly [null, boolean]>;
-declare const number: (options: NumberOptions, runtime?: PromptRuntime) => Promise<readonly [{
+}, null]>;
+declare const number: (options: NumberOptions, runtime?: PromptRuntime) => Promise<readonly [null, number] | readonly [{
   readonly type: string;
   readonly message: string;
-}, null] | readonly [null, number]>;
+}, null]>;
 declare const select: <TValue extends string>(options: SelectOptions<TValue>, runtime?: PromptRuntime) => Promise<readonly [{
   readonly type: string;
   readonly message: string;
@@ -27,5 +93,4 @@ declare const multiselect: <TValue extends string>(options: MultiselectOptions<T
   readonly message: string;
 }, null] | readonly [null, TValue[]]>;
 //#endregion
-export { type ConfirmOptions, type InputOptions, type MultiselectOptions, type NumberOptions, type PasswordOptions, type PromptErrorType, type PromptRuntime, type SelectChoice, type SelectOptions, confirm, input, multiselect, number, password, select };
-//# sourceMappingURL=index.d.mts.map
+export { type ConfirmOptions, type InputOptions, type MultiselectOptions, type NumberOptions, type PasswordOptions, type PromptErrorType, type PromptRuntime, type SelectChoice, type SelectOptions, confirm, input, multiselect, number, password, select };

package/dist/lib/prompts/index.mjs

@@ -1,6 +1,366 @@
-import { createNodePromptRuntime } from "../../prompts/core/runtime.mjs";
-import { runPromptSession } from "../../prompts/core/session.mjs";
+import { err, mightThrow, mightThrowSync, ok } from "../errors/index.mjs";
 import { styleText } from "node:util";
+//#region src/lib/prompts/core/keys.ts
+const ESC = "\x1B";
+const CSI = "\x1B[";
+const ESC_BACKSPACE = `${ESC}\u007F`;
+const CHAR_KEY_MAP = new Map(Object.values({
+	enterCr: {
+		value: "\r",
+		name: "enter"
+	},
+	enterLf: {
+		value: "\n",
+		name: "enter"
+	},
+	ctrlA: {
+		value: "
",
+		name: "ctrl_a"
+	},
+	ctrlC: {
+		value: "",
+		name: "ctrl_c"
+	},
+	ctrlBackspace: {
+		value: "",
+		name: "ctrl_backspace"
+	},
+	backspace: {
+		value: "",
+		name: "backspace"
+	},
+	tab: {
+		value: "	",
+		name: "tab"
+	},
+	space: {
+		value: " ",
+		name: "space"
+	}
+}).map((entry) => [entry.value, { name: entry.name }]));
+const KNOWN_SEQUENCES = [
+	{
+		sequence: "\x1B[1;2D",
+		key: { name: "shift_left" }
+	},
+	{
+		sequence: "\x1B[1;2C",
+		key: { name: "shift_right" }
+	},
+	{
+		sequence: "\x1B[1;5D",
+		key: { name: "ctrl_left" }
+	},
+	{
+		sequence: "\x1B[1;5C",
+		key: { name: "ctrl_right" }
+	},
+	{
+		sequence: "\x1B[1;6D",
+		key: { name: "shift_ctrl_left" }
+	},
+	{
+		sequence: "\x1B[1;6C",
+		key: { name: "shift_ctrl_right" }
+	},
+	{
+		sequence: "\x1B[3~",
+		key: { name: "delete" }
+	},
+	{
+		sequence: "\x1B[H",
+		key: { name: "home" }
+	},
+	{
+		sequence: "\x1B[F",
+		key: { name: "end" }
+	},
+	{
+		sequence: "\x1B[A",
+		key: { name: "up" }
+	},
+	{
+		sequence: "\x1B[B",
+		key: { name: "down" }
+	},
+	{
+		sequence: "\x1B[C",
+		key: { name: "right" }
+	},
+	{
+		sequence: "\x1B[D",
+		key: { name: "left" }
+	}
+];
+const isControlChar = (char) => {
+	return char <= "" || char === "";
+};
+const isCsiFinalByte = (char) => {
+	if (!char) return false;
+	if (char >= "A" && char <= "Z") return true;
+	if (char >= "a" && char <= "z") return true;
+	if (char === "~") return true;
+	return false;
+};
+const readCsiLength = (remaining) => {
+	if (!remaining.startsWith(CSI)) return null;
+	let index = 2;
+	while (index < remaining.length) {
+		if (isCsiFinalByte(remaining[index] ?? "")) return {
+			length: index + 1,
+			incomplete: false
+		};
+		index += 1;
+	}
+	return {
+		length: 0,
+		incomplete: true
+	};
+};
+const parseKeys = (chunk) => {
+	const keys = [];
+	let cursor = 0;
+	while (cursor < chunk.length) {
+		const remaining = chunk.slice(cursor);
+		if (remaining.startsWith(ESC_BACKSPACE)) {
+			keys.push({ name: "ctrl_backspace" });
+			cursor += 2;
+			continue;
+		}
+		const knownSequence = KNOWN_SEQUENCES.find((entry) => remaining.startsWith(entry.sequence));
+		if (knownSequence) {
+			keys.push(knownSequence.key);
+			cursor += knownSequence.sequence.length;
+			continue;
+		}
+		const csiLength = readCsiLength(remaining);
+		if (csiLength) {
+			if (csiLength.incomplete) return {
+				keys,
+				remaining: chunk.slice(cursor)
+			};
+			cursor += csiLength.length;
+			continue;
+		}
+		const char = chunk[cursor] ?? "";
+		switch (char) {
+			case ESC:
+				if (cursor === chunk.length - 1) keys.push({ name: "escape" });
+				break;
+			default: {
+				const key = CHAR_KEY_MAP.get(char);
+				if (key) keys.push(key);
+				else if (!isControlChar(char)) keys.push({
+					name: "character",
+					value: char
+				});
+			}
+		}
+		cursor += 1;
+	}
+	return {
+		keys,
+		remaining: ""
+	};
+};
+//#endregion
+//#region src/lib/prompts/core/runtime.ts
+const HIDE_CURSOR = "\x1B[?25l";
+const SHOW_CURSOR = "\x1B[?25h";
+const countLines = (text) => {
+	let count = 1;
+	for (let i = 0; i < text.length; i++) if (text[i] === "\n") count += 1;
+	return count;
+};
+var NodePromptRuntime = class {
+	stdin;
+	stdout;
+	queue = [];
+	waiters = [];
+	initialized = false;
+	previousLines = 0;
+	buffer = "";
+	constructor(stdin = process.stdin, stdout = process.stdout) {
+		this.stdin = stdin;
+		this.stdout = stdout;
+	}
+	isInteractive() {
+		return Boolean(this.stdin.isTTY && this.stdout.isTTY && typeof this.stdin.setRawMode === "function");
+	}
+	init() {
+		if (!this.isInteractive()) return err("PromptEnvironmentError", "Interactive prompts require a TTY with raw mode support");
+		if (this.initialized) return ok(void 0);
+		const [initError] = mightThrowSync(() => {
+			this.stdin.setRawMode(true);
+			this.stdin.setEncoding("utf8");
+			this.stdin.resume();
+			this.stdin.on("data", this.onData);
+			this.stdout.write(HIDE_CURSOR);
+		});
+		if (initError) return err("PromptIOError", "Unable to initialize prompt runtime");
+		this.initialized = true;
+		return ok(void 0);
+	}
+	readKey() {
+		const queued = this.queue.shift();
+		if (queued) return Promise.resolve(ok(queued));
+		return new Promise((resolve) => {
+			this.waiters.push(resolve);
+		});
+	}
+	render(frame) {
+		const [renderError] = mightThrowSync(() => {
+			if (this.previousLines > 1) this.stdout.write(`\u001B[${this.previousLines - 1}A`);
+			this.stdout.write("\r\x1B[J");
+			this.stdout.write(frame);
+			this.previousLines = countLines(frame);
+		});
+		if (renderError) return err("PromptIOError", "Unable to render prompt frame");
+		return ok(void 0);
+	}
+	done(frame) {
+		const [doneError] = mightThrowSync(() => {
+			if (this.previousLines > 1) this.stdout.write(`\u001B[${this.previousLines - 1}A`);
+			this.stdout.write("\r\x1B[J");
+			this.stdout.write(`${frame}\n`);
+			this.previousLines = 0;
+		});
+		if (doneError) return err("PromptIOError", "Unable to finalize prompt frame");
+		return ok(void 0);
+	}
+	close() {
+		if (!this.initialized) return ok(void 0);
+		this.initialized = false;
+		const [closeError] = mightThrowSync(() => {
+			this.stdin.off("data", this.onData);
+			this.stdin.setRawMode(false);
+			this.stdin.pause?.();
+			this.stdout.write(SHOW_CURSOR);
+		});
+		if (closeError) return err("PromptIOError", "Unable to close prompt runtime");
+		return ok(void 0);
+	}
+	interrupt() {
+		this.close();
+		process.exit(0);
+	}
+	onData = (chunk) => {
+		const value = typeof chunk === "string" ? chunk : chunk.toString("utf8");
+		const combined = `${this.buffer}${value}`;
+		this.buffer = "";
+		const [parseError, result] = mightThrowSync(() => parseKeys(combined));
+		if (parseError || !result) {
+			for (const waiter of this.waiters.splice(0)) waiter(err("PromptIOError", "Failed to parse input"));
+			return;
+		}
+		this.buffer = result.remaining;
+		for (const key of result.keys) {
+			const waiter = this.waiters.shift();
+			if (waiter) waiter(ok(key));
+			else this.queue.push(key);
+		}
+	};
+};
+const createNodePromptRuntime = () => {
+	return new NodePromptRuntime();
+};
+//#endregion
+//#region src/lib/prompts/core/session.ts
+const CANCEL_MESSAGE = "Interrupted, bye!";
+const resolveOutput = async (options, value) => {
+	if (!options.transform) return ok(value);
+	const [transformError, transformed] = await mightThrow(Promise.resolve().then(() => options.transform?.(value)));
+	if (transformError || transformed === null || transformed === void 0) return err("PromptIOError", "Prompt transform callback failed unexpectedly");
+	return ok(transformed);
+};
+const runValidation = async (options, value) => {
+	if (!options.validate) return ok(null);
+	const [validationError, validationMessage] = await mightThrow(Promise.resolve().then(() => options.validate?.(value)));
+	if (validationError) return err("PromptIOError", "Prompt validate callback failed unexpectedly");
+	if (typeof validationMessage === "string" && validationMessage.length > 0) return ok(validationMessage);
+	return ok(null);
+};
+const isCancelKey = (key) => {
+	if (key.name === "ctrl_c") return true;
+	if (key.name === "escape") return true;
+	return false;
+};
+const runPromptSession = async (params) => {
+	const [initError] = params.runtime.init();
+	if (initError) return err(initError.type, initError.message);
+	let state = params.initialState;
+	let errorMessage = null;
+	const closeAndDone = (message) => {
+		const [closeErr] = params.runtime.close();
+		if (closeErr) return err(closeErr.type, closeErr.message);
+		const [doneErr] = params.runtime.done(message);
+		if (doneErr) return err(doneErr.type, doneErr.message);
+		return null;
+	};
+	while (true) {
+		const [renderError] = params.runtime.render(params.render({
+			options: params.options,
+			state,
+			errorMessage
+		}));
+		if (renderError) {
+			params.runtime.close();
+			return err(renderError.type, renderError.message);
+		}
+		const [readError, key] = await params.runtime.readKey();
+		if (readError || !key) {
+			params.runtime.close();
+			return err(readError?.type ?? "PromptIOError", readError?.message ?? "Unable to read prompt input");
+		}
+		if (isCancelKey(key)) {
+			const [closeError] = params.runtime.close();
+			if (closeError) return err(closeError.type, closeError.message);
+			const [doneError] = params.runtime.done(`✖ ${CANCEL_MESSAGE}`);
+			if (doneError) return err(doneError.type, doneError.message);
+			if (params.runtime.interrupt) {
+				const [interruptError] = params.runtime.interrupt(CANCEL_MESSAGE);
+				if (interruptError) return err(interruptError.type, interruptError.message);
+			}
+			return err("PromptCancelledError", CANCEL_MESSAGE);
+		}
+		if (key.name !== "enter") {
+			state = params.onKey(state, key);
+			errorMessage = null;
+			continue;
+		}
+		const submitResult = params.onSubmit(state);
+		if ("errorMessage" in submitResult) {
+			errorMessage = submitResult.errorMessage;
+			continue;
+		}
+		const rawValue = submitResult.value;
+		const [validationRunError, validationErrorMessage] = await runValidation(params.options, rawValue);
+		if (validationRunError) {
+			const closeDoneErr = closeAndDone(`✖ ${params.options.message}`);
+			if (closeDoneErr) return closeDoneErr;
+			return err(validationRunError.type, validationRunError.message);
+		}
+		if (validationErrorMessage) {
+			errorMessage = validationErrorMessage;
+			continue;
+		}
+		const [transformError, finalValue] = await resolveOutput(params.options, rawValue);
+		if (transformError) {
+			const closeDoneErr = closeAndDone(`✖ ${params.options.message}`);
+			if (closeDoneErr) return closeDoneErr;
+			return err(transformError.type, transformError.message);
+		}
+		if (finalValue === null) return err("PromptIOError", "Unable to transform prompt value");
+		const closeDoneErr = closeAndDone(params.complete({
+			options: params.options,
+			state,
+			value: finalValue
+		}));
+		if (closeDoneErr) return closeDoneErr;
+		return ok(finalValue);
+	}
+};
+//#endregion
 //#region src/lib/prompts/index.ts
 const pointer = (active) => {
 	return active ? paint("cyan", "❯") : " ";
@@ -401,5 +761,3 @@ const multiselect = async (options, runtime) => {
 };
 //#endregion
 export { confirm, input, multiselect, number, password, select };
-
-//# sourceMappingURL=index.mjs.map