@geenius/docs 0.1.0 → 0.4.1

package/packages/shared/package.json

@@ -1,31 +0,0 @@
-{
-  "name": "@geenius-docs/shared",
-  "version": "0.1.0",
-  "type": "module",
-  "description": "Framework-agnostic docs types, providers, and utilities",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
-  "exports": {
-    ".": "./src/index.ts"
-  },
-  "dependencies": {
-    "gray-matter": "^4.0.3"
-  },
-  "scripts": {
-    "type-check": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage"
-  },
-  "author": "Antigravity HQ",
-  "license": "MIT",
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "devDependencies": {
-    "vitest": "^4.0.0"
-  }
-}

package/packages/shared/src/__tests__/docs.test.ts

@@ -1,69 +0,0 @@
-import { describe, it, expect } from 'vitest'
-import {
-  calcWordCount, slugify, highlightMatch,
-  searchDocs, buildDocsIndex, defaultDocsConfig,
-} from '../index'
-
-describe('calcWordCount', () => {
-  it('counts words and estimates reading time', () => {
-    const result = calcWordCount('The quick brown fox jumps over the lazy dog')
-    expect(result.wordCount).toBe(9)
-    expect(result.readingTime).toBeGreaterThanOrEqual(1)
-  })
-
-  it('handles empty content', () => {
-    const result = calcWordCount('')
-    expect(result.wordCount).toBe(0)
-  })
-
-  it('handles long content with realistic reading time', () => {
-    const words = Array(500).fill('word').join(' ')
-    const result = calcWordCount(words)
-    expect(result.wordCount).toBe(500)
-    expect(result.readingTime).toBeGreaterThanOrEqual(2)
-  })
-})
-
-describe('slugify', () => {
-  it('converts to lowercase with hyphens', () => {
-    expect(slugify('Getting Started')).toBe('getting-started')
-  })
-
-  it('removes special characters', () => {
-    expect(slugify('API Reference (v2)')).toBe('api-reference-v2')
-  })
-
-  it('trims leading/trailing hyphens', () => {
-    expect(slugify('  Hello World!  ')).toBe('hello-world')
-  })
-})
-
-describe('highlightMatch', () => {
-  it('returns snippet around match', () => {
-    const text = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit'
-    const result = highlightMatch(text, 'dolor')
-    expect(result).toContain('dolor')
-  })
-
-  it('returns start of text when no match', () => {
-    const result = highlightMatch('Hello world', 'xyz', 160)
-    expect(result.length).toBeLessThanOrEqual(160)
-  })
-
-  it('returns text slice when query is empty', () => {
-    const result = highlightMatch('Hello world', '')
-    expect(result).toBe('Hello world')
-  })
-})
-
-describe('Search & Config', () => {
-  it('searchDocs returns empty for blank query', () => {
-    expect(searchDocs('', [])).toEqual([])
-  })
-
-  it('defaultDocsConfig has expected fields', () => {
-    expect(defaultDocsConfig.siteName).toBe('Docs')
-    expect(defaultDocsConfig.cmdKEnabled).toBe(true)
-    expect(defaultDocsConfig.showReadingTime).toBe(true)
-  })
-})

package/packages/shared/src/config.ts

@@ -1,80 +0,0 @@
-// @geenius-docs/shared — src/config.ts
-
-import type { DocsConfig } from './types'
-
-let _config: DocsConfig | null = null
-
-/**
- * Initialize the docs system with a configuration.
- * Call this once at app startup before using any docs features.
- *
- * @example
- * ```ts
- * import { configureDocs } from '@geenius-docs/shared'
- *
- * configureDocs({
- *   baseUrl: '/docs',
- *   siteName: 'My Docs',
- *   versionsEnabled: true,
- * })
- * ```
- */
-export function configureDocs(config: DocsConfig): void {
-  _config = config
-}
-
-/**
- * Get the current docs configuration.
- * Throws if `configureDocs()` has not been called.
- */
-export function getDocsConfig(): DocsConfig {
-  if (!_config) {
-    throw new Error('Docs not configured. Call configureDocs() first.')
-  }
-  return _config
-}
-
-/**
- * Check if docs have been configured.
- */
-export function isDocsConfigured(): boolean {
-  return _config !== null
-}
-
-/**
- * Reset docs configuration (useful for testing).
- */
-export function resetDocsConfig(): void {
-  _config = null
-}
-
-/**
- * Create a fully resolved docs config with defaults.
- */
-export function defineDocsConfig(
-  overrides: Partial<DocsConfig>
-): DocsConfig {
-  return {
-    baseUrl: '/docs',
-    defaultAccess: 'public',
-    versionsEnabled: false,
-    cmdKEnabled: true,
-    showReadingTime: true,
-    showLastEdited: true,
-    printModeEnabled: true,
-    ...overrides,
-  }
-}
-
-/**
- * Merge an existing config with partial overrides.
- */
-export function mergeDocsConfig(
-  base: DocsConfig,
-  overrides: Partial<DocsConfig>
-): DocsConfig {
-  return {
-    ...base,
-    ...overrides,
-  }
-}

