@brainfish-ai/devdoc 0.1.41 → 0.1.43

package/renderer/lib/docs/navigation/generator.ts

@@ -1,348 +0,0 @@
-import { relative, basename, extname } from 'path'
-import { 
-  type DocsConfig, 
-  type NavigationTab, 
-  type NavigationGroup,
-  resolvePagePath,
-  loadPageContent,
-} from '../config'
-import { extractFrontmatter, safeParseFrontmatter } from '../mdx'
-import type { 
-  Navigation, 
-  NavTab, 
-  NavGroup, 
-  NavItem, 
-  PageNavContext,
-  BreadcrumbItem,
-  PageMeta,
-} from './types'
-
-/**
- * Navigation Generator
- * 
- * Builds navigation structure from docs.json configuration
- */
-
-/**
- * Generate navigation from configuration
- */
-export function generateNavigation(
-  config: DocsConfig,
-  docsDir: string
-): Navigation {
-  const nav = config.navigation
-  const navigation: Navigation = {}
-  
-  // Handle tabbed navigation
-  if (nav.tabs && nav.tabs.length > 0) {
-    navigation.tabs = nav.tabs.map(tab => buildNavTab(tab, docsDir))
-  }
-  
-  // Handle single-page navigation (no tabs)
-  if (nav.groups && nav.groups.length > 0) {
-    navigation.groups = nav.groups.map(group => buildNavGroup(group, docsDir))
-  }
-  
-  // Add global anchors
-  if (nav.global?.anchors) {
-    navigation.anchors = nav.global.anchors.map(anchor => ({
-      title: anchor.anchor,
-      href: anchor.href,
-      icon: anchor.icon,
-      external: anchor.href.startsWith('http'),
-    }))
-  }
-  
-  return navigation
-}
-
-/**
- * Build a navigation tab
- */
-function buildNavTab(
-  tab: NavigationTab,
-  docsDir: string
-): NavTab {
-  const slug = tab.tab.toLowerCase().replace(/\s+/g, '-')
-  
-  // Only docs tabs have groups
-  if ('groups' in tab && tab.groups) {
-    const groups = tab.groups.map(group => buildNavGroup(group, docsDir))
-    return {
-      title: tab.tab,
-      slug,
-      groups,
-    }
-  }
-  
-  // For openapi/changelog tabs, return empty groups
-  return {
-    title: tab.tab,
-    slug,
-    groups: [],
-  }
-}
-
-/**
- * Build a navigation group
- */
-function buildNavGroup(
-  group: NavigationGroup,
-  docsDir: string
-): NavGroup {
-  const items = group.pages
-    .map(page => buildNavItemOrGroup(page, docsDir))
-    .filter((item): item is NavItem | NavGroup => item !== null)
-  
-  return {
-    title: group.group,
-    icon: group.icon,
-    items,
-    collapsible: true,
-    defaultCollapsed: false,
-  }
-}
-
-/**
- * Build a navigation item or nested group from a page reference
- */
-function buildNavItemOrGroup(
-  pageRef: string | { group: string; pages: (string | object)[] },
-  docsDir: string
-): NavItem | NavGroup | null {
-  // Handle nested groups
-  if (typeof pageRef === 'object' && 'group' in pageRef) {
-    const nestedItems = pageRef.pages
-      .map(p => buildNavItemOrGroup(p as string | { group: string; pages: (string | object)[] }, docsDir))
-      .filter((item): item is NavItem | NavGroup => item !== null)
-    
-    return {
-      title: pageRef.group,
-      items: nestedItems,
-      collapsible: true,
-      defaultCollapsed: false,
-    }
-  }
-  
-  return buildNavItem(pageRef, docsDir)
-}
-
-/**
- * Build a navigation item from a page reference
- */
-function buildNavItem(
-  pageRef: string,
-  docsDir: string
-): NavItem | null {
-  // Check if it's an external link
-  if (pageRef.startsWith('http://') || pageRef.startsWith('https://')) {
-    return {
-      title: pageRef,
-      href: pageRef,
-      external: true,
-    }
-  }
-  
-  // Resolve the page file
-  const filePath = resolvePagePath(docsDir, pageRef)
-  
-  if (!filePath) {
-    console.warn(`Page not found: ${pageRef}`)
-    return {
-      title: pageRef,
-      href: `/${pageRef}`,
-    }
-  }
-  
-  // Load and parse frontmatter
-  try {
-    const content = loadPageContent(filePath)
-    const { data } = extractFrontmatter(content)
-    const frontmatter = safeParseFrontmatter(data)
-    
-    // Build URL path
-    const urlPath = pageRef === 'index' ? '/' : `/${pageRef}`
-    
-    return {
-      title: frontmatter?.sidebarTitle || frontmatter?.title || pageRef,
-      href: urlPath,
-      icon: frontmatter?.icon,
-      deprecated: frontmatter?.deprecated,
-    }
-  } catch (error) {
-    console.warn(`Failed to load page metadata: ${pageRef}`, error)
-    return {
-      title: pageRef,
-      href: `/${pageRef}`,
-    }
-  }
-}
-
-/**
- * Helper to check if an item is a NavItem (has href)
- */
-function isNavItem(item: NavItem | NavGroup): item is NavItem {
-  return 'href' in item && typeof item.href === 'string'
-}
-
-/**
- * Recursively collect all NavItems from items array (handles nested groups)
- */
-function collectNavItems(items: (NavItem | NavGroup)[]): NavItem[] {
-  const result: NavItem[] = []
-  for (const item of items) {
-    if (isNavItem(item)) {
-      result.push(item)
-    } else if ('items' in item && Array.isArray(item.items)) {
-      result.push(...collectNavItems(item.items))
-    }
-  }
-  return result
-}
-
-/**
- * Find navigation context for a specific page
- */
-export function findPageNavContext(
-  navigation: Navigation,
-  currentPath: string
-): PageNavContext {
-  const breadcrumbs: BreadcrumbItem[] = []
-  let prev: NavItem | undefined
-  let next: NavItem | undefined
-  let currentTab: NavTab | undefined
-  let currentGroup: NavGroup | undefined
-  let currentItem: NavItem | undefined
-  
-  // Normalize path
-  const normalizedPath = currentPath.startsWith('/') ? currentPath : `/${currentPath}`
-  
-  // Flatten all items for prev/next calculation
-  const allItems: NavItem[] = []
-  
-  // Search in tabs
-  if (navigation.tabs) {
-    for (const tab of navigation.tabs) {
-      for (const group of tab.groups) {
-        const groupItems = collectNavItems(group.items)
-        allItems.push(...groupItems)
-        
-        for (const item of groupItems) {
-          if (item.href === normalizedPath) {
-            currentTab = tab
-            currentGroup = group
-            currentItem = item
-            
-            // Build breadcrumbs
-            breadcrumbs.push({ title: tab.title, href: `/${tab.slug}` })
-            breadcrumbs.push({ title: group.title, href: '#' })
-            breadcrumbs.push({ title: item.title, href: item.href })
-          }
-        }
-      }
-    }
-  }
-  
-  // Search in groups (non-tabbed)
-  if (navigation.groups) {
-    for (const group of navigation.groups) {
-      const groupItems = collectNavItems(group.items)
-      allItems.push(...groupItems)
-      
-      for (const item of groupItems) {
-        if (item.href === normalizedPath) {
-          currentGroup = group
-          currentItem = item
-          
-          // Build breadcrumbs
-          breadcrumbs.push({ title: group.title, href: '#' })
-          breadcrumbs.push({ title: item.title, href: item.href })
-        }
-      }
-    }
-  }
-  
-  // Find prev/next
-  const currentIndex = allItems.findIndex(item => item.href === normalizedPath)
-  if (currentIndex > 0) {
-    prev = allItems[currentIndex - 1]
-  }
-  if (currentIndex >= 0 && currentIndex < allItems.length - 1) {
-    next = allItems[currentIndex + 1]
-  }
-  
-  return {
-    breadcrumbs,
-    prev,
-    next,
-    currentTab,
-    currentGroup,
-    currentItem,
-  }
-}
-
-/**
- * Get all page paths from navigation
- */
-export function getAllPagePaths(navigation: Navigation): string[] {
-  const paths: string[] = []
-  
-  if (navigation.tabs) {
-    for (const tab of navigation.tabs) {
-      for (const group of tab.groups) {
-        const items = collectNavItems(group.items)
-        for (const item of items) {
-          if (!item.external) {
-            paths.push(item.href)
-          }
-        }
-      }
-    }
-  }
-  
-  if (navigation.groups) {
-    for (const group of navigation.groups) {
-      const items = collectNavItems(group.items)
-      for (const item of items) {
-        if (!item.external) {
-          paths.push(item.href)
-        }
-      }
-    }
-  }
-  
-  return paths
-}
-
-/**
- * Load page metadata from file
- */
-export function loadPageMeta(
-  filePath: string,
-  docsDir: string
-): PageMeta | null {
-  try {
-    const content = loadPageContent(filePath)
-    const { data } = extractFrontmatter(content)
-    const frontmatter = safeParseFrontmatter(data)
-    
-    // Calculate URL path from file path
-    const relativePath = relative(docsDir, filePath)
-    const urlPath = '/' + relativePath
-      .replace(/\.(mdx?|md)$/, '')
-      .replace(/\/index$/, '')
-      .replace(/^index$/, '')
-    
-    return {
-      filePath: relativePath,
-      urlPath: urlPath || '/',
-      title: frontmatter?.title || basename(filePath, extname(filePath)),
-      description: frontmatter?.description,
-      sidebarTitle: frontmatter?.sidebarTitle,
-      icon: frontmatter?.icon,
-      hidden: frontmatter?.hidden,
-    }
-  } catch {
-    return null
-  }
-}

