Authoritative descriptions of every directive, every Maven plugin parameter, every runtime API entry point, and every diagnostic code Graphitron emits.
Runtime API
-
Runtime API reference: the
Graphitron.buildSchema(…)facade (single-arg and federation two-arg overloads), theGraphitron.newExecutionInput(…)schema-driven factory (DSLContextfirst, then typedcontextArgumentslots reflected from your@service/@conditiondirectives), the sealedGraphitronContextper-request interface (getDslContext,getContextArgument,getValidator), and theNodeIdEncoderutility (genericencode/peekTypeId/decodeValuesplus per-Nodeencode<TypeName>anddecode<TypeName>helpers).
Maven plugin
-
Maven plugin configuration: every parameter on every goal of
graphitron-maven-plugin. Covers the three goals (generate,validate,dev), the shared<configuration>parameters (outputDirectory,outputPackage,jooqPackage,schemaInputs), thedev-only watch parameters (port,debounceMs,skipInitial), and the<schemaInput>POM binding.
Editor support
-
LSP requirements: the LSP’s native runtime. Both the GraphQL grammar and the
libtree-sitterruntime ship bundled, so there is no system dependency to install. Covers the supported host architectures and the startup diagnostics. -
LSP inlay hints and classification hover: the three editor-side config keys (
graphitron.inlayHints.inferredDirectives,graphitron.inlayHints.classification,graphitron.hover.classification) that surface Graphitron’s inference and classification layers inside the editor. Default off; opt in per key.
Diagnostics
-
Diagnostics glossary: every closed-set diagnostic code the validator emits, organised by category. Covers the three top-level rejection kinds (
author-error,invalid-schema,deferred), the nine name-lookup attempt kinds (column,table,foreign-key,service-method,lifter-method,enum-constant,type-name,nodeid-key-column,dml-kind), and the four deferred emit-block reasons.
Deprecations
-
Deprecations: aggregator for every deprecated directive argument, input field, and whole directive in the rewrite, with migration guidance pointing back at the canonical directive page.
Directives
-
Directive reference: every directive in the rewrite’s
directives.graphqls, listed alphabetically and grouped by category. Each directive page carries its SDL signature, parameter table, canonical examples from the Sakila example schema, constraints, and cross-links to the recipes and explanation pages that frame it.