docs: add all references to component

.prettierignore

@@ -0,0 +1 @@
+src/components/SdkReferenceLinkByFramework.mdx

src/components/SdkReferenceLinkByFramework.mdx

@@ -0,0 +1,68 @@
+{/**
+ * @import { FrameworkKey, IntegrationKey } from "@/lib/prefs";
+ */}
+
+import SlotByFramework from "@/components/SlotByFramework";
+import { frameworkToIntegration, frameworks } from "@/lib/prefs";
+import { LinkCard } from "@astrojs/starlight/components";
+
+{/**
+ * List of frameworks that have SDK reference guides for their integrations.
+ *
+ * @type {Array<FrameworkKey>}
+ */}
+export const documented = [
+  "astro",
+  "bun-hono",
+  "bun",
+  "deno",
+  "fastify",
+  "nest-js",
+  "next-js",
+  "node-js-express",
+  "node-js-hono",
+  "node-js",
+  "nuxt",
+  "react-router",
+  "remix",
+  "sveltekit",
+]
+
+{/**
+ * @type {Record<IntegrationKey, string>}
+ */}
+export const pathOverwrites = {
+  "nest-js": "nestjs",
+  "next-js": "nextjs",
+  "node-js": "nodejs"
+}
+
+<SlotByFramework client:load>
+  {
+    frameworks.map(function (framework) {
+      /** @type {IntegrationKey} */
+      const integration = Object.hasOwn(frameworkToIntegration, framework.key) ? frameworkToIntegration[framework.key] : framework.key;
+      const info = frameworks.find(function (d) {
+        return d.key === integration;
+      });
+      if (!info) throw new Error('Cannot find integration `' + integration + '`');
+
+      if (!documented.includes(framework.key)) {
+        console.warn('Missing reference guide for `%s`; if it exists, add it to `documented` in `SdkReferenceLinkByFramework.mdx`', framework.key);
+        return;
+      }
+
+      /** @type {string} */
+      const pathname = Object.hasOwn(pathOverwrites, integration) ? pathOverwrites[integration] : integration;
+
+      return (
+        <LinkCard
+          description={`${info.label} SDK reference guide.`}
+          href={`/reference/${pathname}`}
+          slot={framework.key}
+          title="SDK reference"
+        />
+      )
+    })
+  }
+</SlotByFramework>

src/content/docs/bot-protection/quick-start.mdx

@@ -56,7 +56,7 @@ import FrameworkName from "@/components/FrameworkName";
 import FAQs from "/src/components/FAQs.astro";
 import FrameworkLinks from "@/components/FrameworkLinks";
 import Comments from "/src/components/Comments.astro";
-import SdkReferenceLinkByFramework from "/src/components/SdkReferenceLinkByFramework.astro";
+import SdkReferenceLinkByFramework from "/src/components/SdkReferenceLinkByFramework.mdx";
 
 import AstroStep1 from "@/snippets/shared/astro/InstallWithInspect.mdx";
 import AstroStep2 from "@/snippets/get-started/astro/Step2.mdx";

src/content/docs/email-validation/quick-start.mdx

@@ -41,7 +41,7 @@ ajToc:
 ---
 
 import { LinkCard, CardGrid } from "@astrojs/starlight/components";
-import SdkReferenceLinkByFramework from "/src/components/SdkReferenceLinkByFramework.astro";
+import SdkReferenceLinkByFramework from "/src/components/SdkReferenceLinkByFramework.mdx";
 import WhatIsArcjet from "/src/components/WhatIsArcjet.astro";
 import FrameworkLinks from "@/components/FrameworkLinks";
 import SlotByFramework from "@/components/SlotByFramework";

src/content/docs/filters/quick-start.mdx

@@ -54,7 +54,7 @@ title: "Filters"
 import { CardGrid, LinkCard } from "@astrojs/starlight/components";
 import Comments from "/src/components/Comments.astro";
 import Faqs from "/src/components/FAQs.astro";
-import SdkReferenceLinkByFramework from "/src/components/SdkReferenceLinkByFramework.astro";
+import SdkReferenceLinkByFramework from "/src/components/SdkReferenceLinkByFramework.mdx";
 import WhatIsArcjet from "/src/components/WhatIsArcjet.astro";
 import SlotByFramework from "@/components/SlotByFramework";
 import FrameworkLinks from "@/components/FrameworkLinks";

src/content/docs/get-started.mdx

@@ -58,7 +58,7 @@ import FrameworkLinks from "@/components/FrameworkLinks";
 import { LinkButton, LinkCard, CardGrid } from "@astrojs/starlight/components";
 import FAQs from "/src/components/FAQs.astro";
 import WhatIsArcjet from "/src/components/WhatIsArcjet.astro";
-import SdkReferenceLinkByFramework from "/src/components/SdkReferenceLinkByFramework.astro";
+import SdkReferenceLinkByFramework from "/src/components/SdkReferenceLinkByFramework.mdx";
 import { YouTube } from "astro-embed";
 
 import AstroStep0 from "@/snippets/get-started/astro/Step0.mdx";

src/content/docs/nosecone/quick-start.mdx

