@brainfish-ai/devdoc 0.1.42 → 0.1.44

package/renderer/components/docs-viewer/content/doc-page.js

@@ -0,0 +1,290 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState, useCallback, useRef } from 'react';
+import { Spinner } from '@phosphor-icons/react';
+import { MDXRemote } from 'next-mdx-remote';
+import { useDocsNavigation } from '@/lib/docs-navigation-context';
+import { useCodeCopy } from '@/hooks/use-code-copy';
+import { NotFoundPage } from './not-found-page';
+// Custom Link component for MDX - uses docs navigation context
+function MdxLink({ href, children, ...props }) {
+    const docsNav = useDocsNavigation();
+    const handleClick = useCallback((e)=>{
+        // Handle anchor links (same page)
+        if (href?.startsWith('#')) {
+            return; // Let default behavior handle anchor scrolling
+        }
+        // Handle internal doc links
+        if (href?.startsWith('/') && docsNav?.isApiDocsView) {
+            e.preventDefault();
+            // Extract the slug from the path
+            let slug = href;
+            // Remove leading slash
+            if (slug.startsWith('/')) {
+                slug = slug.slice(1);
+            }
+            // Handle special paths
+            if (slug.startsWith('api-reference')) {
+                docsNav.switchToTab('api-reference');
+                return;
+            }
+            if (slug.startsWith('changelog')) {
+                docsNav.switchToTab('changelog');
+                return;
+            }
+            // Remove docs/ prefix if present
+            if (slug.startsWith('docs/')) {
+                slug = slug.slice(5);
+            }
+            // Navigate to the page
+            docsNav.navigateToPage(slug);
+        }
+    }, [
+        href,
+        docsNav
+    ]);
+    // Determine link styling - better visibility and accessibility
+    // Using visited: to override browser's purple visited link color
+    const linkClassName = "text-primary visited:text-primary font-medium underline decoration-primary/30 underline-offset-2 hover:decoration-primary transition-colors";
+    // External links
+    if (href && !href.startsWith('/') && !href.startsWith('#')) {
+        return /*#__PURE__*/ _jsx("a", {
+            href: href,
+            target: "_blank",
+            rel: "noopener noreferrer",
+            className: linkClassName,
+            ...props,
+            children: children
+        });
+    }
+    return /*#__PURE__*/ _jsx("a", {
+        href: href,
+        onClick: handleClick,
+        className: linkClassName,
+        ...props,
+        children: children
+    });
+}
+// Import MDX components
+import { Note, Warning, Info, Tip, Check, Error as ErrorCallout, Callout, Card, CardGroup, Accordion, AccordionGroup, Steps, Step, Tabs, Tab, CodeGroup, Frame, Columns, Snippet, Latex, ParamField, ResponseField, Expandable, Iframe, Video, Loom, Image, Screenshot, Logo, Icon, Highlight, Marker, Underline, Badge, Mermaid, PDF, Audio, Download, // Landing Page Components
+Hero, Pre, Tagline, Headline, Description, CommandBox, Section, Center, FeatureGrid, FeatureItem, ButtonLink, Spacer, Divider } from '../../docs/mdx/index';
+// MDX components mapping
+const mdxComponents = {
+    // Callouts
+    Note,
+    Warning,
+    Info,
+    Tip,
+    Check,
+    Error: ErrorCallout,
+    Callout,
+    // Cards
+    Card,
+    CardGroup,
+    // Accordion
+    Accordion,
+    AccordionGroup,
+    // Steps
+    Steps,
+    Step,
+    // Tabs
+    Tabs,
+    Tab,
+    // Code
+    CodeGroup,
+    // Layout
+    Frame,
+    Columns,
+    Snippet,
+    Latex,
+    // API docs
+    ParamField,
+    ResponseField,
+    Expandable,
+    // Embeds
+    Iframe,
+    Video,
+    Loom,
+    // Images
+    Image,
+    Screenshot,
+    Logo,
+    Icon,
+    // Highlight
+    Highlight,
+    Marker,
+    Underline,
+    // Badge
+    Badge,
+    // Mermaid
+    Mermaid,
+    // File Embeds
+    PDF,
+    Audio,
+    Download,
+    // Landing Page
+    Hero,
+    Pre,
+    Tagline,
+    Headline,
+    Description,
+    CommandBox,
+    Section,
+    Center,
+    FeatureGrid,
+    FeatureItem,
+    ButtonLink,
+    Spacer,
+    Divider,
+    // Links
+    a: MdxLink
+};
+export function DocPage({ slug, onSearch }) {
+    const [pageData, setPageData] = useState(null);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const [isNotFound, setIsNotFound] = useState(false);
+    const contentRef = useRef(null);
+    // Add copy buttons to code blocks after content loads
+    useCodeCopy(contentRef, [
+        pageData
+    ]);
+    useEffect(()=>{
+        async function fetchPage() {
+            try {
+                setLoading(true);
+                setError(null);
+                setIsNotFound(false);
+                const response = await fetch(`/api/docs?slug=${encodeURIComponent(slug)}`);
+                if (response.status === 404) {
+                    setIsNotFound(true);
+                    return;
+                }
+                if (!response.ok) {
+                    throw new Error('Failed to load page');
+                }
+                const data = await response.json();
+                setPageData(data);
+            } catch (err) {
+                console.error('Error loading doc page:', err);
+                setError(err instanceof Error ? err.message : 'Failed to load page');
+            } finally{
+                setLoading(false);
+            }
+        }
+        fetchPage();
+    }, [
+        slug
+    ]);
+    if (loading) {
+        return /*#__PURE__*/ _jsx("div", {
+            className: "docs-page docs-page-loading w-full min-h-[200px]",
+            children: /*#__PURE__*/ _jsx("div", {
+                className: "docs-loading flex items-center justify-center py-12",
+                children: /*#__PURE__*/ _jsx(Spinner, {
+                    className: "h-6 w-6 animate-spin text-muted-foreground"
+                })
+            })
+        });
+    }
+    // Show 404 page for not found errors
+    if (isNotFound) {
+        return /*#__PURE__*/ _jsx(NotFoundPage, {
+            slug: slug,
+            onSearch: onSearch
+        });
+    }
+    // Show generic error for other errors
+    if (error || !pageData) {
+        return /*#__PURE__*/ _jsx("div", {
+            className: "docs-page docs-page-error w-full min-h-[200px]",
+            children: /*#__PURE__*/ _jsx("div", {
+                className: "docs-error text-center py-12",
+                children: /*#__PURE__*/ _jsx("p", {
+                    className: "text-destructive",
+                    children: error || 'Failed to load page'
+                })
+            })
+        });
+    }
+    const { mode = 'default', hideHeader, fullWidth, background } = pageData.frontmatter;
+    const isCustomMode = mode === 'custom';
+    const isWideMode = mode === 'wide';
+    const showHeader = !hideHeader && !isCustomMode;
+    // Custom mode: Full-width layout for landing pages
+    if (isCustomMode) {
+        return /*#__PURE__*/ _jsx("div", {
+            ref: contentRef,
+            className: "docs-page docs-page-custom docs-content w-full min-h-full",
+            style: {
+                background: background || 'var(--background)',
+                // Ensure the content fills the entire viewport width within the content area
+                marginLeft: 0,
+                marginRight: 0
+            },
+            children: /*#__PURE__*/ _jsx("div", {
+                className: "docs-custom-content [&>*]:w-full",
+                children: /*#__PURE__*/ _jsx(MDXRemote, {
+                    ...pageData.mdxSource,
+                    components: mdxComponents
+                })
+            })
+        });
+    }
+    // Wide mode: No prose wrapper (for landing pages with custom components)
+    if (isWideMode) {
+        return /*#__PURE__*/ _jsxs("div", {
+            ref: contentRef,
+            className: "docs-page docs-content max-w-6xl mx-auto px-4 py-6 sm:px-8 sm:py-8",
+            children: [
+                showHeader && /*#__PURE__*/ _jsxs("div", {
+                    className: "docs-page-header mb-6",
+                    children: [
+                        /*#__PURE__*/ _jsx("h1", {
+                            className: "docs-content-title text-2xl sm:text-3xl font-bold mb-2 text-foreground",
+                            children: pageData.frontmatter.title
+                        }),
+                        pageData.frontmatter.description && /*#__PURE__*/ _jsx("p", {
+                            className: "docs-content-description text-lg text-muted-foreground",
+                            children: pageData.frontmatter.description
+                        })
+                    ]
+                }),
+                /*#__PURE__*/ _jsx("div", {
+                    className: "docs-wide-content",
+                    children: /*#__PURE__*/ _jsx(MDXRemote, {
+                        ...pageData.mdxSource,
+                        components: mdxComponents
+                    })
+                })
+            ]
+        });
+    }
+    // Default mode: Standard documentation layout with prose
+    return /*#__PURE__*/ _jsxs("div", {
+        ref: contentRef,
+        className: "docs-page docs-content max-w-4xl mx-auto px-4 py-6 sm:px-8 sm:py-8",
+        children: [
+            showHeader && /*#__PURE__*/ _jsxs("div", {
+                className: "docs-page-header mb-6",
+                children: [
+                    /*#__PURE__*/ _jsx("h1", {
+                        className: "docs-content-title text-2xl sm:text-3xl font-bold mb-2 text-foreground",
+                        children: pageData.frontmatter.title
+                    }),
+                    pageData.frontmatter.description && /*#__PURE__*/ _jsx("p", {
+                        className: "docs-content-description text-lg text-muted-foreground",
+                        children: pageData.frontmatter.description
+                    })
+                ]
+            }),
+            /*#__PURE__*/ _jsx("div", {
+                className: "docs-prose prose prose-sm max-w-none prose-headings:text-foreground prose-p:text-muted-foreground prose-strong:text-foreground prose-code:text-foreground prose-pre:bg-muted prose-code:bg-muted prose-code:px-1 prose-code:py-0.5 prose-code:rounded prose-pre:overflow-x-auto prose-table:w-full prose-th:text-left prose-th:p-3 prose-th:bg-muted prose-td:p-3 prose-td:border-b prose-td:border-border",
+                children: /*#__PURE__*/ _jsx(MDXRemote, {
+                    ...pageData.mdxSource,
+                    components: mdxComponents
+                })
+            })
+        ]
+    });
+}

