refactor: update GraphQL page titles

refactor: update GraphQL reference

Author: PaulRBerg

.vscode/settings.json

@@ -10,7 +10,8 @@
     ".docusaurus": true,
     "build": true,
     "node_modules": true,
-    "repos": true
+    "repos": true,
+    "docs/api/**/graphql": true
   },
   "[css][javascript][javascriptreact][typescript][typescriptreact]": {
     "editor.defaultFormatter": "biomejs.biome"

cli/commands/autogen/graphql.ts

@@ -86,8 +86,8 @@ const COLLAPSED = {
 
 const THE_GRAPH_CATEGORY: Category = { ...COLLAPSED, label: "The Graph", position: 2 };
 const ENVIO_CATEGORY: Category = { ...COLLAPSED, label: "Envio", position: 3 };
-const QUERIES_CATEGORY: Category = { ...COLLAPSED, label: "Queries", position: 2 }; // first is the overview
-const OBJECTS_CATEGORY: Category = { ...COLLAPSED, label: "Objects", position: 3 };
+const OBJECTS_CATEGORY: Category = { ...COLLAPSED, label: "Objects", position: 2 };
+const QUERIES_CATEGORY: Category = { ...COLLAPSED, label: "Query Syntax", position: 3 }; // first is the overview
 const ENUMS_CATEGORY: Category = { ...COLLAPSED, className: "hidden", label: "Enums", position: 4 };
 const INPUTS_CATEGORY: Category = { ...COLLAPSED, className: "hidden", label: "Inputs", position: 5 };
 const SCALARS_CATEGORY: Category = { ...COLLAPSED, className: "hidden", label: "Scalars", position: 6 };
@@ -98,17 +98,17 @@ function cleanupDocs(docsPaths: string[]): void {
     fs.rmSync(join(docsPath, "subscriptions"), { force: true, recursive: true });
 
     // Delete all _category_.yml files
-    fs.unlinkSync(join(docsPath, "queries", "_category_.yml"));
     fs.unlinkSync(join(docsPath, "enums", "_category_.yml"));
     fs.unlinkSync(join(docsPath, "inputs", "_category_.yml"));
     fs.unlinkSync(join(docsPath, "objects", "_category_.yml"));
+    fs.unlinkSync(join(docsPath, "queries", "_category_.yml"));
     fs.unlinkSync(join(docsPath, "scalars", "_category_.yml"));
 
     // Rewrite _category_.yml files
-    fs.writeFileSync(join(docsPath, "queries", "_category_.yml"), yaml.dump(QUERIES_CATEGORY));
-    fs.writeFileSync(join(docsPath, "objects", "_category_.yml"), yaml.dump(OBJECTS_CATEGORY));
     fs.writeFileSync(join(docsPath, "enums", "_category_.yml"), yaml.dump(ENUMS_CATEGORY));
     fs.writeFileSync(join(docsPath, "inputs", "_category_.yml"), yaml.dump(INPUTS_CATEGORY));
+    fs.writeFileSync(join(docsPath, "objects", "_category_.yml"), yaml.dump(OBJECTS_CATEGORY));
+    fs.writeFileSync(join(docsPath, "queries", "_category_.yml"), yaml.dump(QUERIES_CATEGORY));
     fs.writeFileSync(join(docsPath, "scalars", "_category_.yml"), yaml.dump(SCALARS_CATEGORY));
 
     // Write vendor category file at base path
@@ -131,7 +131,7 @@ async function generateEnvio(protocol: Indexer.Protocol): Promise<string> {
 
 async function generateGraph(protocol: Indexer.Protocol): Promise<string> {
   const docsPath = `./docs/api/${protocol}/graphql/the-graph`;
-  const schemaURL = getIndexerGraph({ chainId: CHAIN_ID_SEPOLIA, protocol }).endpoint.url;
+  const schemaURL = getIndexerGraph({ chainId: CHAIN_ID_SEPOLIA, protocol }).testingURL;
 
   await runGenerator(docsPath, schemaURL);
   console.log(`✔️  Generated GraphQL docs for The Graph vendor and ${_.capitalize(protocol)} protocol\n`);

docs/api/airdrops/graphql/envio/enums/action-select-column.mdx

@@ -22,7 +22,7 @@ export const SpecifiedBy = (props) => (
     <a
       className="link"
       style={{ fontSize: "1.5em", paddingLeft: "4px" }}
-      target="\_blank"
+      target="_blank"
       href={props.url}
       title={"Specified by " + props.url}
     >

docs/api/airdrops/graphql/envio/enums/activity-select-column.mdx

@@ -22,7 +22,7 @@ export const SpecifiedBy = (props) => (
     <a
       className="link"
       style={{ fontSize: "1.5em", paddingLeft: "4px" }}
-      target="\_blank"
+      target="_blank"
       href={props.url}
       title={"Specified by " + props.url}
     >

docs/api/airdrops/graphql/envio/enums/asset-select-column.mdx

@@ -22,7 +22,7 @@ export const SpecifiedBy = (props) => (
     <a
       className="link"
       style={{ fontSize: "1.5em", paddingLeft: "4px" }}
-      target="\_blank"
+      target="_blank"
       href={props.url}
       title={"Specified by " + props.url}
     >

docs/api/airdrops/graphql/envio/enums/campaign-select-column-campaign-aggregate-bool-exp-bool-and-arguments-columns.mdx

@@ -0,0 +1,101 @@
+---
+id: campaign-select-column-campaign-aggregate-bool-exp-bool-and-arguments-columns
+title: Campaign_select_column_Campaign_aggregate_bool_exp_bool_and_arguments_columns
+---
+
+<head>
+  <meta content="noindex" name="robots" />
+  <meta charset="utf-8" />
+</head>
+
+export const Bullet = () => (
+  <>
+    <span style={{ fontWeight: "normal", fontSize: ".5em", color: "var(--ifm-color-secondary-darkest)" }}>
+      &nbsp;●&nbsp;
+    </span>
+  </>
+);
+
+export const SpecifiedBy = (props) => (
+  <>
+    Specification
+    <a
+      className="link"
+      style={{ fontSize: "1.5em", paddingLeft: "4px" }}
+      target="_blank"
+      href={props.url}
+      title={"Specified by " + props.url}
+    >
+      ⎘
+    </a>
+  </>
+);
+
+export const Badge = (props) => (
+  <>
+    <span className={props.class}>{props.text}</span>
+  </>
+);
+
+import { useState } from "react";
+
+export const Details = ({ dataOpen, dataClose, children, startOpen = false }) => {
+  const [open, setOpen] = useState(startOpen);
+  return (
+    <details
+      {...(open ? { open: true } : {})}
+      className="details"
+      style={{ border: "none", boxShadow: "none", background: "var(--ifm-background-color)" }}
+    >
+      <summary
+        onClick={(e) => {
+          e.preventDefault();
+          setOpen((open) => !open);
+        }}
+        style={{ listStyle: "none" }}
+      >
+        {open ? dataOpen : dataClose}
+      </summary>
+      {open && children}
+    </details>
+  );
+};
+
+select "Campaign_aggregate_bool_exp_bool_and_arguments_columns" columns of table "Campaign"
+
+```graphql
+enum Campaign_select_column_Campaign_aggregate_bool_exp_bool_and_arguments_columns {
+  expires
+  streamCancelable
+  streamCliff
+  streamInitial
+  streamStart
+  streamTransferable
+}
+```
+
+### Values
+
+#### [<code style={{ fontWeight: 'normal' }}>Campaign_select_column_Campaign_aggregate_bool_exp_bool_and_arguments_columns.<b>expires</b></code>](#)
+
+column name
+
+#### [<code style={{ fontWeight: 'normal' }}>Campaign_select_column_Campaign_aggregate_bool_exp_bool_and_arguments_columns.<b>streamCancelable</b></code>](#)
+
+column name
+
+#### [<code style={{ fontWeight: 'normal' }}>Campaign_select_column_Campaign_aggregate_bool_exp_bool_and_arguments_columns.<b>streamCliff</b></code>](#)
+
+column name
+
+#### [<code style={{ fontWeight: 'normal' }}>Campaign_select_column_Campaign_aggregate_bool_exp_bool_and_arguments_columns.<b>streamInitial</b></code>](#)
+
+column name
+
+#### [<code style={{ fontWeight: 'normal' }}>Campaign_select_column_Campaign_aggregate_bool_exp_bool_and_arguments_columns.<b>streamStart</b></code>](#)
+
+column name
+
+#### [<code style={{ fontWeight: 'normal' }}>Campaign_select_column_Campaign_aggregate_bool_exp_bool_and_arguments_columns.<b>streamTransferable</b></code>](#)
+
+column name

docs/api/airdrops/graphql/envio/enums/campaign-select-column-campaign-aggregate-bool-exp-bool-or-arguments-columns.mdx

@@ -0,0 +1,101 @@
+---
+id: campaign-select-column-campaign-aggregate-bool-exp-bool-or-arguments-columns
+title: Campaign_select_column_Campaign_aggregate_bool_exp_bool_or_arguments_columns
+---
+
+<head>
+  <meta content="noindex" name="robots" />
+  <meta charset="utf-8" />
+</head>
+
+export const Bullet = () => (
+  <>
+    <span style={{ fontWeight: "normal", fontSize: ".5em", color: "var(--ifm-color-secondary-darkest)" }}>
+      &nbsp;●&nbsp;
+    </span>
+  </>
+);
+
+export const SpecifiedBy = (props) => (
+  <>
+    Specification
+    <a
+      className="link"
+      style={{ fontSize: "1.5em", paddingLeft: "4px" }}
+      target="_blank"
+      href={props.url}
+      title={"Specified by " + props.url}
+    >
+      ⎘
+    </a>
+  </>
+);
+
+export const Badge = (props) => (
+  <>
+    <span className={props.class}>{props.text}</span>
+  </>
+);
+
+import { useState } from "react";
+
+export const Details = ({ dataOpen, dataClose, children, startOpen = false }) => {
+  const [open, setOpen] = useState(startOpen);
+  return (
+    <details
+      {...(open ? { open: true } : {})}
+      className="details"
+      style={{ border: "none", boxShadow: "none", background: "var(--ifm-background-color)" }}
+    >
+      <summary
+        onClick={(e) => {
+          e.preventDefault();
+          setOpen((open) => !open);
+        }}
+        style={{ listStyle: "none" }}
+      >
+        {open ? dataOpen : dataClose}
+      </summary>
+      {open && children}
+    </details>
+  );
+};
+
+select "Campaign_aggregate_bool_exp_bool_or_arguments_columns" columns of table "Campaign"
+
+```graphql
+enum Campaign_select_column_Campaign_aggregate_bool_exp_bool_or_arguments_columns {
+  expires
+  streamCancelable
+  streamCliff
+  streamInitial
+  streamStart
+  streamTransferable
+}
+```
+
+### Values
+
+#### [<code style={{ fontWeight: 'normal' }}>Campaign_select_column_Campaign_aggregate_bool_exp_bool_or_arguments_columns.<b>expires</b></code>](#)
+
+column name
+
+#### [<code style={{ fontWeight: 'normal' }}>Campaign_select_column_Campaign_aggregate_bool_exp_bool_or_arguments_columns.<b>streamCancelable</b></code>](#)
+
+column name
+
+#### [<code style={{ fontWeight: 'normal' }}>Campaign_select_column_Campaign_aggregate_bool_exp_bool_or_arguments_columns.<b>streamCliff</b></code>](#)
+
+column name
+
+#### [<code style={{ fontWeight: 'normal' }}>Campaign_select_column_Campaign_aggregate_bool_exp_bool_or_arguments_columns.<b>streamInitial</b></code>](#)
+
+column name
+
+#### [<code style={{ fontWeight: 'normal' }}>Campaign_select_column_Campaign_aggregate_bool_exp_bool_or_arguments_columns.<b>streamStart</b></code>](#)
+
+column name
+
+#### [<code style={{ fontWeight: 'normal' }}>Campaign_select_column_Campaign_aggregate_bool_exp_bool_or_arguments_columns.<b>streamTransferable</b></code>](#)
+
+column name

docs/api/airdrops/graphql/envio/enums/campaign-select-column.mdx

@@ -22,7 +22,7 @@ export const SpecifiedBy = (props) => (
     <a
       className="link"
       style={{ fontSize: "1.5em", paddingLeft: "4px" }}
-      target="\_blank"
+      target="_blank"
       href={props.url}
       title={"Specified by " + props.url}
     >
@@ -86,6 +86,7 @@ enum Campaign_select_column {
   lockup
   name
   nickname
+  position
   root
   streamCancelable
   streamCliff
@@ -191,6 +192,10 @@ column name
 
 column name
 
+#### [<code style={{ fontWeight: 'normal' }}>Campaign_select_column.<b>position</b></code>](#)
+
+column name
+
 #### [<code style={{ fontWeight: 'normal' }}>Campaign_select_column.<b>root</b></code>](#)
 
 column name

docs/api/airdrops/graphql/envio/enums/chain-metadata-select-column.mdx

@@ -22,7 +22,7 @@ export const SpecifiedBy = (props) => (
     <a
       className="link"
       style={{ fontSize: "1.5em", paddingLeft: "4px" }}
-      target="\_blank"
+      target="_blank"
       href={props.url}
       title={"Specified by " + props.url}
     >

docs/api/airdrops/graphql/envio/enums/cursor-ordering.mdx

@@ -22,7 +22,7 @@ export const SpecifiedBy = (props) => (
     <a
       className="link"
       style={{ fontSize: "1.5em", paddingLeft: "4px" }}
-      target="\_blank"
+      target="_blank"
       href={props.url}
       title={"Specified by " + props.url}
     >