Merge remote-tracking branch 'upstream/main'

surfsense_web/components/chat/AnimatedEmptyState.tsx

@@ -1,45 +1,137 @@
 "use client";
+
 import { cn } from "@/lib/utils";
 import { Manrope } from "next/font/google";
-import React, { useRef, useEffect, useState } from "react";
+import React, { 
+  useRef, 
+  useEffect, 
+  useReducer, 
+  useMemo
+} from "react";
 import { RoughNotation, RoughNotationGroup } from "react-rough-notation";
 import { useInView } from "framer-motion";
 import { useSidebar } from "@/components/ui/sidebar";
 
-const manrope = Manrope({ subsets: ["latin"], weight: ["400", "700"] });
+// Font configuration - could be moved to a global font config file
+const manrope = Manrope({ 
+  subsets: ["latin"], 
+  weight: ["400", "700"],
+  display: "swap", // Optimize font loading
+  variable: "--font-manrope"
+});
+
+// Constants for timing - makes it easier to adjust and more maintainable
+const TIMING = {
+  SIDEBAR_TRANSITION: 300, // Wait for sidebar transition + buffer
+  LAYOUT_SETTLE: 100,      // Small delay to ensure layout is fully settled
+} as const;
+
+// Animation configuration
+const ANIMATION_CONFIG = {
+  HIGHLIGHT: {
+    type: "highlight" as const,
+    animationDuration: 2000,
+    iterations: 3,
+    color: "#3b82f680",
+    multiline: true,
+  },
+  UNDERLINE: {
+    type: "underline" as const,
+    animationDuration: 2000,
+    iterations: 3,
+    color: "#10b981",
+  },
+} as const;
+
+// State management with useReducer for better organization
+interface HighlightState {
+  shouldShowHighlight: boolean;
+  layoutStable: boolean;
+}
+
+type HighlightAction = 
+  | { type: "SIDEBAR_CHANGED" }
+  | { type: "LAYOUT_STABILIZED" }
+  | { type: "SHOW_HIGHLIGHT" }
+  | { type: "HIDE_HIGHLIGHT" };
+
+const highlightReducer = (
+  state: HighlightState, 
+  action: HighlightAction
+): HighlightState => {
+  switch (action.type) {
+    case "SIDEBAR_CHANGED":
+      return {
+        shouldShowHighlight: false,
+        layoutStable: false,
+      };
+    case "LAYOUT_STABILIZED":
+      return {
+        ...state,
+        layoutStable: true,
+      };
+    case "SHOW_HIGHLIGHT":
+      return {
+        ...state,
+        shouldShowHighlight: true,
+      };
+    case "HIDE_HIGHLIGHT":
+      return {
+        ...state,
+        shouldShowHighlight: false,
+      };
+    default:
+      return state;
+  }
+};
+
+const initialState: HighlightState = {
+  shouldShowHighlight: false,
+  layoutStable: true,
+};
 
 export function AnimatedEmptyState() {
-  const ref = useRef(null);
+  const ref = useRef<HTMLDivElement>(null);
   const isInView = useInView(ref);
-  const { state } = useSidebar();
+  const { state: sidebarState } = useSidebar();
-  const [shouldShowHighlight, setShouldShowHighlight] = useState(false);
+  const [{ shouldShowHighlight, layoutStable }, dispatch] = useReducer(
-  const [layoutStable, setLayoutStable] = useState(true);
+    highlightReducer,
+    initialState
+  );
 
-  // Track sidebar state changes and manage highlight visibility
+  // Memoize class names to prevent unnecessary recalculations
+  const headingClassName = useMemo(() => cn(
+    "text-3xl sm:text-4xl md:text-5xl lg:text-6xl font-bold tracking-tight text-neutral-900 dark:text-neutral-50 mb-6",
+    manrope.className,
+  ), []);
+
+  const paragraphClassName = useMemo(() => 
+    "text-lg sm:text-xl text-neutral-600 dark:text-neutral-300 mb-8 max-w-2xl mx-auto",
+  []);
+
+  // Handle sidebar state changes
   useEffect(() => {
-    // Set layout as unstable when sidebar state changes
+    dispatch({ type: "SIDEBAR_CHANGED" });
-    setLayoutStable(false);
-    setShouldShowHighlight(false);
 
-    // Wait for layout to stabilize after sidebar transition
     const stabilizeTimer = setTimeout(() => {
-      setLayoutStable(true);
+      dispatch({ type: "LAYOUT_STABILIZED" });
-    }, 300); // Wait for sidebar transition (200ms) + buffer
+    }, TIMING.SIDEBAR_TRANSITION);
 
     return () => clearTimeout(stabilizeTimer);
-  }, [state]);
+  }, [sidebarState]);
 
