polen 0.10.0-next.14 → 0.10.0-next.3

package/src/lib/graphql-document/example.ts

@@ -1,163 +0,0 @@
-/**
- * Example usage of the GraphQL Document Analysis library
- *
- * This demonstrates how to use the foundational layer for extracting
- * identifiers and context from GraphQL documents - the building block
- * for the interactive GraphQL Document Component.
- */
-
-import { GraphQLDocument } from './$.ts'
-
-// Example GraphQL query with various constructs
-const exampleQuery = `
-  query GetPokemonWithAbilities($id: ID!, $limit: Int = 10) {
-    pokemon(id: $id) {
-      name
-      abilities(first: $limit) {
-        name
-        isHidden
-        pokemon {
-          name
-        }
-      }
-      ... on ElectricPokemon {
-        voltage
-      }
-    }
-  }
-
-  fragment PokemonBasics on Pokemon {
-    name
-    type
-    level
-  }
-`
-
-/**
- * Demonstrate basic analysis
- */
-export const analyzeExample = () => {
-  console.log('🔍 Analyzing GraphQL Document...\n')
-
-  const result = GraphQLDocument.analyze(exampleQuery)
-
-  console.log(`✅ Valid: ${result.isValid}`)
-  console.log(`📊 Total identifiers: ${result.identifiers.all.length}`)
-  console.log(`🚨 Errors: ${result.errors.length}\n`)
-
-  // Show identifiers by kind
-  for (const [kind, identifiers] of result.identifiers.byKind) {
-    console.log(`${getKindEmoji(kind)} ${kind} (${identifiers.length}):`)
-    for (const identifier of identifiers) {
-      const pos = `${identifier.position.line}:${identifier.position.column}`
-      const path = identifier.schemaPath.join(' → ')
-      const parent = identifier.parentType ? ` (in ${identifier.parentType})` : ''
-      console.log(`  • ${identifier.name}${parent} → ${path} @ ${pos}`)
-    }
-    console.log()
-  }
-
-  return result
-}
-
-/**
- * Demonstrate identifier lookup by position
- */
-export const demonstratePositionLookup = () => {
-  console.log('📍 Position-based Identifier Lookup...\n')
-
-  const identifiers = GraphQLDocument.extractIdentifiers(exampleQuery)
-
-  // Find identifier at a specific position (e.g., cursor position in an editor)
-  const targetPosition = 180 // Approximate position of "abilities" field
-
-  // Find the closest identifier to this position
-  let closestIdentifier = null
-  let closestDistance = Infinity
-
-  for (const identifier of identifiers.all) {
-    const distance = Math.abs(identifier.position.start - targetPosition)
-    if (distance < closestDistance) {
-      closestDistance = distance
-      closestIdentifier = identifier
-    }
-  }
-
-  if (closestIdentifier) {
-    console.log(`🎯 Identifier near position ${targetPosition}:`)
-    console.log(`   Name: ${closestIdentifier.name}`)
-    console.log(`   Kind: ${closestIdentifier.kind}`)
-    console.log(`   Schema Path: ${closestIdentifier.schemaPath.join(' → ')}`)
-    console.log(`   Context: ${JSON.stringify(closestIdentifier.context, null, 2)}`)
-  }
-}
-
-/**
- * Demonstrate how this enables hyperlink generation
- */
-export const demonstrateHyperlinkGeneration = () => {
-  console.log('🔗 Hyperlink Generation Preview...\n')
-
-  const identifiers = GraphQLDocument.extractIdentifiers(exampleQuery)
-
-  // Show how each identifier could become a hyperlink
-  const typeIdentifiers = identifiers.byKind.get('Type') || []
-  const fieldIdentifiers = identifiers.byKind.get('Field') || []
-
-  console.log('📝 Type References → Schema Links:')
-  for (const identifier of typeIdentifiers) {
-    const referenceUrl = `/reference/${identifier.name}`
-    console.log(`  ${identifier.name} → ${referenceUrl}`)
-  }
-
-  console.log('\n📝 Field References → Schema Links:')
-  for (const identifier of fieldIdentifiers.slice(0, 5)) { // Show first 5
-    const referenceUrl = identifier.parentType
-      ? `/reference/${identifier.parentType}#${identifier.name}`
-      : `/reference/${identifier.name}`
-    console.log(`  ${identifier.name} → ${referenceUrl}`)
-  }
-}
-
-/**
- * Show the foundation for hover tooltips
- */
-export const demonstrateTooltipFoundation = () => {
-  console.log('💬 Tooltip Foundation...\n')
-
-  const identifiers = GraphQLDocument.extractIdentifiers(exampleQuery)
-
-  // Show context information that would be displayed in tooltips
-  const fieldIdentifiers = identifiers.byKind.get('Field') || []
-
-  for (const identifier of fieldIdentifiers.slice(0, 3)) { // Show first 3
-    console.log(`🏷️  ${identifier.name}:`)
-    console.log(`    Position: Line ${identifier.position.line}, Column ${identifier.position.column}`)
-    console.log(`    Schema Path: ${identifier.schemaPath.join(' → ')}`)
-    console.log(`    Parent Type: ${identifier.parentType || 'Root'}`)
-    console.log(`    Operation: ${identifier.context.operationType || 'None'}`)
-    console.log(`    Selection Path: ${identifier.context.selectionPath.join(' → ')}`)
-    console.log()
-  }
-}
-
-// Helper function
-function getKindEmoji(kind: string): string {
-  const emojis: Record<string, string> = {
-    'Type': '🏷️',
-    'Field': '📋',
-    'Argument': '⚙️',
-    'Variable': '💰',
-    'Directive': '🎯',
-    'Fragment': '🧩',
-  }
-  return emojis[kind] || '❓'
-}
-
-// Run example if executed directly
-if (import.meta.url === `file://${process.argv[1]}`) {
-  analyzeExample()
-  demonstratePositionLookup()
-  demonstrateHyperlinkGeneration()
-  demonstrateTooltipFoundation()
-}

