update compoennt

evanorti · evanorti · commit 305f49cfdab5 · 2025-07-03T11:49:35.000-04:00
diff --git a/app/api/llms/route.ts b/app/api/llms/route.ts
@@ -307,8 +307,14 @@ This is the official documentation site for WAVS, a next-generation AVS platform
 
 For a complete text version of all documentation pages, use https://docs.wavs.xyz/llms-full.txt
 
-## Searching
-Users can search the documentation using the search bar at the top of the site.
+## llm resources
+
+For more llm-ingestible docs, visit https://docs.wavs.xyz/resources/llms.md
+
+## Search API
+
+Search using the search API endpoint: curl "https://docs.wavs.xyz/api/search-custom?q=your_query"
+- returns JSON results with page titles, URLs, and content snippets.
 
 ## Contributions
 The documentation is open-source and accepts contributions. See the GitHub repository for contributing guidelines.
@@ -326,4 +332,4 @@ For additional support or questions not covered in the documentation, users can
       'Content-Type': 'text/plain',
     },
   });
-}
+}
diff --git a/app/api/search-custom/route.ts b/app/api/search-custom/route.ts
@@ -0,0 +1,99 @@
+// This endpoint is for programmatic/LLM search. The site search bar uses /api/search.
+import { getPages } from '@/app/source';
+import { NextRequest, NextResponse } from 'next/server';
+
+export const dynamic = 'force-dynamic';
+export const revalidate = 0;
+
+interface SearchResult {
+  title: string;
+  url: string;
+  snippet: string;
+  score: number;
+}
+
+// Simple text search function
+function searchPages(pages: any[], query: string): SearchResult[] {
+  const results: SearchResult[] = [];
+  const lowerQuery = query.toLowerCase();
+  
+  for (const page of pages) {
+    let score = 0;
+    let snippet = '';
+    
+    // Search in title
+    const title = page.data.title;
+    const lowerTitle = title.toLowerCase();
+    if (lowerTitle.includes(lowerQuery)) {
+      score += 10;
+      snippet = title;
+    }
+    
+    // Search in description
+    const description = (page.data as any).description || '';
+    const lowerDescription = description.toLowerCase();
+    if (lowerDescription.includes(lowerQuery)) {
+      score += 5;
+      if (!snippet) snippet = description;
+    }
+    
+    // Search in structured data content
+    if (page.data.exports.structuredData?.contents) {
+      for (const content of page.data.exports.structuredData.contents) {
+        const contentText = content.content || '';
+        const lowerContent = contentText.toLowerCase();
+        if (lowerContent.includes(lowerQuery)) {
+          score += 3;
+          if (!snippet) {
+            // Create a snippet from the matching content
+            const index = lowerContent.indexOf(lowerQuery);
+            const start = Math.max(0, index - 50);
+            const end = Math.min(contentText.length, index + lowerQuery.length + 50);
+            snippet = (start > 0 ? '...' : '') + contentText.substring(start, end) + (end < contentText.length ? '...' : '');
+          }
+        }
+      }
+    }
+    
+    // Search in headings
+    if (page.data.exports.structuredData?.headings) {
+      for (const heading of page.data.exports.structuredData.headings) {
+        const headingText = heading.content || '';
+        const lowerHeading = headingText.toLowerCase();
+        if (lowerHeading.includes(lowerQuery)) {
+          score += 7;
+          if (!snippet) snippet = headingText;
+        }
+      }
+    }
+    
+    // Add to results if we found matches
+    if (score > 0) {
+      results.push({
+        title,
+        url: page.url,
+        snippet: snippet || title,
+        score
+      });
+    }
+  }
+  
+  // Sort by score (highest first) and limit results
+  return results
+    .sort((a, b) => b.score - a.score)
+    .slice(0, 10);
+}
+
+export async function GET(request: NextRequest) {
+  const { searchParams } = new URL(request.url);
+  const query = searchParams.get('q');
+  
+  if (!query || query.trim() === '') {
+    return NextResponse.json([]);
+  }
+  
+  const pages = getPages();
+  const results = searchPages(pages, query.trim());
+  
+  return NextResponse.json(results);
+} 
diff --git a/app/api/search-debug/route.ts b/app/api/search-debug/route.ts
@@ -0,0 +1,28 @@
+import { getPages } from '@/app/source';
+import { NextRequest, NextResponse } from 'next/server';
+
+export const dynamic = 'force-dynamic';
+export const revalidate = 0;
+
+export async function GET(request: NextRequest) {
+  const pages = getPages();
+  
+  // Sample a few pages to see their structure
+  const samplePages = pages.slice(0, 3).map((page) => ({
+    title: page.data.title,
+    url: page.url,
+    hasStructuredData: !!page.data.exports.structuredData,
+    structuredDataKeys: page.data.exports.structuredData ? Object.keys(page.data.exports.structuredData) : [],
+    structuredDataSample: page.data.exports.structuredData ? 
+      Object.fromEntries(
+        Object.entries(page.data.exports.structuredData).slice(0, 2)
+      ) : null,
+    description: (page.data as any).description || 'No description',
+  }));
+  
+  return NextResponse.json({
+    totalPages: pages.length,
+    samplePages,
+    allPageTitles: pages.map(p => p.data.title),
+  });
+} 
diff --git a/app/api/search/route.ts b/app/api/search/route.ts
@@ -1,3 +1,4 @@
+// This endpoint is for the Fumadocs UI search bar. For programmatic search, use /api/search-custom.
 import { getPages } from '@/app/source';
 import { createSearchAPI } from 'fumadocs-core/search/server';
 
