@jakubmazanec/cli 0.4.0-unstable.d6c542d → 0.4.0

package/README.md

@@ -17,10 +17,13 @@ npm install @jakubmazanec/cli
 ⚠️ This is an [ESM](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c) package!
 It cannot be required from a CommonJS module.
 
+<!-- prerequisites -->
+
 #### Prerequisites
 
-- Node.js 20 or later
+- Node.js 22 or later
 - TypeScript 5 or later
+<!-- prerequisites -->
 
 ## Usage
 

package/build/program/Program.js

@@ -1,7 +1,7 @@
 "use strict";
 import fs from "fs-extra";
 import fetchLatestVersion from "latest-version";
-import path from "path";
+import path from "node:path";
 import { CACHE_PATH } from "../constants.js";
 import { Failure, Help } from "../ui.js";
 import { Wrapper } from "../ui/internals.js";

package/build/program/Program.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../source/program/Program.ts"],
-  "sourcesContent": ["/* eslint-disable @typescript-eslint/no-explicit-any -- needed */\nimport {type Argv, type OptionsConfig, type ParametersConfig} 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 {CACHE_PATH} from '../constants.js';\nimport {Failure, Help} from '../ui.js';\nimport {Wrapper} from '../ui/internals.js';\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';\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"],
+  "sourcesContent": ["/* eslint-disable @typescript-eslint/no-explicit-any -- needed */\nimport {type Argv, type OptionsConfig, type ParametersConfig} from '@jakubmazanec/args';\nimport fs from 'fs-extra';\nimport fetchLatestVersion from 'latest-version';\nimport path from 'node:path';\nimport {type ComponentType} from 'react';\nimport {type FallbackProps} from 'react-error-boundary';\n\nimport {CACHE_PATH} from '../constants.js';\nimport {Failure, Help} from '../ui.js';\nimport {Wrapper} from '../ui/internals.js';\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';\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"],
   "mappings": "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",
   "names": []
 }

package/build/program.d.ts

@@ -1,11 +1,11 @@
 export * from './program/Command.js';
-export * from './program/CommandAction.js';
-export * from './program/CommandArguments.js';
-export * from './program/CommandOptions.js';
+export type * from './program/CommandAction.js';
+export type * from './program/CommandArguments.js';
+export type * from './program/CommandOptions.js';
 export * from './program/getProgramDetail.js';
 export * from './program/Program.js';
-export * from './program/ProgramCreateOptions.js';
-export * from './program/ProgramDetail.js';
+export type * from './program/ProgramCreateOptions.js';
+export type * from './program/ProgramDetail.js';
 export * from './program/ProgramError.js';
-export * from './program/ProgramOptions.js';
-export * from './program/ProgramStreams.js';
+export type * from './program/ProgramOptions.js';
+export type * from './program/ProgramStreams.js';

package/build/program.js

@@ -1,13 +1,6 @@
 "use strict";
 export * from "./program/Command.js";
-export * from "./program/CommandAction.js";
-export * from "./program/CommandArguments.js";
-export * from "./program/CommandOptions.js";
 export * from "./program/getProgramDetail.js";
 export * from "./program/Program.js";
-export * from "./program/ProgramCreateOptions.js";
-export * from "./program/ProgramDetail.js";
 export * from "./program/ProgramError.js";
-export * from "./program/ProgramOptions.js";
-export * from "./program/ProgramStreams.js";
 //# sourceMappingURL=program.js.map

package/build/program.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../source/program.ts"],
-  "sourcesContent": ["export * from './program/Command.js';\nexport * from './program/CommandAction.js';\nexport * from './program/CommandArguments.js';\nexport * from './program/CommandOptions.js';\nexport * from './program/getProgramDetail.js';\nexport * from './program/Program.js';\nexport * from './program/ProgramCreateOptions.js';\nexport * from './program/ProgramDetail.js';\nexport * from './program/ProgramError.js';\nexport * from './program/ProgramOptions.js';\nexport * from './program/ProgramStreams.js';\n"],
-  "mappings": ";AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "sourcesContent": ["export * from './program/Command.js';\nexport type * from './program/CommandAction.js';\nexport type * from './program/CommandArguments.js';\nexport type * from './program/CommandOptions.js';\nexport * from './program/getProgramDetail.js';\nexport * from './program/Program.js';\nexport type * from './program/ProgramCreateOptions.js';\nexport type * from './program/ProgramDetail.js';\nexport * from './program/ProgramError.js';\nexport type * from './program/ProgramOptions.js';\nexport type * from './program/ProgramStreams.js';\n"],
+  "mappings": ";AAAA,cAAc;AAId,cAAc;AACd,cAAc;AAGd,cAAc;",
   "names": []
 }

package/build/ui/Failure.js

@@ -10,10 +10,10 @@ export function Failure({ error, errorDetail, ...boxProps }) {
   return /* @__PURE__ */ jsxs(Box, { ...boxProps, flexDirection: "column", children: [
     /* @__PURE__ */ jsx(Header, { icon: icons.error, children: /* @__PURE__ */ jsx(Text, { color: colors.highlighted, children: label }) }),
     description ? /* @__PURE__ */ jsx(Box, { flexDirection: "column", marginLeft: 2, children: /* @__PURE__ */ jsx(Text, { color: colors.failure, children: description }) }) : null,
-    stack ? /* @__PURE__ */ jsx(Box, { flexDirection: "column", marginTop: 1, marginLeft: 2, children: /* @__PURE__ */ jsx(Text, { color: colors.muted, children: stack }) }) : null,
+    stack ? /* @__PURE__ */ jsx(Box, { flexDirection: "column", marginLeft: 2, marginTop: 1, children: /* @__PURE__ */ jsx(Text, { color: colors.muted, children: stack }) }) : null,
     cause ? /* @__PURE__ */ jsxs(Fragment, { children: [
-      /* @__PURE__ */ jsx(Box, { flexDirection: "column", marginTop: 1, marginLeft: 2, children: /* @__PURE__ */ jsx(Text, { color: colors.muted, children: cause.description }) }),
-      cause.stack ? /* @__PURE__ */ jsx(Box, { flexDirection: "column", marginTop: 1, marginLeft: 2, children: /* @__PURE__ */ jsx(Text, { color: colors.muted, children: cause.stack }) }) : null
+      /* @__PURE__ */ jsx(Box, { flexDirection: "column", marginLeft: 2, marginTop: 1, children: /* @__PURE__ */ jsx(Text, { color: colors.muted, children: cause.description }) }),
+      cause.stack ? /* @__PURE__ */ jsx(Box, { flexDirection: "column", marginLeft: 2, marginTop: 1, children: /* @__PURE__ */ jsx(Text, { color: colors.muted, children: cause.stack }) }) : null
     ] }) : null
   ] });
 }

package/build/ui/Failure.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../source/ui/Failure.tsx"],
-  "sourcesContent": ["import {Box, type BoxProps, Text} from 'ink';\n\nimport * as colors from './colors.js';\nimport {type ErrorDetail} from './ErrorDetail.js';\nimport {getErrorDetail} from './getErrorDetail.js';\nimport {Header} from './Header.js';\nimport * as icons from './icons.js';\n\n/**\n * {@link Failure} component props.\n */\nexport type FailureProps = BoxProps & {\n  /** Error that describes a failure state. Function {@link getErrorDetail} is used for getting all the information from the error; you can use it to implement own retrieval logic and pass the result as `errorDetail` prop. */\n  error: Error;\n\n  /** Information about the failure state. Overrides information retireved from `error` prop. */\n  errorDetail?: ErrorDetail;\n};\n\n/**\n * A component that renders a failure state.\n */\nexport function Failure({error, errorDetail, ...boxProps}: FailureProps) {\n  let {label, description, stack, cause} = errorDetail ?? getErrorDetail(error);\n\n  return (\n    <Box {...boxProps} flexDirection=\"column\">\n      <Header icon={icons.error}>\n        <Text color={colors.highlighted}>{label}</Text>\n      </Header>\n\n      {description ?\n        <Box flexDirection=\"column\" marginLeft={2}>\n          <Text color={colors.failure}>{description}</Text>\n        </Box>\n      : null}\n\n      {stack ?\n        <Box flexDirection=\"column\" marginTop={1} marginLeft={2}>\n          <Text color={colors.muted}>{stack}</Text>\n        </Box>\n      : null}\n\n      {cause ?\n        <>\n          <Box flexDirection=\"column\" marginTop={1} marginLeft={2}>\n            <Text color={colors.muted}>{cause.description}</Text>\n          </Box>\n\n          {cause.stack ?\n            <Box flexDirection=\"column\" marginTop={1} marginLeft={2}>\n              <Text color={colors.muted}>{cause.stack}</Text>\n            </Box>\n          : null}\n        </>\n      : null}\n    </Box>\n  );\n}\n"],
-  "mappings": ";AA4BQ,SAgBA,UAhBA,KAgBA,YAhBA;AA5BR,SAAQ,KAAoB,YAAW;AAEvC,YAAY,YAAY;AAExB,SAAQ,sBAAqB;AAC7B,SAAQ,cAAa;AACrB,YAAY,WAAW;AAgBhB,gBAAS,QAAQ,EAAC,OAAO,aAAa,GAAG,SAAQ,GAAiB;AACvE,MAAI,EAAC,OAAO,aAAa,OAAO,MAAK,IAAI,eAAe,eAAe,KAAK;AAE5E,SACE,qBAAC,OAAK,GAAG,UAAU,eAAc,UAC/B;AAAA,wBAAC,UAAO,MAAM,MAAM,OAClB,8BAAC,QAAK,OAAO,OAAO,aAAc,iBAAM,GAC1C;AAAA,IAEC,cACC,oBAAC,OAAI,eAAc,UAAS,YAAY,GACtC,8BAAC,QAAK,OAAO,OAAO,SAAU,uBAAY,GAC5C,IACA;AAAA,IAED,QACC,oBAAC,OAAI,eAAc,UAAS,WAAW,GAAG,YAAY,GACpD,8BAAC,QAAK,OAAO,OAAO,OAAQ,iBAAM,GACpC,IACA;AAAA,IAED,QACC,iCACE;AAAA,0BAAC,OAAI,eAAc,UAAS,WAAW,GAAG,YAAY,GACpD,8BAAC,QAAK,OAAO,OAAO,OAAQ,gBAAM,aAAY,GAChD;AAAA,MAEC,MAAM,QACL,oBAAC,OAAI,eAAc,UAAS,WAAW,GAAG,YAAY,GACpD,8BAAC,QAAK,OAAO,OAAO,OAAQ,gBAAM,OAAM,GAC1C,IACA;AAAA,OACJ,IACA;AAAA,KACJ;AAEJ;",
+  "sourcesContent": ["import {Box, type BoxProps, Text} from 'ink';\n\nimport * as colors from './colors.js';\nimport {type ErrorDetail} from './ErrorDetail.js';\nimport {getErrorDetail} from './getErrorDetail.js';\nimport {Header} from './Header.js';\nimport * as icons from './icons.js';\n\n/**\n * {@link Failure} component props.\n */\nexport type FailureProps = BoxProps & {\n  /** Error that describes a failure state. Function {@link getErrorDetail} is used for getting all the information from the error; you can use it to implement own retrieval logic and pass the result as `errorDetail` prop. */\n  error: Error;\n\n  /** Information about the failure state. Overrides information retireved from `error` prop. */\n  errorDetail?: ErrorDetail;\n};\n\n/**\n * A component that renders a failure state.\n */\nexport function Failure({error, errorDetail, ...boxProps}: FailureProps) {\n  let {label, description, stack, cause} = errorDetail ?? getErrorDetail(error);\n\n  return (\n    <Box {...boxProps} flexDirection=\"column\">\n      <Header icon={icons.error}>\n        <Text color={colors.highlighted}>{label}</Text>\n      </Header>\n\n      {description ?\n        <Box flexDirection=\"column\" marginLeft={2}>\n          <Text color={colors.failure}>{description}</Text>\n        </Box>\n      : null}\n\n      {stack ?\n        <Box flexDirection=\"column\" marginLeft={2} marginTop={1}>\n          <Text color={colors.muted}>{stack}</Text>\n        </Box>\n      : null}\n\n      {cause ?\n        <>\n          <Box flexDirection=\"column\" marginLeft={2} marginTop={1}>\n            <Text color={colors.muted}>{cause.description}</Text>\n          </Box>\n\n          {cause.stack ?\n            <Box flexDirection=\"column\" marginLeft={2} marginTop={1}>\n              <Text color={colors.muted}>{cause.stack}</Text>\n            </Box>\n          : null}\n        </>\n      : null}\n    </Box>\n  );\n}\n"],
+  "mappings": ";AA4BQ,SAgBA,UAhBA,KAgBA,YAhBA;AA5BR,SAAQ,KAAoB,YAAW;AAEvC,YAAY,YAAY;AAExB,SAAQ,sBAAqB;AAC7B,SAAQ,cAAa;AACrB,YAAY,WAAW;AAgBhB,gBAAS,QAAQ,EAAC,OAAO,aAAa,GAAG,SAAQ,GAAiB;AACvE,MAAI,EAAC,OAAO,aAAa,OAAO,MAAK,IAAI,eAAe,eAAe,KAAK;AAE5E,SACE,qBAAC,OAAK,GAAG,UAAU,eAAc,UAC/B;AAAA,wBAAC,UAAO,MAAM,MAAM,OAClB,8BAAC,QAAK,OAAO,OAAO,aAAc,iBAAM,GAC1C;AAAA,IAEC,cACC,oBAAC,OAAI,eAAc,UAAS,YAAY,GACtC,8BAAC,QAAK,OAAO,OAAO,SAAU,uBAAY,GAC5C,IACA;AAAA,IAED,QACC,oBAAC,OAAI,eAAc,UAAS,YAAY,GAAG,WAAW,GACpD,8BAAC,QAAK,OAAO,OAAO,OAAQ,iBAAM,GACpC,IACA;AAAA,IAED,QACC,iCACE;AAAA,0BAAC,OAAI,eAAc,UAAS,YAAY,GAAG,WAAW,GACpD,8BAAC,QAAK,OAAO,OAAO,OAAQ,gBAAM,aAAY,GAChD;AAAA,MAEC,MAAM,QACL,oBAAC,OAAI,eAAc,UAAS,YAAY,GAAG,WAAW,GACpD,8BAAC,QAAK,OAAO,OAAO,OAAQ,gBAAM,OAAM,GAC1C,IACA;AAAA,OACJ,IACA;AAAA,KACJ;AAEJ;",
   "names": []
 }

