Summary

PR #4229 removed clearDirectives() from GraphQLSchema.Builder as part of unifying built-in directive handling. As noted in issue #4259, this method is useful in practice: a common pattern when using GraphQLSchema.transform is to collect the non-built-in directives from the source schema, call clearDirectives() on the builder, and then add back transformed versions of those directives.

This PR re-adds clearDirectives() with semantics that are consistent with the approach introduced in #4229:

• Clears additionalDirectives entirely (including any explicitly-added built-ins)
• Built-in directives are always re-added automatically at build time by ensureBuiltInDirectives(), so they cannot be permanently removed — all built-ins are treated uniformly

Changes

• Re-adds Builder.clearDirectives() to GraphQLSchema with Javadoc illustrating the transform use case
• Adds tests covering:
  • clearDirectives() followed by build() still yields all 7 built-in directives
  • clearDirectives() followed by adding a custom directive yields the expected set
  • The primary use case: using clearDirectives() in a schema.transform() to replace non-built-in directives
  • Ordering behavior: unoverridden built-ins sort first, then user-supplied directives in insertion order; customized built-ins retain their custom properties

Related

Fixes #4259. See also #4229.