houdini 1.2.44 → 1.2.45

package/build/test-esm/index.js

@@ -53825,10 +53825,10 @@ var require_lib6 = __commonJS({
 
 // src/test/index.ts
 var import_memfs2 = __toESM(require_lib(), 1);
-import * as graphql34 from "graphql";
+import * as graphql33 from "graphql";
 
 // src/codegen/index.ts
-import * as graphql33 from "graphql";
+import * as graphql32 from "graphql";
 
 // src/lib/pipeline.ts
 async function runPipeline(config, pipeline, target) {
@@ -53972,47 +53972,6 @@ function deepMerge(...objects) {
   return mergedObj;
 }
 
-// src/runtime/lib/scalars.ts
-async function marshalSelection({
-  selection,
-  data
-}) {
-  const config = getCurrentConfig();
-  if (data === null || typeof data === "undefined") {
-    return data;
-  }
-  if (Array.isArray(data)) {
-    return await Promise.all(data.map((val) => marshalSelection({ selection, data: val })));
-  }
-  const targetSelection = getFieldsForType(selection, data["__typename"], false);
-  return Object.fromEntries(
-    await Promise.all(
-      Object.entries(data).map(async ([fieldName, value]) => {
-        const { type, selection: selection2 } = targetSelection[fieldName];
-        if (!type) {
-          return [fieldName, value];
-        }
-        if (selection2) {
-          return [fieldName, await marshalSelection({ selection: selection2, data: value })];
-        }
-        if (config.scalars?.[type]) {
-          const marshalFn = config.scalars[type].marshal;
-          if (!marshalFn) {
-            throw new Error(
-              `scalar type ${type} is missing a \`marshal\` function. see https://github.com/AlecAivazis/houdini#%EF%B8%8Fcustom-scalars`
-            );
-          }
-          if (Array.isArray(value)) {
-            return [fieldName, value.map(marshalFn)];
-          }
-          return [fieldName, marshalFn(value)];
-        }
-        return [fieldName, value];
-      })
-    )
-  );
-}
-
 // src/runtime/lib/types.ts
 var CachePolicy = {
   CacheOrNetwork: "CacheOrNetwork",
@@ -54040,11 +53999,6 @@ var RefetchUpdateMode = {
   prepend: "prepend",
   replace: "replace"
 };
-var DataSource = {
-  Cache: "cache",
-  Network: "network",
-  Ssr: "ssr"
-};
 var fragmentKey = " $fragments";
 var PendingValue = Symbol("houdini_loading");
 
@@ -56666,202 +56620,6 @@ var cache_default = new Cache();
 // src/runtime/client/plugins/cache.ts
 var serverSide = typeof globalThis.window === "undefined";
 
-// src/runtime/client/utils/documentPlugins.ts
-var documentPlugin = (kind, source) => {
-  return () => {
-    const sourceHandlers = source();
-    const enterWrapper = (handler) => {
-      return !handler ? void 0 : (ctx, handlers) => {
-        if (ctx.artifact.kind !== kind) {
-          return handlers.next(ctx);
-        }
-        return handler(ctx, handlers);
-      };
-    };
-    const exitWrapper = (handler) => {
-      return !handler ? void 0 : (ctx, handlers) => {
-        if (ctx.artifact.kind !== kind) {
-          return handlers.resolve(ctx);
-        }
-        return handler(ctx, handlers);
-      };
-    };
-    return {
-      start: enterWrapper(sourceHandlers.start),
-      network: enterWrapper(sourceHandlers.network),
-      afterNetwork: exitWrapper(sourceHandlers.afterNetwork),
-      end: exitWrapper(sourceHandlers.end),
-      catch: sourceHandlers.catch ? (ctx, handlers) => sourceHandlers.catch(ctx, handlers) : void 0,
-      cleanup: (...args) => sourceHandlers.cleanup?.(...args)
-    };
-  };
-};
-
-// src/runtime/client/plugins/query.ts
-var query = documentPlugin(ArtifactKind.Query, function() {
-  let subscriptionSpec = null;
-  let lastVariables = null;
-  return {
-    start(ctx, { next }) {
-      const runtimeScalarPayload = {
-        session: ctx.session
-      };
-      ctx.variables = {
-        ...lastVariables,
-        ...Object.fromEntries(
-          Object.entries(ctx.artifact.input?.runtimeScalars ?? {}).map(
-            ([field, type]) => {
-              const runtimeScalar = ctx.config.features?.runtimeScalars?.[type];
-              if (!runtimeScalar) {
-                return [field, type];
-              }
-              return [field, runtimeScalar.resolve(runtimeScalarPayload)];
-            }
-          )
-        ),
-        ...ctx.variables
-      };
-      next(ctx);
-    },
-    end(ctx, { resolve: resolve2, marshalVariables, variablesChanged }) {
-      if (variablesChanged(ctx) && !ctx.cacheParams?.disableSubscriptions) {
-        if (subscriptionSpec) {
-          cache_default.unsubscribe(subscriptionSpec, subscriptionSpec.variables?.() || {});
-        }
-        lastVariables = { ...marshalVariables(ctx) };
-        const variables = lastVariables;
-        subscriptionSpec = {
-          rootType: ctx.artifact.rootType,
-          selection: ctx.artifact.selection,
-          variables: () => variables,
-          set: (newValue) => {
-            resolve2(ctx, {
-              data: newValue,
-              errors: null,
-              fetching: false,
-              partial: false,
-              stale: false,
-              source: DataSource.Cache,
-              variables: ctx.variables ?? {}
-            });
-          }
-        };
-        cache_default.subscribe(subscriptionSpec, lastVariables);
-      }
-      resolve2(ctx);
-    },
-    cleanup() {
-      if (subscriptionSpec) {
-        cache_default.unsubscribe(subscriptionSpec, subscriptionSpec.variables?.());
-        lastVariables = null;
-      }
-    }
-  };
-});
-
-// src/runtime/client/plugins/fragment.ts
-var fragment = documentPlugin(ArtifactKind.Fragment, function() {
-  let subscriptionSpec = null;
-  let lastReference = null;
-  return {
-    start(ctx, { next, resolve: resolve2, variablesChanged, marshalVariables }) {
-      if (!ctx.stuff.parentID) {
-        return next(ctx);
-      }
-      const currentReference = {
-        parent: ctx.stuff.parentID,
-        variables: marshalVariables(ctx)
-      };
-      if (!ctx.cacheParams?.disableSubscriptions && (!deepEquals(lastReference, currentReference) || variablesChanged(ctx))) {
-        if (subscriptionSpec) {
-          cache_default.unsubscribe(subscriptionSpec, subscriptionSpec.variables?.() || {});
-        }
-        const variables = marshalVariables(ctx);
-        subscriptionSpec = {
-          rootType: ctx.artifact.rootType,
-          selection: ctx.artifact.selection,
-          variables: () => variables,
-          parentID: ctx.stuff.parentID,
-          set: (newValue) => {
-            resolve2(ctx, {
-              data: newValue,
-              errors: null,
-              fetching: false,
-              partial: false,
-              stale: false,
-              source: DataSource.Cache,
-              variables
-            });
-          }
-        };
-        cache_default.subscribe(subscriptionSpec, variables);
-        lastReference = currentReference;
-      }
-      next(ctx);
-    },
-    cleanup() {
-      if (subscriptionSpec) {
-        cache_default.unsubscribe(subscriptionSpec, subscriptionSpec.variables?.());
-      }
-    }
-  };
-});
-
-// src/runtime/client/plugins/mutation.ts
-var mutation = documentPlugin(ArtifactKind.Mutation, () => {
-  return {
-    async start(ctx, { next, marshalVariables }) {
-      const layerOptimistic = cache_default._internal_unstable.storage.createLayer(true);
-      const optimisticResponse = ctx.stuff.optimisticResponse;
-      let toNotify = [];
-      if (optimisticResponse) {
-        toNotify = cache_default.write({
-          selection: ctx.artifact.selection,
-          data: await marshalSelection({
-            selection: ctx.artifact.selection,
-            data: optimisticResponse
-          }),
-          variables: marshalVariables(ctx),
-          layer: layerOptimistic.id
-        });
-      }
-      ctx.cacheParams = {
-        ...ctx.cacheParams,
-        layer: layerOptimistic,
-        notifySubscribers: toNotify,
-        forceNotify: true
-      };
-      next(ctx);
-    },
-    afterNetwork(ctx, { resolve: resolve2 }) {
-      if (ctx.cacheParams?.layer) {
-        cache_default.clearLayer(ctx.cacheParams.layer.id);
-      }
-      resolve2(ctx);
-    },
-    end(ctx, { resolve: resolve2, value }) {
-      const hasErrors = value.errors && value.errors.length > 0;
-      if (hasErrors) {
-        if (ctx.cacheParams?.layer) {
-          cache_default.clearLayer(ctx.cacheParams.layer.id);
-        }
-      }
-      if (ctx.cacheParams?.layer) {
-        cache_default._internal_unstable.storage.resolveLayer(ctx.cacheParams.layer.id);
-      }
-      resolve2(ctx);
-    },
-    catch(ctx, { error }) {
-      if (ctx.cacheParams?.layer) {
-        const { layer } = ctx.cacheParams;
-        cache_default.clearLayer(layer.id);
-        cache_default._internal_unstable.storage.resolveLayer(layer.id);
-      }
-      throw error;
-    }
-  };
-});
-
 // src/lib/types.ts
 var LogLevel = {
   Full: "full",
@@ -57636,7 +57394,7 @@ function definitionFromAncestors(ancestors) {
   }
   return { parents, definition };
 }
-function unwrapType(config, type, wrappers = []) {
+function unwrapType(config, type, wrappers = [], convertRuntimeScalars) {
   if (type.kind === "NonNullType") {
     return unwrapType(config, type.type, [TypeWrapper.NonNull, ...wrappers]);
   }
@@ -57652,6 +57410,11 @@ function unwrapType(config, type, wrappers = []) {
   if (type instanceof graphql3.GraphQLList) {
     return unwrapType(config, type.ofType, [TypeWrapper.List, ...wrappers]);
   }
+  if (convertRuntimeScalars && config.configFile.features?.runtimeScalars?.[type.name.value]) {
+    type = config.schema.getType(
+      config.configFile.features?.runtimeScalars?.[type.name.value].type
+    );
+  }
   const namedType = config.schema.getType(type.name.value || type.name);
   if (!namedType) {
     throw new Error("Unknown type: " + type.name.value || type.name);
@@ -57791,16 +57554,162 @@ async function cleanupFiles(pathFolder, listOfObj) {
   return allFilesNotInList;
 }
 
-// src/lib/walk.ts
+// src/lib/typescript.ts
+var recast2 = __toESM(require_main2(), 1);
 import * as graphql4 from "graphql";
+var AST2 = recast2.types.builders;
+function unwrappedTsTypeReference(config, filepath, missingScalars, {
+  type,
+  wrappers
+}, body) {
+  let result;
+  if (graphql4.isScalarType(type)) {
+    result = scalarPropertyValue(config, filepath, missingScalars, type, body, null);
+  } else if (graphql4.isEnumType(type)) {
+    result = enumReference(config, body, type.name);
+  } else {
+    result = AST2.tsTypeReference(AST2.identifier(type.name));
+  }
+  for (const toWrap of wrappers) {
+    if (toWrap === "NonNull" /* NonNull */) {
+      continue;
+    } else if (toWrap === "Nullable" /* Nullable */) {
+      result = nullableField(result, true);
+    } else if (toWrap === "List" /* List */) {
+      result = AST2.tsArrayType(AST2.tsParenthesizedType(result));
+    }
+  }
+  return result;
+}
+function tsTypeReference(config, filepath, missingScalars, definition, body) {
+  const { type, wrappers } = unwrapType(config, definition.type);
+  return unwrappedTsTypeReference(
+    config,
+    filepath,
+    missingScalars,
+    { type, wrappers },
+    body
+  );
+}
+function enumReference(config, body, name) {
+  ensureImports({
+    config,
+    body,
+    import: ["ValueOf"],
+    importKind: "type",
+    sourceModule: "$houdini/runtime/lib/types"
+  });
+  return AST2.tsTypeReference(
+    AST2.identifier("ValueOf"),
+    AST2.tsTypeParameterInstantiation([AST2.tsTypeQuery(AST2.identifier(name))])
+  );
+}
+function readonlyProperty(prop, enable = true) {
+  if (enable) {
+    prop.readonly = true;
+  }
+  return prop;
+}
+function nullableField(inner, input = false) {
+  const members = [inner, AST2.tsNullKeyword()];
+  if (input) {
+    members.push(AST2.tsUndefinedKeyword());
+  }
+  return AST2.tsUnionType(members);
+}
+function scalarPropertyValue(config, filepath, missingScalars, target, body, field) {
+  if (config.configFile.features?.componentFields && target.name === config.componentScalar) {
+    if (!field) {
+      return AST2.tsNeverKeyword();
+    }
+    const component = config.componentFields[field.parent][field.field];
+    const sourcePathRelative = path_exports.relative(
+      path_exports.join(config.projectRoot, "src"),
+      component.filepath
+    );
+    let sourcePathParsed = path_exports.parse(sourcePathRelative);
+    let sourcePath = path_exports.join(sourcePathParsed.dir, sourcePathParsed.name);
+    const localImport = ensureImports({
+      config,
+      body,
+      import: "__component__" + component.fragment,
+      sourceModule: path_exports.join(
+        path_exports.relative(path_exports.dirname(filepath), config.projectRoot),
+        "src",
+        sourcePath
+      )
+    }) ?? "__component__" + component.fragment;
+    const parameters = AST2.tsTypeReference(AST2.identifier("Parameters"));
+    parameters.typeParameters = AST2.tsTypeParameterInstantiation([
+      AST2.tsTypeQuery(AST2.identifier(localImport))
+    ]);
+    const indexed = AST2.tsIndexedAccessType(
+      parameters,
+      AST2.tsLiteralType(AST2.numericLiteral(0))
+    );
+    const omit = AST2.tsTypeReference(AST2.identifier("Omit"));
+    omit.typeParameters = AST2.tsTypeParameterInstantiation([
+      indexed,
+      AST2.tsLiteralType(AST2.stringLiteral(component.prop))
+    ]);
+    const arg = AST2.identifier("props");
+    arg.typeAnnotation = AST2.tsTypeAnnotation(omit);
+    const returnType = AST2.tsTypeReference(AST2.identifier("ReturnType"));
+    returnType.typeParameters = AST2.tsTypeParameterInstantiation([
+      AST2.tsTypeQuery(AST2.identifier(localImport))
+    ]);
+    const fnType = AST2.tsFunctionType([arg]);
+    fnType.typeAnnotation = AST2.tsTypeAnnotation(returnType);
+    return fnType;
+  }
+  switch (target.name) {
+    case "String": {
+      return AST2.tsStringKeyword();
+    }
+    case "Int": {
+      return AST2.tsNumberKeyword();
+    }
+    case "Float": {
+      return AST2.tsNumberKeyword();
+    }
+    case "Boolean": {
+      return AST2.tsBooleanKeyword();
+    }
+    case "ID": {
+      return AST2.tsStringKeyword();
+    }
+    default: {
+      if (graphql4.isNonNullType(target) && "ofType" in target) {
+        return scalarPropertyValue(
+          config,
+          filepath,
+          missingScalars,
+          target.ofType,
+          body,
+          field
+        );
+      }
+      if (config.scalars?.[target.name]) {
+        return AST2.tsTypeReference(AST2.identifier(config.scalars?.[target.name].type));
+      }
+      if (target.name !== config.componentScalar) {
+        missingScalars.add(target.name);
+      }
+      return AST2.tsAnyKeyword();
+    }
+  }
+}
+
+// src/lib/walk.ts
+import * as graphql5 from "graphql";
 
 // src/lib/router/manifest.ts
 var t = __toESM(require_lib6(), 1);
-import * as graphql5 from "graphql";
+import * as graphql6 from "graphql";
 
 // src/codegen/generators/artifacts/index.ts
-var recast4 = __toESM(require_main2(), 1);
-import * as graphql16 from "graphql";
+var recast5 = __toESM(require_main2(), 1);
+import * as graphql17 from "graphql";
 
 // src/codegen/utils/commonjs.ts
 var cjsIndexFilePreamble = `"use strict";
@@ -58042,19 +57951,19 @@ var FieldCollection = class {
 };
 
 // src/codegen/utils/moduleExport.ts
-var recast2 = __toESM(require_main2(), 1);
-var AST2 = recast2.types.builders;
+var recast3 = __toESM(require_main2(), 1);
+var AST3 = recast3.types.builders;
 function moduleExport(config, key, value) {
   if (config.module === "commonjs") {
-    let target = AST2.memberExpression(AST2.identifier("module"), AST2.identifier("exports"));
+    let target = AST3.memberExpression(AST3.identifier("module"), AST3.identifier("exports"));
     if (key !== "default") {
-      target = AST2.memberExpression(target, AST2.identifier(key));
+      target = AST3.memberExpression(target, AST3.identifier(key));
     }
-    return AST2.expressionStatement(AST2.assignmentExpression("=", target, value));
+    return AST3.expressionStatement(AST3.assignmentExpression("=", target, value));
   }
-  return key === "default" ? AST2.exportDefaultDeclaration(value) : AST2.exportNamedDeclaration(
-    AST2.variableDeclaration("const", [
-      AST2.variableDeclarator(AST2.identifier(key), value)
+  return key === "default" ? AST3.exportDefaultDeclaration(value) : AST3.exportNamedDeclaration(
+    AST3.variableDeclaration("const", [
+      AST3.variableDeclarator(AST3.identifier(key), value)
     ])
   );
 }
@@ -58311,7 +58220,7 @@ var serialize = (value, { json, lossy } = {}) => {
 var esm_default = typeof structuredClone === "function" ? (any, options) => options && ("json" in options || "lossy" in options) ? deserialize(serialize(any, options)) : structuredClone(any) : (any, options) => deserialize(serialize(any, options));
 
 // src/codegen/transforms/fragmentVariables.ts
-import * as graphql7 from "graphql";
+import * as graphql8 from "graphql";
 
 // src/codegen/utils/stripLoc.ts
 function stripLoc(value) {
@@ -58332,7 +58241,7 @@ function stripLoc(value) {
 }
 
 // src/codegen/transforms/collectDefinitions.ts
-import * as graphql6 from "graphql";
+import * as graphql7 from "graphql";
 import { Kind as GraphqlKinds } from "graphql";
 async function includeFragmentDefinitions(config, documents) {
   const fragments = collectDefinitions(config, documents);
@@ -58382,10 +58291,10 @@ function collectDefinitions(config, docs) {
 }
 function findRequiredFragments(config, definition) {
   const referencedFragments = [];
-  const typeInfo = new graphql6.TypeInfo(config.schema);
-  definition.selectionSet = graphql6.visit(
+  const typeInfo = new graphql7.TypeInfo(config.schema);
+  definition.selectionSet = graphql7.visit(
     definition,
-    graphql6.visitWithTypeInfo(typeInfo, {
+    graphql7.visitWithTypeInfo(typeInfo, {
       FragmentSpread(node) {
         referencedFragments.push(node.name.value);
       }
@@ -58419,7 +58328,7 @@ function flattenFragments(filepath, operation, fragments) {
 }
 
 // src/codegen/transforms/fragmentVariables.ts
-var GraphqlKinds2 = graphql7.Kind;
+var GraphqlKinds2 = graphql8.Kind;
 async function fragmentVariables(config, documents) {
   const fragments = collectDefinitions(config, documents);
   const generatedFragments = {};
@@ -58442,7 +58351,7 @@ async function fragmentVariables(config, documents) {
     });
   }
   const doc = {
-    kind: graphql7.Kind.DOCUMENT,
+    kind: graphql8.Kind.DOCUMENT,
     definitions: Object.values(generatedFragments)
   };
   documents.push({
@@ -58513,7 +58422,7 @@ function inlineFragmentArgs({
     return null;
   };
   const result = esm_default(
-    graphql7.visit(document, {
+    graphql8.visit(document, {
       FragmentSpread(node) {
         if (!fragmentDefinitions[node.name.value]) {
           throw new Error("Could not find definition for fragment" + node.name.value);
@@ -58599,7 +58508,7 @@ function inlineFragmentArgs({
   );
   if (newName) {
     result.name = {
-      kind: graphql7.Kind.NAME,
+      kind: graphql8.Kind.NAME,
       value: newName
     };
   }
@@ -58766,7 +58675,7 @@ ${exportDefaultFrom(`./${doc.name}`, doc.name)}`,
 }
 
 // src/codegen/generators/artifacts/inputs.ts
-import * as graphql8 from "graphql";
+import * as graphql9 from "graphql";
 function inputObject(config, inputs, runtimeScalars) {
   const visitedTypes = /* @__PURE__ */ new Set();
   const inputObj = {
@@ -58796,10 +58705,10 @@ function walkInputs(config, visitedTypes, inputObj, rootType) {
   if (visitedTypes.has(type.name)) {
     return;
   }
-  if (graphql8.isEnumType(type) || graphql8.isScalarType(type)) {
+  if (graphql9.isEnumType(type) || graphql9.isScalarType(type)) {
     return;
   }
-  if (graphql8.isUnionType(type)) {
+  if (graphql9.isUnionType(type)) {
     return;
   }
   visitedTypes.add(type.name);
@@ -58817,50 +58726,50 @@ function walkInputs(config, visitedTypes, inputObj, rootType) {
 }
 
 // src/codegen/generators/artifacts/operations.ts
-import * as graphql10 from "graphql";
+import * as graphql11 from "graphql";
 
 // src/codegen/generators/artifacts/utils.ts
-var recast3 = __toESM(require_main2(), 1);
-import * as graphql9 from "graphql";
-var AST3 = recast3.types.builders;
+var recast4 = __toESM(require_main2(), 1);
+import * as graphql10 from "graphql";
+var AST4 = recast4.types.builders;
 function serializeValue(value) {
   if (Array.isArray(value)) {
-    return AST3.arrayExpression(value.map(serializeValue));
+    return AST4.arrayExpression(value.map(serializeValue));
   }
   if (typeof value === "object" && value !== null) {
-    return AST3.objectExpression(
+    return AST4.objectExpression(
       Object.entries(value).filter(([key, value2]) => typeof value2 !== "undefined").map(([key, val]) => {
-        return AST3.objectProperty(AST3.stringLiteral(key), serializeValue(val));
+        return AST4.objectProperty(AST4.stringLiteral(key), serializeValue(val));
       })
     );
   }
   if (typeof value === "string") {
     if (value.indexOf("\n") !== -1) {
-      return AST3.templateLiteral(
-        [AST3.templateElement({ raw: value, cooked: value }, true)],
+      return AST4.templateLiteral(
+        [AST4.templateElement({ raw: value, cooked: value }, true)],
         []
       );
     }
-    return AST3.stringLiteral(value);
+    return AST4.stringLiteral(value);
   }
-  return AST3.literal(value);
+  return AST4.literal(value);
 }
 function convertValue(config, val) {
   let value;
   let kind;
-  if (val.kind === graphql9.Kind.INT) {
+  if (val.kind === graphql10.Kind.INT) {
     value = parseInt(val.value, 10);
     kind = "Int";
-  } else if (val.kind === graphql9.Kind.FLOAT) {
+  } else if (val.kind === graphql10.Kind.FLOAT) {
     value = parseFloat(val.value);
     kind = "Float";
-  } else if (val.kind === graphql9.Kind.BOOLEAN) {
+  } else if (val.kind === graphql10.Kind.BOOLEAN) {
     value = val.value;
     kind = "Boolean";
-  } else if (val.kind === graphql9.Kind.VARIABLE) {
+  } else if (val.kind === graphql10.Kind.VARIABLE) {
     value = val.name.value;
     kind = "Variable";
-  } else if (val.kind === graphql9.Kind.STRING) {
+  } else if (val.kind === graphql10.Kind.STRING) {
     value = val.value;
     kind = "String";
   }
@@ -58873,7 +58782,7 @@ function operationsByPath(config, filepath, definition, filterTypes) {
     return {};
   }
   const pathOperations = {};
-  graphql10.visit(definition, {
+  graphql11.visit(definition, {
     FragmentSpread(node, _, __, ___, ancestors) {
       if (!config.isListFragment(node.name.value)) {
         return;
@@ -59032,19 +58941,19 @@ function ancestorKey(ancestors) {
 }
 
 // src/codegen/generators/artifacts/selection.ts
-import * as graphql15 from "graphql";
+import * as graphql16 from "graphql";
 
 // src/codegen/transforms/list.ts
-import * as graphql13 from "graphql";
+import * as graphql14 from "graphql";
 
 // src/codegen/utils/objectIdentificationSelection.ts
-import * as graphql11 from "graphql";
+import * as graphql12 from "graphql";
 var objectIdentificationSelection = (config, type) => {
   return config.keyFieldsForType(type.name).map((key) => {
     return {
-      kind: graphql11.Kind.FIELD,
+      kind: graphql12.Kind.FIELD,
       name: {
-        kind: graphql11.Kind.NAME,
+        kind: graphql12.Kind.NAME,
         value: key
       }
     };
@@ -59052,7 +58961,7 @@ var objectIdentificationSelection = (config, type) => {
 };
 
 // src/codegen/transforms/paginate.ts
-import * as graphql12 from "graphql";
+import * as graphql13 from "graphql";
 async function paginate(config, documents) {
   const newDocs = [];
   for (const doc of documents) {
@@ -59085,7 +58994,7 @@ async function paginate(config, documents) {
     };
     let cursorType = "String";
     let paginationPath = [];
-    doc.document = graphql12.visit(doc.document, {
+    doc.document = graphql13.visit(doc.document, {
       Field(node, _, __, ___, ancestors) {
         const paginateDirective = node.directives?.find(
           (directive) => directive.name.value === config.paginateDirective
@@ -59111,7 +59020,7 @@ async function paginate(config, documents) {
         flags.offset.enabled = offsetPagination;
         flags.limit.enabled = offsetPagination;
         paginationPath = ancestors.filter(
-          (ancestor) => !Array.isArray(ancestor) && ancestor.kind === graphql12.Kind.FIELD
+          (ancestor) => !Array.isArray(ancestor) && ancestor.kind === graphql13.Kind.FIELD
         ).concat(node).map((field) => field.alias?.value || field.name.value);
         return {
           ...node,
@@ -59130,7 +59039,7 @@ async function paginate(config, documents) {
       let fragment2 = "";
       let paginateMode = config.defaultPaginateMode;
       const requiredArgs = [];
-      doc.document = graphql12.visit(doc.document, {
+      doc.document = graphql13.visit(doc.document, {
         OperationDefinition(node) {
           if (node.operation !== "query") {
             throw new HoudiniError({
@@ -59189,9 +59098,9 @@ async function paginate(config, documents) {
               directives: [
                 ...node.directives || [],
                 {
-                  kind: graphql12.Kind.DIRECTIVE,
+                  kind: graphql13.Kind.DIRECTIVE,
                   name: {
-                    kind: graphql12.Kind.NAME,
+                    kind: graphql13.Kind.NAME,
                     value: config.argumentsDirective
                   }
                 }
@@ -59261,22 +59170,22 @@ async function paginate(config, documents) {
       const paginationArgs = Object.entries(flags).filter(([_, { enabled }]) => enabled).map(([key, value]) => ({ name: key, ...value }));
       const fragmentSpreadSelection = [
         {
-          kind: graphql12.Kind.FRAGMENT_SPREAD,
+          kind: graphql13.Kind.FRAGMENT_SPREAD,
           name: {
-            kind: graphql12.Kind.NAME,
+            kind: graphql13.Kind.NAME,
             value: fragmentName
           },
           directives: [
             {
-              kind: graphql12.Kind.DIRECTIVE,
+              kind: graphql13.Kind.DIRECTIVE,
               name: {
-                kind: graphql12.Kind.NAME,
+                kind: graphql13.Kind.NAME,
                 value: config.withDirective
               },
               ["arguments"]: requiredArgs.map((arg) => variableAsArgument(arg.name)).concat(paginationArgs.map(({ name }) => variableAsArgument(name)))
             },
             {
-              kind: graphql12.Kind.DIRECTIVE,
+              kind: graphql13.Kind.DIRECTIVE,
               name: {
                 kind: "Name",
                 value: config.maskDisableDirective
@@ -59303,23 +59212,23 @@ async function paginate(config, documents) {
       });
       const typeConfig = config.typeConfig?.[fragment2];
       const queryDoc = {
-        kind: graphql12.Kind.DOCUMENT,
+        kind: graphql13.Kind.DOCUMENT,
         definitions: [
           {
-            kind: graphql12.Kind.OPERATION_DEFINITION,
+            kind: graphql13.Kind.OPERATION_DEFINITION,
             name: {
-              kind: graphql12.Kind.NAME,
+              kind: graphql13.Kind.NAME,
               value: refetchQueryName
             },
             operation: "query",
             variableDefinitions: requiredArgs.map(
               (arg) => ({
-                kind: graphql12.Kind.VARIABLE_DEFINITION,
+                kind: graphql13.Kind.VARIABLE_DEFINITION,
                 type: arg.type,
                 variable: {
-                  kind: graphql12.Kind.VARIABLE,
+                  kind: graphql13.Kind.VARIABLE,
                   name: {
-                    kind: graphql12.Kind.NAME,
+                    kind: graphql13.Kind.NAME,
                     value: arg.name
                   }
                 }
@@ -59327,18 +59236,18 @@ async function paginate(config, documents) {
             ).concat(
               paginationArgs.map(
                 (arg) => ({
-                  kind: graphql12.Kind.VARIABLE_DEFINITION,
+                  kind: graphql13.Kind.VARIABLE_DEFINITION,
                   type: {
-                    kind: graphql12.Kind.NAMED_TYPE,
+                    kind: graphql13.Kind.NAMED_TYPE,
                     name: {
-                      kind: graphql12.Kind.NAME,
+                      kind: graphql13.Kind.NAME,
                       value: arg.type
                     }
                   },
                   variable: {
-                    kind: graphql12.Kind.VARIABLE,
+                    kind: graphql13.Kind.VARIABLE,
                     name: {
-                      kind: graphql12.Kind.NAME,
+                      kind: graphql13.Kind.NAME,
                       value: arg.name
                     }
                   },
@@ -59350,12 +59259,12 @@ async function paginate(config, documents) {
               ).concat(
                 !nodeQuery ? [] : keys2.map(
                   (key) => ({
-                    kind: graphql12.Kind.VARIABLE_DEFINITION,
+                    kind: graphql13.Kind.VARIABLE_DEFINITION,
                     type: key.type,
                     variable: {
-                      kind: graphql12.Kind.VARIABLE,
+                      kind: graphql13.Kind.VARIABLE,
                       name: {
-                        kind: graphql12.Kind.NAME,
+                        kind: graphql13.Kind.NAME,
                         value: key.name
                       }
                     }
@@ -59364,42 +59273,42 @@ async function paginate(config, documents) {
               )
             ),
             selectionSet: {
-              kind: graphql12.Kind.SELECTION_SET,
+              kind: graphql13.Kind.SELECTION_SET,
               selections: !nodeQuery ? fragmentSpreadSelection : [
                 {
-                  kind: graphql12.Kind.FIELD,
+                  kind: graphql13.Kind.FIELD,
                   name: {
-                    kind: graphql12.Kind.NAME,
+                    kind: graphql13.Kind.NAME,
                     value: typeConfig?.resolve?.queryField || "node"
                   },
                   ["arguments"]: keys2.map((key) => ({
-                    kind: graphql12.Kind.ARGUMENT,
+                    kind: graphql13.Kind.ARGUMENT,
                     name: {
-                      kind: graphql12.Kind.NAME,
+                      kind: graphql13.Kind.NAME,
                       value: key.name
                     },
                     value: {
-                      kind: graphql12.Kind.VARIABLE,
+                      kind: graphql13.Kind.VARIABLE,
                       name: {
-                        kind: graphql12.Kind.NAME,
+                        kind: graphql13.Kind.NAME,
                         value: key.name
                       }
                     }
                   })),
                   selectionSet: {
-                    kind: graphql12.Kind.SELECTION_SET,
+                    kind: graphql13.Kind.SELECTION_SET,
                     selections: [
                       {
-                        kind: graphql12.Kind.FIELD,
+                        kind: graphql13.Kind.FIELD,
                         name: {
-                          kind: graphql12.Kind.NAME,
+                          kind: graphql13.Kind.NAME,
                           value: "__typename"
                         }
                       },
                       ...(typeConfig?.keys || [config.defaultKeys[0]]).map((key) => ({
-                        kind: graphql12.Kind.FIELD,
+                        kind: graphql13.Kind.FIELD,
                         name: {
-                          kind: graphql12.Kind.NAME,
+                          kind: graphql13.Kind.NAME,
                           value: key
                         }
                       })),
@@ -59456,15 +59365,15 @@ function replaceArgumentsWithVariables(args, flags) {
 }
 function variableAsArgument(name, variable) {
   return {
-    kind: graphql12.Kind.ARGUMENT,
+    kind: graphql13.Kind.ARGUMENT,
     name: {
-      kind: graphql12.Kind.NAME,
+      kind: graphql13.Kind.NAME,
       value: name
     },
     value: {
-      kind: graphql12.Kind.VARIABLE,
+      kind: graphql13.Kind.VARIABLE,
       name: {
-        kind: graphql12.Kind.NAME,
+        kind: graphql13.Kind.NAME,
         value: variable ?? name
       }
     }
@@ -59472,18 +59381,18 @@ function variableAsArgument(name, variable) {
 }
 function staticVariableDefinition(name, type, defaultValue, variableName) {
   return {
-    kind: graphql12.Kind.VARIABLE_DEFINITION,
+    kind: graphql13.Kind.VARIABLE_DEFINITION,
     type: {
-      kind: graphql12.Kind.NAMED_TYPE,
+      kind: graphql13.Kind.NAMED_TYPE,
       name: {
-        kind: graphql12.Kind.NAME,
+        kind: graphql13.Kind.NAME,
         value: type
       }
     },
     variable: {
-      kind: graphql12.Kind.VARIABLE,
+      kind: graphql13.Kind.VARIABLE,
       name: {
-        kind: graphql12.Kind.NAME,
+        kind: graphql13.Kind.NAME,
         value: variableName ?? name
       }
     },
@@ -59495,9 +59404,9 @@ function staticVariableDefinition(name, type, defaultValue, variableName) {
 }
 function argumentNode(name, value) {
   return {
-    kind: graphql12.Kind.ARGUMENT,
+    kind: graphql13.Kind.ARGUMENT,
     name: {
-      kind: graphql12.Kind.NAME,
+      kind: graphql13.Kind.NAME,
       value: name
     },
     value: objectNode(value)
@@ -59505,16 +59414,16 @@ function argumentNode(name, value) {
 }
 function objectNode([type, defaultValue]) {
   const node = {
-    kind: graphql12.Kind.OBJECT,
+    kind: graphql13.Kind.OBJECT,
     fields: [
       {
-        kind: graphql12.Kind.OBJECT_FIELD,
+        kind: graphql13.Kind.OBJECT_FIELD,
         name: {
-          kind: graphql12.Kind.NAME,
+          kind: graphql13.Kind.NAME,
           value: "type"
         },
         value: {
-          kind: graphql12.Kind.STRING,
+          kind: graphql13.Kind.STRING,
           value: type
         }
       }
@@ -59522,8 +59431,8 @@ function objectNode([type, defaultValue]) {
   };
   if (defaultValue) {
     node.fields.push({
-      kind: graphql12.Kind.OBJECT_FIELD,
-      name: { kind: graphql12.Kind.NAME, value: "default" },
+      kind: graphql13.Kind.OBJECT_FIELD,
+      name: { kind: graphql13.Kind.NAME, value: "default" },
       value: {
         kind: typeof defaultValue === "number" ? "IntValue" : "StringValue",
         value: defaultValue.toString()
@@ -59534,34 +59443,34 @@ function objectNode([type, defaultValue]) {
 }
 var pageInfoSelection = [
   {
-    kind: graphql12.Kind.FIELD,
+    kind: graphql13.Kind.FIELD,
     name: {
-      kind: graphql12.Kind.NAME,
+      kind: graphql13.Kind.NAME,
       value: "edges"
     },
     selectionSet: {
-      kind: graphql12.Kind.SELECTION_SET,
+      kind: graphql13.Kind.SELECTION_SET,
       selections: [
         {
-          kind: graphql12.Kind.FIELD,
+          kind: graphql13.Kind.FIELD,
           name: {
-            kind: graphql12.Kind.NAME,
+            kind: graphql13.Kind.NAME,
             value: "cursor"
           }
         },
         {
-          kind: graphql12.Kind.FIELD,
+          kind: graphql13.Kind.FIELD,
           name: {
-            kind: graphql12.Kind.NAME,
+            kind: graphql13.Kind.NAME,
             value: "node"
           },
           selectionSet: {
-            kind: graphql12.Kind.SELECTION_SET,
+            kind: graphql13.Kind.SELECTION_SET,
             selections: [
               {
-                kind: graphql12.Kind.FIELD,
+                kind: graphql13.Kind.FIELD,
                 name: {
-                  kind: graphql12.Kind.NAME,
+                  kind: graphql13.Kind.NAME,
                   value: "__typename"
                 }
               }
@@ -59572,39 +59481,39 @@ var pageInfoSelection = [
     }
   },
   {
-    kind: graphql12.Kind.FIELD,
+    kind: graphql13.Kind.FIELD,
     name: {
-      kind: graphql12.Kind.NAME,
+      kind: graphql13.Kind.NAME,
       value: "pageInfo"
     },
     selectionSet: {
-      kind: graphql12.Kind.SELECTION_SET,
+      kind: graphql13.Kind.SELECTION_SET,
       selections: [
         {
-          kind: graphql12.Kind.FIELD,
+          kind: graphql13.Kind.FIELD,
           name: {
-            kind: graphql12.Kind.NAME,
+            kind: graphql13.Kind.NAME,
             value: "hasPreviousPage"
           }
         },
         {
-          kind: graphql12.Kind.FIELD,
+          kind: graphql13.Kind.FIELD,
           name: {
-            kind: graphql12.Kind.NAME,
+            kind: graphql13.Kind.NAME,
             value: "hasNextPage"
           }
         },
         {
-          kind: graphql12.Kind.FIELD,
+          kind: graphql13.Kind.FIELD,
           name: {
-            kind: graphql12.Kind.NAME,
+            kind: graphql13.Kind.NAME,
             value: "startCursor"
           }
         },
         {
-          kind: graphql12.Kind.FIELD,
+          kind: graphql13.Kind.FIELD,
           name: {
-            kind: graphql12.Kind.NAME,
+            kind: graphql13.Kind.NAME,
             value: "endCursor"
           }
         }
@@ -59618,17 +59527,17 @@ async function addListFragments(config, documents) {
   const lists = {};
   const errors = [];
   for (const doc of documents) {
-    doc.document = graphql13.visit(doc.document, {
+    doc.document = graphql14.visit(doc.document, {
       Directive(node, key, parent2, path2, ancestors) {
         if ([config.listDirective, config.paginateDirective].includes(node.name.value)) {
           const nameArg = node.arguments?.find(
             (arg) => arg.name.value === config.listOrPaginateNameArg
           );
           let error = {
-            ...new graphql13.GraphQLError(
+            ...new graphql14.GraphQLError(
               "",
               node,
-              new graphql13.Source(""),
+              new graphql14.Source(""),
               node.loc ? [node.loc.start, node.loc.end] : null,
               path2
             ),
@@ -59680,7 +59589,7 @@ async function addListFragments(config, documents) {
                 {
                   kind: "Argument",
                   name: {
-                    kind: graphql13.Kind.NAME,
+                    kind: graphql14.Kind.NAME,
                     value: "connection"
                   },
                   value: {
@@ -59730,7 +59639,7 @@ async function addListFragments(config, documents) {
   const validDeletes = [
     ...new Set(
       Object.values(lists).map(({ type }) => {
-        if (!(type instanceof graphql13.GraphQLObjectType)) {
+        if (!(type instanceof graphql14.GraphQLObjectType)) {
           return "";
         }
         if (config.keyFieldsForType(type.name).length !== 1) {
@@ -59744,7 +59653,7 @@ async function addListFragments(config, documents) {
     return;
   }
   const generatedDoc = {
-    kind: graphql13.Kind.DOCUMENT,
+    kind: graphql14.Kind.DOCUMENT,
     definitions: Object.entries(lists).flatMap(
       ([name, { selection, type }]) => {
         const schemaType = config.schema.getType(type.name);
@@ -59752,7 +59661,7 @@ async function addListFragments(config, documents) {
           throw new HoudiniError({ message: "Lists must have a selection" });
         }
         const fragmentSelection = {
-          kind: graphql13.Kind.SELECTION_SET,
+          kind: graphql14.Kind.SELECTION_SET,
           selections: [...selection.selections]
         };
         if (schemaType && fragmentSelection && !fragmentSelection?.selections.find(
@@ -59767,14 +59676,14 @@ async function addListFragments(config, documents) {
           {
             name: {
               value: config.listInsertFragment(name),
-              kind: graphql13.Kind.NAME
+              kind: graphql14.Kind.NAME
             },
-            kind: graphql13.Kind.FRAGMENT_DEFINITION,
+            kind: graphql14.Kind.FRAGMENT_DEFINITION,
             selectionSet: fragmentSelection,
             typeCondition: {
-              kind: graphql13.Kind.NAMED_TYPE,
+              kind: graphql14.Kind.NAMED_TYPE,
               name: {
-                kind: graphql13.Kind.NAME,
+                kind: graphql14.Kind.NAME,
                 value: type.name
               }
             }
@@ -59782,32 +59691,32 @@ async function addListFragments(config, documents) {
           {
             name: {
               value: config.listToggleFragment(name),
-              kind: graphql13.Kind.NAME
+              kind: graphql14.Kind.NAME
             },
-            kind: graphql13.Kind.FRAGMENT_DEFINITION,
+            kind: graphql14.Kind.FRAGMENT_DEFINITION,
             selectionSet: fragmentSelection,
             typeCondition: {
-              kind: graphql13.Kind.NAMED_TYPE,
+              kind: graphql14.Kind.NAMED_TYPE,
               name: {
-                kind: graphql13.Kind.NAME,
+                kind: graphql14.Kind.NAME,
                 value: type.name
               }
             }
           },
           {
-            kind: graphql13.Kind.FRAGMENT_DEFINITION,
+            kind: graphql14.Kind.FRAGMENT_DEFINITION,
             name: {
               value: config.listRemoveFragment(name),
-              kind: graphql13.Kind.NAME
+              kind: graphql14.Kind.NAME
             },
             selectionSet: {
-              kind: graphql13.Kind.SELECTION_SET,
+              kind: graphql14.Kind.SELECTION_SET,
               selections: [...objectIdentificationSelection(config, type)]
             },
             typeCondition: {
-              kind: graphql13.Kind.NAMED_TYPE,
+              kind: graphql14.Kind.NAMED_TYPE,
               name: {
-                kind: graphql13.Kind.NAME,
+                kind: graphql14.Kind.NAME,
                 value: type.name
               }
             }
@@ -59816,14 +59725,14 @@ async function addListFragments(config, documents) {
       }
     ).concat(
       ...validDeletes.map((typeName) => ({
-        kind: graphql13.Kind.DIRECTIVE_DEFINITION,
+        kind: graphql14.Kind.DIRECTIVE_DEFINITION,
         name: {
-          kind: graphql13.Kind.NAME,
+          kind: graphql14.Kind.NAME,
           value: config.listDeleteDirective(typeName)
         },
         locations: [
           {
-            kind: graphql13.Kind.NAME,
+            kind: graphql14.Kind.NAME,
             value: "FIELD"
           }
         ],
@@ -59831,8 +59740,8 @@ async function addListFragments(config, documents) {
       }))
     )
   };
-  config.newSchema += "\n" + generatedDoc.definitions.filter((c) => c.kind !== "FragmentDefinition").map(graphql13.print).join("\n\n");
-  config.newDocuments += "\n" + generatedDoc.definitions.filter((c) => c.kind === "FragmentDefinition").map(graphql13.print).join("\n\n");
+  config.newSchema += "\n" + generatedDoc.definitions.filter((c) => c.kind !== "FragmentDefinition").map(graphql14.print).join("\n\n");
+  config.newDocuments += "\n" + generatedDoc.definitions.filter((c) => c.kind === "FragmentDefinition").map(graphql14.print).join("\n\n");
   documents.push({
     name: "generated::lists",
     kind: ArtifactKind.Fragment,
@@ -59918,11 +59827,11 @@ var nodeNotDefinedMessage = (config) => `Looks like you are trying to use the ${
 For more information, visit this link: ${siteURL}/guides/pagination`;
 
 // src/codegen/generators/artifacts/fieldKey.ts
-import * as graphql14 from "graphql";
+import * as graphql15 from "graphql";
 function fieldKey(config, field) {
   const attributeName = field.alias?.value || field.name.value;
-  const printed = graphql14.print(field);
-  const secondParse = graphql14.parse(`{${printed}}`).definitions[0].selectionSet.selections[0];
+  const printed = graphql15.print(field);
+  const secondParse = graphql15.parse(`{${printed}}`).definitions[0].selectionSet.selections[0];
   let paginateMode = config.defaultPaginateMode;
   const paginatedDirective = field.directives?.find(
     (directive) => directive.name.value === config.paginateDirective
@@ -60045,13 +59954,13 @@ function prepareSelection({
       } else if ("getFields" in type) {
         let typeRef = type.getFields()[field.name.value].type;
         fieldType = getRootType(typeRef);
-        nullable = !graphql15.isNonNullType(typeRef);
-      } else if (graphql15.isAbstractType(type)) {
+        nullable = !graphql16.isNonNullType(typeRef);
+      } else if (graphql16.isAbstractType(type)) {
         for (const possible of config.schema.getPossibleTypes(type)) {
-          if (graphql15.isObjectType(possible)) {
+          if (graphql16.isObjectType(possible)) {
             if (possible.getFields()[field.name.value]) {
               fieldType = possible.getFields()[field.name.value].type;
-              nullable = !graphql15.isNonNullType(fieldType);
+              nullable = !graphql16.isNonNullType(fieldType);
               break;
             }
           }
@@ -60188,7 +60097,7 @@ function prepareSelection({
           kind: "value"
         } : { kind: "continue" };
         const parentType = config.schema.getType(rootType);
-        if (graphql15.isObjectType(parentType) || graphql15.isInterfaceType(parentType)) {
+        if (graphql16.isObjectType(parentType) || graphql16.isInterfaceType(parentType)) {
           const fieldType2 = parentType.getFields()[field.name.value]?.type;
           if (fieldType2) {
             const listCount = unwrapType(config, fieldType2).wrappers.filter(
@@ -60211,7 +60120,7 @@ function prepareSelection({
         }
         fieldObj.loading = loadingValue;
       }
-      if (graphql15.isInterfaceType(fieldType) || graphql15.isUnionType(fieldType)) {
+      if (graphql16.isInterfaceType(fieldType) || graphql16.isUnionType(fieldType)) {
         fieldObj.abstract = true;
         if (Object.values(fieldObj.selection?.abstractFields?.fields ?? {}).some(
           (fields) => Object.values(fields ?? {}).some((field2) => field2.required)
@@ -60293,7 +60202,7 @@ function mergeSelection({
         typeSelection,
         abstractSelection.fields[typeName] ?? {}
       );
-      if (graphql15.isAbstractType(gqlType)) {
+      if (graphql16.isAbstractType(gqlType)) {
         for (const possible of config.schema.getPossibleTypes(gqlType)) {
           if (!possibleSelectionTypes[typeName]) {
             possibleSelectionTypes[typeName] = [];
@@ -60328,7 +60237,7 @@ function mergeSelection({
       }
     }
     const parentType = config.schema.getType(rootType);
-    const possibleParents = graphql15.isAbstractType(parentType) ? config.schema.getPossibleTypes(parentType)?.map((t2) => t2.name) : [parentType.name];
+    const possibleParents = graphql16.isAbstractType(parentType) ? config.schema.getPossibleTypes(parentType)?.map((t2) => t2.name) : [parentType.name];
     for (const key of Object.keys(abstractSelection.typeMap)) {
       if (!possibleParents.includes(key) && rootType !== key || abstractSelection.fields[key]) {
         delete abstractSelection.typeMap[key];
@@ -60385,12 +60294,12 @@ function mergeSelection({
 }
 
 // src/codegen/generators/artifacts/index.ts
-var AST4 = recast4.types.builders;
+var AST5 = recast5.types.builders;
 function artifactGenerator(stats) {
   return async function(config, docs) {
     const filterTypes = {};
     for (const doc of docs) {
-      graphql16.visit(doc.document, {
+      graphql17.visit(doc.document, {
         Directive(node, _, __, ___, ancestors) {
           if (node.name.value !== config.listDirective) {
             return;
@@ -60450,7 +60359,7 @@ function artifactGenerator(stats) {
             return;
           }
           const usedVariableNames = /* @__PURE__ */ new Set();
-          let documentWithoutInternalDirectives = graphql16.visit(document, {
+          let documentWithoutInternalDirectives = graphql17.visit(document, {
             Directive(node) {
               if (config.isInternalDirective(node.name.value)) {
                 return null;
@@ -60463,7 +60372,7 @@ function artifactGenerator(stats) {
               }
             }
           });
-          let documentWithoutExtraVariables = graphql16.visit(
+          let documentWithoutExtraVariables = graphql17.visit(
             documentWithoutInternalDirectives,
             {
               VariableDefinition(variableDefinitionNode) {
@@ -60474,13 +60383,13 @@ function artifactGenerator(stats) {
               }
             }
           );
-          let rawString = graphql16.print(documentWithoutExtraVariables);
+          let rawString = graphql17.print(documentWithoutExtraVariables);
           let docKind = doc.kind;
           const operations = document.definitions.filter(
-            ({ kind }) => kind === graphql16.Kind.OPERATION_DEFINITION
+            ({ kind }) => kind === graphql17.Kind.OPERATION_DEFINITION
           );
           const fragments = document.definitions.filter(
-            ({ kind }) => kind === graphql16.Kind.FRAGMENT_DEFINITION
+            ({ kind }) => kind === graphql17.Kind.FRAGMENT_DEFINITION
           );
           let rootType = "";
           let selectionSet;
@@ -60680,9 +60589,9 @@ function artifactGenerator(stats) {
             plugin2.artifactEnd({ config, document: doc });
           }
           const _houdiniHash = hashOriginal({ document: doc });
-          const file = AST4.program([
+          const file = AST5.program([
             moduleExport(config, "default", serializeValue(artifact)),
-            AST4.expressionStatement(AST4.stringLiteral(`HoudiniHash=${_houdiniHash}`))
+            AST5.expressionStatement(AST5.stringLiteral(`HoudiniHash=${_houdiniHash}`))
           ]);
           const artifactPath = config.artifactPath(document);
           const countDocument = doc.generateStore;
@@ -60740,7 +60649,7 @@ function applyMask(config, target, mask) {
     if (!targetType) {
       continue;
     }
-    if (graphql16.isAbstractType(targetType)) {
+    if (graphql17.isAbstractType(targetType)) {
       for (const possible of config.schema.getPossibleTypes(targetType)) {
         if (target.abstractFields?.fields[possible.name]) {
           applyMask(
@@ -60763,8 +60672,8 @@ function applyMask(config, target, mask) {
 }
 
 // src/codegen/generators/runtime/graphqlFunction.ts
-var recast5 = __toESM(require_main2(), 1);
-var AST5 = recast5.types.builders;
+var recast6 = __toESM(require_main2(), 1);
+var AST6 = recast6.types.builders;
 async function generateGraphqlReturnTypes(config, docs) {
   const indexPath = path_exports.join(config.runtimeDirectory, "index.d.ts");
   const fileContent = await fs_exports.readFile(indexPath) || "";
@@ -60799,18 +60708,18 @@ async function generateGraphqlReturnTypes(config, docs) {
         continue;
       }
       for (const [queryString, returnValue] of Object.entries(overloaded_returns)) {
-        const input = AST5.identifier("str");
-        input.typeAnnotation = AST5.tsTypeAnnotation(
-          AST5.tsLiteralType(AST5.stringLiteral(queryString))
+        const input = AST6.identifier("str");
+        input.typeAnnotation = AST6.tsTypeAnnotation(
+          AST6.tsLiteralType(AST6.stringLiteral(queryString))
         );
         script.body.splice(
           i,
           0,
-          AST5.exportNamedDeclaration(
-            AST5.tsDeclareFunction(
-              AST5.identifier("graphql"),
+          AST6.exportNamedDeclaration(
+            AST6.tsDeclareFunction(
+              AST6.identifier("graphql"),
               [input],
-              AST5.tsTypeAnnotation(AST5.tsTypeReference(AST5.identifier(returnValue)))
+              AST6.tsTypeAnnotation(AST6.tsTypeReference(AST6.identifier(returnValue)))
             )
           )
         );
@@ -60985,165 +60894,22 @@ function moduleStatments(config) {
 var recast11 = __toESM(require_main2(), 1);
 
 // src/codegen/generators/typescript/addReferencedInputTypes.ts
-var recast8 = __toESM(require_main2(), 1);
-import * as graphql19 from "graphql";
-
-// src/codegen/generators/typescript/typeReference.ts
 var recast7 = __toESM(require_main2(), 1);
 import * as graphql18 from "graphql";
-
-// src/codegen/generators/typescript/types.ts
-var recast6 = __toESM(require_main2(), 1);
-import * as graphql17 from "graphql";
-var AST6 = recast6.types.builders;
-function readonlyProperty(prop, enable = true) {
-  if (enable) {
-    prop.readonly = true;
-  }
-  return prop;
-}
-function nullableField(inner, input = false) {
-  const members = [inner, AST6.tsNullKeyword()];
-  if (input) {
-    members.push(AST6.tsUndefinedKeyword());
-  }
-  return AST6.tsUnionType(members);
-}
-function scalarPropertyValue(config, filepath, missingScalars, target, body, field) {
-  if (config.configFile.features?.componentFields && target.name === config.componentScalar) {
-    if (!field) {
-      return AST6.tsNeverKeyword();
-    }
-    const component = config.componentFields[field.parent][field.field];
-    const sourcePathRelative = path_exports.relative(
-      path_exports.join(config.projectRoot, "src"),
-      component.filepath
-    );
-    let sourcePathParsed = path_exports.parse(sourcePathRelative);
-    let sourcePath = path_exports.join(sourcePathParsed.dir, sourcePathParsed.name);
-    const localImport = ensureImports({
-      config,
-      body,
-      import: "__component__" + component.fragment,
-      sourceModule: path_exports.join(
-        path_exports.relative(path_exports.dirname(filepath), config.projectRoot),
-        "src",
-        sourcePath
-      )
-    });
-    const parameters = AST6.tsTypeReference(AST6.identifier("Parameters"));
-    parameters.typeParameters = AST6.tsTypeParameterInstantiation([
-      AST6.tsTypeQuery(AST6.identifier(localImport))
-    ]);
-    const indexed = AST6.tsIndexedAccessType(
-      parameters,
-      AST6.tsLiteralType(AST6.numericLiteral(0))
-    );
-    const omit = AST6.tsTypeReference(AST6.identifier("Omit"));
-    omit.typeParameters = AST6.tsTypeParameterInstantiation([
-      indexed,
-      AST6.tsLiteralType(AST6.stringLiteral(component.prop))
-    ]);
-    const arg = AST6.identifier("props");
-    arg.typeAnnotation = AST6.tsTypeAnnotation(omit);
-    const returnType = AST6.tsTypeReference(AST6.identifier("ReturnType"));
-    returnType.typeParameters = AST6.tsTypeParameterInstantiation([
-      AST6.tsTypeQuery(AST6.identifier(localImport))
-    ]);
-    const fnType = AST6.tsFunctionType([arg]);
-    fnType.typeAnnotation = AST6.tsTypeAnnotation(returnType);
-    return fnType;
-  }
-  switch (target.name) {
-    case "String": {
-      return AST6.tsStringKeyword();
-    }
-    case "Int": {
-      return AST6.tsNumberKeyword();
-    }
-    case "Float": {
-      return AST6.tsNumberKeyword();
-    }
-    case "Boolean": {
-      return AST6.tsBooleanKeyword();
-    }
-    case "ID": {
-      return AST6.tsStringKeyword();
-    }
-    default: {
-      if (graphql17.isNonNullType(target) && "ofType" in target) {
-        return scalarPropertyValue(
-          config,
-          filepath,
-          missingScalars,
-          target.ofType,
-          body,
-          field
-        );
-      }
-      if (config.scalars?.[target.name]) {
-        return AST6.tsTypeReference(AST6.identifier(config.scalars?.[target.name].type));
-      }
-      if (target.name !== config.componentScalar) {
-        missingScalars.add(target.name);
-      }
-      return AST6.tsAnyKeyword();
-    }
-  }
-}
-
-// src/codegen/generators/typescript/typeReference.ts
 var AST7 = recast7.types.builders;
-function tsTypeReference(config, filepath, missingScalars, definition, body) {
-  const { type, wrappers } = unwrapType(config, definition.type);
-  let result;
-  if (graphql18.isScalarType(type)) {
-    result = scalarPropertyValue(config, filepath, missingScalars, type, body, null);
-  } else if (graphql18.isEnumType(type)) {
-    result = enumReference(config, body, type.name);
-  } else {
-    result = AST7.tsTypeReference(AST7.identifier(type.name));
-  }
-  for (const toWrap of wrappers) {
-    if (toWrap === "NonNull" /* NonNull */) {
-      continue;
-    } else if (toWrap === "Nullable" /* Nullable */) {
-      result = nullableField(result, true);
-    } else if (toWrap === "List" /* List */) {
-      result = AST7.tsArrayType(AST7.tsParenthesizedType(result));
-    }
-  }
-  return result;
-}
-function enumReference(config, body, name) {
-  ensureImports({
-    config,
-    body,
-    import: ["ValueOf"],
-    importKind: "type",
-    sourceModule: "$houdini/runtime/lib/types"
-  });
-  return AST7.tsTypeReference(
-    AST7.identifier("ValueOf"),
-    AST7.tsTypeParameterInstantiation([AST7.tsTypeQuery(AST7.identifier(name))])
-  );
-}
-
-// src/codegen/generators/typescript/addReferencedInputTypes.ts
-var AST8 = recast8.types.builders;
 function addReferencedInputTypes(config, filepath, body, visitedTypes, missingScalars, rootType) {
   const { type } = unwrapType(config, rootType);
-  if (graphql19.isScalarType(type)) {
+  if (graphql18.isScalarType(type)) {
     return;
   }
   if (visitedTypes.has(type.name)) {
     return;
   }
-  if (graphql19.isUnionType(type)) {
+  if (graphql18.isUnionType(type)) {
     throw new HoudiniError({ filepath, message: "Input Unions are not supported yet. Sorry!" });
   }
   visitedTypes.add(type.name);
-  if (graphql19.isEnumType(type)) {
+  if (graphql18.isEnumType(type)) {
     ensureImports({
       config,
       body,
@@ -61157,21 +60923,37 @@ function addReferencedInputTypes(config, filepath, body, visitedTypes, missingSc
   for (const field of Object.values(type.getFields())) {
     addReferencedInputTypes(config, filepath, body, visitedTypes, missingScalars, field.type);
     members.push(
-      AST8.tsPropertySignature(
-        AST8.identifier(field.name),
-        AST8.tsTypeAnnotation(
+      AST7.tsPropertySignature(
+        AST7.identifier(field.name),
+        AST7.tsTypeAnnotation(
           tsTypeReference(config, filepath, missingScalars, field, body)
         ),
-        graphql19.isNullableType(field.type)
+        graphql18.isNullableType(field.type)
       )
     );
   }
-  body.push(AST8.tsTypeAliasDeclaration(AST8.identifier(type.name), AST8.tsTypeLiteral(members)));
+  body.push(AST7.tsTypeAliasDeclaration(AST7.identifier(type.name), AST7.tsTypeLiteral(members)));
 }
 
 // src/codegen/generators/typescript/inlineType.ts
 var recast9 = __toESM(require_main2(), 1);
-import * as graphql20 from "graphql";
+import * as graphql19 from "graphql";
+
+// src/codegen/generators/comments/jsdoc.ts
+var recast8 = __toESM(require_main2(), 1);
+var AST8 = recast8.types.builders;
+function jsdocComment(text, deprecated) {
+  let commentContent = `*
+ * ${text}
+`;
+  if (deprecated) {
+    commentContent = `${commentContent} * @deprecated ${deprecated}
+`;
+  }
+  return AST8.commentBlock(commentContent, true);
+}
+
+// src/codegen/generators/typescript/inlineType.ts
 var AST9 = recast9.types.builders;
 var fragmentKey2 = " $fragments";
 function inlineType({
@@ -61192,7 +60974,7 @@ function inlineType({
   const { type, wrappers } = unwrapType(config, rootType);
   let result;
   let forceNullable = false;
-  if (graphql20.isScalarType(type)) {
+  if (graphql19.isScalarType(type)) {
     result = scalarPropertyValue(
       config,
       filepath,
@@ -61201,7 +60983,7 @@ function inlineType({
       body,
       field
     );
-  } else if (graphql20.isEnumType(type)) {
+  } else if (graphql19.isEnumType(type)) {
     ensureImports({
       config,
       body,
@@ -61226,11 +61008,11 @@ function inlineType({
     for (const selection of selections) {
       if (selection.kind === "InlineFragment" && selection.typeCondition) {
         const fragmentType = config.schema.getType(selection.typeCondition.name.value);
-        if (!graphql20.isInterfaceType(type) && !graphql20.isUnionType(type)) {
+        if (!graphql19.isInterfaceType(type) && !graphql19.isUnionType(type)) {
           selectedFields.push(...selection.selectionSet.selections);
           continue;
         }
-        if (!graphql20.isInterfaceType(fragmentType) && !graphql20.isUnionType(fragmentType)) {
+        if (!graphql19.isInterfaceType(fragmentType) && !graphql19.isUnionType(fragmentType)) {
           if (!inlineFragments[fragmentType.name]) {
             inlineFragments[fragmentType.name] = [];
           }
@@ -61322,6 +61104,11 @@ function inlineType({
         if (allOptional) {
           prop.optional = true;
         }
+        if (field2.description || field2.deprecationReason) {
+          prop.comments = [
+            jsdocComment(field2.description ?? "", field2.deprecationReason ?? void 0)
+          ];
+        }
         return prop;
       })
     ]);
@@ -61373,7 +61160,7 @@ function inlineType({
           }
         }
       }
-      if (objectType.type === "TSTypeLiteral" && !graphql20.isInterfaceType(fragmentRootType) && !graphql20.isUnionType(fragmentRootType)) {
+      if (objectType.type === "TSTypeLiteral" && !graphql19.isInterfaceType(fragmentRootType) && !graphql19.isUnionType(fragmentRootType)) {
         const existingTypenameIndex = objectType.members.findIndex(
           (member) => member.type === "TSPropertySignature" && member.key.type === "Identifier" && member.key.name === "__typename"
         );
@@ -61398,11 +61185,11 @@ function inlineType({
         ];
       }
       let coveredTypenames;
-      if (graphql20.isInterfaceType(fragmentRootType)) {
+      if (graphql19.isInterfaceType(fragmentRootType)) {
         coveredTypenames = interfaceCoveredTypenames(fragmentRootType);
-      } else if (graphql20.isUnionType(fragmentRootType)) {
+      } else if (graphql19.isUnionType(fragmentRootType)) {
         coveredTypenames = fragmentRootType.getTypes().map((type2) => type2.name);
-      } else if (graphql20.isObjectType(fragmentRootType)) {
+      } else if (graphql19.isObjectType(fragmentRootType)) {
         coveredTypenames = [fragmentRootType.name];
       } else {
         throw Error("unreachable code");
@@ -61438,7 +61225,7 @@ function inlineType({
           );
         }
       );
-      const parentIsUnionOrInterface = !graphql20.isInterfaceType(type) && !graphql20.isUnionType(type);
+      const parentIsUnionOrInterface = !graphql19.isInterfaceType(type) && !graphql19.isUnionType(type);
       const possibleTypenames = parentIsUnionOrInterface ? [parent.name] : config.schema.getPossibleTypes(type).map((type2) => type2.name);
       const coveredTypenames = new Set(
         Object.values(inlineFragmentSelections).flatMap((sel) => sel.coveredTypenames)
@@ -61505,7 +61292,7 @@ function selectionTypeInfo(schema, filepath, rootType, selection) {
       },
       type: schema.getType("String")
     };
-  } else if (graphql20.isNonNullType(rootType) && "getFields" in rootType.ofType) {
+  } else if (graphql19.isNonNullType(rootType) && "getFields" in rootType.ofType) {
     fields = rootType.ofType.getFields();
   } else {
     fields = rootType.getFields();
@@ -61517,7 +61304,7 @@ function selectionTypeInfo(schema, filepath, rootType, selection) {
       message: `Could not find type information for field ${rootType.toString()}.${selectionName} ${field}`
     });
   }
-  const fieldType = graphql20.getNamedType(field.type);
+  const fieldType = graphql19.getNamedType(field.type);
   if (!fieldType) {
     throw new HoudiniError({
       filepath,
@@ -62026,7 +61813,7 @@ async function generateFragmentTypeDefs(config, filepath, body, selections, defi
 
 // src/codegen/generators/typescript/imperativeTypeDef.ts
 var recast12 = __toESM(require_main2(), 1);
-import * as graphql21 from "graphql";
+import * as graphql20 from "graphql";
 var AST12 = recast12.types.builders;
 async function imperativeCacheTypef(config, docs) {
   const returnType = (doc) => config.plugins.find((plugin2) => plugin2.graphqlTagReturn)?.graphqlTagReturn?.({
@@ -62077,7 +61864,7 @@ function typeDefinitions(config, filepath, body, docs, returnType) {
   const operationTypes = [config.schema.getMutationType(), config.schema.getSubscriptionType()].filter(Boolean).map((type) => type?.name);
   const visitedTypes = /* @__PURE__ */ new Set();
   const types14 = Object.values(config.schema.getTypeMap()).filter(
-    (type) => !graphql21.isAbstractType(type) && !graphql21.isScalarType(type) && !graphql21.isEnumType(type) && !graphql21.isInputObjectType(type) && !type.name.startsWith("__") && !operationTypes.includes(type.name)
+    (type) => !graphql20.isAbstractType(type) && !graphql20.isScalarType(type) && !graphql20.isEnumType(type) && !graphql20.isInputObjectType(type) && !type.name.startsWith("__") && !operationTypes.includes(type.name)
   );
   const fragmentMap = fragmentListMap(
     config,
@@ -62094,7 +61881,7 @@ function typeDefinitions(config, filepath, body, docs, returnType) {
       }
       let idFields = AST12.tsNeverKeyword();
       const keys2 = keyFieldsForType(config.configFile, type.name);
-      if (graphql21.isObjectType(type) && keys2.length > 0 && keys2.every((key) => type.getFields()[key])) {
+      if (graphql20.isObjectType(type) && keys2.length > 0 && keys2.every((key) => type.getFields()[key])) {
         idFields = AST12.tsTypeLiteral(
           keys2.map((key) => {
             const fieldType = type.getFields()[key];
@@ -62121,13 +61908,13 @@ function typeDefinitions(config, filepath, body, docs, returnType) {
         idFields = AST12.tsTypeLiteral([]);
       }
       let fields = AST12.tsTypeLiteral([]);
-      if (graphql21.isObjectType(type)) {
+      if (graphql20.isObjectType(type)) {
         fields = AST12.tsTypeLiteral(
           Object.entries(type.getFields()).map(
             ([key, fieldType]) => {
               const unwrapped = unwrapType(config, fieldType.type);
               let typeOptions = AST12.tsUnionType([]);
-              if (graphql21.isScalarType(unwrapped.type)) {
+              if (graphql20.isScalarType(unwrapped.type)) {
                 typeOptions.types.push(
                   scalarPropertyValue(
                     config,
@@ -62141,11 +61928,11 @@ function typeDefinitions(config, filepath, body, docs, returnType) {
                     }
                   )
                 );
-              } else if (graphql21.isEnumType(unwrapped.type)) {
+              } else if (graphql20.isEnumType(unwrapped.type)) {
                 typeOptions.types.push(
                   AST12.tsTypeReference(AST12.identifier(unwrapped.type.name))
                 );
-              } else if (!graphql21.isAbstractType(unwrapped.type)) {
+              } else if (!graphql20.isAbstractType(unwrapped.type)) {
                 typeOptions.types.push(record(unwrapped.type.name));
               } else {
                 typeOptions.types.push(
@@ -62241,7 +62028,7 @@ function listDefinitions(config, filepath, body, docs) {
   const lists = [];
   const visitedLists = /* @__PURE__ */ new Set();
   for (const doc of docs) {
-    graphql21.visit(doc.document, {
+    graphql20.visit(doc.document, {
       Directive(node, key, parent2, path2, ancestors) {
         if (![config.listDirective, config.paginateDirective].includes(node.name.value)) {
           return;
@@ -62263,7 +62050,7 @@ function listDefinitions(config, filepath, body, docs) {
         const targetFieldDefinition = parentType.getFields()[targetField.name.value];
         const { type: listType } = unwrapType(config, targetFieldDefinition.type);
         const possibleTypes = [];
-        if (graphql21.isAbstractType(listType)) {
+        if (graphql20.isAbstractType(listType)) {
           possibleTypes.push(
             ...config.schema.getPossibleTypes(listType).map((possible) => possible.name)
           );
@@ -62425,7 +62212,7 @@ async function typescriptGenerator(config, docs) {
 }
 
 // src/codegen/generators/persistedQueries/index.ts
-import * as graphql22 from "graphql";
+import * as graphql21 from "graphql";
 async function persistOutputGenerator(config, docs) {
   if (!config.persistedQueriesPath.endsWith(".json")) {
     throw new Error('Can write Persisted Queries only in a ".json" file.');
@@ -62435,8 +62222,8 @@ async function persistOutputGenerator(config, docs) {
     if (!generateArtifact) {
       return acc;
     }
-    let rawString = graphql22.print(
-      graphql22.visit(document, {
+    let rawString = graphql21.print(
+      graphql21.visit(document, {
         Directive(node) {
           if (config.isInternalDirective(node.name.value)) {
             return null;
@@ -62445,7 +62232,7 @@ async function persistOutputGenerator(config, docs) {
       })
     );
     const operations = document.definitions.filter(
-      ({ kind }) => kind === graphql22.Kind.OPERATION_DEFINITION
+      ({ kind }) => kind === graphql21.Kind.OPERATION_DEFINITION
     );
     if (operations.length > 0 && operations[0].kind === "OperationDefinition") {
       if (artifact) {
@@ -62460,33 +62247,45 @@ async function persistOutputGenerator(config, docs) {
 }
 
 // src/codegen/generators/definitions/index.ts
-import * as graphql24 from "graphql";
+import * as graphql23 from "graphql";
 
 // src/codegen/generators/definitions/enums.ts
 var recast13 = __toESM(require_main2(), 1);
-import * as graphql23 from "graphql";
+import * as graphql22 from "graphql";
 var AST13 = recast13.types.builders;
 async function definitionsGenerator(config) {
-  const enums = graphql23.parse(graphql23.printSchema(config.schema)).definitions.filter(
+  const enums = graphql22.parse(graphql22.printSchema(config.schema)).definitions.filter(
     (definition) => definition.kind === "EnumTypeDefinition"
   ).filter((def) => !config.isInternalEnum(def));
   const { code: runtimeDefinitions } = await printJS(
     AST13.program(
       enums.map((defn) => {
         const name = defn.name.value;
-        return moduleExport(
+        const declaration = moduleExport(
           config,
           name,
           AST13.objectExpression(
             defn.values?.map((value) => {
               const str = value.name.value;
-              return AST13.objectProperty(
+              const prop = AST13.objectProperty(
                 AST13.stringLiteral(str),
                 AST13.stringLiteral(str)
               );
+              const deprecationReason = value.directives?.find((d) => d.name.value === "deprecated")?.arguments?.find((a) => a.name.value === "reason")?.value?.value;
+              if (value.description || deprecationReason)
+                prop.comments = [
+                  jsdocComment(value.description?.value ?? "", deprecationReason)
+                ];
+              return prop;
             }) || []
           )
         );
+        if (defn.description) {
+          declaration.comments = [
+            AST13.commentBlock(`* ${defn.description.value} `, true, false)
+          ];
+        }
+        return declaration;
       })
     )
   );
@@ -62495,11 +62294,19 @@ type ValuesOf<T> = T[keyof T]
 	` + enums.sort((a, b) => a.name.value.localeCompare(b.name.value)).map((definition) => {
     const name = definition.name.value;
     const values = definition.values;
-    return `
+    let jsdoc = "";
+    if (definition.description) {
+      jsdoc = `
+/** ${definition.description.value} */`;
+    }
+    return `${jsdoc}
 export declare const ${name}: {
-${values?.map((value) => `    readonly ${value.name.value}: "${value.name.value}";`).join("\n")}
+${values?.map(
+      (value) => (value.description ? `    /** ${value.description.value} */
+` : "") + `    readonly ${value.name.value}: "${value.name.value}";`
+    ).join("\n")}
 }
-
+${jsdoc}
 export type ${name}$options = ValuesOf<typeof ${name}>
  `;
   }).join("");
@@ -62519,7 +62326,7 @@ async function schemaGenerator(config) {
   await Promise.all([
     fs_exports.writeFile(
       config.definitionsSchemaPath,
-      config.localSchema ? graphql24.printSchema(config.schema) : config.newSchema
+      config.localSchema ? graphql23.printSchema(config.schema) : config.newSchema
     ),
     fs_exports.writeFile(config.definitionsDocumentsPath, config.newDocuments),
     definitionsGenerator(config)
@@ -64224,7 +64031,7 @@ function mergeGraphQLTypes(typeSource, config) {
 }
 
 // src/codegen/transforms/schema.ts
-import * as graphql25 from "graphql";
+import * as graphql24 from "graphql";
 async function graphqlExtensions(config, documents) {
   let internalSchema = `
 enum CachePolicy {
@@ -64347,7 +64154,7 @@ directive @${config.componentFieldDirective}(field: String!, prop: String, expor
       const args = fragmentArguments(config, "", field.parent);
       if (args.length > 0) {
         argString = "(" + args.map((arg) => {
-          const typeName = graphql25.print(arg.type);
+          const typeName = graphql24.print(arg.type);
           return `${arg.name}:${typeName}${arg.required ? "!" : ""}`;
         }).join("\n") + ")";
       }
@@ -64357,20 +64164,20 @@ directive @${config.componentFieldDirective}(field: String!, prop: String, expor
 	`;
   }).join("\n");
   extensions += `${Object.keys(config.configFile.features?.runtimeScalars ?? {}).map((scalar) => `scalar ${scalar}`).join("\n")}`;
-  config.newSchema = graphql25.print(mergeTypeDefs([internalSchema, config.newSchema]));
+  config.newSchema = graphql24.print(mergeTypeDefs([internalSchema, config.newSchema]));
   config.schemaString += extensions;
-  config.schema = graphql25.buildSchema(
-    graphql25.print(
-      mergeTypeDefs([graphql25.printSchema(config.schema), internalSchema, extensions])
+  config.schema = graphql24.buildSchema(
+    graphql24.print(
+      mergeTypeDefs([graphql24.printSchema(config.schema), internalSchema, extensions])
     )
   );
 }
 
 // src/codegen/transforms/typename.ts
-import * as graphql26 from "graphql";
+import * as graphql25 from "graphql";
 async function addTypename(config, documents) {
   for (const doc of documents) {
-    doc.document = graphql26.visit(doc.document, {
+    doc.document = graphql25.visit(doc.document, {
       Field(node, key, parent2, path2, ancestors) {
         if (!node.selectionSet) {
           return;
@@ -64382,7 +64189,7 @@ async function addTypename(config, documents) {
         );
         const field = type.getFields()[node.name.value];
         const fieldType = unwrapType(config, field.type).type;
-        if (graphql26.isInterfaceType(fieldType) || graphql26.isUnionType(fieldType)) {
+        if (graphql25.isInterfaceType(fieldType) || graphql25.isUnionType(fieldType)) {
           return {
             ...node,
             selectionSet: {
@@ -64390,9 +64197,9 @@ async function addTypename(config, documents) {
               selections: [
                 ...node.selectionSet.selections,
                 {
-                  kind: graphql26.Kind.FIELD,
+                  kind: graphql25.Kind.FIELD,
                   name: {
-                    kind: graphql26.Kind.NAME,
+                    kind: graphql25.Kind.NAME,
                     value: "__typename"
                   }
                 }
@@ -64409,9 +64216,9 @@ async function addTypename(config, documents) {
             selections: [
               ...node.selectionSet.selections,
               {
-                kind: graphql26.Kind.FIELD,
+                kind: graphql25.Kind.FIELD,
                 name: {
-                  kind: graphql26.Kind.NAME,
+                  kind: graphql25.Kind.NAME,
                   value: "__typename"
                 }
               }
@@ -64424,10 +64231,10 @@ async function addTypename(config, documents) {
 }
 
 // src/codegen/transforms/addID.ts
-import * as graphql27 from "graphql";
+import * as graphql26 from "graphql";
 async function addID(config, documents) {
   for (const doc of documents) {
-    doc.document = graphql27.visit(doc.document, {
+    doc.document = graphql26.visit(doc.document, {
       Field(node, key, parent2, path2, ancestors) {
         if (!node.selectionSet) {
           return;
@@ -64465,7 +64272,7 @@ function addKeysToSelection(config, node, fieldType) {
   if (!node.selectionSet || node.selectionSet.selections.length == 0) {
     return;
   }
-  if (!graphql27.isObjectType(fieldType) && !graphql27.isInterfaceType(fieldType)) {
+  if (!graphql26.isObjectType(fieldType) && !graphql26.isInterfaceType(fieldType)) {
     return;
   }
   const keyFields = config.keyFieldsForType(fieldType.name);
@@ -64480,9 +64287,9 @@ function addKeysToSelection(config, node, fieldType) {
       continue;
     }
     selections.push({
-      kind: graphql27.Kind.FIELD,
+      kind: graphql26.Kind.FIELD,
       name: {
-        kind: graphql27.Kind.NAME,
+        kind: graphql26.Kind.NAME,
         value: keyField
       }
     });
@@ -64497,13 +64304,13 @@ function addKeysToSelection(config, node, fieldType) {
 }
 
 // src/codegen/transforms/componentFields.ts
-import * as graphql28 from "graphql";
+import * as graphql27 from "graphql";
 async function componentFields(config, documents) {
   for (const document of documents) {
-    const typeInfo = new graphql28.TypeInfo(config.schema);
-    document.document = graphql28.visit(
+    const typeInfo = new graphql27.TypeInfo(config.schema);
+    document.document = graphql27.visit(
       document.document,
-      graphql28.visitWithTypeInfo(typeInfo, {
+      graphql27.visitWithTypeInfo(typeInfo, {
         Field(node) {
           const parentType = typeInfo.getParentType();
           if (!parentType) {
@@ -64552,10 +64359,10 @@ async function componentFields(config, documents) {
 }
 
 // src/codegen/transforms/runtimeScalars.ts
-import * as graphql29 from "graphql";
+import * as graphql28 from "graphql";
 async function addTypename2(config, documents) {
   for (const doc of documents) {
-    doc.document = graphql29.visit(doc.document, {
+    doc.document = graphql28.visit(doc.document, {
       VariableDefinition(node) {
         const { type, wrappers } = unwrapType(config, node.type);
         const runtimeScalar = config.configFile.features?.runtimeScalars?.[type.name];
@@ -64594,7 +64401,7 @@ async function addTypename2(config, documents) {
 }
 
 // src/codegen/validators/typeCheck.ts
-import * as graphql30 from "graphql";
+import * as graphql29 from "graphql";
 async function typeCheck(config, docs) {
   const errors = [];
   const freeLists = [];
@@ -64602,7 +64409,7 @@ async function typeCheck(config, docs) {
   const listTypes = [];
   const fragments = {};
   for (const { document: parsed, originalString, filename } of docs) {
-    graphql30.visit(parsed, {
+    graphql29.visit(parsed, {
       FragmentDefinition(definition) {
         fragments[definition.name.value] = definition;
       },
@@ -64647,14 +64454,14 @@ async function typeCheck(config, docs) {
             );
             return;
           }
-          if (graphql30.isListType(rootType) || graphql30.isNonNullType(rootType) && graphql30.isListType(rootType.ofType)) {
+          if (graphql29.isListType(rootType) || graphql29.isNonNullType(rootType) && graphql29.isListType(rootType.ofType)) {
             needsParent = true;
             break;
           }
-          if (graphql30.isNonNullType(rootType) && "ofType" in rootType) {
+          if (graphql29.isNonNullType(rootType) && "ofType" in rootType) {
             rootType = rootType.ofType;
           }
-          if (graphql30.isScalarType(rootType)) {
+          if (graphql29.isScalarType(rootType)) {
             break;
           }
           rootType = rootType?.getFields()[parent3.name.value]?.type;
@@ -64730,9 +64537,9 @@ async function typeCheck(config, docs) {
           );
         }
         let targetTypes = [type];
-        if (graphql30.isUnionType(type)) {
+        if (graphql29.isUnionType(type)) {
           targetTypes = config.schema.getPossibleTypes(type);
-        } else if (graphql30.isInterfaceType(type)) {
+        } else if (graphql29.isInterfaceType(type)) {
           try {
             for (const key of config.keyFieldsForType(type.name)) {
               if (!type.getFields()[key]) {
@@ -64768,13 +64575,13 @@ async function typeCheck(config, docs) {
   if (errors.length > 0) {
     throw errors;
   }
-  const rules = (filepath) => [...graphql30.specifiedRules].filter(
+  const rules = (filepath) => [...graphql29.specifiedRules].filter(
     (rule) => ![
-      graphql30.NoUnusedFragmentsRule,
-      graphql30.KnownFragmentNamesRule,
-      graphql30.ExecutableDefinitionsRule,
-      graphql30.KnownDirectivesRule,
-      graphql30.KnownArgumentNamesRule
+      graphql29.NoUnusedFragmentsRule,
+      graphql29.KnownFragmentNamesRule,
+      graphql29.ExecutableDefinitionsRule,
+      graphql29.KnownDirectivesRule,
+      graphql29.KnownArgumentNamesRule
     ].includes(rule)
   ).concat(
     validateLists({
@@ -64795,7 +64602,7 @@ async function typeCheck(config, docs) {
     validateLoadingDirective(config)
   );
   for (const { filename, document: parsed, originalString } of docs) {
-    for (const error of graphql30.validate(config.schema, parsed, rules(filename))) {
+    for (const error of graphql29.validate(config.schema, parsed, rules(filename))) {
       errors.push(
         new HoudiniError({
           filepath: filename,
@@ -64824,20 +64631,20 @@ function validateRequiredDirective(config, filepath) {
         if (!node.directives?.some(({ name }) => name.value === config.requiredDirective))
           return;
         const parentType = parentTypeFromAncestors(config.schema, filepath, ancestors);
-        if (!graphql30.isObjectType(parentType)) {
+        if (!graphql29.isObjectType(parentType)) {
           ctx.reportError(
-            new graphql30.GraphQLError(
+            new graphql29.GraphQLError(
               `@${config.requiredDirective} may only be used on objects, not arguments`
             )
           );
           return;
         }
         const type = parentType.getFields()[node.name.value].type;
-        const isServerNullable = !graphql30.isNonNullType(type);
+        const isServerNullable = !graphql29.isNonNullType(type);
         const isAlreadyClientNullable = isClientNullable(node, true);
         if (!isServerNullable && !isAlreadyClientNullable) {
           ctx.reportError(
-            new graphql30.GraphQLError(
+            new graphql29.GraphQLError(
               `@${config.requiredDirective} may only be used on nullable fields`
             )
           );
@@ -64859,7 +64666,7 @@ var validateLists = ({
       if (!config.isListFragment(node.name.value)) {
         if (!fragments[node.name.value]) {
           ctx.reportError(
-            new graphql30.GraphQLError(
+            new graphql29.GraphQLError(
               "Encountered unknown fragment: " + node.name.value
             )
           );
@@ -64869,7 +64676,7 @@ var validateLists = ({
       const listName = config.listNameFromFragment(node.name.value);
       if (!lists.includes(listName)) {
         ctx.reportError(
-          new graphql30.GraphQLError(
+          new graphql29.GraphQLError(
             "Encountered fragment referencing unknown list: " + listName
           )
         );
@@ -64894,7 +64701,7 @@ var validateLists = ({
         );
         if (parentArg) {
           ctx.reportError(
-            new graphql30.GraphQLError(
+            new graphql29.GraphQLError(
               `@${config.deprecatedlistDirectiveParentIDArg} should be defined only in it's own directive now`
             )
           );
@@ -64910,7 +64717,7 @@ var validateLists = ({
         return;
       }
       ctx.reportError(
-        new graphql30.GraphQLError(
+        new graphql29.GraphQLError(
           `For this list fragment, you need to add or @${config.listParentDirective} or @${config.listAllListsDirective} directive to specify the behavior`
         )
       );
@@ -64920,7 +64727,7 @@ var validateLists = ({
       const directiveName = node.name.value;
       if (directiveName === "connection") {
         ctx.reportError(
-          new graphql30.GraphQLError(
+          new graphql29.GraphQLError(
             "@connection was renamed to @list. Please change your components. If you were using `cache.connection` in your components, you will need to update that to `cache.list` too."
           )
         );
@@ -64929,7 +64736,7 @@ var validateLists = ({
       if (!config.isInternalDirective(node.name.value)) {
         if (!config.schema.getDirective(directiveName)) {
           ctx.reportError(
-            new graphql30.GraphQLError(
+            new graphql29.GraphQLError(
               "Encountered unknown directive: " + directiveName
             )
           );
@@ -64938,7 +64745,7 @@ var validateLists = ({
       }
       if (config.isListOperationDirective(directiveName) && !listTypes.includes(config.listNameFromDirective(directiveName))) {
         ctx.reportError(
-          new graphql30.GraphQLError(
+          new graphql29.GraphQLError(
             "Encountered directive referencing unknown list: " + directiveName
           )
         );
@@ -64949,7 +64756,7 @@ var validateLists = ({
 };
 function knownArguments(config) {
   return function(ctx) {
-    const nativeValidator = graphql30.KnownArgumentNamesRule(ctx);
+    const nativeValidator = graphql29.KnownArgumentNamesRule(ctx);
     return {
       ...nativeValidator,
       Directive(directiveNode) {
@@ -64984,7 +64791,7 @@ function validateFragmentArguments(config, filepath, fragments) {
         for (const arg of node.arguments || []) {
           if (arg.value.kind !== "ObjectValue") {
             ctx.reportError(
-              new graphql30.GraphQLError("values in @arguments must be an object")
+              new graphql29.GraphQLError("values in @arguments must be an object")
             );
             return;
           }
@@ -64994,13 +64801,13 @@ function validateFragmentArguments(config, filepath, fragments) {
           );
           if (!typeArg) {
             ctx.reportError(
-              new graphql30.GraphQLError("missing type field for @arguments directive")
+              new graphql29.GraphQLError("missing type field for @arguments directive")
             );
             return;
           }
-          if (typeArg.value.kind !== graphql30.Kind.STRING) {
+          if (typeArg.value.kind !== graphql29.Kind.STRING) {
             ctx.reportError(
-              new graphql30.GraphQLError("type field to @arguments must be a string")
+              new graphql29.GraphQLError("type field to @arguments must be a string")
             );
             return;
           }
@@ -65013,7 +64820,7 @@ function validateFragmentArguments(config, filepath, fragments) {
           );
           if (typeArg.value.value !== defaultValueType) {
             ctx.reportError(
-              new graphql30.GraphQLError(
+              new graphql29.GraphQLError(
                 `Invalid default value provided for ${arg.name.value}. Expected ${typeArg.value.value}, found ${defaultValueType}`
               )
             );
@@ -65031,7 +64838,7 @@ function validateFragmentArguments(config, filepath, fragments) {
           try {
             args = fragmentArguments(config, filepath, fragments[fragmentName]);
           } catch (e) {
-            ctx.reportError(new graphql30.GraphQLError(e.message));
+            ctx.reportError(new graphql29.GraphQLError(e.message));
             return;
           }
           fragmentArguments2[fragmentName] = args;
@@ -65054,7 +64861,7 @@ function validateFragmentArguments(config, filepath, fragments) {
         );
         if (missing.length > 0) {
           ctx.reportError(
-            new graphql30.GraphQLError(
+            new graphql29.GraphQLError(
               `The following arguments are missing from the "${fragmentName}" fragment: ` + JSON.stringify(missing)
             )
           );
@@ -65065,7 +64872,7 @@ function validateFragmentArguments(config, filepath, fragments) {
         );
         if (unknown.length > 0) {
           ctx.reportError(
-            new graphql30.GraphQLError(
+            new graphql29.GraphQLError(
               "Encountered unknown arguments: " + JSON.stringify(unknown)
             )
           );
@@ -65077,7 +64884,7 @@ function validateFragmentArguments(config, filepath, fragments) {
           for (const [applied, target] of zipped) {
             if (!valueIsType(config, applied.value, target)) {
               ctx.reportError(
-                new graphql30.GraphQLError(
+                new graphql29.GraphQLError(
                   `Invalid argument type. Expected ${target}, found ${applied.value.kind}`
                 )
               );
@@ -65119,7 +64926,7 @@ function valueIsType(config, value, targetType) {
   }
   if (value.kind === "EnumValue" && targetType.kind === "NamedType") {
     const enumType = config.schema.getType(targetType.name.value);
-    if (!graphql30.isEnumType(enumType)) {
+    if (!graphql29.isEnumType(enumType)) {
       return false;
     }
     return enumType.getValues().some((enumValue) => enumValue.value === value.value);
@@ -65139,7 +64946,7 @@ function paginateArgs(config, filepath) {
         }
         if (alreadyPaginated) {
           ctx.reportError(
-            new graphql30.GraphQLError(
+            new graphql29.GraphQLError(
               `@${config.paginateDirective} can only appear in a document once.`
             )
           );
@@ -65171,7 +64978,7 @@ function paginateArgs(config, filepath) {
           const backwards = appliedArgs.has("last");
           if (!forward && !backwards) {
             ctx.reportError(
-              new graphql30.GraphQLError(
+              new graphql29.GraphQLError(
                 "A field with cursor-based pagination must have a first or last argument"
               )
             );
@@ -65185,7 +64992,7 @@ function paginateArgs(config, filepath) {
           }
           if (forward && backwards && paginateMode === "Infinite") {
             ctx.reportError(
-              new graphql30.GraphQLError(
+              new graphql29.GraphQLError(
                 `A field with cursor pagination cannot go forwards an backwards simultaneously`
               )
             );
@@ -65199,7 +65006,7 @@ function paginateArgs(config, filepath) {
           );
           if (!appliedLimitArg) {
             ctx.reportError(
-              new graphql30.GraphQLError(
+              new graphql29.GraphQLError(
                 "A field with offset-based pagination must have a limit argument"
               )
             );
@@ -65215,20 +65022,20 @@ function noUnusedFragmentArguments(config) {
     const args = /* @__PURE__ */ new Set();
     return {
       enter(node) {
-        if (node.kind === graphql30.Kind.FRAGMENT_DEFINITION) {
+        if (node.kind === graphql29.Kind.FRAGMENT_DEFINITION) {
           const definitionArguments = node.directives?.filter((directive) => directive.name.value === config.argumentsDirective).flatMap((directive) => directive.arguments);
           for (const arg of definitionArguments?.map((arg2) => arg2?.name.value) || []) {
             args.add(arg);
           }
-        } else if (node.kind === graphql30.Kind.VARIABLE) {
+        } else if (node.kind === graphql29.Kind.VARIABLE) {
           args.delete(node.name.value);
         }
       },
       leave(node) {
-        if (node.kind === graphql30.Kind.FRAGMENT_DEFINITION) {
+        if (node.kind === graphql29.Kind.FRAGMENT_DEFINITION) {
           if (args.size > 0) {
             ctx.reportError(
-              new graphql30.GraphQLError(
+              new graphql29.GraphQLError(
                 "Encountered unused fragment arguments: " + [...args].join(",")
               )
             );
@@ -65264,7 +65071,7 @@ function nodeDirectives(config, directives) {
         if (definition.kind === "OperationDefinition") {
           if (definition.operation !== "query") {
             ctx.reportError(
-              new graphql30.GraphQLError(
+              new graphql29.GraphQLError(
                 `@${node.name.value} must fall on a fragment or query document`
               )
             );
@@ -65276,7 +65083,7 @@ function nodeDirectives(config, directives) {
         }
         if (!possibleNodes.includes(definitionType)) {
           ctx.reportError(
-            new graphql30.GraphQLError(paginateOnNonNodeMessage(node.name.value))
+            new graphql29.GraphQLError(paginateOnNonNodeMessage(node.name.value))
           );
         }
       }
@@ -65295,7 +65102,7 @@ function checkMutationOperation(config) {
         );
         if (append && prepend) {
           ctx.reportError(
-            new graphql30.GraphQLError(
+            new graphql29.GraphQLError(
               `You can't apply both @${config.listPrependDirective} and @${config.listAppendDirective} at the same time`
             )
           );
@@ -65309,7 +65116,7 @@ function checkMutationOperation(config) {
         );
         if (parentId && allLists) {
           ctx.reportError(
-            new graphql30.GraphQLError(
+            new graphql29.GraphQLError(
               `You can't apply both @${config.listParentDirective} and @${config.listAllListsDirective} at the same time`
             )
           );
@@ -65331,7 +65138,7 @@ function checkMaskDirectives(config) {
         );
         if (maskEnableDirective && maskDisableDirective) {
           ctx.reportError(
-            new graphql30.GraphQLError(
+            new graphql29.GraphQLError(
               `You can't apply both @${config.maskEnableDirective} and @${config.maskDisableDirective} at the same time`
             )
           );
@@ -65373,7 +65180,7 @@ function validateLoadingDirective(config) {
         );
         if (!parentLoading && !global2) {
           ctx.reportError(
-            new graphql30.GraphQLError(
+            new graphql29.GraphQLError(
               `@${config.loadingDirective} can only be applied on a field or fragment spread at the root of a document or on one whose parent also has @${config.loadingDirective}`
             )
           );
@@ -65395,7 +65202,7 @@ function validateLoadingDirective(config) {
         );
         if (!parentLoading && !global2) {
           ctx.reportError(
-            new graphql30.GraphQLError(
+            new graphql29.GraphQLError(
               `@${config.loadingDirective} can only be applied on a field or fragment spread at the root of a document or on one whose parent also has @${config.loadingDirective}`
             )
           );
@@ -65410,7 +65217,7 @@ function getAndVerifyNodeInterface(config) {
   if (!nodeInterface) {
     return null;
   }
-  if (!graphql30.isInterfaceType(nodeInterface)) {
+  if (!graphql29.isInterfaceType(nodeInterface)) {
     displayInvalidNodeFieldMessage(config);
     return null;
   }
@@ -65505,11 +65312,11 @@ async function uniqueDocumentNames(config, docs) {
 }
 
 // src/codegen/validators/noIDAlias.ts
-import * as graphql31 from "graphql";
+import * as graphql30 from "graphql";
 async function noIDAlias(config, docs) {
   const errors = [];
   for (const { filename, document } of docs) {
-    graphql31.visit(document, {
+    graphql30.visit(document, {
       Field(node, _, __, ___, ancestors) {
         const fieldType = parentTypeFromAncestors(config.schema, filename, ancestors).name;
         if (config.keyFieldsForType(fieldType).includes(node.alias?.value || "")) {
@@ -65548,11 +65355,11 @@ async function validatePlugins(config, documents) {
 }
 
 // src/codegen/validators/componentFields.ts
-import * as graphql32 from "graphql";
+import * as graphql31 from "graphql";
 async function componentFields2(config, docs) {
   const errors = [];
   for (const { filename: filepath, document } of docs) {
-    graphql32.visit(document, {
+    graphql31.visit(document, {
       FragmentDefinition(node, _, __, ___, ancestors) {
         const componentFieldDirective = node.directives?.find(
           (dir) => dir.name.value === config.componentFieldDirective
@@ -65600,7 +65407,7 @@ async function componentFields2(config, docs) {
         if (existingField && existingField.filepath !== filepath) {
           conflict = true;
         } else if (parentType && fieldValue) {
-          const fieldDef = graphql32.isObjectType(parentType) && parentType.getFields()[fieldValue];
+          const fieldDef = graphql31.isObjectType(parentType) && parentType.getFields()[fieldValue];
           if (fieldDef && !fieldDef.astNode?.directives?.find(
             (dir) => dir.name.value === config.componentFieldDirective
           )) {
@@ -65613,7 +65420,7 @@ async function componentFields2(config, docs) {
             filepath
           });
         }
-        if (parentType && graphql32.isAbstractType(parentType)) {
+        if (parentType && graphql31.isAbstractType(parentType)) {
           errors.push({
             message: `Cannot add component field ${parent2}.${fieldValue} because ${parent2} is an abstract type`,
             filepath
@@ -65809,7 +65616,7 @@ function testConfigFile({ plugins, ...config } = {}) {
 				id: ID!
 				name(arg: Int): String!
 				birthday: DateTime!
-				firstName: String!
+				firstName: String! @deprecated(reason: "Use name instead")
 				friends: [User!]!
 				friendsByCursor(first: Int, after: String, last: Int, before: String, filter: String): UserConnection!
 				friendsByCursorSnapshot(snapshot: String!, first: Int, after: String, last: Int, before: String): UserConnection!
@@ -65839,13 +65646,22 @@ function testConfigFile({ plugins, ...config } = {}) {
 				believers(first: Int, after: String): GhostConnection
 			}
 
+			"""
+			Cat's documentation
+			"""
 			type Cat implements Friend & Node {
 				id: ID!
+				"""
+				The name of the cat
+				"""
 				name: String!
 				owner: User!
 			}
 
 			type Query {
+				"""
+				Get a user.
+				"""
 				user: User!
 				entity: Entity!
 				version: Int!
@@ -66027,11 +65843,19 @@ function testConfigFile({ plugins, ...config } = {}) {
 				id: ID!
 			}
 
+			"""
+			Documentation of testenum1
+			"""
 			enum TestEnum1 {
+				"Documentation of Value1"
 				Value1
+				"Documentation of Value2"
 				Value2
 			}
 
+			"""
+			Documentation of testenum2
+			"""
 			enum TestEnum2 {
 				Value3
 				Value2
@@ -66116,7 +65940,7 @@ function pipelineTest(config, documents, shouldPass, testBody) {
   };
 }
 function mockCollectedDoc(query2, data) {
-  const parsed = graphql34.parse(query2);
+  const parsed = graphql33.parse(query2);
   const name = parsed.definitions[0].name.value;
   const operations = parsed.definitions;
   let kind = ArtifactKind.Fragment;