docs: add sandbox and ensv2readiness

apps/ensapi/src/omnigraph-api/schema/example-queries.integration.test.ts

@@ -2,19 +2,20 @@ import { type OperationDefinitionNode, parse } from "graphql";
 import { describe, expect, it } from "vitest";
 
 import { ENSNamespaceIds } from "@ensnode/datasources";
+import { getNamespaceSpecificValue } from "@ensnode/ensnode-sdk";
 import { GRAPHQL_API_EXAMPLE_QUERIES } from "@ensnode/ensnode-sdk/internal";
 
 import { request } from "@/test/integration/graphql-utils";
 
 const namespace = ENSNamespaceIds.EnsTestEnv;
 
-const EXAMPLE_QUERY_TEST_CASES = GRAPHQL_API_EXAMPLE_QUERIES.map((entry, i) => {
+const EXAMPLE_QUERY_TEST_CASES = GRAPHQL_API_EXAMPLE_QUERIES.map((entry) => {
   const document = parse(entry.query);
   const operation = document.definitions.find(
     (d): d is OperationDefinitionNode => d.kind === "OperationDefinition",
   );
-  const name = operation?.name?.value ?? `Query #${i}`;
-  const variables = entry.variables[namespace] ?? entry.variables.default;
+  const name = operation?.name?.value ?? entry.id;
+  const variables = getNamespaceSpecificValue(namespace, entry.variables);
   return { name, query: entry.query, variables };
 });
 

apps/ensapi/src/omnigraph-api/schema/example-queries.test.ts

@@ -5,8 +5,8 @@ import { GRAPHQL_API_EXAMPLE_QUERIES } from "@ensnode/ensnode-sdk/internal";
 
 describe("Example Queries", () => {
   it.each(
-    GRAPHQL_API_EXAMPLE_QUERIES.map((entry, i) => ({
-      name: `Query #${i}`,
+    GRAPHQL_API_EXAMPLE_QUERIES.map((entry) => ({
+      name: entry.id,
       query: entry.query,
     })),
   )("$name parses as valid GraphQL", ({ query }) => {

docs/ensnode.io/config/integrations/llms-txt.ts

@@ -0,0 +1,16 @@
+import starlightLlmsTxt from "starlight-llms-txt";
+
+/**
+ * `starlight-llms-txt` renders each docs entry for `/llms-full.txt` and `/llms-small.txt` through
+ * an Astro container that only registers the MDX SSR renderer, not React. MDX pages that import
+ * `.tsx` islands must be omitted from those exports or `astro build` fails with `NoMatchingRenderer`.
+ *
+ * Patterns use micromatch against each entry's `id` in the Starlight `docs` collection (paths are
+ * relative to `src/content/docs/`). Interactive Cookbook recipe pages live under
+ * `docs/integrate/integration-options/enssdk/cookbook/*`; the enssdk Cookbook hub (`.../enssdk/cookbook` index) stays static and
+ * remains included in LLM exports. Recipe slugs use one path segment (`.../cookbook/<slug>`); add
+ * another pattern here if nested recipe routes are introduced.
+ */
+export const starlightLlmsTxtPlugin = starlightLlmsTxt({
+  exclude: ["docs/integrate/integration-options/enssdk/cookbook/*"],
+});

docs/ensnode.io/config/integrations/starlight/index.ts

@@ -1,8 +1,8 @@
 import AstroStarlight from "@astrojs/starlight";
 import type { AstroIntegration } from "astro";
-import starlightLlmsTxt from "starlight-llms-txt";
 import starlightSidebarTopics from "starlight-sidebar-topics";
 
+import { starlightLlmsTxtPlugin } from "../llms-txt";
 import { starlightSidebarTopicsConfig } from "./sidebar-topics";
 
 export function starlight(): AstroIntegration {
@@ -29,7 +29,7 @@ export function starlight(): AstroIntegration {
       "@fontsource/inter/800.css",
       "@fontsource/inter/900.css",
     ],
-    plugins: [starlightLlmsTxt(), starlightSidebarTopics(starlightSidebarTopicsConfig)],
+    plugins: [starlightLlmsTxtPlugin, starlightSidebarTopics(starlightSidebarTopicsConfig)],
     title: "ENSNode",
     disable404Route: true,
     logo: {

docs/ensnode.io/config/integrations/starlight/sidebar-topics/integrate.ts

@@ -29,7 +29,21 @@ export const integrateSidebarTopic = {
         },
         {
           label: "Cookbook",
-          link: "/docs/integrate/omnigraph/cookbook",
+          collapsed: true,
+          items: [
+            {
+              label: "Overview",
+              link: "/docs/integrate/omnigraph/cookbook",
+            },
+            {
+              label: "Domain By Name",
+              link: "/docs/integrate/omnigraph/cookbook/domain-by-name",
+            },
+            {
+              label: "Account Domains",
+              link: "/docs/integrate/omnigraph/cookbook/account-domains",
+            },
+          ],
         },
         {
           label: "Schema Reference",
@@ -51,7 +65,27 @@ export const integrateSidebarTopic = {
         },
         {
           label: "enssdk (TypeScript)",
-          link: "/docs/integrate/integration-options/enssdk",
+          collapsed: false,
+          items: [
+            {
+              label: "Overview",
+              link: "/docs/integrate/integration-options/enssdk",
+            },
+            {
+              label: "Cookbook",
+              collapsed: true,
+              items: [
+                {
+                  label: "Overview",
+                  link: "/docs/integrate/integration-options/enssdk/cookbook",
+                },
+                {
+                  label: "Resolution API",
+                  link: "/docs/integrate/integration-options/enssdk/cookbook/resolution-api",
+                },
+              ],
+            },
+          ],
         },
         {
           label: "Raw GraphQL",

docs/ensnode.io/package.json

@@ -27,7 +27,9 @@
     "@iconify-json/lucide": "^1.2.52",
     "@namehash/namehash-ui": "workspace:*",
     "@octokit/rest": "^20.1.2",
+    "@ensnode/ensnode-sdk": "workspace:*",
     "@scalar/astro": "^0.2.4",
+    "@stackblitz/sdk": "^1.11.0",
     "@tailwindcss/vite": "^4.1.15",
     "astro": "catalog:",
     "astro-font": "catalog:",

docs/ensnode.io/src/components/docs/EnssdkExamplePanels.astro

@@ -0,0 +1,21 @@
+---
+import { Code } from "@astrojs/starlight/components";
+
+interface Props {
+  code: string;
+  responseJson: string;
+}
+
+const { code, responseJson } = Astro.props;
+---
+
+<div class="not-prose grid gap-6 lg:grid-cols-2 lg:gap-8">
+  <div class="min-w-0">
+    <p class="mb-2 text-sm font-medium text-gray-900">TypeScript (enssdk)</p>
+    <Code code={code} lang="ts" title="index.ts" />
+  </div>
+  <div class="min-w-0">
+    <p class="mb-2 text-sm font-medium text-gray-900">Example Omnigraph response</p>
+    <Code code={responseJson} lang="json" title="response.json" />
+  </div>
+</div>

docs/ensnode.io/src/components/docs/OmnigraphRecipeExample.astro

@@ -0,0 +1,34 @@
+---
+import OmnigraphRecipePanels from "./OmnigraphRecipePanels.astro";
+
+import { getOmnigraphExampleById } from "../../data/ens-v2-examples-queries";
+import { buildEnsadminOmnigraphUrl } from "../../content/snippets/omnigraphAdmin";
+import { stringifyJsonForDocs } from "../../data/ens-v2-examples-queries/common";
+
+interface Props {
+  exampleId: string;
+  /** Hide curl tab (e.g. if connection is admin-only). */
+  showCurl?: boolean;
+}
+
+const { exampleId, showCurl = true } = Astro.props;
+const example = getOmnigraphExampleById(exampleId);
+const adminUrl = buildEnsadminOmnigraphUrl({
+  query: example.query,
+  connection: example.connection,
+  variables: example.variables,
+});
+const variablesJson = stringifyJsonForDocs(example.variables);
+const responseJson = example.response ? stringifyJsonForDocs(example.response) : null;
+---
+
+<OmnigraphRecipePanels
+  panelId={exampleId}
+  query={example.query}
+  variablesJson={variablesJson}
+  variablesObject={example.variables}
+  responseJson={responseJson}
+  connectionBaseUrl={example.connection}
+  adminUrl={adminUrl}
+  showCurl={showCurl}
+/>