package/renderer/lib/docs/navigation/index.ts

@@ -1,12 +0,0 @@
-/**
- * Navigation Module Exports
- */
-
-export * from './types'
-
-export {
-  generateNavigation,
-  findPageNavContext,
-  getAllPagePaths,
-  loadPageMeta,
-} from './generator'

package/renderer/lib/docs/navigation/types.ts

@@ -1,123 +0,0 @@
-/**
- * Navigation Types
- * 
- * Types for the documentation navigation system
- */
-
-/**
- * A navigation item representing a single page
- */
-export interface NavItem {
-  /** Display title */
-  title: string
-  /** URL path to the page */
-  href: string
-  /** Icon name (Phosphor icons) */
-  icon?: string
-  /** Whether the page is marked as deprecated */
-  deprecated?: boolean
-  /** Whether this is an external link */
-  external?: boolean
-  /** Optional badge text */
-  badge?: string
-}
-
-/**
- * A group of navigation items
- */
-export interface NavGroup {
-  /** Group title */
-  title: string
-  /** Icon for the group */
-  icon?: string
-  /** Pages in this group (can include nested groups) */
-  items: (NavItem | NavGroup)[]
-  /** Whether the group is collapsible */
-  collapsible?: boolean
-  /** Default collapsed state */
-  defaultCollapsed?: boolean
-}
-
-/**
- * A navigation tab (top-level section)
- */
-export interface NavTab {
-  /** Tab title */
-  title: string
-  /** URL segment for this tab */
-  slug: string
-  /** Groups within this tab */
-  groups: NavGroup[]
-  /** Icon for the tab */
-  icon?: string
-}
-
-/**
- * Complete navigation structure
- */
-export interface Navigation {
-  /** Navigation tabs (if using tabbed navigation) */
-  tabs?: NavTab[]
-  /** Groups (if using single-page navigation) */
-  groups?: NavGroup[]
-  /** Global anchors (shown on all pages) */
-  anchors?: NavItem[]
-}
-
-/**
- * Breadcrumb item
- */
-export interface BreadcrumbItem {
-  title: string
-  href: string
-}
-
-/**
- * Page navigation context
- */
-export interface PageNavContext {
-  /** Current page's breadcrumbs */
-  breadcrumbs: BreadcrumbItem[]
-  /** Previous page in navigation */
-  prev?: NavItem
-  /** Next page in navigation */
-  next?: NavItem
-  /** Current tab (if using tabs) */
-  currentTab?: NavTab
-  /** Current group */
-  currentGroup?: NavGroup
-  /** Current item */
-  currentItem?: NavItem
-}
-
-/**
- * Table of contents item (from page headings)
- */
-export interface TocItem {
-  id: string
-  title: string
-  level: number
-  children?: TocItem[]
-}
-
-/**
- * Page metadata for navigation
- */
-export interface PageMeta {
-  /** File path relative to content directory */
-  filePath: string
-  /** URL path */
-  urlPath: string
-  /** Page title from frontmatter */
-  title: string
-  /** Page description */
-  description?: string
-  /** Sidebar title (shorter) */
-  sidebarTitle?: string
-  /** Icon name */
-  icon?: string
-  /** Whether the page is hidden from navigation */
-  hidden?: boolean
-  /** Page order within group */
-  order?: number
-}