package/src/lib/graphql-document/graphql-document.ts

@@ -1,37 +0,0 @@
-/**
- * GraphQL Document Component Library
- *
- * Transform static GraphQL code blocks into interactive documentation with
- * hyperlinks, tooltips, and schema validation.
- *
- * ## Features
- * - Hyperlinked identifiers that navigate to reference documentation
- * - Hover tooltips showing type information and descriptions
- * - Schema validation with error highlighting
- * - Build-time GraphQL validation
- * - Support for all GraphQL operations (queries, mutations, subscriptions, fragments)
- *
- * ## Usage
- * ```typescript
- * import { GraphQLDocument } from 'polen/lib/graphql-document'
- *
- * <GraphQLDocument schema={schema}>
- *   {`query { user { name } }`}
- * </GraphQLDocument>
- * ```
- *
- * @see {@link GraphQLDocumentWithSchema} for MDX integration
- * @see {@link GraphQLDocument} for the main React component
- */
-
-export * from './analysis.ts'
-export * from './components/index.ts'
-export * from './positioning-simple.ts'
-export * from './schema-integration.ts'
-export * from './types.ts'
-
-// Re-export key functions for convenience
-export { analyze, analyzer, extractIdentifiers } from './analysis.ts'
-export { GraphQLDocument } from './components/GraphQLDocument.tsx'
-export { createSimpleOverlay, createSimplePositionCalculator } from './positioning-simple.ts'
-export { analyzeWithSchema, createPolenSchemaResolver } from './schema-integration.ts'

package/src/lib/graphql-document/hooks/use-tooltip-state.test.ts