package/build/ui/Help.js

@@ -30,7 +30,7 @@ export function Help({ program, ...boxProps }) {
         if (command.description) {
           line += ` ${command.description}`;
         }
-        return /* @__PURE__ */ jsx(Box, { marginLeft: 2, flexDirection: "column", children: /* @__PURE__ */ jsx(Text, { children: line }) }, command.name);
+        return /* @__PURE__ */ jsx(Box, { flexDirection: "column", marginLeft: 2, children: /* @__PURE__ */ jsx(Text, { children: line }) }, command.name);
       })
     ] }) : null
   ] });

package/build/ui/Help.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../source/ui/Help.tsx"],
-  "sourcesContent": ["import chalk from 'chalk';\nimport {Box, type BoxProps, Text} from 'ink';\n\nimport {type Program} from '../program.js';\nimport * as colors from './colors.js';\nimport {Header} from './Header.js';\nimport * as icons from './icons.js';\n\n/**\n * {@link Help} component props.\n */\nexport type HelpProps = BoxProps & {\n  /** {@link Program} instance. */\n  program: Program;\n};\n\n/**\n * A component that renders help information.\n */\nexport function Help({program, ...boxProps}: HelpProps) {\n  return (\n    <Box {...boxProps} flexDirection=\"column\">\n      <Text>{`${chalk[colors.notice](program.displayName ?? program.name ?? '?')} ${chalk[\n        colors.muted\n      ](program.version ?? '?')}`}</Text>\n      <Text color={colors.body}>{program.description}</Text>\n\n      {program.commands.length ?\n        <>\n          <Header icon={icons.info} marginTop={1}>\n            <Text color={colors.highlighted}>Usage</Text>\n          </Header>\n          {program.commands.map((command) => {\n            let line = `${chalk[colors.muted](program.bin ?? '?')} ${command.name}`;\n\n            if (command.parameters) {\n              if (command.parameters.some((parameterConfig) => !!parameterConfig.required)) {\n                line += ` ${chalk[colors.muted]('<parameters>')}`;\n              } else {\n                line += ` ${chalk[colors.muted]('[<parameters>]')}`;\n              }\n            }\n\n            if (command.options) {\n              if (\n                Object.entries(command.options).some(([, optionConfig]) => !!optionConfig.required)\n              ) {\n                line += ` ${chalk[colors.muted]('<options>')}`;\n              } else {\n                line += ` ${chalk[colors.muted]('[<options>]')}`;\n              }\n            }\n\n            if (command.description) {\n              line += ` ${command.description}`;\n            }\n\n            return (\n              <Box key={command.name} marginLeft={2} flexDirection=\"column\">\n                <Text>{line}</Text>\n              </Box>\n            );\n          })}\n        </>\n      : null}\n    </Box>\n  );\n}\n"],
-  "mappings": ";AAsBM,SAME,UANF,KAME,YANF;AAtBN,OAAO,WAAW;AAClB,SAAQ,KAAoB,YAAW;AAGvC,YAAY,YAAY;AACxB,SAAQ,cAAa;AACrB,YAAY,WAAW;AAahB,gBAAS,KAAK,EAAC,SAAS,GAAG,SAAQ,GAAc;AACtD,SACE,qBAAC,OAAK,GAAG,UAAU,eAAc,UAC/B;AAAA,wBAAC,QAAM,aAAG,MAAM,OAAO,MAAM,EAAE,QAAQ,eAAe,QAAQ,QAAQ,GAAG,CAAC,IAAI,MAC5E,OAAO,KACT,EAAE,QAAQ,WAAW,GAAG,CAAC,IAAG;AAAA,IAC5B,oBAAC,QAAK,OAAO,OAAO,MAAO,kBAAQ,aAAY;AAAA,IAE9C,QAAQ,SAAS,SAChB,iCACE;AAAA,0BAAC,UAAO,MAAM,MAAM,MAAM,WAAW,GACnC,8BAAC,QAAK,OAAO,OAAO,aAAa,mBAAK,GACxC;AAAA,MACC,QAAQ,SAAS,IAAI,CAAC,YAAY;AACjC,YAAI,OAAO,GAAG,MAAM,OAAO,KAAK,EAAE,QAAQ,OAAO,GAAG,CAAC,IAAI,QAAQ,IAAI;AAErE,YAAI,QAAQ,YAAY;AACtB,cAAI,QAAQ,WAAW,KAAK,CAAC,oBAAoB,CAAC,CAAC,gBAAgB,QAAQ,GAAG;AAC5E,oBAAQ,IAAI,MAAM,OAAO,KAAK,EAAE,cAAc,CAAC;AAAA,UACjD,OAAO;AACL,oBAAQ,IAAI,MAAM,OAAO,KAAK,EAAE,gBAAgB,CAAC;AAAA,UACnD;AAAA,QACF;AAEA,YAAI,QAAQ,SAAS;AACnB,cACE,OAAO,QAAQ,QAAQ,OAAO,EAAE,KAAK,CAAC,CAAC,EAAE,YAAY,MAAM,CAAC,CAAC,aAAa,QAAQ,GAClF;AACA,oBAAQ,IAAI,MAAM,OAAO,KAAK,EAAE,WAAW,CAAC;AAAA,UAC9C,OAAO;AACL,oBAAQ,IAAI,MAAM,OAAO,KAAK,EAAE,aAAa,CAAC;AAAA,UAChD;AAAA,QACF;AAEA,YAAI,QAAQ,aAAa;AACvB,kBAAQ,IAAI,QAAQ,WAAW;AAAA,QACjC;AAEA,eACE,oBAAC,OAAuB,YAAY,GAAG,eAAc,UACnD,8BAAC,QAAM,gBAAK,KADJ,QAAQ,IAElB;AAAA,MAEJ,CAAC;AAAA,OACH,IACA;AAAA,KACJ;AAEJ;",
+  "sourcesContent": ["import chalk from 'chalk';\nimport {Box, type BoxProps, Text} from 'ink';\n\nimport {type Program} from '../program.js';\nimport * as colors from './colors.js';\nimport {Header} from './Header.js';\nimport * as icons from './icons.js';\n\n/**\n * {@link Help} component props.\n */\nexport type HelpProps = BoxProps & {\n  /** {@link Program} instance. */\n  program: Program;\n};\n\n/**\n * A component that renders help information.\n */\nexport function Help({program, ...boxProps}: HelpProps) {\n  return (\n    <Box {...boxProps} flexDirection=\"column\">\n      <Text>{`${chalk[colors.notice](program.displayName ?? program.name ?? '?')} ${chalk[\n        colors.muted\n      ](program.version ?? '?')}`}</Text>\n      <Text color={colors.body}>{program.description}</Text>\n\n      {program.commands.length ?\n        <>\n          <Header icon={icons.info} marginTop={1}>\n            <Text color={colors.highlighted}>Usage</Text>\n          </Header>\n          {program.commands.map((command) => {\n            let line = `${chalk[colors.muted](program.bin ?? '?')} ${command.name}`;\n\n            if (command.parameters) {\n              if (command.parameters.some((parameterConfig) => !!parameterConfig.required)) {\n                line += ` ${chalk[colors.muted]('<parameters>')}`;\n              } else {\n                line += ` ${chalk[colors.muted]('[<parameters>]')}`;\n              }\n            }\n\n            if (command.options) {\n              if (\n                Object.entries(command.options).some(([, optionConfig]) => !!optionConfig.required)\n              ) {\n                line += ` ${chalk[colors.muted]('<options>')}`;\n              } else {\n                line += ` ${chalk[colors.muted]('[<options>]')}`;\n              }\n            }\n\n            if (command.description) {\n              line += ` ${command.description}`;\n            }\n\n            return (\n              <Box key={command.name} flexDirection=\"column\" marginLeft={2}>\n                <Text>{line}</Text>\n              </Box>\n            );\n          })}\n        </>\n      : null}\n    </Box>\n  );\n}\n"],
+  "mappings": ";AAsBM,SAME,UANF,KAME,YANF;AAtBN,OAAO,WAAW;AAClB,SAAQ,KAAoB,YAAW;AAGvC,YAAY,YAAY;AACxB,SAAQ,cAAa;AACrB,YAAY,WAAW;AAahB,gBAAS,KAAK,EAAC,SAAS,GAAG,SAAQ,GAAc;AACtD,SACE,qBAAC,OAAK,GAAG,UAAU,eAAc,UAC/B;AAAA,wBAAC,QAAM,aAAG,MAAM,OAAO,MAAM,EAAE,QAAQ,eAAe,QAAQ,QAAQ,GAAG,CAAC,IAAI,MAC5E,OAAO,KACT,EAAE,QAAQ,WAAW,GAAG,CAAC,IAAG;AAAA,IAC5B,oBAAC,QAAK,OAAO,OAAO,MAAO,kBAAQ,aAAY;AAAA,IAE9C,QAAQ,SAAS,SAChB,iCACE;AAAA,0BAAC,UAAO,MAAM,MAAM,MAAM,WAAW,GACnC,8BAAC,QAAK,OAAO,OAAO,aAAa,mBAAK,GACxC;AAAA,MACC,QAAQ,SAAS,IAAI,CAAC,YAAY;AACjC,YAAI,OAAO,GAAG,MAAM,OAAO,KAAK,EAAE,QAAQ,OAAO,GAAG,CAAC,IAAI,QAAQ,IAAI;AAErE,YAAI,QAAQ,YAAY;AACtB,cAAI,QAAQ,WAAW,KAAK,CAAC,oBAAoB,CAAC,CAAC,gBAAgB,QAAQ,GAAG;AAC5E,oBAAQ,IAAI,MAAM,OAAO,KAAK,EAAE,cAAc,CAAC;AAAA,UACjD,OAAO;AACL,oBAAQ,IAAI,MAAM,OAAO,KAAK,EAAE,gBAAgB,CAAC;AAAA,UACnD;AAAA,QACF;AAEA,YAAI,QAAQ,SAAS;AACnB,cACE,OAAO,QAAQ,QAAQ,OAAO,EAAE,KAAK,CAAC,CAAC,EAAE,YAAY,MAAM,CAAC,CAAC,aAAa,QAAQ,GAClF;AACA,oBAAQ,IAAI,MAAM,OAAO,KAAK,EAAE,WAAW,CAAC;AAAA,UAC9C,OAAO;AACL,oBAAQ,IAAI,MAAM,OAAO,KAAK,EAAE,aAAa,CAAC;AAAA,UAChD;AAAA,QACF;AAEA,YAAI,QAAQ,aAAa;AACvB,kBAAQ,IAAI,QAAQ,WAAW;AAAA,QACjC;AAEA,eACE,oBAAC,OAAuB,eAAc,UAAS,YAAY,GACzD,8BAAC,QAAM,gBAAK,KADJ,QAAQ,IAElB;AAAA,MAEJ,CAAC;AAAA,OACH,IACA;AAAA,KACJ;AAEJ;",
   "names": []
 }