package/renderer/lib/docs-navigation-context.tsx

@@ -1,80 +0,0 @@
-'use client'
-
-import React, { createContext, useContext, useCallback } from 'react'
-
-/**
- * Docs Navigation Context
- * 
- * Provides navigation functions for doc components (like Card) to use
- * the correct navigation method based on the current view.
- * 
- * In ApiDocs view: Uses hash-based navigation
- * In standalone /docs view: Uses Next.js router
- */
-
-interface DocsNavigationContextValue {
-  // Navigate to a doc page by slug
-  navigateToPage: (slug: string) => void
-  // Navigate to an endpoint by ID
-  navigateToEndpoint: (endpointId: string) => void
-  // Switch to a different tab
-  switchToTab: (tabId: string) => void
-  // Check if we're in the integrated ApiDocs view
-  isApiDocsView: boolean
-  // Current active tab
-  activeTab?: string
-}
-
-const DocsNavigationContext = createContext<DocsNavigationContextValue | null>(null)
-
-interface DocsNavigationProviderProps {
-  children: React.ReactNode
-  onNavigateToPage?: (slug: string) => void
-  onNavigateToEndpoint?: (endpointId: string) => void
-  onSwitchTab?: (tabId: string) => void
-  activeTab?: string
-}
-
-export function DocsNavigationProvider({ 
-  children, 
-  onNavigateToPage,
-  onNavigateToEndpoint,
-  onSwitchTab,
-  activeTab,
-}: DocsNavigationProviderProps) {
-  const navigateToPage = useCallback((slug: string) => {
-    if (onNavigateToPage) {
-      onNavigateToPage(slug)
-    }
-  }, [onNavigateToPage])
-
-  const navigateToEndpoint = useCallback((endpointId: string) => {
-    if (onNavigateToEndpoint) {
-      onNavigateToEndpoint(endpointId)
-    }
-  }, [onNavigateToEndpoint])
-
-  const switchToTab = useCallback((tabId: string) => {
-    if (onSwitchTab) {
-      onSwitchTab(tabId)
-    }
-  }, [onSwitchTab])
-
-  return (
-    <DocsNavigationContext.Provider 
-      value={{ 
-        navigateToPage, 
-        navigateToEndpoint, 
-        switchToTab,
-        isApiDocsView: !!onNavigateToPage,
-        activeTab,
-      }}
-    >
-      {children}
-    </DocsNavigationContext.Provider>
-  )
-}
-
-export function useDocsNavigation() {
-  return useContext(DocsNavigationContext)
-}

