feat(graphql-apt): honor @deprecated schema directive with class/method overrides

[velo]

Summary

• Adds generateDeprecated to @GraphqlSchema (boolean, default true) and @GraphqlQuery (Toggle, default INHERIT) so code generation for GraphQL-deprecated fields/enum values can be disabled per class or overridden per method.
• When a deprecated element is emitted, the generated Java is annotated with @Deprecated so the deprecation propagates into downstream code.
• Covers result records (from query selections), input type records, full object type records, and enum constants.

Test plan

• mvn -pl graphql,graphql-apt test — 116 tests green
• Default keeps deprecated fields and stamps @Deprecated on output
• Class-level generateDeprecated = false skips deprecated fields, input fields, and enum values
• Method-level Toggle.TRUE re-enables generation (and still stamps @Deprecated)
• Method-level Toggle.FALSE disables for that method only