package/packages/shared/src/index.ts

@@ -1,179 +0,0 @@
-export * from './types'
-
-import type { DocPage, DocSection, TocItem, BreadcrumbItem, SearchResult, DocsConfig } from './types'
-
-// ─── Utility: extract ToC from MDX heading lines ─────────────
-export function extractToc(mdxContent: string): TocItem[] {
-  const headingRegex = /^(#{2,4})\s+(.+)$/gm
-  const items: TocItem[] = []
-  let match: RegExpExecArray | null
-
-  while ((match = headingRegex.exec(mdxContent)) !== null) {
-    const level = match[1].length as 2 | 3 | 4
-    const text = match[2].trim()
-    const id = slugify(text)
-    items.push({ id, text, level, children: [] })
-  }
-
-  // Nest h3 under h2, h4 under h3
-  const nested: TocItem[] = []
-  let currentH2: TocItem | null = null
-  let currentH3: TocItem | null = null
-
-  for (const item of items) {
-    if (item.level === 2) {
-      currentH2 = item
-      currentH3 = null
-      nested.push(item)
-    } else if (item.level === 3) {
-      currentH3 = item
-      if (currentH2) {
-        currentH2.children.push(item)
-      } else {
-        nested.push(item)
-      }
-    } else if (item.level === 4) {
-      if (currentH3) {
-        currentH3.children.push(item)
-      } else if (currentH2) {
-        currentH2.children.push(item)
-      } else {
-        nested.push(item)
-      }
-    }
-  }
-
-  return nested
-}
-
-// ─── Utility: count words and reading time ───────────────────
-export function calcWordCount(content: string): { wordCount: number; readingTime: number } {
-  const stripped = content
-    .replace(/```[\s\S]*?```/g, '')
-    .replace(/`[^`]+`/g, '')
-    .replace(/!\[.*?\]\(.*?\)/g, '')
-    .replace(/\[([^\]]+)\]\(.*?\)/g, '$1')
-    .replace(/[#*_~>|-]/g, '')
-    .trim()
-
-  const words = stripped.split(/\s+/).filter(Boolean)
-  const wordCount = words.length
-  const readingTime = Math.max(1, Math.ceil(wordCount / 225))
-
-  return { wordCount, readingTime }
-}
-
-// ─── Utility: build breadcrumbs from section tree ────────────
-export function buildBreadcrumbs(
-  sections: DocSection[],
-  sectionId: string,
-  slug: string
-): BreadcrumbItem[] {
-  const crumbs: BreadcrumbItem[] = [{ title: 'Docs', href: '/docs' }]
-  const sectionMap = new Map(sections.map(s => [s.id, s]))
-
-  const trail: DocSection[] = []
-  let current = sectionMap.get(sectionId)
-  while (current) {
-    trail.unshift(current)
-    current = current.parentId ? sectionMap.get(current.parentId) : undefined
-  }
-
-  for (const section of trail) {
-    crumbs.push({ title: section.title, href: `/docs/${section.slug}` })
-  }
-
-  if (slug) {
-    crumbs.push({ title: slug, href: `/docs/${trail[trail.length - 1]?.slug ?? ''}/${slug}` })
-  }
-
-  return crumbs
-}
-
-// ─── Utility: full-text search index ─────────────────────────
-export function buildDocsIndex(pages: DocPage[], sections: DocSection[]): SearchResult[] {
-  const sectionMap = new Map(sections.map(s => [s.id, s]))
-
-  return pages
-    .filter(p => p.status === 'published')
-    .map(page => {
-      const section = sectionMap.get(page.sectionId)
-      return {
-        pageId: page.id,
-        pageTitle: page.title,
-        sectionTitle: section?.title ?? '',
-        sectionSlug: section?.slug ?? '',
-        slug: page.slug,
-        highlight: page.excerpt ?? page.content.slice(0, 160),
-        score: 0,
-        tags: page.tags,
-      }
-    })
-}
-
-export function searchDocs(query: string, index: SearchResult[]): SearchResult[] {
-  if (!query.trim()) return []
-
-  const terms = query.toLowerCase().split(/\s+/).filter(Boolean)
-
-  const scored = index
-    .map(entry => {
-      let score = 0
-      const titleLower = entry.pageTitle.toLowerCase()
-      const highlightLower = entry.highlight.toLowerCase()
-      const tagsLower = entry.tags.map(t => t.toLowerCase())
-
-      for (const term of terms) {
-        if (titleLower.includes(term)) score += 10
-        if (tagsLower.some(t => t.includes(term))) score += 5
-        if (highlightLower.includes(term)) score += 2
-        if (entry.sectionTitle.toLowerCase().includes(term)) score += 3
-      }
-
-      return { ...entry, score }
-    })
-    .filter(r => r.score > 0)
-    .sort((a, b) => b.score - a.score)
-    .slice(0, 20)
-
-  return scored
-}
-
-// ─── Utility: slugify for doc pages ──────────────────────────
-export function slugify(title: string): string {
-  return title
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, '-')
-    .replace(/(^-|-$)/g, '')
-}
-
-// ─── Utility: highlight search term in text ──────────────────
-export function highlightMatch(text: string, query: string, maxLen = 160): string {
-  if (!query.trim()) return text.slice(0, maxLen)
-
-  const lowerText = text.toLowerCase()
-  const lowerQuery = query.toLowerCase()
-  const idx = lowerText.indexOf(lowerQuery)
-
-  if (idx === -1) return text.slice(0, maxLen)
-
-  const start = Math.max(0, idx - 40)
-  const end = Math.min(text.length, idx + query.length + (maxLen - 80))
-  let snippet = text.slice(start, end)
-
-  if (start > 0) snippet = '…' + snippet
-  if (end < text.length) snippet = snippet + '…'
-
-  return snippet
-}
-
-// ─── Default config ──────────────────────────────────────────
-export const defaultDocsConfig: DocsConfig = {
-  siteName: 'Docs',
-  cmdKEnabled: true,
-  showReadingTime: true,
-  showLastEdited: true,
-  versionsEnabled: false,
-  defaultAccess: 'team',
-  printModeEnabled: true,
-}

package/packages/shared/src/providers/astro.ts

@@ -1,94 +0,0 @@
-import type { DocsProvider, DocsPage, DocsSidebar, DocsSection, DocsSearchResult, TocEntry } from '../types'
-
-/**
- * Astro docs provider — reads MDX files from filesystem at build time.
- * Designed for Astro Starlight or custom Astro docs sites.
- *
- * Usage:
- *   const provider = new AstroDocsProvider()
- *   await provider.loadFromGlob(import.meta.glob('./content/docs/** /*.mdx', { as: 'raw' }))
- */
-export class AstroDocsProvider implements DocsProvider {
-  readonly name = 'astro' as const
-  private pages: DocsPage[] = []
-
-  async loadFromGlob(globResult: Record<string, () => Promise<string> | string>): Promise<void> {
-    const entries = Object.entries(globResult)
-    const parsed = await Promise.all(entries.map(async ([path, loader]) => {
-      const raw = typeof loader === 'function' ? await loader() : loader
-      return this.parseDoc(path, raw)
-    }))
-    this.pages = this.linkPages(parsed)
-  }
-
-  async loadFromFiles(files: { path: string; content: string }[]): Promise<void> {
-    const parsed = files.map(f => this.parseDoc(f.path, f.content))
-    this.pages = this.linkPages(parsed)
-  }
-
-  private parseDoc(path: string, raw: string): DocsPage {
-    let frontmatter: Record<string, any> = {}
-    let content = raw
-    const fmMatch = raw.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/)
-    if (fmMatch) {
-      // Simple YAML parser for common fields
-      frontmatter = Object.fromEntries(fmMatch[1].split('\n').map(line => { const [k, ...v] = line.split(':'); return [k.trim(), v.join(':').trim()] }).filter(([k]) => k))
-      content = fmMatch[2]
-    }
-
-    const pathParts = path.replace(/.*content\/docs\//, '').replace(/\.(mdx?|md)$/, '').split('/')
-    const slug = pathParts.join('/')
-    const section = pathParts.length > 1 ? pathParts[0].replace(/-/g, ' ').replace(/\b\w/g, l => l.toUpperCase()) : 'General'
-
-    return {
-      slug, title: frontmatter.title ?? pathParts.pop() ?? slug,
-      description: frontmatter.description, content, section,
-      order: frontmatter.order ? parseInt(frontmatter.order) : undefined,
-      icon: frontmatter.icon, draft: frontmatter.draft === 'true',
-      toc: this.extractToc(content),
-    }
-  }
-
-  private extractToc(content: string): TocEntry[] {
-    const entries: TocEntry[] = []
-    const regex = /^(#{2,4})\s+(.+)$/gm
-    let match
-    while ((match = regex.exec(content)) !== null) {
-      const title = match[2].trim()
-      entries.push({ id: title.toLowerCase().replace(/[^a-z0-9]+/g, '-'), title, depth: match[1].length })
-    }
-    return entries
-  }
-
-  private linkPages(pages: DocsPage[]): DocsPage[] {
-    const sorted = [...pages].sort((a, b) => (a.order ?? 0) - (b.order ?? 0))
-    return sorted.map((p, i) => ({
-      ...p,
-      prev: i > 0 ? { slug: sorted[i - 1].slug, title: sorted[i - 1].title } : undefined,
-      next: i < sorted.length - 1 ? { slug: sorted[i + 1].slug, title: sorted[i + 1].title } : undefined,
-    }))
-  }
-
-  async getSidebar(): Promise<DocsSidebar> {
-    const sectionMap = new Map<string, DocsPage[]>()
-    for (const p of this.pages.filter(p => !p.draft)) {
-      if (!sectionMap.has(p.section)) sectionMap.set(p.section, [])
-      sectionMap.get(p.section)!.push(p)
-    }
-    return { sections: [...sectionMap.entries()].map(([title, pages]) => ({ title, slug: title.toLowerCase().replace(/\s+/g, '-'), pages })) }
-  }
-
-  async getPage(slug: string): Promise<DocsPage | null> { return this.pages.find(p => p.slug === slug) ?? null }
-  async getAllPages(): Promise<DocsPage[]> { return this.pages.filter(p => !p.draft) }
-
-  async search(query: string): Promise<DocsSearchResult[]> {
-    const q = query.toLowerCase()
-    return this.pages.filter(p => !p.draft && (p.title.toLowerCase().includes(q) || p.content.toLowerCase().includes(q)))
-      .map(page => ({ page, matches: [{ field: 'content', snippet: page.title }], score: 1 }))
-  }
-
-  async getNavigation(slug: string): Promise<{ prev: DocsPage | null; next: DocsPage | null }> {
-    const page = this.pages.find(p => p.slug === slug)
-    return { prev: page?.prev ? this.pages.find(p => p.slug === page.prev!.slug) ?? null : null, next: page?.next ? this.pages.find(p => p.slug === page.next!.slug) ?? null : null }
-  }
-}

package/packages/shared/src/providers/fumadocs.ts

@@ -1,116 +0,0 @@
-import type { DocsProvider, DocsPage, DocsSidebar, DocsSection, DocsSearchResult, TocEntry } from '../types'
-
-/**
- * Fumadocs docs provider — wraps Fumadocs content source API.
- * Use when docs are managed by Fumadocs in a Next.js app.
- *
- * Usage:
- *   import { FumadocsDocsProvider } from '@geenius-docs/shared/providers/fumadocs'
- *   import { docs } from '@/lib/source'
- *   const provider = new FumadocsDocsProvider()
- *   provider.loadFromSource(docs.getPages(), docs.pageTree)
- */
-export class FumadocsDocsProvider implements DocsProvider {
-  readonly name = 'fumadocs' as const
-  private pages: DocsPage[] = []
-  private tree: FumadocsTreeNode[] = []
-
-  /**
-   * Load from Fumadocs source pages and page tree.
-   */
-  loadFromSource(pages: FumadocsSourcePage[], tree?: FumadocsTreeNode[]): void {
-    this.tree = tree ?? []
-    this.pages = this.linkPages(pages.map(p => this.normalizePage(p)))
-  }
-
-  private normalizePage(page: FumadocsSourcePage): DocsPage {
-    const slugParts = page.slugs ?? page.slug?.split('/') ?? []
-    return {
-      slug: slugParts.join('/'),
-      title: page.data?.title ?? slugParts[slugParts.length - 1] ?? '',
-      description: page.data?.description,
-      content: page.data?.body ?? '',
-      section: slugParts.length > 1
-        ? slugParts[0].replace(/-/g, ' ').replace(/\b\w/g, l => l.toUpperCase())
-        : 'General',
-      order: page.data?.order ?? undefined,
-      icon: page.data?.icon,
-      lastUpdated: page.data?.lastModified ?? page.data?.lastUpdated,
-      toc: (page.data?.toc as TocEntry[]) ?? this.extractToc(page.data?.body ?? ''),
-      draft: page.data?.draft ?? false,
-    }
-  }
-
-  private extractToc(content: string): TocEntry[] {
-    const entries: TocEntry[] = []
-    const regex = /^(#{2,4})\s+(.+)$/gm
-    let match
-    while ((match = regex.exec(content)) !== null) {
-      const title = match[2].trim()
-      entries.push({ id: title.toLowerCase().replace(/[^a-z0-9]+/g, '-'), title, depth: match[1].length })
-    }
-    return entries
-  }
-
-  private linkPages(pages: DocsPage[]): DocsPage[] {
-    const sorted = [...pages].sort((a, b) => (a.order ?? 0) - (b.order ?? 0))
-    return sorted.map((p, i) => ({
-      ...p,
-      prev: i > 0 ? { slug: sorted[i - 1].slug, title: sorted[i - 1].title } : undefined,
-      next: i < sorted.length - 1 ? { slug: sorted[i + 1].slug, title: sorted[i + 1].title } : undefined,
-    }))
-  }
-
-  async getSidebar(): Promise<DocsSidebar> {
-    // If we have a Fumadocs tree, use it for sidebar structure
-    if (this.tree.length > 0) {
-      return { sections: this.treeToSections(this.tree) }
-    }
-    // Fallback: group by section
-    const sectionMap = new Map<string, DocsPage[]>()
-    for (const p of this.pages.filter(p => !p.draft)) {
-      if (!sectionMap.has(p.section)) sectionMap.set(p.section, [])
-      sectionMap.get(p.section)!.push(p)
-    }
-    return { sections: [...sectionMap.entries()].map(([title, pages]) => ({ title, slug: title.toLowerCase().replace(/\s+/g, '-'), pages })) }
-  }
-
-  private treeToSections(nodes: FumadocsTreeNode[]): DocsSection[] {
-    return nodes.filter(n => n.type === 'folder').map(folder => ({
-      title: folder.name ?? '',
-      slug: folder.name?.toLowerCase().replace(/\s+/g, '-') ?? '',
-      icon: folder.icon,
-      pages: (folder.children ?? []).filter(c => c.type === 'page').map(c => this.pages.find(p => p.slug === c.slug) ?? { slug: c.slug ?? '', title: c.name ?? '', content: '', section: folder.name ?? '' }),
-    }))
-  }
-
-  async getPage(slug: string): Promise<DocsPage | null> { return this.pages.find(p => p.slug === slug) ?? null }
-  async getAllPages(): Promise<DocsPage[]> { return this.pages.filter(p => !p.draft) }
-
-  async search(query: string): Promise<DocsSearchResult[]> {
-    const q = query.toLowerCase()
-    return this.pages.filter(p => !p.draft && (p.title.toLowerCase().includes(q) || p.content.toLowerCase().includes(q) || p.description?.toLowerCase().includes(q)))
-      .map(page => ({ page, matches: [{ field: 'title', snippet: page.title }], score: 1 }))
-  }
-
-  async getNavigation(slug: string): Promise<{ prev: DocsPage | null; next: DocsPage | null }> {
-    const page = this.pages.find(p => p.slug === slug)
-    return { prev: page?.prev ? this.pages.find(p => p.slug === page.prev!.slug) ?? null : null, next: page?.next ? this.pages.find(p => p.slug === page.next!.slug) ?? null : null }
-  }
-}
-
-// ─── Fumadocs Source Types ───────────────────────────────────
-export interface FumadocsSourcePage {
-  slug?: string
-  slugs?: string[]
-  url?: string
-  data: { title?: string; description?: string; body?: string; icon?: string; order?: number; toc?: unknown; draft?: boolean; lastModified?: string; lastUpdated?: string; [key: string]: unknown }
-}
-
-export interface FumadocsTreeNode {
-  type: 'page' | 'folder' | 'separator'
-  name?: string
-  slug?: string
-  icon?: string
-  children?: FumadocsTreeNode[]
-}

package/packages/shared/src/providers/internal.ts

@@ -1,80 +0,0 @@
-import type { DocsProvider, DocsPage, DocsSidebar, DocsSection, DocsSearchResult, TocEntry } from '../types'
-
-/**
- * Internal docs provider — renders docs from an in-memory page array.
- * Use when loading docs from CMS, API, or static JSON.
- */
-export class InternalDocsProvider implements DocsProvider {
-  readonly name = 'internal' as const
-  private pages: DocsPage[] = []
-
-  constructor(pages?: DocsPage[]) { if (pages) this.pages = pages }
-
-  setPages(pages: DocsPage[]): void { this.pages = this.linkPages(pages) }
-
-  private linkPages(pages: DocsPage[]): DocsPage[] {
-    const sorted = [...pages].sort((a, b) => (a.order ?? 0) - (b.order ?? 0))
-    return sorted.map((page, i) => ({
-      ...page,
-      prev: i > 0 ? { slug: sorted[i - 1].slug, title: sorted[i - 1].title } : undefined,
-      next: i < sorted.length - 1 ? { slug: sorted[i + 1].slug, title: sorted[i + 1].title } : undefined,
-      toc: page.toc ?? this.extractToc(page.content),
-    }))
-  }
-
-  private extractToc(content: string): TocEntry[] {
-    const regex = /^(#{2,4})\s+(.+)$/gm
-    const entries: TocEntry[] = []
-    let match
-    while ((match = regex.exec(content)) !== null) {
-      const title = match[2].trim()
-      entries.push({ id: title.toLowerCase().replace(/[^a-z0-9]+/g, '-'), title, depth: match[1].length })
-    }
-    return entries
-  }
-
-  async getSidebar(): Promise<DocsSidebar> {
-    const sectionMap = new Map<string, DocsPage[]>()
-    for (const page of this.pages.filter(p => !p.draft)) {
-      const section = page.section || 'General'
-      if (!sectionMap.has(section)) sectionMap.set(section, [])
-      sectionMap.get(section)!.push(page)
-    }
-    const sections: DocsSection[] = [...sectionMap.entries()].map(([title, pages]) => ({
-      title, slug: title.toLowerCase().replace(/[^a-z0-9]+/g, '-'),
-      pages: pages.sort((a, b) => (a.order ?? 0) - (b.order ?? 0)),
-    }))
-    return { sections }
-  }
-
-  async getPage(slug: string): Promise<DocsPage | null> {
-    return this.pages.find(p => p.slug === slug) ?? null
-  }
-
-  async getAllPages(): Promise<DocsPage[]> {
-    return this.pages.filter(p => !p.draft)
-  }
-
-  async search(query: string): Promise<DocsSearchResult[]> {
-    const q = query.toLowerCase()
-    return this.pages.filter(p => !p.draft).map(page => {
-      const matches: DocsSearchResult['matches'] = []
-      if (page.title.toLowerCase().includes(q)) matches.push({ field: 'title', snippet: page.title })
-      if (page.description?.toLowerCase().includes(q)) matches.push({ field: 'description', snippet: page.description })
-      if (page.content.toLowerCase().includes(q)) {
-        const idx = page.content.toLowerCase().indexOf(q)
-        matches.push({ field: 'content', snippet: page.content.slice(Math.max(0, idx - 40), idx + q.length + 40) })
-      }
-      return matches.length > 0 ? { page, matches, score: matches.length } : null
-    }).filter(Boolean) as DocsSearchResult[]
-  }
-
-  async getNavigation(slug: string): Promise<{ prev: DocsPage | null; next: DocsPage | null }> {
-    const page = this.pages.find(p => p.slug === slug)
-    if (!page) return { prev: null, next: null }
-    return {
-      prev: page.prev ? (this.pages.find(p => p.slug === page.prev!.slug) ?? null) : null,
-      next: page.next ? (this.pages.find(p => p.slug === page.next!.slug) ?? null) : null,
-    }
-  }
-}