Function consumeLevel

packages/effect/src/unstable/cli/internal/parser.ts:636–708

(
    tokens: ReadonlyArray<Token>,
    command: Command.Any,
    ignoredRegistries: ReadonlyArray<FlagRegistry>
  )

  const errors: Array<CliError.InvalidValue> = []

  const consumeLevel = (
    tokens: ReadonlyArray<Token>,
    command: Command.Any,
    ignoredRegistries: ReadonlyArray<FlagRegistry>
  ): ReadonlyArray<Token> => {
    const localRegistry = createFlagRegistry(extractFlagParams(command))
    const inheritedRegistry = createFlagRegistry(extractContextFlagParams(command))
    const subIndex = buildSubcommandIndex(command.subcommands)
    const cursor = makeCursor(tokens)
    const remainder: Array<Token> = []
    let awaitingFirstValue = true

    for (let token = cursor.take(); token; token = cursor.take()) {
      if (isFlagToken(token)) {
        const ignored = resolveFromRegistries(token, ignoredRegistries)
        if (ignored !== undefined) {
          preserveFlag(remainder, cursor, token, ignored)
          continue
        }

        const inherited = resolveFlag(token, inheritedRegistry)
        if (inherited !== undefined) {
          preserveFlag(remainder, cursor, token, inherited)
          continue
        }

        const local = resolveFlag(token, localRegistry)
        const global = resolveFlag(token, registry)
        if (local !== undefined) {
          if (
            global === undefined || !awaitingFirstValue ||
            !localFlagWouldPrecedeSubcommand(token, cursor.rest(), local, subIndex, [
              localRegistry,
              inheritedRegistry,
              registry
            ])
          ) {
            preserveFlag(remainder, cursor, token, local)
            continue
          }
        }

        if (global !== undefined) {
          const consumed = consumeFlagValueWithTokens(cursor, token, global.param, global.negated)
          if (consumed._tag === "Error") {
            errors.push(consumed.error)
            continue
          }
          if (consumed.value !== undefined) {
            flagMap[global.param.name].push(consumed.value)
          }
          continue
        }

        remainder.push(token)
        continue
      }