@brainfish-ai/devdoc 0.1.21

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

@@ -0,0 +1,123 @@
+/**
+ * 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

@@ -0,0 +1,80 @@
+'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

@@ -0,0 +1,105 @@
+/**
+ * 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)
+}