@jakubmazanec/cli 0.2.1-unstable.ee5adfc → 0.3.0-next.2fa8a2c

package/{src → source}/ui/form/FormProps.ts

@@ -6,21 +6,17 @@ import {type FormValues} from './FormValues.js';
 
 /** A type that creates string literal union type with names of rows that need some props. */
 type FormRowWithPropsNames<C extends FormConfig> = {
-  [P in keyof C['rows']]: C['rows'][P]['type'] extends 'text'
-    ? never
-    : C['rows'][P]['type'] extends 'confirm'
-    ? never
-    : C['rows'][P]['type'] extends 'select'
-    ? P
-    : never;
+  [P in keyof C['rows']]: C['rows'][P]['type'] extends 'text' ? never
+  : C['rows'][P]['type'] extends 'confirm' ? never
+  : C['rows'][P]['type'] extends 'select' ? P
+  : never;
 }[keyof C['rows']];
 
-type FormPropsRow<C extends FormRowConfig> = C['type'] extends 'text'
-  ? never
-  : C['type'] extends 'confirm'
-  ? never
-  : C['type'] extends 'select'
-  ? {
+type FormPropsRow<C extends FormRowConfig> =
+  C['type'] extends 'text' ? never
+  : C['type'] extends 'confirm' ? never
+  : C['type'] extends 'select' ?
+    {
       choices: Array<{value: string; label: string}>;
     }
   : never;
@@ -35,11 +31,9 @@ type FormPropsRows<C extends FormConfig> = Pick<
 /**
  * Form component props.
  */
-export type FormProps<C extends FormConfig> = FormPropsRows<C> extends Record<
-  number | string | symbol,
-  never
->
-  ? BoxProps & {
+export type FormProps<C extends FormConfig> =
+  FormPropsRows<C> extends Record<number | string | symbol, never> ?
+    BoxProps & {
       /** Props for each row. */
       rows?: null | undefined;
 

package/{src → source}/ui/form/FormRow.tsx

@@ -95,15 +95,15 @@ export function FormRow<C extends FormConfig>({
           key={String(rowName)}
           label={config.label ?? ''}
           items={
-            rows
-              ? (
-                  (
-                    rows as {
-                      [key: string]: unknown;
-                    }
-                  )[rowName as string] as {choices: Array<{value: string; label: string}>}
-                ).choices
-              : []
+            rows ?
+              (
+                (
+                  rows as {
+                    [key: string]: unknown;
+                  }
+                )[rowName as string] as {choices: Array<{value: string; label: string}>}
+              ).choices
+            : []
           }
           focus={focus}
           isComplete={isComplete}

package/{src → source}/ui/form/FormValue.ts

@@ -5,8 +5,7 @@ export type StringFormValue = {value: string; isComplete: boolean};
 /**
  * Form value.
  */
-export type FormValue<C extends FormRowConfig> = C['type'] extends 'text'
-  ? StringFormValue
-  : C['type'] extends 'select'
-  ? StringFormValue
+export type FormValue<C extends FormRowConfig> =
+  C['type'] extends 'text' ? StringFormValue
+  : C['type'] extends 'select' ? StringFormValue
   : never;

package/{src → source}/ui/form/SelectInput.tsx

@@ -1,11 +1,11 @@
-import {Box, type BoxProps, Text, useInput, type Key} from 'ink';
+import {Box, type BoxProps, type Key, Text, useInput} from 'ink';
 import _ from 'lodash';
-import {useState, useEffect, useRef} from 'react';
+import {useEffect, useRef, useState} from 'react';
 
-import {type SelectInputItem} from './SelectInputItem.js';
 import * as colors from '../colors.js';
 import * as icons from '../icons.js';
 import {rotate} from '../internals.js';
+import {type SelectInputItem} from './SelectInputItem.js';
 
 /**
  * {@linkcode SelectInput} component props.
@@ -41,7 +41,7 @@ type SelectInputProps = BoxProps & {
  */
 export function SelectInput({
   label,
-  items = [],
+  items,
   focus = true,
   initialIndex = 0,
   limit: userDefinedLimit,
@@ -116,9 +116,8 @@ export function SelectInput({
     {isActive: focus},
   );
 
-  let visibleItems: SelectInputItem[] = hasLimit
-    ? rotate(items, rotatedIndex).slice(0, limit)
-    : items;
+  let visibleItems: SelectInputItem[] =
+    hasLimit ? rotate(items, rotatedIndex).slice(0, limit) : items;
 
   return (
     <Box {...boxProps}>
@@ -130,30 +129,27 @@ export function SelectInput({
         <Box marginRight={1}>
           <Text color={colors.highlighted}>{label}</Text>
         </Box>
-        {isComplete ? (
+        {isComplete ?
           <Text color={colors.body}>
             {items[selectedIndex]?.label ?? String(items[selectedIndex]?.value)}
           </Text>
-        ) : (
-          <Box flexDirection="column">
+        : <Box flexDirection="column">
             {visibleItems.map((item, index) => {
               let isSelected = index === selectedIndex;
 
               return (
                 <Box key={item.value}>
                   <Box marginRight={1}>
-                    {isSelected ? (
+                    {isSelected ?
                       <Text color={colors.selected}>{icons.selectedCircle}</Text>
-                    ) : (
-                      <Text color={colors.unselected}>{icons.unselectedCircle}</Text>
-                    )}
+                    : <Text color={colors.unselected}>{icons.unselectedCircle}</Text>}
                   </Box>
                   <Text color={isSelected ? colors.highlighted : colors.muted}>{item.label}</Text>
                 </Box>
               );
             })}
           </Box>
-        )}
+        }
       </Box>
     </Box>
   );

package/{src → source}/ui/form/TextInput.tsx

@@ -89,9 +89,9 @@ export function TextInput({
 
   if (showCursor && focus) {
     renderedPlaceholder =
-      placeholder.length > 0
-        ? chalk.inverse(placeholder[0]) + chalk[colors.muted](placeholder.slice(1))
-        : chalk.inverse(' ');
+      placeholder.length > 0 ?
+        chalk.inverse(placeholder[0]) + chalk[colors.muted](placeholder.slice(1))
+      : chalk.inverse(' ');
 
     renderedValue = value.length > 0 ? '' : chalk.inverse(' ');
 
@@ -205,18 +205,21 @@ export function TextInput({
         <Box marginRight={1}>
           <Text color={colors.highlighted}>{label}</Text>
         </Box>
-        {isComplete ? (
+        {isComplete ?
           <Text color={colors.body}>{value}</Text>
-        ) : (
-          <Text color={colors.highlighted}>
-            {placeholder ? (value.length > 0 ? renderedValue : renderedPlaceholder) : renderedValue}
+        : <Text color={colors.highlighted}>
+            {placeholder ?
+              value.length > 0 ?
+                renderedValue
+              : renderedPlaceholder
+            : renderedValue}
           </Text>
-        )}
-        {validationError ? (
+        }
+        {validationError ?
           <Box marginTop={0}>
             <Text color={colors.warning}>{validationError}</Text>
           </Box>
-        ) : null}
+        : null}
       </Box>
     </Box>
   );

package/{src → source}/ui/getErrorDetail.ts

@@ -1,4 +1,4 @@
-import {ValidationError, ParsingError} from '@jakubmazanec/args';
+import {ParsingError, ValidationError} from '@jakubmazanec/args';
 import {zodIssuesToStrings} from '@jakubmazanec/zod-utils';
 import {ZodError} from 'zod';
 

package/{src → source}/ui/internals/Wrapper.tsx

@@ -1,11 +1,11 @@
 import {Box, Spacer, Text} from 'ink';
-import {useMemo, type FC, type PropsWithChildren} from 'react';
+import {type FC, type PropsWithChildren, useMemo} from 'react';
 import {ErrorBoundary} from 'react-error-boundary';
 
-import {programContext} from './programContext.js';
 import {type Program} from '../../program.js';
 import {highlighted, notice} from '../colors.js';
 import {Failure} from '../Failure.js';
+import {programContext} from './programContext.js';
 
 /**
  * {@link Wrapper} component props.
@@ -28,7 +28,7 @@ export const Wrapper: FC<PropsWithChildren<WrapperProps>> = ({program, children}
   return (
     <ErrorBoundary FallbackComponent={Failure}>
       <programContext.Provider value={programContextValue}>
-        {program.latestVersion && program.latestVersion !== program.version ? (
+        {program.latestVersion && program.latestVersion !== program.version ?
           <Box>
             <Box
               flexDirection="column"
@@ -49,7 +49,7 @@ export const Wrapper: FC<PropsWithChildren<WrapperProps>> = ({program, children}
             </Box>
             <Spacer />
           </Box>
-        ) : null}
+        : null}
         <Box>{children}</Box>
       </programContext.Provider>
     </ErrorBoundary>

package/dist/constants.js

@@ -1,8 +0,0 @@
-import path from 'node:path';
-import url from 'node:url';
-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

package/dist/constants.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/constants.ts"],"sourcesContent":["import path from 'node:path';\nimport url from 'node:url';\n\nlet directory = path.dirname(url.fileURLToPath(import.meta.url));\n\nexport const PACKAGE_PATH = path.resolve(directory, '..');\nexport const CACHE_PATH = path.resolve(PACKAGE_PATH, 'node_modules/.cache');\n\nexport const DELIMITER = '$ ';\n"],"names":["path","url","directory","dirname","fileURLToPath","PACKAGE_PATH","resolve","CACHE_PATH","DELIMITER"],"mappings":"AAAA,OAAOA,UAAU,YAAY;AAC7B,OAAOC,SAAS,WAAW;AAE3B,IAAIC,YAAYF,KAAKG,OAAO,CAACF,IAAIG,aAAa,CAAC,YAAYH,GAAG;AAE9D,OAAO,MAAMI,eAAeL,KAAKM,OAAO,CAACJ,WAAW,MAAM;AAC1D,OAAO,MAAMK,aAAaP,KAAKM,OAAO,CAACD,cAAc,uBAAuB;AAE5E,OAAO,MAAMG,YAAY,KAAK"}

package/dist/main.js

@@ -1,4 +0,0 @@
-export * from './program.js';
-export * from './ui.js';
-
-//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/main.ts"],"sourcesContent":["export * from './program.js';\nexport * from './ui.js';\n"],"names":[],"mappings":"AAAA,cAAc,eAAe;AAC7B,cAAc,UAAU"}

package/dist/program/Command.js

@@ -1,63 +0,0 @@
-import { parseArguments } from '@jakubmazanec/args';
-/**
- * Command encapsulates piece of a CLI's logic and is executed when {@link Program} instance parses that command from the command line arguments.
- */ 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 ?? undefined,
-            options: this.options ?? undefined,
-            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

package/dist/program/Command.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/program/Command.ts"],"sourcesContent":["import {\n  type Argv,\n  parseArguments,\n  type OptionsConfig,\n  type ParametersConfig,\n  type Arguments,\n} from '@jakubmazanec/args';\n\nimport {type CommandAction} from './CommandAction.js';\nimport {type CommandOptions} from './CommandOptions.js';\nimport {type Program} from './Program.js';\n\n/**\n * Command encapsulates piece of a CLI's logic and is executed when {@link Program} instance parses that command from the command line arguments.\n */\nexport class Command<\n  A extends string,\n  const B extends ParametersConfig | undefined = undefined,\n  const C extends OptionsConfig | undefined = undefined,\n  D extends boolean = false,\n  E extends boolean = false,\n> {\n  readonly name: A;\n  readonly description?: string;\n  readonly parameters: B extends ParametersConfig ? B : null;\n  readonly options: C extends OptionsConfig ? C : null;\n  readonly allowUnknownOptions: D;\n  readonly allowUnknownParameters: E;\n  private readonly action: CommandAction<A, B, C, D, E>;\n\n  /**\n   * @param name Command name, ie. space-separated words consisting only of letters, numbers (but not at the start of the word) or dashes.\n   * @param action Function that runs when command is executed.\n   * @param options Additionl command options.\n   */\n  constructor(\n    name: A,\n    action: CommandAction<A, B, C, D, E>,\n    {\n      description,\n      parameters,\n      options,\n      allowUnknownOptions,\n      allowUnknownParameters,\n    }: CommandOptions<NonNullable<B>, NonNullable<C>, D, E>,\n  ) {\n    this.name = name;\n    this.action = action;\n\n    if (description) {\n      this.description = description;\n    }\n\n    if (parameters) {\n      this.parameters = parameters as B extends ParametersConfig ? B : null;\n    } else {\n      this.parameters = null as B extends ParametersConfig ? B : null;\n    }\n\n    if (options) {\n      this.options = options as C extends OptionsConfig ? C : null;\n    } else {\n      this.options = null as C extends OptionsConfig ? C : null;\n    }\n\n    if (allowUnknownOptions) {\n      this.allowUnknownOptions = allowUnknownOptions;\n    } else {\n      this.allowUnknownOptions = false as D;\n    }\n\n    if (allowUnknownParameters) {\n      this.allowUnknownParameters = allowUnknownParameters;\n    } else {\n      this.allowUnknownParameters = false as E;\n    }\n  }\n\n  /**\n   * Parses a list of command line arguments into an arguments object. Parser is pre-configured based on this command.\n   */\n  parseArguments(argv: Argv): Arguments<{\n    commands: readonly [A];\n    parameters: B;\n    options: C;\n    allowUnknownOptions: D;\n    allowUnknownParameters: E;\n  }> {\n    return parseArguments(argv, {\n      commands: [this.name],\n      parameters: this.parameters ?? undefined,\n      options: this.options ?? undefined,\n      allowUnknownOptions: this.allowUnknownOptions,\n      allowUnknownParameters: this.allowUnknownParameters,\n    } as {\n      commands: readonly [A];\n      parameters: B;\n      options: C;\n      allowUnknownOptions: D;\n      allowUnknownParameters: E;\n    });\n  }\n\n  /**\n   * Executes command action with provided parsed arguments and {@link Program} instance.\n   */\n  async run(\n    parsedArgs: Arguments<{\n      commands: readonly [A];\n      parameters: B;\n      options: C;\n      allowUnknownOptions: D;\n      allowUnknownParameters: E;\n    }>,\n    program: Program,\n  ): Promise<void> {\n    await this.action(parsedArgs, program);\n  }\n}\n"],"names":["parseArguments","Command","name","description","parameters","options","allowUnknownOptions","allowUnknownParameters","action","constructor","argv","commands","undefined","run","parsedArgs","program"],"mappings":"AAAA,SAEEA,cAAc,QAIT,qBAAqB;AAM5B;;CAEC,GACD,OAAO,MAAMC;IAOFC,KAAQ;IACRC,YAAqB;IACrBC,WAAkD;IAClDC,QAA4C;IAC5CC,oBAAuB;IACvBC,uBAA0B;IAClBC,OAAqC;IAEtD;;;;GAIC,GACDC,YACEP,IAAO,EACPM,MAAoC,EACpC,EACEL,WAAW,EACXC,UAAU,EACVC,OAAO,EACPC,mBAAmB,EACnBC,sBAAsB,EAC+B,CACvD;QACA,IAAI,CAACL,IAAI,GAAGA;QACZ,IAAI,CAACM,MAAM,GAAGA;QAEd,IAAIL,aAAa;YACf,IAAI,CAACA,WAAW,GAAGA;QACrB;QAEA,IAAIC,YAAY;YACd,IAAI,CAACA,UAAU,GAAGA;QACpB,OAAO;YACL,IAAI,CAACA,UAAU,GAAG;QACpB;QAEA,IAAIC,SAAS;YACX,IAAI,CAACA,OAAO,GAAGA;QACjB,OAAO;YACL,IAAI,CAACA,OAAO,GAAG;QACjB;QAEA,IAAIC,qBAAqB;YACvB,IAAI,CAACA,mBAAmB,GAAGA;QAC7B,OAAO;YACL,IAAI,CAACA,mBAAmB,GAAG;QAC7B;QAEA,IAAIC,wBAAwB;YAC1B,IAAI,CAACA,sBAAsB,GAAGA;QAChC,OAAO;YACL,IAAI,CAACA,sBAAsB,GAAG;QAChC;IACF;IAEA;;GAEC,GACDP,eAAeU,IAAU,EAMtB;QACD,OAAOV,eAAeU,MAAM;YAC1BC,UAAU;gBAAC,IAAI,CAACT,IAAI;aAAC;YACrBE,YAAY,IAAI,CAACA,UAAU,IAAIQ;YAC/BP,SAAS,IAAI,CAACA,OAAO,IAAIO;YACzBN,qBAAqB,IAAI,CAACA,mBAAmB;YAC7CC,wBAAwB,IAAI,CAACA,sBAAsB;QACrD;IAOF;IAEA;;GAEC,GACD,MAAMM,IACJC,UAME,EACFC,OAAgB,EACD;QACf,MAAM,IAAI,CAACP,MAAM,CAACM,YAAYC;IAChC;AACF"}

package/dist/program/CommandAction.js

@@ -1,3 +0,0 @@
-export { };
-
-//# sourceMappingURL=CommandAction.js.map

package/dist/program/CommandAction.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/program/CommandAction.ts"],"sourcesContent":["import {type OptionsConfig, type ParametersConfig, type Arguments} from '@jakubmazanec/args';\n\nimport {type Program} from './Program.js';\n\n/**\n * Command action.\n */\nexport type CommandAction<\n  A extends string,\n  B extends ParametersConfig | undefined = undefined,\n  C extends OptionsConfig | undefined = undefined,\n  D extends boolean = false,\n  E extends boolean = false,\n> = (\n  parsedArgs: Arguments<{\n    commands: readonly [A];\n    parameters: B;\n    options: C;\n    allowUnknownOptions: D;\n    allowUnknownParameters: E;\n  }>,\n  program: Program,\n) => Promise<void>;\n"],"names":[],"mappings":"AAAA,WAsBmB"}

package/dist/program/CommandArguments.js

@@ -1,3 +0,0 @@
-/* eslint-disable @typescript-eslint/no-explicit-any -- needed */ export { };
-
-//# sourceMappingURL=CommandArguments.js.map

package/dist/program/CommandArguments.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/program/CommandArguments.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any -- needed */\nimport {type Command} from './Command.js';\n\n/**\n * Parsed command arguments type.\n */\nexport type CommandArguments<C extends Command<any, any, any, any, any>> = ReturnType<\n  C['parseArguments']\n>;\n"],"names":[],"mappings":"AAAA,+DAA+D,GAC/D,WAOE"}

package/dist/program/CommandOptions.js

@@ -1,3 +0,0 @@
-export { };
-
-//# sourceMappingURL=CommandOptions.js.map

package/dist/program/CommandOptions.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/program/CommandOptions.ts"],"sourcesContent":["import {type OptionsConfig, type ParametersConfig} from '@jakubmazanec/args';\n\n/**\n * {@link Command.constructor | Command constructor} options parameter.\n */\nexport type CommandOptions<\n  B extends ParametersConfig,\n  C extends OptionsConfig,\n  D extends boolean,\n  E extends boolean,\n> = {\n  description?: string;\n  parameters?: B | undefined;\n  options?: C | undefined;\n  allowUnknownOptions?: D | undefined;\n  allowUnknownParameters?: E | undefined;\n};\n"],"names":[],"mappings":"AAAA,WAgBE"}

package/dist/program/Program.js

@@ -1,168 +0,0 @@
-/* eslint-disable @typescript-eslint/no-explicit-any -- needed */ import fs from 'fs-extra';
-import fetchLatestVersion from 'latest-version';
-import path from 'path';
-import { ProgramError } from './ProgramError.js';
-import { CACHE_PATH } from '../constants.js';
-import { Wrapper } from '../ui/internals.js';
-import { Failure, Help } from '../ui.js';
-/**
- * Program manages and executes {@link Command} instances attached to it based on parsing command line arguments.
- */ 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  {
-            // no-op
-            }
-            // if there is no cache or the cached value is old, refetch and recache
-            if (!cachedLatestVersion || Date.now() - cachedLatestVersion.datetime > 86_400_00) {
-                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) {
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument -- it doesn't matter here; `any` is used to make TypeScript happy in this method, but isn't propagated further.
-        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

package/dist/program/Program.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/program/Program.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any -- needed */\nimport {type ParametersConfig, type Argv, type OptionsConfig} from '@jakubmazanec/args';\nimport fs from 'fs-extra';\nimport fetchLatestVersion from 'latest-version';\nimport path from 'path';\nimport {type ComponentType} from 'react';\nimport {type FallbackProps} from 'react-error-boundary';\n\nimport {type Command} from './Command.js';\nimport {type ProgramCreateOptions} from './ProgramCreateOptions.js';\nimport {ProgramError} from './ProgramError.js';\nimport {type ProgramOptions} from './ProgramOptions.js';\nimport {type ProgramStreams} from './ProgramStreams.js';\nimport {CACHE_PATH} from '../constants.js';\nimport {Wrapper} from '../ui/internals.js';\nimport {Failure, Help} from '../ui.js';\n\n/**\n * Program manages and executes {@link Command} instances attached to it based on parsing command line arguments.\n */\nexport class Program {\n  /** Program name. */\n  readonly name?: string;\n\n  /** More readable program name. */\n  readonly displayName?: string;\n\n  /** Program version. */\n  readonly version?: string;\n\n  /** Program latest version. */\n  readonly latestVersion?: string;\n\n  /** Program description. */\n  readonly description?: string;\n\n  /** Program executable name. */\n  readonly bin?: string;\n\n  /** Program commands */\n  readonly commands: Array<\n    Command<string, ParametersConfig | undefined, OptionsConfig | undefined, boolean, boolean>\n  > = [];\n\n  protected isRendering = false;\n\n  readonly streams: ProgramStreams = {\n    stderr: process.stderr,\n    stdin: process.stdin,\n    stdout: process.stdout,\n  };\n\n  /** Custom error boundary fallback component */\n  ErrorBoundaryFallbackComponent: ComponentType<FallbackProps>;\n\n  private constructor({\n    name,\n    displayName,\n    version,\n    latestVersion,\n    description,\n    bin,\n    ErrorBoundaryFallbackComponent,\n  }: ProgramOptions) {\n    if (name) {\n      this.name = name;\n    }\n\n    if (displayName) {\n      this.displayName = displayName;\n    }\n\n    if (version) {\n      this.version = version;\n    }\n\n    if (latestVersion) {\n      this.latestVersion = latestVersion;\n    }\n\n    if (description) {\n      this.description = description;\n    }\n\n    if (bin) {\n      this.bin = bin;\n    }\n\n    if (ErrorBoundaryFallbackComponent) {\n      this.ErrorBoundaryFallbackComponent = ErrorBoundaryFallbackComponent;\n    } else {\n      this.ErrorBoundaryFallbackComponent = Failure;\n    }\n  }\n\n  static async create({\n    name,\n    version,\n    description,\n    bin,\n    ErrorBoundaryFallbackComponent,\n    checkForUpdate,\n  }: ProgramCreateOptions) {\n    let latestVersion: string | undefined;\n\n    if (checkForUpdate && name) {\n      // first we try to read the cached latest version\n      type CachedLatestVersion = {\n        value: string;\n        datetime: number;\n      };\n\n      let cachePath = path.join(CACHE_PATH, name, 'latest-version.json');\n      let cachedLatestVersion: CachedLatestVersion | undefined;\n\n      try {\n        cachedLatestVersion = (await fs.readJson(cachePath)) as CachedLatestVersion;\n      } catch {\n        // no-op\n      }\n\n      // if there is no cache or the cached value is old, refetch and recache\n      if (!cachedLatestVersion || Date.now() - cachedLatestVersion.datetime > 86_400_00) {\n        latestVersion = await fetchLatestVersion(name);\n\n        await fs.ensureFile(cachePath);\n        await fs.writeJson(cachePath, {\n          value: latestVersion,\n          datetime: Date.now(),\n        });\n      }\n    }\n\n    return new this({\n      name,\n      version,\n      latestVersion,\n      description,\n      bin,\n      ErrorBoundaryFallbackComponent,\n    });\n  }\n\n  /**\n   * Adds command to the program.\n   *\n   * @param command Command to add.\n   * @returns Program instance.\n   */\n  addCommand(command: Command<any, any, any, any, any>): this {\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument -- it doesn't matter here; `any` is used to make TypeScript happy in this method, but isn't propagated further.\n    this.commands.push(command);\n\n    return this;\n  }\n\n  /**\n   * Renders a React element using Ink and outputs to the configured streams.\n   *\n   * @param element The React element to render.\n   */\n  async renderElement(element: React.ReactElement): Promise<void> {\n    if (this.isRendering) {\n      throw new ProgramError('NO_NESTED_RENDER');\n    } else {\n      this.isRendering = true;\n    }\n\n    let {render} = await import('ink');\n    let {createElement} = await import('react');\n    let {stdin, stdout, stderr} = this.streams;\n\n    try {\n      render(createElement(Wrapper, {program: this}, element), {\n        exitOnCtrlC: true,\n        patchConsole: true,\n        stderr,\n        stdin,\n        stdout,\n      });\n    } catch (error: unknown) {\n      if (error instanceof Error) {\n        await this.renderElement(\n          createElement(this.ErrorBoundaryFallbackComponent, {error, resetErrorBoundary: () => {}}),\n        );\n      }\n    } finally {\n      this.isRendering = false;\n    }\n  }\n\n  /**\n   * Runs the program.\n   *\n   * @param argv Unparsed command line arguments.\n   */\n  async run(argv: Argv): Promise<void> {\n    let hasCommandRun = false;\n\n    for (let command of this.commands) {\n      let parsedArgs = command.parseArguments(argv);\n\n      if (parsedArgs.command) {\n        hasCommandRun = true;\n\n        if (parsedArgs.errors.length) {\n          let {createElement} = await import('react');\n\n          for (let error of parsedArgs.errors) {\n            process.exitCode = 1;\n\n            await this.renderElement(\n              createElement(this.ErrorBoundaryFallbackComponent, {\n                error,\n                resetErrorBoundary: () => {},\n              }),\n            );\n          }\n        } else {\n          try {\n            await command.run(parsedArgs, this);\n          } catch (error: unknown) {\n            let {createElement} = await import('react');\n\n            if (error instanceof Error) {\n              process.exitCode = 1;\n\n              await this.renderElement(\n                createElement(this.ErrorBoundaryFallbackComponent, {\n                  error,\n                  resetErrorBoundary: () => {},\n                }),\n              );\n            }\n          }\n\n          break;\n        }\n      }\n    }\n\n    if (!hasCommandRun) {\n      let {createElement} = await import('react');\n\n      await this.renderElement(createElement(Help, {program: this}));\n    }\n  }\n}\n"],"names":["fs","fetchLatestVersion","path","ProgramError","CACHE_PATH","Wrapper","Failure","Help","Program","name","displayName","version","latestVersion","description","bin","commands","isRendering","streams","stderr","process","stdin","stdout","ErrorBoundaryFallbackComponent","create","checkForUpdate","cachePath","join","cachedLatestVersion","readJson","Date","now","datetime","ensureFile","writeJson","value","addCommand","command","push","renderElement","element","render","createElement","program","exitOnCtrlC","patchConsole","error","Error","resetErrorBoundary","run","argv","hasCommandRun","parsedArgs","parseArguments","errors","length","exitCode"],"mappings":"AAAA,+DAA+D,GAE/D,OAAOA,QAAQ,WAAW;AAC1B,OAAOC,wBAAwB,iBAAiB;AAChD,OAAOC,UAAU,OAAO;AAMxB,SAAQC,YAAY,QAAO,oBAAoB;AAG/C,SAAQC,UAAU,QAAO,kBAAkB;AAC3C,SAAQC,OAAO,QAAO,qBAAqB;AAC3C,SAAQC,OAAO,EAAEC,IAAI,QAAO,WAAW;AAEvC;;CAEC,GACD,OAAO,MAAMC;IACX,kBAAkB,GAClB,AAASC,KAAc;IAEvB,gCAAgC,GAChC,AAASC,YAAqB;IAE9B,qBAAqB,GACrB,AAASC,QAAiB;IAE1B,4BAA4B,GAC5B,AAASC,cAAuB;IAEhC,yBAAyB,GACzB,AAASC,YAAqB;IAE9B,6BAA6B,GAC7B,AAASC,IAAa;IAEtB,qBAAqB,GACrB,AAASC,WAEL,EAAE,CAAC;IAEGC,cAAc,MAAM;IAErBC,UAA0B;QACjCC,QAAQC,QAAQD,MAAM;QACtBE,OAAOD,QAAQC,KAAK;QACpBC,QAAQF,QAAQE,MAAM;IACxB,EAAE;IAEF,6CAA6C,GAC7CC,+BAA6D;IAE7D,YAAoB,EAClBb,IAAI,EACJC,WAAW,EACXC,OAAO,EACPC,aAAa,EACbC,WAAW,EACXC,GAAG,EACHQ,8BAA8B,EACf,CAAE;QACjB,IAAIb,MAAM;YACR,IAAI,CAACA,IAAI,GAAGA;QACd;QAEA,IAAIC,aAAa;YACf,IAAI,CAACA,WAAW,GAAGA;QACrB;QAEA,IAAIC,SAAS;YACX,IAAI,CAACA,OAAO,GAAGA;QACjB;QAEA,IAAIC,eAAe;YACjB,IAAI,CAACA,aAAa,GAAGA;QACvB;QAEA,IAAIC,aAAa;YACf,IAAI,CAACA,WAAW,GAAGA;QACrB;QAEA,IAAIC,KAAK;YACP,IAAI,CAACA,GAAG,GAAGA;QACb;QAEA,IAAIQ,gCAAgC;YAClC,IAAI,CAACA,8BAA8B,GAAGA;QACxC,OAAO;YACL,IAAI,CAACA,8BAA8B,GAAGhB;QACxC;IACF;IAEA,aAAaiB,OAAO,EAClBd,IAAI,EACJE,OAAO,EACPE,WAAW,EACXC,GAAG,EACHQ,8BAA8B,EAC9BE,cAAc,EACO,EAAE;QACvB,IAAIZ;QAEJ,IAAIY,kBAAkBf,MAAM;YAO1B,IAAIgB,YAAYvB,KAAKwB,IAAI,CAACtB,YAAYK,MAAM;YAC5C,IAAIkB;YAEJ,IAAI;gBACFA,sBAAuB,MAAM3B,GAAG4B,QAAQ,CAACH;YAC3C,EAAE,OAAM;YACN,QAAQ;YACV;YAEA,uEAAuE;YACvE,IAAI,CAACE,uBAAuBE,KAAKC,GAAG,KAAKH,oBAAoBI,QAAQ,GAAG,WAAW;gBACjFnB,gBAAgB,MAAMX,mBAAmBQ;gBAEzC,MAAMT,GAAGgC,UAAU,CAACP;gBACpB,MAAMzB,GAAGiC,SAAS,CAACR,WAAW;oBAC5BS,OAAOtB;oBACPmB,UAAUF,KAAKC,GAAG;gBACpB;YACF;QACF;QAEA,OAAO,IAAI,IAAI,CAAC;YACdrB;YACAE;YACAC;YACAC;YACAC;YACAQ;QACF;IACF;IAEA;;;;;GAKC,GACDa,WAAWC,OAAyC,EAAQ;QAC1D,iLAAiL;QACjL,IAAI,CAACrB,QAAQ,CAACsB,IAAI,CAACD;QAEnB,OAAO,IAAI;IACb;IAEA;;;;GAIC,GACD,MAAME,cAAcC,OAA2B,EAAiB;QAC9D,IAAI,IAAI,CAACvB,WAAW,EAAE;YACpB,MAAM,IAAIb,aAAa;QACzB,OAAO;YACL,IAAI,CAACa,WAAW,GAAG;QACrB;QAEA,IAAI,EAACwB,MAAM,EAAC,GAAG,MAAM,MAAM,CAAC;QAC5B,IAAI,EAACC,aAAa,EAAC,GAAG,MAAM,MAAM,CAAC;QACnC,IAAI,EAACrB,KAAK,EAAEC,MAAM,EAAEH,MAAM,EAAC,GAAG,IAAI,CAACD,OAAO;QAE1C,IAAI;YACFuB,OAAOC,cAAcpC,SAAS;gBAACqC,SAAS,IAAI;YAAA,GAAGH,UAAU;gBACvDI,aAAa;gBACbC,cAAc;gBACd1B;gBACAE;gBACAC;YACF;QACF,EAAE,OAAOwB,OAAgB;YACvB,IAAIA,iBAAiBC,OAAO;gBAC1B,MAAM,IAAI,CAACR,aAAa,CACtBG,cAAc,IAAI,CAACnB,8BAA8B,EAAE;oBAACuB;oBAAOE,oBAAoB,KAAO;gBAAC;YAE3F;QACF,SAAU;YACR,IAAI,CAAC/B,WAAW,GAAG;QACrB;IACF;IAEA;;;;GAIC,GACD,MAAMgC,IAAIC,IAAU,EAAiB;QACnC,IAAIC,gBAAgB;QAEpB,KAAK,IAAId,WAAW,IAAI,CAACrB,QAAQ,CAAE;YACjC,IAAIoC,aAAaf,QAAQgB,cAAc,CAACH;YAExC,IAAIE,WAAWf,OAAO,EAAE;gBACtBc,gBAAgB;gBAEhB,IAAIC,WAAWE,MAAM,CAACC,MAAM,EAAE;oBAC5B,IAAI,EAACb,aAAa,EAAC,GAAG,MAAM,MAAM,CAAC;oBAEnC,KAAK,IAAII,SAASM,WAAWE,MAAM,CAAE;wBACnClC,QAAQoC,QAAQ,GAAG;wBAEnB,MAAM,IAAI,CAACjB,aAAa,CACtBG,cAAc,IAAI,CAACnB,8BAA8B,EAAE;4BACjDuB;4BACAE,oBAAoB,KAAO;wBAC7B;oBAEJ;gBACF,OAAO;oBACL,IAAI;wBACF,MAAMX,QAAQY,GAAG,CAACG,YAAY,IAAI;oBACpC,EAAE,OAAON,OAAgB;wBACvB,IAAI,EAACJ,aAAa,EAAC,GAAG,MAAM,MAAM,CAAC;wBAEnC,IAAII,iBAAiBC,OAAO;4BAC1B3B,QAAQoC,QAAQ,GAAG;4BAEnB,MAAM,IAAI,CAACjB,aAAa,CACtBG,cAAc,IAAI,CAACnB,8BAA8B,EAAE;gCACjDuB;gCACAE,oBAAoB,KAAO;4BAC7B;wBAEJ;oBACF;oBAEA;gBACF;YACF;QACF;QAEA,IAAI,CAACG,eAAe;YAClB,IAAI,EAACT,aAAa,EAAC,GAAG,MAAM,MAAM,CAAC;YAEnC,MAAM,IAAI,CAACH,aAAa,CAACG,cAAclC,MAAM;gBAACmC,SAAS,IAAI;YAAA;QAC7D;IACF;AACF"}

package/dist/program/ProgramCreateOptions.js

@@ -1,3 +0,0 @@
-export { };
-
-//# sourceMappingURL=ProgramCreateOptions.js.map

package/dist/program/ProgramCreateOptions.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/program/ProgramCreateOptions.ts"],"sourcesContent":["import {type ComponentType} from 'react';\nimport {type FallbackProps} from 'react-error-boundary';\n\n/**\n * {@link Program.create} options parameter.\n */\nexport type ProgramCreateOptions = {\n  /** Program name. */\n  name?: string | undefined;\n\n  /** More readable program name. */\n  displayName?: string | undefined;\n\n  /** Program version. */\n  version?: string | undefined;\n\n  /** Program description. */\n  description?: string | undefined;\n\n  /** Program executable name. */\n  bin?: string | undefined;\n\n  /** Custom error boundary fallback component */\n  ErrorBoundaryFallbackComponent?: ComponentType<FallbackProps>;\n\n  /** Perform check whether a newer version of the program is available. */\n  checkForUpdate?: boolean;\n};\n"],"names":[],"mappings":"AAAA,WA2BE"}

package/dist/program/ProgramDetail.js

@@ -1,5 +0,0 @@
-/**
- * Detailed program information.
- */ export { };
-
-//# sourceMappingURL=ProgramDetail.js.map

package/dist/program/ProgramDetail.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/program/ProgramDetail.ts"],"sourcesContent":["/**\n * Detailed program information.\n */\nexport type ProgramDetail = {\n  name?: string;\n  version?: string;\n  description?: string;\n  bin?: string;\n};\n"],"names":[],"mappings":"AAAA;;CAEC,GACD,WAKE"}

package/dist/program/ProgramError.js

@@ -1,8 +0,0 @@
-import { createCustomError } from '@jakubmazanec/error';
-/**
- * A subclass of `Error` that indicates a program failure.
- */ 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

package/dist/program/ProgramError.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/program/ProgramError.ts"],"sourcesContent":["import {createCustomError} from '@jakubmazanec/error';\n\n/**\n * A subclass of `Error` that indicates a program failure.\n */\nexport const ProgramError = createCustomError('ProgramError', {\n  NO_NESTED_RENDER:\n    'A React render process already exists. This usually occurs by triggering nested render calls.',\n});\n"],"names":["createCustomError","ProgramError","NO_NESTED_RENDER"],"mappings":"AAAA,SAAQA,iBAAiB,QAAO,sBAAsB;AAEtD;;CAEC,GACD,OAAO,MAAMC,eAAeD,kBAAkB,gBAAgB;IAC5DE,kBACE;AACJ,GAAG"}

package/dist/program/ProgramOptions.js

@@ -1,3 +0,0 @@
-export { };
-
-//# sourceMappingURL=ProgramOptions.js.map

package/dist/program/ProgramOptions.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/program/ProgramOptions.ts"],"sourcesContent":["import {type ComponentType} from 'react';\nimport {type FallbackProps} from 'react-error-boundary';\n\n/**\n * {@link Program.constructor | Program constructor} options parameter.\n */\nexport type ProgramOptions = {\n  /** Program name. */\n  name?: string | undefined;\n\n  /** More readable program name. */\n  displayName?: string | undefined;\n\n  /** Program version. */\n  version?: string | undefined;\n\n  /** Program latest version. */\n  latestVersion?: string | undefined;\n\n  /** Program description. */\n  description?: string | undefined;\n\n  /** Program executable name. */\n  bin?: string | undefined;\n\n  /** Custom error boundary fallback component */\n  ErrorBoundaryFallbackComponent?: ComponentType<FallbackProps> | undefined;\n\n  /** Perform check whether a newer version of the program is available. */\n  checkForUpdate?: boolean;\n};\n"],"names":[],"mappings":"AAAA,WA8BE"}

package/dist/program/ProgramStreams.js

@@ -1,5 +0,0 @@
-/**
- * {@link Program} streams;
- */ export { };
-
-//# sourceMappingURL=ProgramStreams.js.map

package/dist/program/ProgramStreams.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/program/ProgramStreams.ts"],"sourcesContent":["/**\n * {@link Program} streams;\n */\nexport type ProgramStreams = {\n  stderr: NodeJS.WriteStream;\n  stdin: NodeJS.ReadStream;\n  stdout: NodeJS.WriteStream;\n};\n"],"names":[],"mappings":"AAAA;;CAEC,GACD,WAIE"}

package/dist/program/getProgramDetail.js

@@ -1,27 +0,0 @@
-/**
- * Creates detailed information about a {@lincode Program}.
- */ 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;
-}
-
-//# sourceMappingURL=getProgramDetail.js.map