@jakubmazanec/cli 0.5.4-next.cad63bdb → 0.5.4-unstable.2468857d

package/build/_virtual/rolldown_runtime.js

@@ -0,0 +1,18 @@
+//#region rolldown:runtime
+var __defProp = Object.defineProperty;
+var __export = (all, symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+
+//#endregion
+export { __export };

package/build/constants.js

@@ -1,8 +1,10 @@
-"use strict";
 import path from "node:path";
 import url from "node:url";
+
+//#region source/constants.ts
 let directory = path.dirname(url.fileURLToPath(import.meta.url));
-export const PACKAGE_PATH = path.resolve(directory, "..");
-export const CACHE_PATH = path.resolve(PACKAGE_PATH, "node_modules/.cache");
-export const DELIMITER = "$ ";
-//# sourceMappingURL=constants.js.map
+const PACKAGE_PATH = path.resolve(directory, "..");
+const CACHE_PATH = path.resolve(PACKAGE_PATH, "node_modules/.cache");
+
+//#endregion
+export { CACHE_PATH };

package/build/main.js

@@ -1,4 +1,18 @@
-"use strict";
-export * from "./program.js";
-export * from "./ui.js";
-//# sourceMappingURL=main.js.map
+import { Command } from "./program/Command.js";
+import { getProgramDetail } from "./program/getProgramDetail.js";
+import { colors_exports } from "./ui/colors.js";
+import { getErrorDetail } from "./ui/getErrorDetail.js";
+import { Spinner } from "./ui/Spinner.js";
+import { Header } from "./ui/Header.js";
+import { icons_exports } from "./ui/icons.js";
+import { Failure } from "./ui/Failure.js";
+import { SelectInput } from "./ui/form/SelectInput.js";
+import { TextInput } from "./ui/form/TextInput.js";
+import { FormRow } from "./ui/form/FormRow.js";
+import { createForm } from "./ui/form/createForm.js";
+import { Help } from "./ui/Help.js";
+import { useProgram } from "./ui/useProgram.js";
+import { ProgramError } from "./program/ProgramError.js";
+import { Program } from "./program/Program.js";
+
+export { Command, Failure, FormRow, Header, Help, Program, ProgramError, SelectInput, Spinner, TextInput, colors_exports as colors, createForm, getErrorDetail, getProgramDetail, icons_exports as icons, useProgram };

package/build/program/Command.js

@@ -1,70 +1,54 @@
-"use strict";
-import {
-  parseArguments
-} from "@jakubmazanec/args";
-export class Command {
-  name;
-  description;
-  parameters;
-  options;
-  allowUnknownOptions;
-  allowUnknownParameters;
-  action;
-  /**
-   * @param name Command name, ie. space-separated words consisting only of letters, numbers (but not at the start of the word) or dashes.
-   * @param action Function that runs when command is executed.
-   * @param options Additionl command options.
-   */
-  constructor(name, action, {
-    description,
-    parameters,
-    options,
-    allowUnknownOptions,
-    allowUnknownParameters
-  }) {
-    this.name = name;
-    this.action = action;
-    if (description) {
-      this.description = description;
-    }
-    if (parameters) {
-      this.parameters = parameters;
-    } else {
-      this.parameters = null;
-    }
-    if (options) {
-      this.options = options;
-    } else {
-      this.options = null;
-    }
-    if (allowUnknownOptions) {
-      this.allowUnknownOptions = allowUnknownOptions;
-    } else {
-      this.allowUnknownOptions = false;
-    }
-    if (allowUnknownParameters) {
-      this.allowUnknownParameters = allowUnknownParameters;
-    } else {
-      this.allowUnknownParameters = false;
-    }
-  }
-  /**
-   * Parses a list of command line arguments into an arguments object. Parser is pre-configured based on this command.
-   */
-  parseArguments(argv) {
-    return parseArguments(argv, {
-      commands: [this.name],
-      parameters: this.parameters ?? void 0,
-      options: this.options ?? void 0,
-      allowUnknownOptions: this.allowUnknownOptions,
-      allowUnknownParameters: this.allowUnknownParameters
-    });
-  }
-  /**
-   * Executes command action with provided parsed arguments and {@link Program} instance.
-   */
-  async run(parsedArgs, program) {
-    await this.action(parsedArgs, program);
-  }
-}
-//# sourceMappingURL=Command.js.map
+import { parseArguments } from "@jakubmazanec/args";
+
+//#region source/program/Command.ts
+/**
+* Command encapsulates piece of a CLI's logic and is executed when {@link Program} instance parses that command from the command line arguments.
+*/
+var Command = class {
+	name;
+	description;
+	parameters;
+	options;
+	allowUnknownOptions;
+	allowUnknownParameters;
+	action;
+	/**
+	* @param name Command name, ie. space-separated words consisting only of letters, numbers (but not at the start of the word) or dashes.
+	* @param action Function that runs when command is executed.
+	* @param options Additionl command options.
+	*/
+	constructor(name, action, { description, parameters, options, allowUnknownOptions, allowUnknownParameters }) {
+		this.name = name;
+		this.action = action;
+		if (description) this.description = description;
+		if (parameters) this.parameters = parameters;
+		else this.parameters = null;
+		if (options) this.options = options;
+		else this.options = null;
+		if (allowUnknownOptions) this.allowUnknownOptions = allowUnknownOptions;
+		else this.allowUnknownOptions = false;
+		if (allowUnknownParameters) this.allowUnknownParameters = allowUnknownParameters;
+		else this.allowUnknownParameters = false;
+	}
+	/**
+	* Parses a list of command line arguments into an arguments object. Parser is pre-configured based on this command.
+	*/
+	parseArguments(argv) {
+		return parseArguments(argv, {
+			commands: [this.name],
+			parameters: this.parameters ?? void 0,
+			options: this.options ?? void 0,
+			allowUnknownOptions: this.allowUnknownOptions,
+			allowUnknownParameters: this.allowUnknownParameters
+		});
+	}
+	/**
+	* Executes command action with provided parsed arguments and {@link Program} instance.
+	*/
+	async run(parsedArgs, program) {
+		await this.action(parsedArgs, program);
+	}
+};
+
+//#endregion
+export { Command };

package/build/program/Program.js

@@ -1,191 +1,156 @@
-"use strict";
+import { CACHE_PATH } from "../constants.js";
+import { Failure } from "../ui/Failure.js";
+import { Wrapper } from "../ui/internals/Wrapper.js";
+import { Help } from "../ui/Help.js";
+import { ProgramError } from "./ProgramError.js";
 import fs from "fs-extra";
 import fetchLatestVersion from "latest-version";
 import path from "node:path";
-import { CACHE_PATH } from "../constants.js";
-import { Failure, Help } from "../ui.js";
-import { Wrapper } from "../ui/internals.js";
-import { ProgramError } from "./ProgramError.js";
-export class Program {
-  /** Program name. */
-  name;
-  /** More readable program name. */
-  displayName;
-  /** Program version. */
-  version;
-  /** Program latest version. */
-  latestVersion;
-  /** Program description. */
-  description;
-  /** Program executable name. */
-  bin;
-  /** Program commands */
-  commands = [];
-  isRendering = false;
-  streams = {
-    stderr: process.stderr,
-    stdin: process.stdin,
-    stdout: process.stdout
-  };
-  /** Custom error boundary fallback component */
-  ErrorBoundaryFallbackComponent;
-  constructor({
-    name,
-    displayName,
-    version,
-    latestVersion,
-    description,
-    bin,
-    ErrorBoundaryFallbackComponent
-  }) {
-    if (name) {
-      this.name = name;
-    }
-    if (displayName) {
-      this.displayName = displayName;
-    }
-    if (version) {
-      this.version = version;
-    }
-    if (latestVersion) {
-      this.latestVersion = latestVersion;
-    }
-    if (description) {
-      this.description = description;
-    }
-    if (bin) {
-      this.bin = bin;
-    }
-    if (ErrorBoundaryFallbackComponent) {
-      this.ErrorBoundaryFallbackComponent = ErrorBoundaryFallbackComponent;
-    } else {
-      this.ErrorBoundaryFallbackComponent = Failure;
-    }
-  }
-  static async create({
-    name,
-    version,
-    description,
-    bin,
-    ErrorBoundaryFallbackComponent,
-    checkForUpdate
-  }) {
-    let latestVersion;
-    if (checkForUpdate && name) {
-      let cachePath = path.join(CACHE_PATH, name, "latest-version.json");
-      let cachedLatestVersion;
-      try {
-        cachedLatestVersion = await fs.readJson(cachePath);
-      } catch {
-      }
-      if (!cachedLatestVersion || Date.now() - cachedLatestVersion.datetime > 864e4) {
-        latestVersion = await fetchLatestVersion(name);
-        await fs.ensureFile(cachePath);
-        await fs.writeJson(cachePath, {
-          value: latestVersion,
-          datetime: Date.now()
-        });
-      }
-    }
-    return new this({
-      name,
-      version,
-      latestVersion,
-      description,
-      bin,
-      ErrorBoundaryFallbackComponent
-    });
-  }
-  /**
-   * Adds command to the program.
-   *
-   * @param command Command to add.
-   * @returns Program instance.
-   */
-  addCommand(command) {
-    this.commands.push(command);
-    return this;
-  }
-  /**
-   * Renders a React element using Ink and outputs to the configured streams.
-   *
-   * @param element The React element to render.
-   */
-  async renderElement(element) {
-    if (this.isRendering) {
-      throw new ProgramError("NO_NESTED_RENDER");
-    } else {
-      this.isRendering = true;
-    }
-    let { render } = await import("ink");
-    let { createElement } = await import("react");
-    let { stdin, stdout, stderr } = this.streams;
-    try {
-      render(createElement(Wrapper, { program: this }, element), {
-        exitOnCtrlC: true,
-        patchConsole: true,
-        stderr,
-        stdin,
-        stdout
-      });
-    } catch (error) {
-      if (error instanceof Error) {
-        await this.renderElement(
-          createElement(this.ErrorBoundaryFallbackComponent, { error, resetErrorBoundary: () => {
-          } })
-        );
-      }
-    } finally {
-      this.isRendering = false;
-    }
-  }
-  /**
-   * Runs the program.
-   *
-   * @param argv Unparsed command line arguments.
-   */
-  async run(argv) {
-    let hasCommandRun = false;
-    for (let command of this.commands) {
-      let parsedArgs = command.parseArguments(argv);
-      if (parsedArgs.command) {
-        hasCommandRun = true;
-        if (parsedArgs.errors.length) {
-          let { createElement } = await import("react");
-          for (let error of parsedArgs.errors) {
-            process.exitCode = 1;
-            await this.renderElement(
-              createElement(this.ErrorBoundaryFallbackComponent, {
-                error,
-                resetErrorBoundary: () => {
-                }
-              })
-            );
-          }
-        } else {
-          try {
-            await command.run(parsedArgs, this);
-          } catch (error) {
-            let { createElement } = await import("react");
-            if (error instanceof Error) {
-              process.exitCode = 1;
-              await this.renderElement(
-                createElement(this.ErrorBoundaryFallbackComponent, {
-                  error,
-                  resetErrorBoundary: () => {
-                  }
-                })
-              );
-            }
-          }
-          break;
-        }
-      }
-    }
-    if (!hasCommandRun) {
-      let { createElement } = await import("react");
-      await this.renderElement(createElement(Help, { program: this }));
-    }
-  }
-}
-//# sourceMappingURL=Program.js.map
+
+//#region source/program/Program.ts
+/**
+* Program manages and executes {@link Command} instances attached to it based on parsing command line arguments.
+*/
+var Program = class {
+	/** Program name. */
+	name;
+	/** More readable program name. */
+	displayName;
+	/** Program version. */
+	version;
+	/** Program latest version. */
+	latestVersion;
+	/** Program description. */
+	description;
+	/** Program executable name. */
+	bin;
+	/** Program commands */
+	commands = [];
+	isRendering = false;
+	streams = {
+		stderr: process.stderr,
+		stdin: process.stdin,
+		stdout: process.stdout
+	};
+	/** Custom error boundary fallback component */
+	ErrorBoundaryFallbackComponent;
+	constructor({ name, displayName, version, latestVersion, description, bin, ErrorBoundaryFallbackComponent }) {
+		if (name) this.name = name;
+		if (displayName) this.displayName = displayName;
+		if (version) this.version = version;
+		if (latestVersion) this.latestVersion = latestVersion;
+		if (description) this.description = description;
+		if (bin) this.bin = bin;
+		if (ErrorBoundaryFallbackComponent) this.ErrorBoundaryFallbackComponent = ErrorBoundaryFallbackComponent;
+		else this.ErrorBoundaryFallbackComponent = Failure;
+	}
+	static async create({ name, version, description, bin, ErrorBoundaryFallbackComponent, checkForUpdate }) {
+		let latestVersion;
+		if (checkForUpdate && name) {
+			let cachePath = path.join(CACHE_PATH, name, "latest-version.json");
+			let cachedLatestVersion;
+			try {
+				cachedLatestVersion = await fs.readJson(cachePath);
+			} catch {}
+			if (!cachedLatestVersion || Date.now() - cachedLatestVersion.datetime > 864e4) {
+				latestVersion = await fetchLatestVersion(name);
+				await fs.ensureFile(cachePath);
+				await fs.writeJson(cachePath, {
+					value: latestVersion,
+					datetime: Date.now()
+				});
+			}
+		}
+		return new this({
+			name,
+			version,
+			latestVersion,
+			description,
+			bin,
+			ErrorBoundaryFallbackComponent
+		});
+	}
+	/**
+	* Adds command to the program.
+	*
+	* @param command Command to add.
+	* @returns Program instance.
+	*/
+	addCommand(command) {
+		this.commands.push(command);
+		return this;
+	}
+	/**
+	* Renders a React element using Ink and outputs to the configured streams.
+	*
+	* @param element The React element to render.
+	*/
+	async renderElement(element) {
+		if (this.isRendering) throw new ProgramError("NO_NESTED_RENDER");
+		else this.isRendering = true;
+		let { render } = await import("ink");
+		let { createElement } = await import("react");
+		let { stdin, stdout, stderr } = this.streams;
+		try {
+			render(createElement(Wrapper, { program: this }, element), {
+				exitOnCtrlC: true,
+				patchConsole: true,
+				stderr,
+				stdin,
+				stdout
+			});
+		} catch (error) {
+			if (error instanceof Error) await this.renderElement(createElement(this.ErrorBoundaryFallbackComponent, {
+				error,
+				resetErrorBoundary: () => {}
+			}));
+		} finally {
+			this.isRendering = false;
+		}
+	}
+	/**
+	* Runs the program.
+	*
+	* @param argv Unparsed command line arguments.
+	*/
+	async run(argv) {
+		let hasCommandRun = false;
+		for (let command of this.commands) {
+			let parsedArgs = command.parseArguments(argv);
+			if (parsedArgs.command) {
+				hasCommandRun = true;
+				if (parsedArgs.errors.length) {
+					let { createElement } = await import("react");
+					for (let error of parsedArgs.errors) {
+						process.exitCode = 1;
+						await this.renderElement(createElement(this.ErrorBoundaryFallbackComponent, {
+							error,
+							resetErrorBoundary: () => {}
+						}));
+					}
+				} else {
+					try {
+						await command.run(parsedArgs, this);
+					} catch (error) {
+						let { createElement } = await import("react");
+						if (error instanceof Error) {
+							process.exitCode = 1;
+							await this.renderElement(createElement(this.ErrorBoundaryFallbackComponent, {
+								error,
+								resetErrorBoundary: () => {}
+							}));
+						}
+					}
+					break;
+				}
+			}
+		}
+		if (!hasCommandRun) {
+			let { createElement } = await import("react");
+			await this.renderElement(createElement(Help, { program: this }));
+		}
+	}
+};
+
+//#endregion
+export { Program };

package/build/program/ProgramError.js

@@ -1,6 +1,10 @@
-"use strict";
 import { createCustomError } from "@jakubmazanec/error";
-export const ProgramError = createCustomError("ProgramError", {
-  NO_NESTED_RENDER: "A React render process already exists. This usually occurs by triggering nested render calls."
-});
-//# sourceMappingURL=ProgramError.js.map
+
+//#region source/program/ProgramError.ts
+/**
+* A subclass of `Error` that indicates a program failure.
+*/
+const ProgramError = createCustomError("ProgramError", { NO_NESTED_RENDER: "A React render process already exists. This usually occurs by triggering nested render calls." });
+
+//#endregion
+export { ProgramError };

package/build/program/getProgramDetail.js

@@ -1,25 +1,22 @@
-"use strict";
-export function getProgramDetail(packageJson) {
-  let programDetail = {};
-  if (packageJson.name) {
-    programDetail.name = packageJson.name;
-  }
-  if (packageJson.version) {
-    programDetail.version = packageJson.version;
-  }
-  if (packageJson.description) {
-    programDetail.description = packageJson.description;
-  }
-  if (packageJson.bin && typeof packageJson.bin !== "string") {
-    let bins = Object.entries(packageJson.bin);
-    if (bins.length === 1) {
-      let firstBin = bins[0];
-      [programDetail.bin] = firstBin;
-    }
-  }
-  if (typeof packageJson.bin === "string" && packageJson.name) {
-    programDetail.bin = packageJson.name;
-  }
-  return programDetail;
+//#region source/program/getProgramDetail.ts
+/**
+* Creates detailed information about a {@lincode Program}.
+*/
+function getProgramDetail(packageJson) {
+	let programDetail = {};
+	if (packageJson.name) programDetail.name = packageJson.name;
+	if (packageJson.version) programDetail.version = packageJson.version;
+	if (packageJson.description) programDetail.description = packageJson.description;
+	if (packageJson.bin && typeof packageJson.bin !== "string") {
+		let bins = Object.entries(packageJson.bin);
+		if (bins.length === 1) {
+			let firstBin = bins[0];
+			[programDetail.bin] = firstBin;
+		}
+	}
+	if (typeof packageJson.bin === "string" && packageJson.name) programDetail.bin = packageJson.name;
+	return programDetail;
 }
-//# sourceMappingURL=getProgramDetail.js.map
+
+//#endregion
+export { getProgramDetail };