Function processArgs

packages/cli/src/internal/options.ts:1686–1715

(
  args: ReadonlyArray<string>
)

 *      ["--option", "value"])
 */
const processArgs = (
  args: ReadonlyArray<string>
): Effect.Effect<ReadonlyArray<string>, ValidationError.ValidationError> =>
  Arr.matchLeft(args, {
    onEmpty: () => Effect.succeed(Arr.empty()),
    onNonEmpty: (head, tail) => {
      const value = head.trim()
      // Attempt to match clustered short command-line arguments (i.e. `-abc`)
      if (CLUSTERED_REGEX.test(value)) {
        const unclustered = value.substring(1).split("").map((c) => `-${c}`)
        return Effect.fail(InternalValidationError.unclusteredFlag(
          InternalHelpDoc.empty,
          unclustered,
          tail
        ))
      }
      // Attempt to match a long command-line argument and ensure the option and
      // it's value have been separated and added back to the arguments
      if (FLAG_REGEX.test(value)) {
        const result = FLAG_REGEX.exec(value)
        if (result !== null && result[2] !== undefined) {
          return Effect.succeed<ReadonlyArray<string>>(
            Arr.appendAll([result[1], result[2]], tail)
          )
        }
      }
      // Otherwise return the original command-line arguments
      return Effect.succeed(args)
    }
  })

/**
 * Processes the command-line arguments for a parseable option, returning the