cli-kiss 0.2.8 → 0.2.9

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/lib/Typo.ts","../src/lib/Suggest.ts","../src/lib/Command.ts","../src/lib/Operation.ts","../src/lib/Type.ts","../src/lib/Option.ts","../src/lib/Positional.ts","../src/lib/Reader.ts","../src/lib/Usage.ts","../src/lib/Run.ts"],"sourcesContent":["export * from \"./lib/Command\";\nexport * from \"./lib/Operation\";\nexport * from \"./lib/Option\";\nexport * from \"./lib/Positional\";\nexport * from \"./lib/Reader\";\nexport * from \"./lib/Run\";\nexport * from \"./lib/Suggest\";\nexport * from \"./lib/Type\";\nexport * from \"./lib/Typo\";\nexport * from \"./lib/Usage\";\n","/**\n * Color names for terminal styling, used by {@link TypoStyle}.\n * `dark*` = standard ANSI (30–37); `bright*` = high-intensity (90–97).\n */\nexport type TypoColor =\n  | \"darkBlack\"\n  | \"darkRed\"\n  | \"darkGreen\"\n  | \"darkYellow\"\n  | \"darkBlue\"\n  | \"darkMagenta\"\n  | \"darkCyan\"\n  | \"darkWhite\"\n  | \"brightBlack\"\n  | \"brightRed\"\n  | \"brightGreen\"\n  | \"brightYellow\"\n  | \"brightBlue\"\n  | \"brightMagenta\"\n  | \"brightCyan\"\n  | \"brightWhite\";\n\n/**\n * Visual styling applied by a {@link TypoSupport} instance.\n * All fields are optional; ignored entirely in `\"none\"` mode.\n */\nexport type TypoStyle = {\n  /**\n   * Letter case.\n   */\n  case?: \"upper\" | \"lower\";\n  /**\n   * Foreground (text) color.\n   */\n  fgColor?: TypoColor;\n  /**\n   * Background color.\n   */\n  bgColor?: TypoColor;\n  /**\n   * Reduced intensity.\n   */\n  dim?: boolean;\n  /**\n   * Bold.\n   */\n  bold?: boolean;\n  /**\n   * Italic.\n   */\n  italic?: boolean;\n  /**\n   * Underline.\n   */\n  underline?: boolean;\n  /**\n   * Strikethrough.\n   */\n  strikethrough?: boolean;\n};\n\n/**\n * Section title style. Bold dark-green.\n */\nexport const typoStyleTitle: TypoStyle = {\n  fgColor: \"darkGreen\",\n  bold: true,\n};\n/**\n * Logic/type identifier style. Bold dark-magenta.\n */\nexport const typoStyleLogic: TypoStyle = {\n  fgColor: \"darkMagenta\",\n  bold: true,\n};\n/**\n * Quoted user-input style. Bold dark-yellow.\n */\nexport const typoStyleQuote: TypoStyle = {\n  fgColor: \"darkYellow\",\n  bold: true,\n};\n\n/**\n * Error label style. Bold dark-red.\n */\nexport const typoStyleFailure: TypoStyle = {\n  fgColor: \"darkRed\",\n  bold: true,\n};\n\n/**\n * Option/command name style. Bold dark-cyan.\n */\nexport const typoStyleConstants: TypoStyle = {\n  fgColor: \"darkCyan\",\n  bold: true,\n};\n/**\n * Positional/user-input label style. Bold dark-blue.\n */\nexport const typoStyleUserInput: TypoStyle = {\n  fgColor: \"darkBlue\",\n  bold: true,\n};\n\n/**\n * Strong text style. Bold.\n */\nexport const typoStyleRegularStrong: TypoStyle = {\n  bold: true,\n};\n/**\n * Subtle text style. Italic and dim.\n */\nexport const typoStyleRegularWeaker: TypoStyle = {\n  italic: true,\n  dim: true,\n};\n\n/**\n * Immutable styled string segment. Compose into a {@link TypoText}.\n */\nexport class TypoString {\n  #value: string;\n  #style: TypoStyle | undefined;\n  /**\n   * @param value - Raw text content.\n   * @param style - Style to apply when rendering.\n   */\n  constructor(value: string, style?: TypoStyle) {\n    this.#value = value;\n    this.#style = style;\n  }\n  /**\n   * Returns the text styled by `typoSupport`.\n   *\n   * @param typoSupport - Rendering mode.\n   */\n  computeStyledString(typoSupport: TypoSupport): string {\n    return typoSupport.computeStyledString(this.#value, this.#style);\n  }\n  /**\n   * Returns the raw text.\n   */\n  getRawString(): string {\n    // TODO - should there be a global config or smthg instead of passing support everywhere?\n    return this.#value;\n  }\n  /**\n   * Predefined ellipsis segment with subtle styling.\n   */\n  static elipsis = new TypoString(\"...\", typoStyleRegularWeaker);\n}\n\n/**\n * A segment of styled text, a string, or an array of segments.\n */\nexport type TypoSegment = TypoText | TypoString | Array<TypoSegment>;\n\n/**\n * Mutable sequence of {@link TypoString} segments.\n */\nexport class TypoText {\n  #strings: Array<TypoString>;\n  /**\n   * @param segments - Initial text segments\n   */\n  constructor(...segments: Array<TypoSegment>) {\n    this.#strings = [];\n    for (const segment of segments) {\n      this.push(segment);\n    }\n  }\n  /**\n   * Appends new text segment(s).\n   */\n  push(...segments: Array<TypoSegment>): void {\n    for (const segment of segments) {\n      if (typeof segment === \"string\") {\n        this.#strings.push(new TypoString(segment));\n      } else if (segment instanceof TypoString) {\n        this.#strings.push(segment);\n      } else if (segment instanceof TypoText) {\n        this.#strings.push(...segment.#strings);\n      } else if (Array.isArray(segment)) {\n        for (const part of segment) {\n          this.push(part);\n        }\n      }\n    }\n  }\n  /**\n   * Appends separated segments, optionally truncating with an ellipsis.\n   */\n  pushJoined(\n    segments: Array<TypoSegment>,\n    separator: TypoSegment,\n    ellipsisLimit: number,\n  ): void {\n    for (let index = 0; index < segments.length; index++) {\n      if (index > 0) {\n        this.push(separator);\n      }\n      if (ellipsisLimit !== undefined && index >= ellipsisLimit) {\n        this.push(TypoString.elipsis);\n        break;\n      }\n      this.push(segments[index]!);\n    }\n  }\n  /**\n   * Renders all segments into a single styled string.\n   *\n   * @param typoSupport - Rendering mode.\n   * @returns Concatenated styled string.\n   */\n  computeStyledString(typoSupport: TypoSupport): string {\n    return this.#strings\n      .map((t) => t.computeStyledString(typoSupport))\n      .join(\"\");\n  }\n  /**\n   * Returns the concatenated raw text.\n   */\n  computeRawString(): string {\n    return this.#strings.map((t) => t.getRawString()).join(\"\");\n  }\n  /**\n   * Returns the total raw character count.\n   */\n  computeRawLength(): number {\n    let length = 0;\n    for (const typoString of this.#strings) {\n      length += typoString.getRawString().length;\n    }\n    return length;\n  }\n}\n\n/**\n * Column-aligned grid of {@link TypoText} cells.\n * Each column is padded to the widest cell (raw chars); the last column is not padded.\n */\nexport class TypoGrid {\n  #typoRows: Array<Array<TypoText>>;\n  constructor() {\n    this.#typoRows = [];\n  }\n  /**\n   * Appends a row. All rows should have the same cell count.\n   *\n   * @param cells - Ordered {@link TypoText} cells.\n   */\n  pushRow(cells: Array<TypoText>) {\n    this.#typoRows.push(cells);\n  }\n  /**\n   * Renders as an array of styled, column-padded strings.\n   *\n   * @param typoSupport - Rendering mode.\n   * @returns Array of styled strings.\n   */\n  computeStyledLines(typoSupport: TypoSupport): Array<string> {\n    const widths = new Array<number>();\n    const styledLines = new Array<string>();\n    for (const typoGridRow of this.#typoRows) {\n      for (\n        let typoGridColumnIndex = 0;\n        typoGridColumnIndex < typoGridRow.length;\n        typoGridColumnIndex++\n      ) {\n        const typoGridCell = typoGridRow[typoGridColumnIndex]!;\n        const width = typoGridCell.computeRawLength();\n        if (\n          widths[typoGridColumnIndex] === undefined ||\n          width > widths[typoGridColumnIndex]!\n        ) {\n          widths[typoGridColumnIndex] = width;\n        }\n      }\n    }\n    for (const typoGridRow of this.#typoRows) {\n      const styledGridRow = new Array<string>();\n      for (\n        let typoGridColumnIndex = 0;\n        typoGridColumnIndex < typoGridRow.length;\n        typoGridColumnIndex++\n      ) {\n        const typoGridCell = typoGridRow[typoGridColumnIndex]!;\n        styledGridRow.push(typoGridCell.computeStyledString(typoSupport));\n        if (typoGridColumnIndex < typoGridRow.length - 1) {\n          const width = typoGridCell.computeRawLength();\n          const padding = \" \".repeat(widths[typoGridColumnIndex]! - width);\n          styledGridRow.push(padding);\n        }\n      }\n      styledLines.push(styledGridRow.join(\"\"));\n    }\n    return styledLines;\n  }\n}\n\n/**\n * `Error` subclass with a {@link TypoText} styled message for rich terminal output.\n * Chains `TypoError` sources after `\": \"`.\n */\nexport class TypoError extends Error {\n  #typoText: TypoText;\n  /**\n   * @param currentTypoText - Styled message for this error.\n   * @param source - Optional cause; `TypoError` chains styled text, `Error` appends `.message`, else `String()`.\n   */\n  constructor(currentTypoText: TypoText, source?: unknown) {\n    const typoText = new TypoText();\n    typoText.push(currentTypoText);\n    if (source instanceof TypoError) {\n      typoText.push(new TypoString(\": \"));\n      typoText.push(source.#typoText);\n    } else if (source instanceof Error) {\n      typoText.push(new TypoString(`: ${source.message}`));\n    } else if (source !== undefined) {\n      typoText.push(new TypoString(`: ${String(source)}`));\n    }\n    super(typoText.computeRawString());\n    this.#typoText = typoText;\n  }\n  /**\n   * Renders the styled message (without `\"Error:\"` prefix).\n   *\n   * @param typoSupport - Rendering mode.\n   * @returns Styled error string.\n   */\n  computeStyledString(typoSupport: TypoSupport): string {\n    return this.#typoText.computeStyledString(typoSupport);\n  }\n  /**\n   * Runs `thrower`; wraps any thrown error as a `TypoError` with `context()` prepended.\n   *\n   * @typeParam Value - Return type of `thrower`.\n   * @param thrower - Function to execute; result passed through on success.\n   * @param context - Produces the {@link TypoText} prepended to the caught error.\n   * @returns Value from `thrower`.\n   * @throws `TypoError` wrapping the original error with context prepended.\n   */\n  static tryWithContext<Value>(\n    thrower: () => Value,\n    context: () => TypoText,\n  ): Value {\n    try {\n      return thrower();\n    } catch (error) {\n      throw new TypoError(context(), error);\n    }\n  }\n}\n\n/**\n * Controls ANSI terminal styling. Create via the static factory methods.\n */\nexport class TypoSupport {\n  #kind: TypoSupportKind;\n  private constructor(kind: TypoSupportKind) {\n    this.#kind = kind;\n  }\n  /**\n   * Plain text — no ANSI codes.\n   */\n  static none(): TypoSupport {\n    return new TypoSupport(\"none\");\n  }\n  /**\n   * ANSI escape codes for color terminals.\n   */\n  static tty(): TypoSupport {\n    return new TypoSupport(\"tty\");\n  }\n  /**\n   * Deterministic textual styling for snapshot tests.\n   */\n  static mock(): TypoSupport {\n    return new TypoSupport(\"mock\");\n  }\n  /**\n   * Auto-detects styling mode from the process environment on best-effort basis.\n   */\n  static inferFromEnv(): TypoSupport {\n    if (!process || !process.env || !process.stdout) {\n      return TypoSupport.none();\n    }\n    if (readEnvVar(\"NO_COLOR\")) {\n      return TypoSupport.none();\n    }\n    const envForceColor = readEnvVar(\"FORCE_COLOR\");\n    if (envForceColor === \"0\") {\n      return TypoSupport.none();\n    }\n    if (envForceColor === \"1\") {\n      return TypoSupport.tty();\n    }\n    if (envForceColor === \"2\") {\n      return TypoSupport.tty();\n    }\n    if (envForceColor === \"3\") {\n      return TypoSupport.tty(); // TODO - should there be fancy colors possible?\n    }\n    if (envForceColor) {\n      return TypoSupport.tty();\n    }\n    if (!process.stdout.isTTY) {\n      return TypoSupport.none();\n    }\n    if (readEnvVar(\"TERM\")?.toLowerCase() === \"dumb\") {\n      return TypoSupport.none();\n    }\n    return TypoSupport.tty();\n  }\n  /**\n   * Applies `typoStyle` to `value` according to the current mode.\n   *\n   * @param value - Raw text.\n   * @param typoStyle - Style to apply.\n   * @returns Styled string.\n   */\n  computeStyledString(value: string, typoStyle: TypoStyle | undefined): string {\n    if (typoStyle === undefined) {\n      return value;\n    }\n    let styledValue = value;\n    if (typoStyle.case === \"upper\") {\n      styledValue = styledValue.toUpperCase();\n    }\n    if (typoStyle.case === \"lower\") {\n      styledValue = styledValue.toLowerCase();\n    }\n    if (this.#kind === \"none\") {\n      return styledValue;\n    }\n    if (this.#kind === \"tty\") {\n      const fgColorCode = typoStyle.fgColor\n        ? ttyCodeFgColors[typoStyle.fgColor]\n        : \"\";\n      const bgColorCode = typoStyle.bgColor\n        ? ttyCodeBgColors[typoStyle.bgColor]\n        : \"\";\n      const boldCode = typoStyle.bold ? ttyCodeBold : \"\";\n      const dimCode = typoStyle.dim ? ttyCodeDim : \"\";\n      const italicCode = typoStyle.italic ? ttyCodeItalic : \"\";\n      const underlineCode = typoStyle.underline ? ttyCodeUnderline : \"\";\n      const strikethroughCode = typoStyle.strikethrough\n        ? ttyCodeStrikethrough\n        : \"\";\n      return `${fgColorCode}${bgColorCode}${boldCode}${dimCode}${italicCode}${underlineCode}${strikethroughCode}${styledValue}${ttyCodeReset}`;\n    }\n    if (this.#kind === \"mock\") {\n      const fgColorPart = typoStyle.fgColor\n        ? `{${styledValue}}@${typoStyle.fgColor}`\n        : styledValue;\n      const bgColorPart = typoStyle.bgColor\n        ? `{${fgColorPart}}#${typoStyle.bgColor}`\n        : fgColorPart;\n      const boldPart = typoStyle.bold ? `{${bgColorPart}}+` : bgColorPart;\n      const dimPart = typoStyle.dim ? `{${boldPart}}-` : boldPart;\n      const italicPart = typoStyle.italic ? `{${dimPart}}*` : dimPart;\n      const underlinePart = typoStyle.underline\n        ? `{${italicPart}}_`\n        : italicPart;\n      const strikethroughPart = typoStyle.strikethrough\n        ? `{${underlinePart}}~`\n        : underlinePart;\n      return strikethroughPart;\n    }\n    throw new Error(`Unknown TypoSupport kind: ${this.#kind}`);\n  }\n  /**\n   * Formats any thrown value as `\"Error: <message>\"` with {@link typoStyleFailure} on the prefix.\n   *\n   * @param error - Any thrown value.\n   * @returns Styled error string.\n   */\n  computeStyledErrorMessage(error: unknown): string {\n    return [\n      this.computeStyledString(\"Error:\", typoStyleFailure),\n      error instanceof TypoError\n        ? error.computeStyledString(this)\n        : error instanceof Error\n          ? error.message\n          : String(error),\n    ].join(\" \");\n  }\n}\n\nconst ttyCodeReset = \"\\x1b[0m\";\nconst ttyCodeBold = \"\\x1b[1m\";\nconst ttyCodeDim = \"\\x1b[2m\";\nconst ttyCodeItalic = \"\\x1b[3m\";\nconst ttyCodeUnderline = \"\\x1b[4m\";\nconst ttyCodeStrikethrough = \"\\x1b[9m\";\nconst ttyCodeFgColors: Record<TypoColor, string> = {\n  darkBlack: \"\\x1b[30m\",\n  darkRed: \"\\x1b[31m\",\n  darkGreen: \"\\x1b[32m\",\n  darkYellow: \"\\x1b[33m\",\n  darkBlue: \"\\x1b[34m\",\n  darkMagenta: \"\\x1b[35m\",\n  darkCyan: \"\\x1b[36m\",\n  darkWhite: \"\\x1b[37m\",\n  brightBlack: \"\\x1b[90m\",\n  brightRed: \"\\x1b[91m\",\n  brightGreen: \"\\x1b[92m\",\n  brightYellow: \"\\x1b[93m\",\n  brightBlue: \"\\x1b[94m\",\n  brightMagenta: \"\\x1b[95m\",\n  brightCyan: \"\\x1b[96m\",\n  brightWhite: \"\\x1b[97m\",\n};\nconst ttyCodeBgColors: Record<TypoColor, string> = {\n  darkBlack: \"\\x1b[40m\",\n  darkRed: \"\\x1b[41m\",\n  darkGreen: \"\\x1b[42m\",\n  darkYellow: \"\\x1b[43m\",\n  darkBlue: \"\\x1b[44m\",\n  darkMagenta: \"\\x1b[45m\",\n  darkCyan: \"\\x1b[46m\",\n  darkWhite: \"\\x1b[47m\",\n  brightBlack: \"\\x1b[100m\",\n  brightRed: \"\\x1b[101m\",\n  brightGreen: \"\\x1b[102m\",\n  brightYellow: \"\\x1b[103m\",\n  brightBlue: \"\\x1b[104m\",\n  brightMagenta: \"\\x1b[105m\",\n  brightCyan: \"\\x1b[106m\",\n  brightWhite: \"\\x1b[107m\",\n};\n\nfunction readEnvVar(name: string) {\n  if (!(name in process.env)) {\n    return undefined;\n  }\n  return process.env[name];\n}\n\ntype TypoSupportKind = \"none\" | \"tty\" | \"mock\";\n","import { TypoSegment, TypoString, TypoText } from \"./Typo\";\n\nexport function suggestTextPushMessage(\n  text: TypoText,\n  query: string,\n  candidates: Array<{ reference: string; hint: TypoSegment }>,\n) {\n  const reasonableHints = suggestReasonablePayloads(\n    query,\n    candidates.map(({ reference, hint }) => ({ reference, payload: hint })),\n  );\n  if (reasonableHints.length === 0) {\n    return;\n  }\n  text.push(new TypoString(\" Did you mean: \"));\n  text.pushJoined(reasonableHints, new TypoString(\", \"), 3);\n  text.push(new TypoString(` ?`));\n}\n\nfunction suggestReasonablePayloads<Payload>(\n  query: string,\n  candidates: Array<{ reference: string; payload: Payload }>,\n): Array<Payload> {\n  if (candidates.length === 0) {\n    return [];\n  }\n  const sortedAlternatives = computeAndSortByDivergences(query, candidates);\n  const divergenceThreshold = sortedAlternatives[0]!.divergence + 0.25;\n  const acceptablePayloads = new Array<Payload>();\n  for (const { divergence, payload } of sortedAlternatives) {\n    if (divergence > divergenceThreshold) {\n      break;\n    }\n    acceptablePayloads.push(payload);\n  }\n  return acceptablePayloads;\n}\n\nfunction computeAndSortByDivergences<Payload>(\n  query: string,\n  candidates: Array<{ reference: string; payload: Payload }>,\n): Array<{ divergence: number; payload: Payload }> {\n  const queryNormalized = query.toLowerCase().slice(0, 100);\n  const scored = candidates.map(({ reference, payload }) => {\n    const referenceNormalized = reference.toLowerCase().slice(0, 100);\n    const divergence =\n      distanceDamerauLevenshtein(queryNormalized, referenceNormalized) /\n      Math.max(queryNormalized.length, referenceNormalized.length);\n    return { divergence, reference, payload };\n  });\n  return scored.sort((a, b) => a.divergence - b.divergence);\n}\n\nfunction distanceDamerauLevenshtein(a: string, b: string): number {\n  const m = a.length;\n  const n = b.length;\n  const dp = Array.from({ length: m + 1 }, () => Array<number>(n + 1).fill(0));\n  for (let i = 0; i <= m; i++) {\n    dp[i]![0] = i;\n  }\n  for (let j = 0; j <= n; j++) {\n    dp[0]![j] = j;\n  }\n  for (let i = 1; i <= m; i++) {\n    for (let j = 1; j <= n; j++) {\n      const cost = a[i - 1] === b[j - 1] ? 0 : 1;\n      dp[i]![j] = Math.min(\n        dp[i - 1]![j]! + 1,\n        dp[i]![j - 1]! + 1,\n        dp[i - 1]![j - 1]! + cost,\n      );\n      if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {\n        dp[i]![j] = Math.min(dp[i]![j]!, dp[i - 2]![j - 2]! + cost);\n      }\n    }\n  }\n  return dp[m]![n]!;\n}\n","import { Operation } from \"./Operation\";\nimport { ReaderArgs } from \"./Reader\";\nimport { suggestTextPushMessage } from \"./Suggest\";\nimport {\n  TypoError,\n  TypoString,\n  typoStyleConstants,\n  typoStyleQuote,\n  typoStyleUserInput,\n  TypoText,\n} from \"./Typo\";\nimport { UsageCommand } from \"./Usage\";\n\n/**\n * A CLI command. Created with {@link command}, {@link commandWithSubcommands}, or {@link commandChained}.\n *\n * @typeParam Context - Injected at execution; forwarded to handlers.\n * @typeParam Result - Produced on execution; typically `void`.\n */\nexport type Command<Context, Result> = {\n  /**\n   * Returns static metadata.\n   */\n  getInformation(): CommandInformation;\n  /**\n   * Registers options/positionals on `readerArgs`; returns a {@link CommandDecoder}.\n   */\n  consumeAndMakeDecoder(\n    readerArgs: ReaderArgs,\n  ): CommandDecoder<Context, Result>;\n};\n\n/**\n * Produced by {@link Command.consumeAndMakeDecoder}.\n *\n * @typeParam Context - See {@link Command}.\n * @typeParam Result - See {@link Command}.\n */\nexport type CommandDecoder<Context, Result> = {\n  /**\n   * Returns {@link UsageCommand} for the current command path.\n   */\n  generateUsage(): UsageCommand;\n  /**\n   * Creates a ready-to-execute {@link CommandInterpreter}.\n   *\n   * @throws if parsing or decoding failed.\n   */\n  decodeAndMakeInterpreter(): CommandInterpreter<Context, Result>;\n};\n\n/**\n * A fully parsed, decoded and ready-to-execute command.\n *\n * @typeParam Context - Context passed to the handler.\n * @typeParam Result - Value produced on success.\n */\nexport type CommandInterpreter<Context, Result> = {\n  /**\n   * Executes with the provided context.\n   */\n  executeWithContext(context: Context): Promise<Result>;\n};\n\n/**\n * Command metadata shown in `--help` output.\n */\nexport type CommandInformation = {\n  /**\n   * Shown in the usage header.\n   */\n  description: string;\n  /**\n   * Shown in parentheses, e.g. `\"deprecated\"`, `\"experimental\"`.\n   */\n  hint?: string;\n  /**\n   * Extra lines printed below the description.\n   */\n  details?: Array<string>;\n  /**\n   * Shown in the `Examples:` section.\n   */\n  examples?: Array<{\n    // TODO - a nicer example system, maybe with --help=example support\n    /**\n     * Explanation shown above the example.\n     */\n    explanation: string;\n    /**\n     * Example command args.\n     */\n    commandArgs: Array<\n      | string\n      | { positional: string }\n      | { subcommand: string }\n      | {\n          option:\n            | { long: string; inlined?: string; separated?: Array<string> }\n            | { short: string; inlined?: string; separated?: Array<string> };\n        }\n    >;\n  }>;\n};\n\n/**\n * Creates a leaf command that directly executes an {@link Operation}.\n *\n * @typeParam Context - Context forwarded to the handler.\n * @typeParam Result - Value returned by the handler.\n *\n * @param information - Command metadata.\n * @param operation - Options, positionals, and handler.\n * @returns A {@link Command}.\n *\n * @example\n * ```ts\n * const greet = command(\n *   { description: \"Greet a user\" },\n *   operation(\n *     { positionals: [positionalRequired({ type: type(\"name\") })] },\n *     async (_ctx, { positionals: [name] }) => console.log(`Hello, ${name}!`),\n *   ),\n * );\n * ```\n */\nexport function command<Context, Result = void>(\n  information: CommandInformation,\n  operation: Operation<Context, Result>,\n): Command<Context, Result> {\n  return {\n    getInformation() {\n      return information;\n    },\n    consumeAndMakeDecoder(readerArgs: ReaderArgs) {\n      try {\n        const operationDecoder = operation.consumeAndMakeDecoder(readerArgs);\n        const endPositional = readerArgs.consumePositional();\n        if (endPositional !== undefined) {\n          const errorText = new TypoText();\n          errorText.push(new TypoString(`Unexpected argument: `));\n          errorText.push(new TypoString(`\"${endPositional}\"`, typoStyleQuote));\n          errorText.push(new TypoString(`.`));\n          throw new TypoError(errorText);\n        }\n        return {\n          generateUsage: () => generateUsageLeaf(information, operation),\n          decodeAndMakeInterpreter() {\n            const operationInterpreter =\n              operationDecoder.decodeAndMakeInterpreter();\n            return {\n              async executeWithContext(context: Context) {\n                return await operationInterpreter.executeWithContext(context);\n              },\n            };\n          },\n        };\n      } catch (error) {\n        return {\n          generateUsage: () => generateUsageLeaf(information, operation),\n          decodeAndMakeInterpreter() {\n            throw error;\n          },\n        };\n      }\n    },\n  };\n}\n\n/**\n * Creates a command that runs `operation` first,\n * then dispatches result to a named subcommand.\n *\n * @typeParam Context - Context accepted by `operation`.\n * @typeParam Payload - Output of `operation`; becomes the subcommand's context.\n * @typeParam Result - Value produced by the selected subcommand.\n *\n * @param information - Command metadata.\n * @param operation - Runs first; output becomes the subcommand's context.\n * @param subcommands - Map of subcommand names to their {@link Command}s.\n * @returns A dispatching {@link Command}.\n *\n * @example\n * ```ts\n * const rootCmd = commandWithSubcommands(\n *   { description: \"My CLI\" },\n *   operation({ options: {}, positionals: [] }, async (ctx) => ctx),\n *   {\n *     deploy: command({ description: \"Deploy\" }, deployOperation),\n *     rollback: command({ description: \"Rollback\" }, rollbackOperation),\n *   },\n * );\n * ```\n */\nexport function commandWithSubcommands<Context, Payload, Result = void>(\n  information: CommandInformation,\n  operation: Operation<Context, Payload>,\n  subcommands: { [subcommand: string]: Command<Payload, Result> },\n): Command<Context, Result> {\n  // TODO - forbid subcommands that start with a \"-\" ?\n  const subcommandNames = Object.keys(subcommands);\n  if (subcommandNames.length === 0) {\n    throw new Error(\"At least one subcommand is required\");\n  }\n  return {\n    getInformation() {\n      return information;\n    },\n    consumeAndMakeDecoder(readerArgs: ReaderArgs) {\n      try {\n        const operationDecoder = operation.consumeAndMakeDecoder(readerArgs);\n        const subcommandName = readerArgs.consumePositional();\n        if (subcommandName === undefined) {\n          const errorText = new TypoText();\n          errorText.push(new TypoString(`<subcommand>`, typoStyleUserInput));\n          errorText.push(new TypoString(`: Missing argument.`));\n          suggestSubcommandNames(errorText, \"\", subcommandNames);\n          throw new TypoError(errorText);\n        }\n        const subcommandInput = subcommands[subcommandName];\n        if (subcommandInput === undefined) {\n          const errorText = new TypoText();\n          errorText.push(new TypoString(`<subcommand>`, typoStyleUserInput));\n          errorText.push(new TypoString(`: Unknown name: `));\n          errorText.push(new TypoString(`\"${subcommandName}\"`, typoStyleQuote));\n          errorText.push(new TypoString(`.`));\n          suggestSubcommandNames(errorText, subcommandName, subcommandNames);\n          throw new TypoError(errorText);\n        }\n        const subcommandDecoder =\n          subcommandInput.consumeAndMakeDecoder(readerArgs);\n        return {\n          generateUsage() {\n            const subcommandUsage = subcommandDecoder.generateUsage();\n            const currentUsage = generateUsageLeaf(information, operation);\n            currentUsage.segments.push({ subcommand: subcommandName });\n            currentUsage.segments.push(...subcommandUsage.segments);\n            currentUsage.information = subcommandUsage.information;\n            currentUsage.positionals.push(...subcommandUsage.positionals);\n            currentUsage.subcommands = subcommandUsage.subcommands;\n            currentUsage.options.push(...subcommandUsage.options);\n            return currentUsage;\n          },\n          decodeAndMakeInterpreter() {\n            const operationInterpreter =\n              operationDecoder.decodeAndMakeInterpreter();\n            const subcommandInterpreter =\n              subcommandDecoder.decodeAndMakeInterpreter();\n            return {\n              async executeWithContext(context: Context) {\n                return await subcommandInterpreter.executeWithContext(\n                  await operationInterpreter.executeWithContext(context),\n                );\n              },\n            };\n          },\n        };\n      } catch (error) {\n        return {\n          generateUsage() {\n            const currentUsage = generateUsageLeaf(information, operation);\n            currentUsage.segments.push({ positional: \"<subcommand>\" });\n            for (const [name, subcommand] of Object.entries(subcommands)) {\n              const { description, hint } = subcommand.getInformation();\n              currentUsage.subcommands.push({ name, description, hint });\n            }\n            return currentUsage;\n          },\n          decodeAndMakeInterpreter() {\n            throw error;\n          },\n        };\n      }\n    },\n  };\n}\n\n/**\n * Chains an {@link Operation} and a {@link Command}: `operation` runs first,\n * its output becomes `subcommand`'s context. No token is consumed for routing.\n *\n * @typeParam Context - Context accepted by `operation`.\n * @typeParam Payload - Output of `operation`; becomes `subcommand`'s context.\n * @typeParam Result - Value produced by `subcommand`.\n *\n * @param information - Command metadata.\n * @param operation - Runs first; output becomes `subcommand`'s context.\n * @param subcommand - Runs after `operation`.\n * @returns A {@link Command} composing both stages.\n */\nexport function commandChained<Context, Payload, Result = void>(\n  information: CommandInformation,\n  operation: Operation<Context, Payload>,\n  subcommand: Command<Payload, Result>,\n): Command<Context, Result> {\n  return {\n    getInformation() {\n      return information;\n    },\n    consumeAndMakeDecoder(readerArgs: ReaderArgs) {\n      try {\n        const operationDecoder = operation.consumeAndMakeDecoder(readerArgs);\n        const subcommandDecoder = subcommand.consumeAndMakeDecoder(readerArgs);\n        return {\n          generateUsage() {\n            const subcommandUsage = subcommandDecoder.generateUsage();\n            const currentUsage = generateUsageLeaf(information, operation);\n            currentUsage.segments.push(...subcommandUsage.segments);\n            currentUsage.information = subcommandUsage.information;\n            currentUsage.positionals.push(...subcommandUsage.positionals);\n            currentUsage.subcommands = subcommandUsage.subcommands;\n            currentUsage.options.push(...subcommandUsage.options);\n            return currentUsage;\n          },\n          decodeAndMakeInterpreter() {\n            const operationInterpreter =\n              operationDecoder.decodeAndMakeInterpreter();\n            const subcommandInterpreter =\n              subcommandDecoder.decodeAndMakeInterpreter();\n            return {\n              async executeWithContext(context: Context) {\n                return await subcommandInterpreter.executeWithContext(\n                  await operationInterpreter.executeWithContext(context),\n                );\n              },\n            };\n          },\n        };\n      } catch (error) {\n        return {\n          generateUsage() {\n            const currentUsage = generateUsageLeaf(information, operation);\n            currentUsage.segments.push({ positional: \"[REST]...\" });\n            return currentUsage;\n          },\n          decodeAndMakeInterpreter() {\n            throw error;\n          },\n        };\n      }\n    },\n  };\n}\n\nfunction generateUsageLeaf(\n  information: CommandInformation,\n  operation: Operation<any, any>,\n): UsageCommand {\n  const { positionals, options } = operation.generateUsage();\n  return {\n    segments: positionals.map((p) => ({ positional: p.label })),\n    information,\n    positionals,\n    subcommands: [],\n    options,\n  };\n}\n\nfunction suggestSubcommandNames(\n  errorText: TypoText,\n  input: string,\n  subcommandNames: Array<string> = [],\n) {\n  suggestTextPushMessage(\n    errorText,\n    input,\n    subcommandNames.map((subcommandName) => ({\n      reference: subcommandName,\n      hint: new TypoString(subcommandName, typoStyleConstants),\n    })),\n  );\n}\n","import { Option, OptionDecoder } from \"./Option\";\nimport { Positional, PositionalDecoder } from \"./Positional\";\nimport { ReaderArgs } from \"./Reader\";\nimport { UsageOption, UsagePositional } from \"./Usage\";\n\n/**\n * Options, positionals, and an async handler that together form the logic of a CLI command.\n *\n * Created with {@link operation} and passed to {@link command},\n * {@link commandWithSubcommands}, or {@link commandChained}.\n *\n * @typeParam Context - Injected at execution; forwarded to handlers.\n * @typeParam Result - Value produced on execution; typically `void`.\n */\nexport type Operation<Context, Result> = {\n  /**\n   * Returns usage metadata without consuming any arguments.\n   */\n  generateUsage(): {\n    /**\n     * Registered options.\n     */\n    options: Array<UsageOption>;\n    /**\n     * Declared positionals, in order.\n     */\n    positionals: Array<UsagePositional>;\n  };\n  /**\n   * Consumes args from `readerArgs` and returns an {@link OperationDecoder}.\n   */\n  consumeAndMakeDecoder(\n    readerArgs: ReaderArgs,\n  ): OperationDecoder<Context, Result>;\n};\n\n/**\n * Produced by {@link Operation.consumeAndMakeDecoder}.\n *\n * @typeParam Context - See {@link Operation}.\n * @typeParam Result - See {@link Operation}.\n */\nexport type OperationDecoder<Context, Result> = {\n  /**\n   * Creates a ready-to-execute {@link OperationInterpreter}.\n   *\n   * @throws if parsing or decoding failed.\n   */\n  decodeAndMakeInterpreter(): OperationInterpreter<Context, Result>;\n};\n\n/**\n * A fully parsed, decoded and ready-to-execute operation.\n *\n * @typeParam Context - Caller-supplied context.\n * @typeParam Result - Value produced on success.\n */\nexport type OperationInterpreter<Context, Result> = {\n  /**\n   * Executes with the provided context.\n   */\n  executeWithContext(context: Context): Promise<Result>;\n};\n\n/**\n * Creates an {@link Operation} from options, positionals, and an async handler.\n *\n * The `handler` receives `context` and `inputs` with decoded `options` and `positionals`.\n *\n * @typeParam Context - Context type accepted by the handler.\n * @typeParam Result - Return type of the handler.\n * @typeParam Options - Map of option keys to parsed value types.\n * @typeParam Positionals - Tuple of parsed positional value types, in order.\n *\n * @param inputs - Options and positionals this operation accepts.\n * @param inputs.options - Map of keys to {@link Option} descriptors.\n * @param inputs.positionals - Ordered array of {@link Positional} descriptors.\n * @param handler - Async function implementing the command logic.\n * @returns An {@link Operation}.\n *\n * @example\n * ```ts\n * const greetOperation = operation(\n *   {\n *     options: {\n *       loud: optionFlag({ long: \"loud\", description: \"Print in uppercase\" }),\n *     },\n *     positionals: [\n *       positionalRequired({ type: type(\"name\"), description: \"Name to greet\" }),\n *     ],\n *   },\n *   async function (_ctx, { options: { loud }, positionals: [name] }) {\n *     const message = `Hello, ${name}!`;\n *     console.log(loud ? message.toUpperCase() : message);\n *   },\n * );\n * ```\n */\nexport function operation<\n  Context,\n  Result,\n  const Options extends { [option: string]: any } = {},\n  const Positionals extends Array<any> = [],\n>(\n  inputs: {\n    options?: { [K in keyof Options]: Option<Options[K]> };\n    positionals?: { [K in keyof Positionals]: Positional<Positionals[K]> };\n  },\n  handler: (\n    context: Context,\n    inputs: {\n      options: { [K in keyof Options]: Options[K] };\n      positionals: { [K in keyof Positionals]: Positionals[K] };\n    },\n  ) => Promise<Result>,\n): Operation<Context, Result> {\n  return {\n    generateUsage() {\n      const optionsUsage = new Array<UsageOption>();\n      if (inputs.options !== undefined) {\n        for (const optionKey in inputs.options) {\n          const optionInput = inputs.options[optionKey]!;\n          optionsUsage.push(optionInput.generateUsage());\n        }\n      }\n      const positionalsUsage = new Array<UsagePositional>();\n      if (inputs.positionals !== undefined) {\n        for (const positionalInput of inputs.positionals) {\n          positionalsUsage.push(positionalInput.generateUsage());\n        }\n      }\n      return { options: optionsUsage, positionals: positionalsUsage };\n    },\n    consumeAndMakeDecoder(readerArgs: ReaderArgs) {\n      const optionsDecoders: Record<string, OptionDecoder<any>> = {};\n      if (inputs.options !== undefined) {\n        for (const optionKey in inputs.options) {\n          const optionInput = inputs.options[optionKey]!;\n          optionsDecoders[optionKey] =\n            optionInput.registerAndMakeDecoder(readerArgs);\n        }\n      }\n      const positionalsDecoders: Array<PositionalDecoder<any>> = [];\n      if (inputs.positionals !== undefined) {\n        for (const positionalInput of inputs.positionals) {\n          positionalsDecoders.push(\n            positionalInput.consumeAndMakeDecoder(readerArgs),\n          );\n        }\n      }\n      return {\n        decodeAndMakeInterpreter() {\n          const optionsValues: any = {};\n          for (const optionKey in optionsDecoders) {\n            optionsValues[optionKey] =\n              optionsDecoders[optionKey]!.getAndDecodeValue();\n          }\n          const positionalsValues: any = [];\n          for (const positionalDecoder of positionalsDecoders) {\n            positionalsValues.push(positionalDecoder.decodeValue());\n          }\n          return {\n            executeWithContext(context: Context) {\n              return handler(context, {\n                options: optionsValues,\n                positionals: positionalsValues,\n              });\n            },\n          };\n        },\n      };\n    },\n  };\n}\n","import { statSync } from \"fs\";\nimport { suggestTextPushMessage } from \"./Suggest\";\nimport {\n  TypoError,\n  TypoString,\n  typoStyleLogic,\n  typoStyleQuote,\n  TypoText,\n} from \"./Typo\";\n\n/**\n * Decodes a raw CLI string into a typed value.\n * A pair of a human-readable `content` name and a `decoder` function.\n *\n * Built-in: {@link type}, {@link typeBoolean}, {@link typeNumber},\n * {@link typeInteger}, {@link typeDatetime}, {@link typeUrl}.\n * Composite: {@link typeChoice}, {@link typeConverted}, {@link typeTuple}, {@link typeList}.\n *\n * @typeParam Value - Type produced by the decoder.\n */\nexport type Type<Value> = {\n  /**\n   * Human-readable name shown in help and errors (e.g. `\"name\"`, `\"context\"`).\n   */\n  content: string; // TODO - add an enforcement mechanism for casing ?\n  /**\n   * Decodes a raw CLI string into `Value`.\n   *\n   * @param input - Raw string from the command line.\n   * @returns The decoded value.\n   * @throws on invalid input.\n   */\n  decoder(input: string): Value;\n};\n\n/**\n * Decodes a string to `boolean` (case-insensitive).\n * Used by {@link optionFlag} for `--flag=<value>`.\n *\n * @example\n * ```ts\n * typeBoolean(\"flag\").decoder(\"true\")  // → true\n * typeBoolean(\"flag\").decoder(\"yes\")   // → true\n * typeBoolean(\"flag\").decoder(\"y\")     // → true\n * typeBoolean(\"flag\").decoder(\"false\") // → false\n * typeBoolean(\"flag\").decoder(\"no\")    // → false\n * typeBoolean(\"flag\").decoder(\"n\")     // → false\n * ```\n */\nexport function typeBoolean(name?: string): Type<boolean> {\n  return {\n    content: name ?? \"boolean\",\n    decoder(input: string) {\n      const lowerInput = input.toLowerCase();\n      if (typeBooleanValuesTrue.has(lowerInput)) {\n        return true;\n      }\n      if (typeBooleanValuesFalse.has(lowerInput)) {\n        return false;\n      }\n      throwInvalidValue(\"a boolean\", input);\n    },\n  };\n}\nconst typeBooleanValuesTrue = new Set([\"true\", \"yes\", \"on\", \"y\"]);\nconst typeBooleanValuesFalse = new Set([\"false\", \"no\", \"off\", \"n\"]);\n\n/**\n * Parses a date/time string via `Date.parse`.\n * Accepts any format supported by `Date.parse`, including ISO 8601.\n *\n * @example\n * ```ts\n * typeDatetime(\"my-datetime\").decoder(\"2024-01-15\") // → Date object for 2024-01-15\n * typeDatetime(\"my-datetime\").decoder(\"2024-01-15T13:45:30Z\") // → Date object for 2024-01-15 13:45:30 UTC\n * typeDatetime(\"my-datetime\").decoder(\"not a date\") // throws TypoError\n * ```\n */\nexport function typeDatetime(name?: string): Type<Date> {\n  return {\n    content: name ?? \"datetime\",\n    decoder(input: string) {\n      try {\n        const timestampMs = Date.parse(input);\n        if (isNaN(timestampMs)) {\n          throw new Error();\n        }\n        return new Date(timestampMs);\n      } catch {\n        throwInvalidValue(\"a valid ISO_8601 datetime\", input);\n      }\n    },\n  };\n}\n\n/**\n * Parses a string to `number` via `Number()`; `NaN` throws.\n *\n * @example\n * ```ts\n * typeNumber(\"my-number\").decoder(\"3.14\")  // → 3.14\n * typeNumber(\"my-number\").decoder(\"-1\")    // → -1\n * typeNumber(\"my-number\").decoder(\"hello\") // throws\n * ```\n */\nexport function typeNumber(name?: string): Type<number> {\n  return {\n    content: name ?? \"number\",\n    decoder(input: string) {\n      try {\n        const parsed = Number(input);\n        if (isNaN(parsed)) {\n          throw new Error();\n        }\n        return parsed;\n      } catch {\n        throwInvalidValue(\"a number\", input);\n      }\n    },\n  };\n}\n\n/**\n * Parses an integer string to `bigint` via `BigInt()`.\n * Floats and non-numeric strings throws.\n *\n * @example\n * ```ts\n * typeInteger(\"my-integer\").decoder(\"42\")   // → 42n\n * typeInteger(\"my-integer\").decoder(\"3.14\") // throws\n * typeInteger(\"my-integer\").decoder(\"abc\")  // throws\n * ```\n */\nexport function typeInteger(name?: string): Type<bigint> {\n  return {\n    content: name ?? \"integer\",\n    decoder(input: string) {\n      try {\n        return BigInt(input);\n      } catch {\n        throwInvalidValue(\"an integer\", input);\n      }\n    },\n  };\n}\n\n/**\n * Parses an absolute URL string to a `URL` object.\n * Relative or malformed URLs throws.\n *\n * @example\n * ```ts\n * typeUrl(\"my-url\").decoder(\"https://example.com\") // → URL { href: \"https://example.com/\", ... }\n * typeUrl(\"my-url\").decoder(\"not-a-url\")           // throws\n * ```\n */\nexport function typeUrl(name?: string): Type<URL> {\n  return {\n    content: name ?? \"url\",\n    decoder(input: string) {\n      try {\n        return new URL(input);\n      } catch {\n        throwInvalidValue(\"an URL\", input);\n      }\n    },\n  };\n}\n\n/**\n * A named type that accepts any string as input.\n * @param name - Name shown in help and errors (e.g. `\"my-value\"`).\n * @example\n * ```ts\n * type(\"greeting\").decoder(\"hello\") // → \"hello\"\n * type(\"greeting\").decoder(\"\")      // → \"\"\n * ```\n */\nexport function type(name?: string): Type<string> {\n  return {\n    content: name ?? \"string\",\n    decoder: (input: string) => input,\n  };\n}\n\n/**\n * Chains `before`'s decoder with an `after` transformation.\n * `before` errors are prefixed with `\"from: <content>\"` for traceability.\n *\n * @typeParam Before - Intermediate type from `before.decoder`.\n * @typeParam After - Final type from `after.decoder`.\n *\n * @param name - Name shown in help and errors (e.g. `\"my-value\"`).\n * @param before - Base type to decode the raw string.\n * @param mapper - Transforms `before`'s output to the final value; errors are wrapped with context.\n * @returns A {@link Type}`<After>`.\n *\n * @example\n * ```ts\n * const typePort = typeConverted(\"port\", typeNumber(), (n) => {\n *   if (n < 1 || n > 65535) throw new Error(\"Out of range\");\n *   return n;\n * });\n * // \"--port 8080\"   →  8080\n * // \"--port 99999\"  →  TypoError: --port: <PORT>: Port: Out of range\n * ```\n */\nexport function typeConverted<Before, After>(\n  name: string,\n  before: Type<Before>,\n  mapper: (value: Before) => After,\n): Type<After> {\n  return {\n    content: name,\n    decoder: (input: string) => {\n      return mapper(\n        TypoError.tryWithContext(\n          () => before.decoder(input),\n          () =>\n            new TypoText(\n              new TypoString(\"from: \"),\n              new TypoString(before.content, typoStyleLogic),\n            ),\n        ),\n      );\n    },\n  };\n}\n\n/**\n * Adds a name to a {@link Type} for clearer error messages and help text.\n *\n * @param name - Name to use for the type.\n * @param type - Base type to name.\n * @returns A {@link Type} with the given name.\n */\nexport function typeRenamed<Value>(\n  type: Type<Value>,\n  name: string,\n): Type<Value> {\n  return {\n    content: name,\n    decoder: (input: string) => {\n      return TypoError.tryWithContext(\n        () => type.decoder(input),\n        () =>\n          new TypoText(\n            new TypoString(\"from: \"),\n            new TypoString(type.content, typoStyleLogic),\n          ),\n      );\n    },\n  };\n}\n\n/**\n * Creates a {@link Type} for filesystem paths with optional existence checks.\n * @param checks - Optional checks for path existence and type (file/directory).\n * @returns A {@link Type}`<string>` representing the path.\n */\nexport function typePath(\n  name?: string,\n  checks?: { checkSyncExistAs?: \"file\" | \"directory\" | \"anything\" },\n): Type<string> {\n  return {\n    content: name ?? \"path\",\n    decoder(input: string) {\n      if (input.length === 0) {\n        throw new Error(`Path cannot be empty`);\n      }\n      if (input.includes(\"\\0\")) {\n        throw new Error(`Path cannot contain null characters`);\n      }\n      if (checks?.checkSyncExistAs !== undefined) {\n        function safeStatSync(path: string) {\n          try {\n            return statSync(path);\n          } catch (error) {\n            throw new TypoError(\n              new TypoText(\n                new TypoString(`Path does not exist: `),\n                new TypoString(`\"${path}\"`, typoStyleQuote),\n              ),\n              error,\n            );\n          }\n        }\n        const stats = safeStatSync(input);\n        const preview = stats.isDirectory()\n          ? \"directory\"\n          : stats.isFile()\n            ? \"file\"\n            : \"unknown\";\n        if (checks.checkSyncExistAs === \"file\" && !stats.isFile()) {\n          throw new TypoError(\n            new TypoText(\n              new TypoString(`Expected a file but found: ${preview}: `),\n              new TypoString(`\"${input}\"`, typoStyleQuote),\n            ),\n          );\n        }\n        if (checks.checkSyncExistAs === \"directory\" && !stats.isDirectory()) {\n          throw new TypoError(\n            new TypoText(\n              new TypoString(`Expected a directory but found: ${preview}: `),\n              new TypoString(`\"${input}\"`, typoStyleQuote),\n            ),\n          );\n        }\n      }\n      return input;\n    },\n  };\n}\n\n/**\n * Creates a {@link Type}`<string>` that only accepts a fixed set of values.\n *\n * @param name - Name shown in help and errors.\n * @param values - Ordered list of accepted values.\n * @returns A {@link Type}`<string>`.\n *\n * @example\n * ```ts\n * const typeEnv = typeChoice(\"environment\", [\"dev\", \"staging\", \"prod\"]);\n * typeEnv.decoder(\"prod\")    // → \"prod\"\n * typeEnv.decoder(\"unknown\") // throws\n * ```\n */\nexport function typeChoice<const Value extends string>(\n  name: string,\n  values: Array<Value>,\n  caseSensitive: boolean = true,\n): Type<Value> {\n  if (values.length === 0) {\n    throw new Error(\"At least one value is required\");\n  }\n  const normalize = caseSensitive\n    ? (input: string) => input\n    : (input: string) => input.toLowerCase();\n  const valueByNormalized = new Map(\n    values.map((value) => [normalize(value), value]),\n  );\n  return {\n    content: name,\n    decoder(input: string) {\n      const value = valueByNormalized.get(normalize(input));\n      if (value !== undefined) {\n        return value;\n      }\n      const errorText = new TypoText();\n      errorText.push(new TypoString(`Unknown value: `));\n      errorText.push(new TypoString(`\"${input}\"`, typoStyleQuote));\n      errorText.push(new TypoString(`.`));\n      suggestTextPushMessage(\n        errorText,\n        input,\n        values.map((value) => ({\n          reference: value,\n          hint: new TypoString(`\"${value}\"`, typoStyleQuote),\n        })),\n      );\n      throw new TypoError(errorText);\n    },\n  };\n}\n\n/**\n * Splits a delimited string into a typed tuple.\n * Each part is decoded by the corresponding element type; wrong count or decode failure throws.\n *\n * @typeParam Elements - Tuple of decoded value types (inferred from `elementTypes`).\n *\n * @param elementTypes - One {@link Type} per tuple element, in order.\n * @param separator - Delimiter (default `\",\"`).\n * @returns A {@link Type}`<Elements>`.\n *\n * @example\n * ```ts\n * const typePoint = typeTuple([typeNumber(\"x\"), typeNumber(\"y\")]);\n * typePoint.decoder(\"3.14,2.71\") // → [3.14, 2.71]\n * typePoint.decoder(\"1\")         // throws\n * typePoint.decoder(\"1,2,3\")     // throws\n * typePoint.decoder(\"x,2\")       // throws\n * ```\n */\nexport function typeTuple<const Elements extends Array<any>>(\n  elementTypes: { [K in keyof Elements]: Type<Elements[K]> },\n  separator: string = \",\",\n): Type<Elements> {\n  return {\n    content: elementTypes\n      .map((elementType) => elementType.content)\n      .join(separator),\n    decoder(input: string) {\n      const splits = input.split(separator, elementTypes.length);\n      if (splits.length !== elementTypes.length) {\n        throw new TypoError(\n          new TypoText(\n            new TypoString(`Found ${splits.length} splits: `),\n            new TypoString(`Expected ${elementTypes.length} splits from: `),\n            new TypoString(`\"${input}\"`, typoStyleQuote),\n            new TypoString(`.`),\n          ),\n        );\n      }\n      return splits.map((split, index) => {\n        const elementType = elementTypes[index]!;\n        return TypoError.tryWithContext(\n          () => elementType.decoder(split),\n          () =>\n            new TypoText(\n              new TypoString(`at ${index}: `),\n              new TypoString(elementType.content, typoStyleLogic),\n            ),\n        );\n      }) as Elements;\n    },\n  };\n}\n\n/**\n * Splits a delimited string into a typed array.\n * Each part is decoded by `elementType`; failed decodes throws.\n * Note: splitting an empty string yields one empty element — prefer {@link optionRepeatable} for a zero-default.\n *\n * @typeParam Value - Element type produced by `elementType.decoder`.\n *\n * @param elementType - Decoder applied to each element.\n * @param separator - Delimiter (default `\",\"`).\n * @returns A {@link Type}`<Array<Value>>`.\n *\n * @example\n * ```ts\n * const typeNumbers = typeList(typeNumber(\"v\"));\n * typeNumbers.decoder(\"1,2,3\")  // → [1, 2, 3]\n * typeNumbers.decoder(\"1,x,3\")  // throws\n * const typePaths = typeList(typePath(), \":\");\n * typePaths.decoder(\"/usr/bin:/usr/local/bin\") // → [\"/usr/bin\", \"/usr/local/bin\"]\n * ```\n */\nexport function typeList<Value>(\n  elementType: Type<Value>,\n  separator: string = \",\",\n): Type<Array<Value>> {\n  return {\n    content: `${elementType.content}[${separator}${elementType.content}]...`,\n    decoder(input: string) {\n      const splits = input.split(separator);\n      return splits.map((split, index) =>\n        TypoError.tryWithContext(\n          () => elementType.decoder(split),\n          () =>\n            new TypoText(\n              new TypoString(`at ${index}: `),\n              new TypoString(elementType.content, typoStyleLogic),\n            ),\n        ),\n      );\n    },\n  };\n}\n\nfunction throwInvalidValue(kind: string, input: string): never {\n  throw new TypoError(\n    new TypoText(\n      new TypoString(`Not ${kind}: `),\n      new TypoString(`\"${input}\"`, typoStyleQuote),\n      new TypoString(`.`),\n    ),\n  );\n}\n","import {\n  ReaderOptionGetter,\n  ReaderOptionNextGuard,\n  ReaderOptionRestGuard,\n  ReaderOptions,\n  ReaderOptionValue,\n} from \"./Reader\";\nimport { Type, typeBoolean } from \"./Type\";\nimport {\n  TypoError,\n  TypoString,\n  typoStyleConstants,\n  typoStyleLogic,\n  typoStyleUserInput,\n  TypoText,\n} from \"./Typo\";\nimport { UsageOption } from \"./Usage\";\n\n/**\n * A CLI option. Created with {@link optionFlag}, {@link optionSingleValue},\n * or {@link optionRepeatable}.\n *\n * @typeParam Value - Decoded value type.\n */\nexport type Option<Value> = {\n  /**\n   * Returns metadata for the `Options:` section.\n   */\n  generateUsage(): UsageOption;\n  /**\n   * Registers the option on `readerOptions` and returns an {@link OptionDecoder}.\n   */\n  registerAndMakeDecoder(readerOptions: ReaderOptions): OptionDecoder<Value>;\n};\n\n/**\n * Produced by {@link Option.registerAndMakeDecoder}.\n *\n * @typeParam Value - Decoded value type.\n */\nexport type OptionDecoder<Value> = {\n  /**\n   * Returns the decoded option value.\n   *\n   * @throws if decoding failed.\n   */\n  getAndDecodeValue(): Value;\n};\n\n/**\n * Creates a boolean flag option (`--verbose`, optionally `--flag=no`).\n *\n * Syntax: `--long`, `--long=no`, `-s`, `-s=no`.\n * Parsing logic:\n * - absent → default value\n * - `--flag` / `--flag=yes` → `true`\n * - `--flag=no` → `false`\n * - specified more than once → throws.\n *\n * @param definition.long - Long-form name (without `--`).\n * @param definition.short - Short-form name (without `-`).\n * @param definition.description - Help text.\n * @param definition.hint - Short note shown in parentheses.\n * @param definition.aliases - Additional names.\n * @param definition.default - Default value when absent.\n * @returns An {@link Option}`<boolean>`.\n *\n * @example\n * ```ts\n * const verboseFlag = optionFlag({\n *   long: \"verbose\",\n *   short: \"v\",\n *   description: \"Enable verbose output\",\n * });\n * ```\n */\nexport function optionFlag(definition: {\n  long: string;\n  short?: string;\n  description?: string;\n  hint?: string;\n  aliases?: { longs?: Array<string>; shorts?: Array<string> };\n  default?: boolean;\n}): Option<boolean> {\n  const type = typeBoolean(\"value\");\n  const { long, short, description, hint, aliases } = definition;\n  return {\n    generateUsage() {\n      return { short, long, annotation: \"[=no]\", description, hint };\n    },\n    registerAndMakeDecoder(readerOptions: ReaderOptions) {\n      const resultsGetter = setupOptionAliased(readerOptions, {\n        longKey: long,\n        shortKey: short,\n        aliasLongKeys: aliases?.longs,\n        aliasShortKeys: aliases?.shorts,\n        restGuard: () => false,\n        nextGuard: () => false,\n      });\n      return {\n        getAndDecodeValue() {\n          const results = resultsGetter();\n          if (results.length > 1) {\n            throwSetMultipleTimesError(results.map((r) => r.identifier));\n          }\n          if (results.length === 0) {\n            return definition.default === undefined\n              ? false\n              : definition.default;\n          }\n          const input = results[0]!.value.inlined;\n          if (input === null) {\n            return true;\n          }\n          return decodeValue({ long, label: undefined, type, input });\n        },\n      };\n    },\n  };\n}\n\n/**\n * Creates an option that accepts exactly one value (e.g. `--output dist/`).\n *\n * Syntax: `--long value`, `--long=value`, `-s value`, `-s=value`, `-svalue`.\n * Parsing logic:\n * - absent → `fallbackValueIfAbsent()`\n * - `--long value` → decoded with `type.decoder(\"value\")`\n * - more than once → throws\n * - if `impliedValueIfNotInlined` is not provided, then: `--long` / `-s` without a value → throws\n * - if `impliedValueIfNotInlined` is provided, then: `--long` / `-s` without an inline value → `impliedValueIfNotInlined()`\n *\n * @typeParam Value - Type produced by the decoder.\n *\n * @param definition.long - Long-form name (without `--`).\n * @param definition.short - Short-form name (without `-`).\n * @param definition.description - Help text.\n * @param definition.hint - Short note shown in parentheses.\n * @param definition.aliases - Additional names.\n * @param definition.type - Decoder for the raw string value.\n * @param definition.fallbackValueIfAbsent - Default value when the option is not specified at all.\n * @param definition.impliedValueIfNotInlined - Default value when the option is specified without an inline value (e.g. `--option` or `-o`).\n * @returns An {@link Option}`<Value>`.\n *\n * @example\n * ```ts\n * const outputOption = optionSingleValue({\n *   long: \"output\",\n *   short: \"o\",\n *   type: typePath(),\n *   description: \"Output directory\",\n *   fallbackValueIfAbsent: () => \"dist\",\n * });\n * ```\n */\nexport function optionSingleValue<Value>(definition: {\n  long: string;\n  short?: string;\n  description?: string;\n  hint?: string;\n  aliases?: { longs?: Array<string>; shorts?: Array<string> };\n  type: Type<Value>;\n  fallbackValueIfAbsent?: () => Value;\n  impliedValueIfNotInlined?: () => Value;\n}): Option<Value> {\n  const { long, short, description, hint, aliases, type } = definition;\n  const label = definition.impliedValueIfNotInlined\n    ? undefined\n    : `<${type.content}>`;\n  const annotation = definition.impliedValueIfNotInlined\n    ? `[=${type.content}]`\n    : undefined; // TODO - handle implied value and default better in usage and errors\n  return {\n    generateUsage() {\n      return { short, long, label, annotation, description, hint };\n    },\n    registerAndMakeDecoder(readerOptions: ReaderOptions) {\n      const resultsGetter = setupOptionAliased(readerOptions, {\n        longKey: long,\n        shortKey: short,\n        aliasLongKeys: aliases?.longs,\n        aliasShortKeys: aliases?.shorts,\n        restGuard: () => {\n          if (definition.impliedValueIfNotInlined !== undefined) {\n            return false;\n          }\n          return true;\n        },\n        nextGuard: (value) => {\n          if (definition.impliedValueIfNotInlined !== undefined) {\n            return false;\n          }\n          if (value.inlined !== null) {\n            return false;\n          }\n          if (value.separated.length !== 0) {\n            return false;\n          }\n          return true;\n        },\n      });\n      return {\n        getAndDecodeValue() {\n          const results = resultsGetter();\n          if (results.length > 1) {\n            throwSetMultipleTimesError(\n              results.map((result) => result.identifier),\n            );\n          }\n          const result = results[0];\n          if (result === undefined) {\n            if (definition.fallbackValueIfAbsent === undefined) {\n              const errorText = makeErrorText({ long, label, type });\n              errorText.push(new TypoString(`: Is required, but was not set.`));\n              throw new TypoError(errorText);\n            }\n            try {\n              return definition.fallbackValueIfAbsent();\n            } catch (error) {\n              const errorText = makeErrorText({ long, label, type });\n              errorText.push(new TypoString(`: Failed to get fallback value.`));\n              throw new TypoError(errorText, error);\n            }\n          }\n          const inlined = result.value.inlined;\n          if (inlined !== null) {\n            return decodeValue({ long, label, type, input: inlined });\n          }\n          if (definition.impliedValueIfNotInlined !== undefined) {\n            try {\n              return definition.impliedValueIfNotInlined();\n            } catch (error) {\n              const errorText = makeErrorText({ long, label, type });\n              errorText.push(new TypoString(`: Failed to get implied value.`));\n              throw new TypoError(errorText, error);\n            }\n          }\n          const separated = result.value.separated[0]!;\n          return decodeValue({ long, label, type, input: separated });\n        },\n      };\n    },\n  };\n}\n\n/**\n * Creates an option that collects every occurrence into an array (e.g. `--file a.ts --file b.ts`).\n *\n * Syntax: `--long value`, `--long=value`, `-s value`, `-s=value`, `-svalue`.\n * Parsing logic:\n * - absent → `[]`\n * - N occurrences → array of N decoded values in order.\n *\n * @typeParam Value - Type produced by the decoder for each occurrence.\n *\n * @param definition.long - Long-form name (without `--`).\n * @param definition.short - Short-form name (without `-`).\n * @param definition.description - Help text.\n * @param definition.hint - Short note shown in parentheses.\n * @param definition.aliases - Additional names.\n * @param definition.type - Decoder applied to each raw string value.\n * @returns An {@link Option}`<Array<Value>>`.\n *\n * @example\n * ```ts\n * const filesOption = optionRepeatable({\n *   long: \"file\",\n *   short: \"f\",\n *   type: typeString,\n *   label: \"PATH\",\n *   description: \"Input file (may be repeated)\",\n * });\n * ```\n */\nexport function optionRepeatable<Value>(definition: {\n  long: string;\n  short?: string;\n  description?: string;\n  hint?: string;\n  aliases?: { longs?: Array<string>; shorts?: Array<string> };\n  type: Type<Value>;\n}): Option<Array<Value>> {\n  const { long, short, description, hint, aliases, type } = definition;\n  const label = `<${type.content}>`;\n  return {\n    generateUsage() {\n      return { short, long, label, annotation: \" [*]\", description, hint };\n    },\n    registerAndMakeDecoder(readerOptions: ReaderOptions) {\n      const resultsGetter = setupOptionAliased(readerOptions, {\n        longKey: long,\n        shortKey: short,\n        aliasLongKeys: aliases?.longs,\n        aliasShortKeys: aliases?.shorts,\n        restGuard: () => true,\n        nextGuard: (value) => {\n          if (value.inlined !== null) {\n            return false;\n          }\n          if (value.separated.length !== 0) {\n            return false;\n          }\n          return true;\n        },\n      });\n      return {\n        getAndDecodeValue() {\n          return resultsGetter().map((result) => {\n            const value = result.value;\n            const input = value.inlined ?? value.separated[0]!;\n            return decodeValue({ long, label, type, input });\n          });\n        },\n      };\n    },\n  };\n}\n\nfunction decodeValue<Value>(params: {\n  long: string;\n  label: string | undefined;\n  type: Type<Value>;\n  input: string;\n}): Value {\n  const { long, label, type, input } = params;\n  return TypoError.tryWithContext(\n    () => type.decoder(input),\n    () => makeErrorText({ long, label, type }),\n  );\n}\n\nfunction makeErrorText(params: {\n  long: string;\n  label: string | undefined;\n  type: Type<any>;\n}): TypoText {\n  const errorText = new TypoText();\n  errorText.push(new TypoString(`--${params.long}`, typoStyleConstants));\n  if (params.label !== undefined) {\n    errorText.push(new TypoString(`: `));\n    errorText.push(new TypoString(params.label, typoStyleUserInput));\n  } else {\n    errorText.push(new TypoString(`: `));\n    errorText.push(new TypoString(params.type.content, typoStyleLogic));\n  }\n  return errorText;\n}\n\nfunction setupOptionAliased(\n  readerOptions: ReaderOptions,\n  params: {\n    longKey: string;\n    shortKey: string | undefined;\n    aliasLongKeys: Array<string> | undefined;\n    aliasShortKeys: Array<string> | undefined;\n    restGuard: ReaderOptionRestGuard;\n    nextGuard: ReaderOptionNextGuard;\n  },\n): () => Array<{ identifier: string; value: ReaderOptionValue }> {\n  const { longKey, shortKey, aliasLongKeys, aliasShortKeys } = params;\n  const longKeys = [longKey];\n  if (aliasLongKeys !== undefined) {\n    longKeys.push(...aliasLongKeys);\n  }\n  const shortKeys = shortKey ? [shortKey] : [];\n  if (aliasShortKeys !== undefined) {\n    shortKeys.push(...aliasShortKeys);\n  }\n  return setupOptionMany(readerOptions, {\n    longKeys,\n    shortKeys,\n    restGuard: params.restGuard,\n    nextGuard: params.nextGuard,\n  });\n}\n\nfunction setupOptionMany(\n  readerOptions: ReaderOptions,\n  params: {\n    longKeys: Array<string>;\n    shortKeys: Array<string>;\n    restGuard: ReaderOptionRestGuard;\n    nextGuard: ReaderOptionNextGuard;\n  },\n): () => Array<{ identifier: string; value: ReaderOptionValue }> {\n  const { longKeys, shortKeys, restGuard, nextGuard } = params;\n  const getters = new Array<ReaderOptionGetter>();\n  for (const key of longKeys) {\n    getters.push(readerOptions.registerOptionLong({ key, nextGuard }));\n  }\n  for (const key of shortKeys) {\n    getters.push(\n      readerOptions.registerOptionShort({ key, restGuard, nextGuard }),\n    );\n  }\n  return () => {\n    const results = new Array();\n    for (const getter of getters) {\n      const { identifier, values } = getter();\n      for (const value of values) {\n        results.push({ identifier, value });\n      }\n    }\n    return results;\n  };\n}\n\nfunction throwSetMultipleTimesError(identifiers: Array<string>): never {\n  const identifiersTexts = Array.from(new Set(identifiers)).map(\n    (identifier) => new TypoString(identifier, typoStyleConstants),\n  );\n  const errorText = new TypoText();\n  errorText.pushJoined(identifiersTexts, new TypoString(\", \"), 3);\n  errorText.push(new TypoString(`: Must not be set multiple times.`));\n  throw new TypoError(errorText);\n}\n","import { ReaderPositionals } from \"./Reader\";\nimport { Type } from \"./Type\";\nimport {\n  TypoError,\n  TypoString,\n  typoStyleRegularWeaker,\n  typoStyleUserInput,\n  TypoText,\n} from \"./Typo\";\nimport { UsagePositional } from \"./Usage\";\n\n/**\n * A positional argument. Created with {@link positionalRequired}, {@link positionalOptional},\n * or {@link positionalVariadics}.\n *\n * @typeParam Value - Decoded value type.\n */\nexport type Positional<Value> = {\n  /**\n   * Returns metadata for the `Positionals:` section.\n   */\n  generateUsage(): UsagePositional;\n  /**\n   * Consumes the next positional token from `readerPositionals`.\n   * Returns a decoder that produces the final value.\n   */\n  consumeAndMakeDecoder(\n    readerPositionals: ReaderPositionals,\n  ): PositionalDecoder<Value>;\n};\n\n/**\n * Produced by {@link Positional.consumeAndMakeDecoder}.\n *\n * @typeParam Value - Decoded value type.\n */\nexport type PositionalDecoder<Value> = {\n  /**\n   * Returns the decoded positional value.\n   *\n   * @throws if decoding failed.\n   */\n  decodeValue(): Value;\n};\n\n/**\n * Creates a required positional — missing token throws.\n *\n * Syntax: `<type>`, e.g. `<NAME>`.\n * Parsing logic:\n * - \"token\" → decoded with `type.decoder(\"token\")`\n * - token missing → throws\n *\n * @typeParam Value - Type produced by the decoder.\n *\n * @param definition.description - Help text.\n * @param definition.hint - Short note shown in parentheses.\n * @param definition.type - Decoder for the raw token.\n * @param definition.missing - Message shown when the token is missing.\n * @returns A {@link Positional}`<Value>`.\n *\n * @example\n * ```ts\n * const namePositional = positionalRequired({\n *   type: type(\"name\"),\n *   description: \"The name to greet\",\n * });\n * ```\n */\nexport function positionalRequired<Value>(definition: {\n  description?: string;\n  hint?: string;\n  type: Type<Value>;\n}): Positional<Value> {\n  const { description, hint, type } = definition;\n  const label = `<${type.content}>`;\n  return {\n    generateUsage() {\n      return { description, hint, label };\n    },\n    consumeAndMakeDecoder(readerPositionals: ReaderPositionals) {\n      const positional = readerPositionals.consumePositional();\n      if (positional === undefined) {\n        const errorText = makeErrorText(label);\n        errorText.push(new TypoString(`: Is required, but was not provided.`));\n        if (description !== undefined) {\n          // TODO - should there be a dedicated hint here ?\n          errorText.push(\n            new TypoString(` (${description})`, typoStyleRegularWeaker),\n          );\n        }\n        throw new TypoError(errorText);\n      }\n      return {\n        decodeValue() {\n          return decodeValue(label, definition.type, positional);\n        },\n      };\n    },\n  };\n}\n\n/**\n * Creates an optional positional — absent token falls back to `default()`.\n *\n * Syntax: `[type]`, e.g. `[NAME]`.\n * Parsing logic:\n * - \"token\" → decoded with `type.decoder(\"token\")`\n * - token missing → `default()`\n *\n * @typeParam Value - Type produced by the decoder (or the default).\n *\n * @param definition.description - Help text.\n * @param definition.hint - Short note shown in parentheses.\n * @param definition.type - Decoder for the raw token.\n * @param definition.default - Value when absent. Throw to make it required.\n * @returns A {@link Positional}`<Value>`.\n *\n * @example\n * ```ts\n * const greeteePositional = positionalOptional({\n *   type: type(\"name\"),\n *   description: \"Name to greet\",\n *   hint: \"Defaults to \\\"world\\\"\",\n *   default: () => \"world\",\n * });\n * ```\n */\nexport function positionalOptional<Value>(definition: {\n  description?: string;\n  hint?: string;\n  type: Type<Value>;\n  default: () => Value;\n}): Positional<Value> {\n  const { description, hint, type } = definition;\n  const label = `[${type.content}]`;\n  return {\n    generateUsage() {\n      return { description, hint, label };\n    },\n    consumeAndMakeDecoder(readerPositionals: ReaderPositionals) {\n      const positional = readerPositionals.consumePositional();\n      return {\n        decodeValue() {\n          if (positional === undefined) {\n            try {\n              return definition.default();\n            } catch (error) {\n              throwsWhenFailedToGetDefault(label);\n            }\n          }\n          return decodeValue(label, definition.type, positional);\n        },\n      };\n    },\n  };\n}\n\n/**\n * Creates a variadic positional that collects zero or more remaining tokens into an array.\n * Optionally stops at `endDelimiter` (consumed, not included).\n *\n * Syntax: `[type]...`, e.g. `[NAME]...`.\n * Parsing logic:\n * - \"a b ...\" → decoded with `[type.decoder(\"a\")`, `type.decoder(\"b\"), ...]``\n * - token missing → stops collection\n * - endDelimiter encountered → stops collection\n *\n * @typeParam Value - Type produced by the decoder for each token.\n *\n * @param definition.endDelimiter - Sentinel token that stops collection (consumed, not included).\n * @param definition.description - Help text.\n * @param definition.hint - Short note shown in parentheses.\n * @param definition.type - Decoder applied to each token.\n * @returns A {@link Positional}`<Array<Value>>`.\n *\n * @example\n * ```ts\n * const filesPositional = positionalVariadics({\n *   type: typePath(),\n *   description: \"Files to process\",\n * });\n * ```\n */\nexport function positionalVariadics<Value>(definition: {\n  endDelimiter?: string;\n  description?: string;\n  hint?: string;\n  type: Type<Value>;\n}): Positional<Array<Value>> {\n  const { description, hint, type } = definition;\n  const labelSingle = `[${type.content}]`;\n  const labelMultiple =\n    `${labelSingle}...` +\n    (definition.endDelimiter ? ` [\"${definition.endDelimiter}\"]` : \"\");\n  return {\n    generateUsage() {\n      return { description, hint, label: labelMultiple };\n    },\n    consumeAndMakeDecoder(readerPositionals: ReaderPositionals) {\n      const positionals = new Array<string>();\n      while (true) {\n        const positional = readerPositionals.consumePositional();\n        if (\n          positional === undefined ||\n          positional === definition.endDelimiter\n        ) {\n          break;\n        }\n        positionals.push(positional);\n      }\n      return {\n        decodeValue() {\n          return positionals.map((positional) =>\n            decodeValue(labelSingle, definition.type, positional),\n          );\n        },\n      };\n    },\n  };\n}\n\nfunction decodeValue<Value>(\n  label: string,\n  type: Type<Value>,\n  input: string,\n): Value {\n  return TypoError.tryWithContext(\n    () => type.decoder(input),\n    () => new TypoText(new TypoString(label, typoStyleUserInput)),\n  );\n}\n\nfunction makeErrorText(label: string): TypoText {\n  const errorText = new TypoText();\n  errorText.push(new TypoString(label, typoStyleUserInput));\n  return errorText;\n}\n\nfunction throwsWhenFailedToGetDefault(label: string): never {\n  const errorText = makeErrorText(label);\n  errorText.push(new TypoString(`: Failed to get default value.`));\n  throw new TypoError(errorText);\n}\n","import { suggestTextPushMessage } from \"./Suggest\";\nimport {\n  TypoError,\n  TypoString,\n  typoStyleConstants,\n  typoStyleQuote,\n  TypoText,\n} from \"./Typo\";\n\n/**\n */\nexport type ReaderOptionLongSpec = {\n  key: string;\n  nextGuard: ReaderOptionNextGuard;\n};\n\n/**\n */\nexport type ReaderOptionShortSpec = {\n  key: string;\n  restGuard: ReaderOptionRestGuard;\n  nextGuard: ReaderOptionNextGuard;\n};\n\n/**\n */\nexport type ReaderOptionRestGuard = (rest: string) => boolean;\n\n/**\n */\nexport type ReaderOptionNextGuard = (\n  value: ReaderOptionValue,\n  next: string | undefined,\n) => boolean;\n\n/**\n */\nexport type ReaderOptionResult = {\n  identifier: string;\n  values: ReadonlyArray<ReaderOptionValue>;\n};\n\n/**\n */\nexport type ReaderOptionValue = {\n  inlined: string | null;\n  separated: ReadonlyArray<string>;\n};\n\n/**\n */\nexport type ReaderOptionGetter = () => ReaderOptionResult;\n\n/**\n * Option registration/query interface. Subset of {@link ReaderArgs}.\n */\nexport type ReaderOptions = {\n  registerOptionLong(longSpec: ReaderOptionLongSpec): ReaderOptionGetter;\n  registerOptionShort(shortSpec: ReaderOptionShortSpec): ReaderOptionGetter;\n};\n\n/**\n * Positional consumption interface. Subset of {@link ReaderArgs}.\n */\nexport type ReaderPositionals = {\n  /**\n   * Returns the next positional token, parsing intervening options as side-effects.\n   *\n   * @returns The next positional, or `undefined` when exhausted.\n   * @throws on an unrecognised option.\n   */\n  consumePositional(): string | undefined;\n};\n\n/**\n * Core argument parser: converts raw CLI tokens into named options and positionals.\n * Options must be registered before {@link ReaderArgs.consumePositional} is called.\n *\n * Supported syntax: `--name`, `--name value`, `--name=value`,\n * `-n`, `-n value`, `-nvalue`, `-abc` (stacked), `--` (end-of-options).\n *\n * Created internally by {@link runAndExit}; exposed for advanced / custom runners.\n */\nexport class ReaderArgs {\n  #tokens: ReadonlyArray<string>;\n  #parsedIndex: number;\n  #parsedDouble: boolean;\n  #optionLongContextByIdentifier: Map<string, Context<ReaderOptionLongSpec>>;\n  #optionShortContextByIdentifier: Map<string, Context<ReaderOptionShortSpec>>;\n\n  /**\n   * @param tokens - Raw CLI tokens (e.g. `process.argv.slice(2)`).\n   */\n  constructor(tokens: ReadonlyArray<string>) {\n    this.#tokens = tokens;\n    this.#parsedIndex = 0;\n    this.#parsedDouble = false;\n    this.#optionLongContextByIdentifier = new Map();\n    this.#optionShortContextByIdentifier = new Map();\n  }\n\n  /**\n   */\n  registerOptionLong(longSpec: ReaderOptionLongSpec): ReaderOptionGetter {\n    const identifier = `--${longSpec.key}`;\n    if (!isValidOptionKey(longSpec.key)) {\n      throw new Error(`Option identifier is invalid: ${identifier}.`);\n    }\n    if (this.#optionLongContextByIdentifier.has(identifier)) {\n      throw new Error(`Option already registered: ${identifier}.`);\n    }\n    const values = new Array<ReaderOptionValue>();\n    this.#optionLongContextByIdentifier.set(identifier, {\n      identifier,\n      spec: longSpec,\n      values,\n    });\n    return () => ({ identifier, values });\n  }\n\n  /**\n   */\n  registerOptionShort(shortSpec: ReaderOptionShortSpec): ReaderOptionGetter {\n    const identifier = `-${shortSpec.key}`;\n    if (!isValidOptionKey(shortSpec.key)) {\n      throw new Error(`Option identifier is invalid: ${identifier}.`);\n    }\n    if (this.#optionShortContextByIdentifier.has(identifier)) {\n      throw new Error(`Option already registered: ${identifier}.`);\n    }\n    for (let i = 0; i < identifier.length; i++) {\n      const slicedIdentifier = identifier.slice(0, 1 + i);\n      if (this.#optionShortContextByIdentifier.has(slicedIdentifier)) {\n        throw new Error(\n          `Option ${identifier} overlap with shorter option: ${slicedIdentifier}.`,\n        );\n      }\n    }\n    for (const otherIdentifier of this.#optionShortContextByIdentifier.keys()) {\n      if (otherIdentifier.startsWith(identifier)) {\n        throw new Error(\n          `Option ${identifier} overlap with longer option: ${otherIdentifier}.`,\n        );\n      }\n    }\n    const values = new Array<ReaderOptionValue>();\n    this.#optionShortContextByIdentifier.set(identifier, {\n      identifier,\n      spec: shortSpec,\n      values,\n    });\n    return () => ({ identifier, values });\n  }\n\n  /**\n   * Returns the next positional token; parses intervening options as a side-effect.\n   * All tokens after `--` are treated as positionals.\n   *\n   * @returns The next positional, or `undefined` when exhausted.\n   * @throws on an unrecognised option.\n   */\n  consumePositional(): string | undefined {\n    while (true) {\n      const token = this.#consumeToken();\n      if (token === undefined) {\n        return undefined;\n      }\n      if (!this.#tryConsumeAsOption(token)) {\n        return token;\n      }\n    }\n  }\n\n  #consumeToken(): string | undefined {\n    const token = this.#tokens[this.#parsedIndex];\n    if (token === undefined) {\n      return undefined;\n    }\n    this.#parsedIndex++;\n    if (!this.#parsedDouble) {\n      if (token === \"--\") {\n        this.#parsedDouble = true;\n        return this.#consumeToken();\n      }\n    }\n    return token;\n  }\n\n  #tryConsumeAsOption(token: string): boolean {\n    if (this.#parsedDouble) {\n      return false;\n    }\n    if (token.startsWith(\"--\")) {\n      const valueIndexStart = token.indexOf(\"=\");\n      if (valueIndexStart === -1) {\n        this.#consumeOptionLong(token, null);\n      } else {\n        this.#consumeOptionLong(\n          token.slice(0, valueIndexStart),\n          token.slice(valueIndexStart + 1),\n        );\n      }\n      return true;\n    }\n    if (token.startsWith(\"-\")) {\n      let shortIndexStart = 1;\n      let shortIndexEnd = 2;\n      while (shortIndexEnd <= token.length) {\n        const identifier = `-${token.slice(shortIndexStart, shortIndexEnd)}`;\n        const shortContext =\n          this.#optionShortContextByIdentifier.get(identifier);\n        if (shortContext !== undefined) {\n          const tokenRest = token.slice(shortIndexEnd);\n          if (this.#tryConsumeOptionShort(shortContext, tokenRest)) {\n            return true;\n          }\n          shortIndexStart = shortIndexEnd;\n        }\n        shortIndexEnd++;\n      }\n      this.#throwUnknownOptionError(`-${token.slice(shortIndexStart)}`);\n    }\n    return false;\n  }\n\n  #consumeOptionLong(identifier: string, valueInlined: string | null): void {\n    const longContext = this.#optionLongContextByIdentifier.get(identifier);\n    if (longContext !== undefined) {\n      return this.#consumeOptionValues(longContext, valueInlined);\n    }\n    this.#throwUnknownOptionError(identifier);\n  }\n\n  #tryConsumeOptionShort(\n    shortContext: Context<ReaderOptionShortSpec>,\n    tokenRest: string,\n  ): boolean {\n    if (tokenRest.startsWith(\"=\")) {\n      this.#consumeOptionValues(shortContext, tokenRest.slice(1));\n      return true;\n    }\n    if (tokenRest.length === 0) {\n      this.#consumeOptionValues(shortContext, null);\n      return true;\n    }\n    if (shortContext.spec.restGuard(tokenRest)) {\n      this.#consumeOptionValues(shortContext, tokenRest);\n      return true;\n    }\n    this.#consumeOptionValues(shortContext, null);\n    return false;\n  }\n\n  #consumeOptionValues(\n    context: Context<{ nextGuard: ReaderOptionNextGuard }>,\n    valueInlined: string | null,\n  ) {\n    const value = { inlined: valueInlined, separated: new Array<string>() };\n    const { identifier, values, spec } = context;\n    values.push(value);\n    while (true) {\n      const nextToken = this.#tokens[this.#parsedIndex];\n      if (!spec.nextGuard(value, nextToken)) {\n        return;\n      }\n      const token = this.#consumeToken();\n      if (this.#parsedDouble) {\n        throw new TypoError(\n          new TypoText(\n            new TypoString(identifier, typoStyleConstants),\n            new TypoString(`: Requires a value but got: `),\n            new TypoString(`\"--\"`, typoStyleQuote),\n            new TypoString(`.`),\n          ),\n        );\n      }\n      // TODO - should we allow consuming the EOF token ?\n      if (token === undefined) {\n        throw new TypoError(\n          new TypoText(\n            new TypoString(identifier, typoStyleConstants),\n            new TypoString(`: Requires a value, but got end of input.`), // TODO - hint at option value syntax ?\n          ),\n        );\n      }\n      // TODO - is that weird, could a valid value start with dash ?\n      if (token.startsWith(\"-\")) {\n        throw new TypoError(\n          new TypoText(\n            new TypoString(identifier, typoStyleConstants),\n            new TypoString(`: Requires a value, but got: `),\n            new TypoString(`\"${token}\"`, typoStyleQuote),\n            new TypoString(`.`),\n          ),\n        );\n      }\n      value.separated.push(token);\n    }\n  }\n\n  #throwUnknownOptionError(inputIdentifier: string): never {\n    const candidatesIdentifiers = [];\n    for (const identifier of this.#optionLongContextByIdentifier.keys()) {\n      candidatesIdentifiers.push(identifier);\n    }\n    for (const identifier of this.#optionShortContextByIdentifier.keys()) {\n      candidatesIdentifiers.push(identifier);\n    }\n    const errorText = new TypoText();\n    errorText.push(new TypoString(`Unknown option: `));\n    errorText.push(new TypoString(`\"${inputIdentifier}\"`, typoStyleQuote));\n    if (candidatesIdentifiers.length === 0) {\n      errorText.push(new TypoString(`, no options are registered.`));\n    } else {\n      errorText.push(new TypoString(`.`));\n      suggestTextPushMessage(\n        errorText,\n        inputIdentifier,\n        candidatesIdentifiers.map((candidateIdentifier) => ({\n          reference: candidateIdentifier,\n          hint: new TypoString(candidateIdentifier, typoStyleConstants),\n        })),\n      );\n    }\n    throw new TypoError(errorText);\n  }\n}\n\nfunction isValidOptionKey(name: string): boolean {\n  return name.length > 0 && !name.includes(\"=\") && !name.includes(\"\\0\");\n}\n\ntype Context<Spec> = {\n  identifier: string;\n  spec: Spec;\n  values: Array<ReaderOptionValue>;\n};\n","import { CommandInformation } from \"./Command\";\nimport {\n  TypoGrid,\n  TypoString,\n  typoStyleConstants,\n  typoStyleLogic,\n  typoStyleRegularStrong,\n  typoStyleRegularWeaker,\n  typoStyleTitle,\n  typoStyleUserInput,\n  TypoSupport,\n  TypoText,\n} from \"./Typo\";\n\n/**\n * Usage model. Produced by {@link CommandDecoder.generateUsage}, consumed by {@link usageToStyledLines}.\n */\nexport type UsageCommand = {\n  /**\n   * Segments of the usage line\n   */\n  segments: Array<{ positional: string } | { subcommand: string }>;\n  /**\n   * Command metadata.\n   */\n  information: CommandInformation;\n  /**\n   * Positionals in declaration order.\n   */\n  positionals: Array<UsagePositional>;\n  /**\n   * Subcommands, populated when none was selected.\n   */\n  subcommands: Array<UsageSubcommand>;\n  /**\n   * Options in registration order.\n   */\n  options: Array<UsageOption>;\n};\n\n/**\n * Positional metadata for the `Positionals:` section of help.\n */\nexport type UsagePositional = {\n  /**\n   * Help text.\n   */\n  description?: string | undefined;\n  /**\n   * Short note shown in parentheses.\n   */\n  hint?: string | undefined;\n  /**\n   * Placeholder label shown in the usage line and the `Positionals:` section.\n   */\n  label: string;\n};\n\n/**\n * Entry in the `Subcommands:` section.\n */\nexport type UsageSubcommand = {\n  /**\n   * Token the user types (e.g. `\"deploy\"`).\n   */\n  name: string;\n  /**\n   * From {@link CommandInformation.description}.\n   */\n  description?: string | undefined;\n  /**\n   * From {@link CommandInformation.hint}.\n   */\n  hint?: string | undefined;\n};\n\n/**\n * Option metadata for the `Options:` section of help.\n */\nexport type UsageOption = {\n  /**\n   * Short-form name without `-` (e.g. `\"v\"`).\n   */\n  short?: string | undefined;\n  /**\n   * Long-form name without `--` (e.g. `\"verbose\"`).\n   */\n  long: string;\n  /**\n   * Value placeholder in help (e.g. `\"<FILE>\"`).\n   */\n  label?: string | undefined;\n  /**\n   * Extra annotation appended to the option label in help.\n   */\n  annotation?: string | undefined; // TODO - maybe prefix/postfix would be more useful\n  /**\n   * Help text.\n   */\n  description?: string | undefined;\n  /**\n   * Short note shown in parentheses.\n   */\n  hint?: string | undefined;\n};\n\n/**\n * Converts a {@link UsageCommand} model into an array of styled lines ready to be\n * joined with `\"\\n\"` and printed to the terminal.\n *\n * The output format is:\n * ```\n * Usage: <cliName> [segments...]\n *\n * <description> (<hint>)\n * <detail lines...>\n *\n * Positionals:\n *   <label>  <description> (<hint>)\n *\n * Subcommands:\n *   <name>  <description> (<hint>)\n *\n * Options:\n *   -s, --long <label><annotation>  <description> (<hint>)\n *\n * Examples:\n *   <explanation>\n *   <command line>\n *\n * ```\n * Sections that have no entries are omitted. The trailing empty line is always included.\n *\n * Column alignment per section via {@link TypoGrid}.\n *\n * @param params.cliName - Program name for the usage line.\n * @param params.usage - From {@link CommandDecoder.generateUsage}.\n * @param params.typoSupport - Rendering mode.\n * @returns Styled lines; includes a trailing empty string.\n *\n * @example\n * ```ts\n * const lines = usageToStyledLines({\n *   cliName: \"my-cli\",\n *   usage: commandDecoder.generateUsage(),\n *   typoSupport: TypoSupport.tty(),\n * });\n * process.stdout.write(lines.join(\"\\n\"));\n * ```\n */\nexport function usageToStyledLines(params: {\n  cliName: string;\n  usage: UsageCommand;\n  typoSupport: TypoSupport;\n}) {\n  const { cliName, usage, typoSupport } = params;\n\n  const lines = new Array<string>();\n\n  const segmentsText = new TypoText();\n  segmentsText.push(textUsageHero(\"Usage:\"));\n  segmentsText.push(textDelimiter(\" \"));\n  segmentsText.push(textConstants(cliName));\n  for (const segment of usage.segments) {\n    segmentsText.push(textDelimiter(\" \"));\n    if (\"positional\" in segment) {\n      segmentsText.push(textUserInput(segment.positional));\n    }\n    if (\"subcommand\" in segment) {\n      segmentsText.push(textConstants(segment.subcommand));\n    }\n  }\n  lines.push(segmentsText.computeStyledString(typoSupport));\n\n  lines.push(\"\");\n  const introText = new TypoText();\n  introText.push(textUsageText(usage.information.description));\n  if (usage.information.hint !== undefined) {\n    introText.push(textDelimiter(\" \"));\n    introText.push(textSubtleInfo(`(${usage.information.hint})`));\n  }\n  lines.push(introText.computeStyledString(typoSupport));\n  for (const detail of usage.information.details ?? []) {\n    const detailText = new TypoText();\n    detailText.push(textSubtleInfo(detail));\n    lines.push(detailText.computeStyledString(typoSupport));\n  }\n\n  if (usage.positionals.length > 0) {\n    lines.push(\"\");\n    lines.push(textBlockTitle(\"Positionals:\").computeStyledString(typoSupport));\n    const typoGrid = new TypoGrid();\n    for (const positionalUsage of usage.positionals) {\n      const typoGridRow = new Array<TypoText>();\n      typoGridRow.push(new TypoText(textDelimiter(\"  \")));\n      typoGridRow.push(new TypoText(textUserInput(positionalUsage.label)));\n      typoGridRow.push(...createInformationals(positionalUsage));\n      typoGrid.pushRow(typoGridRow);\n    }\n    lines.push(...typoGrid.computeStyledLines(typoSupport));\n  }\n\n  if (usage.subcommands.length > 0) {\n    lines.push(\"\");\n    lines.push(textBlockTitle(\"Subcommands:\").computeStyledString(typoSupport));\n    const typoGrid = new TypoGrid();\n    for (const subcommandUsage of usage.subcommands) {\n      const typoGridRow = new Array<TypoText>();\n      typoGridRow.push(new TypoText(textDelimiter(\"  \")));\n      typoGridRow.push(new TypoText(textConstants(subcommandUsage.name)));\n      typoGridRow.push(...createInformationals(subcommandUsage));\n      typoGrid.pushRow(typoGridRow);\n    }\n    lines.push(...typoGrid.computeStyledLines(typoSupport));\n  }\n\n  if (usage.options.length > 0) {\n    lines.push(\"\");\n    lines.push(textBlockTitle(\"Options:\").computeStyledString(typoSupport));\n    const typoGrid = new TypoGrid();\n    for (const optionUsage of usage.options) {\n      const typoGridRow = new Array<TypoText>();\n      typoGridRow.push(new TypoText(textDelimiter(\"  \")));\n      if (optionUsage.short !== undefined) {\n        typoGridRow.push(\n          new TypoText(\n            textConstants(`-${optionUsage.short}`),\n            textDelimiter(\", \"),\n          ),\n        );\n      } else {\n        typoGridRow.push(new TypoText());\n      }\n      const longOptionText = new TypoText(\n        textConstants(`--${optionUsage.long}`),\n      );\n      if (optionUsage.label !== undefined) {\n        longOptionText.push(textDelimiter(\" \"));\n        longOptionText.push(textUserInput(optionUsage.label));\n      }\n      if (optionUsage.annotation !== undefined) {\n        longOptionText.push(textSubtleInfo(optionUsage.annotation));\n      }\n      typoGridRow.push(longOptionText);\n      typoGridRow.push(...createInformationals(optionUsage));\n      typoGrid.pushRow(typoGridRow);\n    }\n    lines.push(...typoGrid.computeStyledLines(typoSupport));\n  }\n\n  if (usage.information.examples !== undefined) {\n    lines.push(\"\");\n    lines.push(textBlockTitle(\"Examples:\").computeStyledString(typoSupport));\n    for (const example of usage.information.examples) {\n      const explanationText = new TypoText();\n      explanationText.push(textDelimiter(\" \"));\n      explanationText.push(textSubtleInfo(`# ${example.explanation}`));\n      lines.push(explanationText.computeStyledString(typoSupport));\n      const commandLineText = new TypoText();\n      commandLineText.push(textDelimiter(\" \"));\n      commandLineText.push(textConstants(cliName));\n      for (const commandArg of example.commandArgs) {\n        commandLineText.push(textDelimiter(\" \"));\n        if (typeof commandArg === \"string\") {\n          commandLineText.push(new TypoString(commandArg));\n        } else if (\"positional\" in commandArg) {\n          commandLineText.push(textUserInput(commandArg.positional));\n        } else if (\"subcommand\" in commandArg) {\n          commandLineText.push(textConstants(commandArg.subcommand));\n        } else if (\"option\" in commandArg) {\n          const option = commandArg.option;\n          if (\"short\" in option) {\n            commandLineText.push(textConstants(`-${option.short}`));\n          } else {\n            commandLineText.push(textConstants(`--${option.long}`));\n          }\n          if (option.inlined !== undefined) {\n            commandLineText.push(textSubtleInfo(\"=\"));\n            commandLineText.push(textUserInput(option.inlined));\n          }\n          if (option.separated !== undefined) {\n            for (const separatedValue of option.separated) {\n              commandLineText.push(textDelimiter(\" \"));\n              commandLineText.push(textUserInput(separatedValue));\n            }\n          }\n        }\n      }\n      lines.push(commandLineText.computeStyledString(typoSupport));\n    }\n  }\n\n  lines.push(\"\");\n  return lines;\n}\n\nfunction createInformationals(usage: {\n  description?: string | undefined;\n  hint?: string | undefined;\n}): Array<TypoText> {\n  const informationals = [];\n  if (usage.description !== undefined) {\n    informationals.push(textDelimiter(\" \"));\n    informationals.push(textUsefulInfo(usage.description));\n  }\n  if (usage.hint !== undefined) {\n    informationals.push(textDelimiter(\" \"));\n    informationals.push(textSubtleInfo(`(${usage.hint})`));\n  }\n  if (informationals.length > 0) {\n    return [new TypoText(textDelimiter(\" \"), ...informationals)];\n  }\n  return [];\n}\n\nfunction textUsageHero(value: string): TypoString {\n  return new TypoString(value, typoStyleLogic);\n}\n\nfunction textUsageText(value: string): TypoString {\n  return new TypoString(value, typoStyleRegularStrong);\n}\n\nfunction textUsefulInfo(value: string): TypoString {\n  return new TypoString(value);\n}\n\nfunction textBlockTitle(value: string): TypoString {\n  return new TypoString(value, typoStyleTitle);\n}\n\nfunction textSubtleInfo(value: string): TypoString {\n  return new TypoString(value, typoStyleRegularWeaker);\n}\n\nfunction textConstants(value: string): TypoString {\n  return new TypoString(value, typoStyleConstants);\n}\n\nfunction textUserInput(value: string): TypoString {\n  return new TypoString(value, typoStyleUserInput);\n}\n\nfunction textDelimiter(value: string): TypoString {\n  return new TypoString(value);\n}\n","import { Command, CommandDecoder } from \"./Command\";\nimport { optionFlag, optionSingleValue } from \"./Option\";\nimport { ReaderArgs } from \"./Reader\";\nimport { typeChoice } from \"./Type\";\nimport { TypoSupport } from \"./Typo\";\nimport { usageToStyledLines } from \"./Usage\";\n\n/**\n * Color selection modes availables\n */\nexport type RunColorMode = \"env\" | \"always\" | \"never\" | \"mock\";\n\n/**\n * Main entry point: parses CLI arguments, executes the matched command, and exits.\n * Handles `--help`, `--version`, usage-on-error, and exit codes.\n *\n * Exit codes:\n *  - `0` on success / `--help` / `--version`\n *  - `1` on parse error or execution error.\n *\n * @typeParam Context - Forwarded unchanged to the handler.\n *\n * @param cliName - Program name used in usage and `--version` output.\n * @param cliArgs - Raw arguments, typically `process.argv.slice(2)`.\n * @param context - Forwarded to the handler.\n * @param command - Root {@link Command}.\n * @param options.colorSetup - Configures color support; enables `--color` flag if set to `\"flag\"`.\n * @param options.usageOnHelp - Enables `--help` flag (default `true`).\n * @param options.usageOnError - Prints usage to stderr on parse error (default `true`).\n * @param options.buildVersion - Enables `--version`; prints `<cliName> <buildVersion>`.\n * @param options.onError - Custom handler for errors.\n * @param options.onExit - Overrides `process.exit`; useful for testing.\n *\n * @returns `Promise<never>` — always calls `onExit`.\n *\n * @example\n * ```ts\n * import { runAndExit, command, operation, positionalRequired, type } from \"cli-kiss\";\n *\n * const greetCommand = command(\n *   { description: \"Greet someone\" },\n *   operation(\n *     { options: {}, positionals: [positionalRequired({ type: type(\"name\") })] },\n *     async function (_ctx, { positionals: [name] }) {\n *       console.log(`Hello, ${name}!`);\n *     },\n *   ),\n * );\n *\n * await runAndExit(\"greet\", process.argv.slice(2), undefined, greetCommand, {\n *   buildVersion: \"1.0.0\",\n * });\n * ```\n */\nexport async function runAndExit<Context>(\n  cliName: string,\n  cliArgs: ReadonlyArray<string>,\n  context: Context,\n  command: Command<Context, void>,\n  options?: {\n    colorSetup?: \"flag\" | RunColorMode | undefined;\n    usageOnHelp?: boolean | undefined;\n    usageOnError?: boolean | undefined;\n    buildVersion?: string | undefined;\n    onError?: ((error: unknown) => void) | undefined;\n    onExit?: ((code: number) => never) | undefined;\n  },\n): Promise<never> {\n  const readerArgs = new ReaderArgs(cliArgs);\n  const preprocessors = new Array<\n    (commandDecoder: CommandDecoder<Context, void>) => undefined | number\n  >();\n  let typoSupport = TypoSupport.none();\n  const colorSetup = options?.colorSetup ?? \"flag\";\n  if (colorSetup === \"flag\") {\n    const colorOption = optionSingleValue<\"auto\" | RunColorMode>({\n      long: \"color\",\n      type: typeChoice(\"color-mode\", [\"auto\", \"always\", \"never\"]),\n      fallbackValueIfAbsent: () => \"auto\",\n      impliedValueIfNotInlined: () => \"always\",\n    }).registerAndMakeDecoder(readerArgs);\n    preprocessors.push(() => {\n      try {\n        typoSupport = computeTypoSupport(colorOption.getAndDecodeValue());\n      } catch (error) {\n        typoSupport = TypoSupport.inferFromEnv();\n        throw error;\n      }\n      return undefined;\n    });\n  } else {\n    typoSupport = computeTypoSupport(colorSetup);\n  }\n  if (options?.usageOnHelp ?? true) {\n    const helpOption = optionFlag({ long: \"help\" }).registerAndMakeDecoder(\n      readerArgs,\n    );\n    preprocessors.push((commandDecoder) => {\n      if (!helpOption.getAndDecodeValue()) {\n        return undefined;\n      }\n      console.log(computeUsageString(cliName, commandDecoder, typoSupport));\n      return 0;\n    });\n  }\n  if (options?.buildVersion !== undefined) {\n    const versionOption = optionFlag({\n      long: \"version\",\n    }).registerAndMakeDecoder(readerArgs);\n    preprocessors.push(() => {\n      if (!versionOption.getAndDecodeValue()) {\n        return undefined;\n      }\n      console.log([cliName, options.buildVersion].join(\" \"));\n      return 0;\n    });\n  }\n  // TODO - the lifecycle of this function should be improved\n  // TODO - how to pass the color information to the command logic ?\n  /*\n  // TODO - handle completions ?\n  readerArgs.registerFlag({\n    key: \"completion\",\n    shorts: [],\n    longs: [\"completion\"],\n  });\n  */\n  const commandDecoder = command.consumeAndMakeDecoder(readerArgs);\n  while (true) {\n    try {\n      const positional = readerArgs.consumePositional();\n      if (positional === undefined) {\n        break;\n      }\n    } catch (_) {}\n  }\n  const onExit = options?.onExit ?? process.exit;\n  try {\n    for (const preprocessor of preprocessors) {\n      const preprocessorResult = preprocessor(commandDecoder);\n      if (preprocessorResult !== undefined) {\n        return onExit(preprocessorResult);\n      }\n    }\n    const commandInterpreter = commandDecoder.decodeAndMakeInterpreter();\n    try {\n      await commandInterpreter.executeWithContext(context);\n      return onExit(0);\n    } catch (executionError) {\n      handleError(cliName, options?.onError, executionError, typoSupport);\n      return onExit(1);\n    }\n  } catch (parsingError) {\n    if (options?.usageOnError ?? true) {\n      console.error(computeUsageString(cliName, commandDecoder, typoSupport));\n    }\n    handleError(cliName, options?.onError, parsingError, typoSupport);\n    return onExit(1);\n  }\n}\n\nfunction handleError(\n  _cliName: string,\n  onError: ((error: unknown) => void) | undefined,\n  error: unknown,\n  typoSupport: TypoSupport,\n) {\n  // TODO - should the cliName be part of the error message for logs ?\n  const finalError = error;\n  /*\n  const finalError = new TypoError(\n    new TypoText(new TypoString(cliName, typoStyleConstants)),\n    error,\n  );\n  */\n  if (onError !== undefined) {\n    onError(finalError);\n  } else {\n    console.error(typoSupport.computeStyledErrorMessage(finalError));\n  }\n}\n\nfunction computeUsageString<Context, Result>(\n  cliName: string,\n  commandDecoder: CommandDecoder<Context, Result>,\n  typoSupport: TypoSupport,\n) {\n  return usageToStyledLines({\n    cliName,\n    usage: commandDecoder.generateUsage(),\n    typoSupport,\n  }).join(\"\\n\");\n}\n\nfunction computeTypoSupport(colorMode: \"auto\" | RunColorMode): TypoSupport {\n  switch (colorMode) {\n    case \"auto\":\n      return TypoSupport.inferFromEnv();\n    case \"env\":\n      return TypoSupport.inferFromEnv();\n    case \"always\":\n      return TypoSupport.tty();\n    case \"never\":\n      return TypoSupport.none();\n    case \"mock\":\n      return TypoSupport.mock();\n  }\n}\n"],"mappings":"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","names":["index_exports","__export","ReaderArgs","TypoError","TypoGrid","TypoString","TypoSupport","TypoText","command","commandChained","commandWithSubcommands","operation","optionFlag","optionRepeatable","optionSingleValue","positionalOptional","positionalRequired","positionalVariadics","runAndExit","suggestTextPushMessage","type","typeBoolean","typeChoice","typeConverted","typeDatetime","typeInteger","typeList","typeNumber","typePath","typeRenamed","typeTuple","typeUrl","typoStyleConstants","typoStyleFailure","typoStyleLogic","typoStyleQuote","typoStyleRegularStrong","typoStyleRegularWeaker","typoStyleTitle","typoStyleUserInput","usageToStyledLines","__toCommonJS","typoStyleTitle","typoStyleLogic","typoStyleQuote","typoStyleFailure","typoStyleConstants","typoStyleUserInput","typoStyleRegularStrong","typoStyleRegularWeaker","_value","_style","_TypoString","value","style","__privateAdd","__privateSet","typoSupport","__privateGet","TypoString","_strings","_TypoText","segments","segment","part","separator","ellipsisLimit","index","t","length","typoString","TypoText","_typoRows","TypoGrid","cells","widths","styledLines","typoGridRow","typoGridColumnIndex","width","styledGridRow","typoGridCell","padding","_typoText","_TypoError","currentTypoText","source","typoText","thrower","context","error","TypoError","_kind","_TypoSupport","kind","readEnvVar","envForceColor","typoStyle","styledValue","fgColorCode","ttyCodeFgColors","bgColorCode","ttyCodeBgColors","boldCode","ttyCodeBold","dimCode","ttyCodeDim","italicCode","ttyCodeItalic","underlineCode","ttyCodeUnderline","strikethroughCode","ttyCodeStrikethrough","ttyCodeReset","fgColorPart","bgColorPart","boldPart","dimPart","italicPart","underlinePart","TypoSupport","name","suggestTextPushMessage","text","query","candidates","reasonableHints","suggestReasonablePayloads","reference","hint","TypoString","sortedAlternatives","computeAndSortByDivergences","divergenceThreshold","acceptablePayloads","divergence","payload","queryNormalized","referenceNormalized","distanceDamerauLevenshtein","a","b","m","n","dp","i","j","cost","command","information","operation","readerArgs","operationDecoder","endPositional","errorText","TypoText","TypoString","typoStyleQuote","TypoError","generateUsageLeaf","operationInterpreter","context","error","commandWithSubcommands","subcommands","subcommandNames","subcommandName","typoStyleUserInput","suggestSubcommandNames","subcommandInput","subcommandDecoder","subcommandUsage","currentUsage","subcommandInterpreter","name","subcommand","description","hint","commandChained","positionals","options","p","input","suggestTextPushMessage","typoStyleConstants","operation","inputs","handler","optionsUsage","optionKey","optionInput","positionalsUsage","positionalInput","readerArgs","optionsDecoders","positionalsDecoders","optionsValues","positionalsValues","positionalDecoder","context","import_fs","typeBoolean","name","input","lowerInput","typeBooleanValuesTrue","typeBooleanValuesFalse","throwInvalidValue","typeDatetime","timestampMs","typeNumber","parsed","typeInteger","typeUrl","type","typeConverted","before","mapper","TypoError","TypoText","TypoString","typoStyleLogic","typeRenamed","typePath","checks","safeStatSync","path","error","typoStyleQuote","stats","preview","typeChoice","values","caseSensitive","normalize","valueByNormalized","value","errorText","suggestTextPushMessage","typeTuple","elementTypes","separator","elementType","splits","split","index","typeList","kind","optionFlag","definition","type","typeBoolean","long","short","description","hint","aliases","readerOptions","resultsGetter","setupOptionAliased","results","throwSetMultipleTimesError","r","input","decodeValue","optionSingleValue","label","annotation","value","result","errorText","makeErrorText","TypoString","TypoError","error","inlined","separated","optionRepeatable","params","TypoText","typoStyleConstants","typoStyleUserInput","typoStyleLogic","longKey","shortKey","aliasLongKeys","aliasShortKeys","longKeys","shortKeys","setupOptionMany","restGuard","nextGuard","getters","key","getter","identifier","values","identifiers","identifiersTexts","positionalRequired","definition","description","hint","type","label","readerPositionals","positional","errorText","makeErrorText","TypoString","typoStyleRegularWeaker","TypoError","decodeValue","positionalOptional","throwsWhenFailedToGetDefault","positionalVariadics","labelSingle","labelMultiple","positionals","input","TypoText","typoStyleUserInput","_tokens","_parsedIndex","_parsedDouble","_optionLongContextByIdentifier","_optionShortContextByIdentifier","_ReaderArgs_instances","consumeToken_fn","tryConsumeAsOption_fn","consumeOptionLong_fn","tryConsumeOptionShort_fn","consumeOptionValues_fn","throwUnknownOptionError_fn","ReaderArgs","tokens","__privateAdd","__privateSet","longSpec","identifier","isValidOptionKey","__privateGet","values","shortSpec","i","slicedIdentifier","otherIdentifier","token","__privateMethod","__privateWrapper","valueIndexStart","shortIndexStart","shortIndexEnd","shortContext","tokenRest","valueInlined","longContext","context","value","spec","nextToken","TypoError","TypoText","TypoString","typoStyleConstants","typoStyleQuote","inputIdentifier","candidatesIdentifiers","errorText","suggestTextPushMessage","candidateIdentifier","name","usageToStyledLines","params","cliName","usage","typoSupport","lines","segmentsText","TypoText","textUsageHero","textDelimiter","textConstants","segment","textUserInput","introText","textUsageText","textSubtleInfo","detail","detailText","textBlockTitle","typoGrid","TypoGrid","positionalUsage","typoGridRow","createInformationals","subcommandUsage","optionUsage","longOptionText","example","explanationText","commandLineText","commandArg","TypoString","option","separatedValue","informationals","textUsefulInfo","value","typoStyleLogic","typoStyleRegularStrong","typoStyleTitle","typoStyleRegularWeaker","typoStyleConstants","typoStyleUserInput","runAndExit","cliName","cliArgs","context","command","options","readerArgs","ReaderArgs","preprocessors","typoSupport","TypoSupport","colorSetup","colorOption","optionSingleValue","typeChoice","computeTypoSupport","error","helpOption","optionFlag","commandDecoder","computeUsageString","versionOption","onExit","preprocessor","preprocessorResult","commandInterpreter","executionError","handleError","parsingError","_cliName","onError","finalError","usageToStyledLines","colorMode"]}
+{"version":3,"sources":["../src/index.ts","../src/lib/Typo.ts","../src/lib/Suggest.ts","../src/lib/Command.ts","../src/lib/Operation.ts","../src/lib/Type.ts","../src/lib/Option.ts","../src/lib/Positional.ts","../src/lib/Reader.ts","../src/lib/Usage.ts","../src/lib/Run.ts"],"sourcesContent":["export * from \"./lib/Command\";\nexport * from \"./lib/Operation\";\nexport * from \"./lib/Option\";\nexport * from \"./lib/Positional\";\nexport * from \"./lib/Reader\";\nexport * from \"./lib/Run\";\nexport * from \"./lib/Suggest\";\nexport * from \"./lib/Type\";\nexport * from \"./lib/Typo\";\nexport * from \"./lib/Usage\";\n","/**\n * Color names for terminal styling, used by {@link TypoStyle}.\n * `dark*` = standard ANSI (30–37); `bright*` = high-intensity (90–97).\n */\nexport type TypoColor =\n  | \"darkBlack\"\n  | \"darkRed\"\n  | \"darkGreen\"\n  | \"darkYellow\"\n  | \"darkBlue\"\n  | \"darkMagenta\"\n  | \"darkCyan\"\n  | \"darkWhite\"\n  | \"brightBlack\"\n  | \"brightRed\"\n  | \"brightGreen\"\n  | \"brightYellow\"\n  | \"brightBlue\"\n  | \"brightMagenta\"\n  | \"brightCyan\"\n  | \"brightWhite\";\n\n/**\n * Visual styling applied by a {@link TypoSupport} instance.\n * All fields are optional; ignored entirely in `\"none\"` mode.\n */\nexport type TypoStyle = {\n  /**\n   * Letter case.\n   */\n  case?: \"upper\" | \"lower\";\n  /**\n   * Foreground (text) color.\n   */\n  fgColor?: TypoColor;\n  /**\n   * Background color.\n   */\n  bgColor?: TypoColor;\n  /**\n   * Reduced intensity.\n   */\n  dim?: boolean;\n  /**\n   * Bold.\n   */\n  bold?: boolean;\n  /**\n   * Italic.\n   */\n  italic?: boolean;\n  /**\n   * Underline.\n   */\n  underline?: boolean;\n  /**\n   * Strikethrough.\n   */\n  strikethrough?: boolean;\n};\n\n/**\n * Section title style. Bold dark-green.\n */\nexport const typoStyleTitle: TypoStyle = {\n  fgColor: \"darkGreen\",\n  bold: true,\n};\n/**\n * Logic/type identifier style. Bold dark-magenta.\n */\nexport const typoStyleLogic: TypoStyle = {\n  fgColor: \"darkMagenta\",\n  bold: true,\n};\n/**\n * Quoted user-input style. Bold dark-yellow.\n */\nexport const typoStyleQuote: TypoStyle = {\n  fgColor: \"darkYellow\",\n  bold: true,\n};\n\n/**\n * Error label style. Bold dark-red.\n */\nexport const typoStyleFailure: TypoStyle = {\n  fgColor: \"darkRed\",\n  bold: true,\n};\n\n/**\n * Option/command name style. Bold dark-cyan.\n */\nexport const typoStyleConstants: TypoStyle = {\n  fgColor: \"darkCyan\",\n  bold: true,\n};\n/**\n * Positional/user-input label style. Bold dark-blue.\n */\nexport const typoStyleUserInput: TypoStyle = {\n  fgColor: \"darkBlue\",\n  bold: true,\n};\n\n/**\n * Strong text style. Bold.\n */\nexport const typoStyleRegularStrong: TypoStyle = {\n  bold: true,\n};\n/**\n * Subtle text style. Italic and dim.\n */\nexport const typoStyleRegularWeaker: TypoStyle = {\n  italic: true,\n  dim: true,\n};\n\n/**\n * Immutable styled string segment. Compose into a {@link TypoText}.\n */\nexport class TypoString {\n  #value: string;\n  #style: TypoStyle | undefined;\n  /**\n   * @param value - Raw text content.\n   * @param style - Style to apply when rendering.\n   */\n  constructor(value: string, style?: TypoStyle) {\n    this.#value = value;\n    this.#style = style;\n  }\n  /**\n   * Returns the text styled by `typoSupport`.\n   *\n   * @param typoSupport - Rendering mode.\n   */\n  computeStyledString(typoSupport: TypoSupport): string {\n    return typoSupport.computeStyledString(this.#value, this.#style);\n  }\n  /**\n   * Returns the raw text.\n   */\n  getRawString(): string {\n    // TODO - should there be a global config or smthg instead of passing support everywhere?\n    return this.#value;\n  }\n  /**\n   * Predefined ellipsis segment with subtle styling.\n   */\n  static elipsis = new TypoString(\"...\", typoStyleRegularWeaker);\n}\n\n/**\n * A segment of styled text, a string, or an array of segments.\n */\nexport type TypoSegment = TypoText | TypoString | Array<TypoSegment>;\n\n/**\n * Mutable sequence of {@link TypoString} segments.\n */\nexport class TypoText {\n  #strings: Array<TypoString>;\n  /**\n   * @param segments - Initial text segments\n   */\n  constructor(...segments: Array<TypoSegment>) {\n    this.#strings = [];\n    for (const segment of segments) {\n      this.push(segment);\n    }\n  }\n  /**\n   * Appends new text segment(s).\n   */\n  push(...segments: Array<TypoSegment>): void {\n    for (const segment of segments) {\n      if (typeof segment === \"string\") {\n        this.#strings.push(new TypoString(segment));\n      } else if (segment instanceof TypoString) {\n        this.#strings.push(segment);\n      } else if (segment instanceof TypoText) {\n        this.#strings.push(...segment.#strings);\n      } else if (Array.isArray(segment)) {\n        for (const part of segment) {\n          this.push(part);\n        }\n      }\n    }\n  }\n  /**\n   * Appends separated segments, optionally truncating with an ellipsis.\n   */\n  pushJoined(\n    segments: Array<TypoSegment>,\n    separator: TypoSegment,\n    ellipsisLimit: number,\n  ): void {\n    for (let index = 0; index < segments.length; index++) {\n      if (index > 0) {\n        this.push(separator);\n      }\n      if (ellipsisLimit !== undefined && index >= ellipsisLimit) {\n        this.push(TypoString.elipsis);\n        break;\n      }\n      this.push(segments[index]!);\n    }\n  }\n  /**\n   * Renders all segments into a single styled string.\n   *\n   * @param typoSupport - Rendering mode.\n   * @returns Concatenated styled string.\n   */\n  computeStyledString(typoSupport: TypoSupport): string {\n    return this.#strings\n      .map((t) => t.computeStyledString(typoSupport))\n      .join(\"\");\n  }\n  /**\n   * Returns the concatenated raw text.\n   */\n  computeRawString(): string {\n    return this.#strings.map((t) => t.getRawString()).join(\"\");\n  }\n  /**\n   * Returns the total raw character count.\n   */\n  computeRawLength(): number {\n    let length = 0;\n    for (const typoString of this.#strings) {\n      length += typoString.getRawString().length;\n    }\n    return length;\n  }\n}\n\n/**\n * Column-aligned grid of {@link TypoText} cells.\n * Each column is padded to the widest cell (raw chars); the last column is not padded.\n */\nexport class TypoGrid {\n  #typoRows: Array<Array<TypoText>>;\n  constructor() {\n    this.#typoRows = [];\n  }\n  /**\n   * Appends a row. All rows should have the same cell count.\n   *\n   * @param cells - Ordered {@link TypoText} cells.\n   */\n  pushRow(cells: Array<TypoText>) {\n    this.#typoRows.push(cells);\n  }\n  /**\n   * Renders as an array of styled, column-padded strings.\n   *\n   * @param typoSupport - Rendering mode.\n   * @returns Array of styled strings.\n   */\n  computeStyledLines(typoSupport: TypoSupport): Array<string> {\n    const widths = new Array<number>();\n    const styledLines = new Array<string>();\n    for (const typoGridRow of this.#typoRows) {\n      for (\n        let typoGridColumnIndex = 0;\n        typoGridColumnIndex < typoGridRow.length;\n        typoGridColumnIndex++\n      ) {\n        const typoGridCell = typoGridRow[typoGridColumnIndex]!;\n        const width = typoGridCell.computeRawLength();\n        if (\n          widths[typoGridColumnIndex] === undefined ||\n          width > widths[typoGridColumnIndex]!\n        ) {\n          widths[typoGridColumnIndex] = width;\n        }\n      }\n    }\n    for (const typoGridRow of this.#typoRows) {\n      const styledGridRow = new Array<string>();\n      for (\n        let typoGridColumnIndex = 0;\n        typoGridColumnIndex < typoGridRow.length;\n        typoGridColumnIndex++\n      ) {\n        const typoGridCell = typoGridRow[typoGridColumnIndex]!;\n        styledGridRow.push(typoGridCell.computeStyledString(typoSupport));\n        if (typoGridColumnIndex < typoGridRow.length - 1) {\n          const width = typoGridCell.computeRawLength();\n          const padding = \" \".repeat(widths[typoGridColumnIndex]! - width);\n          styledGridRow.push(padding);\n        }\n      }\n      styledLines.push(styledGridRow.join(\"\"));\n    }\n    return styledLines;\n  }\n}\n\n/**\n * `Error` subclass with a {@link TypoText} styled message for rich terminal output.\n * Chains `TypoError` sources after `\": \"`.\n */\nexport class TypoError extends Error {\n  #typoText: TypoText;\n  /**\n   * @param currentTypoText - Styled message for this error.\n   * @param source - Optional cause; `TypoError` chains styled text, `Error` appends `.message`, else `String()`.\n   */\n  constructor(currentTypoText: TypoText, source?: unknown) {\n    const typoText = new TypoText();\n    typoText.push(currentTypoText);\n    if (source instanceof TypoError) {\n      typoText.push(new TypoString(\": \"));\n      typoText.push(source.#typoText);\n    } else if (source instanceof Error) {\n      typoText.push(new TypoString(`: ${source.message}`));\n    } else if (source !== undefined) {\n      typoText.push(new TypoString(`: ${String(source)}`));\n    }\n    super(typoText.computeRawString());\n    this.#typoText = typoText;\n  }\n  /**\n   * Renders the styled message (without `\"Error:\"` prefix).\n   *\n   * @param typoSupport - Rendering mode.\n   * @returns Styled error string.\n   */\n  computeStyledString(typoSupport: TypoSupport): string {\n    return this.#typoText.computeStyledString(typoSupport);\n  }\n  /**\n   * Runs `thrower`; wraps any thrown error as a `TypoError` with `context()` prepended.\n   *\n   * @typeParam Value - Return type of `thrower`.\n   * @param thrower - Function to execute; result passed through on success.\n   * @param context - Produces the {@link TypoText} prepended to the caught error.\n   * @returns Value from `thrower`.\n   * @throws `TypoError` wrapping the original error with context prepended.\n   */\n  static tryWithContext<Value>(\n    thrower: () => Value,\n    context: () => TypoText,\n  ): Value {\n    try {\n      return thrower();\n    } catch (error) {\n      throw new TypoError(context(), error);\n    }\n  }\n}\n\n/**\n * Controls ANSI terminal styling. Create via the static factory methods.\n */\nexport class TypoSupport {\n  #kind: TypoSupportKind;\n  private constructor(kind: TypoSupportKind) {\n    this.#kind = kind;\n  }\n  /**\n   * Plain text — no ANSI codes.\n   */\n  static none(): TypoSupport {\n    return new TypoSupport(\"none\");\n  }\n  /**\n   * ANSI escape codes for color terminals.\n   */\n  static tty(): TypoSupport {\n    return new TypoSupport(\"tty\");\n  }\n  /**\n   * Deterministic textual styling for snapshot tests.\n   */\n  static mock(): TypoSupport {\n    return new TypoSupport(\"mock\");\n  }\n  /**\n   * Auto-detects styling mode from the process environment on best-effort basis.\n   */\n  static inferFromEnv(): TypoSupport {\n    if (!process || !process.env || !process.stdout) {\n      return TypoSupport.none();\n    }\n    if (readEnvVar(\"NO_COLOR\")) {\n      return TypoSupport.none();\n    }\n    const envForceColor = readEnvVar(\"FORCE_COLOR\");\n    if (envForceColor === \"0\") {\n      return TypoSupport.none();\n    }\n    if (envForceColor === \"1\") {\n      return TypoSupport.tty();\n    }\n    if (envForceColor === \"2\") {\n      return TypoSupport.tty();\n    }\n    if (envForceColor === \"3\") {\n      return TypoSupport.tty();\n    }\n    if (envForceColor) {\n      return TypoSupport.tty();\n    }\n    if (!process.stdout.isTTY) {\n      return TypoSupport.none();\n    }\n    if (readEnvVar(\"TERM\")?.toLowerCase() === \"dumb\") {\n      return TypoSupport.none();\n    }\n    return TypoSupport.tty();\n  }\n  /**\n   * Applies `typoStyle` to `value` according to the current mode.\n   *\n   * @param value - Raw text.\n   * @param typoStyle - Style to apply.\n   * @returns Styled string.\n   */\n  computeStyledString(value: string, typoStyle: TypoStyle | undefined): string {\n    if (typoStyle === undefined) {\n      return value;\n    }\n    let styledValue = value;\n    if (typoStyle.case === \"upper\") {\n      styledValue = styledValue.toUpperCase();\n    }\n    if (typoStyle.case === \"lower\") {\n      styledValue = styledValue.toLowerCase();\n    }\n    if (this.#kind === \"none\") {\n      return styledValue;\n    }\n    if (this.#kind === \"tty\") {\n      const fgColorCode = typoStyle.fgColor\n        ? ttyCodeFgColors[typoStyle.fgColor]\n        : \"\";\n      const bgColorCode = typoStyle.bgColor\n        ? ttyCodeBgColors[typoStyle.bgColor]\n        : \"\";\n      const boldCode = typoStyle.bold ? ttyCodeBold : \"\";\n      const dimCode = typoStyle.dim ? ttyCodeDim : \"\";\n      const italicCode = typoStyle.italic ? ttyCodeItalic : \"\";\n      const underlineCode = typoStyle.underline ? ttyCodeUnderline : \"\";\n      const strikethroughCode = typoStyle.strikethrough\n        ? ttyCodeStrikethrough\n        : \"\";\n      return `${fgColorCode}${bgColorCode}${boldCode}${dimCode}${italicCode}${underlineCode}${strikethroughCode}${styledValue}${ttyCodeReset}`;\n    }\n    if (this.#kind === \"mock\") {\n      const fgColorPart = typoStyle.fgColor\n        ? `{${styledValue}}@${typoStyle.fgColor}`\n        : styledValue;\n      const bgColorPart = typoStyle.bgColor\n        ? `{${fgColorPart}}#${typoStyle.bgColor}`\n        : fgColorPart;\n      const boldPart = typoStyle.bold ? `{${bgColorPart}}+` : bgColorPart;\n      const dimPart = typoStyle.dim ? `{${boldPart}}-` : boldPart;\n      const italicPart = typoStyle.italic ? `{${dimPart}}*` : dimPart;\n      const underlinePart = typoStyle.underline\n        ? `{${italicPart}}_`\n        : italicPart;\n      const strikethroughPart = typoStyle.strikethrough\n        ? `{${underlinePart}}~`\n        : underlinePart;\n      return strikethroughPart;\n    }\n    throw new Error(`Unknown TypoSupport kind: ${this.#kind}`);\n  }\n  /**\n   * Formats any thrown value as `\"Error: <message>\"` with {@link typoStyleFailure} on the prefix.\n   *\n   * @param error - Any thrown value.\n   * @returns Styled error string.\n   */\n  computeStyledErrorMessage(error: unknown): string {\n    return [\n      this.computeStyledString(\"Error:\", typoStyleFailure),\n      error instanceof TypoError\n        ? error.computeStyledString(this)\n        : error instanceof Error\n          ? error.message\n          : String(error),\n    ].join(\" \");\n  }\n}\n\nconst ttyCodeReset = \"\\x1b[0m\";\nconst ttyCodeBold = \"\\x1b[1m\";\nconst ttyCodeDim = \"\\x1b[2m\";\nconst ttyCodeItalic = \"\\x1b[3m\";\nconst ttyCodeUnderline = \"\\x1b[4m\";\nconst ttyCodeStrikethrough = \"\\x1b[9m\";\nconst ttyCodeFgColors: Record<TypoColor, string> = {\n  darkBlack: \"\\x1b[30m\",\n  darkRed: \"\\x1b[31m\",\n  darkGreen: \"\\x1b[32m\",\n  darkYellow: \"\\x1b[33m\",\n  darkBlue: \"\\x1b[34m\",\n  darkMagenta: \"\\x1b[35m\",\n  darkCyan: \"\\x1b[36m\",\n  darkWhite: \"\\x1b[37m\",\n  brightBlack: \"\\x1b[90m\",\n  brightRed: \"\\x1b[91m\",\n  brightGreen: \"\\x1b[92m\",\n  brightYellow: \"\\x1b[93m\",\n  brightBlue: \"\\x1b[94m\",\n  brightMagenta: \"\\x1b[95m\",\n  brightCyan: \"\\x1b[96m\",\n  brightWhite: \"\\x1b[97m\",\n};\nconst ttyCodeBgColors: Record<TypoColor, string> = {\n  darkBlack: \"\\x1b[40m\",\n  darkRed: \"\\x1b[41m\",\n  darkGreen: \"\\x1b[42m\",\n  darkYellow: \"\\x1b[43m\",\n  darkBlue: \"\\x1b[44m\",\n  darkMagenta: \"\\x1b[45m\",\n  darkCyan: \"\\x1b[46m\",\n  darkWhite: \"\\x1b[47m\",\n  brightBlack: \"\\x1b[100m\",\n  brightRed: \"\\x1b[101m\",\n  brightGreen: \"\\x1b[102m\",\n  brightYellow: \"\\x1b[103m\",\n  brightBlue: \"\\x1b[104m\",\n  brightMagenta: \"\\x1b[105m\",\n  brightCyan: \"\\x1b[106m\",\n  brightWhite: \"\\x1b[107m\",\n};\n\nfunction readEnvVar(name: string) {\n  if (!(name in process.env)) {\n    return undefined;\n  }\n  return process.env[name];\n}\n\ntype TypoSupportKind = \"none\" | \"tty\" | \"mock\";\n","import { TypoSegment, TypoString, TypoText } from \"./Typo\";\n\nexport function suggestTextPushMessage(\n  text: TypoText,\n  query: string,\n  candidates: Array<{ reference: string; hint: TypoSegment }>,\n) {\n  const reasonableHints = suggestReasonablePayloads(\n    query,\n    candidates.map(({ reference, hint }) => ({ reference, payload: hint })),\n  );\n  if (reasonableHints.length === 0) {\n    return;\n  }\n  text.push(new TypoString(\" Did you mean: \"));\n  text.pushJoined(reasonableHints, new TypoString(\", \"), 3);\n  text.push(new TypoString(` ?`));\n}\n\nfunction suggestReasonablePayloads<Payload>(\n  query: string,\n  candidates: Array<{ reference: string; payload: Payload }>,\n): Array<Payload> {\n  if (candidates.length === 0) {\n    return [];\n  }\n  const sortedAlternatives = computeAndSortByDivergences(query, candidates);\n  const divergenceThreshold = sortedAlternatives[0]!.divergence + 0.25;\n  const acceptablePayloads = new Array<Payload>();\n  for (const { divergence, payload } of sortedAlternatives) {\n    if (divergence > divergenceThreshold) {\n      break;\n    }\n    acceptablePayloads.push(payload);\n  }\n  return acceptablePayloads;\n}\n\nfunction computeAndSortByDivergences<Payload>(\n  query: string,\n  candidates: Array<{ reference: string; payload: Payload }>,\n): Array<{ divergence: number; payload: Payload }> {\n  const queryNormalized = query.toLowerCase().slice(0, 100);\n  const scored = candidates.map(({ reference, payload }) => {\n    const referenceNormalized = reference.toLowerCase().slice(0, 100);\n    const divergence =\n      distanceDamerauLevenshtein(queryNormalized, referenceNormalized) /\n      Math.max(queryNormalized.length, referenceNormalized.length);\n    return { divergence, reference, payload };\n  });\n  return scored.sort((a, b) => a.divergence - b.divergence);\n}\n\nfunction distanceDamerauLevenshtein(a: string, b: string): number {\n  const m = a.length;\n  const n = b.length;\n  const dp = Array.from({ length: m + 1 }, () => Array<number>(n + 1).fill(0));\n  for (let i = 0; i <= m; i++) {\n    dp[i]![0] = i;\n  }\n  for (let j = 0; j <= n; j++) {\n    dp[0]![j] = j;\n  }\n  for (let i = 1; i <= m; i++) {\n    for (let j = 1; j <= n; j++) {\n      const cost = a[i - 1] === b[j - 1] ? 0 : 1;\n      dp[i]![j] = Math.min(\n        dp[i - 1]![j]! + 1,\n        dp[i]![j - 1]! + 1,\n        dp[i - 1]![j - 1]! + cost,\n      );\n      if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {\n        dp[i]![j] = Math.min(dp[i]![j]!, dp[i - 2]![j - 2]! + cost);\n      }\n    }\n  }\n  return dp[m]![n]!;\n}\n","import { Operation } from \"./Operation\";\nimport { ReaderArgs } from \"./Reader\";\nimport { suggestTextPushMessage } from \"./Suggest\";\nimport {\n  TypoError,\n  TypoString,\n  typoStyleConstants,\n  typoStyleQuote,\n  typoStyleUserInput,\n  TypoText,\n} from \"./Typo\";\nimport { UsageCommand } from \"./Usage\";\n\n/**\n * A CLI command. Created with {@link command}, {@link commandWithSubcommands}, or {@link commandChained}.\n *\n * @typeParam Context - Injected at execution; forwarded to handlers.\n * @typeParam Result - Produced on execution; typically `void`.\n */\nexport type Command<Context, Result = void> = {\n  /**\n   * Returns static metadata.\n   */\n  getInformation(): CommandInformation;\n  /**\n   * Registers options/positionals on `readerArgs`; returns a {@link CommandDecoder}.\n   */\n  consumeAndMakeDecoder(\n    readerArgs: ReaderArgs,\n  ): CommandDecoder<Context, Result>;\n};\n\n/**\n * Produced by {@link Command.consumeAndMakeDecoder}.\n *\n * @typeParam Context - See {@link Command}.\n * @typeParam Result - See {@link Command}.\n */\nexport type CommandDecoder<Context, Result> = {\n  /**\n   * Returns {@link UsageCommand} for the current command path.\n   */\n  generateUsage(): UsageCommand;\n  /**\n   * Creates a ready-to-execute {@link CommandInterpreter}.\n   *\n   * @throws if parsing or decoding failed.\n   */\n  decodeAndMakeInterpreter(): CommandInterpreter<Context, Result>;\n};\n\n/**\n * A fully parsed, decoded and ready-to-execute command.\n *\n * @typeParam Context - Context passed to the handler.\n * @typeParam Result - Value produced on success.\n */\nexport type CommandInterpreter<Context, Result> = {\n  /**\n   * Executes with the provided context.\n   */\n  executeWithContext(context: Context): Promise<Result>;\n};\n\n/**\n * Command metadata shown in `--help` output.\n */\nexport type CommandInformation = {\n  /**\n   * Shown in the usage header.\n   */\n  description: string;\n  /**\n   * Shown in parentheses, e.g. `\"deprecated\"`, `\"experimental\"`.\n   */\n  hint?: string;\n  /**\n   * Extra lines printed below the description.\n   */\n  details?: Array<string>;\n  /**\n   * Shown in the `Examples:` section.\n   */\n  examples?: Array<{\n    // TODO - a nicer example system, maybe with --help=example support\n    /**\n     * Explanation shown above the example.\n     */\n    explanation: string;\n    /**\n     * Example command args.\n     */\n    commandArgs: Array<\n      | string\n      | { positional: string }\n      | { subcommand: string }\n      | {\n          option:\n            | { long: string; inlined?: string; separated?: Array<string> }\n            | { short: string; inlined?: string; separated?: Array<string> };\n        }\n    >;\n  }>;\n};\n\n/**\n * Creates a leaf command that directly executes an {@link Operation}.\n *\n * @typeParam Context - Context forwarded to the handler.\n * @typeParam Result - Value returned by the handler.\n *\n * @param information - Command metadata.\n * @param operation - Options, positionals, and handler.\n * @returns A {@link Command}.\n *\n * @example\n * ```ts\n * const greet = command(\n *   { description: \"Greet a user\" },\n *   operation(\n *     { positionals: [positionalRequired({ type: type(\"name\") })] },\n *     async (_ctx, { positionals: [name] }) => console.log(`Hello, ${name}!`),\n *   ),\n * );\n * ```\n */\nexport function command<Context, Result = void>(\n  information: CommandInformation,\n  operation: Operation<Context, Result>,\n): Command<Context, Result> {\n  return {\n    getInformation() {\n      return information;\n    },\n    consumeAndMakeDecoder(readerArgs: ReaderArgs) {\n      try {\n        const operationDecoder = operation.consumeAndMakeDecoder(readerArgs);\n        const endPositional = readerArgs.consumePositional();\n        if (endPositional !== undefined) {\n          const errorText = new TypoText();\n          errorText.push(new TypoString(`Unexpected argument: `));\n          errorText.push(new TypoString(`\"${endPositional}\"`, typoStyleQuote));\n          errorText.push(new TypoString(`.`));\n          throw new TypoError(errorText);\n        }\n        return {\n          generateUsage: () => generateUsageLeaf(information, operation),\n          decodeAndMakeInterpreter() {\n            const operationInterpreter =\n              operationDecoder.decodeAndMakeInterpreter();\n            return {\n              async executeWithContext(context: Context) {\n                return await operationInterpreter.executeWithContext(context);\n              },\n            };\n          },\n        };\n      } catch (error) {\n        return {\n          generateUsage: () => generateUsageLeaf(information, operation),\n          decodeAndMakeInterpreter() {\n            throw error;\n          },\n        };\n      }\n    },\n  };\n}\n\n/**\n * Creates a command that runs `operation` first,\n * then dispatches result to a named subcommand.\n *\n * @typeParam Context - Context accepted by `operation`.\n * @typeParam Payload - Output of `operation`; becomes the subcommand's context.\n * @typeParam Result - Value produced by the selected subcommand.\n *\n * @param information - Command metadata.\n * @param operation - Runs first; output becomes the subcommand's context.\n * @param subcommands - Map of subcommand names to their {@link Command}s.\n * @returns A dispatching {@link Command}.\n *\n * @example\n * ```ts\n * const rootCmd = commandWithSubcommands(\n *   { description: \"My CLI\" },\n *   operation({ options: {}, positionals: [] }, async (ctx) => ctx),\n *   {\n *     deploy: command({ description: \"Deploy\" }, deployOperation),\n *     rollback: command({ description: \"Rollback\" }, rollbackOperation),\n *   },\n * );\n * ```\n */\nexport function commandWithSubcommands<Context, Payload, Result = void>(\n  information: CommandInformation,\n  operation: Operation<Context, Payload>,\n  subcommands: { [subcommand: string]: Command<Payload, Result> },\n): Command<Context, Result> {\n  const subcommandNames = Object.keys(subcommands);\n  if (subcommandNames.length === 0) {\n    throw new Error(\"At least one subcommand is required\");\n  }\n  for (const name of subcommandNames) {\n    if (name.startsWith(\"-\")) {\n      throw new Error(`Subcommand name \"${name}\" cannot start with \"-\".`);\n    }\n  }\n  return {\n    getInformation() {\n      return information;\n    },\n    consumeAndMakeDecoder(readerArgs: ReaderArgs) {\n      try {\n        const operationDecoder = operation.consumeAndMakeDecoder(readerArgs);\n        const subcommandName = readerArgs.consumePositional();\n        if (subcommandName === undefined) {\n          const errorText = new TypoText();\n          errorText.push(new TypoString(`Missing argument: `));\n          errorText.push(new TypoString(`<subcommand>`, typoStyleUserInput));\n          errorText.push(new TypoString(`.`));\n          suggestSubcommandNames(errorText, \"\", subcommandNames);\n          throw new TypoError(errorText);\n        }\n        const subcommandInput = subcommands[subcommandName];\n        if (subcommandInput === undefined) {\n          const errorText = new TypoText();\n          errorText.push(new TypoString(`<subcommand>`, typoStyleUserInput));\n          errorText.push(new TypoString(`: Unknown name: `));\n          errorText.push(new TypoString(`\"${subcommandName}\"`, typoStyleQuote));\n          errorText.push(new TypoString(`.`));\n          suggestSubcommandNames(errorText, subcommandName, subcommandNames);\n          throw new TypoError(errorText);\n        }\n        const subcommandDecoder =\n          subcommandInput.consumeAndMakeDecoder(readerArgs);\n        return {\n          generateUsage() {\n            const subcommandUsage = subcommandDecoder.generateUsage();\n            const currentUsage = generateUsageLeaf(information, operation);\n            currentUsage.segments.push({ subcommand: subcommandName });\n            currentUsage.segments.push(...subcommandUsage.segments);\n            currentUsage.information = subcommandUsage.information;\n            currentUsage.positionals.push(...subcommandUsage.positionals);\n            currentUsage.subcommands = subcommandUsage.subcommands;\n            currentUsage.options.push(...subcommandUsage.options);\n            return currentUsage;\n          },\n          decodeAndMakeInterpreter() {\n            const operationInterpreter =\n              operationDecoder.decodeAndMakeInterpreter();\n            const subcommandInterpreter =\n              subcommandDecoder.decodeAndMakeInterpreter();\n            return {\n              async executeWithContext(context: Context) {\n                return await subcommandInterpreter.executeWithContext(\n                  await operationInterpreter.executeWithContext(context),\n                );\n              },\n            };\n          },\n        };\n      } catch (error) {\n        return {\n          generateUsage() {\n            const currentUsage = generateUsageLeaf(information, operation);\n            currentUsage.segments.push({ positional: \"<subcommand>\" });\n            for (const [name, subcommand] of Object.entries(subcommands)) {\n              const { description, hint } = subcommand.getInformation();\n              currentUsage.subcommands.push({ name, description, hint });\n            }\n            return currentUsage;\n          },\n          decodeAndMakeInterpreter() {\n            throw error;\n          },\n        };\n      }\n    },\n  };\n}\n\n/**\n * Chains an {@link Operation} and a {@link Command}: `operation` runs first,\n * its output becomes `subcommand`'s context. No token is consumed for routing.\n *\n * @typeParam Context - Context accepted by `operation`.\n * @typeParam Payload - Output of `operation`; becomes `subcommand`'s context.\n * @typeParam Result - Value produced by `subcommand`.\n *\n * @param information - Command metadata.\n * @param operation - Runs first; output becomes `subcommand`'s context.\n * @param subcommand - Runs after `operation`.\n * @returns A {@link Command} composing both stages.\n */\nexport function commandChained<Context, Payload, Result = void>(\n  information: CommandInformation,\n  operation: Operation<Context, Payload>,\n  subcommand: Command<Payload, Result>,\n): Command<Context, Result> {\n  return {\n    getInformation() {\n      return information;\n    },\n    consumeAndMakeDecoder(readerArgs: ReaderArgs) {\n      try {\n        const operationDecoder = operation.consumeAndMakeDecoder(readerArgs);\n        const subcommandDecoder = subcommand.consumeAndMakeDecoder(readerArgs);\n        return {\n          generateUsage() {\n            const subcommandUsage = subcommandDecoder.generateUsage();\n            const currentUsage = generateUsageLeaf(information, operation);\n            currentUsage.segments.push(...subcommandUsage.segments);\n            currentUsage.information = subcommandUsage.information;\n            currentUsage.positionals.push(...subcommandUsage.positionals);\n            currentUsage.subcommands = subcommandUsage.subcommands;\n            currentUsage.options.push(...subcommandUsage.options);\n            return currentUsage;\n          },\n          decodeAndMakeInterpreter() {\n            const operationInterpreter =\n              operationDecoder.decodeAndMakeInterpreter();\n            const subcommandInterpreter =\n              subcommandDecoder.decodeAndMakeInterpreter();\n            return {\n              async executeWithContext(context: Context) {\n                return await subcommandInterpreter.executeWithContext(\n                  await operationInterpreter.executeWithContext(context),\n                );\n              },\n            };\n          },\n        };\n      } catch (error) {\n        return {\n          generateUsage() {\n            const currentUsage = generateUsageLeaf(information, operation);\n            currentUsage.segments.push({ positional: \"[REST]...\" });\n            return currentUsage;\n          },\n          decodeAndMakeInterpreter() {\n            throw error;\n          },\n        };\n      }\n    },\n  };\n}\n\nfunction generateUsageLeaf(\n  information: CommandInformation,\n  operation: Operation<any, any>,\n): UsageCommand {\n  const { positionals, options } = operation.generateUsage();\n  return {\n    segments: positionals.map((p) => ({ positional: p.label })),\n    information,\n    positionals,\n    subcommands: [],\n    options,\n  };\n}\n\nfunction suggestSubcommandNames(\n  errorText: TypoText,\n  input: string,\n  subcommandNames: Array<string> = [],\n) {\n  suggestTextPushMessage(\n    errorText,\n    input,\n    subcommandNames.map((subcommandName) => ({\n      reference: subcommandName,\n      hint: new TypoString(subcommandName, typoStyleConstants),\n    })),\n  );\n}\n","import { Option, OptionDecoder } from \"./Option\";\nimport { Positional, PositionalDecoder } from \"./Positional\";\nimport { ReaderArgs } from \"./Reader\";\nimport { UsageOption, UsagePositional } from \"./Usage\";\n\n/**\n * Options, positionals, and an async handler that together form the logic of a CLI command.\n *\n * Created with {@link operation} and passed to {@link command},\n * {@link commandWithSubcommands}, or {@link commandChained}.\n *\n * @typeParam Context - Injected at execution; forwarded to handlers.\n * @typeParam Result - Value produced on execution; typically `void`.\n */\nexport type Operation<Context, Result = void> = {\n  /**\n   * Returns usage metadata without consuming any arguments.\n   */\n  generateUsage(): {\n    /**\n     * Registered options.\n     */\n    options: Array<UsageOption>;\n    /**\n     * Declared positionals, in order.\n     */\n    positionals: Array<UsagePositional>;\n  };\n  /**\n   * Consumes args from `readerArgs` and returns an {@link OperationDecoder}.\n   */\n  consumeAndMakeDecoder(\n    readerArgs: ReaderArgs,\n  ): OperationDecoder<Context, Result>;\n};\n\n/**\n * Produced by {@link Operation.consumeAndMakeDecoder}.\n *\n * @typeParam Context - See {@link Operation}.\n * @typeParam Result - See {@link Operation}.\n */\nexport type OperationDecoder<Context, Result> = {\n  /**\n   * Creates a ready-to-execute {@link OperationInterpreter}.\n   *\n   * @throws if parsing or decoding failed.\n   */\n  decodeAndMakeInterpreter(): OperationInterpreter<Context, Result>;\n};\n\n/**\n * A fully parsed, decoded and ready-to-execute operation.\n *\n * @typeParam Context - Caller-supplied context.\n * @typeParam Result - Value produced on success.\n */\nexport type OperationInterpreter<Context, Result> = {\n  /**\n   * Executes with the provided context.\n   */\n  executeWithContext(context: Context): Promise<Result>;\n};\n\n/**\n * Creates an {@link Operation} from options, positionals, and an async handler.\n *\n * The `handler` receives `context` and `inputs` with decoded `options` and `positionals`.\n *\n * @typeParam Context - Context type accepted by the handler.\n * @typeParam Result - Return type of the handler.\n * @typeParam Options - Map of option keys to parsed value types.\n * @typeParam Positionals - Tuple of parsed positional value types, in order.\n *\n * @param inputs - Options and positionals this operation accepts.\n * @param inputs.options - Map of keys to {@link Option} descriptors.\n * @param inputs.positionals - Ordered array of {@link Positional} descriptors.\n * @param handler - Async function implementing the command logic.\n * @returns An {@link Operation}.\n *\n * @example\n * ```ts\n * const greetOperation = operation(\n *   {\n *     options: {\n *       loud: optionFlag({ long: \"loud\", description: \"Print in uppercase\" }),\n *     },\n *     positionals: [\n *       positionalRequired({ type: type(\"name\"), description: \"Name to greet\" }),\n *     ],\n *   },\n *   async function (_ctx, { options: { loud }, positionals: [name] }) {\n *     const message = `Hello, ${name}!`;\n *     console.log(loud ? message.toUpperCase() : message);\n *   },\n * );\n * ```\n */\nexport function operation<\n  Context,\n  Result,\n  const Options extends { [option: string]: any } = {},\n  const Positionals extends Array<any> = [],\n>(\n  inputs: {\n    options?: { [K in keyof Options]: Option<Options[K]> };\n    positionals?: { [K in keyof Positionals]: Positional<Positionals[K]> };\n  },\n  handler: (\n    context: Context,\n    inputs: {\n      options: { [K in keyof Options]: Options[K] };\n      positionals: { [K in keyof Positionals]: Positionals[K] };\n    },\n  ) => Promise<Result>,\n): Operation<Context, Result> {\n  return {\n    generateUsage() {\n      const optionsUsage = new Array<UsageOption>();\n      if (inputs.options !== undefined) {\n        for (const optionKey in inputs.options) {\n          const optionInput = inputs.options[optionKey]!;\n          optionsUsage.push(optionInput.generateUsage());\n        }\n      }\n      const positionalsUsage = new Array<UsagePositional>();\n      if (inputs.positionals !== undefined) {\n        for (const positionalInput of inputs.positionals) {\n          positionalsUsage.push(positionalInput.generateUsage());\n        }\n      }\n      return { options: optionsUsage, positionals: positionalsUsage };\n    },\n    consumeAndMakeDecoder(readerArgs: ReaderArgs) {\n      const optionsDecoders = {} as {\n        [K in keyof Options]: OptionDecoder<Options[K]>;\n      };\n      if (inputs.options !== undefined) {\n        for (const optionKey in inputs.options) {\n          const optionInput = inputs.options[optionKey]!;\n          optionsDecoders[optionKey] =\n            optionInput.registerAndMakeDecoder(readerArgs);\n        }\n      }\n      const positionalsDecoders = [] as {\n        [K in keyof Positionals]: PositionalDecoder<Positionals[K]>;\n      };\n      if (inputs.positionals !== undefined) {\n        for (const positionalInput of inputs.positionals) {\n          positionalsDecoders.push(\n            positionalInput.consumeAndMakeDecoder(readerArgs),\n          );\n        }\n      }\n      return {\n        decodeAndMakeInterpreter() {\n          const optionsValues = {} as {\n            [K in keyof Options]: Options[K];\n          };\n          for (const optionKey in optionsDecoders) {\n            optionsValues[optionKey] =\n              optionsDecoders[optionKey]!.getAndDecodeValue();\n          }\n          const positionalsValues = [] as {\n            [K in keyof Positionals]: Positionals[K];\n          };\n          for (const positionalDecoder of positionalsDecoders) {\n            positionalsValues.push(positionalDecoder.decodeValue());\n          }\n          return {\n            executeWithContext(context: Context) {\n              return handler(context, {\n                options: optionsValues,\n                positionals: positionalsValues,\n              });\n            },\n          };\n        },\n      };\n    },\n  };\n}\n","import { statSync } from \"fs\";\nimport { suggestTextPushMessage } from \"./Suggest\";\nimport {\n  TypoError,\n  TypoString,\n  typoStyleLogic,\n  typoStyleQuote,\n  TypoText,\n} from \"./Typo\";\n\n/**\n * Decodes a raw CLI string into a typed value.\n * A pair of a human-readable `content` name and a `decoder` function.\n *\n * Primitive Types:\n * - {@link typeString}\n * - {@link typeBoolean}\n * - {@link typeNumber},\n * - {@link typeInteger}\n * - {@link typeDatetime}\n * - {@link typeUrl}\n * - {@link typePath}\n * - {@link typeChoice}\n *\n * Composed Types:\n * - {@link typeMapped}\n * - {@link typeTuple}\n * - {@link typeList}\n *\n * @typeParam Value - Type produced by the decoder.\n */\nexport type Type<Value> = {\n  /**\n   * Human-readable name shown in help and errors (e.g. `\"name\"`, `\"context\"`).\n   */\n  content: string; // TODO - add an enforcement mechanism for casing ?\n  /**\n   * Decodes a raw CLI string into `Value`.\n   *\n   * @param input - Raw string from the command line.\n   * @returns The decoded value.\n   * @throws on invalid input.\n   */\n  decoder(input: string): Value;\n};\n\n/**\n * A named type that accepts any string as input.\n * @param name - Name shown in help and errors (e.g. `\"my-value\"`).\n * @example\n * ```ts\n * typeString(\"greeting\").decoder(\"hello\") // → \"hello\"\n * typeString(\"greeting\").decoder(\"\")      // → \"\"\n * ```\n */\nexport function typeString(name?: string): Type<string> {\n  return {\n    content: name ?? \"string\",\n    decoder: (input: string) => input,\n  };\n}\n\n/**\n * Decodes a string to `boolean` (case-insensitive).\n * Used by {@link optionFlag} for `--flag=<value>`.\n *\n * @example\n * ```ts\n * typeBoolean(\"flag\").decoder(\"true\")  // → true\n * typeBoolean(\"flag\").decoder(\"yes\")   // → true\n * typeBoolean(\"flag\").decoder(\"Y\")     // → true\n * typeBoolean(\"flag\").decoder(\"FALSE\") // → false\n * typeBoolean(\"flag\").decoder(\"NO\")    // → false\n * typeBoolean(\"flag\").decoder(\"n\")     // → false\n * typeBoolean(\"flag\").decoder(\"maybe\") // throws\n * ```\n */\nexport function typeBoolean(name?: string): Type<boolean> {\n  return {\n    content: name ?? \"boolean\",\n    decoder(input: string) {\n      const lowerInput = input.toLowerCase();\n      if (typeBooleanValuesTrue.has(lowerInput)) {\n        return true;\n      }\n      if (typeBooleanValuesFalse.has(lowerInput)) {\n        return false;\n      }\n      throwInvalidValue(\"a boolean\", input);\n    },\n  };\n}\n\n/**\n * Parses a string to `number` via `Number()`; `NaN` throws.\n *\n * @example\n * ```ts\n * typeNumber(\"my-number\").decoder(\"3.14\")  // → 3.14\n * typeNumber(\"my-number\").decoder(\"-1\")    // → -1\n * typeNumber(\"my-number\").decoder(\"hello\") // throws\n * ```\n */\nexport function typeNumber(name?: string): Type<number> {\n  return {\n    content: name ?? \"number\",\n    decoder(input: string) {\n      try {\n        const parsed = Number(input);\n        if (isNaN(parsed)) {\n          throw new Error();\n        }\n        return parsed;\n      } catch {\n        throwInvalidValue(\"a number\", input);\n      }\n    },\n  };\n}\n\n/**\n * Parses an integer string to `bigint` via `BigInt()`.\n * Floats and non-numeric strings throws.\n *\n * @example\n * ```ts\n * typeInteger(\"my-integer\").decoder(\"42\")   // → 42n\n * typeInteger(\"my-integer\").decoder(\"3.14\") // throws\n * typeInteger(\"my-integer\").decoder(\"abc\")  // throws\n * ```\n */\nexport function typeInteger(name?: string): Type<bigint> {\n  return {\n    content: name ?? \"integer\",\n    decoder(input: string) {\n      try {\n        return BigInt(input);\n      } catch {\n        throwInvalidValue(\"an integer\", input);\n      }\n    },\n  };\n}\n\n/**\n * Parses a date/time string via `Date.parse`.\n * Accepts any format supported by `Date.parse`, including ISO 8601.\n *\n * @example\n * ```ts\n * typeDatetime(\"start\").decoder(\"2024-01-15\") // → Date object for 2024-01-15\n * typeDatetime(\"start\").decoder(\"2024-01-15T13:45:30Z\") // → Date object for 2024-01-15 13:45:30 UTC\n * typeDatetime(\"start\").decoder(\"not a date\") // throws\n * ```\n */\nexport function typeDatetime(name?: string): Type<Date> {\n  return {\n    content: name ?? \"datetime\",\n    decoder(input: string) {\n      try {\n        const timestampMs = Date.parse(input);\n        if (isNaN(timestampMs)) {\n          throw new Error();\n        }\n        return new Date(timestampMs);\n      } catch {\n        throwInvalidValue(\"a valid ISO_8601 datetime\", input);\n      }\n    },\n  };\n}\n\n/**\n * Parses an absolute URL string to a `URL` object.\n * Relative or malformed URLs throws.\n *\n * @example\n * ```ts\n * typeUrl(\"my-url\").decoder(\"https://example.com\") // → URL { href: \"https://example.com/\", ... }\n * typeUrl(\"my-url\").decoder(\"not-a-url\")           // throws\n * ```\n */\nexport function typeUrl(name?: string): Type<URL> {\n  return {\n    content: name ?? \"url\",\n    decoder(input: string) {\n      try {\n        return new URL(input);\n      } catch {\n        throwInvalidValue(\"an URL\", input);\n      }\n    },\n  };\n}\n\n/**\n * Creates a {@link Type} for filesystem paths with optional existence checks.\n *\n * @param checks - Optional checks for path existence and type (file/directory).\n * @returns A {@link Type}`<string>` representing the path.\n *\n * @example\n * ```ts\n * const typeInputFile = typePath(\"input-file\", { checkSyncExistAs: \"file\" });\n * typeInputFile.decoder(\"data.txt\"); // → \"data.txt\" if it exists and is a file, otherwise throws\n * typeInputFile.decoder(\"somedir\");  // throws if \"somedir\" exists and is a directory\n * ```\n */\nexport function typePath(\n  name?: string,\n  checks?: { checkSyncExistAs?: \"file\" | \"directory\" | \"anything\" },\n): Type<string> {\n  return {\n    content: name ?? \"path\",\n    decoder(input: string) {\n      if (input.length === 0) {\n        throw new Error(`Path cannot be empty`);\n      }\n      if (input.includes(\"\\0\")) {\n        throw new Error(`Path cannot contain null characters`);\n      }\n      if (checks?.checkSyncExistAs !== undefined) {\n        function safeStatSync(path: string) {\n          try {\n            return statSync(path);\n          } catch (error) {\n            throw new TypoError(\n              new TypoText(\n                new TypoString(`Path does not exist: `),\n                new TypoString(`\"${path}\"`, typoStyleQuote),\n              ),\n              error,\n            );\n          }\n        }\n        const stats = safeStatSync(input);\n        const preview = stats.isDirectory()\n          ? \"directory\"\n          : stats.isFile()\n            ? \"file\"\n            : \"unknown\";\n        if (checks.checkSyncExistAs === \"file\" && !stats.isFile()) {\n          throw new TypoError(\n            new TypoText(\n              new TypoString(`Expected a file but found: ${preview}: `),\n              new TypoString(`\"${input}\"`, typoStyleQuote),\n            ),\n          );\n        }\n        if (checks.checkSyncExistAs === \"directory\" && !stats.isDirectory()) {\n          throw new TypoError(\n            new TypoText(\n              new TypoString(`Expected a directory but found: ${preview}: `),\n              new TypoString(`\"${input}\"`, typoStyleQuote),\n            ),\n          );\n        }\n      }\n      return input;\n    },\n  };\n}\n\n/**\n * Creates a {@link Type}`<string>` that only accepts a fixed set of values.\n *\n * @param name - Name shown in help and errors.\n * @param values - Ordered list of accepted values.\n * @returns A {@link Type}`<string>`.\n *\n * @example\n * ```ts\n * const typeEnv = typeChoice(\"environment\", [\"dev\", \"staging\", \"prod\"]);\n * typeEnv.decoder(\"prod\")    // → \"prod\"\n * typeEnv.decoder(\"unknown\") // throws\n * ```\n */\nexport function typeChoice<const Value extends string>(\n  name: string,\n  values: Array<Value>,\n  caseSensitive: boolean = true,\n): Type<Value> {\n  if (values.length === 0) {\n    throw new Error(\"At least one value is required\");\n  }\n  const normalize = caseSensitive\n    ? (input: string) => input\n    : (input: string) => input.toLowerCase();\n  const valueByNormalized = new Map(\n    values.map((value) => [normalize(value), value]),\n  );\n  return {\n    content: name,\n    decoder(input: string) {\n      const value = valueByNormalized.get(normalize(input));\n      if (value !== undefined) {\n        return value;\n      }\n      const errorText = new TypoText();\n      errorText.push(new TypoString(`Unknown value: `));\n      errorText.push(new TypoString(`\"${input}\"`, typoStyleQuote));\n      errorText.push(new TypoString(`.`));\n      suggestTextPushMessage(\n        errorText,\n        input,\n        values.map((value) => ({\n          reference: value,\n          hint: new TypoString(`\"${value}\"`, typoStyleQuote),\n        })),\n      );\n      throw new TypoError(errorText);\n    },\n  };\n}\n\n/**\n * Chains `before`'s decoder with an `after` transformation.\n * `before` errors are prefixed with `\"from: <content>\"` for traceability.\n *\n * @typeParam Before - Intermediate type from `before.decoder`.\n * @typeParam After - Final type from `after.decoder`.\n *\n * @param name - Name shown in help and errors (e.g. `\"my-value\"`).\n * @param before - Base type to decode the raw string.\n * @param mapper - Transforms `before`'s output to the final value; errors are wrapped with context.\n * @returns A {@link Type}`<After>`.\n *\n * @example\n * ```ts\n * const typePort = typeMapped(\"port\", typeNumber(), (n) => {\n *   if (n < 1 || n > 65535) {\n *     throw new Error(\"Out of range\");\n *   }\n *   return n;\n * });\n * typePort.decoder(\"8080\");  // → 8080\n * typePort.decoder(\"70000\"); // throws\n * ```\n */\nexport function typeMapped<Before, After>(\n  name: string,\n  before: Type<Before>,\n  mapper: (value: Before) => After,\n): Type<After> {\n  return {\n    content: name,\n    decoder: (input: string) => {\n      return mapper(\n        TypoError.tryWithContext(\n          () => before.decoder(input),\n          () =>\n            new TypoText(\n              new TypoString(\"from: \"),\n              new TypoString(before.content, typoStyleLogic),\n            ),\n        ),\n      );\n    },\n  };\n}\n\n/**\n * Adds a name to a {@link Type} for clearer error messages and help text.\n *\n * @param name - Name to use for the type.\n * @param type - Base type to name.\n * @returns A {@link Type} with the given name.\n */\nexport function typeRenamed<Value>(\n  type: Type<Value>,\n  name: string,\n): Type<Value> {\n  return {\n    content: name,\n    decoder: (input: string) => {\n      return TypoError.tryWithContext(\n        () => type.decoder(input),\n        () =>\n          new TypoText(\n            new TypoString(\"from: \"),\n            new TypoString(type.content, typoStyleLogic),\n          ),\n      );\n    },\n  };\n}\n\n/**\n * Splits a delimited string into a typed tuple.\n * Each part is decoded by the corresponding element type; wrong count or decode failure throws.\n *\n * @typeParam Elements - Tuple of decoded value types (inferred from `elementTypes`).\n *\n * @param elementTypes - One {@link Type} per tuple element, in order.\n * @param separator - Delimiter (default `\",\"`).\n * @returns A {@link Type}`<Elements>`.\n *\n * @example\n * ```ts\n * const typePoint = typeTuple([typeNumber(\"x\"), typeNumber(\"y\")]);\n * typePoint.decoder(\"3.14,2.71\") // → [3.14, 2.71]\n * typePoint.decoder(\"1\")         // throws\n * typePoint.decoder(\"1,2,3\")     // throws\n * typePoint.decoder(\"x,2\")       // throws\n * ```\n */\nexport function typeTuple<const Elements extends Array<any>>(\n  elementTypes: { [K in keyof Elements]: Type<Elements[K]> },\n  separator: string = \",\",\n): Type<Elements> {\n  return {\n    content: elementTypes\n      .map((elementType) => elementType.content)\n      .join(separator),\n    decoder(input: string) {\n      const splits = input.split(separator, elementTypes.length);\n      if (splits.length !== elementTypes.length) {\n        throw new TypoError(\n          new TypoText(\n            new TypoString(`Found ${splits.length} splits: `),\n            new TypoString(`Expected ${elementTypes.length} splits from: `),\n            new TypoString(`\"${input}\"`, typoStyleQuote),\n            new TypoString(`.`),\n          ),\n        );\n      }\n      return splits.map((split, index) => {\n        const elementType = elementTypes[index]!;\n        return TypoError.tryWithContext(\n          () => elementType.decoder(split),\n          () =>\n            new TypoText(\n              new TypoString(`at ${index}: `),\n              new TypoString(elementType.content, typoStyleLogic),\n            ),\n        );\n      }) as Elements;\n    },\n  };\n}\n\n/**\n * Splits a delimited string into a typed array.\n * Each part is decoded by `elementType`; failed decodes throws.\n * Note: splitting an empty string yields one empty element — prefer {@link optionRepeatable} for a zero-default.\n *\n * @typeParam Value - Element type produced by `elementType.decoder`.\n *\n * @param elementType - Decoder applied to each element.\n * @param separator - Delimiter (default `\",\"`).\n * @returns A {@link Type}`<Array<Value>>`.\n *\n * @example\n * ```ts\n * const typeNumbers = typeList(typeNumber(\"v\"));\n * typeNumbers.decoder(\"1,2,3\")  // → [1, 2, 3]\n * typeNumbers.decoder(\"1,x,3\")  // throws\n * const typePaths = typeList(typePath(), \":\");\n * typePaths.decoder(\"/bin:/usr\") // → [\"/bin\", \"/usr\"]\n * typePaths.decoder(\"/usr/bin\")  // → [\"/usr/bin\"]\n * typePaths.decoder(\"\")          // → throws\n * ```\n */\nexport function typeList<Value>(\n  elementType: Type<Value>,\n  separator: string = \",\",\n): Type<Array<Value>> {\n  return {\n    content: `${elementType.content}[${separator}${elementType.content}]...`,\n    decoder(input: string) {\n      const splits = input.split(separator);\n      return splits.map((split, index) =>\n        TypoError.tryWithContext(\n          () => elementType.decoder(split),\n          () =>\n            new TypoText(\n              new TypoString(`at ${index}: `),\n              new TypoString(elementType.content, typoStyleLogic),\n            ),\n        ),\n      );\n    },\n  };\n}\n\nfunction throwInvalidValue(kind: string, input: string): never {\n  throw new TypoError(\n    new TypoText(\n      new TypoString(`Not ${kind}: `),\n      new TypoString(`\"${input}\"`, typoStyleQuote),\n      new TypoString(`.`),\n    ),\n  );\n}\n\nconst typeBooleanValuesTrue = new Set([\"true\", \"yes\", \"on\", \"y\"]);\nconst typeBooleanValuesFalse = new Set([\"false\", \"no\", \"off\", \"n\"]);\n","import {\n  ReaderOptionGetter,\n  ReaderOptionNextGuard,\n  ReaderOptions,\n  ReaderOptionValue,\n} from \"./Reader\";\nimport { Type, typeBoolean } from \"./Type\";\nimport {\n  TypoError,\n  TypoString,\n  typoStyleConstants,\n  typoStyleLogic,\n  typoStyleUserInput,\n  TypoText,\n} from \"./Typo\";\nimport { UsageOption } from \"./Usage\";\n\n/**\n * A CLI option. Created with {@link optionFlag}, {@link optionSingleValue},\n * or {@link optionRepeatable}.\n *\n * @typeParam Value - Decoded value type.\n */\nexport type Option<Value> = {\n  /**\n   * Returns metadata for the `Options:` section.\n   */\n  generateUsage(): UsageOption;\n  /**\n   * Registers the option on `readerOptions` and returns an {@link OptionDecoder}.\n   */\n  registerAndMakeDecoder(readerOptions: ReaderOptions): OptionDecoder<Value>;\n};\n\n/**\n * Produced by {@link Option.registerAndMakeDecoder}.\n *\n * @typeParam Value - Decoded value type.\n */\nexport type OptionDecoder<Value> = {\n  /**\n   * Returns the decoded option value.\n   *\n   * @throws if decoding failed.\n   */\n  getAndDecodeValue(): Value;\n};\n\n/**\n * Creates a boolean flag option (`--verbose`, optionally `--flag=no`).\n *\n * Syntax: `--long`, `--long=no`, `-s`, `-s=no`.\n * Parsing logic:\n * - absent → default value\n * - `--flag` / `--flag=yes` → `true`\n * - `--flag=no` → `false`\n * - specified more than once → throws.\n *\n * @param definition.long - Long-form name (without `--`).\n * @param definition.short - Short-form name (without `-`).\n * @param definition.description - Help text.\n * @param definition.hint - Short note shown in parentheses.\n * @param definition.aliases - Additional names.\n * @param definition.default - Default value when absent.\n * @returns An {@link Option}`<boolean>`.\n *\n * @example\n * ```ts\n * const verboseFlag = optionFlag({\n *   long: \"verbose\",\n *   short: \"v\",\n *   description: \"Enable verbose output\",\n * });\n * ```\n */\nexport function optionFlag(definition: {\n  long: string;\n  short?: string;\n  description?: string;\n  hint?: string;\n  aliases?: { longs?: Array<string>; shorts?: Array<string> };\n  default?: boolean;\n}): Option<boolean> {\n  const type = typeBoolean(\"value\");\n  const { long, short, description, hint, aliases } = definition;\n  return {\n    generateUsage() {\n      return { short, long, annotation: \"[=no]\", description, hint };\n    },\n    registerAndMakeDecoder(readerOptions: ReaderOptions) {\n      const resultsGetter = setupOptionAliased(readerOptions, {\n        longKey: long,\n        shortKey: short,\n        aliasLongKeys: aliases?.longs,\n        aliasShortKeys: aliases?.shorts,\n        nextGuard: () => false,\n        consumeGroupRestAsValue: false,\n      });\n      return {\n        getAndDecodeValue() {\n          const results = resultsGetter();\n          if (results.length > 1) {\n            throwSetMultipleTimesError(results.map((r) => r.identifier));\n          }\n          if (results.length === 0) {\n            return definition.default === undefined\n              ? false\n              : definition.default;\n          }\n          const input = results[0]!.value.inlined;\n          if (input === null) {\n            return true;\n          }\n          return decodeValue({ long, label: undefined, type, input });\n        },\n      };\n    },\n  };\n}\n\n/**\n * Creates an option that accepts exactly one value (e.g. `--output dist/`).\n *\n * Syntax: `--long value`, `--long=value`, `-s value`, `-s=value`, `-svalue`.\n * Parsing logic:\n * - absent → `fallbackValueIfAbsent()`\n * - `--long value` → decoded with `type.decoder(\"value\")`\n * - more than once → throws\n * - if `impliedValueIfNotInlined` is not provided, then: `--long` / `-s` without a value → throws\n * - if `impliedValueIfNotInlined` is provided, then: `--long` / `-s` without an inline value → `impliedValueIfNotInlined()`\n *\n * @typeParam Value - Type produced by the decoder.\n *\n * @param definition.long - Long-form name (without `--`).\n * @param definition.short - Short-form name (without `-`).\n * @param definition.description - Help text.\n * @param definition.hint - Short note shown in parentheses.\n * @param definition.aliases - Additional names.\n * @param definition.type - Decoder for the raw string value.\n * @param definition.fallbackValueIfAbsent - Default value when the option is not specified at all.\n * @param definition.impliedValueIfNotInlined - Default value when the option is specified without an inline value (e.g. `--option` or `-o`).\n * @returns An {@link Option}`<Value>`.\n *\n * @example\n * ```ts\n * const outputOption = optionSingleValue({\n *   long: \"output\",\n *   short: \"o\",\n *   type: typePath(),\n *   description: \"Output directory\",\n *   fallbackValueIfAbsent: () => \"dist\",\n * });\n * ```\n */\nexport function optionSingleValue<Value>(definition: {\n  long: string;\n  short?: string;\n  description?: string;\n  hint?: string;\n  aliases?: { longs?: Array<string>; shorts?: Array<string> };\n  type: Type<Value>;\n  fallbackValueIfAbsent?: () => Value;\n  impliedValueIfNotInlined?: () => Value;\n}): Option<Value> {\n  const { long, short, description, hint, aliases, type } = definition;\n  const label = definition.impliedValueIfNotInlined\n    ? undefined\n    : `<${type.content}>`;\n  const annotation = definition.impliedValueIfNotInlined\n    ? `[=${type.content}]`\n    : undefined; // TODO - handle implied value and default better in usage and errors\n  return {\n    generateUsage() {\n      return { short, long, label, annotation, description, hint };\n    },\n    registerAndMakeDecoder(readerOptions: ReaderOptions) {\n      const resultsGetter = setupOptionAliased(readerOptions, {\n        longKey: long,\n        shortKey: short,\n        aliasLongKeys: aliases?.longs,\n        aliasShortKeys: aliases?.shorts,\n        nextGuard: (value) => {\n          if (definition.impliedValueIfNotInlined !== undefined) {\n            return false;\n          }\n          if (value.inlined !== null) {\n            return false;\n          }\n          if (value.separated.length !== 0) {\n            return false;\n          }\n          return true;\n        },\n        consumeGroupRestAsValue:\n          definition.impliedValueIfNotInlined === undefined,\n      });\n      return {\n        getAndDecodeValue() {\n          const results = resultsGetter();\n          if (results.length > 1) {\n            throwSetMultipleTimesError(\n              results.map((result) => result.identifier),\n            );\n          }\n          const result = results[0];\n          if (result === undefined) {\n            if (definition.fallbackValueIfAbsent === undefined) {\n              const errorText = makeErrorText({ long, label, type });\n              errorText.push(new TypoString(`: Is required, but was not set.`));\n              throw new TypoError(errorText);\n            }\n            try {\n              return definition.fallbackValueIfAbsent();\n            } catch (error) {\n              const errorText = makeErrorText({ long, label, type });\n              errorText.push(new TypoString(`: Failed to get fallback value.`));\n              throw new TypoError(errorText, error);\n            }\n          }\n          const inlined = result.value.inlined;\n          if (inlined !== null) {\n            return decodeValue({ long, label, type, input: inlined });\n          }\n          if (definition.impliedValueIfNotInlined !== undefined) {\n            try {\n              return definition.impliedValueIfNotInlined();\n            } catch (error) {\n              const errorText = makeErrorText({ long, label, type });\n              errorText.push(new TypoString(`: Failed to get implied value.`));\n              throw new TypoError(errorText, error);\n            }\n          }\n          const separated = result.value.separated[0]!;\n          return decodeValue({ long, label, type, input: separated });\n        },\n      };\n    },\n  };\n}\n\n/**\n * Creates an option that collects every occurrence into an array (e.g. `--file a.ts --file b.ts`).\n *\n * Syntax: `--long value`, `--long=value`, `-s value`, `-s=value`, `-svalue`.\n * Parsing logic:\n * - absent → `[]`\n * - N occurrences → array of N decoded values in order.\n *\n * @typeParam Value - Type produced by the decoder for each occurrence.\n *\n * @param definition.long - Long-form name (without `--`).\n * @param definition.short - Short-form name (without `-`).\n * @param definition.description - Help text.\n * @param definition.hint - Short note shown in parentheses.\n * @param definition.aliases - Additional names.\n * @param definition.type - Decoder applied to each raw string value.\n * @returns An {@link Option}`<Array<Value>>`.\n *\n * @example\n * ```ts\n * const filesOption = optionRepeatable({\n *   long: \"file\",\n *   short: \"f\",\n *   type: typeString,\n *   label: \"PATH\",\n *   description: \"Input file (may be repeated)\",\n * });\n * ```\n */\nexport function optionRepeatable<Value>(definition: {\n  long: string;\n  short?: string;\n  description?: string;\n  hint?: string;\n  aliases?: { longs?: Array<string>; shorts?: Array<string> };\n  type: Type<Value>;\n}): Option<Array<Value>> {\n  const { long, short, description, hint, aliases, type } = definition;\n  const label = `<${type.content}>`;\n  return {\n    generateUsage() {\n      return { short, long, label, annotation: \" [*]\", description, hint };\n    },\n    registerAndMakeDecoder(readerOptions: ReaderOptions) {\n      const resultsGetter = setupOptionAliased(readerOptions, {\n        longKey: long,\n        shortKey: short,\n        aliasLongKeys: aliases?.longs,\n        aliasShortKeys: aliases?.shorts,\n        nextGuard: (value) => {\n          if (value.inlined !== null) {\n            return false;\n          }\n          if (value.separated.length !== 0) {\n            return false;\n          }\n          return true;\n        },\n        consumeGroupRestAsValue: true,\n      });\n      return {\n        getAndDecodeValue() {\n          return resultsGetter().map((result) => {\n            const value = result.value;\n            const input = value.inlined ?? value.separated[0]!;\n            return decodeValue({ long, label, type, input });\n          });\n        },\n      };\n    },\n  };\n}\n\nfunction decodeValue<Value>(params: {\n  long: string;\n  label: string | undefined;\n  type: Type<Value>;\n  input: string;\n}): Value {\n  const { long, label, type, input } = params;\n  return TypoError.tryWithContext(\n    () => type.decoder(input),\n    () => makeErrorText({ long, label, type }),\n  );\n}\n\nfunction makeErrorText(params: {\n  long: string;\n  label: string | undefined;\n  type: Type<any>;\n}): TypoText {\n  const errorText = new TypoText();\n  errorText.push(new TypoString(`--${params.long}`, typoStyleConstants));\n  if (params.label !== undefined) {\n    errorText.push(new TypoString(`: `));\n    errorText.push(new TypoString(params.label, typoStyleUserInput));\n  } else {\n    errorText.push(new TypoString(`: `));\n    errorText.push(new TypoString(params.type.content, typoStyleLogic));\n  }\n  return errorText;\n}\n\nfunction setupOptionAliased(\n  readerOptions: ReaderOptions,\n  params: {\n    longKey: string;\n    shortKey: string | undefined;\n    aliasLongKeys: Array<string> | undefined;\n    aliasShortKeys: Array<string> | undefined;\n    nextGuard: ReaderOptionNextGuard;\n    consumeGroupRestAsValue: boolean;\n  },\n): () => Array<{ identifier: string; value: ReaderOptionValue }> {\n  const { longKey, shortKey, aliasLongKeys, aliasShortKeys } = params;\n  const longKeys = [longKey];\n  if (aliasLongKeys !== undefined) {\n    longKeys.push(...aliasLongKeys);\n  }\n  const shortKeys = shortKey ? [shortKey] : [];\n  if (aliasShortKeys !== undefined) {\n    shortKeys.push(...aliasShortKeys);\n  }\n  return setupOptionMany(readerOptions, {\n    longKeys,\n    shortKeys,\n    nextGuard: params.nextGuard,\n    consumeGroupRestAsValue: params.consumeGroupRestAsValue,\n  });\n}\n\nfunction setupOptionMany(\n  readerOptions: ReaderOptions,\n  params: {\n    longKeys: Array<string>;\n    shortKeys: Array<string>;\n    nextGuard: ReaderOptionNextGuard;\n    consumeGroupRestAsValue: boolean;\n  },\n): () => Array<{ identifier: string; value: ReaderOptionValue }> {\n  const { longKeys, shortKeys, nextGuard, consumeGroupRestAsValue } = params;\n  const getters = new Map<string, ReaderOptionGetter>();\n  for (const key of longKeys) {\n    getters.set(\n      `--${key}`,\n      readerOptions.registerOptionLong({ key, nextGuard }),\n    );\n  }\n  for (const key of shortKeys) {\n    getters.set(\n      `-${key}`,\n      readerOptions.registerOptionShort({\n        key,\n        nextGuard,\n        consumeGroupRestAsValue,\n      }),\n    );\n  }\n  return () => {\n    const results = new Array();\n    for (const [identifier, getter] of getters.entries()) {\n      for (const value of getter()) {\n        results.push({ identifier, value });\n      }\n    }\n    return results;\n  };\n}\n\nfunction throwSetMultipleTimesError(identifiers: Array<string>): never {\n  const identifiersTexts = Array.from(new Set(identifiers)).map(\n    (identifier) => new TypoString(identifier, typoStyleConstants),\n  );\n  const errorText = new TypoText();\n  errorText.pushJoined(identifiersTexts, new TypoString(\", \"), 3);\n  errorText.push(new TypoString(`: Must not be set multiple times.`));\n  throw new TypoError(errorText);\n}\n","import { ReaderPositionals } from \"./Reader\";\nimport { Type } from \"./Type\";\nimport {\n  TypoError,\n  TypoString,\n  typoStyleRegularWeaker,\n  typoStyleUserInput,\n  TypoText,\n} from \"./Typo\";\nimport { UsagePositional } from \"./Usage\";\n\n/**\n * A positional argument. Created with {@link positionalRequired}, {@link positionalOptional},\n * or {@link positionalVariadics}.\n *\n * @typeParam Value - Decoded value type.\n */\nexport type Positional<Value> = {\n  /**\n   * Returns metadata for the `Positionals:` section.\n   */\n  generateUsage(): UsagePositional;\n  /**\n   * Consumes the next positional token from `readerPositionals`.\n   * Returns a decoder that produces the final value.\n   */\n  consumeAndMakeDecoder(\n    readerPositionals: ReaderPositionals,\n  ): PositionalDecoder<Value>;\n};\n\n/**\n * Produced by {@link Positional.consumeAndMakeDecoder}.\n *\n * @typeParam Value - Decoded value type.\n */\nexport type PositionalDecoder<Value> = {\n  /**\n   * Returns the decoded positional value.\n   *\n   * @throws if decoding failed.\n   */\n  decodeValue(): Value;\n};\n\n/**\n * Creates a required positional — missing token throws.\n *\n * Syntax: `<type>`, e.g. `<NAME>`.\n * Parsing logic:\n * - \"token\" → decoded with `type.decoder(\"token\")`\n * - token missing → throws\n *\n * @typeParam Value - Type produced by the decoder.\n *\n * @param definition.description - Help text.\n * @param definition.hint - Short note shown in parentheses.\n * @param definition.type - Decoder for the raw token.\n * @param definition.missing - Message shown when the token is missing.\n * @returns A {@link Positional}`<Value>`.\n *\n * @example\n * ```ts\n * const namePositional = positionalRequired({\n *   type: type(\"name\"),\n *   description: \"The name to greet\",\n * });\n * ```\n */\nexport function positionalRequired<Value>(definition: {\n  description?: string;\n  hint?: string;\n  type: Type<Value>;\n}): Positional<Value> {\n  const { description, hint, type } = definition;\n  const label = `<${type.content}>`;\n  return {\n    generateUsage() {\n      return { description, hint, label };\n    },\n    consumeAndMakeDecoder(readerPositionals: ReaderPositionals) {\n      const positional = readerPositionals.consumePositional();\n      if (positional === undefined) {\n        const errorText = makeErrorTextLabel(\"Missing argument\", label);\n        if (description !== undefined) {\n          errorText.push(\n            new TypoString(`: `),\n            new TypoString(`${description}`),\n          );\n        }\n        if (hint !== undefined) {\n          errorText.push(\n            new TypoString(` `),\n            new TypoString(`(${hint})`, typoStyleRegularWeaker),\n          );\n        }\n        throw new TypoError(errorText);\n      }\n      return {\n        decodeValue() {\n          return decodeValue(label, definition.type, positional);\n        },\n      };\n    },\n  };\n}\n\n/**\n * Creates an optional positional — absent token falls back to `default()`.\n *\n * Syntax: `[type]`, e.g. `[NAME]`.\n * Parsing logic:\n * - \"token\" → decoded with `type.decoder(\"token\")`\n * - token missing → `default()`\n *\n * @typeParam Value - Type produced by the decoder (or the default).\n *\n * @param definition.description - Help text.\n * @param definition.hint - Short note shown in parentheses.\n * @param definition.type - Decoder for the raw token.\n * @param definition.default - Value when absent. Throw to make it required.\n * @returns A {@link Positional}`<Value>`.\n *\n * @example\n * ```ts\n * const greeteePositional = positionalOptional({\n *   type: type(\"name\"),\n *   description: \"Name to greet\",\n *   hint: \"Defaults to \\\"world\\\"\",\n *   default: () => \"world\",\n * });\n * ```\n */\nexport function positionalOptional<Value>(definition: {\n  description?: string;\n  hint?: string;\n  type: Type<Value>;\n  default: () => Value;\n}): Positional<Value> {\n  const { description, hint, type } = definition;\n  const label = `[${type.content}]`;\n  return {\n    generateUsage() {\n      return { description, hint, label };\n    },\n    consumeAndMakeDecoder(readerPositionals: ReaderPositionals) {\n      const positional = readerPositionals.consumePositional();\n      return {\n        decodeValue() {\n          if (positional === undefined) {\n            try {\n              return definition.default();\n            } catch (error) {\n              const errorText = makeErrorTextLabel(\n                \"Failed to get default value\",\n                label,\n              );\n              errorText.push(new TypoString(\".\"));\n              throw new TypoError(errorText, error);\n            }\n          }\n          return decodeValue(label, definition.type, positional);\n        },\n      };\n    },\n  };\n}\n\n/**\n * Creates a variadic positional that collects zero or more remaining tokens into an array.\n * Optionally stops at `endDelimiter` (consumed, not included).\n *\n * Syntax: `[type]...`, e.g. `[NAME]...`.\n * Parsing logic:\n * - \"a b ...\" → decoded with `[type.decoder(\"a\")`, `type.decoder(\"b\"), ...]``\n * - token missing → stops collection\n * - endDelimiter encountered → stops collection\n *\n * @typeParam Value - Type produced by the decoder for each token.\n *\n * @param definition.endDelimiter - Sentinel token that stops collection (consumed, not included).\n * @param definition.description - Help text.\n * @param definition.hint - Short note shown in parentheses.\n * @param definition.type - Decoder applied to each token.\n * @returns A {@link Positional}`<Array<Value>>`.\n *\n * @example\n * ```ts\n * const filesPositional = positionalVariadics({\n *   type: typePath(),\n *   description: \"Files to process\",\n * });\n * ```\n */\nexport function positionalVariadics<Value>(definition: {\n  endDelimiter?: string;\n  description?: string;\n  hint?: string;\n  type: Type<Value>;\n}): Positional<Array<Value>> {\n  const { description, hint, type } = definition;\n  const labelSingle = `[${type.content}]`;\n  const labelMultiple =\n    `${labelSingle}...` +\n    (definition.endDelimiter ? ` [\"${definition.endDelimiter}\"]` : \"\");\n  return {\n    generateUsage() {\n      return { description, hint, label: labelMultiple };\n    },\n    consumeAndMakeDecoder(readerPositionals: ReaderPositionals) {\n      const positionals = new Array<string>();\n      while (true) {\n        const positional = readerPositionals.consumePositional();\n        if (\n          positional === undefined ||\n          positional === definition.endDelimiter\n        ) {\n          break;\n        }\n        positionals.push(positional);\n      }\n      return {\n        decodeValue() {\n          return positionals.map((positional) =>\n            decodeValue(labelSingle, definition.type, positional),\n          );\n        },\n      };\n    },\n  };\n}\n\nfunction decodeValue<Value>(\n  label: string,\n  type: Type<Value>,\n  input: string,\n): Value {\n  return TypoError.tryWithContext(\n    () => type.decoder(input),\n    () => new TypoText(new TypoString(label, typoStyleUserInput)),\n  );\n}\n\nfunction makeErrorTextLabel(message: string, label: string): TypoText {\n  const errorText = new TypoText();\n  errorText.push(new TypoString(`${message}: `));\n  errorText.push(new TypoString(label, typoStyleUserInput));\n  return errorText;\n}\n","import { suggestTextPushMessage } from \"./Suggest\";\nimport {\n  TypoError,\n  TypoString,\n  typoStyleConstants,\n  typoStyleQuote,\n  TypoText,\n} from \"./Typo\";\n\n/**\n * Represents the parsing specification for a long option\n */\nexport type ReaderOptionLongSpec = {\n  key: string;\n  nextGuard: ReaderOptionNextGuard;\n};\n\n/**\n * Represents the parsing specification for a short option\n */\nexport type ReaderOptionShortSpec = ReaderOptionLongSpec & {\n  consumeGroupRestAsValue: boolean;\n};\n\n/**\n * Determines whether the next token is valid for a given option.\n */\nexport type ReaderOptionNextGuard = (\n  value: ReaderOptionValue,\n  next: string | undefined,\n) => boolean;\n\n/**\n * Represents the values parsed for an option.\n */\nexport type ReaderOptionValue = {\n  inlined: string | null;\n  separated: ReadonlyArray<string>;\n};\n\n/**\n * Returns the parsed values for a registered option.\n */\nexport type ReaderOptionGetter = () => ReadonlyArray<ReaderOptionValue>;\n\n/**\n * Option registration/query interface. Subset of {@link ReaderArgs}.\n */\nexport type ReaderOptions = {\n  registerOptionLong(longSpec: ReaderOptionLongSpec): ReaderOptionGetter;\n  registerOptionShort(shortSpec: ReaderOptionShortSpec): ReaderOptionGetter;\n};\n\n/**\n * Positional consumption interface. Subset of {@link ReaderArgs}.\n */\nexport type ReaderPositionals = {\n  /**\n   * Returns the next positional token, parsing intervening options as side-effects.\n   *\n   * @returns The next positional, or `undefined` when exhausted.\n   * @throws on an unrecognised option.\n   */\n  consumePositional(): string | undefined;\n};\n\n/**\n * Core argument parser: converts raw CLI tokens into named options and positionals.\n * Options must be registered before {@link ReaderArgs.consumePositional} is called.\n *\n * Supported syntax: `--name`, `--name value`, `--name=value`,\n * `-n`, `-n value`, `-nvalue`, `-abc` (stacked), `--` (end-of-options).\n *\n * Created internally by {@link runAndExit}; exposed for advanced / custom runners.\n */\nexport class ReaderArgs {\n  #tokens: ReadonlyArray<string>;\n  #parsedIndex: number;\n  #parsedDouble: boolean;\n  #optionLongContextByIdentifier: Map<string, Context<ReaderOptionLongSpec>>;\n  #optionShortContextByIdentifier: Map<string, Context<ReaderOptionShortSpec>>;\n\n  /**\n   * @param tokens - Raw CLI tokens (e.g. `process.argv.slice(2)`).\n   */\n  constructor(tokens: ReadonlyArray<string>) {\n    this.#tokens = tokens;\n    this.#parsedIndex = 0;\n    this.#parsedDouble = false;\n    this.#optionLongContextByIdentifier = new Map();\n    this.#optionShortContextByIdentifier = new Map();\n  }\n\n  /**\n   * Registers a long option and returns a getter for its parsed values.\n   */\n  registerOptionLong(longSpec: ReaderOptionLongSpec): ReaderOptionGetter {\n    const identifier = `--${longSpec.key}`; // TODO - is this necessary ?\n    if (!isValidOptionKey(longSpec.key)) {\n      throw new Error(`Option identifier is invalid: ${identifier}.`);\n    }\n    if (this.#optionLongContextByIdentifier.has(identifier)) {\n      throw new Error(`Option already registered: ${identifier}.`);\n    }\n    const values = new Array<ReaderOptionValue>();\n    this.#optionLongContextByIdentifier.set(identifier, {\n      identifier,\n      spec: longSpec,\n      values,\n    });\n    return () => values;\n  }\n\n  /**\n   * Registers a short option and returns a getter for its parsed values.\n   */\n  registerOptionShort(shortSpec: ReaderOptionShortSpec): ReaderOptionGetter {\n    const identifier = `-${shortSpec.key}`;\n    if (!isValidOptionKey(shortSpec.key)) {\n      throw new Error(`Option identifier is invalid: ${identifier}.`);\n    }\n    if (this.#optionShortContextByIdentifier.has(identifier)) {\n      throw new Error(`Option already registered: ${identifier}.`);\n    }\n    for (let i = 0; i < identifier.length; i++) {\n      const slicedIdentifier = identifier.slice(0, 1 + i);\n      if (this.#optionShortContextByIdentifier.has(slicedIdentifier)) {\n        throw new Error(\n          `Option ${identifier} overlap with shorter option: ${slicedIdentifier}.`,\n        );\n      }\n    }\n    for (const otherIdentifier of this.#optionShortContextByIdentifier.keys()) {\n      if (otherIdentifier.startsWith(identifier)) {\n        throw new Error(\n          `Option ${identifier} overlap with longer option: ${otherIdentifier}.`,\n        );\n      }\n    }\n    const values = new Array<ReaderOptionValue>();\n    this.#optionShortContextByIdentifier.set(identifier, {\n      identifier,\n      spec: shortSpec,\n      values,\n    });\n    return () => values;\n  }\n\n  /**\n   * Returns the next positional token; parses intervening options as a side-effect.\n   * All tokens after `--` are treated as positionals.\n   *\n   * @returns The next positional, or `undefined` when exhausted.\n   * @throws on an unrecognised option.\n   */\n  consumePositional(): string | undefined {\n    while (true) {\n      const token = this.#consumeToken();\n      if (token === undefined) {\n        return undefined;\n      }\n      if (!this.#tryConsumeAsOption(token)) {\n        return token;\n      }\n    }\n  }\n\n  #consumeToken(): string | undefined {\n    const token = this.#tokens[this.#parsedIndex];\n    if (token === undefined) {\n      return undefined;\n    }\n    this.#parsedIndex++;\n    if (!this.#parsedDouble) {\n      if (token === \"--\") {\n        this.#parsedDouble = true;\n        return this.#consumeToken();\n      }\n    }\n    return token;\n  }\n\n  #tryConsumeAsOption(token: string): boolean {\n    if (this.#parsedDouble) {\n      return false;\n    }\n    if (token.startsWith(\"--\")) {\n      const valueIndexStart = token.indexOf(\"=\");\n      if (valueIndexStart === -1) {\n        this.#consumeOptionLong(token, null);\n      } else {\n        this.#consumeOptionLong(\n          token.slice(0, valueIndexStart),\n          token.slice(valueIndexStart + 1),\n        );\n      }\n      return true;\n    }\n    if (token.startsWith(\"-\")) {\n      let shortIndexStart = 1;\n      let shortIndexEnd = 2;\n      while (shortIndexEnd <= token.length) {\n        const identifier = `-${token.slice(shortIndexStart, shortIndexEnd)}`;\n        const shortContext =\n          this.#optionShortContextByIdentifier.get(identifier);\n        if (shortContext !== undefined) {\n          const tokenRest = token.slice(shortIndexEnd);\n          if (this.#tryConsumeOptionShort(shortContext, tokenRest)) {\n            return true;\n          }\n          shortIndexStart = shortIndexEnd;\n        }\n        shortIndexEnd++;\n      }\n      this.#throwUnknownOptionError(`-${token.slice(shortIndexStart)}`);\n    }\n    return false;\n  }\n\n  #consumeOptionLong(identifier: string, valueInlined: string | null): void {\n    const longContext = this.#optionLongContextByIdentifier.get(identifier);\n    if (longContext !== undefined) {\n      return this.#consumeOptionValues(longContext, valueInlined);\n    }\n    this.#throwUnknownOptionError(identifier);\n  }\n\n  #tryConsumeOptionShort(\n    shortContext: Context<ReaderOptionShortSpec>,\n    tokenRest: string,\n  ): boolean {\n    if (tokenRest.startsWith(\"=\")) {\n      this.#consumeOptionValues(shortContext, tokenRest.slice(1));\n      return true;\n    }\n    if (tokenRest.length === 0) {\n      this.#consumeOptionValues(shortContext, null);\n      return true;\n    }\n    if (shortContext.spec.consumeGroupRestAsValue) {\n      this.#consumeOptionValues(shortContext, tokenRest);\n      return true;\n    }\n    this.#consumeOptionValues(shortContext, null);\n    return false;\n  }\n\n  #consumeOptionValues(\n    context: Context<{ nextGuard: ReaderOptionNextGuard }>,\n    valueInlined: string | null,\n  ) {\n    const value = { inlined: valueInlined, separated: new Array<string>() };\n    const { identifier, values, spec } = context;\n    values.push(value);\n    while (true) {\n      const nextToken = this.#tokens[this.#parsedIndex];\n      if (!spec.nextGuard(value, nextToken)) {\n        return;\n      }\n      const token = this.#consumeToken();\n      if (this.#parsedDouble) {\n        throw new TypoError(\n          new TypoText(\n            new TypoString(identifier, typoStyleConstants),\n            new TypoString(`: Requires a value but got: `),\n            new TypoString(`\"--\"`, typoStyleQuote),\n            new TypoString(`.`),\n          ),\n        );\n      }\n      // TODO - should we allow consuming the EOF token ?\n      if (token === undefined) {\n        throw new TypoError(\n          new TypoText(\n            new TypoString(identifier, typoStyleConstants),\n            new TypoString(`: Requires a value, but got end of input.`), // TODO - hint at option value syntax ?\n          ),\n        );\n      }\n      // TODO - is that weird, could a valid value start with dash ?\n      if (token.startsWith(\"-\")) {\n        throw new TypoError(\n          new TypoText(\n            new TypoString(identifier, typoStyleConstants),\n            new TypoString(`: Requires a value, but got: `),\n            new TypoString(`\"${token}\"`, typoStyleQuote),\n            new TypoString(`.`),\n          ),\n        );\n      }\n      value.separated.push(token);\n    }\n  }\n\n  #throwUnknownOptionError(inputIdentifier: string): never {\n    const candidatesIdentifiers = [];\n    for (const identifier of this.#optionLongContextByIdentifier.keys()) {\n      candidatesIdentifiers.push(identifier);\n    }\n    for (const identifier of this.#optionShortContextByIdentifier.keys()) {\n      candidatesIdentifiers.push(identifier);\n    }\n    const errorText = new TypoText();\n    errorText.push(new TypoString(`Unknown option: `));\n    errorText.push(new TypoString(`\"${inputIdentifier}\"`, typoStyleQuote));\n    if (candidatesIdentifiers.length === 0) {\n      errorText.push(new TypoString(`, no options are registered.`));\n    } else {\n      errorText.push(new TypoString(`.`));\n      suggestTextPushMessage(\n        errorText,\n        inputIdentifier,\n        candidatesIdentifiers.map((candidateIdentifier) => ({\n          reference: candidateIdentifier,\n          hint: new TypoString(candidateIdentifier, typoStyleConstants),\n        })),\n      );\n    }\n    throw new TypoError(errorText);\n  }\n}\n\nfunction isValidOptionKey(name: string): boolean {\n  return name.length > 0 && !name.includes(\"=\") && !name.includes(\"\\0\");\n}\n\ntype Context<Spec> = {\n  identifier: string;\n  spec: Spec;\n  values: Array<ReaderOptionValue>;\n};\n","import { CommandInformation } from \"./Command\";\nimport {\n  TypoGrid,\n  TypoString,\n  typoStyleConstants,\n  typoStyleLogic,\n  typoStyleRegularStrong,\n  typoStyleRegularWeaker,\n  typoStyleTitle,\n  typoStyleUserInput,\n  TypoSupport,\n  TypoText,\n} from \"./Typo\";\n\n/**\n * Usage model. Produced by {@link CommandDecoder.generateUsage}, consumed by {@link usageToStyledLines}.\n */\nexport type UsageCommand = {\n  /**\n   * Segments of the usage line\n   */\n  segments: Array<{ positional: string } | { subcommand: string }>;\n  /**\n   * Command metadata.\n   */\n  information: CommandInformation;\n  /**\n   * Positionals in declaration order.\n   */\n  positionals: Array<UsagePositional>;\n  /**\n   * Subcommands, populated when none was selected.\n   */\n  subcommands: Array<UsageSubcommand>;\n  /**\n   * Options in registration order.\n   */\n  options: Array<UsageOption>;\n};\n\n/**\n * Positional metadata for the `Positionals:` section of help.\n */\nexport type UsagePositional = {\n  /**\n   * Help text.\n   */\n  description?: string | undefined;\n  /**\n   * Short note shown in parentheses.\n   */\n  hint?: string | undefined;\n  /**\n   * Placeholder label shown in the usage line and the `Positionals:` section.\n   */\n  label: string;\n};\n\n/**\n * Entry in the `Subcommands:` section.\n */\nexport type UsageSubcommand = {\n  /**\n   * Token the user types (e.g. `\"deploy\"`).\n   */\n  name: string;\n  /**\n   * From {@link CommandInformation.description}.\n   */\n  description?: string | undefined;\n  /**\n   * From {@link CommandInformation.hint}.\n   */\n  hint?: string | undefined;\n};\n\n/**\n * Option metadata for the `Options:` section of help.\n */\nexport type UsageOption = {\n  /**\n   * Short-form name without `-` (e.g. `\"v\"`).\n   */\n  short?: string | undefined;\n  /**\n   * Long-form name without `--` (e.g. `\"verbose\"`).\n   */\n  long: string;\n  /**\n   * Value placeholder in help (e.g. `\"<FILE>\"`).\n   */\n  label?: string | undefined;\n  /**\n   * Extra annotation appended to the option label in help.\n   */\n  annotation?: string | undefined; // TODO - maybe prefix/postfix would be more useful\n  /**\n   * Help text.\n   */\n  description?: string | undefined;\n  /**\n   * Short note shown in parentheses.\n   */\n  hint?: string | undefined;\n};\n\n/**\n * Converts a {@link UsageCommand} model into an array of styled lines ready to be\n * joined with `\"\\n\"` and printed to the terminal.\n *\n * The output format is:\n * ```\n * Usage: <cliName> [segments...]\n *\n * <description> (<hint>)\n * <detail lines...>\n *\n * Positionals:\n *   <label>  <description> (<hint>)\n *\n * Subcommands:\n *   <name>  <description> (<hint>)\n *\n * Options:\n *   -s, --long <label><annotation>  <description> (<hint>)\n *\n * Examples:\n *   <explanation>\n *   <command line>\n *\n * ```\n * Sections that have no entries are omitted. The trailing empty line is always included.\n *\n * Column alignment per section via {@link TypoGrid}.\n *\n * @param params.cliName - Program name for the usage line.\n * @param params.usage - From {@link CommandDecoder.generateUsage}.\n * @param params.typoSupport - Rendering mode.\n * @returns Styled lines; includes a trailing empty string.\n *\n * @example\n * ```ts\n * const lines = usageToStyledLines({\n *   cliName: \"my-cli\",\n *   usage: commandDecoder.generateUsage(),\n *   typoSupport: TypoSupport.tty(),\n * });\n * process.stdout.write(lines.join(\"\\n\"));\n * ```\n */\nexport function usageToStyledLines(params: {\n  cliName: string;\n  usage: UsageCommand;\n  typoSupport: TypoSupport;\n}) {\n  const { cliName, usage, typoSupport } = params;\n\n  const lines = new Array<string>();\n\n  const segmentsText = new TypoText();\n  segmentsText.push(textUsageHero(\"Usage:\"));\n  segmentsText.push(textDelimiter(\" \"));\n  segmentsText.push(textConstants(cliName));\n  for (const segment of usage.segments) {\n    segmentsText.push(textDelimiter(\" \"));\n    if (\"positional\" in segment) {\n      segmentsText.push(textUserInput(segment.positional));\n    }\n    if (\"subcommand\" in segment) {\n      segmentsText.push(textConstants(segment.subcommand));\n    }\n  }\n  lines.push(segmentsText.computeStyledString(typoSupport));\n\n  lines.push(\"\");\n  const introText = new TypoText();\n  introText.push(textUsageText(usage.information.description));\n  if (usage.information.hint !== undefined) {\n    introText.push(textDelimiter(\" \"));\n    introText.push(textSubtleInfo(`(${usage.information.hint})`));\n  }\n  lines.push(introText.computeStyledString(typoSupport));\n  for (const detail of usage.information.details ?? []) {\n    const detailText = new TypoText();\n    detailText.push(textSubtleInfo(detail));\n    lines.push(detailText.computeStyledString(typoSupport));\n  }\n\n  if (usage.positionals.length > 0) {\n    lines.push(\"\");\n    lines.push(textBlockTitle(\"Positionals:\").computeStyledString(typoSupport));\n    const typoGrid = new TypoGrid();\n    for (const positionalUsage of usage.positionals) {\n      const typoGridRow = new Array<TypoText>();\n      typoGridRow.push(new TypoText(textDelimiter(\"  \")));\n      typoGridRow.push(new TypoText(textUserInput(positionalUsage.label)));\n      typoGridRow.push(...createInformationals(positionalUsage));\n      typoGrid.pushRow(typoGridRow);\n    }\n    lines.push(...typoGrid.computeStyledLines(typoSupport));\n  }\n\n  if (usage.subcommands.length > 0) {\n    lines.push(\"\");\n    lines.push(textBlockTitle(\"Subcommands:\").computeStyledString(typoSupport));\n    const typoGrid = new TypoGrid();\n    for (const subcommandUsage of usage.subcommands) {\n      const typoGridRow = new Array<TypoText>();\n      typoGridRow.push(new TypoText(textDelimiter(\"  \")));\n      typoGridRow.push(new TypoText(textConstants(subcommandUsage.name)));\n      typoGridRow.push(...createInformationals(subcommandUsage));\n      typoGrid.pushRow(typoGridRow);\n    }\n    lines.push(...typoGrid.computeStyledLines(typoSupport));\n  }\n\n  if (usage.options.length > 0) {\n    lines.push(\"\");\n    lines.push(textBlockTitle(\"Options:\").computeStyledString(typoSupport));\n    const typoGrid = new TypoGrid();\n    for (const optionUsage of usage.options) {\n      const typoGridRow = new Array<TypoText>();\n      typoGridRow.push(new TypoText(textDelimiter(\"  \")));\n      if (optionUsage.short !== undefined) {\n        typoGridRow.push(\n          new TypoText(\n            textConstants(`-${optionUsage.short}`),\n            textDelimiter(\", \"),\n          ),\n        );\n      } else {\n        typoGridRow.push(new TypoText());\n      }\n      const longOptionText = new TypoText(\n        textConstants(`--${optionUsage.long}`),\n      );\n      if (optionUsage.label !== undefined) {\n        longOptionText.push(textDelimiter(\" \"));\n        longOptionText.push(textUserInput(optionUsage.label));\n      }\n      if (optionUsage.annotation !== undefined) {\n        longOptionText.push(textSubtleInfo(optionUsage.annotation));\n      }\n      typoGridRow.push(longOptionText);\n      typoGridRow.push(...createInformationals(optionUsage));\n      typoGrid.pushRow(typoGridRow);\n    }\n    lines.push(...typoGrid.computeStyledLines(typoSupport));\n  }\n\n  if (usage.information.examples !== undefined) {\n    lines.push(\"\");\n    lines.push(textBlockTitle(\"Examples:\").computeStyledString(typoSupport));\n    for (const example of usage.information.examples) {\n      const explanationText = new TypoText();\n      explanationText.push(textDelimiter(\" \"));\n      explanationText.push(textSubtleInfo(`# ${example.explanation}`));\n      lines.push(explanationText.computeStyledString(typoSupport));\n      const commandLineText = new TypoText();\n      commandLineText.push(textDelimiter(\" \"));\n      commandLineText.push(textConstants(cliName));\n      for (const commandArg of example.commandArgs) {\n        commandLineText.push(textDelimiter(\" \"));\n        if (typeof commandArg === \"string\") {\n          commandLineText.push(new TypoString(commandArg));\n        } else if (\"positional\" in commandArg) {\n          commandLineText.push(textUserInput(commandArg.positional));\n        } else if (\"subcommand\" in commandArg) {\n          commandLineText.push(textConstants(commandArg.subcommand));\n        } else if (\"option\" in commandArg) {\n          const option = commandArg.option;\n          if (\"short\" in option) {\n            commandLineText.push(textConstants(`-${option.short}`));\n          } else {\n            commandLineText.push(textConstants(`--${option.long}`));\n          }\n          if (option.inlined !== undefined) {\n            commandLineText.push(textSubtleInfo(\"=\"));\n            commandLineText.push(textUserInput(option.inlined));\n          }\n          if (option.separated !== undefined) {\n            for (const separatedValue of option.separated) {\n              commandLineText.push(textDelimiter(\" \"));\n              commandLineText.push(textUserInput(separatedValue));\n            }\n          }\n        }\n      }\n      lines.push(commandLineText.computeStyledString(typoSupport));\n    }\n  }\n\n  lines.push(\"\");\n  return lines;\n}\n\nfunction createInformationals(usage: {\n  description?: string | undefined;\n  hint?: string | undefined;\n}): Array<TypoText> {\n  const informationals = [];\n  if (usage.description !== undefined) {\n    informationals.push(textDelimiter(\" \"));\n    informationals.push(textUsefulInfo(usage.description));\n  }\n  if (usage.hint !== undefined) {\n    informationals.push(textDelimiter(\" \"));\n    informationals.push(textSubtleInfo(`(${usage.hint})`));\n  }\n  if (informationals.length > 0) {\n    return [new TypoText(textDelimiter(\" \"), ...informationals)];\n  }\n  return [];\n}\n\nfunction textUsageHero(value: string): TypoString {\n  return new TypoString(value, typoStyleLogic);\n}\n\nfunction textUsageText(value: string): TypoString {\n  return new TypoString(value, typoStyleRegularStrong);\n}\n\nfunction textUsefulInfo(value: string): TypoString {\n  return new TypoString(value);\n}\n\nfunction textBlockTitle(value: string): TypoString {\n  return new TypoString(value, typoStyleTitle);\n}\n\nfunction textSubtleInfo(value: string): TypoString {\n  return new TypoString(value, typoStyleRegularWeaker);\n}\n\nfunction textConstants(value: string): TypoString {\n  return new TypoString(value, typoStyleConstants);\n}\n\nfunction textUserInput(value: string): TypoString {\n  return new TypoString(value, typoStyleUserInput);\n}\n\nfunction textDelimiter(value: string): TypoString {\n  return new TypoString(value);\n}\n","import { Command, CommandDecoder } from \"./Command\";\nimport { optionFlag, optionSingleValue } from \"./Option\";\nimport { ReaderArgs } from \"./Reader\";\nimport { typeChoice } from \"./Type\";\nimport { TypoSupport } from \"./Typo\";\nimport { usageToStyledLines } from \"./Usage\";\n\n/**\n * Color selection modes availables\n */\nexport type RunColorMode = \"env\" | \"always\" | \"never\" | \"mock\";\n\n/**\n * Main entry point: parses CLI arguments, executes the matched command, and exits.\n * Handles `--help`, `--version`, usage-on-error, and exit codes.\n *\n * Exit codes:\n *  - `0` on success / `--help` / `--version`\n *  - `1` on parse error or execution error.\n *\n * @typeParam Context - Forwarded unchanged to the handler.\n *\n * @param cliName - Program name used in usage and `--version` output.\n * @param cliArgs - Raw arguments, typically `process.argv.slice(2)`.\n * @param context - Forwarded to the handler.\n * @param command - Root {@link Command}.\n * @param options.colorSetup - Configures color support; enables `--color` flag if set to `\"flag\"`.\n * @param options.usageOnHelp - Enables `--help` flag (default `true`).\n * @param options.usageOnError - Prints usage to stderr on parse error (default `true`).\n * @param options.buildVersion - Enables `--version`; prints `<cliName> <buildVersion>`.\n * @param options.onError - Custom handler for errors.\n * @param options.onExit - Overrides `process.exit`; useful for testing.\n *\n * @returns `Promise<never>` — always calls `onExit`.\n *\n * @example\n * ```ts\n * import { runAndExit, command, operation, positionalRequired, type } from \"cli-kiss\";\n *\n * const greetCommand = command(\n *   { description: \"Greet someone\" },\n *   operation(\n *     { options: {}, positionals: [positionalRequired({ type: type(\"name\") })] },\n *     async function (_ctx, { positionals: [name] }) {\n *       console.log(`Hello, ${name}!`);\n *     },\n *   ),\n * );\n *\n * await runAndExit(\"greet\", process.argv.slice(2), undefined, greetCommand, {\n *   buildVersion: \"1.0.0\",\n * });\n * ```\n */\nexport async function runAndExit<Context>(\n  cliName: string,\n  cliArgs: ReadonlyArray<string>,\n  context: Context,\n  command: Command<Context, void>,\n  options?: {\n    colorSetup?: \"flag\" | RunColorMode | undefined;\n    usageOnHelp?: boolean | undefined;\n    usageOnError?: boolean | undefined;\n    buildVersion?: string | undefined;\n    onError?: ((error: unknown) => void) | undefined;\n    onExit?: ((code: number) => never) | undefined;\n  },\n): Promise<never> {\n  const readerArgs = new ReaderArgs(cliArgs);\n  const preprocessors = new Array<\n    (commandDecoder: CommandDecoder<Context, void>) => undefined | number\n  >();\n  let typoSupport = TypoSupport.none();\n  const colorSetup = options?.colorSetup ?? \"flag\";\n  if (colorSetup === \"flag\") {\n    const colorOption = optionSingleValue<\"auto\" | RunColorMode>({\n      long: \"color\",\n      type: typeChoice(\"color-mode\", [\"auto\", \"always\", \"never\"]),\n      fallbackValueIfAbsent: () => \"auto\",\n      impliedValueIfNotInlined: () => \"always\",\n    }).registerAndMakeDecoder(readerArgs);\n    preprocessors.push(() => {\n      try {\n        typoSupport = computeTypoSupport(colorOption.getAndDecodeValue());\n      } catch (error) {\n        typoSupport = TypoSupport.inferFromEnv();\n        throw error;\n      }\n      return undefined;\n    });\n  } else {\n    typoSupport = computeTypoSupport(colorSetup);\n  }\n  if (options?.usageOnHelp ?? true) {\n    const helpOption = optionFlag({ long: \"help\" }).registerAndMakeDecoder(\n      readerArgs,\n    );\n    preprocessors.push((commandDecoder) => {\n      if (!helpOption.getAndDecodeValue()) {\n        return undefined;\n      }\n      console.log(computeUsageString(cliName, commandDecoder, typoSupport));\n      return 0;\n    });\n  }\n  if (options?.buildVersion !== undefined) {\n    const versionOption = optionFlag({\n      long: \"version\",\n    }).registerAndMakeDecoder(readerArgs);\n    preprocessors.push(() => {\n      if (!versionOption.getAndDecodeValue()) {\n        return undefined;\n      }\n      console.log([cliName, options.buildVersion].join(\" \"));\n      return 0;\n    });\n  }\n  // TODO - the lifecycle of this function should be improved\n  // TODO - how to pass the color TypoSupport to the command logic ?\n  // TODO - handle completions generators ?\n  /*\n  readerArgs.registerFlag({\n    key: \"completion\",\n    shorts: [],\n    longs: [\"completion\"],\n  });\n  */\n  const commandDecoder = command.consumeAndMakeDecoder(readerArgs);\n  while (true) {\n    try {\n      const positional = readerArgs.consumePositional();\n      if (positional === undefined) {\n        break;\n      }\n    } catch (_) {}\n  }\n  const onExit = options?.onExit ?? process.exit;\n  try {\n    for (const preprocessor of preprocessors) {\n      const preprocessorResult = preprocessor(commandDecoder);\n      if (preprocessorResult !== undefined) {\n        return onExit(preprocessorResult);\n      }\n    }\n    const commandInterpreter = commandDecoder.decodeAndMakeInterpreter();\n    try {\n      await commandInterpreter.executeWithContext(context);\n      return onExit(0);\n    } catch (executionError) {\n      handleError(cliName, options?.onError, executionError, typoSupport);\n      return onExit(1);\n    }\n  } catch (parsingError) {\n    if (options?.usageOnError ?? true) {\n      console.error(computeUsageString(cliName, commandDecoder, typoSupport));\n    }\n    handleError(cliName, options?.onError, parsingError, typoSupport);\n    return onExit(1);\n  }\n}\n\nfunction handleError(\n  _cliName: string,\n  onError: ((error: unknown) => void) | undefined,\n  error: unknown,\n  typoSupport: TypoSupport,\n) {\n  // TODO - should the cliName be part of the error message for logs ?\n  const finalError = error;\n  /*\n  const finalError = new TypoError(\n    new TypoText(new TypoString(cliName, typoStyleConstants)),\n    error,\n  );\n  */\n  if (onError !== undefined) {\n    onError(finalError);\n  } else {\n    console.error(typoSupport.computeStyledErrorMessage(finalError));\n  }\n}\n\nfunction computeUsageString<Context, Result>(\n  cliName: string,\n  commandDecoder: CommandDecoder<Context, Result>,\n  typoSupport: TypoSupport,\n) {\n  return usageToStyledLines({\n    cliName,\n    usage: commandDecoder.generateUsage(),\n    typoSupport,\n  }).join(\"\\n\");\n}\n\nfunction computeTypoSupport(colorMode: \"auto\" | RunColorMode): TypoSupport {\n  switch (colorMode) {\n    case \"auto\":\n      return TypoSupport.inferFromEnv();\n    case \"env\":\n      return TypoSupport.inferFromEnv();\n    case \"always\":\n      return TypoSupport.tty();\n    case \"never\":\n      return TypoSupport.none();\n    case \"mock\":\n      return TypoSupport.mock();\n  }\n}\n"],"mappings":"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","names":["index_exports","__export","ReaderArgs","TypoError","TypoGrid","TypoString","TypoSupport","TypoText","command","commandChained","commandWithSubcommands","operation","optionFlag","optionRepeatable","optionSingleValue","positionalOptional","positionalRequired","positionalVariadics","runAndExit","suggestTextPushMessage","typeBoolean","typeChoice","typeDatetime","typeInteger","typeList","typeMapped","typeNumber","typePath","typeRenamed","typeString","typeTuple","typeUrl","typoStyleConstants","typoStyleFailure","typoStyleLogic","typoStyleQuote","typoStyleRegularStrong","typoStyleRegularWeaker","typoStyleTitle","typoStyleUserInput","usageToStyledLines","__toCommonJS","typoStyleTitle","typoStyleLogic","typoStyleQuote","typoStyleFailure","typoStyleConstants","typoStyleUserInput","typoStyleRegularStrong","typoStyleRegularWeaker","_value","_style","_TypoString","value","style","__privateAdd","__privateSet","typoSupport","__privateGet","TypoString","_strings","_TypoText","segments","segment","part","separator","ellipsisLimit","index","t","length","typoString","TypoText","_typoRows","TypoGrid","cells","widths","styledLines","typoGridRow","typoGridColumnIndex","width","styledGridRow","typoGridCell","padding","_typoText","_TypoError","currentTypoText","source","typoText","thrower","context","error","TypoError","_kind","_TypoSupport","kind","readEnvVar","envForceColor","typoStyle","styledValue","fgColorCode","ttyCodeFgColors","bgColorCode","ttyCodeBgColors","boldCode","ttyCodeBold","dimCode","ttyCodeDim","italicCode","ttyCodeItalic","underlineCode","ttyCodeUnderline","strikethroughCode","ttyCodeStrikethrough","ttyCodeReset","fgColorPart","bgColorPart","boldPart","dimPart","italicPart","underlinePart","TypoSupport","name","suggestTextPushMessage","text","query","candidates","reasonableHints","suggestReasonablePayloads","reference","hint","TypoString","sortedAlternatives","computeAndSortByDivergences","divergenceThreshold","acceptablePayloads","divergence","payload","queryNormalized","referenceNormalized","distanceDamerauLevenshtein","a","b","m","n","dp","i","j","cost","command","information","operation","readerArgs","operationDecoder","endPositional","errorText","TypoText","TypoString","typoStyleQuote","TypoError","generateUsageLeaf","operationInterpreter","context","error","commandWithSubcommands","subcommands","subcommandNames","name","subcommandName","typoStyleUserInput","suggestSubcommandNames","subcommandInput","subcommandDecoder","subcommandUsage","currentUsage","subcommandInterpreter","subcommand","description","hint","commandChained","positionals","options","p","input","suggestTextPushMessage","typoStyleConstants","operation","inputs","handler","optionsUsage","optionKey","optionInput","positionalsUsage","positionalInput","readerArgs","optionsDecoders","positionalsDecoders","optionsValues","positionalsValues","positionalDecoder","context","import_fs","typeString","name","input","typeBoolean","lowerInput","typeBooleanValuesTrue","typeBooleanValuesFalse","throwInvalidValue","typeNumber","parsed","typeInteger","typeDatetime","timestampMs","typeUrl","typePath","checks","safeStatSync","path","error","TypoError","TypoText","TypoString","typoStyleQuote","stats","preview","typeChoice","values","caseSensitive","normalize","valueByNormalized","value","errorText","suggestTextPushMessage","typeMapped","before","mapper","typoStyleLogic","typeRenamed","type","typeTuple","elementTypes","separator","elementType","splits","split","index","typeList","kind","optionFlag","definition","type","typeBoolean","long","short","description","hint","aliases","readerOptions","resultsGetter","setupOptionAliased","results","throwSetMultipleTimesError","r","input","decodeValue","optionSingleValue","label","annotation","value","result","errorText","makeErrorText","TypoString","TypoError","error","inlined","separated","optionRepeatable","params","TypoText","typoStyleConstants","typoStyleUserInput","typoStyleLogic","longKey","shortKey","aliasLongKeys","aliasShortKeys","longKeys","shortKeys","setupOptionMany","nextGuard","consumeGroupRestAsValue","getters","key","identifier","getter","identifiers","identifiersTexts","positionalRequired","definition","description","hint","type","label","readerPositionals","positional","errorText","makeErrorTextLabel","TypoString","typoStyleRegularWeaker","TypoError","decodeValue","positionalOptional","error","positionalVariadics","labelSingle","labelMultiple","positionals","input","TypoText","typoStyleUserInput","message","_tokens","_parsedIndex","_parsedDouble","_optionLongContextByIdentifier","_optionShortContextByIdentifier","_ReaderArgs_instances","consumeToken_fn","tryConsumeAsOption_fn","consumeOptionLong_fn","tryConsumeOptionShort_fn","consumeOptionValues_fn","throwUnknownOptionError_fn","ReaderArgs","tokens","__privateAdd","__privateSet","longSpec","identifier","isValidOptionKey","__privateGet","values","shortSpec","i","slicedIdentifier","otherIdentifier","token","__privateMethod","__privateWrapper","valueIndexStart","shortIndexStart","shortIndexEnd","shortContext","tokenRest","valueInlined","longContext","context","value","spec","nextToken","TypoError","TypoText","TypoString","typoStyleConstants","typoStyleQuote","inputIdentifier","candidatesIdentifiers","errorText","suggestTextPushMessage","candidateIdentifier","name","usageToStyledLines","params","cliName","usage","typoSupport","lines","segmentsText","TypoText","textUsageHero","textDelimiter","textConstants","segment","textUserInput","introText","textUsageText","textSubtleInfo","detail","detailText","textBlockTitle","typoGrid","TypoGrid","positionalUsage","typoGridRow","createInformationals","subcommandUsage","optionUsage","longOptionText","example","explanationText","commandLineText","commandArg","TypoString","option","separatedValue","informationals","textUsefulInfo","value","typoStyleLogic","typoStyleRegularStrong","typoStyleTitle","typoStyleRegularWeaker","typoStyleConstants","typoStyleUserInput","runAndExit","cliName","cliArgs","context","command","options","readerArgs","ReaderArgs","preprocessors","typoSupport","TypoSupport","colorSetup","colorOption","optionSingleValue","typeChoice","computeTypoSupport","error","helpOption","optionFlag","commandDecoder","computeUsageString","versionOption","onExit","preprocessor","preprocessorResult","commandInterpreter","executionError","handleError","parsingError","_cliName","onError","finalError","usageToStyledLines","colorMode"]}