@brainfish-ai/devdoc 0.1.21

package/renderer/app/robots.txt/route.ts

@@ -0,0 +1,84 @@
+import { NextResponse } from 'next/server'
+import { join } from 'path'
+import { readFileSync, existsSync } from 'fs'
+
+/**
+ * robots.txt - Auto-generated robots file for search engines
+ */
+
+const DOCS_DIR = join(process.cwd(), 'templates', 'starter')
+const BASE_URL = process.env.NEXT_PUBLIC_SITE_URL || 'http://localhost:3000'
+
+interface DocsConfig {
+  seo?: {
+    metatags?: Record<string, string>
+  }
+}
+
+function loadDocsConfig(): DocsConfig | null {
+  const configPath = join(DOCS_DIR, 'docs.json')
+  if (!existsSync(configPath)) return null
+  
+  try {
+    const content = readFileSync(configPath, 'utf-8')
+    return JSON.parse(content)
+  } catch {
+    return null
+  }
+}
+
+function generateRobotsTxt(config: DocsConfig): string {
+  const baseUrl = config.seo?.metatags?.canonical || BASE_URL
+  const isNoIndex = config.seo?.metatags?.robots === 'noindex'
+  
+  const lines: string[] = []
+  
+  lines.push('# robots.txt generated by Benjy')
+  lines.push('')
+  lines.push('User-agent: *')
+  
+  if (isNoIndex) {
+    lines.push('Disallow: /')
+  } else {
+    lines.push('Allow: /')
+    lines.push('')
+    lines.push('# Disallow API routes')
+    lines.push('Disallow: /api/')
+  }
+  
+  lines.push('')
+  lines.push(`Sitemap: ${baseUrl}/sitemap.xml`)
+  lines.push('')
+  
+  return lines.join('\n')
+}
+
+export async function GET() {
+  try {
+    // Check for custom robots.txt first
+    const customPath = join(DOCS_DIR, 'robots.txt')
+    if (existsSync(customPath)) {
+      const customContent = readFileSync(customPath, 'utf-8')
+      return new NextResponse(customContent, {
+        headers: {
+          'Content-Type': 'text/plain; charset=utf-8',
+          'Cache-Control': 'public, max-age=3600',
+        },
+      })
+    }
+    
+    // Generate default robots.txt
+    const config = loadDocsConfig()
+    const content = generateRobotsTxt(config || {})
+    
+    return new NextResponse(content, {
+      headers: {
+        'Content-Type': 'text/plain; charset=utf-8',
+        'Cache-Control': 'public, max-age=3600',
+      },
+    })
+  } catch (error) {
+    console.error('Error generating robots.txt:', error)
+    return new NextResponse('Error generating robots.txt', { status: 500 })
+  }
+}

package/renderer/app/sitemap.xml/route.ts

