ci(docs): add linter check (#10376)

### Description

Turning on the linter for the docs site now that we've done the bulk of
our high velocity work.

### Testing Instructions

CI. You can also browse the preview for anything that may look amiss.

Author: anthonyshew

docs/site/.eslintrc.js

@@ -1,12 +1,15 @@
 /** @type {import('eslint').Linter.Config} */
 module.exports = {
   root: true,
-  extends: ["@turbo/eslint-config/library", "next"],
+  extends: ["@turbo/eslint-config/library", "plugin:@next/next/recommended"],
   ignorePatterns: [
     "turbo",
     ".map.ts",
     "!app/.well-known/vercel/flags/route.ts",
     ".source",
+    "components/ui/**",
+    // TODO: Need to fix the JSON inference in this file
+    "components/examples-table.tsx",
   ],
   overrides: [
     {
@@ -16,7 +19,15 @@ module.exports = {
       },
     },
     {
-      files: ["next.config.mjs", "global-error.jsx"],
+      files: [
+        "next.config.mjs",
+        "global-error.tsx",
+        "page.tsx",
+        "not-found.tsx",
+        "source.config.ts",
+        "next.config.ts",
+        "layout.tsx",
+      ],
       rules: {
         "import/no-default-export": "off",
       },

docs/site/app/(no-sidebar)/[...slug]/layout.tsx

@@ -2,7 +2,7 @@ import { notFound } from "next/navigation";
 import { extraPages } from "@/app/source";
 
 export default async function SlugLayout(props: {
-  params: Promise<{ slug?: string[] }>;
+  params: Promise<{ slug?: Array<string> }>;
   children: React.ReactNode;
 }): Promise<JSX.Element> {
   const params = await props.params;

docs/site/app/(no-sidebar)/[...slug]/page.tsx

@@ -5,7 +5,7 @@ import { createMetadata } from "@/lib/create-metadata";
 import { mdxComponents } from "@/mdx-components";
 
 export default async function Page(props: {
-  params: Promise<{ slug?: string[] }>;
+  params: Promise<{ slug?: Array<string> }>;
 }): Promise<JSX.Element> {
   const params = await props.params;
   const page = extraPages.getPage(params.slug);
@@ -14,6 +14,7 @@ export default async function Page(props: {
     notFound();
   }
 
+  /* eslint-disable-next-line @typescript-eslint/no-unsafe-assignment -- MDX component */
   const Mdx = page.data.body;
 
   return (
@@ -24,14 +25,14 @@ export default async function Page(props: {
   );
 }
 
-export function generateStaticParams(): { slug: string[] }[] {
+export function generateStaticParams(): Array<{ slug: Array<string> }> {
   return extraPages.getPages().map((page) => ({
     slug: page.slugs,
   }));
 }
 
 export async function generateMetadata(props: {
-  params: Promise<{ slug?: string[] }>;
+  params: Promise<{ slug?: Array<string> }>;
 }): Promise<Metadata> {
   const params = await props.params;
   const page = extraPages.getPage(params.slug);

docs/site/app/(no-sidebar)/blog/[...slug]/page.tsx

@@ -7,14 +7,14 @@ import { createMetadata } from "@/lib/create-metadata";
 import { FaviconHandler } from "@/app/_components/favicon-handler";
 import { mdxComponents } from "@/mdx-components";
 
-export function generateStaticParams(): { slug: string[] }[] {
+export function generateStaticParams(): Array<{ slug: Array<string> }> {
   return blog.getPages().map((page) => ({
     slug: page.slugs,
   }));
 }
 
 export async function generateMetadata(props: {
-  params: Promise<{ slug?: string[] }>;
+  params: Promise<{ slug?: Array<string> }>;
 }): Promise<Metadata> {
   const params = await props.params;
   const page = blog.getPage(params.slug);
@@ -38,13 +38,14 @@ export async function generateMetadata(props: {
 }
 
 export default async function Page(props: {
-  params: Promise<{ slug?: string[] }>;
+  params: Promise<{ slug?: Array<string> }>;
 }): Promise<JSX.Element> {
   const params = await props.params;
   const page = blog.getPage(params.slug);
 
   if (!page) notFound();
 
+  // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment -- Not being inferred correctly
   const Mdx = page.data.body;
 
   return (

docs/site/app/(no-sidebar)/layout.tsx

@@ -11,7 +11,7 @@ export default function Layout({
   return (
     <>
       <FaviconHandler />
-      {/* @ts-expect-error */}
+      {/* @ts-expect-error - className isn't on type but it works. */}
       <HomeLayout className="p-0" {...baseOptions}>
         {children}
       </HomeLayout>

docs/site/app/(no-sidebar)/page.tsx

@@ -1,9 +1,9 @@
 "use client";
 
 import React, { useState } from "react";
-import { cn } from "@/components/cn";
 import Link from "next/link";
 import { motion } from "framer-motion";
+import { cn } from "@/components/cn";
 import { Clients } from "@/app/_clients/clients";
 import { FadeIn } from "@/app/_components/home-shared/fade-in";
 import { PackLogo } from "@/app/_components/logos/pack-logo";

docs/site/app/(openapi)/docs/openapi/[[...slug]]/page.tsx

@@ -7,11 +7,10 @@ import {
 import { notFound } from "next/navigation";
 import defaultMdxComponents from "fumadocs-ui/mdx";
 import { openapi, openapiPages } from "../source";
-// eslint-disable-next-line rulesdir/global-css
 import "./openapi.css";
 
 export default async function Page(props: {
-  params: Promise<{ slug?: string[] }>;
+  params: Promise<{ slug?: Array<string> }>;
 }): Promise<JSX.Element> {
   const params = await props.params;
   const page = openapiPages.getPage(params.slug);
@@ -20,6 +19,7 @@ export default async function Page(props: {
     notFound();
   }
 
+  // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment -- Not typed properly?
   const Mdx = page.data.body;
 
   return (
@@ -30,6 +30,7 @@ export default async function Page(props: {
         <Mdx
           components={{
             ...defaultMdxComponents,
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment -- Not typed properly?
             APIPage: openapi.APIPage,
           }}
         />
@@ -38,6 +39,6 @@ export default async function Page(props: {
   );
 }
 
-export function generateStaticParams(): { slug: string[] }[] {
+export function generateStaticParams(): Array<{ slug: Array<string> }> {
   return openapiPages.generateParams();
 }

docs/site/app/(openapi)/docs/openapi/layout.tsx

@@ -4,11 +4,7 @@ import { Navigation } from "@/components/nav";
 import { Sidebar } from "#/components/docs-layout/sidebar";
 import { openapiPages } from "./source";
 
-export default async function Layout({
-  children,
-}: {
-  children: React.ReactNode;
-}) {
+export default function Layout({ children }: { children: React.ReactNode }) {
   return (
     <>
       <Navigation />

docs/site/app/(openapi)/docs/openapi/source.ts

@@ -1,14 +1,11 @@
 import { createMDXSource } from "fumadocs-mdx";
-import { createOpenAPI, attachFile } from "fumadocs-openapi/server";
+import { createOpenAPI } from "fumadocs-openapi/server";
 import { loader } from "fumadocs-core/source";
 import { openapiDocs, openapiMeta } from "@/.source";
 
 export const openapiPages = loader({
   baseUrl: "/docs/openapi",
   source: createMDXSource(openapiDocs, openapiMeta),
-  pageTree: {
-    attachFile,
-  },
 });
 
 export const openapi = createOpenAPI();

docs/site/app/(sidebar)/docs/[[...slug]]/layout.tsx

@@ -3,7 +3,7 @@ import { notFound } from "next/navigation";
 import { repoDocsPages } from "@/app/source";
 
 export default async function SlugLayout(props: {
-  params: Promise<{ slug?: string[] }>;
+  params: Promise<{ slug?: Array<string> }>;
   children: React.ReactNode;
 }): Promise<JSX.Element> {
   const params = await props.params;