feat: Add support for mdx partials

apps/docs/features/docs/MdxBase.shared.tsx

@@ -117,7 +117,6 @@ const components = {
    */
   RefDefinitionParams,
   RefDefinitionReturnType,
-  CodeBlock,
   CollapsibleDetails,
 }
 

apps/docs/scripts/generate-tsdoc-mdx.ts

@@ -1,4 +1,4 @@
-import { mkdirSync, readdirSync, writeFileSync } from 'fs'
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'fs'
 import { join, dirname, relative } from 'path'
 import { fileURLToPath } from 'url'
 import { processSpec, type SpecCategory, type SpecConfig } from './process-tsdoc.js'
@@ -135,7 +135,7 @@ function generateExamplesBlock(examples: any[]): string[] {
   return lines
 }
 
-function generateMdx(categories: SpecCategory[], config: SpecConfig): string {
+function generateMdx(categories: SpecCategory[], config: SpecConfig, specDir: string): string {
   const fmVal = (v: string) => `"${v.replace(/"/g, '\\"')}"`
   const frontmatter = [
     '---',
@@ -151,6 +151,12 @@ function generateMdx(categories: SpecCategory[], config: SpecConfig): string {
   ]
   const lines: string[] = frontmatter
 
+  // Insert optional introduction partial immediately after frontmatter
+  const introParthialPath = join(specDir, 'introduction.partial.mdx')
+  if (existsSync(introParthialPath)) {
+    lines.push(readFileSync(introParthialPath, 'utf-8').trimEnd(), '')
+  }
+
   for (let i = 0; i < categories.length; i++) {
     const { category, definitions } = categories[i]
 
@@ -160,6 +166,12 @@ function generateMdx(categories: SpecCategory[], config: SpecConfig): string {
 
     lines.push(`## ${category}`, '')
 
+    // Insert optional partial: <specDir>/<category-slug>.partial.mdx
+    const partialPath = join(specDir, `${toSlug(category)}.partial.mdx`)
+    if (existsSync(partialPath)) {
+      lines.push(readFileSync(partialPath, 'utf-8').trimEnd(), '')
+    }
+
     for (let j = 0; j < definitions.length; j++) {
       const def = definitions[j]
       const isLastInCategory = j === definitions.length - 1
@@ -221,7 +233,7 @@ for (const specDir of specFolders) {
   mkdirSync(outDir, { recursive: true })
 
   // Write MDX
-  const mdx = generateMdx(categories, config)
+  const mdx = generateMdx(categories, config, specDir)
   const mdxPath = join(outDir, 'index.mdx')
   writeFileSync(mdxPath, mdx)
 

apps/docs/spec/reference/javascript/Auth.partial.mdx

@@ -0,0 +1 @@
+Hello **world**, this is Auth.

apps/docs/spec/reference/javascript/Database.partial.mdx

@@ -0,0 +1 @@
+Hello **world**, this is _Database_.

apps/docs/spec/reference/javascript/introduction.partial.mdx

@@ -0,0 +1,9 @@
+### Install
+
+Walla walla...
+
+```sh
+npm i @supabase/supabase-js
+```
+
+Push the tempo.