@@ -1,76 +0,0 @@
-/**
- * Unit tests for tooltip state management hook
- *
- * @vitest-environment jsdom
- */
-
-import { act, renderHook } from '@testing-library/react'
-import { describe, expect, it, vi } from 'vitest'
-import { useTooltipState } from './use-tooltip-state.ts'
-
-describe('useTooltipState', () => {
-  it('shows tooltip after hover delay', () => {
-    vi.useFakeTimers()
-    const { result } = renderHook(() => useTooltipState({ showDelay: 300 }))
-
-    act(() => {
-      result.current.onHoverStart('field-1')
-    })
-    expect(result.current.isOpen('field-1')).toBe(false)
-
-    act(() => {
-      vi.advanceTimersByTime(300)
-    })
-    expect(result.current.isOpen('field-1')).toBe(true)
-    vi.useRealTimers()
-  })
-
-  it('hides tooltip after hover end delay', () => {
-    vi.useFakeTimers()
-    const { result } = renderHook(() => useTooltipState())
-
-    // Show tooltip
-    act(() => {
-      result.current.onHoverStart('field-1')
-      vi.advanceTimersByTime(300)
-    })
-
-    // Trigger hide
-    act(() => {
-      result.current.onHoverEnd('field-1')
-    })
-    expect(result.current.isOpen('field-1')).toBe(true) // Still open during delay
-
-    act(() => {
-      vi.advanceTimersByTime(200)
-    })
-    expect(result.current.isOpen('field-1')).toBe(false)
-    vi.useRealTimers()
-  })
-
-  it('pins and unpins tooltip on toggle', () => {
-    const { result } = renderHook(() => useTooltipState())
-
-    act(() => {
-      result.current.onTogglePin('field-1')
-    })
-    expect(result.current.isPinned('field-1')).toBe(true)
-
-    act(() => {
-      result.current.onTogglePin('field-1')
-    })
-    expect(result.current.isPinned('field-1')).toBe(false)
-  })
-
-  it('allows multiple pins when enabled', () => {
-    const { result } = renderHook(() => useTooltipState())
-
-    act(() => {
-      result.current.onTogglePin('field-1')
-      result.current.onTogglePin('field-2')
-    })
-
-    expect(result.current.isPinned('field-1')).toBe(true)
-    expect(result.current.isPinned('field-2')).toBe(true)
-  })
-})

package/src/lib/graphql-document/hooks/use-tooltip-state.ts

