@jakubmazanec/cli 0.1.0-c5ebb6f → 0.1.0-dee6883

package/dist/ui/form/TextInput.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/ui/form/TextInput.tsx"],"sourcesContent":["// TODO: resolve\n/* eslint-disable complexity -- TODO */\nimport chalk from 'chalk';\nimport {Box, type BoxProps, Text, useInput} from 'ink';\nimport {useEffect, useState} from 'react';\n\nimport * as colors from '../colors.js';\nimport * as icons from '../icons.js';\n\n/**\n * Text input component props.\n */\nexport type TextInputProps = BoxProps & {\n  /** Text to display as a label. */\n  label: string;\n\n  /** Text to display when `value` is empty. */\n  placeholder?: string | undefined;\n\n  /** Value. */\n  value: string;\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 | undefined;\n\n  /** Replace all chars and mask the value. Useful for password inputs. */\n  mask?: string | undefined;\n\n  /** Show cursor and allow navigation using arrow keys. */\n  showCursor?: boolean | undefined;\n\n  /** Validation function that is called when value changes. If this function throws an error*/\n  validate?: ((value: string) => void) | undefined;\n\n  /** Handler function that is called when value changes. */\n  onChange: (value: string) => void;\n\n  /** Handler function that is called when enter is pressed. */\n  onSubmit?: ((value: string) => 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 * Text input component.\n */\nexport function TextInput({\n  label,\n  validate,\n  isComplete,\n  value: originalValue,\n  placeholder = '',\n  focus = true,\n  mask,\n  showCursor = true,\n  onChange,\n  onSubmit,\n  ...boxProps\n}: TextInputProps) {\n  let [validationError, setValidationError] = useState('');\n  let [state, setState] = useState({\n    cursorOffset: (originalValue || '').length,\n    cursorWidth: 0,\n  });\n\n  useEffect(() => {\n    setState((previousState) => {\n      if (!focus || !showCursor) {\n        return previousState;\n      }\n\n      let newValue = originalValue || '';\n\n      if (previousState.cursorOffset > newValue.length - 1) {\n        return {\n          cursorOffset: newValue.length,\n          cursorWidth: 0,\n        };\n      }\n\n      return previousState;\n    });\n  }, [originalValue, focus, showCursor]);\n\n  let value = mask ? mask.repeat(originalValue.length) : originalValue;\n  let renderedValue = value;\n  let renderedPlaceholder = placeholder ? chalk[colors.muted](placeholder) : undefined;\n\n  // fake mouse cursor; dealing with with actual cursor and ANSI escape codes is inconvinient\n  if (showCursor && focus) {\n    renderedPlaceholder =\n      placeholder.length > 0\n        ? chalk.inverse(placeholder[0]) + chalk[colors.muted](placeholder.slice(1))\n        : chalk.inverse(' ');\n\n    renderedValue = value.length > 0 ? '' : chalk.inverse(' ');\n\n    let i = 0;\n\n    for (let char of value) {\n      if (i >= state.cursorOffset && i <= state.cursorOffset) {\n        renderedValue += chalk.inverse(char);\n      } else {\n        renderedValue += char;\n      }\n\n      i += 1;\n    }\n\n    if (value.length > 0 && state.cursorOffset === value.length) {\n      renderedValue += chalk.inverse(' ');\n    }\n  }\n\n  useInput(\n    (input, key) => {\n      if (\n        key.upArrow ||\n        key.downArrow ||\n        (key.ctrl && input === 'c') ||\n        (key.shift && key.tab) ||\n        key.tab\n      ) {\n        return;\n      }\n\n      if (key.return) {\n        if (onSubmit) {\n          if (validate) {\n            try {\n              validate(originalValue);\n            } catch (error: unknown) {\n              setValidationError((error as Error).message);\n\n              return;\n            }\n          }\n\n          if (validationError) {\n            setValidationError('');\n          } else {\n            onSubmit(originalValue);\n          }\n        }\n\n        return;\n      }\n\n      let nextCursorOffset = state.cursorOffset;\n      let nextValue = originalValue;\n      let nextCursorWidth = 0;\n\n      if (key.leftArrow) {\n        if (showCursor) {\n          nextCursorOffset -= 1;\n        }\n      } else if (key.rightArrow) {\n        if (showCursor) {\n          nextCursorOffset += 1;\n        }\n      } else if (key.backspace || key.delete) {\n        if (state.cursorOffset > 0) {\n          nextValue =\n            originalValue.slice(0, state.cursorOffset - 1) +\n            originalValue.slice(state.cursorOffset, originalValue.length);\n\n          nextCursorOffset -= 1;\n        }\n      } else {\n        nextValue =\n          originalValue.slice(0, state.cursorOffset) +\n          input +\n          originalValue.slice(state.cursorOffset, originalValue.length);\n\n        nextCursorOffset += input.length;\n\n        if (input.length > 1) {\n          nextCursorWidth = input.length;\n        }\n      }\n\n      if (state.cursorOffset < 0) {\n        nextCursorOffset = 0;\n      }\n\n      if (state.cursorOffset > originalValue.length) {\n        nextCursorOffset = originalValue.length;\n      }\n\n      setState({\n        cursorOffset: nextCursorOffset,\n        cursorWidth: nextCursorWidth,\n      });\n\n      if (nextValue !== originalValue) {\n        onChange(nextValue);\n      }\n    },\n    {isActive: focus},\n  );\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}>{value}</Text>\n        ) : (\n          <Text color={colors.highlighted}>\n            {placeholder ? (value.length > 0 ? renderedValue : renderedPlaceholder) : renderedValue}\n          </Text>\n        )}\n        {validationError ? (\n          <Box marginTop={0}>\n            <Text color={colors.warning}>{validationError}</Text>\n          </Box>\n        ) : null}\n      </Box>\n    </Box>\n  );\n}\n"],"names":["chalk","Box","Text","useInput","useEffect","useState","colors","icons","TextInput","label","validate","isComplete","value","originalValue","placeholder","focus","mask","showCursor","onChange","onSubmit","boxProps","validationError","setValidationError","state","setState","cursorOffset","length","cursorWidth","previousState","newValue","repeat","renderedValue","renderedPlaceholder","muted","undefined","inverse","slice","i","char","input","key","upArrow","downArrow","ctrl","shift","tab","return","error","message","nextCursorOffset","nextValue","nextCursorWidth","leftArrow","rightArrow","backspace","delete","isActive","marginRight","success","question","flexDirection","color","highlighted","body","marginTop","warning"],"mappings":"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"}
+{"version":3,"sources":["../../../src/ui/form/TextInput.tsx"],"sourcesContent":["// TODO: resolve\n/* eslint-disable complexity -- TODO */\nimport chalk from 'chalk';\nimport {Box, type BoxProps, Text, useInput} from 'ink';\nimport {useEffect, useState} from 'react';\n\nimport * as colors from '../colors.js';\nimport * as icons from '../icons.js';\n\n/**\n * Text input component props.\n */\nexport type TextInputProps = BoxProps & {\n  /** Text to display as a label. */\n  label: string;\n\n  /** Text to display when `value` is empty. */\n  placeholder?: string | undefined;\n\n  /** Value. */\n  value: string;\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 handled only by a specific component. */\n  focus?: boolean | undefined;\n\n  /** Replace all chars and mask the value. Useful for password inputs. */\n  mask?: string | undefined;\n\n  /** Show cursor and allow navigation using arrow keys. */\n  showCursor?: boolean | undefined;\n\n  /** Validation function that is called when value changes. If this function throws an error*/\n  validate?: ((value: string) => void) | undefined;\n\n  /** Handler function that is called when value changes. */\n  onChange: (value: string) => void;\n\n  /** Handler function that is called when enter is pressed. */\n  onSubmit?: ((value: string) => 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 * Text input component.\n */\nexport function TextInput({\n  label,\n  validate,\n  isComplete,\n  value: originalValue,\n  placeholder = '',\n  focus = true,\n  mask,\n  showCursor = true,\n  onChange,\n  onSubmit,\n  ...boxProps\n}: TextInputProps) {\n  let [validationError, setValidationError] = useState('');\n  let [state, setState] = useState({\n    cursorOffset: (originalValue || '').length,\n    cursorWidth: 0,\n  });\n\n  useEffect(() => {\n    setState((previousState) => {\n      if (!focus || !showCursor) {\n        return previousState;\n      }\n\n      let newValue = originalValue || '';\n\n      if (previousState.cursorOffset > newValue.length - 1) {\n        return {\n          cursorOffset: newValue.length,\n          cursorWidth: 0,\n        };\n      }\n\n      return previousState;\n    });\n  }, [originalValue, focus, showCursor]);\n\n  let value = mask ? mask.repeat(originalValue.length) : originalValue;\n  let renderedValue = value;\n  let renderedPlaceholder = placeholder ? chalk[colors.muted](placeholder) : undefined;\n\n  if (showCursor && focus) {\n    renderedPlaceholder =\n      placeholder.length > 0\n        ? chalk.inverse(placeholder[0]) + chalk[colors.muted](placeholder.slice(1))\n        : chalk.inverse(' ');\n\n    renderedValue = value.length > 0 ? '' : chalk.inverse(' ');\n\n    for (let [i, character] of Object.entries(value)) {\n      if (Number(i) >= state.cursorOffset && Number(i) <= state.cursorOffset) {\n        renderedValue += chalk.inverse(character);\n      } else {\n        renderedValue += character;\n      }\n    }\n\n    if (value.length > 0 && state.cursorOffset === value.length) {\n      renderedValue += chalk.inverse(' ');\n    }\n  }\n\n  useInput(\n    (input, key) => {\n      if (\n        key.upArrow ||\n        key.downArrow ||\n        (key.ctrl && input === 'c') ||\n        (key.shift && key.tab) ||\n        key.tab\n      ) {\n        return;\n      }\n\n      if (key.return) {\n        if (onSubmit) {\n          if (validate) {\n            try {\n              validate(originalValue);\n            } catch (error: unknown) {\n              setValidationError((error as Error).message);\n\n              return;\n            }\n          }\n\n          if (validationError) {\n            setValidationError('');\n          } else {\n            onSubmit(originalValue);\n          }\n        }\n\n        return;\n      }\n\n      let nextCursorOffset = state.cursorOffset;\n      let nextValue = originalValue;\n      let nextCursorWidth = 0;\n\n      if (key.leftArrow) {\n        if (showCursor) {\n          nextCursorOffset -= 1;\n        }\n      } else if (key.rightArrow) {\n        if (showCursor) {\n          nextCursorOffset += 1;\n        }\n      } else if (key.backspace || key.delete) {\n        if (state.cursorOffset > 0) {\n          nextValue =\n            originalValue.slice(0, state.cursorOffset - 1) +\n            originalValue.slice(state.cursorOffset, originalValue.length);\n\n          nextCursorOffset -= 1;\n        }\n      } else {\n        nextValue =\n          originalValue.slice(0, state.cursorOffset) +\n          input +\n          originalValue.slice(state.cursorOffset, originalValue.length);\n\n        nextCursorOffset += input.length;\n\n        if (input.length > 1) {\n          nextCursorWidth = input.length;\n        }\n      }\n\n      if (state.cursorOffset < 0) {\n        nextCursorOffset = 0;\n      }\n\n      if (state.cursorOffset > originalValue.length) {\n        nextCursorOffset = originalValue.length;\n      }\n\n      setState({\n        cursorOffset: nextCursorOffset,\n        cursorWidth: nextCursorWidth,\n      });\n\n      if (nextValue !== originalValue) {\n        onChange(nextValue);\n      }\n    },\n    {isActive: focus},\n  );\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}>{value}</Text>\n        ) : (\n          <Text color={colors.highlighted}>\n            {placeholder ? (value.length > 0 ? renderedValue : renderedPlaceholder) : renderedValue}\n          </Text>\n        )}\n        {validationError ? (\n          <Box marginTop={0}>\n            <Text color={colors.warning}>{validationError}</Text>\n          </Box>\n        ) : null}\n      </Box>\n    </Box>\n  );\n}\n"],"names":["chalk","Box","Text","useInput","useEffect","useState","colors","icons","TextInput","label","validate","isComplete","value","originalValue","placeholder","focus","mask","showCursor","onChange","onSubmit","boxProps","validationError","setValidationError","state","setState","cursorOffset","length","cursorWidth","previousState","newValue","repeat","renderedValue","renderedPlaceholder","muted","undefined","inverse","slice","i","character","Object","entries","Number","input","key","upArrow","downArrow","ctrl","shift","tab","return","error","message","nextCursorOffset","nextValue","nextCursorWidth","leftArrow","rightArrow","backspace","delete","isActive","marginRight","success","question","flexDirection","color","highlighted","body","marginTop","warning"],"mappings":"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"}

