@brainfish-ai/devdoc 0.1.42 → 0.1.44

package/renderer/components/ui/spinner.js

@@ -0,0 +1,92 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from "@/lib/utils";
+import { CircleNotch } from "@phosphor-icons/react";
+import { useEffect, useState } from "react";
+export function Spinner({ size = "md", className }) {
+    const sizeClasses = {
+        sm: "h-4 w-4",
+        md: "h-6 w-6",
+        lg: "h-8 w-8"
+    };
+    return /*#__PURE__*/ _jsx(CircleNotch, {
+        className: cn("animate-spin text-primary", sizeClasses[size], className)
+    });
+}
+const loadingMessages = [
+    "Loading API documentation...",
+    "Fetching endpoint specifications...",
+    "Preparing interactive documentation...",
+    "Compiling API reference...",
+    "Initializing documentation viewer...",
+    "Loading schema definitions...",
+    "Rendering API endpoints...",
+    "Setting up interactive examples...",
+    "Organizing API methods...",
+    "Building comprehensive docs...",
+    "Configuring API explorer...",
+    "Loading request/response models..."
+];
+export function LoadingSpinner({ message = "Loading...", className, dynamicText = false }) {
+    const [currentMessage, setCurrentMessage] = useState(message);
+    useEffect(()=>{
+        if (!dynamicText) {
+            setCurrentMessage(message);
+            return;
+        }
+        // Initialize with a random message
+        const initialIndex = Math.floor(Math.random() * loadingMessages.length);
+        setCurrentMessage(loadingMessages[initialIndex]);
+        const messageInterval = setInterval(()=>{
+            setCurrentMessage((prevMessage)=>{
+                const currentIndex = loadingMessages.indexOf(prevMessage);
+                const nextIndex = (currentIndex + 1) % loadingMessages.length;
+                return loadingMessages[nextIndex];
+            });
+        }, 2000) // Change message every 2 seconds
+        ;
+        return ()=>{
+            clearInterval(messageInterval);
+        };
+    }, [
+        dynamicText,
+        message
+    ]);
+    return /*#__PURE__*/ _jsxs("div", {
+        className: cn("flex flex-col items-center justify-center space-y-6", className),
+        children: [
+            /*#__PURE__*/ _jsxs("div", {
+                className: "relative",
+                children: [
+                    /*#__PURE__*/ _jsx(Spinner, {
+                        size: "lg",
+                        className: "drop-shadow-sm"
+                    }),
+                    /*#__PURE__*/ _jsx("div", {
+                        className: "absolute inset-0 bg-primary/10 rounded-full blur-lg scale-150 animate-pulse"
+                    })
+                ]
+            }),
+            /*#__PURE__*/ _jsxs("div", {
+                className: "text-center max-w-xs",
+                children: [
+                    /*#__PURE__*/ _jsx("p", {
+                        className: "text-sm text-muted-foreground animate-in fade-in-0 duration-500 font-medium",
+                        children: currentMessage
+                    }, currentMessage),
+                    dynamicText && /*#__PURE__*/ _jsx("div", {
+                        className: "flex justify-center mt-3 space-x-1",
+                        children: [
+                            ...Array(3)
+                        ].map((_, i)=>/*#__PURE__*/ _jsx("div", {
+                                className: "w-1 h-1 bg-primary/60 rounded-full animate-pulse",
+                                style: {
+                                    animationDelay: `${i * 0.3}s`,
+                                    animationDuration: '1.8s'
+                                }
+                            }, i))
+                    })
+                ]
+            })
+        ]
+    });
+}

package/renderer/components/ui/tabs.js