@@ -0,0 +1,199 @@
+import { NextResponse } from 'next/server'
+import { join } from 'path'
+import { readFileSync, existsSync, readdirSync, statSync } from 'fs'
+
+/**
+ * sitemap.xml - Auto-generated sitemap for search engines
+ * 
+ * Generated from docs.json configuration.
+ */
+
+const DOCS_DIR = join(process.cwd(), 'templates', 'starter')
+const BASE_URL = process.env.NEXT_PUBLIC_SITE_URL || 'http://localhost:3000'
+
+interface NavigationTab {
+  tab: string
+  type: 'docs' | 'openapi' | 'changelog'
+  path?: string
+  groups?: Array<{
+    group: string
+    pages: string[]
+  }>
+  versions?: Array<{
+    version: string
+    spec: string
+    default?: boolean
+  }>
+}
+
+interface DocsConfig {
+  name?: string
+  seo?: {
+    indexing?: 'all' | 'navigation'
+    metatags?: Record<string, string>
+  }
+  navigation?: {
+    tabs?: NavigationTab[]
+  }
+}
+
+interface SitemapEntry {
+  url: string
+  lastmod?: string
+  changefreq?: string
+  priority?: number
+}
+
+function loadDocsConfig(): DocsConfig | null {
+  const configPath = join(DOCS_DIR, 'docs.json')
+  if (!existsSync(configPath)) return null
+  
+  try {
+    const content = readFileSync(configPath, 'utf-8')
+    return JSON.parse(content)
+  } catch {
+    return null
+  }
+}
+
+function getFileLastModified(slug: string): string | undefined {
+  const extensions = ['.mdx', '.md']
+  
+  for (const ext of extensions) {
+    const filePath = join(DOCS_DIR, `${slug}${ext}`)
+    if (existsSync(filePath)) {
+      try {
+        const stats = statSync(filePath)
+        return stats.mtime.toISOString().split('T')[0]
+      } catch {
+        return undefined
+      }
+    }
+  }
+  return undefined
+}
+
+function getChangelogFiles(): string[] {
+  const changelogDir = join(DOCS_DIR, 'changelog')
+  if (!existsSync(changelogDir)) return []
+  
+  try {
+    return readdirSync(changelogDir)
+      .filter(f => (f.endsWith('.mdx') || f.endsWith('.md')) && f !== 'latest.mdx')
+      .map(f => f.replace(/\.(mdx?|md)$/, ''))
+  } catch {
+    return []
+  }
+}
+
+function generateSitemap(config: DocsConfig): string {
+  const entries: SitemapEntry[] = []
+  const baseUrl = config.seo?.metatags?.canonical || BASE_URL
+  
+  // Add homepage
+  entries.push({
+    url: baseUrl,
+    changefreq: 'weekly',
+    priority: 1.0,
+  })
+  
+  // Process navigation tabs
+  if (config.navigation?.tabs) {
+    for (const tab of config.navigation.tabs) {
+      if (tab.type === 'docs' && tab.groups) {
+        for (const group of tab.groups) {
+          for (const page of group.pages) {
+            const lastmod = getFileLastModified(page)
+            const urlPath = page === 'index' ? '' : page
+            
+            entries.push({
+              url: `${baseUrl}/#${tab.tab.toLowerCase()}/page/${urlPath}`.replace(/\/+$/, ''),
+              lastmod,
+              changefreq: 'weekly',
+              priority: page === 'index' ? 0.9 : 0.8,
+            })
+          }
+        }
+      } else if (tab.type === 'openapi') {
+        entries.push({
+          url: `${baseUrl}/#api-reference`,
+          changefreq: 'weekly',
+          priority: 0.9,
+        })
+      } else if (tab.type === 'changelog') {
+        entries.push({
+          url: `${baseUrl}/#changelog`,
+          changefreq: 'weekly',
+          priority: 0.7,
+        })
+        
+        // Add individual changelog pages
+        const versions = getChangelogFiles()
+        for (const version of versions) {
+          const lastmod = getFileLastModified(`changelog/${version}`)
+          entries.push({
+            url: `${baseUrl}/#changelog/page/changelog/${version}`,
+            lastmod,
+            changefreq: 'monthly',
+            priority: 0.6,
+          })
+        }
+      }
+    }
+  }
+  
+  // Generate XML
+  const xml = `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${entries.map(entry => `  <url>
+    <loc>${escapeXml(entry.url)}</loc>
+${entry.lastmod ? `    <lastmod>${entry.lastmod}</lastmod>\n` : ''}${entry.changefreq ? `    <changefreq>${entry.changefreq}</changefreq>\n` : ''}${entry.priority !== undefined ? `    <priority>${entry.priority}</priority>\n` : ''}  </url>`).join('\n')}
+</urlset>`
+  
+  return xml
+}
+
+function escapeXml(str: string): string {
+  return str
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&apos;')
+}
+
+export async function GET() {
+  try {
+    // Check for custom sitemap.xml first
+    const customPath = join(DOCS_DIR, 'sitemap.xml')
+    if (existsSync(customPath)) {
+      const customContent = readFileSync(customPath, 'utf-8')
+      return new NextResponse(customContent, {
+        headers: {
+          'Content-Type': 'application/xml; charset=utf-8',
+          'Cache-Control': 'public, max-age=3600',
+        },
+      })
+    }
+    
+    // Generate from docs.json config
+    const config = loadDocsConfig()
+    if (!config) {
+      return new NextResponse('<?xml version="1.0" encoding="UTF-8"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"></urlset>', {
+        headers: { 'Content-Type': 'application/xml; charset=utf-8' },
+      })
+    }
+    
+    const content = generateSitemap(config)
+    
+    return new NextResponse(content, {
+      headers: {
+        'Content-Type': 'application/xml; charset=utf-8',
+        'Cache-Control': 'public, max-age=3600',
+      },
+    })
+  } catch (error) {
+    console.error('Error generating sitemap.xml:', error)
+    return new NextResponse('Error generating sitemap.xml', { status: 500 })
+  }
+}