package/build/ui/form/FormRow.js

@@ -33,39 +33,39 @@ export function FormRow({
     [rowName, onComplete]
   );
   switch (config.type) {
-    case "text": {
+    case "confirm": {
+      return null;
+    }
+    case "select": {
       return /* @__PURE__ */ jsx(
-        TextInput,
+        SelectInput,
         {
-          label: config.label ?? "",
-          validate: config.validate,
-          value,
+          items: rows ? rows[rowName].choices : [],
           focus,
           isComplete,
-          onChange: handleChange,
-          onSubmit: handleFinish,
+          label: config.label ?? "",
+          onSelect: handleSelectFinish,
           ...boxProps
         },
         String(rowName)
       );
     }
-    case "select": {
+    case "text": {
       return /* @__PURE__ */ jsx(
-        SelectInput,
+        TextInput,
         {
-          label: config.label ?? "",
-          items: rows ? rows[rowName].choices : [],
           focus,
           isComplete,
-          onSelect: handleSelectFinish,
+          label: config.label ?? "",
+          validate: config.validate,
+          value,
+          onChange: handleChange,
+          onSubmit: handleFinish,
           ...boxProps
         },
         String(rowName)
       );
     }
-    case "confirm": {
-      return null;
-    }
     default: {
       config;
       return null;

package/build/ui/form/FormRow.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../source/ui/form/FormRow.tsx"],
-  "sourcesContent": ["import {type BoxProps} from 'ink';\nimport {useCallback} from 'react';\n\nimport {type FormConfig} from './FormConfig.js';\nimport {type FormProps} from './FormProps.js';\nimport {type FormRowConfig} from './FormRowConfig.js';\nimport {SelectInput} from './SelectInput.js';\nimport {TextInput} from './TextInput.js';\n\n/**\n * Form row component props.\n */\ntype FormRowProps<C extends FormConfig> = BoxProps & {\n  /** Form row configuration. */\n  config: FormRowConfig;\n\n  // TODO: Should all rows props be passed to each row?\n  /** Props of all form rows. */\n  rows: FormProps<C>['rows'] | null;\n\n  /** Row name. */\n  rowName: keyof C['rows'];\n\n  /** Value. */\n  value: unknown;\n\n  /** Should component listen to Listen to user's input? Useful in case there are multiple input components at the same time and input must be \"routed\" to a specific component. */\n  focus: boolean;\n\n  /** Handler function that is called when value changes. */\n  onChange: (value: unknown, inputName: keyof C['rows']) => void;\n\n  /** Handler function that is called when the value is accepted. */\n  onComplete: (value: unknown, inputName: keyof C['rows']) => void;\n\n  /** Indicates whether value has been accepted. Component in the row then doesn't accept more input. */\n  isComplete: boolean;\n};\n\n/**\n * Form row component.\n */\nexport function FormRow<C extends FormConfig>({\n  rowName,\n  config,\n  rows,\n  value,\n  focus,\n  isComplete,\n  onChange,\n  onComplete,\n  ...boxProps\n}: FormRowProps<C>) {\n  // TODO: Each input component handles values and events differently; the APIs should be adjusted.\n  let handleChange = useCallback(\n    (newValue: unknown) => {\n      onChange(newValue, rowName);\n    },\n    [rowName, onChange],\n  );\n\n  let handleFinish = useCallback(\n    (newValue: unknown) => {\n      onComplete(newValue, rowName);\n    },\n    [rowName, onComplete],\n  );\n\n  let handleSelectFinish = useCallback(\n    (item: {value: unknown}) => {\n      onComplete(item.value, rowName);\n    },\n    [rowName, onComplete],\n  );\n\n  switch (config.type) {\n    case 'text': {\n      return (\n        <TextInput\n          key={String(rowName)}\n          label={config.label ?? ''}\n          validate={config.validate}\n          value={value as string}\n          focus={focus}\n          isComplete={isComplete}\n          onChange={handleChange}\n          onSubmit={handleFinish}\n          {...boxProps}\n        />\n      );\n    }\n    case 'select': {\n      return (\n        <SelectInput\n          key={String(rowName)}\n          label={config.label ?? ''}\n          items={\n            rows ?\n              (\n                (\n                  rows as {\n                    [key: string]: unknown;\n                  }\n                )[rowName as string] as {choices: Array<{value: string; label: string}>}\n              ).choices\n            : []\n          }\n          focus={focus}\n          isComplete={isComplete}\n          onSelect={handleSelectFinish}\n          {...boxProps}\n        />\n      );\n    }\n    case 'confirm': {\n      return null;\n    }\n    default: {\n      config satisfies never;\n\n      return null;\n    }\n  }\n}\n"],
-  "mappings": ";AA8EQ;AA7ER,SAAQ,mBAAkB;AAK1B,SAAQ,mBAAkB;AAC1B,SAAQ,iBAAgB;AAmCjB,gBAAS,QAA8B;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAoB;AAElB,MAAI,eAAe;AAAA,IACjB,CAAC,aAAsB;AACrB,eAAS,UAAU,OAAO;AAAA,IAC5B;AAAA,IACA,CAAC,SAAS,QAAQ;AAAA,EACpB;AAEA,MAAI,eAAe;AAAA,IACjB,CAAC,aAAsB;AACrB,iBAAW,UAAU,OAAO;AAAA,IAC9B;AAAA,IACA,CAAC,SAAS,UAAU;AAAA,EACtB;AAEA,MAAI,qBAAqB;AAAA,IACvB,CAAC,SAA2B;AAC1B,iBAAW,KAAK,OAAO,OAAO;AAAA,IAChC;AAAA,IACA,CAAC,SAAS,UAAU;AAAA,EACtB;AAEA,UAAQ,OAAO,MAAM;AAAA,IACnB,KAAK,QAAQ;AACX,aACE;AAAA,QAAC;AAAA;AAAA,UAEC,OAAO,OAAO,SAAS;AAAA,UACvB,UAAU,OAAO;AAAA,UACjB;AAAA,UACA;AAAA,UACA;AAAA,UACA,UAAU;AAAA,UACV,UAAU;AAAA,UACT,GAAG;AAAA;AAAA,QARC,OAAO,OAAO;AAAA,MASrB;AAAA,IAEJ;AAAA,IACA,KAAK,UAAU;AACb,aACE;AAAA,QAAC;AAAA;AAAA,UAEC,OAAO,OAAO,SAAS;AAAA,UACvB,OACE,OAGM,KAGA,OAAiB,EACnB,UACF,CAAC;AAAA,UAEL;AAAA,UACA;AAAA,UACA,UAAU;AAAA,UACT,GAAG;AAAA;AAAA,QAhBC,OAAO,OAAO;AAAA,MAiBrB;AAAA,IAEJ;AAAA,IACA,KAAK,WAAW;AACd,aAAO;AAAA,IACT;AAAA,IACA,SAAS;AACP;AAEA,aAAO;AAAA,IACT;AAAA,EACF;AACF;",
+  "sourcesContent": ["import {type BoxProps} from 'ink';\nimport {useCallback} from 'react';\n\nimport {type FormConfig} from './FormConfig.js';\nimport {type FormProps} from './FormProps.js';\nimport {type FormRowConfig} from './FormRowConfig.js';\nimport {SelectInput} from './SelectInput.js';\nimport {TextInput} from './TextInput.js';\n\n/**\n * Form row component props.\n */\ntype FormRowProps<C extends FormConfig> = BoxProps & {\n  /** Form row configuration. */\n  config: FormRowConfig;\n\n  // TODO: Should all rows props be passed to each row?\n  /** Props of all form rows. */\n  rows: FormProps<C>['rows'] | null;\n\n  /** Row name. */\n  rowName: keyof C['rows'];\n\n  /** Value. */\n  value: unknown;\n\n  /** Should component listen to Listen to user's input? Useful in case there are multiple input components at the same time and input must be \"routed\" to a specific component. */\n  focus: boolean;\n\n  /** Handler function that is called when value changes. */\n  onChange: (value: unknown, inputName: keyof C['rows']) => void;\n\n  /** Handler function that is called when the value is accepted. */\n  onComplete: (value: unknown, inputName: keyof C['rows']) => void;\n\n  /** Indicates whether value has been accepted. Component in the row then doesn't accept more input. */\n  isComplete: boolean;\n};\n\n/**\n * Form row component.\n */\nexport function FormRow<C extends FormConfig>({\n  rowName,\n  config,\n  rows,\n  value,\n  focus,\n  isComplete,\n  onChange,\n  onComplete,\n  ...boxProps\n}: FormRowProps<C>) {\n  // TODO: Each input component handles values and events differently; the APIs should be adjusted.\n  let handleChange = useCallback(\n    (newValue: unknown) => {\n      onChange(newValue, rowName);\n    },\n    [rowName, onChange],\n  );\n\n  let handleFinish = useCallback(\n    (newValue: unknown) => {\n      onComplete(newValue, rowName);\n    },\n    [rowName, onComplete],\n  );\n\n  let handleSelectFinish = useCallback(\n    (item: {value: unknown}) => {\n      onComplete(item.value, rowName);\n    },\n    [rowName, onComplete],\n  );\n\n  switch (config.type) {\n    case 'confirm': {\n      return null;\n    }\n    case 'select': {\n      return (\n        <SelectInput\n          key={String(rowName)}\n          items={\n            rows ?\n              (\n                (\n                  rows as {\n                    [key: string]: unknown;\n                  }\n                )[rowName as string] as {choices: Array<{value: string; label: string}>}\n              ).choices\n            : []\n          }\n          focus={focus}\n          isComplete={isComplete}\n          label={config.label ?? ''}\n          onSelect={handleSelectFinish}\n          {...boxProps}\n        />\n      );\n    }\n    case 'text': {\n      return (\n        <TextInput\n          key={String(rowName)}\n          focus={focus}\n          isComplete={isComplete}\n          label={config.label ?? ''}\n          validate={config.validate}\n          value={value as string}\n          onChange={handleChange}\n          onSubmit={handleFinish}\n          {...boxProps}\n        />\n      );\n    }\n    default: {\n      config satisfies never;\n\n      return null;\n    }\n  }\n}\n"],
+  "mappings": ";AAiFQ;AAhFR,SAAQ,mBAAkB;AAK1B,SAAQ,mBAAkB;AAC1B,SAAQ,iBAAgB;AAmCjB,gBAAS,QAA8B;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAoB;AAElB,MAAI,eAAe;AAAA,IACjB,CAAC,aAAsB;AACrB,eAAS,UAAU,OAAO;AAAA,IAC5B;AAAA,IACA,CAAC,SAAS,QAAQ;AAAA,EACpB;AAEA,MAAI,eAAe;AAAA,IACjB,CAAC,aAAsB;AACrB,iBAAW,UAAU,OAAO;AAAA,IAC9B;AAAA,IACA,CAAC,SAAS,UAAU;AAAA,EACtB;AAEA,MAAI,qBAAqB;AAAA,IACvB,CAAC,SAA2B;AAC1B,iBAAW,KAAK,OAAO,OAAO;AAAA,IAChC;AAAA,IACA,CAAC,SAAS,UAAU;AAAA,EACtB;AAEA,UAAQ,OAAO,MAAM;AAAA,IACnB,KAAK,WAAW;AACd,aAAO;AAAA,IACT;AAAA,IACA,KAAK,UAAU;AACb,aACE;AAAA,QAAC;AAAA;AAAA,UAEC,OACE,OAGM,KAGA,OAAiB,EACnB,UACF,CAAC;AAAA,UAEL;AAAA,UACA;AAAA,UACA,OAAO,OAAO,SAAS;AAAA,UACvB,UAAU;AAAA,UACT,GAAG;AAAA;AAAA,QAhBC,OAAO,OAAO;AAAA,MAiBrB;AAAA,IAEJ;AAAA,IACA,KAAK,QAAQ;AACX,aACE;AAAA,QAAC;AAAA;AAAA,UAEC;AAAA,UACA;AAAA,UACA,OAAO,OAAO,SAAS;AAAA,UACvB,UAAU,OAAO;AAAA,UACjB;AAAA,UACA,UAAU;AAAA,UACV,UAAU;AAAA,UACT,GAAG;AAAA;AAAA,QARC,OAAO,OAAO;AAAA,MASrB;AAAA,IAEJ;AAAA,IACA,SAAS;AACP;AAEA,aAAO;AAAA,IACT;AAAA,EACF;AACF;",
   "names": []
 }

package/build/ui/form/SelectInput.d.ts

@@ -1,4 +1,5 @@
 import { type BoxProps } from 'ink';
+import React from 'react';
 import { type SelectInputItem } from './SelectInputItem.js';
 /**
  * {@linkcode SelectInput} component props.
@@ -24,5 +25,5 @@ type SelectInputProps = BoxProps & {
 /**
  * Select input component.
  */
-export declare function SelectInput({ label, items, focus, initialIndex, limit: userDefinedLimit, onSelect, onHighlight, isComplete, ...boxProps }: SelectInputProps): JSX.Element;
+export declare function SelectInput({ label, items, focus, initialIndex, limit: userDefinedLimit, onSelect, onHighlight, isComplete, ...boxProps }: SelectInputProps): React.JSX.Element;
 export {};

package/build/ui/form/SelectInput.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../source/ui/form/SelectInput.tsx"],
-  "sourcesContent": ["import {Box, type BoxProps, type Key, Text, useInput} from 'ink';\nimport _ from 'lodash';\nimport {useEffect, useRef, useState} from 'react';\n\nimport * as colors from '../colors.js';\nimport * as icons from '../icons.js';\nimport {rotate} from '../internals.js';\nimport {type SelectInputItem} from './SelectInputItem.js';\n\n/**\n * {@linkcode SelectInput} component props.\n */\ntype SelectInputProps = BoxProps & {\n  /** Text to display as a label. */\n  label: string;\n\n  /** Items to display in a list. */\n  items: SelectInputItem[];\n\n  /** Should component listen to user's input? Useful in case there are multiple input components at the same time and input must be handled only by a specific component. */\n  focus?: boolean | undefined;\n\n  /** Index of initially selected item. */\n  initialIndex?: number | undefined;\n\n  /** Number of items to display. */\n  limit?: number | undefined;\n\n  /** Handler function that is called when item is selected. */\n  onSelect?: ((item: SelectInputItem) => void) | undefined;\n\n  /** Handler function that is called when item is highlighted. */\n  onHighlight?: ((item: SelectInputItem) => void) | undefined;\n\n  /** Indicates whether value has been accepted. Component then doesn't accept more input. */\n  isComplete?: boolean | undefined;\n};\n\n/**\n * Select input component.\n */\nexport function SelectInput({\n  label,\n  items,\n  focus = true,\n  initialIndex = 0,\n  limit: userDefinedLimit,\n  onSelect,\n  onHighlight,\n  isComplete,\n  ...boxProps\n}: SelectInputProps): JSX.Element {\n  let [rotatedIndex, setRotatedIndex] = useState(0);\n  let [selectedIndex, setSelectedIndex] = useState(initialIndex);\n  let hasLimit = typeof userDefinedLimit === 'number' && items.length > userDefinedLimit;\n  let limit = hasLimit ? Math.min(userDefinedLimit as number, items.length) : items.length;\n  let previousItems = useRef<SelectInputItem[]>(items);\n\n  useEffect(() => {\n    if (\n      !_.isEqual(\n        previousItems.current.map((item) => item.value),\n        items.map((item) => item.value),\n      )\n    ) {\n      setRotatedIndex(0);\n      setSelectedIndex(0);\n    }\n\n    previousItems.current = items;\n  }, [items]);\n\n  useInput(\n    (input: string, key: Key) => {\n      if (input === 'k' || key.upArrow) {\n        let lastIndex = (hasLimit ? limit : items.length) - 1;\n        let isAtFirstIndex = selectedIndex === 0;\n        let nextIndex = hasLimit ? selectedIndex : lastIndex;\n        let nextRotatedIndex = isAtFirstIndex ? rotatedIndex + 1 : rotatedIndex;\n        let nextSelectedIndex = isAtFirstIndex ? nextIndex : selectedIndex - 1;\n\n        setRotatedIndex(nextRotatedIndex);\n        setSelectedIndex(nextSelectedIndex);\n\n        let slicedItems = hasLimit ? rotate(items, nextRotatedIndex).slice(0, limit) : items;\n\n        if (typeof onHighlight === 'function') {\n          onHighlight(slicedItems[nextSelectedIndex] as SelectInputItem);\n        }\n      }\n\n      if (input === 'j' || key.downArrow) {\n        let isAtLastIndex = selectedIndex === (hasLimit ? limit : items.length) - 1;\n        let nextIndex = hasLimit ? selectedIndex : 0;\n        let nextRotatedIndex = isAtLastIndex ? rotatedIndex - 1 : rotatedIndex;\n        let nextSelectedIndex = isAtLastIndex ? nextIndex : selectedIndex + 1;\n\n        setRotatedIndex(nextRotatedIndex);\n        setSelectedIndex(nextSelectedIndex);\n\n        let slicedItems = hasLimit ? rotate(items, nextRotatedIndex).slice(0, limit) : items;\n\n        if (typeof onHighlight === 'function') {\n          onHighlight(slicedItems[nextSelectedIndex] as SelectInputItem);\n        }\n      }\n\n      if (key.return) {\n        let slicedItems = hasLimit ? rotate(items, rotatedIndex).slice(0, limit) : items;\n\n        if (typeof onSelect === 'function') {\n          onSelect(slicedItems[selectedIndex] as SelectInputItem);\n        }\n      }\n    },\n    {isActive: focus},\n  );\n\n  let visibleItems: SelectInputItem[] =\n    hasLimit ? rotate(items, rotatedIndex).slice(0, limit) : items;\n\n  return (\n    <Box {...boxProps}>\n      <Box marginRight={1}>\n        <Text>{isComplete ? icons.success : icons.question}</Text>\n      </Box>\n\n      <Box flexDirection=\"column\">\n        <Box marginRight={1}>\n          <Text color={colors.highlighted}>{label}</Text>\n        </Box>\n        {isComplete ?\n          <Text color={colors.body}>\n            {items[selectedIndex]?.label ?? String(items[selectedIndex]?.value)}\n          </Text>\n        : <Box flexDirection=\"column\">\n            {visibleItems.map((item, index) => {\n              let isSelected = index === selectedIndex;\n\n              return (\n                <Box key={item.value}>\n                  <Box marginRight={1}>\n                    {isSelected ?\n                      <Text color={colors.selected}>{icons.selectedCircle}</Text>\n                    : <Text color={colors.unselected}>{icons.unselectedCircle}</Text>}\n                  </Box>\n                  <Text color={isSelected ? colors.highlighted : colors.muted}>{item.label}</Text>\n                </Box>\n              );\n            })}\n          </Box>\n        }\n      </Box>\n    </Box>\n  );\n}\n\n// partially based on https://github.com/vadimdemedes/ink-select-input/tree/309497ca641f55d8df0083ec2d07264f101358e4 (see https://github.com/vadimdemedes/ink-select-input/blob/309497ca641f55d8df0083ec2d07264f101358e4/license for license)\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {Box, type BoxProps, type Key, Text, useInput} from 'ink';\nimport _ from 'lodash';\nimport React, {useEffect, useRef, useState} from 'react';\n\nimport * as colors from '../colors.js';\nimport * as icons from '../icons.js';\nimport {rotate} from '../internals.js';\nimport {type SelectInputItem} from './SelectInputItem.js';\n\n/**\n * {@linkcode SelectInput} component props.\n */\ntype SelectInputProps = BoxProps & {\n  /** Text to display as a label. */\n  label: string;\n\n  /** Items to display in a list. */\n  items: SelectInputItem[];\n\n  /** Should component listen to user's input? Useful in case there are multiple input components at the same time and input must be handled only by a specific component. */\n  focus?: boolean | undefined;\n\n  /** Index of initially selected item. */\n  initialIndex?: number | undefined;\n\n  /** Number of items to display. */\n  limit?: number | undefined;\n\n  /** Handler function that is called when item is selected. */\n  onSelect?: ((item: SelectInputItem) => void) | undefined;\n\n  /** Handler function that is called when item is highlighted. */\n  onHighlight?: ((item: SelectInputItem) => void) | undefined;\n\n  /** Indicates whether value has been accepted. Component then doesn't accept more input. */\n  isComplete?: boolean | undefined;\n};\n\n/**\n * Select input component.\n */\nexport function SelectInput({\n  label,\n  items,\n  focus = true,\n  initialIndex = 0,\n  limit: userDefinedLimit,\n  onSelect,\n  onHighlight,\n  isComplete,\n  ...boxProps\n}: SelectInputProps): React.JSX.Element {\n  let [rotatedIndex, setRotatedIndex] = useState(0);\n  let [selectedIndex, setSelectedIndex] = useState(initialIndex);\n  let hasLimit = typeof userDefinedLimit === 'number' && items.length > userDefinedLimit;\n  let limit = hasLimit ? Math.min(userDefinedLimit as number, items.length) : items.length;\n  let previousItems = useRef<SelectInputItem[]>(items);\n\n  useEffect(() => {\n    if (\n      !_.isEqual(\n        previousItems.current.map((item) => item.value),\n        items.map((item) => item.value),\n      )\n    ) {\n      setRotatedIndex(0);\n      setSelectedIndex(0);\n    }\n\n    previousItems.current = items;\n  }, [items]);\n\n  useInput(\n    (input: string, key: Key) => {\n      if (input === 'k' || key.upArrow) {\n        let lastIndex = (hasLimit ? limit : items.length) - 1;\n        let isAtFirstIndex = selectedIndex === 0;\n        let nextIndex = hasLimit ? selectedIndex : lastIndex;\n        let nextRotatedIndex = isAtFirstIndex ? rotatedIndex + 1 : rotatedIndex;\n        let nextSelectedIndex = isAtFirstIndex ? nextIndex : selectedIndex - 1;\n\n        setRotatedIndex(nextRotatedIndex);\n        setSelectedIndex(nextSelectedIndex);\n\n        let slicedItems = hasLimit ? rotate(items, nextRotatedIndex).slice(0, limit) : items;\n\n        if (typeof onHighlight === 'function') {\n          onHighlight(slicedItems[nextSelectedIndex] as SelectInputItem);\n        }\n      }\n\n      if (input === 'j' || key.downArrow) {\n        let isAtLastIndex = selectedIndex === (hasLimit ? limit : items.length) - 1;\n        let nextIndex = hasLimit ? selectedIndex : 0;\n        let nextRotatedIndex = isAtLastIndex ? rotatedIndex - 1 : rotatedIndex;\n        let nextSelectedIndex = isAtLastIndex ? nextIndex : selectedIndex + 1;\n\n        setRotatedIndex(nextRotatedIndex);\n        setSelectedIndex(nextSelectedIndex);\n\n        let slicedItems = hasLimit ? rotate(items, nextRotatedIndex).slice(0, limit) : items;\n\n        if (typeof onHighlight === 'function') {\n          onHighlight(slicedItems[nextSelectedIndex] as SelectInputItem);\n        }\n      }\n\n      if (key.return) {\n        let slicedItems = hasLimit ? rotate(items, rotatedIndex).slice(0, limit) : items;\n\n        if (typeof onSelect === 'function') {\n          onSelect(slicedItems[selectedIndex] as SelectInputItem);\n        }\n      }\n    },\n    {isActive: focus},\n  );\n\n  let visibleItems: SelectInputItem[] =\n    hasLimit ? rotate(items, rotatedIndex).slice(0, limit) : items;\n\n  return (\n    <Box {...boxProps}>\n      <Box marginRight={1}>\n        <Text>{isComplete ? icons.success : icons.question}</Text>\n      </Box>\n\n      <Box flexDirection=\"column\">\n        <Box marginRight={1}>\n          <Text color={colors.highlighted}>{label}</Text>\n        </Box>\n        {isComplete ?\n          <Text color={colors.body}>\n            {items[selectedIndex]?.label ?? String(items[selectedIndex]?.value)}\n          </Text>\n        : <Box flexDirection=\"column\">\n            {visibleItems.map((item, index) => {\n              let isSelected = index === selectedIndex;\n\n              return (\n                <Box key={item.value}>\n                  <Box marginRight={1}>\n                    {isSelected ?\n                      <Text color={colors.selected}>{icons.selectedCircle}</Text>\n                    : <Text color={colors.unselected}>{icons.unselectedCircle}</Text>}\n                  </Box>\n                  <Text color={isSelected ? colors.highlighted : colors.muted}>{item.label}</Text>\n                </Box>\n              );\n            })}\n          </Box>\n        }\n      </Box>\n    </Box>\n  );\n}\n\n// partially based on https://github.com/vadimdemedes/ink-select-input/tree/309497ca641f55d8df0083ec2d07264f101358e4 (see https://github.com/vadimdemedes/ink-select-input/blob/309497ca641f55d8df0083ec2d07264f101358e4/license for license)\n"],
+  "mappings": "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",
   "names": []
 }

package/build/ui/form/createForm.js

@@ -51,12 +51,12 @@ export function createForm(formConfig) {
           /* @__PURE__ */ jsx(
             FormRow,
             {
-              marginTop: inputElements.length === 0 ? 0 : 1,
+              config: input,
               focus: rowName === activeInputName,
               isComplete: results[rowName].isComplete,
-              config: input,
-              rows,
+              marginTop: inputElements.length === 0 ? 0 : 1,
               rowName,
+              rows,
               value: results[rowName].value,
               onChange: handleChange,
               onComplete: handleFinish

package/build/ui/form/createForm.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../source/ui/form/createForm.tsx"],
-  "sourcesContent": ["import {Box, type BoxProps} from 'ink';\nimport {useCallback} from 'react';\n\nimport {type Form} from './Form.js';\nimport {type FormConfig} from './FormConfig.js';\nimport {type FormProps} from './FormProps.js';\nimport {FormRow} from './FormRow.js';\n\n/**\n * Creates form component that contains individual rows with inputs based on the provided config.\n *\n * @param formConfig Form configuration.\n * @returns Form component.\n */\nexport function createForm<C extends FormConfig>(formConfig: C): Form<C> {\n  let Form = ({\n    rows,\n    values: results,\n    onChange,\n    onComplete: onFinish,\n    ...boxProps\n  }: FormProps<C>) => {\n    let handleChange = useCallback(\n      (value: unknown, rowName: keyof C['rows']) => {\n        if (onChange) {\n          onChange({\n            ...results,\n            [rowName]: {\n              ...results[rowName],\n              value,\n            },\n          });\n        }\n      },\n      [onChange, results],\n    );\n\n    let handleFinish = useCallback(\n      (value: unknown, rowName: keyof C['rows']) => {\n        onFinish({\n          ...results,\n          [rowName]: {\n            value,\n            isComplete: true,\n          },\n        });\n      },\n      [onFinish, results],\n    );\n\n    let inputElements = [];\n    let activeInputName: string | null = null;\n\n    for (let [rowName] of Object.entries(formConfig.rows)) {\n      if (!results[rowName as keyof C['rows']].isComplete) {\n        activeInputName = String(rowName);\n\n        break;\n      }\n    }\n\n    for (let [rowName, input] of Object.entries(formConfig.rows)) {\n      if (results[rowName as keyof C['rows']].isComplete || rowName === activeInputName) {\n        inputElements.push(\n          <FormRow\n            key={rowName}\n            marginTop={inputElements.length === 0 ? 0 : 1}\n            focus={rowName === activeInputName}\n            isComplete={results[rowName as keyof C['rows']].isComplete}\n            config={input}\n            rows={rows}\n            rowName={rowName}\n            value={results[rowName as keyof C['rows']].value}\n            onChange={handleChange}\n            onComplete={handleFinish}\n          />,\n        );\n      }\n    }\n\n    return (\n      <Box {...(boxProps as BoxProps)} flexDirection=\"column\">\n        {inputElements}\n      </Box>\n    );\n  };\n\n  return Object.assign(Form, {config: formConfig});\n}\n"],
-  "mappings": ";AAgEU;AAhEV,SAAQ,WAAyB;AACjC,SAAQ,mBAAkB;AAK1B,SAAQ,eAAc;AAQf,gBAAS,WAAiC,YAAwB;AACvE,MAAI,OAAO,CAAC;AAAA,IACV;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,IACA,YAAY;AAAA,IACZ,GAAG;AAAA,EACL,MAAoB;AAClB,QAAI,eAAe;AAAA,MACjB,CAAC,OAAgB,YAA6B;AAC5C,YAAI,UAAU;AACZ,mBAAS;AAAA,YACP,GAAG;AAAA,YACH,CAAC,OAAO,GAAG;AAAA,cACT,GAAG,QAAQ,OAAO;AAAA,cAClB;AAAA,YACF;AAAA,UACF,CAAC;AAAA,QACH;AAAA,MACF;AAAA,MACA,CAAC,UAAU,OAAO;AAAA,IACpB;AAEA,QAAI,eAAe;AAAA,MACjB,CAAC,OAAgB,YAA6B;AAC5C,iBAAS;AAAA,UACP,GAAG;AAAA,UACH,CAAC,OAAO,GAAG;AAAA,YACT;AAAA,YACA,YAAY;AAAA,UACd;AAAA,QACF,CAAC;AAAA,MACH;AAAA,MACA,CAAC,UAAU,OAAO;AAAA,IACpB;AAEA,QAAI,gBAAgB,CAAC;AACrB,QAAI,kBAAiC;AAErC,aAAS,CAAC,OAAO,KAAK,OAAO,QAAQ,WAAW,IAAI,GAAG;AACrD,UAAI,CAAC,QAAQ,OAA0B,EAAE,YAAY;AACnD,0BAAkB,OAAO,OAAO;AAEhC;AAAA,MACF;AAAA,IACF;AAEA,aAAS,CAAC,SAAS,KAAK,KAAK,OAAO,QAAQ,WAAW,IAAI,GAAG;AAC5D,UAAI,QAAQ,OAA0B,EAAE,cAAc,YAAY,iBAAiB;AACjF,sBAAc;AAAA,UACZ;AAAA,YAAC;AAAA;AAAA,cAEC,WAAW,cAAc,WAAW,IAAI,IAAI;AAAA,cAC5C,OAAO,YAAY;AAAA,cACnB,YAAY,QAAQ,OAA0B,EAAE;AAAA,cAChD,QAAQ;AAAA,cACR;AAAA,cACA;AAAA,cACA,OAAO,QAAQ,OAA0B,EAAE;AAAA,cAC3C,UAAU;AAAA,cACV,YAAY;AAAA;AAAA,YATP;AAAA,UAUP;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAEA,WACE,oBAAC,OAAK,GAAI,UAAuB,eAAc,UAC5C,yBACH;AAAA,EAEJ;AAEA,SAAO,OAAO,OAAO,MAAM,EAAC,QAAQ,WAAU,CAAC;AACjD;",
+  "sourcesContent": ["import {Box, type BoxProps} from 'ink';\nimport {useCallback} from 'react';\n\nimport {type Form} from './Form.js';\nimport {type FormConfig} from './FormConfig.js';\nimport {type FormProps} from './FormProps.js';\nimport {FormRow} from './FormRow.js';\n\n/**\n * Creates form component that contains individual rows with inputs based on the provided config.\n *\n * @param formConfig Form configuration.\n * @returns Form component.\n */\nexport function createForm<C extends FormConfig>(formConfig: C): Form<C> {\n  let Form = ({\n    rows,\n    values: results,\n    onChange,\n    onComplete: onFinish,\n    ...boxProps\n  }: FormProps<C>) => {\n    let handleChange = useCallback(\n      (value: unknown, rowName: keyof C['rows']) => {\n        if (onChange) {\n          onChange({\n            ...results,\n            [rowName]: {\n              ...results[rowName],\n              value,\n            },\n          });\n        }\n      },\n      [onChange, results],\n    );\n\n    let handleFinish = useCallback(\n      (value: unknown, rowName: keyof C['rows']) => {\n        onFinish({\n          ...results,\n          [rowName]: {\n            value,\n            isComplete: true,\n          },\n        });\n      },\n      [onFinish, results],\n    );\n\n    let inputElements = [];\n    let activeInputName: string | null = null;\n\n    for (let [rowName] of Object.entries(formConfig.rows)) {\n      if (!results[rowName as keyof C['rows']].isComplete) {\n        activeInputName = String(rowName);\n\n        break;\n      }\n    }\n\n    for (let [rowName, input] of Object.entries(formConfig.rows)) {\n      if (results[rowName as keyof C['rows']].isComplete || rowName === activeInputName) {\n        inputElements.push(\n          <FormRow\n            key={rowName}\n            config={input}\n            focus={rowName === activeInputName}\n            isComplete={results[rowName as keyof C['rows']].isComplete}\n            marginTop={inputElements.length === 0 ? 0 : 1}\n            rowName={rowName}\n            rows={rows}\n            value={results[rowName as keyof C['rows']].value}\n            onChange={handleChange}\n            onComplete={handleFinish}\n          />,\n        );\n      }\n    }\n\n    return (\n      <Box {...(boxProps as BoxProps)} flexDirection=\"column\">\n        {inputElements}\n      </Box>\n    );\n  };\n\n  return Object.assign(Form, {config: formConfig});\n}\n"],
+  "mappings": ";AAgEU;AAhEV,SAAQ,WAAyB;AACjC,SAAQ,mBAAkB;AAK1B,SAAQ,eAAc;AAQf,gBAAS,WAAiC,YAAwB;AACvE,MAAI,OAAO,CAAC;AAAA,IACV;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,IACA,YAAY;AAAA,IACZ,GAAG;AAAA,EACL,MAAoB;AAClB,QAAI,eAAe;AAAA,MACjB,CAAC,OAAgB,YAA6B;AAC5C,YAAI,UAAU;AACZ,mBAAS;AAAA,YACP,GAAG;AAAA,YACH,CAAC,OAAO,GAAG;AAAA,cACT,GAAG,QAAQ,OAAO;AAAA,cAClB;AAAA,YACF;AAAA,UACF,CAAC;AAAA,QACH;AAAA,MACF;AAAA,MACA,CAAC,UAAU,OAAO;AAAA,IACpB;AAEA,QAAI,eAAe;AAAA,MACjB,CAAC,OAAgB,YAA6B;AAC5C,iBAAS;AAAA,UACP,GAAG;AAAA,UACH,CAAC,OAAO,GAAG;AAAA,YACT;AAAA,YACA,YAAY;AAAA,UACd;AAAA,QACF,CAAC;AAAA,MACH;AAAA,MACA,CAAC,UAAU,OAAO;AAAA,IACpB;AAEA,QAAI,gBAAgB,CAAC;AACrB,QAAI,kBAAiC;AAErC,aAAS,CAAC,OAAO,KAAK,OAAO,QAAQ,WAAW,IAAI,GAAG;AACrD,UAAI,CAAC,QAAQ,OAA0B,EAAE,YAAY;AACnD,0BAAkB,OAAO,OAAO;AAEhC;AAAA,MACF;AAAA,IACF;AAEA,aAAS,CAAC,SAAS,KAAK,KAAK,OAAO,QAAQ,WAAW,IAAI,GAAG;AAC5D,UAAI,QAAQ,OAA0B,EAAE,cAAc,YAAY,iBAAiB;AACjF,sBAAc;AAAA,UACZ;AAAA,YAAC;AAAA;AAAA,cAEC,QAAQ;AAAA,cACR,OAAO,YAAY;AAAA,cACnB,YAAY,QAAQ,OAA0B,EAAE;AAAA,cAChD,WAAW,cAAc,WAAW,IAAI,IAAI;AAAA,cAC5C;AAAA,cACA;AAAA,cACA,OAAO,QAAQ,OAA0B,EAAE;AAAA,cAC3C,UAAU;AAAA,cACV,YAAY;AAAA;AAAA,YATP;AAAA,UAUP;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAEA,WACE,oBAAC,OAAK,GAAI,UAAuB,eAAc,UAC5C,yBACH;AAAA,EAEJ;AAEA,SAAO,OAAO,OAAO,MAAM,EAAC,QAAQ,WAAU,CAAC;AACjD;",
   "names": []
 }

package/build/ui/form.d.ts

@@ -1,13 +1,13 @@
 export * from './form/createForm.js';
-export * from './form/Form.js';
-export * from './form/FormConfig.js';
-export * from './form/FormProps.js';
-export * from './form/FormResult.js';
+export type * from './form/Form.js';
+export type * from './form/FormConfig.js';
+export type * from './form/FormProps.js';
+export type * from './form/FormResult.js';
 export * from './form/FormRow.js';
-export * from './form/FormRowConfig.js';
-export * from './form/FormRowsConfig.js';
-export * from './form/FormValue.js';
-export * from './form/FormValues.js';
+export type * from './form/FormRowConfig.js';
+export type * from './form/FormRowsConfig.js';
+export type * from './form/FormValue.js';
+export type * from './form/FormValues.js';
 export * from './form/SelectInput.js';
-export * from './form/SelectInputItem.js';
+export type * from './form/SelectInputItem.js';
 export * from './form/TextInput.js';

package/build/ui/form.js

@@ -1,15 +1,6 @@
 "use strict";
 export * from "./form/createForm.js";
-export * from "./form/Form.js";
-export * from "./form/FormConfig.js";
-export * from "./form/FormProps.js";
-export * from "./form/FormResult.js";
 export * from "./form/FormRow.js";
-export * from "./form/FormRowConfig.js";
-export * from "./form/FormRowsConfig.js";
-export * from "./form/FormValue.js";
-export * from "./form/FormValues.js";
 export * from "./form/SelectInput.js";
-export * from "./form/SelectInputItem.js";
 export * from "./form/TextInput.js";
 //# sourceMappingURL=form.js.map

package/build/ui/form.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../source/ui/form.ts"],
-  "sourcesContent": ["export * from './form/createForm.js';\nexport * from './form/Form.js';\nexport * from './form/FormConfig.js';\nexport * from './form/FormProps.js';\nexport * from './form/FormResult.js';\nexport * from './form/FormRow.js';\nexport * from './form/FormRowConfig.js';\nexport * from './form/FormRowsConfig.js';\nexport * from './form/FormValue.js';\nexport * from './form/FormValues.js';\nexport * from './form/SelectInput.js';\nexport * from './form/SelectInputItem.js';\nexport * from './form/TextInput.js';\n"],
-  "mappings": ";AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "sourcesContent": ["export * from './form/createForm.js';\nexport type * from './form/Form.js';\nexport type * from './form/FormConfig.js';\nexport type * from './form/FormProps.js';\nexport type * from './form/FormResult.js';\nexport * from './form/FormRow.js';\nexport type * from './form/FormRowConfig.js';\nexport type * from './form/FormRowsConfig.js';\nexport type * from './form/FormValue.js';\nexport type * from './form/FormValues.js';\nexport * from './form/SelectInput.js';\nexport type * from './form/SelectInputItem.js';\nexport * from './form/TextInput.js';\n"],
+  "mappings": ";AAAA,cAAc;AAKd,cAAc;AAKd,cAAc;AAEd,cAAc;",
   "names": []
 }

package/build/ui/internals/Wrapper.js

@@ -18,14 +18,14 @@ export const Wrapper = ({ program, children }) => {
       /* @__PURE__ */ jsxs(
         Box,
         {
-          flexDirection: "column",
           borderColor: notice,
           borderStyle: "round",
+          flexDirection: "column",
           margin: 1,
-          paddingTop: 1,
-          paddingRight: 4,
           paddingBottom: 1,
           paddingLeft: 4,
+          paddingRight: 4,
+          paddingTop: 1,
           children: [
             /* @__PURE__ */ jsxs(Text, { children: [
               "New version ",

package/build/ui/internals/Wrapper.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../source/ui/internals/Wrapper.tsx"],
-  "sourcesContent": ["import {Box, Spacer, Text} from 'ink';\nimport {type FC, type PropsWithChildren, useMemo} from 'react';\nimport {ErrorBoundary} from 'react-error-boundary';\n\nimport {type Program} from '../../program.js';\nimport {highlighted, notice} from '../colors.js';\nimport {Failure} from '../Failure.js';\nimport {programContext} from './programContext.js';\n\n/**\n * {@link Wrapper} component props.\n */\nexport type WrapperProps = {\n  program: Program;\n};\n\n/**\n * A component that wraps anything {@link Program} tries to render with an error boundary and all neccessary providers.\n */\nexport const Wrapper: FC<PropsWithChildren<WrapperProps>> = ({program, children}) => {\n  let programContextValue = useMemo(\n    () => ({\n      program,\n    }),\n    [program],\n  );\n\n  return (\n    <ErrorBoundary FallbackComponent={Failure}>\n      <programContext.Provider value={programContextValue}>\n        {program.latestVersion && program.latestVersion !== program.version ?\n          <Box>\n            <Box\n              flexDirection=\"column\"\n              borderColor={notice}\n              borderStyle=\"round\"\n              margin={1}\n              paddingTop={1}\n              paddingRight={4}\n              paddingBottom={1}\n              paddingLeft={4}\n            >\n              <Text>\n                New version <Text color={highlighted}>{program.latestVersion}</Text> is available!\n              </Text>\n              <Text>\n                Run <Text color={highlighted}>{`npm install ${program.name} -D`}</Text> to update.\n              </Text>\n            </Box>\n            <Spacer />\n          </Box>\n        : null}\n        <Box>{children}</Box>\n      </programContext.Provider>\n    </ErrorBoundary>\n  );\n};\n"],
-  "mappings": ";AA0Cc,SACc,KADd;AA1Cd,SAAQ,KAAK,QAAQ,YAAW;AAChC,SAAyC,eAAc;AACvD,SAAQ,qBAAoB;AAG5B,SAAQ,aAAa,cAAa;AAClC,SAAQ,eAAc;AACtB,SAAQ,sBAAqB;AAYtB,aAAM,UAA+C,CAAC,EAAC,SAAS,SAAQ,MAAM;AACnF,MAAI,sBAAsB;AAAA,IACxB,OAAO;AAAA,MACL;AAAA,IACF;AAAA,IACA,CAAC,OAAO;AAAA,EACV;AAEA,SACE,oBAAC,iBAAc,mBAAmB,SAChC,+BAAC,eAAe,UAAf,EAAwB,OAAO,qBAC7B;AAAA,YAAQ,iBAAiB,QAAQ,kBAAkB,QAAQ,UAC1D,qBAAC,OACC;AAAA;AAAA,QAAC;AAAA;AAAA,UACC,eAAc;AAAA,UACd,aAAa;AAAA,UACb,aAAY;AAAA,UACZ,QAAQ;AAAA,UACR,YAAY;AAAA,UACZ,cAAc;AAAA,UACd,eAAe;AAAA,UACf,aAAa;AAAA,UAEb;AAAA,iCAAC,QAAK;AAAA;AAAA,cACQ,oBAAC,QAAK,OAAO,aAAc,kBAAQ,eAAc;AAAA,cAAO;AAAA,eACtE;AAAA,YACA,qBAAC,QAAK;AAAA;AAAA,cACA,oBAAC,QAAK,OAAO,aAAc,yBAAe,QAAQ,IAAI,OAAM;AAAA,cAAO;AAAA,eACzE;AAAA;AAAA;AAAA,MACF;AAAA,MACA,oBAAC,UAAO;AAAA,OACV,IACA;AAAA,IACF,oBAAC,OAAK,UAAS;AAAA,KACjB,GACF;AAEJ;",
+  "sourcesContent": ["import {Box, Spacer, Text} from 'ink';\nimport {type FC, type PropsWithChildren, useMemo} from 'react';\nimport {ErrorBoundary} from 'react-error-boundary';\n\nimport {type Program} from '../../program.js';\nimport {highlighted, notice} from '../colors.js';\nimport {Failure} from '../Failure.js';\nimport {programContext} from './programContext.js';\n\n/**\n * {@link Wrapper} component props.\n */\nexport type WrapperProps = {\n  program: Program;\n};\n\n/**\n * A component that wraps anything {@link Program} tries to render with an error boundary and all neccessary providers.\n */\nexport const Wrapper: FC<PropsWithChildren<WrapperProps>> = ({program, children}) => {\n  let programContextValue = useMemo(\n    () => ({\n      program,\n    }),\n    [program],\n  );\n\n  return (\n    <ErrorBoundary FallbackComponent={Failure}>\n      <programContext.Provider value={programContextValue}>\n        {program.latestVersion && program.latestVersion !== program.version ?\n          <Box>\n            <Box\n              borderColor={notice}\n              borderStyle=\"round\"\n              flexDirection=\"column\"\n              margin={1}\n              paddingBottom={1}\n              paddingLeft={4}\n              paddingRight={4}\n              paddingTop={1}\n            >\n              <Text>\n                New version <Text color={highlighted}>{program.latestVersion}</Text> is available!\n              </Text>\n              <Text>\n                Run <Text color={highlighted}>{`npm install ${program.name} -D`}</Text> to update.\n              </Text>\n            </Box>\n            <Spacer />\n          </Box>\n        : null}\n        <Box>{children}</Box>\n      </programContext.Provider>\n    </ErrorBoundary>\n  );\n};\n"],
+  "mappings": ";AA0Cc,SACc,KADd;AA1Cd,SAAQ,KAAK,QAAQ,YAAW;AAChC,SAAyC,eAAc;AACvD,SAAQ,qBAAoB;AAG5B,SAAQ,aAAa,cAAa;AAClC,SAAQ,eAAc;AACtB,SAAQ,sBAAqB;AAYtB,aAAM,UAA+C,CAAC,EAAC,SAAS,SAAQ,MAAM;AACnF,MAAI,sBAAsB;AAAA,IACxB,OAAO;AAAA,MACL;AAAA,IACF;AAAA,IACA,CAAC,OAAO;AAAA,EACV;AAEA,SACE,oBAAC,iBAAc,mBAAmB,SAChC,+BAAC,eAAe,UAAf,EAAwB,OAAO,qBAC7B;AAAA,YAAQ,iBAAiB,QAAQ,kBAAkB,QAAQ,UAC1D,qBAAC,OACC;AAAA;AAAA,QAAC;AAAA;AAAA,UACC,aAAa;AAAA,UACb,aAAY;AAAA,UACZ,eAAc;AAAA,UACd,QAAQ;AAAA,UACR,eAAe;AAAA,UACf,aAAa;AAAA,UACb,cAAc;AAAA,UACd,YAAY;AAAA,UAEZ;AAAA,iCAAC,QAAK;AAAA;AAAA,cACQ,oBAAC,QAAK,OAAO,aAAc,kBAAQ,eAAc;AAAA,cAAO;AAAA,eACtE;AAAA,YACA,qBAAC,QAAK;AAAA;AAAA,cACA,oBAAC,QAAK,OAAO,aAAc,yBAAe,QAAQ,IAAI,OAAM;AAAA,cAAO;AAAA,eACzE;AAAA;AAAA;AAAA,MACF;AAAA,MACA,oBAAC,UAAO;AAAA,OACV,IACA;AAAA,IACF,oBAAC,OAAK,UAAS;AAAA,KACjB,GACF;AAEJ;",
   "names": []
 }

package/build/ui/useProgram.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../source/ui/useProgram.ts"],
-  "sourcesContent": ["import {useApp} from 'ink';\nimport {useCallback, useContext} from 'react';\nimport {useErrorBoundary} from 'react-error-boundary';\n\nimport {programContext} from './internals.js';\n\n/**\n * A React hook for accessing {@link Program} instance and `exit` function that is used for showing an error (via an error boundary) and exiting.\n */\nexport function useProgram() {\n  let {showBoundary} = useErrorBoundary();\n  let {exit: appExit} = useApp();\n  let {program} = useContext(programContext);\n\n  let exit = useCallback(\n    (error: unknown) => {\n      process.exitCode = 1;\n\n      showBoundary(error);\n      appExit(error as Error);\n    },\n    [appExit, showBoundary],\n  );\n\n  return {program, exit};\n}\n"],
-  "mappings": ";AAAA,SAAQ,cAAa;AACrB,SAAQ,aAAa,kBAAiB;AACtC,SAAQ,wBAAuB;AAE/B,SAAQ,sBAAqB;AAKtB,gBAAS,aAAa;AAC3B,MAAI,EAAC,aAAY,IAAI,iBAAiB;AACtC,MAAI,EAAC,MAAM,QAAO,IAAI,OAAO;AAC7B,MAAI,EAAC,QAAO,IAAI,WAAW,cAAc;AAEzC,MAAI,OAAO;AAAA,IACT,CAAC,UAAmB;AAClB,cAAQ,WAAW;AAEnB,mBAAa,KAAK;AAClB,cAAQ,KAAc;AAAA,IACxB;AAAA,IACA,CAAC,SAAS,YAAY;AAAA,EACxB;AAEA,SAAO,EAAC,SAAS,KAAI;AACvB;",
+  "sourcesContent": ["import {useApp} from 'ink';\nimport {useCallback, useContext} from 'react';\nimport {useErrorBoundary} from 'react-error-boundary';\n\nimport {programContext} from './internals.js';\n\n/**\n * A React hook for accessing {@link Program} instance and `exit` function that is used for showing an error (via an error boundary) and exiting.\n */\nexport function useProgram() {\n  let {showBoundary} = useErrorBoundary();\n  let {exit: appExit} = useApp();\n  let {program} = useContext(programContext);\n\n  let exit = useCallback(\n    (error: unknown) => {\n      // TODO: remove when this is fixed: https://github.com/facebook/react/issues/31544\n      // eslint-disable-next-line react-compiler/react-compiler -- false positive\n      process.exitCode = 1;\n\n      showBoundary(error);\n      appExit(error as Error);\n    },\n    [appExit, showBoundary],\n  );\n\n  return {program, exit};\n}\n"],
+  "mappings": ";AAAA,SAAQ,cAAa;AACrB,SAAQ,aAAa,kBAAiB;AACtC,SAAQ,wBAAuB;AAE/B,SAAQ,sBAAqB;AAKtB,gBAAS,aAAa;AAC3B,MAAI,EAAC,aAAY,IAAI,iBAAiB;AACtC,MAAI,EAAC,MAAM,QAAO,IAAI,OAAO;AAC7B,MAAI,EAAC,QAAO,IAAI,WAAW,cAAc;AAEzC,MAAI,OAAO;AAAA,IACT,CAAC,UAAmB;AAGlB,cAAQ,WAAW;AAEnB,mBAAa,KAAK;AAClB,cAAQ,KAAc;AAAA,IACxB;AAAA,IACA,CAAC,SAAS,YAAY;AAAA,EACxB;AAEA,SAAO,EAAC,SAAS,KAAI;AACvB;",
   "names": []
 }

package/build/ui.d.ts

@@ -1,5 +1,5 @@
 export * as colors from './ui/colors.js';
-export * from './ui/ErrorDetail.js';
+export type * from './ui/ErrorDetail.js';
 export * from './ui/Failure.js';
 export * from './ui/form.js';
 export * from './ui/getErrorDetail.js';

package/build/ui.js

@@ -1,6 +1,5 @@
 "use strict";
 export * as colors from "./ui/colors.js";
-export * from "./ui/ErrorDetail.js";
 export * from "./ui/Failure.js";
 export * from "./ui/form.js";
 export * from "./ui/getErrorDetail.js";

package/build/ui.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../source/ui.ts"],
-  "sourcesContent": ["export * as colors from './ui/colors.js';\nexport * from './ui/ErrorDetail.js';\nexport * from './ui/Failure.js';\nexport * from './ui/form.js';\nexport * from './ui/getErrorDetail.js';\nexport * from './ui/Header.js';\nexport * from './ui/Help.js';\nexport * as icons from './ui/icons.js';\nexport * from './ui/Spinner.js';\nexport * from './ui/useProgram.js';\n"],
-  "mappings": ";AAAA,YAAY,YAAY;AACxB,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,YAAY,WAAW;AACvB,cAAc;AACd,cAAc;",
+  "sourcesContent": ["export * as colors from './ui/colors.js';\nexport type * from './ui/ErrorDetail.js';\nexport * from './ui/Failure.js';\nexport * from './ui/form.js';\nexport * from './ui/getErrorDetail.js';\nexport * from './ui/Header.js';\nexport * from './ui/Help.js';\nexport * as icons from './ui/icons.js';\nexport * from './ui/Spinner.js';\nexport * from './ui/useProgram.js';\n"],
+  "mappings": ";AAAA,YAAY,YAAY;AAExB,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,YAAY,WAAW;AACvB,cAAc;AACd,cAAc;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jakubmazanec/cli",
-  "version": "0.4.0-unstable.d6c542d",
+  "version": "0.4.0",
   "description": "TypeScript-first library for building CLIs.",
   "repository": {
     "type": "git",
@@ -17,9 +17,9 @@
     "source"
   ],
   "scripts": {
-    "build": "del-cli build tsconfig.tsbuildinfo && esbuild \"source/**/*\" --platform=node --target=node20.8 --outdir=build --sourcemap && tsc",
+    "build": "del-cli build tsconfig.tsbuildinfo && esbuild \"source/**/*\" --platform=node --target=node22.13 --outdir=build --sourcemap && tsc",
     "clean": "del-cli coverage build *.tsbuildinfo",
-    "develop": "concurrently \"esbuild \"source/**/*\" --platform=node --target=node20.8 --outdir=build --sourcemap --watch\" \"tsc --watch\"",
+    "develop": "concurrently \"esbuild \"source/**/*\" --platform=node --target=node22.13 --outdir=build --sourcemap --watch\" \"tsc --watch\"",
     "document": "del-cli docs && typedoc --options typedoc.config.cjs",
     "format": "prettier . --write --ignore-unknown",
     "lint": "eslint .",
@@ -27,46 +27,45 @@
     "typecheck": "tsc --project tsconfig.typecheck.json"
   },
   "dependencies": {
-    "@jakubmazanec/args": "2.1.0-unstable.d6c542d",
-    "@jakubmazanec/error": "3.1.0-unstable.d6c542d",
-    "@jakubmazanec/ts-utils": "3.1.0-unstable.d6c542d",
-    "@jakubmazanec/zod-utils": "2.1.0-unstable.d6c542d",
-    "chalk": "^5.3.0",
+    "@jakubmazanec/args": "^2.0.0",
+    "@jakubmazanec/error": "^3.0.0",
+    "@jakubmazanec/ts-utils": "^3.0.0",
+    "@jakubmazanec/zod-utils": "^2.0.0",
+    "chalk": "^5.4.1",
     "fs-extra": "^11.2.0",
     "latest-version": "^9.0.0",
     "lodash": "^4.17.21",
-    "react-error-boundary": "^4.1.2",
-    "zod": "^3.23.8"
+    "react-error-boundary": "^5.0.0",
+    "zod": "^3.24.1"
   },
   "devDependencies": {
-    "@jakubmazanec/eslint-config": "4.0.0-unstable.d6c542d",
+    "@jakubmazanec/eslint-config": "^4.1.0",
     "@types/fs-extra": "^11.0.4",
-    "@types/lodash": "^4.17.13",
-    "@types/node": "^22.9.0",
-    "@types/react": "^18.2.63",
-    "@vitest/coverage-v8": "^2.1.4",
-    "concurrently": "^9.1.0",
+    "@types/lodash": "^4.17.14",
+    "@types/node": "^22.10.5",
+    "@types/react": "^19.0.5",
+    "@vitest/coverage-v8": "^2.1.8",
+    "concurrently": "^9.1.2",
     "cross-env": "^7.0.3",
     "del-cli": "^6.0.0",
-    "esbuild": "^0.24.0",
-    "eslint": "^9.14.0",
-    "ink": "^5.0.1",
+    "esbuild": "^0.24.2",
+    "eslint": "^9.18.0",
+    "ink": "^5.1.0",
     "ink-testing-library": "^4.0.0",
-    "lodash": "^4.17.21",
-    "prettier": "^3.3.3",
-    "prettier-plugin-packagejson": "^2.5.3",
-    "react": "^18.2.0",
-    "typedoc": "^0.26.11",
-    "typedoc-plugin-markdown": "^4.2.10",
-    "typescript": "^5.6.3",
-    "vitest": "^2.1.4"
+    "prettier": "^3.4.2",
+    "prettier-plugin-packagejson": "^2.5.6",
+    "react": "^19.0.0",
+    "typedoc": "^0.27.6",
+    "typedoc-plugin-markdown": "^4.4.1",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.8"
   },
   "peerDependencies": {
     "ink": "5.x",
-    "react": "18.x"
+    "react": "19.x"
   },
   "packageManager": "npm@10.9.0",
   "engines": {
-    "node": "^22.11.0"
+    "node": "^22.13.0"
   }
 }

package/source/program/Program.ts

@@ -2,7 +2,7 @@
 import {type Argv, type OptionsConfig, type ParametersConfig} from '@jakubmazanec/args';
 import fs from 'fs-extra';
 import fetchLatestVersion from 'latest-version';
-import path from 'path';
+import path from 'node:path';
 import {type ComponentType} from 'react';
 import {type FallbackProps} from 'react-error-boundary';
 

package/source/program.ts

@@ -1,11 +1,11 @@
 export * from './program/Command.js';
-export * from './program/CommandAction.js';
-export * from './program/CommandArguments.js';
-export * from './program/CommandOptions.js';
+export type * from './program/CommandAction.js';
+export type * from './program/CommandArguments.js';
+export type * from './program/CommandOptions.js';
 export * from './program/getProgramDetail.js';
 export * from './program/Program.js';
-export * from './program/ProgramCreateOptions.js';
-export * from './program/ProgramDetail.js';
+export type * from './program/ProgramCreateOptions.js';
+export type * from './program/ProgramDetail.js';
 export * from './program/ProgramError.js';
-export * from './program/ProgramOptions.js';
-export * from './program/ProgramStreams.js';
+export type * from './program/ProgramOptions.js';
+export type * from './program/ProgramStreams.js';

package/source/ui/Failure.tsx

@@ -36,19 +36,19 @@ export function Failure({error, errorDetail, ...boxProps}: FailureProps) {
       : null}
 
       {stack ?
-        <Box flexDirection="column" marginTop={1} marginLeft={2}>
+        <Box flexDirection="column" marginLeft={2} marginTop={1}>
           <Text color={colors.muted}>{stack}</Text>
         </Box>
       : null}
 
       {cause ?
         <>
-          <Box flexDirection="column" marginTop={1} marginLeft={2}>
+          <Box flexDirection="column" marginLeft={2} marginTop={1}>
             <Text color={colors.muted}>{cause.description}</Text>
           </Box>
 
           {cause.stack ?
-            <Box flexDirection="column" marginTop={1} marginLeft={2}>
+            <Box flexDirection="column" marginLeft={2} marginTop={1}>
               <Text color={colors.muted}>{cause.stack}</Text>
             </Box>
           : null}

package/source/ui/Help.tsx

@@ -56,7 +56,7 @@ export function Help({program, ...boxProps}: HelpProps) {
             }
 
             return (
-              <Box key={command.name} marginLeft={2} flexDirection="column">
+              <Box key={command.name} flexDirection="column" marginLeft={2}>
                 <Text>{line}</Text>
               </Box>
             );

package/source/ui/form/FormRow.tsx

@@ -74,26 +74,13 @@ export function FormRow<C extends FormConfig>({
   );
 
   switch (config.type) {
-    case 'text': {
-      return (
-        <TextInput
-          key={String(rowName)}
-          label={config.label ?? ''}
-          validate={config.validate}
-          value={value as string}
-          focus={focus}
-          isComplete={isComplete}
-          onChange={handleChange}
-          onSubmit={handleFinish}
-          {...boxProps}
-        />
-      );
+    case 'confirm': {
+      return null;
     }
     case 'select': {
       return (
         <SelectInput
           key={String(rowName)}
-          label={config.label ?? ''}
           items={
             rows ?
               (
@@ -107,13 +94,26 @@ export function FormRow<C extends FormConfig>({
           }
           focus={focus}
           isComplete={isComplete}
+          label={config.label ?? ''}
           onSelect={handleSelectFinish}
           {...boxProps}
         />
       );
     }
-    case 'confirm': {
-      return null;
+    case 'text': {
+      return (
+        <TextInput
+          key={String(rowName)}
+          focus={focus}
+          isComplete={isComplete}
+          label={config.label ?? ''}
+          validate={config.validate}
+          value={value as string}
+          onChange={handleChange}
+          onSubmit={handleFinish}
+          {...boxProps}
+        />
+      );
     }
     default: {
       config satisfies never;

package/source/ui/form/SelectInput.tsx

@@ -1,6 +1,6 @@
 import {Box, type BoxProps, type Key, Text, useInput} from 'ink';
 import _ from 'lodash';
-import {useEffect, useRef, useState} from 'react';
+import React, {useEffect, useRef, useState} from 'react';
 
 import * as colors from '../colors.js';
 import * as icons from '../icons.js';
@@ -49,7 +49,7 @@ export function SelectInput({
   onHighlight,
   isComplete,
   ...boxProps
-}: SelectInputProps): JSX.Element {
+}: SelectInputProps): React.JSX.Element {
   let [rotatedIndex, setRotatedIndex] = useState(0);
   let [selectedIndex, setSelectedIndex] = useState(initialIndex);
   let hasLimit = typeof userDefinedLimit === 'number' && items.length > userDefinedLimit;

package/source/ui/form/createForm.tsx

@@ -64,12 +64,12 @@ export function createForm<C extends FormConfig>(formConfig: C): Form<C> {
         inputElements.push(
           <FormRow
             key={rowName}
-            marginTop={inputElements.length === 0 ? 0 : 1}
+            config={input}
             focus={rowName === activeInputName}
             isComplete={results[rowName as keyof C['rows']].isComplete}
-            config={input}
-            rows={rows}
+            marginTop={inputElements.length === 0 ? 0 : 1}
             rowName={rowName}
+            rows={rows}
             value={results[rowName as keyof C['rows']].value}
             onChange={handleChange}
             onComplete={handleFinish}

package/source/ui/form.ts

@@ -1,13 +1,13 @@
 export * from './form/createForm.js';
-export * from './form/Form.js';
-export * from './form/FormConfig.js';
-export * from './form/FormProps.js';
-export * from './form/FormResult.js';
+export type * from './form/Form.js';
+export type * from './form/FormConfig.js';
+export type * from './form/FormProps.js';
+export type * from './form/FormResult.js';
 export * from './form/FormRow.js';
-export * from './form/FormRowConfig.js';
-export * from './form/FormRowsConfig.js';
-export * from './form/FormValue.js';
-export * from './form/FormValues.js';
+export type * from './form/FormRowConfig.js';
+export type * from './form/FormRowsConfig.js';
+export type * from './form/FormValue.js';
+export type * from './form/FormValues.js';
 export * from './form/SelectInput.js';
-export * from './form/SelectInputItem.js';
+export type * from './form/SelectInputItem.js';
 export * from './form/TextInput.js';

package/source/ui/internals/Wrapper.tsx

@@ -31,14 +31,14 @@ export const Wrapper: FC<PropsWithChildren<WrapperProps>> = ({program, children}
         {program.latestVersion && program.latestVersion !== program.version ?
           <Box>
             <Box
-              flexDirection="column"
               borderColor={notice}
               borderStyle="round"
+              flexDirection="column"
               margin={1}
-              paddingTop={1}
-              paddingRight={4}
               paddingBottom={1}
               paddingLeft={4}
+              paddingRight={4}
+              paddingTop={1}
             >
               <Text>
                 New version <Text color={highlighted}>{program.latestVersion}</Text> is available!

package/source/ui/useProgram.ts

@@ -14,6 +14,8 @@ export function useProgram() {
 
   let exit = useCallback(
     (error: unknown) => {
+      // TODO: remove when this is fixed: https://github.com/facebook/react/issues/31544
+      // eslint-disable-next-line react-compiler/react-compiler -- false positive
       process.exitCode = 1;
 
       showBoundary(error);

package/source/ui.ts

@@ -1,5 +1,5 @@
 export * as colors from './ui/colors.js';
-export * from './ui/ErrorDetail.js';
+export type * from './ui/ErrorDetail.js';
 export * from './ui/Failure.js';
 export * from './ui/form.js';
 export * from './ui/getErrorDetail.js';