@@ -0,0 +1,34 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import * as React from "react";
+import * as TabsPrimitive from "@radix-ui/react-tabs";
+import { cn } from "@/lib/utils";
+function Tabs({ className, ...props }) {
+    return /*#__PURE__*/ _jsx(TabsPrimitive.Root, {
+        "data-slot": "tabs",
+        className: cn("flex flex-col gap-2", className),
+        ...props
+    });
+}
+function TabsList({ className, ...props }) {
+    return /*#__PURE__*/ _jsx(TabsPrimitive.List, {
+        "data-slot": "tabs-list",
+        className: cn("bg-muted text-muted-foreground inline-flex h-9 w-fit items-center justify-center rounded-sm p-[3px]", className),
+        ...props
+    });
+}
+function TabsTrigger({ className, ...props }) {
+    return /*#__PURE__*/ _jsx(TabsPrimitive.Trigger, {
+        "data-slot": "tabs-trigger",
+        className: cn("data-[state=active]:bg-background dark:data-[state=active]:text-foreground focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:outline-ring dark:data-[state=active]:border-input dark:data-[state=active]:bg-input/30 text-foreground dark:text-muted-foreground inline-flex h-[calc(100%-1px)] flex-1 items-center justify-center gap-1.5 rounded-sm border border-transparent px-2 py-1 text-sm font-medium whitespace-nowrap transition-[color,box-shadow] focus-visible:ring-[3px] focus-visible:outline-1 disabled:pointer-events-none disabled:opacity-50 data-[state=active]:shadow-sm [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4", className),
+        ...props
+    });
+}
+function TabsContent({ className, ...props }) {
+    return /*#__PURE__*/ _jsx(TabsPrimitive.Content, {
+        "data-slot": "tabs-content",
+        className: cn("flex-1 outline-none", className),
+        ...props
+    });
+}
+export { Tabs, TabsList, TabsTrigger, TabsContent };

package/renderer/components/ui/tooltip.js

@@ -0,0 +1,43 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import * as TooltipPrimitive from "@radix-ui/react-tooltip";
+import { cn } from "@/lib/utils";
+function TooltipProvider({ delayDuration = 0, ...props }) {
+    return /*#__PURE__*/ _jsx(TooltipPrimitive.Provider, {
+        "data-slot": "tooltip-provider",
+        delayDuration: delayDuration,
+        ...props
+    });
+}
+function Tooltip({ ...props }) {
+    return /*#__PURE__*/ _jsx(TooltipProvider, {
+        children: /*#__PURE__*/ _jsx(TooltipPrimitive.Root, {
+            "data-slot": "tooltip",
+            ...props
+        })
+    });
+}
+function TooltipTrigger({ ...props }) {
+    return /*#__PURE__*/ _jsx(TooltipPrimitive.Trigger, {
+        "data-slot": "tooltip-trigger",
+        ...props
+    });
+}
+function TooltipContent({ className, sideOffset = 0, children, ...props }) {
+    return /*#__PURE__*/ _jsx(TooltipPrimitive.Portal, {
+        children: /*#__PURE__*/ _jsxs(TooltipPrimitive.Content, {
+            "data-slot": "tooltip-content",
+            sideOffset: sideOffset,
+            className: cn("bg-foreground text-background animate-in fade-in-0 zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 w-fit origin-(--radix-tooltip-content-transform-origin) rounded-sm px-3 py-1.5 text-xs text-balance", className),
+            ...props,
+            children: [
+                children,
+                /*#__PURE__*/ _jsx(TooltipPrimitive.Arrow, {
+                    className: "bg-foreground fill-foreground z-50 size-2.5 translate-y-[calc(-50%_-_2px)] rotate-45 rounded-[2px]"
+                })
+            ]
+        })
+    });
+}
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };

package/renderer/hooks/use-code-copy.js