package/renderer/components/docs-viewer/content/documentation-viewer.js

@@ -0,0 +1,14 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { MarkdownRenderer } from '../shared/markdown-renderer';
+export function DocumentationViewer({ content }) {
+    return /*#__PURE__*/ _jsx("div", {
+        className: "max-w-4xl mx-auto p-8",
+        children: /*#__PURE__*/ _jsx("div", {
+            className: "prose prose-sm max-w-none",
+            children: /*#__PURE__*/ _jsx(MarkdownRenderer, {
+                content: content
+            })
+        })
+    });
+}

package/renderer/components/docs-viewer/content/index.js

@@ -0,0 +1,31 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { RequestDetails } from './request-details';
+// Export ContentRouter for URL-based routing
+export { ContentRouter, findRequestById } from './content-router';
+export function ApiDocsContent({ request }) {
+    if (!request) {
+        return /*#__PURE__*/ _jsx("div", {
+            className: "flex-1 flex items-center justify-center bg-background",
+            children: /*#__PURE__*/ _jsxs("div", {
+                className: "text-center",
+                children: [
+                    /*#__PURE__*/ _jsx("p", {
+                        className: "text-muted-foreground text-lg mb-2",
+                        children: "Select an endpoint"
+                    }),
+                    /*#__PURE__*/ _jsx("p", {
+                        className: "text-sm text-muted-foreground",
+                        children: "Choose an endpoint from the sidebar to view its documentation"
+                    })
+                ]
+            })
+        });
+    }
+    return /*#__PURE__*/ _jsx("div", {
+        className: "flex-1 overflow-y-auto bg-background",
+        children: /*#__PURE__*/ _jsx(RequestDetails, {
+            request: request
+        })
+    });
+}

