Method parse

src/cac.ts:174–261

* Parse argv

(
    argv?: string[],
    {
      run = true,
    }: {
      /** Whether to run the action for matched command */
      run?: boolean | undefined
    } = {},
  )

   * Parse argv
   */
  parse(
    argv?: string[],
    {
      run = true,
    }: {
      /** Whether to run the action for matched command */
      run?: boolean | undefined
    } = {},
  ): ParsedArgv {
    if (!argv) {
      if (!runtimeProcessArgs) {
        throw new Error(
          'No argv provided and runtime process argv is not available.',
        )
      }
      argv = runtimeProcessArgs
    }

    this.rawArgs = argv
    if (!this.name) {
      this.name = argv[1] ? getFileName(argv[1]) : 'cli'
    }

    let shouldParse = true

    // Search sub-commands
    for (const command of this.commands) {
      const parsed = this.mri(argv.slice(2), command)

      const commandName = parsed.args[0]
      if (command.isMatched(commandName)) {
        shouldParse = false
        const parsedInfo = {
          ...parsed,
          args: parsed.args.slice(1),
        }
        this.setParsedInfo(parsedInfo, command, commandName)
        this.dispatchEvent(
          new CustomEvent(`command:${commandName}`, { detail: command }),
        )
      }
    }

    if (shouldParse) {
      // Search the default command
      for (const command of this.commands) {
        if (command.isDefaultCommand) {
          shouldParse = false
          const parsed = this.mri(argv.slice(2), command)
          this.setParsedInfo(parsed, command)
          this.dispatchEvent(new CustomEvent('command:!', { detail: command }))
        }
      }
    }

    if (shouldParse) {
      const parsed = this.mri(argv.slice(2))
      this.setParsedInfo(parsed)