@depup/graphql-codegen__plugin-helpers 6.2.0-depup.1 → 7.1.0-depup.8

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Dotan Simha
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -13,18 +13,17 @@ npm install @depup/graphql-codegen__plugin-helpers
 
 | Field | Value |
 |-------|-------|
-| Original | [@graphql-codegen/plugin-helpers](https://www.npmjs.com/package/@graphql-codegen/plugin-helpers) @ 6.2.0 |
-| Processed | 2026-03-31 |
+| Original | [@graphql-codegen/plugin-helpers](https://www.npmjs.com/package/@graphql-codegen/plugin-helpers) @ 7.1.0 |
+| Processed | 2026-07-21 |
 | Smoke test | passed |
-| Deps updated | 3 |
+| Deps updated | 2 |
 
 ## Dependency Changes
 
 | Dependency | From | To |
 |------------|------|-----|
-| change-case-all | 1.0.15 | ^2.1.0 |
-| lodash | ~4.17.0 | ^4.18.0 |
-| tslib | ~2.6.0 | ^2.8.1 |
+| @graphql-tools/utils | ^11.2.0 | ^11.2.2 |
+| tslib | ^2.8.0 | ^2.8.1 |
 
 ---
 

package/changes.json

@@ -1,18 +1,14 @@
 {
   "bumped": {
-    "change-case-all": {
-      "from": "1.0.15",
-      "to": "^2.1.0"
-    },
-    "lodash": {
-      "from": "~4.17.0",
-      "to": "^4.18.0"
+    "@graphql-tools/utils": {
+      "from": "^11.2.0",
+      "to": "^11.2.2"
     },
     "tslib": {
-      "from": "~2.6.0",
+      "from": "^2.8.0",
       "to": "^2.8.1"
     }
   },
-  "timestamp": "2026-03-31T20:20:31.084Z",
-  "totalUpdated": 3
+  "timestamp": "2026-07-21T16:05:24.059Z",
+  "totalUpdated": 2
 }

package/cjs/federation.js

@@ -3,8 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApolloFederation = exports.federationSpec = void 0;
 exports.addFederationReferencesToSchema = addFederationReferencesToSchema;
 exports.removeFederation = removeFederation;
-const utils_1 = require("@graphql-tools/utils");
 const graphql_1 = require("graphql");
+const utils_1 = require("@graphql-tools/utils");
 const index_js_1 = require("./index.js");
 const utils_js_1 = require("./utils.js");
 /**
@@ -25,7 +25,7 @@ exports.federationSpec = (0, graphql_1.parse)(/* GraphQL */ `
  * - return type
  * @param schema
  */
-function addFederationReferencesToSchema(schema) {
+function addFederationReferencesToSchema(schema, config) {
     const setFederationMeta = ({ meta, typeName, update, }) => {
         meta[typeName] = {
             ...(meta[typeName] ||
@@ -43,7 +43,10 @@ function addFederationReferencesToSchema(schema) {
         // @key() @key() - "primary keys" in Federation
         // A reference may receive one primary key combination at a time, so they will be combined with `|`
         const primaryKeys = resolvableKeyDirectives.map(extractReferenceSelectionSet);
-        referenceSelectionSets.push({ directive: '@key', selectionSets: [...primaryKeys] });
+        referenceSelectionSets.push({
+            directive: '@key',
+            selectionSets: [...primaryKeys],
+        });
         const requiresPossibleTypes = [];
         for (const fieldNode of Object.values(fields)) {
             // Look for @requires and see what the service needs and gets
@@ -53,7 +56,10 @@ function addFederationReferencesToSchema(schema) {
                 requiresPossibleTypes.push(requires);
             }
         }
-        referenceSelectionSets.push({ directive: '@requires', selectionSets: requiresPossibleTypes });
+        referenceSelectionSets.push({
+            directive: '@requires',
+            selectionSets: requiresPossibleTypes,
+        });
         return referenceSelectionSets;
     };
     /**
@@ -149,6 +155,8 @@ function addFederationReferencesToSchema(schema) {
                 typeConfig.fields = {
                     [resolveReferenceFieldName]: {
                         type,
+                        args: {},
+                        extensions: {},
                     },
                     ...typeConfig.fields,
                 };
@@ -158,7 +166,7 @@ function addFederationReferencesToSchema(schema) {
                 });
                 const referenceSelectionSetsString = printReferenceSelectionSets({
                     typeName: type.name,
-                    baseFederationType: `FederationTypes['${type.name}']`, // FIXME: run convertName on FederationTypes
+                    baseFederationType: `${config.convertName('FederationTypes')}['${type.name}']`,
                     referenceSelectionSets,
                 });
                 setFederationMeta({
@@ -187,12 +195,14 @@ function addFederationReferencesToSchema(schema) {
                 typeConfig.fields = {
                     [resolveReferenceFieldName]: {
                         type,
+                        args: {},
+                        extensions: {},
                     },
                     ...typeConfig.fields,
                 };
                 const referenceSelectionSetsString = printReferenceSelectionSets({
                     typeName: type.name,
-                    baseFederationType: `FederationTypes['${type.name}']`, // FIXME: run convertName on FederationTypes
+                    baseFederationType: `${config.convertName('FederationTypes')}['${type.name}']`,
                     referenceSelectionSets,
                 });
                 setFederationMeta({
@@ -254,7 +264,7 @@ class ApolloFederation {
      */
     fieldsToGenerate;
     meta = {};
-    constructor({ enabled, schema, meta }) {
+    constructor({ enabled, schema, meta, }) {
         this.enabled = enabled;
         this.schema = schema;
         this.providesMap = this.createMapOfProvides();
@@ -395,7 +405,9 @@ function checkTypeFederationDetails(node, schema) {
     }
     const resolvableKeyDirectives = keyDirectives.filter(d => {
         for (const arg of d.arguments) {
-            if (arg.name.value === 'resolvable' && arg.value.kind === 'BooleanValue' && arg.value.value === false) {
+            if (arg.name.value === 'resolvable' &&
+                arg.value.kind === 'BooleanValue' &&
+                arg.value.value === false) {
                 return false;
             }
         }

package/cjs/helpers.js

@@ -68,10 +68,10 @@ function isUsingTypes(document, externalFragments, schema) {
             enter(node, key, parent, anscestors) {
                 const insideIgnoredFragment = anscestors.find((f) => f.kind && f.kind === 'FragmentDefinition' && externalFragments.includes(f.name.value));
                 if (insideIgnoredFragment) {
-                    return;
+                    return node;
                 }
                 const selections = node.selections || [];
-                if (schema && selections.length > 0) {
+                if (schema && selections.length > 0 && !Array.isArray(parent) && 'kind' in parent) {
                     const nextTypeName = (() => {
                         if (parent.kind === graphql_1.Kind.FRAGMENT_DEFINITION) {
                             return parent.typeCondition.name.value;
@@ -107,23 +107,26 @@ function isUsingTypes(document, externalFragments, schema) {
                         return null;
                     })();
                     typesStack.push(schema.getType(nextTypeName));
+                    return node;
                 }
+                return undefined;
             },
             leave(node) {
                 const selections = node.selections || [];
                 if (schema && selections.length > 0) {
                     typesStack.pop();
                 }
+                return node;
             },
         },
         Field: {
             enter: (node, key, parent, path, anscestors) => {
                 if (node.name.value.startsWith('__')) {
-                    return;
+                    return node;
                 }
                 const insideIgnoredFragment = anscestors.find((f) => f.kind && f.kind === 'FragmentDefinition' && externalFragments.includes(f.name.value));
                 if (insideIgnoredFragment) {
-                    return;
+                    return node;
                 }
                 const selections = node.selectionSet ? node.selectionSet.selections || [] : [];
                 const relevantFragmentSpreads = selections.filter(s => s.kind === graphql_1.Kind.FRAGMENT_SPREAD && !externalFragments.includes(s.name.value));
@@ -144,24 +147,27 @@ function isUsingTypes(document, externalFragments, schema) {
                         }
                     }
                 }
+                return undefined;
             },
         },
         VariableDefinition: {
             enter: (node, key, parent, path, anscestors) => {
                 const insideIgnoredFragment = anscestors.find((f) => f.kind && f.kind === 'FragmentDefinition' && externalFragments.includes(f.name.value));
                 if (insideIgnoredFragment) {
-                    return;
+                    return node;
                 }
                 foundFields++;
+                return undefined;
             },
         },
         InputValueDefinition: {
             enter: (node, key, parent, path, anscestors) => {
                 const insideIgnoredFragment = anscestors.find((f) => f.kind && f.kind === 'FragmentDefinition' && externalFragments.includes(f.name.value));
                 if (insideIgnoredFragment) {
-                    return;
+                    return node;
                 }
                 foundFields++;
+                return node;
             },
         },
     });

package/cjs/utils.js

@@ -6,7 +6,11 @@ exports.getBaseType = getBaseType;
 exports.removeNonNullWrapper = removeNonNullWrapper;
 const graphql_1 = require("graphql");
 function mergeOutputs(content) {
-    const result = { content: '', prepend: [], append: [] };
+    const result = {
+        content: '',
+        prepend: [],
+        append: [],
+    };
     if (Array.isArray(content)) {
         for (const item of content) {
             if (typeof item === 'string') {

package/esm/federation.js

@@ -1,5 +1,5 @@
-import { astFromInterfaceType, astFromObjectType, getRootTypeNames, MapperKind, mapSchema } from '@graphql-tools/utils';
 import { GraphQLInterfaceType, GraphQLObjectType, isObjectType, parse, } from 'graphql';
+import { astFromInterfaceType, astFromObjectType, getRootTypeNames, MapperKind, mapSchema, } from '@graphql-tools/utils';
 import { oldVisit } from './index.js';
 import { getBaseType } from './utils.js';
 /**
@@ -20,7 +20,7 @@ export const federationSpec = parse(/* GraphQL */ `
  * - return type
  * @param schema
  */
-export function addFederationReferencesToSchema(schema) {
+export function addFederationReferencesToSchema(schema, config) {
     const setFederationMeta = ({ meta, typeName, update, }) => {
         meta[typeName] = {
             ...(meta[typeName] ||
@@ -38,7 +38,10 @@ export function addFederationReferencesToSchema(schema) {
         // @key() @key() - "primary keys" in Federation
         // A reference may receive one primary key combination at a time, so they will be combined with `|`
         const primaryKeys = resolvableKeyDirectives.map(extractReferenceSelectionSet);
-        referenceSelectionSets.push({ directive: '@key', selectionSets: [...primaryKeys] });
+        referenceSelectionSets.push({
+            directive: '@key',
+            selectionSets: [...primaryKeys],
+        });
         const requiresPossibleTypes = [];
         for (const fieldNode of Object.values(fields)) {
             // Look for @requires and see what the service needs and gets
@@ -48,7 +51,10 @@ export function addFederationReferencesToSchema(schema) {
                 requiresPossibleTypes.push(requires);
             }
         }
-        referenceSelectionSets.push({ directive: '@requires', selectionSets: requiresPossibleTypes });
+        referenceSelectionSets.push({
+            directive: '@requires',
+            selectionSets: requiresPossibleTypes,
+        });
         return referenceSelectionSets;
     };
     /**
@@ -144,6 +150,8 @@ export function addFederationReferencesToSchema(schema) {
                 typeConfig.fields = {
                     [resolveReferenceFieldName]: {
                         type,
+                        args: {},
+                        extensions: {},
                     },
                     ...typeConfig.fields,
                 };
@@ -153,7 +161,7 @@ export function addFederationReferencesToSchema(schema) {
                 });
                 const referenceSelectionSetsString = printReferenceSelectionSets({
                     typeName: type.name,
-                    baseFederationType: `FederationTypes['${type.name}']`, // FIXME: run convertName on FederationTypes
+                    baseFederationType: `${config.convertName('FederationTypes')}['${type.name}']`,
                     referenceSelectionSets,
                 });
                 setFederationMeta({
@@ -182,12 +190,14 @@ export function addFederationReferencesToSchema(schema) {
                 typeConfig.fields = {
                     [resolveReferenceFieldName]: {
                         type,
+                        args: {},
+                        extensions: {},
                     },
                     ...typeConfig.fields,
                 };
                 const referenceSelectionSetsString = printReferenceSelectionSets({
                     typeName: type.name,
-                    baseFederationType: `FederationTypes['${type.name}']`, // FIXME: run convertName on FederationTypes
+                    baseFederationType: `${config.convertName('FederationTypes')}['${type.name}']`,
                     referenceSelectionSets,
                 });
                 setFederationMeta({
@@ -249,7 +259,7 @@ export class ApolloFederation {
      */
     fieldsToGenerate;
     meta = {};
-    constructor({ enabled, schema, meta }) {
+    constructor({ enabled, schema, meta, }) {
         this.enabled = enabled;
         this.schema = schema;
         this.providesMap = this.createMapOfProvides();
@@ -389,7 +399,9 @@ function checkTypeFederationDetails(node, schema) {
     }
     const resolvableKeyDirectives = keyDirectives.filter(d => {
         for (const arg of d.arguments) {
-            if (arg.name.value === 'resolvable' && arg.value.kind === 'BooleanValue' && arg.value.value === false) {
+            if (arg.name.value === 'resolvable' &&
+                arg.value.kind === 'BooleanValue' &&
+                arg.value.value === false) {
                 return false;
             }
         }

package/esm/helpers.js

@@ -58,10 +58,10 @@ export function isUsingTypes(document, externalFragments, schema) {
             enter(node, key, parent, anscestors) {
                 const insideIgnoredFragment = anscestors.find((f) => f.kind && f.kind === 'FragmentDefinition' && externalFragments.includes(f.name.value));
                 if (insideIgnoredFragment) {
-                    return;
+                    return node;
                 }
                 const selections = node.selections || [];
-                if (schema && selections.length > 0) {
+                if (schema && selections.length > 0 && !Array.isArray(parent) && 'kind' in parent) {
                     const nextTypeName = (() => {
                         if (parent.kind === Kind.FRAGMENT_DEFINITION) {
                             return parent.typeCondition.name.value;
@@ -97,23 +97,26 @@ export function isUsingTypes(document, externalFragments, schema) {
                         return null;
                     })();
                     typesStack.push(schema.getType(nextTypeName));
+                    return node;
                 }
+                return undefined;
             },
             leave(node) {
                 const selections = node.selections || [];
                 if (schema && selections.length > 0) {
                     typesStack.pop();
                 }
+                return node;
             },
         },
         Field: {
             enter: (node, key, parent, path, anscestors) => {
                 if (node.name.value.startsWith('__')) {
-                    return;
+                    return node;
                 }
                 const insideIgnoredFragment = anscestors.find((f) => f.kind && f.kind === 'FragmentDefinition' && externalFragments.includes(f.name.value));
                 if (insideIgnoredFragment) {
-                    return;
+                    return node;
                 }
                 const selections = node.selectionSet ? node.selectionSet.selections || [] : [];
                 const relevantFragmentSpreads = selections.filter(s => s.kind === Kind.FRAGMENT_SPREAD && !externalFragments.includes(s.name.value));
@@ -134,24 +137,27 @@ export function isUsingTypes(document, externalFragments, schema) {
                         }
                     }
                 }
+                return undefined;
             },
         },
         VariableDefinition: {
             enter: (node, key, parent, path, anscestors) => {
                 const insideIgnoredFragment = anscestors.find((f) => f.kind && f.kind === 'FragmentDefinition' && externalFragments.includes(f.name.value));
                 if (insideIgnoredFragment) {
-                    return;
+                    return node;
                 }
                 foundFields++;
+                return undefined;
             },
         },
         InputValueDefinition: {
             enter: (node, key, parent, path, anscestors) => {
                 const insideIgnoredFragment = anscestors.find((f) => f.kind && f.kind === 'FragmentDefinition' && externalFragments.includes(f.name.value));
                 if (insideIgnoredFragment) {
-                    return;
+                    return node;
                 }
                 foundFields++;
+                return node;
             },
         },
     });

package/esm/utils.js

@@ -1,6 +1,10 @@
-import { isListType, isNonNullType } from 'graphql';
+import { isListType, isNonNullType, } from 'graphql';
 export function mergeOutputs(content) {
-    const result = { content: '', prepend: [], append: [] };
+    const result = {
+        content: '',
+        prepend: [],
+        append: [],
+    };
     if (Array.isArray(content)) {
         for (const item of content) {
             if (typeof item === 'string') {

package/package.json

@@ -1,16 +1,15 @@
 {
   "name": "@depup/graphql-codegen__plugin-helpers",
-  "version": "6.2.0-depup.1",
+  "version": "7.1.0-depup.8",
   "description": "GraphQL Code Generator common utils and types (with updated dependencies)",
   "peerDependencies": {
-    "graphql": "^0.8.0 || ^0.9.0 || ^0.10.0 || ^0.11.0 || ^0.12.0 || ^0.13.0 || ^14.0.0 || ^15.0.0 || ^16.0.0"
+    "graphql": "^0.8.0 || ^0.9.0 || ^0.10.0 || ^0.11.0 || ^0.12.0 || ^0.13.0 || ^14.0.0 || ^15.0.0 || ^16.0.0 || ^17.0.0"
   },
   "dependencies": {
-    "@graphql-tools/utils": "^11.0.0",
+    "@graphql-tools/utils": "^11.2.2",
     "change-case-all": "^2.1.0",
     "common-tags": "1.8.2",
     "import-from": "4.0.0",
-    "lodash": "^4.18.0",
     "tslib": "^2.8.1"
   },
   "repository": {
@@ -56,23 +55,19 @@
   ],
   "depup": {
     "changes": {
-      "change-case-all": {
-        "from": "1.0.15",
-        "to": "^2.1.0"
-      },
-      "lodash": {
-        "from": "~4.17.0",
-        "to": "^4.18.0"
+      "@graphql-tools/utils": {
+        "from": "^11.2.0",
+        "to": "^11.2.2"
       },
       "tslib": {
-        "from": "~2.6.0",
+        "from": "^2.8.0",
         "to": "^2.8.1"
       }
     },
-    "depsUpdated": 3,
+    "depsUpdated": 2,
     "originalPackage": "@graphql-codegen/plugin-helpers",
-    "originalVersion": "6.2.0",
-    "processedAt": "2026-03-31T20:20:32.973Z",
+    "originalVersion": "7.1.0",
+    "processedAt": "2026-07-21T16:05:27.114Z",
     "smokeTest": "passed"
   }
 }

package/typings/federation.d.cts

@@ -32,7 +32,9 @@ export type FederationMeta = {
  * - return type
  * @param schema
  */
-export declare function addFederationReferencesToSchema(schema: GraphQLSchema): {
+export declare function addFederationReferencesToSchema(schema: GraphQLSchema, config: {
+    convertName: (type: string) => string;
+}): {
     transformedSchema: GraphQLSchema;
     federationMeta: FederationMeta;
 };
@@ -52,7 +54,7 @@ export declare class ApolloFederation {
      */
     private fieldsToGenerate;
     protected meta: FederationMeta;
-    constructor({ enabled, schema, meta }: {
+    constructor({ enabled, schema, meta, }: {
         enabled: boolean;
         schema: GraphQLSchema;
         meta: FederationMeta;

package/typings/federation.d.ts

@@ -32,7 +32,9 @@ export type FederationMeta = {
  * - return type
  * @param schema
  */
-export declare function addFederationReferencesToSchema(schema: GraphQLSchema): {
+export declare function addFederationReferencesToSchema(schema: GraphQLSchema, config: {
+    convertName: (type: string) => string;
+}): {
     transformedSchema: GraphQLSchema;
     federationMeta: FederationMeta;
 };
@@ -52,7 +54,7 @@ export declare class ApolloFederation {
      */
     private fieldsToGenerate;
     protected meta: FederationMeta;
-    constructor({ enabled, schema, meta }: {
+    constructor({ enabled, schema, meta, }: {
         enabled: boolean;
         schema: GraphQLSchema;
         meta: FederationMeta;

package/typings/oldVisit.d.cts

@@ -1,9 +1,2 @@
-import { ASTNode, visit } from 'graphql';
-type VisitFn = typeof visit;
-type NewVisitor = Partial<Parameters<VisitFn>[1]>;
-type OldVisitor = {
-    enter?: Partial<Record<keyof NewVisitor, NonNullable<NewVisitor[keyof NewVisitor]>['enter']>>;
-    leave?: Partial<Record<keyof NewVisitor, NonNullable<NewVisitor[keyof NewVisitor]>['leave']>>;
-} & NewVisitor;
-export declare function oldVisit(root: ASTNode, { enter: enterVisitors, leave: leaveVisitors, ...newVisitor }: OldVisitor): any;
-export {};
+import { ASTNode } from 'graphql';
+export declare function oldVisit(root: ASTNode, { enter: enterVisitors, leave: leaveVisitors, ...newVisitor }: any): any;

package/typings/oldVisit.d.ts

@@ -1,9 +1,2 @@
-import { ASTNode, visit } from 'graphql';
-type VisitFn = typeof visit;
-type NewVisitor = Partial<Parameters<VisitFn>[1]>;
-type OldVisitor = {
-    enter?: Partial<Record<keyof NewVisitor, NonNullable<NewVisitor[keyof NewVisitor]>['enter']>>;
-    leave?: Partial<Record<keyof NewVisitor, NonNullable<NewVisitor[keyof NewVisitor]>['leave']>>;
-} & NewVisitor;
-export declare function oldVisit(root: ASTNode, { enter: enterVisitors, leave: leaveVisitors, ...newVisitor }: OldVisitor): any;
-export {};
+import { ASTNode } from 'graphql';
+export declare function oldVisit(root: ASTNode, { enter: enterVisitors, leave: leaveVisitors, ...newVisitor }: any): any;

package/typings/types.d.cts

@@ -1,6 +1,6 @@
+import { DocumentNode, GraphQLSchema } from 'graphql';
 import type { ApolloEngineOptions } from '@graphql-tools/apollo-engine-loader';
 import { Source } from '@graphql-tools/utils';
-import { DocumentNode, GraphQLSchema } from 'graphql';
 import type { Profiler } from './profiler.cjs';
 export declare namespace Types {
     interface GenerateOptions {
@@ -34,7 +34,8 @@ export declare namespace Types {
         };
     };
     interface DocumentFile extends Source {
-        hash?: string;
+        hash?: string | null;
+        type?: 'standard' | 'external';
     }
     type Promisable<T> = T | Promise<T>;
     type InstanceOrArray<T> = T | T[];
@@ -272,6 +273,12 @@ export declare namespace Types {
          * For more details: https://graphql-code-generator.com/docs/config-reference/documents-field
          */
         documents?: InstanceOrArray<OperationDocument>;
+        /**
+         * @description A pointer(s) to your GraphQL documents that will be read but will not have type files generated for them.
+         * These documents are available to plugins for type resolution (e.g. fragment types), but no output files will be generated based on them.
+         * Accepts the same formats as `documents`.
+         */
+        externalDocuments?: InstanceOrArray<OperationDocument>;
         /**
          * @description A pointer(s) to your GraphQL schema. This schema will be available only for this specific `generates` record.
          * You can use one of the following:
@@ -389,6 +396,12 @@ export declare namespace Types {
          * For more details: https://graphql-code-generator.com/docs/config-reference/documents-field
          */
         documents?: InstanceOrArray<OperationDocument>;
+        /**
+         * @description A pointer(s) to your GraphQL documents that will be read but will not have type files generated for them.
+         * These documents are available to plugins for type resolution (e.g. fragment types), but no output files will be generated based on them.
+         * Accepts the same formats as `documents`.
+         */
+        externalDocuments?: InstanceOrArray<OperationDocument>;
         /**
          * @type object
          * @additionalProperties true
@@ -509,6 +522,10 @@ export declare namespace Types {
          * @description If `true`, write to files whichever `generates` block succeeds. If `false`, one failed `generates` means no output is written to files. Default: false
          */
         allowPartialOutputs?: boolean;
+        /**
+         * Working directory
+         */
+        cwd?: string;
     }
     type ComplexPluginOutput<M = Record<string, unknown>> = {
         content: string;

package/typings/types.d.ts

@@ -1,6 +1,6 @@
+import { DocumentNode, GraphQLSchema } from 'graphql';
 import type { ApolloEngineOptions } from '@graphql-tools/apollo-engine-loader';
 import { Source } from '@graphql-tools/utils';
-import { DocumentNode, GraphQLSchema } from 'graphql';
 import type { Profiler } from './profiler.js';
 export declare namespace Types {
     interface GenerateOptions {
@@ -34,7 +34,8 @@ export declare namespace Types {
         };
     };
     interface DocumentFile extends Source {
-        hash?: string;
+        hash?: string | null;
+        type?: 'standard' | 'external';
     }
     type Promisable<T> = T | Promise<T>;
     type InstanceOrArray<T> = T | T[];
@@ -272,6 +273,12 @@ export declare namespace Types {
          * For more details: https://graphql-code-generator.com/docs/config-reference/documents-field
          */
         documents?: InstanceOrArray<OperationDocument>;
+        /**
+         * @description A pointer(s) to your GraphQL documents that will be read but will not have type files generated for them.
+         * These documents are available to plugins for type resolution (e.g. fragment types), but no output files will be generated based on them.
+         * Accepts the same formats as `documents`.
+         */
+        externalDocuments?: InstanceOrArray<OperationDocument>;
         /**
          * @description A pointer(s) to your GraphQL schema. This schema will be available only for this specific `generates` record.
          * You can use one of the following:
@@ -389,6 +396,12 @@ export declare namespace Types {
          * For more details: https://graphql-code-generator.com/docs/config-reference/documents-field
          */
         documents?: InstanceOrArray<OperationDocument>;
+        /**
+         * @description A pointer(s) to your GraphQL documents that will be read but will not have type files generated for them.
+         * These documents are available to plugins for type resolution (e.g. fragment types), but no output files will be generated based on them.
+         * Accepts the same formats as `documents`.
+         */
+        externalDocuments?: InstanceOrArray<OperationDocument>;
         /**
          * @type object
          * @additionalProperties true
@@ -509,6 +522,10 @@ export declare namespace Types {
          * @description If `true`, write to files whichever `generates` block succeeds. If `false`, one failed `generates` means no output is written to files. Default: false
          */
         allowPartialOutputs?: boolean;
+        /**
+         * Working directory
+         */
+        cwd?: string;
     }
     type ComplexPluginOutput<M = Record<string, unknown>> = {
         content: string;