package/renderer/components/docs-viewer/content/not-found-page.js

@@ -0,0 +1,300 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState, useCallback, useRef } from 'react';
+import { FileX, House, ArrowLeft, MagnifyingGlass, Spinner } from '@phosphor-icons/react';
+import { Button } from '@/components/ui/button';
+import { useDocsNavigation } from '@/lib/docs-navigation-context';
+import { MDXRemote } from 'next-mdx-remote';
+import { useCodeCopy } from '@/hooks/use-code-copy';
+// Import MDX components for custom 404 pages
+import { Note, Warning, Info, Tip, Check, Error as ErrorCallout, Callout, Card, CardGroup, Accordion, AccordionGroup, Steps, Step, Tabs, Tab, CodeGroup, Frame, Columns, Snippet, Latex, ParamField, ResponseField, Expandable, Iframe, Video, Loom, Image, Screenshot, Logo, Icon, Highlight, Marker, Underline, Badge, Mermaid, PDF, Audio, Download, Hero, Pre, Tagline, Headline, Description, CommandBox, Section, Center, FeatureGrid, FeatureItem, ButtonLink, Spacer, Divider } from '../../docs/mdx/index';
+// MDX components mapping for custom 404 pages
+const mdxComponents = {
+    Note,
+    Warning,
+    Info,
+    Tip,
+    Check,
+    Error: ErrorCallout,
+    Callout,
+    Card,
+    CardGroup,
+    Accordion,
+    AccordionGroup,
+    Steps,
+    Step,
+    Tabs,
+    Tab,
+    CodeGroup,
+    Frame,
+    Columns,
+    Snippet,
+    Latex,
+    ParamField,
+    ResponseField,
+    Expandable,
+    Iframe,
+    Video,
+    Loom,
+    Image,
+    Screenshot,
+    Logo,
+    Icon,
+    Highlight,
+    Marker,
+    Underline,
+    Badge,
+    Mermaid,
+    PDF,
+    Audio,
+    Download,
+    Hero,
+    Pre,
+    Tagline,
+    Headline,
+    Description,
+    CommandBox,
+    Section,
+    Center,
+    FeatureGrid,
+    FeatureItem,
+    ButtonLink,
+    Spacer,
+    Divider
+};
+export function NotFoundPage({ slug, onGoBack, onSearch }) {
+    const docsNav = useDocsNavigation();
+    const [customPage, setCustomPage] = useState(null);
+    const [loading, setLoading] = useState(true);
+    const contentRef = useRef(null);
+    // Add copy buttons to code blocks after content loads
+    useCodeCopy(contentRef, [
+        customPage
+    ]);
+    // Try to load custom 404.mdx page
+    useEffect(()=>{
+        async function loadCustom404() {
+            try {
+                const response = await fetch('/api/docs?slug=404&is404=true');
+                if (response.ok) {
+                    const data = await response.json();
+                    setCustomPage(data);
+                }
+            } catch  {
+            // No custom 404 page, use default
+            } finally{
+                setLoading(false);
+            }
+        }
+        loadCustom404();
+    }, []);
+    const handleGoHome = useCallback(()=>{
+        // Navigate to the first page of the current tab or just switch to first tab
+        if (docsNav?.switchToTab) {
+            window.location.hash = '';
+            window.location.reload();
+        } else {
+            window.location.hash = '';
+        }
+    }, [
+        docsNav
+    ]);
+    const handleGoBack = useCallback(()=>{
+        if (onGoBack) {
+            onGoBack();
+        } else {
+            window.history.back();
+        }
+    }, [
+        onGoBack
+    ]);
+    // Show loading state briefly while checking for custom 404
+    if (loading) {
+        return /*#__PURE__*/ _jsx("div", {
+            className: "docs-page docs-page-not-found w-full min-h-[200px]",
+            children: /*#__PURE__*/ _jsx("div", {
+                className: "flex items-center justify-center py-12",
+                children: /*#__PURE__*/ _jsx(Spinner, {
+                    className: "h-6 w-6 animate-spin text-muted-foreground"
+                })
+            })
+        });
+    }
+    // Render custom 404 page if available
+    if (customPage) {
+        const { mode = 'default', hideHeader, background } = customPage.frontmatter;
+        const isCustomMode = mode === 'custom';
+        const showHeader = !hideHeader && !isCustomMode;
+        // Custom mode: Full-width layout
+        if (isCustomMode) {
+            return /*#__PURE__*/ _jsx("div", {
+                ref: contentRef,
+                className: "docs-page docs-page-not-found docs-content w-full min-h-full",
+                style: {
+                    background: background || 'var(--background)'
+                },
+                children: /*#__PURE__*/ _jsx("div", {
+                    className: "docs-custom-content [&>*]:w-full",
+                    children: /*#__PURE__*/ _jsx(MDXRemote, {
+                        ...customPage.mdxSource,
+                        components: mdxComponents
+                    })
+                })
+            });
+        }
+        // Default mode with optional header
+        const containerClass = mode === 'wide' ? 'max-w-6xl' : 'max-w-4xl';
+        return /*#__PURE__*/ _jsxs("div", {
+            ref: contentRef,
+            className: `docs-page docs-page-not-found docs-content ${containerClass} mx-auto px-4 py-6 sm:px-8 sm:py-8`,
+            children: [
+                showHeader && customPage.frontmatter.title && /*#__PURE__*/ _jsxs("div", {
+                    className: "docs-page-header mb-6",
+                    children: [
+                        /*#__PURE__*/ _jsx("h1", {
+                            className: "docs-content-title text-2xl sm:text-3xl font-bold mb-2 text-foreground",
+                            children: customPage.frontmatter.title
+                        }),
+                        customPage.frontmatter.description && /*#__PURE__*/ _jsx("p", {
+                            className: "docs-content-description text-lg text-muted-foreground",
+                            children: customPage.frontmatter.description
+                        })
+                    ]
+                }),
+                /*#__PURE__*/ _jsx("div", {
+                    className: "docs-prose prose prose-sm max-w-none prose-headings:text-foreground prose-p:text-muted-foreground prose-strong:text-foreground",
+                    children: /*#__PURE__*/ _jsx(MDXRemote, {
+                        ...customPage.mdxSource,
+                        components: mdxComponents
+                    })
+                }),
+                /*#__PURE__*/ _jsx("div", {
+                    className: "mt-8 pt-6 border-t border-border",
+                    children: /*#__PURE__*/ _jsxs("div", {
+                        className: "flex flex-col sm:flex-row items-center justify-center gap-3",
+                        children: [
+                            /*#__PURE__*/ _jsxs(Button, {
+                                variant: "outline",
+                                size: "sm",
+                                onClick: handleGoBack,
+                                className: "gap-2 min-w-[120px]",
+                                children: [
+                                    /*#__PURE__*/ _jsx(ArrowLeft, {
+                                        className: "w-4 h-4"
+                                    }),
+                                    "Go back"
+                                ]
+                            }),
+                            /*#__PURE__*/ _jsxs(Button, {
+                                variant: "default",
+                                size: "sm",
+                                onClick: handleGoHome,
+                                className: "gap-2 min-w-[120px]",
+                                children: [
+                                    /*#__PURE__*/ _jsx(House, {
+                                        className: "w-4 h-4"
+                                    }),
+                                    "Go home"
+                                ]
+                            }),
+                            onSearch && /*#__PURE__*/ _jsxs(Button, {
+                                variant: "outline",
+                                size: "sm",
+                                onClick: onSearch,
+                                className: "gap-2 min-w-[120px]",
+                                children: [
+                                    /*#__PURE__*/ _jsx(MagnifyingGlass, {
+                                        className: "w-4 h-4"
+                                    }),
+                                    "Search"
+                                ]
+                            })
+                        ]
+                    })
+                })
+            ]
+        });
+    }
+    // Default 404 page
+    return /*#__PURE__*/ _jsx("div", {
+        className: "docs-page docs-page-not-found w-full min-h-[calc(100vh-200px)] flex items-center justify-center",
+        children: /*#__PURE__*/ _jsxs("div", {
+            className: "text-center px-4 py-12 max-w-md mx-auto",
+            children: [
+                /*#__PURE__*/ _jsx("div", {
+                    className: "mb-6",
+                    children: /*#__PURE__*/ _jsx("div", {
+                        className: "inline-flex items-center justify-center w-20 h-20 rounded-full bg-muted/50 text-muted-foreground",
+                        children: /*#__PURE__*/ _jsx(FileX, {
+                            className: "w-10 h-10",
+                            weight: "light"
+                        })
+                    })
+                }),
+                /*#__PURE__*/ _jsx("h1", {
+                    className: "text-2xl font-semibold text-foreground mb-2",
+                    children: "Page not found"
+                }),
+                /*#__PURE__*/ _jsx("p", {
+                    className: "text-muted-foreground mb-2",
+                    children: "The page you're looking for doesn't exist or has been moved."
+                }),
+                slug && /*#__PURE__*/ _jsxs("p", {
+                    className: "text-sm text-muted-foreground/70 mb-6 font-mono bg-muted/30 px-3 py-1.5 rounded-md inline-block",
+                    children: [
+                        "/",
+                        slug
+                    ]
+                }),
+                !slug && /*#__PURE__*/ _jsx("div", {
+                    className: "mb-6"
+                }),
+                /*#__PURE__*/ _jsxs("div", {
+                    className: "flex flex-col sm:flex-row items-center justify-center gap-3",
+                    children: [
+                        /*#__PURE__*/ _jsxs(Button, {
+                            variant: "outline",
+                            size: "sm",
+                            onClick: handleGoBack,
+                            className: "gap-2 min-w-[120px]",
+                            children: [
+                                /*#__PURE__*/ _jsx(ArrowLeft, {
+                                    className: "w-4 h-4"
+                                }),
+                                "Go back"
+                            ]
+                        }),
+                        /*#__PURE__*/ _jsxs(Button, {
+                            variant: "default",
+                            size: "sm",
+                            onClick: handleGoHome,
+                            className: "gap-2 min-w-[120px]",
+                            children: [
+                                /*#__PURE__*/ _jsx(House, {
+                                    className: "w-4 h-4"
+                                }),
+                                "Go home"
+                            ]
+                        }),
+                        onSearch && /*#__PURE__*/ _jsxs(Button, {
+                            variant: "outline",
+                            size: "sm",
+                            onClick: onSearch,
+                            className: "gap-2 min-w-[120px]",
+                            children: [
+                                /*#__PURE__*/ _jsx(MagnifyingGlass, {
+                                    className: "w-4 h-4"
+                                }),
+                                "Search"
+                            ]
+                        })
+                    ]
+                }),
+                /*#__PURE__*/ _jsx("p", {
+                    className: "text-xs text-muted-foreground/60 mt-8",
+                    children: "If you believe this is an error, please check the URL or contact the documentation maintainer."
+                })
+            ]
+        })
+    });
+}