package/renderer/lib/multi-tenant/context.ts

@@ -1,105 +0,0 @@
-/**
- * Multi-tenant project context utilities
- * Handles extracting project slug from hostname and managing project context
- */
-
-export interface ProjectContext {
-  slug: string
-  isMultiTenant: boolean
-  hostname: string
-}
-
-/**
- * Known hostnames that should use local file system (not multi-tenant)
- */
-const LOCAL_HOSTNAMES = [
-  'localhost',
-  '127.0.0.1',
-  '0.0.0.0',
-]
-
-/**
- * The main platform domain
- */
-const PLATFORM_DOMAIN = process.env.DEVDOC_PLATFORM_DOMAIN || 'devdoc.sh'
-
-/**
- * Extract project context from hostname
- * 
- * Examples:
- * - my-docs.devdoc.sh -> { slug: 'my-docs', isMultiTenant: true }
- * - localhost:3000 -> { slug: null, isMultiTenant: false }
- * - docs.company.com -> { slug: lookup from custom domains, isMultiTenant: true }
- */
-export function extractProjectContext(hostname: string): ProjectContext {
-  // Remove port if present
-  const host = hostname.split(':')[0]
-  
-  // Check if it's a local development hostname
-  if (LOCAL_HOSTNAMES.includes(host)) {
-    return {
-      slug: '',
-      isMultiTenant: false,
-      hostname: host,
-    }
-  }
-  
-  // Check if it's a subdomain of the platform domain
-  if (host.endsWith(`.${PLATFORM_DOMAIN}`)) {
-    const slug = host.replace(`.${PLATFORM_DOMAIN}`, '')
-    return {
-      slug,
-      isMultiTenant: true,
-      hostname: host,
-    }
-  }
-  
-  // Check if it's the main platform domain
-  if (host === PLATFORM_DOMAIN || host === `www.${PLATFORM_DOMAIN}`) {
-    return {
-      slug: '',
-      isMultiTenant: false,
-      hostname: host,
-    }
-  }
-  
-  // Custom domain - need to lookup in database
-  // For now, return the full hostname as slug placeholder
-  // This will be resolved via the domains API
-  return {
-    slug: host, // Will be resolved to actual slug via custom domains lookup
-    isMultiTenant: true,
-    hostname: host,
-  }
-}
-
-/**
- * Check if running in multi-tenant mode
- */
-export function isMultiTenantMode(): boolean {
-  return process.env.MULTI_TENANT_MODE === 'true'
-}
-
-/**
- * Get the current project slug from environment or context
- */
-export function getCurrentProjectSlug(): string | null {
-  return process.env.DEVDOC_PROJECT_SLUG || null
-}
-
-/**
- * Build the URL for a project's docs
- */
-export function getProjectUrl(slug: string): string {
-  const protocol = process.env.NODE_ENV === 'production' ? 'https' : 'http'
-  return `${protocol}://${slug}.${PLATFORM_DOMAIN}`
-}
-
-/**
- * Validate a project slug format
- */
-export function isValidSlug(slug: string): boolean {
-  // Must be lowercase alphanumeric with hyphens, 3-50 chars
-  const slugRegex = /^[a-z0-9][a-z0-9-]{1,48}[a-z0-9]$/
-  return slugRegex.test(slug)
-}