-  // Re-enable highlights after layout stabilizes and component is in view
+  // Handle highlight visibility based on layout stability and viewport visibility
   useEffect(() => {
-    if (layoutStable && isInView) {
+    if (!layoutStable || !isInView) {
-      const showTimer = setTimeout(() => {
+      dispatch({ type: "HIDE_HIGHLIGHT" });
-        setShouldShowHighlight(true);
+      return;
-      }, 100); // Small delay to ensure layout is fully settled
-
-      return () => clearTimeout(showTimer);
-    } else {
-      setShouldShowHighlight(false);
     }
+
+    const showTimer = setTimeout(() => {
+      dispatch({ type: "SHOW_HIGHLIGHT" });
+    }, TIMING.LAYOUT_SETTLE);
+
+    return () => clearTimeout(showTimer);
   }, [layoutStable, isInView]);
 
   return (
@@ -49,30 +141,14 @@ export function AnimatedEmptyState() {
     >
       <div className="max-w-4xl mx-auto px-4 py-10 text-center">
         <RoughNotationGroup show={shouldShowHighlight}>
-          <h1
+          <h1 className={headingClassName}>
-            className={cn(
+            <RoughNotation {...ANIMATION_CONFIG.HIGHLIGHT}>
-              "text-3xl sm:text-4xl md:text-5xl lg:text-6xl font-bold tracking-tight text-neutral-900 dark:text-neutral-50 mb-6",
-              manrope.className,
-            )}
-          >
-            <RoughNotation
-              type="highlight"
-              animationDuration={2000}
-              iterations={3}
-              color="#3b82f680"
-              multiline
-            >
               <span>SurfSense</span>
             </RoughNotation>
           </h1>
 
-          <p className="text-lg sm:text-xl text-neutral-600 dark:text-neutral-300 mb-8 max-w-2xl mx-auto">
+          <p className={paragraphClassName}>
-            <RoughNotation
+            <RoughNotation {...ANIMATION_CONFIG.UNDERLINE}>
-              type="underline"
-              animationDuration={2000}
-              iterations={3}
-              color="#10b981"
-            >
               Let's Start Surfing
             </RoughNotation>{" "}
             through your knowledge base.

surfsense_web/components/chat/ChatMessages.tsx

@@ -12,6 +12,9 @@ import ChatSourcesDisplay from "@/components/chat/ChatSources";
 import { CitationDisplay } from "@/components/chat/ChatCitation";
 import { ChatFurtherQuestions } from "@/components/chat/ChatFurtherQuestions";
 import { AnimatedEmptyState } from "@/components/chat/AnimatedEmptyState";
+import { languageRenderers } from "@/components/chat/CodeBlock";
+
+
 
 export function ChatMessagesUI() {
   const { messages } = useChatUI();
@@ -63,6 +66,7 @@ function ChatMessageUI({
           <LlamaIndexChatMessage.Content className="flex-1">
             <LlamaIndexChatMessage.Content.Markdown
               citationComponent={CitationDisplay}
+              languageRenderers={languageRenderers}
             />
           </LlamaIndexChatMessage.Content>
           <div ref={bottomRef} />
@@ -73,7 +77,9 @@ function ChatMessageUI({
         </div>
       ) : (
         <LlamaIndexChatMessage.Content className="flex-1">
-          <LlamaIndexChatMessage.Content.Markdown />
+          <LlamaIndexChatMessage.Content.Markdown 
+            languageRenderers={languageRenderers}
+          />
         </LlamaIndexChatMessage.Content>
       )}
     </LlamaIndexChatMessage>

surfsense_web/components/chat/CodeBlock.tsx

@@ -0,0 +1,194 @@
+"use client";
+
+import React, { useState, useEffect, useMemo, useCallback } from "react";
+import { Prism as SyntaxHighlighter } from "react-syntax-highlighter";
+import {
+  oneLight,
+  oneDark,
+} from "react-syntax-highlighter/dist/cjs/styles/prism";
+import { Check, Copy } from "lucide-react";
+import { useTheme } from "next-themes";
+
+// Constants for styling and configuration
+const COPY_TIMEOUT = 2000;
+
+const BASE_CUSTOM_STYLE = {
+  margin: 0,
+  borderRadius: "0.375rem",
+  fontSize: "0.75rem",
+  lineHeight: "1.5rem",
+  border: "none",
+} as const;
+
+const LINE_PROPS_STYLE = {
+  wordBreak: "break-all" as const,
+  whiteSpace: "pre-wrap" as const,
+  border: "none",
+  borderBottom: "none",
+  paddingLeft: 0,
+  paddingRight: 0,
+  margin: "0.25rem 0",
+} as const;
+
+const CODE_TAG_PROPS = {
+  className: "font-mono",
+  style: {
+    border: "none",
+    background: "var(--syntax-bg)",
+  },
+} as const;
+
+// TypeScript interfaces
+interface CodeBlockProps {
+  children: string;
+  language: string;
+}
+
+interface LanguageRenderer {
+  (props: { code: string }): React.JSX.Element;
+}
+
+interface SyntaxStyle {
+  [key: string]: React.CSSProperties;
+}
+
+// Memoized fallback component for SSR/hydration
+const FallbackCodeBlock = React.memo(({ children }: { children: string }) => (
+  <div className="bg-muted p-4 rounded-md">
+    <pre className="m-0 p-0 border-0">
+      <code className="text-xs font-mono border-0 leading-6">
+        {children}
+      </code>
+    </pre>
+  </div>
+));
+
+FallbackCodeBlock.displayName = "FallbackCodeBlock";
+
+// Code block component with syntax highlighting and copy functionality
+export const CodeBlock = React.memo<CodeBlockProps>(({
+  children,
+  language,
+}) => {
+  const [copied, setCopied] = useState(false);
+  const { resolvedTheme, theme } = useTheme();
+  const [mounted, setMounted] = useState(false);
+
+  // Prevent hydration issues
+  useEffect(() => {
+    setMounted(true);
+  }, []);
+
+  // Memoize theme detection
+  const isDarkTheme = useMemo(() => 
+    mounted && (resolvedTheme === "dark" || theme === "dark"),
+    [mounted, resolvedTheme, theme]
+  );
+
+  // Memoize syntax theme selection
+  const syntaxTheme = useMemo(() => 
+    isDarkTheme ? oneDark : oneLight,
+    [isDarkTheme]
+  );
+
+  // Memoize enhanced style with theme-specific modifications
+  const enhancedStyle = useMemo<SyntaxStyle>(() => ({
+    ...syntaxTheme,
+    'pre[class*="language-"]': {
+      ...syntaxTheme['pre[class*="language-"]'],
+      margin: 0,
+      border: "none",
+      borderRadius: "0.375rem",
+      background: "var(--syntax-bg)",
+    },
+    'code[class*="language-"]': {
+      ...syntaxTheme['code[class*="language-"]'],
+      border: "none",
+      background: "var(--syntax-bg)",
+    },
+  }), [syntaxTheme]);
+
+  // Memoize custom style with background
+  const customStyle = useMemo(() => ({
+    ...BASE_CUSTOM_STYLE,
+    backgroundColor: "var(--syntax-bg)",
+  }), []);
+
+  // Memoized copy handler
+  const handleCopy = useCallback(async () => {
+    try {
+      await navigator.clipboard.writeText(children);
+      setCopied(true);
+      const timeoutId = setTimeout(() => setCopied(false), COPY_TIMEOUT);
+      return () => clearTimeout(timeoutId);
+    } catch (error) {
+      console.warn("Failed to copy code to clipboard:", error);
+    }
+  }, [children]);
+
+  // Memoized line props with style
+  const lineProps = useMemo(() => ({
+    style: LINE_PROPS_STYLE,
+  }), []);
+
+  // Early return for non-mounted state
+  if (!mounted) {
+    return <FallbackCodeBlock>{children}</FallbackCodeBlock>;
+  }
+
+  return (
+    <div className="relative my-4 group">
+      <div className="absolute right-2 top-2 z-10">
+        <button
+          onClick={handleCopy}
+          className="p-1.5 rounded-md bg-background/80 hover:bg-background border border-border flex items-center justify-center transition-colors"
+          aria-label="Copy code"
+          type="button"
+        >
+          {copied ? (
+            <Check size={14} className="text-green-500" />
+          ) : (
+            <Copy size={14} className="text-muted-foreground" />
+          )}
+        </button>
+      </div>
+      <SyntaxHighlighter
+        language={language || "text"}
+        style={enhancedStyle}
+        customStyle={customStyle}
+        codeTagProps={CODE_TAG_PROPS}
+        showLineNumbers={false}
+        wrapLines={false}
+        lineProps={lineProps}
+        PreTag="div"
+      >
+        {children}
+      </SyntaxHighlighter>
+    </div>
+  );
+});
+
+CodeBlock.displayName = "CodeBlock";
+
+// Optimized language renderer factory with memoization
+const createLanguageRenderer = (lang: string): LanguageRenderer => {
+  const renderer = ({ code }: { code: string }) => (
+    <CodeBlock language={lang}>{code}</CodeBlock>
+  );
+  renderer.displayName = `LanguageRenderer(${lang})`;
+  return renderer;
+};
+
+// Pre-defined supported languages for better maintainability
+const SUPPORTED_LANGUAGES = [
+  "javascript", "typescript", "python", "java", "csharp", "cpp", "c",
+  "php", "ruby", "go", "rust", "swift", "kotlin", "scala", "sql",
+  "json", "xml", "yaml", "bash", "shell", "powershell", "dockerfile",
+  "html", "css", "scss", "less", "markdown", "text"
+] as const;
+
+// Generate language renderers efficiently
+export const languageRenderers: Record<string, LanguageRenderer> = 
+  Object.fromEntries(
+    SUPPORTED_LANGUAGES.map(lang => [lang, createLanguageRenderer(lang)])
+  ); 

surfsense_web/components/chat/index.ts

@@ -4,4 +4,5 @@ export * from './ConnectorComponents';
 export * from './Citation';
 export * from './SourceUtils';
 export * from './ScrollUtils';
+export * from './CodeBlock';
 export * from './types';