package/dist/ui/getErrorDetail.js

@@ -1,4 +1,6 @@
 import { ValidationError, ParsingError } from '@jakubmazanec/args';
+import { zodIssuesToStrings } from '@jakubmazanec/zod-utils';
+import { ZodError } from 'zod';
 /**
  * Creates detailed information about an error.
  */ export function getErrorDetail(error) {
@@ -37,6 +39,13 @@ import { ValidationError, ParsingError } from '@jakubmazanec/args';
         }
         return errorDetail;
     }
+    if (error instanceof ZodError) {
+        let errorDetail = {
+            label: 'Error',
+            description: zodIssuesToStrings(error.issues).join('\n')
+        };
+        return errorDetail;
+    }
     if (error instanceof Error) {
         let errorDetail = {
             label: 'Error',

package/dist/ui/getErrorDetail.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/ui/getErrorDetail.ts"],"sourcesContent":["import {ValidationError, ParsingError} from '@jakubmazanec/args';\n\nimport {type ErrorDetail} from './ErrorDetail.js';\n\n/**\n * Creates detailed information about an error.\n */\nexport function getErrorDetail(error: unknown): ErrorDetail {\n  // TODO: add all codes\n  if (error instanceof ParsingError) {\n    switch (error.code) {\n      default: {\n        return {\n          label: 'Parsing error',\n          description: error.message,\n        };\n      }\n    }\n  }\n\n  // TODO: add all codes\n  if (error instanceof ValidationError) {\n    switch (error.code) {\n      default: {\n        return {\n          label: 'Validation error',\n          description: error.message,\n        };\n      }\n    }\n  }\n\n  // TODO: add all built-in errors\n  if (error instanceof ReferenceError) {\n    let errorDetail: ErrorDetail = {\n      label: 'Error',\n      description: error.message,\n    };\n\n    if (error.stack) {\n      errorDetail.stack = error.stack;\n    }\n\n    return errorDetail;\n  }\n\n  if (error instanceof Error) {\n    let errorDetail: ErrorDetail = {\n      label: 'Error',\n      description: error.message,\n    };\n\n    if (error.stack) {\n      errorDetail.stack = error.stack;\n    }\n\n    if (error.cause instanceof Error) {\n      errorDetail.cause = {\n        description: error.cause.message,\n      };\n\n      if (error.cause.stack) {\n        errorDetail.cause.stack = error.cause.stack;\n      }\n    }\n\n    return errorDetail;\n  }\n\n  return {\n    label: 'Error',\n  };\n}\n"],"names":["ValidationError","ParsingError","getErrorDetail","error","code","label","description","message","ReferenceError","errorDetail","stack","Error","cause"],"mappings":"AAAA,SAAQA,eAAe,EAAEC,YAAY,QAAO,qBAAqB;AAIjE;;CAEC,GACD,OAAO,SAASC,eAAeC,KAAc;IAC3C,sBAAsB;IACtB,IAAIA,iBAAiBF,cAAc;QACjC,OAAQE,MAAMC,IAAI;YAChB;gBAAS;oBACP,OAAO;wBACLC,OAAO;wBACPC,aAAaH,MAAMI,OAAO;oBAC5B;gBACF;QACF;IACF;IAEA,sBAAsB;IACtB,IAAIJ,iBAAiBH,iBAAiB;QACpC,OAAQG,MAAMC,IAAI;YAChB;gBAAS;oBACP,OAAO;wBACLC,OAAO;wBACPC,aAAaH,MAAMI,OAAO;oBAC5B;gBACF;QACF;IACF;IAEA,gCAAgC;IAChC,IAAIJ,iBAAiBK,gBAAgB;QACnC,IAAIC,cAA2B;YAC7BJ,OAAO;YACPC,aAAaH,MAAMI,OAAO;QAC5B;QAEA,IAAIJ,MAAMO,KAAK,EAAE;YACfD,YAAYC,KAAK,GAAGP,MAAMO,KAAK;QACjC;QAEA,OAAOD;IACT;IAEA,IAAIN,iBAAiBQ,OAAO;QAC1B,IAAIF,cAA2B;YAC7BJ,OAAO;YACPC,aAAaH,MAAMI,OAAO;QAC5B;QAEA,IAAIJ,MAAMO,KAAK,EAAE;YACfD,YAAYC,KAAK,GAAGP,MAAMO,KAAK;QACjC;QAEA,IAAIP,MAAMS,KAAK,YAAYD,OAAO;YAChCF,YAAYG,KAAK,GAAG;gBAClBN,aAAaH,MAAMS,KAAK,CAACL,OAAO;YAClC;YAEA,IAAIJ,MAAMS,KAAK,CAACF,KAAK,EAAE;gBACrBD,YAAYG,KAAK,CAACF,KAAK,GAAGP,MAAMS,KAAK,CAACF,KAAK;YAC7C;QACF;QAEA,OAAOD;IACT;IAEA,OAAO;QACLJ,OAAO;IACT;AACF"}
+{"version":3,"sources":["../../src/ui/getErrorDetail.ts"],"sourcesContent":["import {ValidationError, ParsingError} from '@jakubmazanec/args';\nimport {zodIssuesToStrings} from '@jakubmazanec/zod-utils';\nimport {ZodError} from 'zod';\n\nimport {type ErrorDetail} from './ErrorDetail.js';\n\n/**\n * Creates detailed information about an error.\n */\nexport function getErrorDetail(error: unknown): ErrorDetail {\n  // TODO: add all codes\n  if (error instanceof ParsingError) {\n    switch (error.code) {\n      default: {\n        return {\n          label: 'Parsing error',\n          description: error.message,\n        };\n      }\n    }\n  }\n\n  // TODO: add all codes\n  if (error instanceof ValidationError) {\n    switch (error.code) {\n      default: {\n        return {\n          label: 'Validation error',\n          description: error.message,\n        };\n      }\n    }\n  }\n\n  // TODO: add all built-in errors\n  if (error instanceof ReferenceError) {\n    let errorDetail: ErrorDetail = {\n      label: 'Error',\n      description: error.message,\n    };\n\n    if (error.stack) {\n      errorDetail.stack = error.stack;\n    }\n\n    return errorDetail;\n  }\n\n  if (error instanceof ZodError) {\n    let errorDetail: ErrorDetail = {\n      label: 'Error',\n      description: zodIssuesToStrings(error.issues).join('\\n'),\n    };\n\n    return errorDetail;\n  }\n\n  if (error instanceof Error) {\n    let errorDetail: ErrorDetail = {\n      label: 'Error',\n      description: error.message,\n    };\n\n    if (error.stack) {\n      errorDetail.stack = error.stack;\n    }\n\n    if (error.cause instanceof Error) {\n      errorDetail.cause = {\n        description: error.cause.message,\n      };\n\n      if (error.cause.stack) {\n        errorDetail.cause.stack = error.cause.stack;\n      }\n    }\n\n    return errorDetail;\n  }\n\n  return {\n    label: 'Error',\n  };\n}\n"],"names":["ValidationError","ParsingError","zodIssuesToStrings","ZodError","getErrorDetail","error","code","label","description","message","ReferenceError","errorDetail","stack","issues","join","Error","cause"],"mappings":"AAAA,SAAQA,eAAe,EAAEC,YAAY,QAAO,qBAAqB;AACjE,SAAQC,kBAAkB,QAAO,0BAA0B;AAC3D,SAAQC,QAAQ,QAAO,MAAM;AAI7B;;CAEC,GACD,OAAO,SAASC,eAAeC,KAAc;IAC3C,sBAAsB;IACtB,IAAIA,iBAAiBJ,cAAc;QACjC,OAAQI,MAAMC,IAAI;YAChB;gBAAS;oBACP,OAAO;wBACLC,OAAO;wBACPC,aAAaH,MAAMI,OAAO;oBAC5B;gBACF;QACF;IACF;IAEA,sBAAsB;IACtB,IAAIJ,iBAAiBL,iBAAiB;QACpC,OAAQK,MAAMC,IAAI;YAChB;gBAAS;oBACP,OAAO;wBACLC,OAAO;wBACPC,aAAaH,MAAMI,OAAO;oBAC5B;gBACF;QACF;IACF;IAEA,gCAAgC;IAChC,IAAIJ,iBAAiBK,gBAAgB;QACnC,IAAIC,cAA2B;YAC7BJ,OAAO;YACPC,aAAaH,MAAMI,OAAO;QAC5B;QAEA,IAAIJ,MAAMO,KAAK,EAAE;YACfD,YAAYC,KAAK,GAAGP,MAAMO,KAAK;QACjC;QAEA,OAAOD;IACT;IAEA,IAAIN,iBAAiBF,UAAU;QAC7B,IAAIQ,cAA2B;YAC7BJ,OAAO;YACPC,aAAaN,mBAAmBG,MAAMQ,MAAM,EAAEC,IAAI,CAAC;QACrD;QAEA,OAAOH;IACT;IAEA,IAAIN,iBAAiBU,OAAO;QAC1B,IAAIJ,cAA2B;YAC7BJ,OAAO;YACPC,aAAaH,MAAMI,OAAO;QAC5B;QAEA,IAAIJ,MAAMO,KAAK,EAAE;YACfD,YAAYC,KAAK,GAAGP,MAAMO,KAAK;QACjC;QAEA,IAAIP,MAAMW,KAAK,YAAYD,OAAO;YAChCJ,YAAYK,KAAK,GAAG;gBAClBR,aAAaH,MAAMW,KAAK,CAACP,OAAO;YAClC;YAEA,IAAIJ,MAAMW,KAAK,CAACJ,KAAK,EAAE;gBACrBD,YAAYK,KAAK,CAACJ,KAAK,GAAGP,MAAMW,KAAK,CAACJ,KAAK;YAC7C;QACF;QAEA,OAAOD;IACT;IAEA,OAAO;QACLJ,OAAO;IACT;AACF"}

package/dist/ui/internals/Wrapper.d.ts

@@ -1,12 +1,12 @@
 import { type FC, type PropsWithChildren } from 'react';
 import { type Program } from '../../program.js';
 /**
- * {@linkcode Wrapper} component props.
+ * {@link Wrapper} component props.
  */
 export type WrapperProps = {
     program: Program;
 };
 /**
- * A component that wraps anything {@linkcode Program} tries to render with an error boundary and all neccessary providers.
+ * A component that wraps anything {@link Program} tries to render with an error boundary and all neccessary providers.
  */
 export declare const Wrapper: FC<PropsWithChildren<WrapperProps>>;

package/dist/ui/internals/Wrapper.js

@@ -5,7 +5,7 @@ import { ErrorBoundary } from 'react-error-boundary';
 import { programContext } from './programContext.js';
 import { Failure } from '../Failure.js';
 /**
- * A component that wraps anything {@linkcode Program} tries to render with an error boundary and all neccessary providers.
+ * A component that wraps anything {@link Program} tries to render with an error boundary and all neccessary providers.
  */ export const Wrapper = ({ program, children })=>{
     let programContextValue = useMemo(()=>({
             program

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/ui/internals/Wrapper.tsx"],"sourcesContent":["import {Box} from 'ink';\nimport {useMemo, type FC, type PropsWithChildren} from 'react';\nimport {ErrorBoundary} from 'react-error-boundary';\n\nimport {programContext} from './programContext.js';\nimport {type Program} from '../../program.js';\nimport {Failure} from '../Failure.js';\n\n/**\n * {@linkcode Wrapper} component props.\n */\nexport type WrapperProps = {\n  program: Program;\n};\n\n/**\n * A component that wraps anything {@linkcode 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        <Box>{children}</Box>\n      </programContext.Provider>\n    </ErrorBoundary>\n  );\n};\n"],"names":["Box","useMemo","ErrorBoundary","programContext","Failure","Wrapper","program","children","programContextValue","FallbackComponent","Provider","value"],"mappings":";AAAA,SAAQA,GAAG,QAAO,MAAM;AACxB,SAAQC,OAAO,QAAwC,QAAQ;AAC/D,SAAQC,aAAa,QAAO,uBAAuB;AAEnD,SAAQC,cAAc,QAAO,sBAAsB;AAEnD,SAAQC,OAAO,QAAO,gBAAgB;AAStC;;CAEC,GACD,OAAO,MAAMC,UAA+C,CAAC,EAACC,OAAO,EAAEC,QAAQ,EAAC;IAC9E,IAAIC,sBAAsBP,QACxB,IAAO,CAAA;YACLK;QACF,CAAA,GACA;QAACA;KAAQ;IAGX,qBACE,KAACJ;QAAcO,mBAAmBL;kBAChC,cAAA,KAACD,eAAeO,QAAQ;YAACC,OAAOH;sBAC9B,cAAA,KAACR;0BAAKO;;;;AAId,EAAE"}
+{"version":3,"sources":["../../../src/ui/internals/Wrapper.tsx"],"sourcesContent":["import {Box} from 'ink';\nimport {useMemo, type FC, type PropsWithChildren} from 'react';\nimport {ErrorBoundary} from 'react-error-boundary';\n\nimport {programContext} from './programContext.js';\nimport {type Program} from '../../program.js';\nimport {Failure} from '../Failure.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        <Box>{children}</Box>\n      </programContext.Provider>\n    </ErrorBoundary>\n  );\n};\n"],"names":["Box","useMemo","ErrorBoundary","programContext","Failure","Wrapper","program","children","programContextValue","FallbackComponent","Provider","value"],"mappings":";AAAA,SAAQA,GAAG,QAAO,MAAM;AACxB,SAAQC,OAAO,QAAwC,QAAQ;AAC/D,SAAQC,aAAa,QAAO,uBAAuB;AAEnD,SAAQC,cAAc,QAAO,sBAAsB;AAEnD,SAAQC,OAAO,QAAO,gBAAgB;AAStC;;CAEC,GACD,OAAO,MAAMC,UAA+C,CAAC,EAACC,OAAO,EAAEC,QAAQ,EAAC;IAC9E,IAAIC,sBAAsBP,QACxB,IAAO,CAAA;YACLK;QACF,CAAA,GACA;QAACA;KAAQ;IAGX,qBACE,KAACJ;QAAcO,mBAAmBL;kBAChC,cAAA,KAACD,eAAeO,QAAQ;YAACC,OAAOH;sBAC9B,cAAA,KAACR;0BAAKO;;;;AAId,EAAE"}

package/dist/ui/internals/programContext.d.ts

@@ -4,6 +4,6 @@ export type ProgramContext = {
     program: Program;
 };
 /**
- * A React context that stores {@linkcode Program} instance.
+ * A React context that stores {@link Program} instance.
  */
 export declare const programContext: React.Context<ProgramContext>;

package/dist/ui/internals/programContext.js

@@ -1,6 +1,6 @@
 import React from 'react';
 /**
- * A React context that stores {@linkcode Program} instance.
+ * A React context that stores {@link Program} instance.
  */ export const programContext = React.createContext({});
 
 //# sourceMappingURL=programContext.js.map

package/dist/ui/internals/programContext.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/ui/internals/programContext.ts"],"sourcesContent":["import React from 'react';\n\nimport {type Program} from '../../program/Program.js';\n\nexport type ProgramContext = {\n  program: Program;\n};\n\n/**\n * A React context that stores {@linkcode Program} instance.\n */\nexport const programContext = React.createContext<ProgramContext>({} as ProgramContext);\n"],"names":["React","programContext","createContext"],"mappings":"AAAA,OAAOA,WAAW,QAAQ;AAQ1B;;CAEC,GACD,OAAO,MAAMC,iBAAiBD,MAAME,aAAa,CAAiB,CAAC,GAAqB"}
+{"version":3,"sources":["../../../src/ui/internals/programContext.ts"],"sourcesContent":["import React from 'react';\n\nimport {type Program} from '../../program/Program.js';\n\nexport type ProgramContext = {\n  program: Program;\n};\n\n/**\n * A React context that stores {@link Program} instance.\n */\nexport const programContext = React.createContext<ProgramContext>({} as ProgramContext);\n"],"names":["React","programContext","createContext"],"mappings":"AAAA,OAAOA,WAAW,QAAQ;AAQ1B;;CAEC,GACD,OAAO,MAAMC,iBAAiBD,MAAME,aAAa,CAAiB,CAAC,GAAqB"}

package/dist/ui/useProgram.d.ts

@@ -1,5 +1,5 @@
 /**
- * A React hook for accessing {@linkcode Program} instance and `exit` function that is used for showing an error (via an error boundary) and exiting.
+ * A React hook for accessing {@link Program} instance and `exit` function that is used for showing an error (via an error boundary) and exiting.
  */
 export declare function useProgram(): {
     program: import("../program.js").Program;

package/dist/ui/useProgram.js

@@ -3,7 +3,7 @@ import { useCallback, useContext } from 'react';
 import { useErrorBoundary } from 'react-error-boundary';
 import { programContext } from './internals.js';
 /**
- * A React hook for accessing {@linkcode Program} instance and `exit` function that is used for showing an error (via an error boundary) and exiting.
+ * A React hook for accessing {@link Program} instance and `exit` function that is used for showing an error (via an error boundary) and exiting.
  */ export function useProgram() {
     let { showBoundary } = useErrorBoundary();
     let { exit: appExit } = useApp();

package/dist/ui/useProgram.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/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 {@linkcode 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      showBoundary(error);\n      appExit(error as Error);\n    },\n    [appExit, showBoundary],\n  );\n\n  return {program, exit};\n}\n"],"names":["useApp","useCallback","useContext","useErrorBoundary","programContext","useProgram","showBoundary","exit","appExit","program","error"],"mappings":"AAAA,SAAQA,MAAM,QAAO,MAAM;AAC3B,SAAQC,WAAW,EAAEC,UAAU,QAAO,QAAQ;AAC9C,SAAQC,gBAAgB,QAAO,uBAAuB;AAEtD,SAAQC,cAAc,QAAO,iBAAiB;AAE9C;;CAEC,GACD,OAAO,SAASC;IACd,IAAI,EAACC,YAAY,EAAC,GAAGH;IACrB,IAAI,EAACI,MAAMC,OAAO,EAAC,GAAGR;IACtB,IAAI,EAACS,OAAO,EAAC,GAAGP,WAAWE;IAE3B,IAAIG,OAAON,YACT,CAACS;QACCJ,aAAaI;QACbF,QAAQE;IACV,GACA;QAACF;QAASF;KAAa;IAGzB,OAAO;QAACG;QAASF;IAAI;AACvB"}
+{"version":3,"sources":["../../src/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      showBoundary(error);\n      appExit(error as Error);\n    },\n    [appExit, showBoundary],\n  );\n\n  return {program, exit};\n}\n"],"names":["useApp","useCallback","useContext","useErrorBoundary","programContext","useProgram","showBoundary","exit","appExit","program","error"],"mappings":"AAAA,SAAQA,MAAM,QAAO,MAAM;AAC3B,SAAQC,WAAW,EAAEC,UAAU,QAAO,QAAQ;AAC9C,SAAQC,gBAAgB,QAAO,uBAAuB;AAEtD,SAAQC,cAAc,QAAO,iBAAiB;AAE9C;;CAEC,GACD,OAAO,SAASC;IACd,IAAI,EAACC,YAAY,EAAC,GAAGH;IACrB,IAAI,EAACI,MAAMC,OAAO,EAAC,GAAGR;IACtB,IAAI,EAACS,OAAO,EAAC,GAAGP,WAAWE;IAE3B,IAAIG,OAAON,YACT,CAACS;QACCJ,aAAaI;QACbF,QAAQE;IACV,GACA;QAACF;QAASF;KAAa;IAGzB,OAAO;QAACG;QAASF;IAAI;AACvB"}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@jakubmazanec/cli",
-  "version": "0.1.0-c5ebb6f",
+  "version": "0.1.0-dee6883",
   "description": "TypeScript-first library for building CLIs.",
   "repository": {
     "type": "git",
-    "url": "https://github.com/jakubmazanec/js-tools",
+    "url": "git@github.com:jakubmazanec/js-tools.git",
     "directory": "packages/cli"
   },
   "license": "LGPL-3.0-only",
@@ -27,13 +27,14 @@
     "typecheck": "tsc --project tsconfig.typecheck.json"
   },
   "dependencies": {
-    "@jakubmazanec/args": "1.0.1-c5ebb6f",
-    "@jakubmazanec/error": "2.0.1-c5ebb6f",
-    "@jakubmazanec/ts-utils": "2.1.0-c5ebb6f",
-    "@jakubmazanec/zod-utils": "1.0.0-c5ebb6f",
+    "@jakubmazanec/args": "1.0.1-dee6883",
+    "@jakubmazanec/error": "2.0.1-dee6883",
+    "@jakubmazanec/ts-utils": "2.1.0-dee6883",
+    "@jakubmazanec/zod-utils": "1.0.0-dee6883",
     "chalk": "^5.2.0",
     "lodash": "^4.17.21",
-    "react-error-boundary": "^4.0.7"
+    "react-error-boundary": "^4.0.7",
+    "zod": "^3.14.4"
   },
   "devDependencies": {
     "@jest/globals": "^29.5.0",

package/src/program/Command.ts

@@ -12,7 +12,7 @@ import {type Program} from './Program.js';
 // import {type ProgramCommand} from './ProgramCommand.js';
 
 /**
- * Command encapsulates piece of a CLI's logic and is executed when {@linkcode Program} instance parses that command from the command line arguments.
+ * 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<
   A extends string,
@@ -21,7 +21,6 @@ export class Command<
   D extends boolean = false,
   E extends boolean = false,
 > {
-  /* implements ProgramCommand*/
   readonly name: A;
   readonly description?: string;
   readonly parameters: B extends ParametersConfig ? B : null;
@@ -104,7 +103,7 @@ export class Command<
   }
 
   /**
-   * Executes command action with provided parsed arguments and {@linkcode Program} instance.
+   * Executes command action with provided parsed arguments and {@link Program} instance.
    */
   async run(
     parsedArgs: Arguments<{

package/src/program/CommandOptions.ts

@@ -1,7 +1,7 @@
 import {type OptionsConfig, type ParametersConfig} from '@jakubmazanec/args';
 
 /**
- * New command options.
+ * {@link Command.constructor | Command constructor} options parameter.
  */
 export type CommandOptions<
   B extends ParametersConfig,

package/src/program/Program.ts

@@ -1,5 +1,7 @@
 /* eslint-disable @typescript-eslint/no-explicit-any -- needed */
 import {type ParametersConfig, type Argv, type OptionsConfig} from '@jakubmazanec/args';
+import {type ComponentType} from 'react';
+import {type FallbackProps} from 'react-error-boundary';
 
 import {type Command} from './Command.js';
 import {ProgramError} from './ProgramError.js';
@@ -9,7 +11,7 @@ import {Wrapper} from '../ui/internals.js';
 import {Failure, Help} from '../ui.js';
 
 /**
- * Program manages and executes {@linkcode Command} instances attached to it based on parsing command line arguments.
+ * Program manages and executes {@link Command} instances attached to it based on parsing command line arguments.
  */
 export class Program {
   /** Program name. */
@@ -37,7 +39,10 @@ export class Program {
     stdout: process.stdout,
   };
 
-  constructor({name, version, description, bin}: ProgramOptions) {
+  /** Custom error boundary fallback component */
+  ErrorBoundaryFallbackComponent: ComponentType<FallbackProps>;
+
+  constructor({name, version, description, bin, ErrorBoundaryFallbackComponent}: ProgramOptions) {
     if (name) {
       this.name = name;
     }
@@ -53,6 +58,12 @@ export class Program {
     if (bin) {
       this.bin = bin;
     }
+
+    if (ErrorBoundaryFallbackComponent) {
+      this.ErrorBoundaryFallbackComponent = ErrorBoundaryFallbackComponent;
+    } else {
+      this.ErrorBoundaryFallbackComponent = Failure;
+    }
   }
 
   /**
@@ -70,6 +81,8 @@ export class Program {
 
   /**
    * Renders a React element using Ink and outputs to the configured streams.
+   *
+   * @param element The React element to render.
    */
   async renderElement(element: React.ReactElement): Promise<void> {
     if (this.isRendering) {
@@ -92,7 +105,9 @@ export class Program {
       });
     } catch (error: unknown) {
       if (error instanceof Error) {
-        await this.renderElement(createElement(Failure, {error}));
+        await this.renderElement(
+          createElement(this.ErrorBoundaryFallbackComponent, {error, resetErrorBoundary: () => {}}),
+        );
       }
     } finally {
       this.isRendering = false;
@@ -117,7 +132,12 @@ export class Program {
           let {createElement} = await import('react');
 
           for (let error of parsedArgs.errors) {
-            await this.renderElement(createElement(Failure, {error}));
+            await this.renderElement(
+              createElement(this.ErrorBoundaryFallbackComponent, {
+                error,
+                resetErrorBoundary: () => {},
+              }),
+            );
           }
         } else {
           try {
@@ -126,7 +146,12 @@ export class Program {
             let {createElement} = await import('react');
 
             if (error instanceof Error) {
-              await this.renderElement(createElement(Failure, {error}));
+              await this.renderElement(
+                createElement(this.ErrorBoundaryFallbackComponent, {
+                  error,
+                  resetErrorBoundary: () => {},
+                }),
+              );
             }
           }
 

package/src/program/ProgramOptions.ts

@@ -1,5 +1,8 @@
+import {type ComponentType} from 'react';
+import {type FallbackProps} from 'react-error-boundary';
+
 /**
- * Options for creating new {@linkcode Program} instance.
+ * {@link Project.constructor | Program constructor} options parameter.
  */
 export type ProgramOptions = {
   /** Program name. */
@@ -13,4 +16,7 @@ export type ProgramOptions = {
 
   /** Program executable name. */
   bin?: string | undefined;
+
+  /** Custom error boundary fallback component */
+  ErrorBoundaryFallbackComponent?: ComponentType<FallbackProps>;
 };

package/src/program/ProgramStreams.ts

@@ -1,5 +1,5 @@
 /**
- * {@linkcode Program} streams;
+ * {@link Program} streams;
  */
 export type ProgramStreams = {
   stderr: NodeJS.WriteStream;

package/src/ui/Failure.tsx

@@ -7,10 +7,10 @@ import {Header} from './Header.js';
 import * as icons from './icons.js';
 
 /**
- * {@linkcode Failure} component props.
+ * {@link Failure} component props.
  */
 export type FailureProps = BoxProps & {
-  /** Error that describes a failure state. Function {@linkcode 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. */
+  /** 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. */
   error: Error;
 
   /** Information about the failure state. Overrides information retireved from `error` prop. */

package/src/ui/Header.tsx

@@ -4,7 +4,7 @@ import {type PropsWithChildren} from 'react';
 import {Spinner} from './Spinner.js';
 
 /**
- * {@linkcode Header} component props.
+ * {@link Header} component props.
  */
 export type HeaderProps = BoxProps & {
   /** Icon (recommended is 1 character) to render before the header itself. */

package/src/ui/Help.tsx

@@ -7,10 +7,10 @@ import * as icons from './icons.js';
 import {type Program} from '../program.js';
 
 /**
- * {@linkcode Help} component props.
+ * {@link Help} component props.
  */
 export type HelpProps = BoxProps & {
-  /** {@linkcode Program} instance. */
+  /** {@link Program} instance. */
   program: Program;
 };
 

package/src/ui/form/SelectInput.tsx

@@ -1,6 +1,6 @@
 import {Box, type BoxProps, Text, useInput, type Key} from 'ink';
 import _ from 'lodash';
-import {useState, useEffect, useRef, useCallback} from 'react';
+import {useState, useEffect, useRef} from 'react';
 
 import {type SelectInputItem} from './SelectInputItem.js';
 import * as colors from '../colors.js';
@@ -8,7 +8,7 @@ import * as icons from '../icons.js';
 import {rotate} from '../internals.js';
 
 /**
- * Select input component props.
+ * {@linkcode SelectInput} component props.
  */
 type SelectInputProps = BoxProps & {
   /** Text to display as a label. */
@@ -17,7 +17,7 @@ type SelectInputProps = BoxProps & {
   /** Items to display in a list. */
   items: SelectInputItem[];
 
-  /** 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. */
+  /** 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. */
   focus?: boolean | undefined;
 
   /** Index of initially selected item. */
@@ -44,17 +44,16 @@ export function SelectInput({
   items = [],
   focus = true,
   initialIndex = 0,
-  limit: customLimit,
+  limit: userDefinedLimit,
   onSelect,
   onHighlight,
-  marginTop = 0,
   isComplete,
   ...boxProps
 }: SelectInputProps): JSX.Element {
-  let [rotateIndex, setRotateIndex] = useState(0);
+  let [rotatedIndex, setRotatedIndex] = useState(0);
   let [selectedIndex, setSelectedIndex] = useState(initialIndex);
-  let hasLimit = typeof customLimit === 'number' && items.length > customLimit;
-  let limit = hasLimit ? Math.min(customLimit as number, items.length) : items.length;
+  let hasLimit = typeof userDefinedLimit === 'number' && items.length > userDefinedLimit;
+  let limit = hasLimit ? Math.min(userDefinedLimit as number, items.length) : items.length;
   let previousItems = useRef<SelectInputItem[]>(items);
 
   useEffect(() => {
@@ -64,26 +63,26 @@ export function SelectInput({
         items.map((item) => item.value),
       )
     ) {
-      setRotateIndex(0);
+      setRotatedIndex(0);
       setSelectedIndex(0);
     }
 
     previousItems.current = items;
   }, [items]);
 
-  let inputHandler = useCallback(
+  useInput(
     (input: string, key: Key) => {
       if (input === 'k' || key.upArrow) {
         let lastIndex = (hasLimit ? limit : items.length) - 1;
-        let atFirstIndex = selectedIndex === 0;
+        let isAtFirstIndex = selectedIndex === 0;
         let nextIndex = hasLimit ? selectedIndex : lastIndex;
-        let nextRotateIndex = atFirstIndex ? rotateIndex + 1 : rotateIndex;
-        let nextSelectedIndex = atFirstIndex ? nextIndex : selectedIndex - 1;
+        let nextRotatedIndex = isAtFirstIndex ? rotatedIndex + 1 : rotatedIndex;
+        let nextSelectedIndex = isAtFirstIndex ? nextIndex : selectedIndex - 1;
 
-        setRotateIndex(nextRotateIndex);
+        setRotatedIndex(nextRotatedIndex);
         setSelectedIndex(nextSelectedIndex);
 
-        let slicedItems = hasLimit ? rotate(items, nextRotateIndex).slice(0, limit) : items;
+        let slicedItems = hasLimit ? rotate(items, nextRotatedIndex).slice(0, limit) : items;
 
         if (typeof onHighlight === 'function') {
           onHighlight(slicedItems[nextSelectedIndex] as SelectInputItem);
@@ -93,13 +92,13 @@ export function SelectInput({
       if (input === 'j' || key.downArrow) {
         let isAtLastIndex = selectedIndex === (hasLimit ? limit : items.length) - 1;
         let nextIndex = hasLimit ? selectedIndex : 0;
-        let nextRotateIndex = isAtLastIndex ? rotateIndex - 1 : rotateIndex;
+        let nextRotatedIndex = isAtLastIndex ? rotatedIndex - 1 : rotatedIndex;
         let nextSelectedIndex = isAtLastIndex ? nextIndex : selectedIndex + 1;
 
-        setRotateIndex(nextRotateIndex);
+        setRotatedIndex(nextRotatedIndex);
         setSelectedIndex(nextSelectedIndex);
 
-        let slicedItems = hasLimit ? rotate(items, nextRotateIndex).slice(0, limit) : items;
+        let slicedItems = hasLimit ? rotate(items, nextRotatedIndex).slice(0, limit) : items;
 
         if (typeof onHighlight === 'function') {
           onHighlight(slicedItems[nextSelectedIndex] as SelectInputItem);
@@ -107,20 +106,18 @@ export function SelectInput({
       }
 
       if (key.return) {
-        let slicedItems = hasLimit ? rotate(items, rotateIndex).slice(0, limit) : items;
+        let slicedItems = hasLimit ? rotate(items, rotatedIndex).slice(0, limit) : items;
 
         if (typeof onSelect === 'function') {
           onSelect(slicedItems[selectedIndex] as SelectInputItem);
         }
       }
     },
-    [hasLimit, limit, rotateIndex, selectedIndex, items, onSelect, onHighlight],
+    {isActive: focus},
   );
 
-  useInput(inputHandler, {isActive: focus});
-
-  let visibleItem: SelectInputItem[] = hasLimit
-    ? rotate(items, rotateIndex).slice(0, limit)
+  let visibleItems: SelectInputItem[] = hasLimit
+    ? rotate(items, rotatedIndex).slice(0, limit)
     : items;
 
   return (
@@ -139,7 +136,7 @@ export function SelectInput({
           </Text>
         ) : (
           <Box flexDirection="column">
-            {visibleItem.map((item, index) => {
+            {visibleItems.map((item, index) => {
               let isSelected = index === selectedIndex;
 
               return (
@@ -151,9 +148,7 @@ export function SelectInput({
                       <Text color={colors.unselected}>{icons.unselectedCircle}</Text>
                     )}
                   </Box>
-                  <Text
-                    color={isSelected ? colors.highlighted : colors.muted}
-                  >{`${item.label}`}</Text>
+                  <Text color={isSelected ? colors.highlighted : colors.muted}>{item.label}</Text>
                 </Box>
               );
             })}

package/src/ui/form/TextInput.tsx

@@ -20,7 +20,7 @@ export type TextInputProps = BoxProps & {
   /** Value. */
   value: string;
 
-  /** 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. */
+  /** 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 handled only by a specific component. */
   focus?: boolean | undefined;
 
   /** Replace all chars and mask the value. Useful for password inputs. */
@@ -87,7 +87,6 @@ export function TextInput({
   let renderedValue = value;
   let renderedPlaceholder = placeholder ? chalk[colors.muted](placeholder) : undefined;
 
-  // fake mouse cursor; dealing with with actual cursor and ANSI escape codes is inconvinient
   if (showCursor && focus) {
     renderedPlaceholder =
       placeholder.length > 0
@@ -96,16 +95,12 @@ export function TextInput({
 
     renderedValue = value.length > 0 ? '' : chalk.inverse(' ');
 
-    let i = 0;
-
-    for (let char of value) {
-      if (i >= state.cursorOffset && i <= state.cursorOffset) {
-        renderedValue += chalk.inverse(char);
+    for (let [i, character] of Object.entries(value)) {
+      if (Number(i) >= state.cursorOffset && Number(i) <= state.cursorOffset) {
+        renderedValue += chalk.inverse(character);
       } else {
-        renderedValue += char;
+        renderedValue += character;
       }
-
-      i += 1;
     }
 
     if (value.length > 0 && state.cursorOffset === value.length) {

package/src/ui/getErrorDetail.ts

@@ -1,4 +1,6 @@
 import {ValidationError, ParsingError} from '@jakubmazanec/args';
+import {zodIssuesToStrings} from '@jakubmazanec/zod-utils';
+import {ZodError} from 'zod';
 
 import {type ErrorDetail} from './ErrorDetail.js';
 
@@ -44,6 +46,15 @@ export function getErrorDetail(error: unknown): ErrorDetail {
     return errorDetail;
   }
 
+  if (error instanceof ZodError) {
+    let errorDetail: ErrorDetail = {
+      label: 'Error',
+      description: zodIssuesToStrings(error.issues).join('\n'),
+    };
+
+    return errorDetail;
+  }
+
   if (error instanceof Error) {
     let errorDetail: ErrorDetail = {
       label: 'Error',

package/src/ui/internals/Wrapper.tsx

@@ -7,14 +7,14 @@ import {type Program} from '../../program.js';
 import {Failure} from '../Failure.js';
 
 /**
- * {@linkcode Wrapper} component props.
+ * {@link Wrapper} component props.
  */
 export type WrapperProps = {
   program: Program;
 };
 
 /**
- * A component that wraps anything {@linkcode Program} tries to render with an error boundary and all neccessary providers.
+ * A component that wraps anything {@link Program} tries to render with an error boundary and all neccessary providers.
  */
 export const Wrapper: FC<PropsWithChildren<WrapperProps>> = ({program, children}) => {
   let programContextValue = useMemo(

package/src/ui/internals/programContext.ts

@@ -7,6 +7,6 @@ export type ProgramContext = {
 };
 
 /**
- * A React context that stores {@linkcode Program} instance.
+ * A React context that stores {@link Program} instance.
  */
 export const programContext = React.createContext<ProgramContext>({} as ProgramContext);