code: public QueryBuilder withShadowScope(ShadowScope shadowScope){
          Validate.argumentIsNotNull(shadowScope);
          this.shadowScope = shadowScope;
          if (shadowScope == DEEP_PLUS && maxGapsToFill == 0) {
              this.maxGapsToFill = DEFAULT_GAPS_TO_FILL_LIMIT;
          }
  
          return this;
      }
docs: Choose between <i>shallow</i>, <i>child-value-object</i>, </i><i>commit-deep</i> or <i>deep+</i> query scopes.
  <br/>
  The wider the scope, the more object shadows are loaded to the resulting graph.
  <br/><br/>
  
  Default scope is {@link ShadowScope#SHALLOW}.
  <br/><br/>
  
  Read more about query scopes in {@link Javers#findShadows(JqlQuery)} javadoc.
  <br/><br/>
  
  Only for Shadow queries.
  
  @see <a href="http://javers.org/documentation/jql-examples/">http://javers.org/documentation/jql-examples</a>
  @since 3.2