@@ -44,7 +44,7 @@ import SlotByFramework from "@/components/SlotByFramework";
 import { frameworks } from "@/lib/prefs";
 import { LinkCard, CardGrid } from "@astrojs/starlight/components";
 import Comments from "/src/components/Comments.astro";
-import SdkReferenceLinkByFramework from "/src/components/SdkReferenceLinkByFramework.astro";
+import SdkReferenceLinkByFramework from "/src/components/SdkReferenceLinkByFramework.mdx";
 
 import BunStep1 from "@/snippets/nosecone/quick-start/bun/Step1.mdx";
 import BunStep2 from "@/snippets/nosecone/quick-start/bun/Step2.mdx";

src/content/docs/rate-limiting/quick-start.mdx

@@ -51,7 +51,7 @@ import FrameworkLinks from "@/components/FrameworkLinks";
 import FAQs from "@/components/FAQs.astro";
 import Comments from "@/components/Comments.astro";
 import { frameworks } from "@/lib/prefs";
-import SdkReferenceLinkByFramework from "/src/components/SdkReferenceLinkByFramework.astro";
+import SdkReferenceLinkByFramework from "/src/components/SdkReferenceLinkByFramework.mdx";
 
 import BunStep1 from "@/snippets/rate-limiting/quick-start/bun/Step1.mdx";
 import BunStep2 from "@/snippets/rate-limiting/quick-start/bun/Step2.mdx";

src/content/docs/redact/quick-start.mdx

@@ -10,7 +10,7 @@ import FAQs from "/src/components/FAQs.astro";
 import QuickStartRedact from "/src/snippets/redact/QuickStartRedact.ts?raw";
 import QuickStartUnredact from "/src/snippets/redact/QuickStartUnredact.ts?raw";
 import Comments from "/src/components/Comments.astro";
-import SdkReferenceLinkByFramework from "/src/components/SdkReferenceLinkByFramework.astro";
+import SdkReferenceLinkByFramework from "/src/components/SdkReferenceLinkByFramework.mdx";
 
 The Arcjet Redaction library makes it easy to redact sensitive information
 locally.

src/content/docs/sensitive-info/quick-start.mdx

@@ -47,7 +47,7 @@ import FrameworkName from "@/components/FrameworkName";
 import { frameworks } from "@/lib/prefs";
 import FAQs from "/src/components/FAQs.astro";
 import Comments from "/src/components/Comments.astro";
-import SdkReferenceLinkByFramework from "/src/components/SdkReferenceLinkByFramework.astro";
+import SdkReferenceLinkByFramework from "/src/components/SdkReferenceLinkByFramework.mdx";
 
 import Step1Bun from "@/snippets/sensitive-info/quick-start/bun/Step1.mdx";
 import Step1NestJs from "@/snippets/sensitive-info/quick-start/nestjs/Step1.mdx";

src/content/docs/shield/quick-start.mdx

@@ -50,7 +50,7 @@ import { CardGrid, LinkCard } from "@astrojs/starlight/components";
 import Comments from "/src/components/Comments.astro";
 import FAQs from "/src/components/FAQs.astro";
 import WhatIsArcjet from "/src/components/WhatIsArcjet.astro";
-import SdkReferenceLinkByFramework from "/src/components/SdkReferenceLinkByFramework.astro";
+import SdkReferenceLinkByFramework from "/src/components/SdkReferenceLinkByFramework.mdx";
 
 import Step1Bun from "@/snippets/shield/quick-start/bun/Step1.mdx";
 import Step3Bun from "@/snippets/shield/quick-start/bun/Step3.mdx";

src/content/docs/signup-protection/quick-start.mdx

@@ -46,7 +46,7 @@ import SlotByFramework from "@/components/SlotByFramework";
 import FrameworkLinks from "@/components/FrameworkLinks";
 import FrameworkName from "@/components/FrameworkName";
 import { frameworks } from "@/lib/prefs";
-import SdkReferenceLinkByFramework from "/src/components/SdkReferenceLinkByFramework.astro";
+import SdkReferenceLinkByFramework from "/src/components/SdkReferenceLinkByFramework.mdx";
 
 import Step1Bun from "@/snippets/signup-protection/quick-start/bun/Step1.mdx";
 import Step1NestJs from "@/snippets/signup-protection/quick-start/nestjs/Step1.mdx";

src/lib/prefs.ts

@@ -26,6 +26,14 @@ export type FrameworkLabel = Framework["label"];
  */
 export type Framework = (typeof frameworks)[number];
 
+/**
+ * Integration keys.
+ */
+export type IntegrationKey = Exclude<
+  FrameworkKey,
+  "bun-hono" | "node-js-express" | "node-js-hono"
+>;
+
 /**
  * The available user prefs
  * Defines the user preferences that are persisted.
@@ -63,6 +71,16 @@ export const frameworks = [
   { key: "sveltekit", label: "SvelteKit" },
 ] as const;
 
+/**
+ * Some framework choices add some third party onto another framework.
+ * These are mapped here.
+ */
+export const frameworkToIntegration = {
+  "bun-hono": "bun",
+  "node-js-express": "node-js",
+  "node-js-hono": "node-js",
+} as const;
+
 /**
  * Default Selected Framework
  * The framework selected by default if the user didn't make a choice.