@@ -0,0 +1,76 @@
+'use client';
+import { useEffect } from 'react';
+/**
+ * Hook to add copy buttons to rehype-pretty-code figures
+ * This enhances static code blocks with interactive copy functionality
+ */ export function useCodeCopy(containerRef, deps = []) {
+    useEffect(()=>{
+        if (!containerRef.current) return;
+        // Small delay to ensure content is rendered
+        const timeoutId = setTimeout(()=>{
+            if (!containerRef.current) return;
+            const figures = containerRef.current.querySelectorAll('[data-rehype-pretty-code-figure]');
+            figures.forEach((figure)=>{
+                // Skip if already has a copy button
+                if (figure.querySelector('.code-copy-button')) return;
+                const title = figure.querySelector('[data-rehype-pretty-code-title]');
+                const pre = figure.querySelector('pre');
+                const code = pre?.querySelector('code');
+                if (!pre || !code) return;
+                // Create copy button
+                const button = document.createElement('button');
+                button.type = 'button';
+                button.className = 'code-copy-button';
+                button.title = 'Copy code';
+                button.innerHTML = `
+          <svg class="copy-icon" xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" viewBox="0 0 256 256">
+            <path d="M216,32H88a8,8,0,0,0-8,8V80H40a8,8,0,0,0-8,8V216a8,8,0,0,0,8,8H168a8,8,0,0,0,8-8V176h40a8,8,0,0,0,8-8V40A8,8,0,0,0,216,32ZM160,208H48V96H160Zm48-48H176V88a8,8,0,0,0-8-8H96V48H208Z"></path>
+          </svg>
+          <svg class="check-icon" xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" viewBox="0 0 256 256" style="display:none;">
+            <path d="M229.66,77.66l-128,128a8,8,0,0,1-11.32,0l-56-56a8,8,0,0,1,11.32-11.32L96,188.69,218.34,66.34a8,8,0,0,1,11.32,11.32Z"></path>
+          </svg>
+        `;
+                button.addEventListener('click', async ()=>{
+                    const text = code.textContent || '';
+                    try {
+                        await navigator.clipboard.writeText(text);
+                        // Show check icon
+                        const copyIcon = button.querySelector('.copy-icon');
+                        const checkIcon = button.querySelector('.check-icon');
+                        if (copyIcon && checkIcon) {
+                            copyIcon.style.display = 'none';
+                            checkIcon.style.display = 'block';
+                            checkIcon.style.color = 'rgb(16, 185, 129)';
+                            setTimeout(()=>{
+                                copyIcon.style.display = 'block';
+                                checkIcon.style.display = 'none';
+                            }, 2000);
+                        }
+                    } catch (err) {
+                        console.error('Failed to copy:', err);
+                    }
+                });
+                // If there's a title, add button to header area
+                if (title) {
+                    // Create a wrapper for the header content
+                    const headerWrapper = document.createElement('div');
+                    headerWrapper.className = 'code-header-wrapper';
+                    // Move title into wrapper
+                    title.parentNode?.insertBefore(headerWrapper, title);
+                    headerWrapper.appendChild(title);
+                    headerWrapper.appendChild(button);
+                } else {
+                    // For code blocks without title, add button to pre
+                    pre.style.position = 'relative';
+                    button.classList.add('code-copy-button-floating');
+                    pre.appendChild(button);
+                }
+            });
+        }, 100);
+        return ()=>clearTimeout(timeoutId);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [
+        containerRef,
+        ...deps
+    ]);
+}

package/renderer/hooks/use-openapi-title.js

@@ -0,0 +1,33 @@
+'use client';
+import { useState, useEffect } from 'react';
+export function useOpenApiTitle() {
+    const [title, setTitle] = useState('API Documentation');
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    useEffect(()=>{
+        async function fetchTitle() {
+            try {
+                setLoading(true);
+                const response = await fetch('/api/openapi-spec');
+                if (!response.ok) {
+                    throw new Error(`Failed to fetch OpenAPI spec: ${response.status}`);
+                }
+                const spec = await response.json();
+                setTitle(spec.info.title || 'API Documentation');
+                setError(null);
+            } catch (err) {
+                console.error('Error fetching OpenAPI title:', err);
+                setError(err instanceof Error ? err.message : 'Unknown error');
+                setTitle('API Documentation'); // Fallback title
+            } finally{
+                setLoading(false);
+            }
+        }
+        fetchTitle();
+    }, []);
+    return {
+        title,
+        loading,
+        error
+    };
+}

package/renderer/hooks/use-route-state.js

@@ -0,0 +1,159 @@
+'use client';
+import { useState, useEffect, useCallback, useMemo } from 'react';
+/**
+ * Parse URL hash into route state
+ * 
+ * URL Schema:
+ * - #tab                              → Tab only, show default content (docs view)
+ * - #tab/page/{slug}                  → Doc page (docs view)
+ * - #tab/endpoint/{id}                → API endpoint (docs view)
+ * - #tab/endpoint/{id}/playground     → API endpoint (playground view)
+ * - #tab/endpoint/{id}/notes          → API endpoint (notes view)
+ * - #tab/page/{slug}/notes            → Doc page (notes view)
+ */ function parseHash(hash) {
+    // Remove leading # if present
+    const cleanHash = hash.startsWith('#') ? hash.slice(1) : hash;
+    // Default state
+    const defaultState = {
+        tab: null,
+        contentType: null,
+        contentId: null,
+        view: 'docs',
+        hash: cleanHash
+    };
+    if (!cleanHash) {
+        return defaultState;
+    }
+    // Split hash into parts: tab/type/id[/view]
+    const parts = cleanHash.split('/');
+    const tab = parts[0] || null;
+    const type = parts[1] || null;
+    // Check if last part is a view mode
+    const lastPart = parts[parts.length - 1];
+    const isViewSuffix = lastPart === 'playground' || lastPart === 'notes';
+    const view = isViewSuffix ? lastPart : 'docs';
+    // Get ID (everything between type and view, or type and end)
+    const idParts = isViewSuffix ? parts.slice(2, -1) : parts.slice(2);
+    const id = idParts.join('/') || null;
+    // Parse content type
+    let contentType = null;
+    if (type === 'endpoint') {
+        contentType = 'endpoint';
+    } else if (type === 'page') {
+        contentType = 'page';
+    } else if (type === 'section') {
+        contentType = 'section';
+    }
+    return {
+        tab,
+        contentType,
+        contentId: id,
+        view,
+        hash: cleanHash
+    };
+}
+/**
+ * Get the current hash from window.location
+ */ function getCurrentHash() {
+    if (typeof window === 'undefined') return '';
+    return window.location.hash;
+}
+/**
+ * Hook that provides URL-based route state
+ * 
+ * This hook is the single source of truth for page/content selection.
+ * It automatically updates when the URL hash changes (via navigation or browser back/forward).
+ * 
+ * @example
+ * const { tab, contentType, contentId } = useRouteState()
+ * 
+ * // Render based on content type
+ * if (contentType === 'page') {
+ *   return <DocPage slug={contentId} />
+ * }
+ */ export function useRouteState() {
+    const [hash, setHash] = useState(()=>getCurrentHash());
+    // Parse hash into route state
+    const state = useMemo(()=>parseHash(hash), [
+        hash
+    ]);
+    // Listen for hash changes
+    useEffect(()=>{
+        const handleHashChange = ()=>{
+            setHash(getCurrentHash());
+        };
+        // Listen for both hashchange and popstate (browser back/forward)
+        window.addEventListener('hashchange', handleHashChange);
+        window.addEventListener('popstate', handleHashChange);
+        // Set initial hash (in case it was set before this effect ran)
+        handleHashChange();
+        return ()=>{
+            window.removeEventListener('hashchange', handleHashChange);
+            window.removeEventListener('popstate', handleHashChange);
+        };
+    }, []);
+    return state;
+}
+/**
+ * Hook that provides navigation functions for updating the URL
+ * 
+ * @param defaultTab - Default tab to use when navigating
+ * @returns Navigation functions
+ */ export function useRouteNavigation(defaultTab) {
+    const navigateToPage = useCallback((slug, tab, view)=>{
+        const targetTab = tab || defaultTab || '';
+        const viewSuffix = view && view !== 'docs' ? `/${view}` : '';
+        window.location.hash = targetTab ? `${targetTab}/page/${slug}${viewSuffix}` : `page/${slug}${viewSuffix}`;
+    }, [
+        defaultTab
+    ]);
+    const navigateToEndpoint = useCallback((id, tab, view)=>{
+        const targetTab = tab || defaultTab || '';
+        const viewSuffix = view && view !== 'docs' ? `/${view}` : '';
+        window.location.hash = targetTab ? `${targetTab}/endpoint/${id}${viewSuffix}` : `endpoint/${id}${viewSuffix}`;
+    }, [
+        defaultTab
+    ]);
+    const navigateToSection = useCallback((sectionId, tab)=>{
+        const targetTab = tab || defaultTab || '';
+        window.location.hash = targetTab ? `${targetTab}/section/${sectionId}` : `section/${sectionId}`;
+    }, [
+        defaultTab
+    ]);
+    const navigateToTab = useCallback((tab)=>{
+        window.location.hash = tab;
+    }, []);
+    const clearSelection = useCallback((tab)=>{
+        const targetTab = tab || defaultTab;
+        if (targetTab) {
+            window.location.hash = targetTab;
+        } else {
+            // Remove hash entirely
+            window.history.pushState(null, '', window.location.pathname + window.location.search);
+        }
+    }, [
+        defaultTab
+    ]);
+    return {
+        navigateToPage,
+        navigateToEndpoint,
+        navigateToSection,
+        navigateToTab,
+        clearSelection
+    };
+}
+/**
+ * Utility to build hash URLs (for href attributes)
+ */ export const buildHashUrl = {
+    page: (tab, slug, view)=>{
+        const viewSuffix = view && view !== 'docs' ? `/${view}` : '';
+        return `#${tab}/page/${slug}${viewSuffix}`;
+    },
+    endpoint: (tab, id, view)=>{
+        const viewSuffix = view && view !== 'docs' ? `/${view}` : '';
+        return `#${tab}/endpoint/${id}${viewSuffix}`;
+    },
+    section: (tab, sectionId)=>`#${tab}/section/${sectionId}`,
+    tab: (tab)=>`#${tab}`
+};
+export { parseHash };

package/renderer/lib/api-docs/agent/index.js

@@ -0,0 +1,4 @@
+/**
+ * Agent Module Exports
+ */ export * from './types';
+export * from './indexer';