diff --git a/components/open-in-llm.tsx b/components/open-in-llm.tsx
@@ -2,7 +2,7 @@
 
 import { useState, useRef, useEffect } from 'react';
 import { Collapsible, CollapsibleContent, CollapsibleTrigger } from './ui/collapsible';
-import { ChevronDown, ExternalLink, Copy, FileText, Book } from 'lucide-react';
+import { ChevronDown, ExternalLink, Copy, FileText, Book, ScrollText, NotepadTextDashed, NotebookText, Map, WandSparkles, Sparkles } from 'lucide-react';
 import { usePathname } from 'next/navigation';
 import { useMediaQuery } from './hooks/use-media-query';
 import Image from 'next/image';
@@ -110,17 +110,8 @@ export const OpenInLLM = () => {
           <button 
             className="flex items-center gap-2 rounded-lg px-3 py-2 text-sm font-medium text-[hsl(var(--text-secondary))] bg-[hsl(var(--background-secondary))] hover:text-[hsl(var(--text-accent))] hover:bg-[hsl(var(--background-accent))] transition-colors border border-[hsl(var(--border-primary))] shadow-sm"
           >
-            {isMobile ? (
-              <>
-                <Book size={18} />
-                <ChevronDown size={16} className={`transition-transform ${isOpen ? 'rotate-180' : ''}`} />
-              </>
-            ) : (
-              <>
-                <span>Open in LLM</span>
-                <ChevronDown size={16} className={`transition-transform ${isOpen ? 'rotate-180' : ''}`} />
-              </>
-            )}
+            <Sparkles size={18} />
+            <ChevronDown size={16} className={`transition-transform ${isOpen ? 'rotate-180' : ''}`} />
           </button>
         </CollapsibleTrigger>
         <CollapsibleContent className="absolute right-0 top-full z-50 mt-1 w-64 rounded-lg bg-[hsl(var(--background-base))] p-1 shadow-lg border border-[hsl(var(--border-primary))]">
@@ -129,7 +120,7 @@ export const OpenInLLM = () => {
               href={getClaudeUrl()}
               target="_blank"
               rel="noopener noreferrer" 
-              className="flex items-center gap-2 px-3 py-2.5 text-sm text-[hsl(var(--text-primary))] hover:bg-[hsl(var(--background-secondary))] no-underline"
+              className="flex items-center gap-2 px-3 py-2.5 text-sm text-[hsl(var(--text-primary))] hover:bg-[hsl(var(--background-accent))] hover:text-[hsl(var(--text-accent))] no-underline"
               onClick={() => setIsOpen(false)}
             >
               <span className="flex h-5 w-5 items-center justify-center">
@@ -153,7 +144,7 @@ export const OpenInLLM = () => {
               href={getChatGPTUrl()}
               target="_blank"
               rel="noopener noreferrer" 
-              className="flex items-center gap-2 px-3 py-2.5 text-sm text-[hsl(var(--text-primary))] hover:bg-[hsl(var(--background-secondary))] no-underline"
+              className="flex items-center gap-2 px-3 py-2.5 text-sm text-[hsl(var(--text-primary))] hover:bg-[hsl(var(--background-accent))] hover:text-[hsl(var(--text-accent))] no-underline"
               onClick={() => setIsOpen(false)}
             >
               <span className="flex h-5 w-5 items-center justify-center">
@@ -173,9 +164,15 @@ export const OpenInLLM = () => {
               <ExternalLink size={14} className="ml-auto opacity-70" />
             </a>
 
-            <button 
-              onClick={copyMarkdown}
-              className="flex w-full items-center gap-2 px-3 py-2.5 text-sm text-[hsl(var(--text-primary))] hover:bg-[hsl(var(--background-secondary))]"
+            <div className="h-px bg-[hsl(var(--border-primary))] my-1" />
+
+            <a 
+              href="#"
+              onClick={(e) => {
+                e.preventDefault();
+                copyMarkdown();
+              }}
+              className="flex items-center gap-2 px-3 py-2.5 text-sm text-[hsl(var(--text-primary))] hover:bg-[hsl(var(--background-accent))] hover:text-[hsl(var(--text-accent))] no-underline"
             >
               <span className="flex h-5 w-5 items-center justify-center">
                 <Copy size={16} />
@@ -185,13 +182,13 @@ export const OpenInLLM = () => {
                 <span className="text-xs text-[hsl(var(--text-tertiary))]">Copy page as plaintext</span>
               </div>
               <ExternalLink size={14} className="ml-auto opacity-0" />
-            </button>
+            </a>
             
             <a 
               href={mounted ? (isIndexPage ? `${window.location.origin}/api/md/docs/index` : markdownUrl) : '#'}
               target="_blank"
               rel="noopener noreferrer" 
-              className="flex items-center gap-2 px-3 py-2.5 text-sm text-[hsl(var(--text-primary))] hover:bg-[hsl(var(--background-secondary))] no-underline"
+              className="flex items-center gap-2 px-3 py-2.5 text-sm text-[hsl(var(--text-primary))] hover:bg-[hsl(var(--background-accent))] hover:text-[hsl(var(--text-accent))] no-underline"
               onClick={() => setIsOpen(false)}
             >
               <span className="flex h-5 w-5 items-center justify-center">
@@ -204,26 +201,71 @@ export const OpenInLLM = () => {
               <ExternalLink size={14} className="ml-auto opacity-70" />
             </a>
 
-            <div className="mt-2 px-3 py-2 border-t border-[hsl(var(--border-primary))]">
-              <div className="grid grid-cols-2 gap-2">
-                <a 
-                  href="/llms.txt"
-                  target="_blank"
-                  rel="noopener noreferrer"
-                  className="flex justify-center items-center gap-1 px-2 py-1.5 text-xs font-medium rounded-md text-[hsl(var(--text-primary))] bg-[hsl(var(--background-secondary))] hover:bg-[hsl(var(--background-primary))] no-underline border border-[hsl(var(--border-primary))] transition-colors"
-                >
-                  <span>llms.txt</span>
-                </a>
-                <a 
-                  href="/llms-full.txt"
-                  target="_blank"
-                  rel="noopener noreferrer"
-                  className="flex justify-center items-center gap-1 px-2 py-1.5 text-xs font-medium rounded-md text-[hsl(var(--text-primary))] bg-[hsl(var(--background-secondary))] hover:bg-[hsl(var(--background-primary))] no-underline border border-[hsl(var(--border-primary))] transition-colors"
-                >
-                  <span>llms-full.txt</span>
-                </a>
+            <div className="h-px bg-[hsl(var(--border-primary))] my-1" />
+
+            <a 
+              href="/llms.txt"
+              target="_blank"
+              rel="noopener noreferrer" 
+              className="flex items-center gap-2 px-3 py-2.5 text-sm text-[hsl(var(--text-primary))] hover:bg-[hsl(var(--background-accent))] hover:text-[hsl(var(--text-accent))] no-underline"
+              onClick={() => setIsOpen(false)}
+            >
+              <span className="flex h-5 w-5 items-center justify-center">
+                <Map size={16} />
+              </span>
+              <div className="flex flex-col">
+                <span>llms.txt</span>
+                <span className="text-xs text-[hsl(var(--text-tertiary))]">Docs index for AI</span>
+              </div>
+              <ExternalLink size={14} className="ml-auto opacity-70" />
+            </a>
+
+            <a 
+              href="/llms-full.txt"
+              target="_blank"
+              rel="noopener noreferrer" 
+              className="flex items-center gap-2 px-3 py-2.5 text-sm text-[hsl(var(--text-primary))] hover:bg-[hsl(var(--background-accent))] hover:text-[hsl(var(--text-accent))] no-underline"
+              onClick={() => setIsOpen(false)}
+            >
+              <span className="flex h-5 w-5 items-center justify-center">
+                <NotebookText size={16} />
+              </span>
+              <div className="flex flex-col">
+                <span>Full Documentation</span>
+                <span className="text-xs text-[hsl(var(--text-tertiary))]">Complete docs as text</span>
+              </div>
+              <ExternalLink size={14} className="ml-auto opacity-70" />
+            </a>
+
+            <a 
+              href="/resources/llms"
+              className="flex items-center gap-2 px-3 py-2.5 text-sm text-[hsl(var(--text-primary))] hover:bg-[hsl(var(--background-accent))] hover:text-[hsl(var(--text-accent))] no-underline"
+              onClick={() => setIsOpen(false)}
+            >
+              <span className="flex h-5 w-5 items-center justify-center">
+                <Book size={16} />
+              </span>
+              <div className="flex flex-col">
+                <span>LLM Resouces</span>
+                <span className="text-xs text-[hsl(var(--text-tertiary))]">AI-friendly resources</span>
               </div>
-            </div>
+              <ExternalLink size={14} className="ml-auto opacity-70" />
+            </a>
+
+            <a 
+              href="/handbook/ai"
+              className="flex items-center gap-2 px-3 py-2.5 text-sm text-[hsl(var(--text-primary))] hover:bg-[hsl(var(--background-accent))] hover:text-[hsl(var(--text-accent))] no-underline"
+              onClick={() => setIsOpen(false)}
+            >
+              <span className="flex h-5 w-5 items-center justify-center">
+                <WandSparkles size={16} />
+              </span>
+              <div className="flex flex-col">
+                <span>AI template</span>
+                <span className="text-xs text-[hsl(var(--text-tertiary))]">Create components with AI</span>
+              </div>
+              <ExternalLink size={14} className="ml-auto opacity-70" />
+            </a>
           </div>
         </CollapsibleContent>
       </Collapsible>
diff --git a/content/docs/llm-docs.mdx b/content/docs/llm-docs.mdx
diff --git a/content/docs/resources/llms.mdx b/content/docs/resources/llms.mdx
@@ -2,8 +2,13 @@
 title: LLM docs
 description: Access WAVS documentation in formats optimized for AI tools and integration.
 ---
+import { Callout } from 'fumadocs-ui/components/callout';
+import { DocsPage } from 'fumadocs-ui/page';
 
 
+<Callout title="AI components" type="info">
+To learn how to create one-shot components with AI, visit the [AI-powered component creation page](/handbook/ai)
+</Callout>
 
 The LLM text format presents documentation in a clean, plain text format optimized for large language models (LLMs) like Claude, ChatGPT, and others.
 
@@ -42,3 +47,9 @@ Examples:
 - `/overview.md` - Overview page as Markdown
 - `/tutorial/1-overview.md` - Tutorial introduction as Markdown
 - `/handbook/service.md` - Service handbook as Markdown
+
+## Crate docs
+
+## WAVS foundry template llm docs
+
+An llm-ingestible full markdown version of the [WAVS foundry template](https://github.com/Lay3rLabs/wavs-foundry-template) is available
diff --git a/content/docs/resources/meta.json b/content/docs/resources/meta.json
diff --git a/last_commit_sync.txt b/last_commit_sync.txt

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+// This endpoint is for the Fumadocs UI search bar. For programmatic search, use /api/search-custom.`
`1`	`2`	`import { getPages } from '@/app/source';`
`2`	`3`	`import { createSearchAPI } from 'fumadocs-core/search/server';`
`3`	`4`