package/renderer/components/docs/index.ts

@@ -0,0 +1,12 @@
+/**
+ * Documentation Components Exports
+ */
+
+// MDX Components
+export * from './mdx'
+
+// MDX Renderer
+export { MDXRenderer, TableOfContents as MDXTableOfContents, type TableOfContentsItem } from './mdx-renderer'
+
+// Navigation Components
+export * from './navigation'

package/renderer/components/docs/mdx/accordion.tsx

@@ -0,0 +1,169 @@
+'use client'
+
+import React, { useState, createContext, useContext } from 'react'
+import { cn } from '@/lib/utils'
+import { CaretDown } from '@phosphor-icons/react'
+import * as PhosphorIcons from '@phosphor-icons/react'
+
+/**
+ * Accordion Components for MDX Documentation
+ * 
+ * Mintlify-compatible accordion components for collapsible content sections.
+ */
+
+// Dynamic icon resolver
+function getIcon(iconName: string): React.ComponentType<{ className?: string; weight?: string }> | null {
+  if (!iconName) return null
+  
+  const pascalCase = iconName
+    .split(/[-_]/)
+    .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+    .join('')
+  
+  const Icon = (PhosphorIcons as Record<string, unknown>)[pascalCase] as React.ComponentType<{ className?: string; weight?: string }> | undefined
+  return Icon || null
+}
+
+// Context for AccordionGroup
+interface AccordionGroupContextType {
+  openItems: Set<string>
+  toggleItem: (id: string) => void
+  allowMultiple: boolean
+}
+
+const AccordionGroupContext = createContext<AccordionGroupContextType | null>(null)
+
+interface AccordionProps {
+  title: string
+  children: React.ReactNode
+  description?: string
+  icon?: string
+  iconType?: string
+  defaultOpen?: boolean
+  className?: string
+}
+
+export function Accordion({
+  title,
+  children,
+  description,
+  icon,
+  defaultOpen = false,
+  className,
+}: AccordionProps) {
+  const groupContext = useContext(AccordionGroupContext)
+  const [localOpen, setLocalOpen] = useState(defaultOpen)
+  
+  // Generate a stable ID for this accordion
+  const id = React.useId()
+  
+  // Use group context if available, otherwise use local state
+  const isOpen = groupContext ? groupContext.openItems.has(id) : localOpen
+  const toggle = () => {
+    if (groupContext) {
+      groupContext.toggleItem(id)
+    } else {
+      setLocalOpen(!localOpen)
+    }
+  }
+  
+  // Register default open state with group on mount
+  React.useEffect(() => {
+    if (groupContext && defaultOpen) {
+      groupContext.toggleItem(id)
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [])
+  
+  const Icon = icon ? getIcon(icon) : null
+  
+  return (
+    <div
+      className={cn(
+        'border border-border rounded-lg overflow-hidden',
+        'bg-card',
+        className
+      )}
+    >
+      <button
+        type="button"
+        onClick={toggle}
+        className={cn(
+          'flex w-full items-center gap-3 p-4 text-left',
+          'hover:bg-muted/50 transition-colors',
+          'focus:outline-none focus-visible:ring-2 focus-visible:ring-primary/50'
+        )}
+        aria-expanded={isOpen}
+      >
+        {Icon && (
+          <Icon className="h-5 w-5 shrink-0 text-primary" weight="duotone" />
+        )}
+        
+        <div className="flex-1 min-w-0">
+          <div className="font-medium text-foreground">{title}</div>
+          {description && (
+            <div className="text-sm text-muted-foreground mt-0.5">{description}</div>
+          )}
+        </div>
+        
+        <CaretDown
+          className={cn(
+            'h-5 w-5 shrink-0 text-muted-foreground transition-transform duration-200',
+            isOpen && 'rotate-180'
+          )}
+          weight="bold"
+        />
+      </button>
+      
+      <div
+        className={cn(
+          'grid transition-all duration-200 ease-in-out',
+          isOpen ? 'grid-rows-[1fr] opacity-100' : 'grid-rows-[0fr] opacity-0'
+        )}
+      >
+        <div className="overflow-hidden">
+          <div className="px-4 pb-4 text-sm text-foreground/90 [&>p]:mb-2 [&>p:last-child]:mb-0">
+            {children}
+          </div>
+        </div>
+      </div>
+    </div>
+  )
+}
+
+interface AccordionGroupProps {
+  children: React.ReactNode
+  allowMultiple?: boolean
+  className?: string
+}
+
+export function AccordionGroup({
+  children,
+  allowMultiple = true,
+  className,
+}: AccordionGroupProps) {
+  const [openItems, setOpenItems] = useState<Set<string>>(new Set())
+  
+  const toggleItem = (id: string) => {
+    setOpenItems(prev => {
+      const next = new Set(prev)
+      if (next.has(id)) {
+        next.delete(id)
+      } else {
+        if (!allowMultiple) {
+          next.clear()
+        }
+        next.add(id)
+      }
+      return next
+    })
+  }
+  
+  return (
+    <AccordionGroupContext.Provider value={{ openItems, toggleItem, allowMultiple }}>
+      <div className={cn('space-y-2 my-4', className)}>
+        {children}
+      </div>
+    </AccordionGroupContext.Provider>
+  )
+}

package/renderer/components/docs/mdx/badge.tsx

@@ -0,0 +1,132 @@
+'use client'
+
+import { ReactNode } from 'react'
+import { cn } from '@/lib/utils'
+import * as PhosphorIcons from '@phosphor-icons/react'
+
+// Helper to get Phosphor icon component from name
+function getIcon(iconName?: string): React.ComponentType<{ className?: string; weight?: "thin" | "light" | "regular" | "bold" | "fill" | "duotone" }> | null {
+  if (!iconName) return null
+  
+  // Convert kebab-case to PascalCase for Phosphor icons
+  const pascalCase = iconName
+    .split('-')
+    .map(part => part.charAt(0).toUpperCase() + part.slice(1))
+    .join('')
+  
+  const IconComponent = (PhosphorIcons as Record<string, unknown>)[pascalCase] as React.ComponentType<{ className?: string; weight?: "thin" | "light" | "regular" | "bold" | "fill" | "duotone" }> | undefined
+  return IconComponent || null
+}
+
+type BadgeColor = 
+  | 'gray' 
+  | 'blue' 
+  | 'green' 
+  | 'yellow' 
+  | 'orange' 
+  | 'red' 
+  | 'purple' 
+  | 'white' 
+  | 'surface' 
+  | 'white-destructive' 
+  | 'surface-destructive'
+
+type BadgeSize = 'xs' | 'sm' | 'md' | 'lg'
+type BadgeShape = 'rounded' | 'pill'
+
+interface BadgeProps {
+  children: ReactNode
+  color?: BadgeColor
+  size?: BadgeSize
+  shape?: BadgeShape
+  icon?: string
+  stroke?: boolean
+  disabled?: boolean
+  className?: string
+}
+
+// Color variants - filled background
+const colorVariants: Record<BadgeColor, string> = {
+  gray: 'bg-gray-100 text-gray-700 dark:bg-gray-800 dark:text-gray-300',
+  blue: 'bg-blue-100 text-blue-700 dark:bg-blue-900/50 dark:text-blue-300',
+  green: 'bg-green-100 text-green-700 dark:bg-green-900/50 dark:text-green-300',
+  yellow: 'bg-yellow-100 text-yellow-700 dark:bg-yellow-900/50 dark:text-yellow-300',
+  orange: 'bg-orange-100 text-orange-700 dark:bg-orange-900/50 dark:text-orange-300',
+  red: 'bg-red-100 text-red-700 dark:bg-red-900/50 dark:text-red-300',
+  purple: 'bg-purple-100 text-purple-700 dark:bg-purple-900/50 dark:text-purple-300',
+  white: 'bg-white text-gray-900 border border-gray-200 dark:bg-gray-900 dark:text-gray-100 dark:border-gray-700',
+  surface: 'bg-muted text-foreground',
+  'white-destructive': 'bg-white text-red-600 border border-red-200 dark:bg-gray-900 dark:text-red-400 dark:border-red-800',
+  'surface-destructive': 'bg-red-50 text-red-600 dark:bg-red-950 dark:text-red-400',
+}
+
+// Color variants - stroke/outline
+const strokeVariants: Record<BadgeColor, string> = {
+  gray: 'border border-gray-300 text-gray-700 dark:border-gray-600 dark:text-gray-300',
+  blue: 'border border-blue-300 text-blue-700 dark:border-blue-600 dark:text-blue-300',
+  green: 'border border-green-300 text-green-700 dark:border-green-600 dark:text-green-300',
+  yellow: 'border border-yellow-300 text-yellow-700 dark:border-yellow-600 dark:text-yellow-300',
+  orange: 'border border-orange-300 text-orange-700 dark:border-orange-600 dark:text-orange-300',
+  red: 'border border-red-300 text-red-700 dark:border-red-600 dark:text-red-300',
+  purple: 'border border-purple-300 text-purple-700 dark:border-purple-600 dark:text-purple-300',
+  white: 'border border-gray-300 text-gray-700 dark:border-gray-600 dark:text-gray-300',
+  surface: 'border border-border text-foreground',
+  'white-destructive': 'border border-red-300 text-red-600 dark:border-red-600 dark:text-red-400',
+  'surface-destructive': 'border border-red-300 text-red-600 dark:border-red-600 dark:text-red-400',
+}
+
+// Size variants
+const sizeVariants: Record<BadgeSize, string> = {
+  xs: 'text-[10px] px-1.5 py-0.5 gap-1',
+  sm: 'text-xs px-2 py-0.5 gap-1',
+  md: 'text-sm px-2.5 py-1 gap-1.5',
+  lg: 'text-base px-3 py-1.5 gap-2',
+}
+
+// Icon size variants
+const iconSizeVariants: Record<BadgeSize, string> = {
+  xs: 'h-2.5 w-2.5',
+  sm: 'h-3 w-3',
+  md: 'h-3.5 w-3.5',
+  lg: 'h-4 w-4',
+}
+
+// Shape variants
+const shapeVariants: Record<BadgeShape, string> = {
+  rounded: 'rounded-md',
+  pill: 'rounded-full',
+}
+
+export function Badge({
+  children,
+  color = 'gray',
+  size = 'md',
+  shape = 'rounded',
+  icon,
+  stroke = false,
+  disabled = false,
+  className,
+}: BadgeProps) {
+  const IconComponent = getIcon(icon)
+  
+  return (
+    <span
+      className={cn(
+        'inline-flex items-center font-medium whitespace-nowrap',
+        sizeVariants[size],
+        shapeVariants[shape],
+        stroke ? strokeVariants[color] : colorVariants[color],
+        disabled && 'opacity-50 cursor-not-allowed',
+        className
+      )}
+    >
+      {IconComponent && (
+        <IconComponent 
+          className={cn(iconSizeVariants[size], 'shrink-0')} 
+          weight="bold" 
+        />
+      )}
+      {children}
+    </span>
+  )
+}