@@ -1,191 +0,0 @@
-/**
- * State management for GraphQL document tooltips
- *
- * Handles hover delays, pinning, and multiple tooltip coordination
- */
-
-import { React } from '#dep/react/index'
-
-export interface TooltipState {
-  /** Currently visible tooltip (via hover) */
-  hoveredId: string | null
-  /** Set of pinned tooltip IDs */
-  pinnedIds: Set<string>
-  /** ID pending show (waiting for delay) */
-  pendingShowId: string | null
-  /** ID pending hide (waiting for grace period) */
-  pendingHideId: string | null
-}
-
-export interface UseTooltipStateOptions {
-  /** Delay before showing tooltip on hover (ms) */
-  showDelay?: number
-  /** Delay before hiding tooltip on mouse leave (ms) */
-  hideDelay?: number
-  /** Whether to allow multiple pinned tooltips */
-  allowMultiplePins?: boolean
-}
-
-export interface UseTooltipStateReturn {
-  /** Check if a tooltip should be visible */
-  isOpen: (id: string) => boolean
-  /** Check if a tooltip is pinned */
-  isPinned: (id: string) => boolean
-  /** Handle hover start */
-  onHoverStart: (id: string) => void
-  /** Handle hover end */
-  onHoverEnd: (id: string) => void
-  /** Handle click (toggle pin) */
-  onTogglePin: (id: string) => void
-  /** Handle tooltip content hover (cancels hide) */
-  onTooltipHover: (id: string) => void
-  /** Unpin a specific tooltip */
-  unpin: (id: string) => void
-  /** Unpin all tooltips */
-  unpinAll: () => void
-}
-
-export const useTooltipState = (options: UseTooltipStateOptions = {}): UseTooltipStateReturn => {
-  const {
-    showDelay = 300,
-    hideDelay = 200,
-    allowMultiplePins = true,
-  } = options
-
-  const [hoveredId, setHoveredId] = React.useState<string | null>(null)
-  const [pinnedIds, setPinnedIds] = React.useState<Set<string>>(new Set())
-  const [pendingShowId, setPendingShowId] = React.useState<string | null>(null)
-  const [pendingHideId, setPendingHideId] = React.useState<string | null>(null)
-
-  // Timer refs
-  const showTimerRef = React.useRef<NodeJS.Timeout | null>(null)
-  const hideTimerRef = React.useRef<NodeJS.Timeout | null>(null)
-
-  // Clear any pending timers
-  const clearTimers = React.useCallback(() => {
-    if (showTimerRef.current) {
-      clearTimeout(showTimerRef.current)
-      showTimerRef.current = null
-    }
-    if (hideTimerRef.current) {
-      clearTimeout(hideTimerRef.current)
-      hideTimerRef.current = null
-    }
-    setPendingShowId(null)
-    setPendingHideId(null)
-  }, [])
-
-  // Check if tooltip should be visible
-  const isOpen = React.useCallback((id: string): boolean => {
-    return hoveredId === id || pinnedIds.has(id)
-  }, [hoveredId, pinnedIds])
-
-  // Check if tooltip is pinned
-  const isPinned = React.useCallback((id: string): boolean => {
-    return pinnedIds.has(id)
-  }, [pinnedIds])
-
-  // Handle hover start
-  const onHoverStart = React.useCallback((id: string) => {
-    // Don't show if already pinned
-    if (pinnedIds.has(id)) return
-
-    // Cancel any pending hide for this ID
-    if (pendingHideId === id) {
-      clearTimeout(hideTimerRef.current!)
-      hideTimerRef.current = null
-      setPendingHideId(null)
-      return
-    }
-
-    // Clear any other pending operations
-    clearTimers()
-
-    // Schedule show
-    setPendingShowId(id)
-    showTimerRef.current = setTimeout(() => {
-      setHoveredId(id)
-      setPendingShowId(null)
-    }, showDelay)
-  }, [pinnedIds, pendingHideId, clearTimers, showDelay])
-
-  // Handle hover end
-  const onHoverEnd = React.useCallback((id: string) => {
-    // Don't hide if pinned
-    if (pinnedIds.has(id)) return
-
-    // Cancel pending show if still waiting
-    if (pendingShowId === id) {
-      clearTimeout(showTimerRef.current!)
-      showTimerRef.current = null
-      setPendingShowId(null)
-      return
-    }
-
-    // Only hide if currently showing this tooltip
-    if (hoveredId === id) {
-      setPendingHideId(id)
-      hideTimerRef.current = setTimeout(() => {
-        // First set hovered to null to trigger close animation
-        setHoveredId(null)
-        setPendingHideId(null)
-      }, hideDelay)
-    }
-  }, [pinnedIds, pendingShowId, hoveredId, hideDelay])
-
-  // Handle tooltip content hover (cancels hide)
-  const onTooltipHover = React.useCallback((id: string) => {
-    if (pendingHideId === id) {
-      clearTimeout(hideTimerRef.current!)
-      hideTimerRef.current = null
-      setPendingHideId(null)
-    }
-  }, [pendingHideId])
-
-  // Toggle pin state
-  const onTogglePin = React.useCallback((id: string) => {
-    clearTimers()
-
-    setPinnedIds((prev: Set<string>) => {
-      const next = new Set(prev)
-      if (next.has(id)) {
-        // Unpin
-        next.delete(id)
-        setHoveredId(null) // Also clear hover state
-      } else {
-        // Pin
-        if (!allowMultiplePins) {
-          next.clear() // Clear other pins
-        }
-        next.add(id)
-        setHoveredId(null) // Clear hover state since it's now pinned
-      }
-      return next
-    })
-  }, [clearTimers, allowMultiplePins])
-
-  // Unpin specific tooltip
-  const unpin = React.useCallback((id: string) => {
-    setPinnedIds((prev: Set<string>) => {
-      const next = new Set(prev)
-      next.delete(id)
-      return next
-    })
-  }, [])
-
-  // Unpin all tooltips
-  const unpinAll = React.useCallback(() => {
-    setPinnedIds(new Set())
-  }, [])
-
-  return {
-    isOpen,
-    isPinned,
-    onHoverStart,
-    onHoverEnd,
-    onTogglePin,
-    onTooltipHover,
-    unpin,
-    unpinAll,
-  }
-}