@tachui/core 0.7.0-alpha1 → 0.8.0-alpha

package/dist/validation/developer-experience.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"developer-experience.js","sources":["../../src/validation/developer-experience.ts"],"sourcesContent":["/**\n * Developer Experience Integration - Phase 1D\n * \n * Enhanced error message templates, intelligent fix suggestions,\n * and comprehensive developer guidance system.\n */\n\nimport type { ValidationErrorCategory, ValidationErrorSeverity } from './error-reporting'\nimport { EnhancedValidationError } from './enhanced-runtime'\n\n/**\n * Intelligent fix suggestion with automated repair capability\n */\nexport interface IntelligentFixSuggestion {\n  id: string\n  title: string\n  description: string\n  difficulty: 'easy' | 'medium' | 'hard'\n  confidence: number // 0-1 confidence score\n  category: 'syntax' | 'logic' | 'performance' | 'accessibility' | 'best-practice'\n  \n  // Code examples\n  before: string\n  after: string\n  \n  // Automated fix capability\n  canAutoFix: boolean\n  autoFix?: () => string\n  \n  // Learning resources\n  learnMore?: {\n    documentation: string\n    examples: string[]\n    videoTutorial?: string\n  }\n  \n  // Related suggestions\n  relatedFixes: string[]\n}\n\n/**\n * Enhanced error message template with rich formatting\n */\nexport interface DeveloperErrorMessageTemplate {\n  id: string\n  title: string\n  description: string\n  severity: ValidationErrorSeverity\n  category: ValidationErrorCategory\n  \n  // Rich formatting\n  emoji: string\n  color: string\n  \n  // Developer guidance\n  quickFix: string\n  explanation: string\n  prevention: string\n  \n  // Interactive elements\n  suggestions: IntelligentFixSuggestion[]\n  examples: {\n    wrong: CodeExample[]\n    correct: CodeExample[]\n  }\n  \n  // Documentation links\n  documentation: {\n    primary: string\n    related: string[]\n    apiReference?: string\n  }\n  \n  // Contextual information\n  context: {\n    component?: string\n    modifier?: string\n    package?: string\n    commonCause: string[]\n  }\n}\n\n/**\n * Code example with syntax highlighting metadata\n */\nexport interface CodeExample {\n  code: string\n  language: 'typescript' | 'javascript' | 'tsx' | 'jsx'\n  title: string\n  description?: string\n  highlights?: {\n    line: number\n    type: 'error' | 'warning' | 'info' | 'success'\n    message: string\n  }[]\n}\n\n/**\n * Developer experience configuration\n */\nexport interface DeveloperExperienceConfig {\n  // Error message preferences\n  verbosity: 'minimal' | 'standard' | 'detailed' | 'comprehensive'\n  showEmojis: boolean\n  showColors: boolean\n  showCodeExamples: boolean\n  showDocumentationLinks: boolean\n  \n  // Fix suggestions\n  enableAutoFix: boolean\n  suggestionCount: number\n  minConfidenceScore: number\n  \n  // IDE integration\n  enableInlineHelp: boolean\n  enableHoverInfo: boolean\n  enableQuickActions: boolean\n  \n  // Learning features\n  showLearningTips: boolean\n  trackProgress: boolean\n  personalization: boolean\n}\n\n/**\n * Global developer experience configuration\n */\nlet devExperienceConfig: DeveloperExperienceConfig = {\n  verbosity: 'standard',\n  showEmojis: true,\n  showColors: true,\n  showCodeExamples: true,\n  showDocumentationLinks: true,\n  enableAutoFix: true,\n  suggestionCount: 3,\n  minConfidenceScore: 0.7,\n  enableInlineHelp: true,\n  enableHoverInfo: true,\n  enableQuickActions: true,\n  showLearningTips: true,\n  trackProgress: false,\n  personalization: false\n}\n\n/**\n * Comprehensive error message templates database\n */\nexport const errorMessageTemplates: Record<string, DeveloperErrorMessageTemplate> = {\n  'missing-required-prop': {\n    id: 'missing-required-prop',\n    title: 'Missing Required Property',\n    description: 'Component is missing a required property that is necessary for proper functionality.',\n    severity: 'error',\n    category: 'component-construction',\n    emoji: '❌',\n    color: '#ff4444',\n    quickFix: 'Add the required property to the component',\n    explanation: 'This component requires specific properties to function correctly. Missing required properties can cause runtime errors or unexpected behavior.',\n    prevention: 'Always check component documentation for required properties and use TypeScript for compile-time validation.',\n    suggestions: [\n      {\n        id: 'add-required-prop',\n        title: 'Add Required Property',\n        description: 'Add the missing required property with an appropriate value',\n        difficulty: 'easy',\n        confidence: 0.95,\n        category: 'syntax',\n        before: 'Text()',\n        after: 'Text(\"Hello World\")',\n        canAutoFix: true,\n        autoFix: () => 'Text(\"Hello World\")',\n        learnMore: {\n          documentation: '/docs/components/text#required-properties',\n          examples: ['/examples/text-basic-usage', '/examples/text-with-signals']\n        },\n        relatedFixes: ['use-signal-content', 'add-type-annotation']\n      }\n    ],\n    examples: {\n      wrong: [{\n        code: 'Text()',\n        language: 'typescript',\n        title: 'Missing content parameter',\n        description: 'Text component requires content to display',\n        highlights: [{\n          line: 1,\n          type: 'error',\n          message: 'Missing required \"content\" parameter'\n        }]\n      }],\n      correct: [{\n        code: 'Text(\"Hello World\")',\n        language: 'typescript',\n        title: 'Correct usage with content',\n        description: 'Text component with required content parameter'\n      }, {\n        code: 'Text(() => dynamicContent.value)',\n        language: 'typescript',\n        title: 'Using reactive content',\n        description: 'Text component with reactive content function'\n      }]\n    },\n    documentation: {\n      primary: '/docs/components/text',\n      related: ['/docs/concepts/required-properties', '/docs/guides/component-construction'],\n      apiReference: '/api/components/text'\n    },\n    context: {\n      component: 'Text',\n      package: 'core',\n      commonCause: ['Forgot to pass content parameter', 'Copy-paste error', 'Incomplete refactoring']\n    }\n  },\n\n  'invalid-modifier-usage': {\n    id: 'invalid-modifier-usage',\n    title: 'Invalid Modifier Usage',\n    description: 'Modifier is not compatible with this component type or is being used incorrectly.',\n    severity: 'error',\n    category: 'modifier-usage',\n    emoji: '🔧',\n    color: '#ff8800',\n    quickFix: 'Remove the incompatible modifier or use it on a compatible component',\n    explanation: 'Components have specific modifiers that are compatible with their functionality. Using incompatible modifiers can cause rendering issues.',\n    prevention: 'Check component documentation for supported modifiers and use IDE autocomplete for guidance.',\n    suggestions: [\n      {\n        id: 'remove-incompatible-modifier',\n        title: 'Remove Incompatible Modifier',\n        description: 'Remove the modifier that is not supported by this component',\n        difficulty: 'easy',\n        confidence: 0.9,\n        category: 'syntax',\n        before: 'VStack({ children: [] }).fontSize(16)',\n        after: 'VStack({ children: [] })',\n        canAutoFix: true,\n        autoFix: () => 'VStack({ children: [] })',\n        learnMore: {\n          documentation: '/docs/modifiers/compatibility',\n          examples: ['/examples/modifier-usage', '/examples/component-styling']\n        },\n        relatedFixes: ['use-compatible-modifier', 'wrap-in-container']\n      }\n    ],\n    examples: {\n      wrong: [{\n        code: 'VStack({ children: [] }).fontSize(16)',\n        language: 'typescript',\n        title: 'Text modifier on layout component',\n        description: 'fontSize is only applicable to text components',\n        highlights: [{\n          line: 1,\n          type: 'error',\n          message: 'fontSize modifier not compatible with VStack'\n        }]\n      }],\n      correct: [{\n        code: 'Text(\"Hello\").fontSize(16)',\n        language: 'typescript',\n        title: 'Correct fontSize usage',\n        description: 'fontSize modifier used on Text component'\n      }, {\n        code: 'VStack({ children: [] }).padding(16)',\n        language: 'typescript',\n        title: 'Compatible VStack modifier',\n        description: 'padding modifier is compatible with VStack'\n      }]\n    },\n    documentation: {\n      primary: '/docs/modifiers/overview',\n      related: ['/docs/modifiers/compatibility', '/docs/components/modifier-support'],\n      apiReference: '/api/modifiers'\n    },\n    context: {\n      modifier: 'fontSize',\n      component: 'VStack',\n      package: 'core',\n      commonCause: ['Confusion about modifier compatibility', 'Copy-paste from different component', 'Misunderstanding of component types']\n    }\n  },\n\n  'performance-warning': {\n    id: 'performance-warning',\n    title: 'Performance Optimization Available',\n    description: 'Code pattern detected that could impact performance with optimization suggestions.',\n    severity: 'warning',\n    category: 'performance',\n    emoji: '⚡',\n    color: '#ffaa00',\n    quickFix: 'Apply performance optimization suggestions',\n    explanation: 'This pattern works correctly but may impact performance in certain scenarios. Consider the suggested optimizations for better user experience.',\n    prevention: 'Follow performance best practices and use the TachUI performance monitoring tools during development.',\n    suggestions: [\n      {\n        id: 'optimize-list-rendering',\n        title: 'Use Virtual Scrolling',\n        description: 'For large lists, consider using virtual scrolling to improve performance',\n        difficulty: 'medium',\n        confidence: 0.8,\n        category: 'performance',\n        before: 'List({ children: largeDataset.map(item => ListItem(item)) })',\n        after: 'VirtualList({ data: largeDataset, renderItem: item => ListItem(item) })',\n        canAutoFix: false,\n        learnMore: {\n          documentation: '/docs/performance/virtual-scrolling',\n          examples: ['/examples/virtual-list', '/examples/performance-optimization'],\n          videoTutorial: '/videos/optimizing-large-lists'\n        },\n        relatedFixes: ['add-key-prop', 'memo-optimization']\n      }\n    ],\n    examples: {\n      wrong: [{\n        code: 'List({ children: items.map(item => Item(item)) })',\n        language: 'typescript',\n        title: 'Large list without optimization',\n        description: 'Rendering all items at once can impact performance',\n        highlights: [{\n          line: 1,\n          type: 'warning',\n          message: 'Consider virtual scrolling for large datasets'\n        }]\n      }],\n      correct: [{\n        code: 'VirtualList({ data: items, renderItem: item => Item(item) })',\n        language: 'typescript',\n        title: 'Optimized virtual list',\n        description: 'Virtual scrolling only renders visible items'\n      }]\n    },\n    documentation: {\n      primary: '/docs/performance/optimization',\n      related: ['/docs/components/virtual-list', '/docs/guides/performance-best-practices']\n    },\n    context: {\n      component: 'List',\n      package: 'core',\n      commonCause: ['Large datasets', 'Unaware of optimization options', 'Premature optimization concerns']\n    }\n  }\n}\n\n/**\n * Intelligent fix suggestion engine\n */\nexport class FixSuggestionEngine {\n  private suggestionDatabase = new Map<string, IntelligentFixSuggestion[]>()\n  private usageTracker = new Map<string, number>()\n\n  constructor() {\n    this.initializeSuggestionDatabase()\n  }\n\n  /**\n   * Get intelligent fix suggestions for a given error\n   */\n  getSuggestions(\n    errorType: string,\n    _context: {\n      component?: string\n      modifier?: string\n      code?: string\n      severity?: ValidationErrorSeverity\n    }\n  ): IntelligentFixSuggestion[] {\n    const baseSuggestions = this.suggestionDatabase.get(errorType) || []\n    \n    // Filter by confidence score\n    const filteredSuggestions = baseSuggestions.filter(\n      suggestion => suggestion.confidence >= devExperienceConfig.minConfidenceScore\n    )\n\n    // Sort by relevance and confidence\n    const sortedSuggestions = filteredSuggestions.sort((a, b) => {\n      // Prioritize by confidence and usage statistics\n      const aScore = a.confidence + (this.usageTracker.get(a.id) || 0) * 0.1\n      const bScore = b.confidence + (this.usageTracker.get(b.id) || 0) * 0.1\n      return bScore - aScore\n    })\n\n    // Limit to configured count\n    return sortedSuggestions.slice(0, devExperienceConfig.suggestionCount)\n  }\n\n  /**\n   * Apply automatic fix\n   */\n  applyAutoFix(suggestionId: string, _code: string): string | null {\n    for (const suggestions of this.suggestionDatabase.values()) {\n      const suggestion = suggestions.find(s => s.id === suggestionId)\n      if (suggestion && suggestion.canAutoFix && suggestion.autoFix) {\n        this.trackSuggestionUsage(suggestionId)\n        return suggestion.autoFix()\n      }\n    }\n    return null\n  }\n\n  /**\n   * Track suggestion usage for improvement\n   */\n  private trackSuggestionUsage(suggestionId: string): void {\n    const currentCount = this.usageTracker.get(suggestionId) || 0\n    this.usageTracker.set(suggestionId, currentCount + 1)\n  }\n\n  /**\n   * Initialize suggestion database with common fixes\n   */\n  private initializeSuggestionDatabase(): void {\n    // Extract suggestions from error templates\n    for (const template of Object.values(errorMessageTemplates)) {\n      this.suggestionDatabase.set(template.id, template.suggestions)\n    }\n\n    // Add additional contextual suggestions\n    this.suggestionDatabase.set('common-typos', [\n      {\n        id: 'fix-typo-background',\n        title: 'Fix Background Color Typo',\n        description: 'Correct common typo in background color property',\n        difficulty: 'easy',\n        confidence: 0.9,\n        category: 'syntax',\n        before: '.backround(\"blue\")',\n        after: '.background(\"blue\")',\n        canAutoFix: true,\n        autoFix: () => '.background(\"blue\")',\n        relatedFixes: []\n      }\n    ])\n  }\n\n  /**\n   * Get suggestion statistics\n   */\n  getStatistics() {\n    return {\n      totalSuggestions: Array.from(this.suggestionDatabase.values()).reduce((acc, arr) => acc + arr.length, 0),\n      totalUsages: Array.from(this.usageTracker.values()).reduce((acc, count) => acc + count, 0),\n      topSuggestions: Array.from(this.usageTracker.entries())\n        .sort(([, a], [, b]) => b - a)\n        .slice(0, 5)\n    }\n  }\n}\n\n/**\n * Enhanced error message formatter with rich templates\n */\nexport class EnhancedErrorFormatter {\n  private fixEngine = new FixSuggestionEngine()\n\n  /**\n   * Format error with enhanced template\n   */\n  formatError(\n    error: EnhancedValidationError,\n    templateId?: string\n  ): FormattedErrorMessage {\n    const template = templateId ? errorMessageTemplates[templateId] : this.findBestTemplate(error)\n    \n    if (!template) {\n      return this.formatBasicError(error)\n    }\n\n    const suggestions = this.fixEngine.getSuggestions(template.id, {\n      component: error.context.component,\n      severity: template.severity\n    })\n\n    return {\n      id: `error-${Date.now()}`,\n      template,\n      error,\n      suggestions,\n      formatted: this.renderFormattedMessage(template, error, suggestions),\n      interactive: {\n        canAutoFix: suggestions.some(s => s.canAutoFix),\n        quickActions: this.generateQuickActions(suggestions),\n        learnMore: template.documentation\n      }\n    }\n  }\n\n  /**\n   * Find the best template for an error\n   */\n  private findBestTemplate(error: EnhancedValidationError): DeveloperErrorMessageTemplate | null {\n    // Simple heuristic matching - could be made more sophisticated\n    if (error.message.includes('required')) {\n      return errorMessageTemplates['missing-required-prop']\n    }\n    if (error.message.includes('modifier')) {\n      return errorMessageTemplates['invalid-modifier-usage']\n    }\n    if (error.message.includes('performance')) {\n      return errorMessageTemplates['performance-warning']\n    }\n    return null\n  }\n\n  /**\n   * Render formatted message with rich content\n   */\n  private renderFormattedMessage(\n    template: DeveloperErrorMessageTemplate,\n    error: EnhancedValidationError,\n    suggestions: IntelligentFixSuggestion[]\n  ): string {\n    const { verbosity, showEmojis, showCodeExamples } = devExperienceConfig\n\n    let message = ''\n\n    // Header\n    if (showEmojis) {\n      message += `${template.emoji} `\n    }\n    message += `${template.title}: ${error.message}\\n`\n\n    // Description based on verbosity\n    if (verbosity !== 'minimal') {\n      message += `\\n${template.description}\\n`\n    }\n\n    // Quick fix\n    if (verbosity === 'standard' || verbosity === 'detailed' || verbosity === 'comprehensive') {\n      message += `\\n💡 Quick Fix: ${template.quickFix}\\n`\n    }\n\n    // Code examples\n    if (showCodeExamples && template.examples.wrong.length > 0) {\n      message += `\\n❌ Wrong:\\n${template.examples.wrong[0].code}\\n`\n      message += `✅ Correct:\\n${template.examples.correct[0].code}\\n`\n    }\n\n    // Suggestions\n    if (suggestions.length > 0) {\n      message += `\\n🔧 Suggestions:\\n`\n      suggestions.forEach((suggestion, index) => {\n        message += `${index + 1}. ${suggestion.title}: ${suggestion.description}\\n`\n      })\n    }\n\n    // Documentation links\n    if (devExperienceConfig.showDocumentationLinks && template.documentation.primary) {\n      message += `\\n📚 Documentation: ${template.documentation.primary}\\n`\n    }\n\n    return message\n  }\n\n  /**\n   * Format basic error without template\n   */\n  private formatBasicError(error: EnhancedValidationError): FormattedErrorMessage {\n    return {\n      id: `basic-error-${Date.now()}`,\n      template: null,\n      error,\n      suggestions: [],\n      formatted: error.getFormattedMessage(),\n      interactive: {\n        canAutoFix: false,\n        quickActions: [],\n        learnMore: { primary: '/docs/troubleshooting', related: [] }\n      }\n    }\n  }\n\n  /**\n   * Generate quick actions for IDE integration\n   */\n  private generateQuickActions(suggestions: IntelligentFixSuggestion[]): QuickAction[] {\n    return suggestions\n      .filter(s => s.canAutoFix)\n      .map(suggestion => ({\n        id: suggestion.id,\n        title: `Fix: ${suggestion.title}`,\n        description: suggestion.description,\n        command: 'tachui.applyFix',\n        arguments: [suggestion.id]\n      }))\n  }\n}\n\n/**\n * Formatted error message with rich content\n */\nexport interface FormattedErrorMessage {\n  id: string\n  template: DeveloperErrorMessageTemplate | null\n  error: EnhancedValidationError\n  suggestions: IntelligentFixSuggestion[]\n  formatted: string\n  interactive: {\n    canAutoFix: boolean\n    quickActions: QuickAction[]\n    learnMore: {\n      primary: string\n      related: string[]\n    }\n  }\n}\n\n/**\n * Quick action for IDE integration\n */\nexport interface QuickAction {\n  id: string\n  title: string\n  description: string\n  command: string\n  arguments: any[]\n}\n\n/**\n * Configure developer experience\n */\nexport function configureDeveloperExperience(config: Partial<DeveloperExperienceConfig>): void {\n  devExperienceConfig = { ...devExperienceConfig, ...config }\n}\n\n/**\n * Get current developer experience configuration\n */\nexport function getDeveloperExperienceConfig(): DeveloperExperienceConfig {\n  return { ...devExperienceConfig }\n}\n\n// Global instances\nconst enhancedFormatter = new EnhancedErrorFormatter()\nconst fixEngine = new FixSuggestionEngine()\n\n/**\n * Developer Experience utilities\n */\nexport const DeveloperExperienceUtils = {\n  /**\n   * Format error with enhanced template\n   */\n  formatError: (error: EnhancedValidationError, templateId?: string) => \n    enhancedFormatter.formatError(error, templateId),\n\n  /**\n   * Get fix suggestions\n   */\n  getSuggestions: (errorType: string, context: any) => \n    fixEngine.getSuggestions(errorType, context),\n\n  /**\n   * Apply automatic fix\n   */\n  applyAutoFix: (suggestionId: string, code: string) => \n    fixEngine.applyAutoFix(suggestionId, code),\n\n  /**\n   * Get available error templates\n   */\n  getErrorTemplates: () => errorMessageTemplates,\n\n  /**\n   * Configure experience\n   */\n  configure: configureDeveloperExperience,\n\n  /**\n   * Get statistics\n   */\n  getStatistics: () => ({\n    formatter: {\n      templatesAvailable: Object.keys(errorMessageTemplates).length\n    },\n    fixEngine: fixEngine.getStatistics(),\n    config: devExperienceConfig\n  }),\n\n  /**\n   * Test developer experience system\n   */\n  test: () => {\n    console.group('🎨 Developer Experience System Test')\n    \n    try {\n      // Test error formatting\n      const testError = new EnhancedValidationError('Test missing required property', {\n        component: 'Text',\n        property: 'content',\n        recoveryStrategy: 'fallback'\n      })\n      \n      const formatted = enhancedFormatter.formatError(testError, 'missing-required-prop')\n      console.info('✅ Error formatting:', formatted.template?.title)\n      console.info('✅ Suggestions count:', formatted.suggestions.length)\n      console.info('✅ Quick actions:', formatted.interactive.quickActions.length)\n      \n      // Test fix engine\n      const suggestions = fixEngine.getSuggestions('missing-required-prop', { component: 'Text' })\n      console.info('✅ Fix suggestions:', suggestions.length)\n      \n      console.info('✅ Developer experience system is working correctly')\n      \n    } catch (error) {\n      console.error('❌ Developer experience test failed:', error)\n    }\n    \n    console.groupEnd()\n  }\n}\n\n// Export global instances\nexport { enhancedFormatter, fixEngine }"],"names":["devExperienceConfig","errorMessageTemplates","FixSuggestionEngine","__publicField","errorType","_context","suggestion","a","b","aScore","suggestionId","_code","suggestions","s","currentCount","template","acc","arr","count","EnhancedErrorFormatter","error","templateId","verbosity","showEmojis","showCodeExamples","message","index","configureDeveloperExperience","config","getDeveloperExperienceConfig","enhancedFormatter","fixEngine","DeveloperExperienceUtils","context","code","testError","EnhancedValidationError","formatted"],"mappings":"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"}

package/dist/validation/documentation-integration.cjs

@@ -1,7 +0,0 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var y=Object.defineProperty,v=(n,e,t)=>e in n?y(n,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):n[e]=t,m=(n,e,t)=>v(n,typeof e!="symbol"?e+"":e,t);let d={defaultDifficulty:"intermediate",preferredTypes:["guide","api-reference","example"],maxRelatedItems:5,enableLearningProfile:!0,enableRecommendations:!0,enableProgressTracking:!0,showEstimatedTime:!0,showRatings:!0,showPrerequisites:!0,groupByDifficulty:!1,enableInlineHelp:!0,enableContextualSuggestions:!0,enableLearningPaths:!0,enableOfflineMode:!1,cacheDocumentation:!0,offlineStorageLimit:50};const a={"text-component-guide":{id:"text-component-guide",title:"Text Component Guide",description:"Complete guide to using the Text component for displaying content",type:"guide",difficulty:"beginner",url:"/docs/components/text",estimatedReadTime:5,lastUpdated:"2025-01-01",version:"1.0.0",tags:["text","content","typography","basics"],categories:["components","fundamentals"],relatedComponents:["Button","Link"],relatedModifiers:["fontSize","fontWeight","foregroundColor"],prerequisites:[],nextSteps:["button-component-guide","typography-styling"],rating:4.8,completionRate:.92,helpfulnessScore:.95,hasInteractiveExample:!0,hasVideoContent:!1,hasCodeSandbox:!0,isAccessible:!0,hasTranscript:!1,supportedLanguages:["en","es","fr"]},"button-component-guide":{id:"button-component-guide",title:"Button Component Guide",description:"Interactive buttons with actions and styling",type:"guide",difficulty:"beginner",url:"/docs/components/button",estimatedReadTime:7,lastUpdated:"2025-01-01",version:"1.0.0",tags:["button","interaction","actions","ui"],categories:["components","interaction"],relatedComponents:["Text","Link","Toggle"],relatedModifiers:["background","foregroundColor","padding","disabled"],prerequisites:["text-component-guide"],nextSteps:["event-handling","styling-components"],rating:4.7,completionRate:.88,helpfulnessScore:.91,hasInteractiveExample:!0,hasVideoContent:!0,hasCodeSandbox:!0,isAccessible:!0,hasTranscript:!0,supportedLanguages:["en"]},"modifier-compatibility":{id:"modifier-compatibility",title:"Modifier Compatibility Reference",description:"Complete reference for which modifiers work with which components",type:"api-reference",difficulty:"intermediate",url:"/docs/modifiers/compatibility",estimatedReadTime:10,lastUpdated:"2025-01-01",version:"1.0.0",tags:["modifiers","compatibility","reference","styling"],categories:["modifiers","reference"],relatedComponents:["*"],relatedModifiers:["*"],prerequisites:["text-component-guide","button-component-guide"],nextSteps:["advanced-styling","custom-modifiers"],rating:4.9,completionRate:.76,helpfulnessScore:.97,hasInteractiveExample:!0,hasVideoContent:!1,hasCodeSandbox:!1,isAccessible:!0,hasTranscript:!1,supportedLanguages:["en"]},"troubleshooting-errors":{id:"troubleshooting-errors",title:"Common Validation Errors",description:"Solutions for common TachUI validation errors and warnings",type:"troubleshooting",difficulty:"beginner",url:"/docs/troubleshooting/validation-errors",estimatedReadTime:15,lastUpdated:"2025-01-01",version:"1.0.0",tags:["troubleshooting","errors","validation","debugging"],categories:["troubleshooting","validation"],relatedComponents:["*"],relatedModifiers:["*"],prerequisites:[],nextSteps:["advanced-debugging","error-handling"],rating:4.6,completionRate:.85,helpfulnessScore:.93,hasInteractiveExample:!0,hasVideoContent:!0,hasCodeSandbox:!1,isAccessible:!0,hasTranscript:!0,supportedLanguages:["en","es"]},"performance-optimization":{id:"performance-optimization",title:"Performance Best Practices",description:"Optimize your TachUI applications for better performance",type:"best-practices",difficulty:"advanced",url:"/docs/guides/performance",estimatedReadTime:20,lastUpdated:"2025-01-01",version:"1.0.0",tags:["performance","optimization","best-practices","advanced"],categories:["performance","optimization"],relatedComponents:["List","VirtualList","Image"],relatedModifiers:["clipped","opacity"],prerequisites:["modifier-compatibility","component-lifecycle"],nextSteps:["memory-optimization","bundle-optimization"],rating:4.5,completionRate:.62,helpfulnessScore:.89,hasInteractiveExample:!0,hasVideoContent:!0,hasCodeSandbox:!0,isAccessible:!0,hasTranscript:!0,supportedLanguages:["en"]}};class f{constructor(){m(this,"userProfile",null),m(this,"usageStats",new Map)}getContextualDocumentation(e){const t=this.findRelevantResources(e);if(t.length===0)return null;const o=this.selectPrimaryResource(t,e),i=this.selectRelatedResources(t,o);return{primary:o,related:i,quickHelp:this.generateQuickHelp(o,e),codeExamples:this.generateCodeExamples(o,e),commonPitfalls:this.getCommonPitfalls(o,e),learningPath:this.generateLearningPath(o)}}findRelevantResources(e){return Object.values(a).filter(o=>{if(e.component&&!o.relatedComponents.includes(e.component)&&!o.relatedComponents.includes("*")||e.modifier&&!o.relatedModifiers.includes(e.modifier)&&!o.relatedModifiers.includes("*"))return!1;if(e.errorType&&(o.type==="troubleshooting"||o.tags.includes(e.errorType)))return!0;if(e.userLevel){const i=["beginner","intermediate","advanced","expert"],r=i.indexOf(e.userLevel);if(i.indexOf(o.difficulty)>r+1)return!1}return!0})}selectPrimaryResource(e,t){const o=e.map(i=>({resource:i,score:this.calculateRelevanceScore(i,t)}));return o.sort((i,r)=>r.score-i.score),o[0].resource}calculateRelevanceScore(e,t){let o=0;o+=e.rating*.2,o+=e.helpfulnessScore*.3,o+=e.completionRate*.1,t.component&&e.relatedComponents.includes(t.component)&&(o+=.4),t.modifier&&e.relatedModifiers.includes(t.modifier)&&(o+=.3),t.errorType&&e.tags.includes(t.errorType)&&(o+=.5),this.userProfile&&(this.userProfile.preferredDocumentationTypes.includes(e.type)&&(o+=.2),this.userProfile.completedResources.includes(e.id)&&(o-=.1));const i=this.usageStats.get(e.id)||0;return o+=Math.min(i*.05,.2),o}selectRelatedResources(e,t){return e.filter(i=>i.id!==t.id).sort((i,r)=>{const s=t.nextSteps.includes(i.id)?1:0,l=t.nextSteps.includes(r.id)?1:0;return s!==l?l-s:r.rating-i.rating}).slice(0,d.maxRelatedItems)}generateQuickHelp(e,t){return{"missing-required-prop":"Components require specific properties to function. Check the component documentation for required parameters.","invalid-modifier-usage":"Modifiers have compatibility restrictions. Use the modifier compatibility reference to find valid combinations.","performance-warning":"Performance optimizations can improve user experience. Consider the suggested improvements for better performance."}[t.errorType]||e.description}generateCodeExamples(e,t){const o={basic:`// Basic usage example
-// See documentation for details`,advanced:`// Advanced usage example
-// See documentation for details`,realWorld:`// Real-world example
-// See documentation for details`};return t.component==="Text"?(o.basic='Text("Hello World")',o.advanced='Text(() => dynamicContent.value).fontSize(16).foregroundColor("blue")',o.realWorld='Text(userProfile.name).fontSize(18).fontWeight("bold").padding(8)'):t.component==="Button"&&(o.basic='Button("Click me", handleClick)',o.advanced='Button("Submit", handleSubmit).background("blue").foregroundColor("white").disabled(isLoading)',o.realWorld='Button("Save Changes", saveUserProfile).background(theme.primary).padding({ horizontal: 16, vertical: 8 })'),o}getCommonPitfalls(e,t){return[{issue:"Forgetting required parameters",solution:"Always check component documentation for required properties",example:`Text() // Wrong
-Text("content") // Correct`},{issue:"Using incompatible modifiers",solution:"Check modifier compatibility before applying",example:`VStack().fontSize(16) // Wrong
-Text("hello").fontSize(16) // Correct`}]}generateLearningPath(e){const t=e.nextSteps.map(i=>a[i]).filter(Boolean).slice(0,3);let o=0;if(this.userProfile){const i=e.nextSteps.length+e.prerequisites.length+1;o=[...e.prerequisites,e.id,...e.nextSteps].filter(s=>this.userProfile.completedResources.includes(s)).length/i}return{current:e,next:t,progress:o}}setUserProfile(e){this.userProfile=e}trackResourceUsage(e){const t=this.usageStats.get(e)||0;this.usageStats.set(e,t+1)}getPersonalizedRecommendations(e=5){if(!this.userProfile||!d.enableRecommendations)return[];const i=Object.values(a).filter(r=>!this.userProfile.completedResources.includes(r.id)).map(r=>({resource:r,score:this.calculatePersonalizationScore(r)}));return i.sort((r,s)=>s.score-r.score),i.slice(0,e).map(r=>r.resource)}calculatePersonalizationScore(e){if(!this.userProfile)return 0;let t=0;const o=["beginner","intermediate","advanced","expert"],i=o.indexOf(this.userProfile.skillLevel),r=o.indexOf(e.difficulty);r===i?t+=.4:r===i+1?t+=.3:r<i&&(t+=.1),this.userProfile.preferredDocumentationTypes.includes(e.type)&&(t+=.3);const s=this.userProfile.mostUsedComponents,l=this.userProfile.mostUsedModifiers;return e.relatedComponents.some(u=>s.includes(u))&&(t+=.2),e.relatedModifiers.some(u=>l.includes(u))&&(t+=.1),t}getStatistics(){return{totalResources:Object.keys(a).length,resourcesByType:this.groupResourcesByType(),resourcesByDifficulty:this.groupResourcesByDifficulty(),totalUsages:Array.from(this.usageStats.values()).reduce((e,t)=>e+t,0),averageRating:this.calculateAverageRating(),completionRates:this.getCompletionRates()}}groupResourcesByType(){const e={};return Object.values(a).forEach(t=>{e[t.type]=(e[t.type]||0)+1}),e}groupResourcesByDifficulty(){const e={};return Object.values(a).forEach(t=>{e[t.difficulty]=(e[t.difficulty]||0)+1}),e}calculateAverageRating(){const e=Object.values(a);return e.reduce((o,i)=>o+i.rating,0)/e.length}getCompletionRates(){const e=Object.values(a),o=e.reduce((s,l)=>s+l.completionRate,0)/e.length,i={},r=this.groupResourcesByDifficulty();return Object.keys(r).forEach(s=>{const l=e.filter(p=>p.difficulty===s),u=l.reduce((p,b)=>p+b.completionRate,0);i[s]=u/l.length}),{average:o,byDifficulty:i}}}function g(n){d={...d,...n}}function h(){return{...d}}const c=new f,R={getContextualDocumentation:n=>c.getContextualDocumentation(n),getRecommendations:n=>c.getPersonalizedRecommendations(n),setUserProfile:n=>c.setUserProfile(n),trackUsage:n=>c.trackResourceUsage(n),configure:g,getConfig:h,getStatistics:()=>c.getStatistics(),getAllResources:()=>a,test:()=>{console.group("📚 Documentation Integration System Test");try{const n=c.getContextualDocumentation({component:"Text",errorType:"missing-required-prop",userLevel:"beginner"});console.info("✅ Contextual documentation:",!!n),n&&(console.info("✅ Primary resource:",n.primary.title),console.info("✅ Related resources:",n.related.length),console.info("✅ Quick help available:",!!n.quickHelp));const e=c.getPersonalizedRecommendations(3);console.info("✅ Recommendations available:",e.length);const t=c.getStatistics();console.info("✅ Total resources:",t.totalResources),console.info("✅ Average rating:",t.averageRating.toFixed(1)),console.info("✅ Documentation integration system is working correctly")}catch(n){console.error("❌ Documentation integration test failed:",n)}console.groupEnd()}};exports.DocumentationIntegrationUtils=R;exports.DocumentationProvider=f;exports.configureDocumentationIntegration=g;exports.documentationDatabase=a;exports.documentationProvider=c;exports.getDocumentationConfig=h;
-//# sourceMappingURL=documentation-integration.cjs.map

package/dist/validation/documentation-integration.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"documentation-integration.cjs","sources":["../../src/validation/documentation-integration.ts"],"sourcesContent":["/**\n * Documentation Integration System - Phase 1D\n * \n * Context-aware help, intelligent documentation links,\n * and comprehensive learning resource management.\n */\n\nimport type { ValidationErrorCategory } from './error-reporting'\n\n/**\n * Documentation resource types\n */\nexport type DocumentationType = \n  | 'guide' \n  | 'api-reference' \n  | 'tutorial' \n  | 'example' \n  | 'video' \n  | 'troubleshooting'\n  | 'best-practices'\n\n/**\n * Learning difficulty levels\n */\nexport type DifficultyLevel = 'beginner' | 'intermediate' | 'advanced' | 'expert'\n\n/**\n * Documentation resource\n */\nexport interface DocumentationResource {\n  id: string\n  title: string\n  description: string\n  type: DocumentationType\n  difficulty: DifficultyLevel\n  \n  // Content metadata\n  url: string\n  estimatedReadTime: number // minutes\n  lastUpdated: string\n  version: string\n  \n  // Categorization\n  tags: string[]\n  categories: string[]\n  relatedComponents: string[]\n  relatedModifiers: string[]\n  \n  // Learning path\n  prerequisites: string[]\n  nextSteps: string[]\n  \n  // Quality metrics\n  rating: number // 1-5\n  completionRate: number // 0-1\n  helpfulnessScore: number // 0-1\n  \n  // Interactive features\n  hasInteractiveExample: boolean\n  hasVideoContent: boolean\n  hasCodeSandbox: boolean\n  \n  // Accessibility\n  isAccessible: boolean\n  hasTranscript: boolean\n  supportedLanguages: string[]\n}\n\n/**\n * Context-aware documentation provider\n */\nexport interface ContextualDocumentation {\n  primary: DocumentationResource\n  related: DocumentationResource[]\n  quickHelp: string\n  codeExamples: {\n    basic: string\n    advanced: string\n    realWorld: string\n  }\n  commonPitfalls: {\n    issue: string\n    solution: string\n    example: string\n  }[]\n  learningPath: {\n    current: DocumentationResource\n    next: DocumentationResource[]\n    progress: number // 0-1\n  }\n}\n\n/**\n * User learning profile for personalization\n */\nexport interface UserLearningProfile {\n  id: string\n  skillLevel: DifficultyLevel\n  preferredLearningStyle: 'visual' | 'reading' | 'hands-on' | 'video'\n  completedResources: string[]\n  bookmarkedResources: string[]\n  learningGoals: string[]\n  weakAreas: string[]\n  strongAreas: string[]\n  \n  // Behavior tracking\n  averageReadTime: number\n  preferredDocumentationTypes: DocumentationType[]\n  mostUsedComponents: string[]\n  mostUsedModifiers: string[]\n  \n  // Preferences\n  enablePersonalization: boolean\n  enableProgressTracking: boolean\n  enableRecommendations: boolean\n}\n\n/**\n * Documentation integration configuration\n */\nexport interface DocumentationConfig {\n  // Content preferences\n  defaultDifficulty: DifficultyLevel\n  preferredTypes: DocumentationType[]\n  maxRelatedItems: number\n  \n  // Personalization\n  enableLearningProfile: boolean\n  enableRecommendations: boolean\n  enableProgressTracking: boolean\n  \n  // Display options\n  showEstimatedTime: boolean\n  showRatings: boolean\n  showPrerequisites: boolean\n  groupByDifficulty: boolean\n  \n  // Integration features\n  enableInlineHelp: boolean\n  enableContextualSuggestions: boolean\n  enableLearningPaths: boolean\n  \n  // Offline support\n  enableOfflineMode: boolean\n  cacheDocumentation: boolean\n  offlineStorageLimit: number // MB\n}\n\n/**\n * Global documentation configuration\n */\nlet docConfig: DocumentationConfig = {\n  defaultDifficulty: 'intermediate',\n  preferredTypes: ['guide', 'api-reference', 'example'],\n  maxRelatedItems: 5,\n  enableLearningProfile: true,\n  enableRecommendations: true,\n  enableProgressTracking: true,\n  showEstimatedTime: true,\n  showRatings: true,\n  showPrerequisites: true,\n  groupByDifficulty: false,\n  enableInlineHelp: true,\n  enableContextualSuggestions: true,\n  enableLearningPaths: true,\n  enableOfflineMode: false,\n  cacheDocumentation: true,\n  offlineStorageLimit: 50\n}\n\n/**\n * Comprehensive documentation database\n */\nexport const documentationDatabase: Record<string, DocumentationResource> = {\n  'text-component-guide': {\n    id: 'text-component-guide',\n    title: 'Text Component Guide',\n    description: 'Complete guide to using the Text component for displaying content',\n    type: 'guide',\n    difficulty: 'beginner',\n    url: '/docs/components/text',\n    estimatedReadTime: 5,\n    lastUpdated: '2025-01-01',\n    version: '1.0.0',\n    tags: ['text', 'content', 'typography', 'basics'],\n    categories: ['components', 'fundamentals'],\n    relatedComponents: ['Button', 'Link'],\n    relatedModifiers: ['fontSize', 'fontWeight', 'foregroundColor'],\n    prerequisites: [],\n    nextSteps: ['button-component-guide', 'typography-styling'],\n    rating: 4.8,\n    completionRate: 0.92,\n    helpfulnessScore: 0.95,\n    hasInteractiveExample: true,\n    hasVideoContent: false,\n    hasCodeSandbox: true,\n    isAccessible: true,\n    hasTranscript: false,\n    supportedLanguages: ['en', 'es', 'fr']\n  },\n\n  'button-component-guide': {\n    id: 'button-component-guide',\n    title: 'Button Component Guide',\n    description: 'Interactive buttons with actions and styling',\n    type: 'guide',\n    difficulty: 'beginner',\n    url: '/docs/components/button',\n    estimatedReadTime: 7,\n    lastUpdated: '2025-01-01',\n    version: '1.0.0',\n    tags: ['button', 'interaction', 'actions', 'ui'],\n    categories: ['components', 'interaction'],\n    relatedComponents: ['Text', 'Link', 'Toggle'],\n    relatedModifiers: ['background', 'foregroundColor', 'padding', 'disabled'],\n    prerequisites: ['text-component-guide'],\n    nextSteps: ['event-handling', 'styling-components'],\n    rating: 4.7,\n    completionRate: 0.88,\n    helpfulnessScore: 0.91,\n    hasInteractiveExample: true,\n    hasVideoContent: true,\n    hasCodeSandbox: true,\n    isAccessible: true,\n    hasTranscript: true,\n    supportedLanguages: ['en']\n  },\n\n  'modifier-compatibility': {\n    id: 'modifier-compatibility',\n    title: 'Modifier Compatibility Reference',\n    description: 'Complete reference for which modifiers work with which components',\n    type: 'api-reference',\n    difficulty: 'intermediate',\n    url: '/docs/modifiers/compatibility',\n    estimatedReadTime: 10,\n    lastUpdated: '2025-01-01',\n    version: '1.0.0',\n    tags: ['modifiers', 'compatibility', 'reference', 'styling'],\n    categories: ['modifiers', 'reference'],\n    relatedComponents: ['*'],\n    relatedModifiers: ['*'],\n    prerequisites: ['text-component-guide', 'button-component-guide'],\n    nextSteps: ['advanced-styling', 'custom-modifiers'],\n    rating: 4.9,\n    completionRate: 0.76,\n    helpfulnessScore: 0.97,\n    hasInteractiveExample: true,\n    hasVideoContent: false,\n    hasCodeSandbox: false,\n    isAccessible: true,\n    hasTranscript: false,\n    supportedLanguages: ['en']\n  },\n\n  'troubleshooting-errors': {\n    id: 'troubleshooting-errors',\n    title: 'Common Validation Errors',\n    description: 'Solutions for common TachUI validation errors and warnings',\n    type: 'troubleshooting',\n    difficulty: 'beginner',\n    url: '/docs/troubleshooting/validation-errors',\n    estimatedReadTime: 15,\n    lastUpdated: '2025-01-01',\n    version: '1.0.0',\n    tags: ['troubleshooting', 'errors', 'validation', 'debugging'],\n    categories: ['troubleshooting', 'validation'],\n    relatedComponents: ['*'],\n    relatedModifiers: ['*'],\n    prerequisites: [],\n    nextSteps: ['advanced-debugging', 'error-handling'],\n    rating: 4.6,\n    completionRate: 0.85,\n    helpfulnessScore: 0.93,\n    hasInteractiveExample: true,\n    hasVideoContent: true,\n    hasCodeSandbox: false,\n    isAccessible: true,\n    hasTranscript: true,\n    supportedLanguages: ['en', 'es']\n  },\n\n  'performance-optimization': {\n    id: 'performance-optimization',\n    title: 'Performance Best Practices',\n    description: 'Optimize your TachUI applications for better performance',\n    type: 'best-practices',\n    difficulty: 'advanced',\n    url: '/docs/guides/performance',\n    estimatedReadTime: 20,\n    lastUpdated: '2025-01-01',\n    version: '1.0.0',\n    tags: ['performance', 'optimization', 'best-practices', 'advanced'],\n    categories: ['performance', 'optimization'],\n    relatedComponents: ['List', 'VirtualList', 'Image'],\n    relatedModifiers: ['clipped', 'opacity'],\n    prerequisites: ['modifier-compatibility', 'component-lifecycle'],\n    nextSteps: ['memory-optimization', 'bundle-optimization'],\n    rating: 4.5,\n    completionRate: 0.62,\n    helpfulnessScore: 0.89,\n    hasInteractiveExample: true,\n    hasVideoContent: true,\n    hasCodeSandbox: true,\n    isAccessible: true,\n    hasTranscript: true,\n    supportedLanguages: ['en']\n  }\n}\n\n/**\n * Context-aware documentation provider\n */\nexport class DocumentationProvider {\n  private userProfile: UserLearningProfile | null = null\n  private usageStats = new Map<string, number>()\n\n  /**\n   * Get contextual documentation for an error or component\n   */\n  getContextualDocumentation(context: {\n    component?: string\n    modifier?: string\n    errorType?: string\n    category?: ValidationErrorCategory\n    userLevel?: DifficultyLevel\n  }): ContextualDocumentation | null {\n    const relevantResources = this.findRelevantResources(context)\n    \n    if (relevantResources.length === 0) {\n      return null\n    }\n\n    const primary = this.selectPrimaryResource(relevantResources, context)\n    const related = this.selectRelatedResources(relevantResources, primary)\n    \n    return {\n      primary,\n      related,\n      quickHelp: this.generateQuickHelp(primary, context),\n      codeExamples: this.generateCodeExamples(primary, context),\n      commonPitfalls: this.getCommonPitfalls(primary, context),\n      learningPath: this.generateLearningPath(primary)\n    }\n  }\n\n  /**\n   * Find relevant documentation resources\n   */\n  private findRelevantResources(context: {\n    component?: string\n    modifier?: string\n    errorType?: string\n    category?: ValidationErrorCategory\n    userLevel?: DifficultyLevel\n  }): DocumentationResource[] {\n    const resources = Object.values(documentationDatabase)\n    \n    return resources.filter(resource => {\n      // Component relevance\n      if (context.component) {\n        if (!resource.relatedComponents.includes(context.component) && \n            !resource.relatedComponents.includes('*')) {\n          return false\n        }\n      }\n\n      // Modifier relevance\n      if (context.modifier) {\n        if (!resource.relatedModifiers.includes(context.modifier) && \n            !resource.relatedModifiers.includes('*')) {\n          return false\n        }\n      }\n\n      // Error type relevance\n      if (context.errorType) {\n        if (resource.type === 'troubleshooting' || \n            resource.tags.includes(context.errorType)) {\n          return true\n        }\n      }\n\n      // Difficulty level filtering\n      if (context.userLevel) {\n        const levelOrder = ['beginner', 'intermediate', 'advanced', 'expert']\n        const userLevelIndex = levelOrder.indexOf(context.userLevel)\n        const resourceLevelIndex = levelOrder.indexOf(resource.difficulty)\n        \n        // Show resources at or slightly above user level\n        if (resourceLevelIndex > userLevelIndex + 1) {\n          return false\n        }\n      }\n\n      return true\n    })\n  }\n\n  /**\n   * Select primary documentation resource\n   */\n  private selectPrimaryResource(\n    resources: DocumentationResource[], \n    context: any\n  ): DocumentationResource {\n    // Sort by relevance score\n    const scored = resources.map(resource => ({\n      resource,\n      score: this.calculateRelevanceScore(resource, context)\n    }))\n\n    scored.sort((a, b) => b.score - a.score)\n    return scored[0].resource\n  }\n\n  /**\n   * Calculate relevance score for a resource\n   */\n  private calculateRelevanceScore(resource: DocumentationResource, context: any): number {\n    let score = 0\n\n    // Base quality score\n    score += resource.rating * 0.2\n    score += resource.helpfulnessScore * 0.3\n    score += resource.completionRate * 0.1\n\n    // Context relevance\n    if (context.component && resource.relatedComponents.includes(context.component)) {\n      score += 0.4\n    }\n    if (context.modifier && resource.relatedModifiers.includes(context.modifier)) {\n      score += 0.3\n    }\n    if (context.errorType && resource.tags.includes(context.errorType)) {\n      score += 0.5\n    }\n\n    // User preference bonus\n    if (this.userProfile) {\n      if (this.userProfile.preferredDocumentationTypes.includes(resource.type)) {\n        score += 0.2\n      }\n      if (this.userProfile.completedResources.includes(resource.id)) {\n        score -= 0.1 // Slightly prefer new content\n      }\n    }\n\n    // Usage statistics\n    const usageCount = this.usageStats.get(resource.id) || 0\n    score += Math.min(usageCount * 0.05, 0.2) // Cap usage bonus\n\n    return score\n  }\n\n  /**\n   * Select related resources\n   */\n  private selectRelatedResources(\n    allResources: DocumentationResource[], \n    primary: DocumentationResource\n  ): DocumentationResource[] {\n    const related = allResources\n      .filter(resource => resource.id !== primary.id)\n      .sort((a, b) => {\n        // Prefer next steps and prerequisites\n        const aIsNext = primary.nextSteps.includes(a.id) ? 1 : 0\n        const bIsNext = primary.nextSteps.includes(b.id) ? 1 : 0\n        if (aIsNext !== bIsNext) return bIsNext - aIsNext\n\n        // Then by rating\n        return b.rating - a.rating\n      })\n\n    return related.slice(0, docConfig.maxRelatedItems)\n  }\n\n  /**\n   * Generate quick help text\n   */\n  private generateQuickHelp(primary: DocumentationResource, context: any): string {\n    const contextualHelpers: Record<string, string> = {\n      'missing-required-prop': 'Components require specific properties to function. Check the component documentation for required parameters.',\n      'invalid-modifier-usage': 'Modifiers have compatibility restrictions. Use the modifier compatibility reference to find valid combinations.',\n      'performance-warning': 'Performance optimizations can improve user experience. Consider the suggested improvements for better performance.'\n    }\n\n    return contextualHelpers[context.errorType] || primary.description\n  }\n\n  /**\n   * Generate contextual code examples\n   */\n  private generateCodeExamples(_primary: DocumentationResource, context: any): {\n    basic: string\n    advanced: string\n    realWorld: string\n  } {\n    const examples = {\n      basic: '// Basic usage example\\n// See documentation for details',\n      advanced: '// Advanced usage example\\n// See documentation for details',\n      realWorld: '// Real-world example\\n// See documentation for details'\n    }\n\n    // Customize based on context\n    if (context.component === 'Text') {\n      examples.basic = 'Text(\"Hello World\")'\n      examples.advanced = 'Text(() => dynamicContent.value).fontSize(16).foregroundColor(\"blue\")'\n      examples.realWorld = 'Text(userProfile.name).fontSize(18).fontWeight(\"bold\").padding(8)'\n    } else if (context.component === 'Button') {\n      examples.basic = 'Button(\"Click me\", handleClick)'\n      examples.advanced = 'Button(\"Submit\", handleSubmit).background(\"blue\").foregroundColor(\"white\").disabled(isLoading)'\n      examples.realWorld = 'Button(\"Save Changes\", saveUserProfile).background(theme.primary).padding({ horizontal: 16, vertical: 8 })'\n    }\n\n    return examples\n  }\n\n  /**\n   * Get common pitfalls for a resource\n   */\n  private getCommonPitfalls(_primary: DocumentationResource, _context: any): {\n    issue: string\n    solution: string\n    example: string\n  }[] {\n    const pitfalls = [\n      {\n        issue: 'Forgetting required parameters',\n        solution: 'Always check component documentation for required properties',\n        example: 'Text() // Wrong\\nText(\"content\") // Correct'\n      },\n      {\n        issue: 'Using incompatible modifiers',\n        solution: 'Check modifier compatibility before applying',\n        example: 'VStack().fontSize(16) // Wrong\\nText(\"hello\").fontSize(16) // Correct'\n      }\n    ]\n\n    return pitfalls\n  }\n\n  /**\n   * Generate learning path\n   */\n  private generateLearningPath(primary: DocumentationResource): {\n    current: DocumentationResource\n    next: DocumentationResource[]\n    progress: number\n  } {\n    const nextResources = primary.nextSteps\n      .map(id => documentationDatabase[id])\n      .filter(Boolean)\n      .slice(0, 3)\n\n    let progress = 0\n    if (this.userProfile) {\n      const totalRecommended = primary.nextSteps.length + primary.prerequisites.length + 1\n      const completed = [\n        ...primary.prerequisites,\n        primary.id,\n        ...primary.nextSteps\n      ].filter(id => this.userProfile!.completedResources.includes(id)).length\n\n      progress = completed / totalRecommended\n    }\n\n    return {\n      current: primary,\n      next: nextResources,\n      progress\n    }\n  }\n\n  /**\n   * Set user learning profile\n   */\n  setUserProfile(profile: UserLearningProfile): void {\n    this.userProfile = profile\n  }\n\n  /**\n   * Track resource usage\n   */\n  trackResourceUsage(resourceId: string): void {\n    const currentCount = this.usageStats.get(resourceId) || 0\n    this.usageStats.set(resourceId, currentCount + 1)\n  }\n\n  /**\n   * Get personalized recommendations\n   */\n  getPersonalizedRecommendations(limit: number = 5): DocumentationResource[] {\n    if (!this.userProfile || !docConfig.enableRecommendations) {\n      return []\n    }\n\n    const allResources = Object.values(documentationDatabase)\n    \n    // Filter out completed resources\n    const uncompletedResources = allResources.filter(\n      resource => !this.userProfile!.completedResources.includes(resource.id)\n    )\n\n    // Score based on user profile\n    const scored = uncompletedResources.map(resource => ({\n      resource,\n      score: this.calculatePersonalizationScore(resource)\n    }))\n\n    scored.sort((a, b) => b.score - a.score)\n    return scored.slice(0, limit).map(item => item.resource)\n  }\n\n  /**\n   * Calculate personalization score\n   */\n  private calculatePersonalizationScore(resource: DocumentationResource): number {\n    if (!this.userProfile) return 0\n\n    let score = 0\n\n    // Difficulty alignment\n    const levelOrder = ['beginner', 'intermediate', 'advanced', 'expert']\n    const userLevelIndex = levelOrder.indexOf(this.userProfile.skillLevel)\n    const resourceLevelIndex = levelOrder.indexOf(resource.difficulty)\n    \n    if (resourceLevelIndex === userLevelIndex) {\n      score += 0.4 // Perfect match\n    } else if (resourceLevelIndex === userLevelIndex + 1) {\n      score += 0.3 // Slightly challenging\n    } else if (resourceLevelIndex < userLevelIndex) {\n      score += 0.1 // Review material\n    }\n\n    // Type preference\n    if (this.userProfile.preferredDocumentationTypes.includes(resource.type)) {\n      score += 0.3\n    }\n\n    // Component/modifier usage\n    const userComponents = this.userProfile.mostUsedComponents\n    const userModifiers = this.userProfile.mostUsedModifiers\n    \n    if (resource.relatedComponents.some(comp => userComponents.includes(comp))) {\n      score += 0.2\n    }\n    \n    if (resource.relatedModifiers.some(mod => userModifiers.includes(mod))) {\n      score += 0.1\n    }\n\n    return score\n  }\n\n  /**\n   * Get documentation statistics\n   */\n  getStatistics() {\n    return {\n      totalResources: Object.keys(documentationDatabase).length,\n      resourcesByType: this.groupResourcesByType(),\n      resourcesByDifficulty: this.groupResourcesByDifficulty(),\n      totalUsages: Array.from(this.usageStats.values()).reduce((a, b) => a + b, 0),\n      averageRating: this.calculateAverageRating(),\n      completionRates: this.getCompletionRates()\n    }\n  }\n\n  /**\n   * Group resources by type\n   */\n  private groupResourcesByType(): Record<DocumentationType, number> {\n    const grouped: Record<string, number> = {}\n    \n    Object.values(documentationDatabase).forEach(resource => {\n      grouped[resource.type] = (grouped[resource.type] || 0) + 1\n    })\n\n    return grouped as Record<DocumentationType, number>\n  }\n\n  /**\n   * Group resources by difficulty\n   */\n  private groupResourcesByDifficulty(): Record<DifficultyLevel, number> {\n    const grouped: Record<string, number> = {}\n    \n    Object.values(documentationDatabase).forEach(resource => {\n      grouped[resource.difficulty] = (grouped[resource.difficulty] || 0) + 1\n    })\n\n    return grouped as Record<DifficultyLevel, number>\n  }\n\n  /**\n   * Calculate average rating\n   */\n  private calculateAverageRating(): number {\n    const resources = Object.values(documentationDatabase)\n    const totalRating = resources.reduce((sum, resource) => sum + resource.rating, 0)\n    return totalRating / resources.length\n  }\n\n  /**\n   * Get completion rates\n   */\n  private getCompletionRates(): { average: number; byDifficulty: Record<DifficultyLevel, number> } {\n    const resources = Object.values(documentationDatabase)\n    const totalCompletion = resources.reduce((sum, resource) => sum + resource.completionRate, 0)\n    const average = totalCompletion / resources.length\n\n    const byDifficulty: Record<string, number> = {}\n    const difficultyGroups = this.groupResourcesByDifficulty()\n    \n    Object.keys(difficultyGroups).forEach(difficulty => {\n      const difficultyResources = resources.filter(r => r.difficulty === difficulty)\n      const difficultyCompletion = difficultyResources.reduce((sum, r) => sum + r.completionRate, 0)\n      byDifficulty[difficulty] = difficultyCompletion / difficultyResources.length\n    })\n\n    return {\n      average,\n      byDifficulty: byDifficulty as Record<DifficultyLevel, number>\n    }\n  }\n}\n\n/**\n * Configure documentation integration\n */\nexport function configureDocumentationIntegration(config: Partial<DocumentationConfig>): void {\n  docConfig = { ...docConfig, ...config }\n}\n\n/**\n * Get current documentation configuration\n */\nexport function getDocumentationConfig(): DocumentationConfig {\n  return { ...docConfig }\n}\n\n// Global documentation provider instance\nconst documentationProvider = new DocumentationProvider()\n\n/**\n * Documentation Integration utilities\n */\nexport const DocumentationIntegrationUtils = {\n  /**\n   * Get contextual documentation\n   */\n  getContextualDocumentation: (context: any) => \n    documentationProvider.getContextualDocumentation(context),\n\n  /**\n   * Get personalized recommendations\n   */\n  getRecommendations: (limit?: number) => \n    documentationProvider.getPersonalizedRecommendations(limit),\n\n  /**\n   * Set user profile\n   */\n  setUserProfile: (profile: UserLearningProfile) => \n    documentationProvider.setUserProfile(profile),\n\n  /**\n   * Track resource usage\n   */\n  trackUsage: (resourceId: string) => \n    documentationProvider.trackResourceUsage(resourceId),\n\n  /**\n   * Configure integration\n   */\n  configure: configureDocumentationIntegration,\n\n  /**\n   * Get configuration\n   */\n  getConfig: getDocumentationConfig,\n\n  /**\n   * Get statistics\n   */\n  getStatistics: () => documentationProvider.getStatistics(),\n\n  /**\n   * Get all resources\n   */\n  getAllResources: () => documentationDatabase,\n\n  /**\n   * Test documentation system\n   */\n  test: () => {\n    console.group('📚 Documentation Integration System Test')\n    \n    try {\n      // Test contextual documentation\n      const contextualDocs = documentationProvider.getContextualDocumentation({\n        component: 'Text',\n        errorType: 'missing-required-prop',\n        userLevel: 'beginner'\n      })\n      \n      console.info('✅ Contextual documentation:', !!contextualDocs)\n      if (contextualDocs) {\n        console.info('✅ Primary resource:', contextualDocs.primary.title)\n        console.info('✅ Related resources:', contextualDocs.related.length)\n        console.info('✅ Quick help available:', !!contextualDocs.quickHelp)\n      }\n\n      // Test recommendations\n      const recommendations = documentationProvider.getPersonalizedRecommendations(3)\n      console.info('✅ Recommendations available:', recommendations.length)\n\n      // Test statistics\n      const stats = documentationProvider.getStatistics()\n      console.info('✅ Total resources:', stats.totalResources)\n      console.info('✅ Average rating:', stats.averageRating.toFixed(1))\n\n      console.info('✅ Documentation integration system is working correctly')\n      \n    } catch (error) {\n      console.error('❌ Documentation integration test failed:', error)\n    }\n    \n    console.groupEnd()\n  }\n}\n\n// Export provider instance\nexport { documentationProvider }"],"names":["docConfig","documentationDatabase","DocumentationProvider","__publicField","context","relevantResources","primary","related","resource","levelOrder","userLevelIndex","resources","scored","a","b","score","usageCount","allResources","aIsNext","bIsNext","_primary","examples","_context","nextResources","id","progress","totalRecommended","profile","resourceId","currentCount","limit","item","resourceLevelIndex","userComponents","userModifiers","comp","mod","grouped","sum","average","byDifficulty","difficultyGroups","difficulty","difficultyResources","r","difficultyCompletion","configureDocumentationIntegration","config","getDocumentationConfig","documentationProvider","DocumentationIntegrationUtils","contextualDocs","recommendations","stats","error"],"mappings":"4OAuJA,IAAIA,EAAiC,CACnC,kBAAmB,eACnB,eAAgB,CAAC,QAAS,gBAAiB,SAAS,EACpD,gBAAiB,EACjB,sBAAuB,GACvB,sBAAuB,GACvB,uBAAwB,GACxB,kBAAmB,GACnB,YAAa,GACb,kBAAmB,GACnB,kBAAmB,GACnB,iBAAkB,GAClB,4BAA6B,GAC7B,oBAAqB,GACrB,kBAAmB,GACnB,mBAAoB,GACpB,oBAAqB,EACvB,EAKO,MAAMC,EAA+D,CAC1E,uBAAwB,CACtB,GAAI,uBACJ,MAAO,uBACP,YAAa,oEACb,KAAM,QACN,WAAY,WACZ,IAAK,wBACL,kBAAmB,EACnB,YAAa,aACb,QAAS,QACT,KAAM,CAAC,OAAQ,UAAW,aAAc,QAAQ,EAChD,WAAY,CAAC,aAAc,cAAc,EACzC,kBAAmB,CAAC,SAAU,MAAM,EACpC,iBAAkB,CAAC,WAAY,aAAc,iBAAiB,EAC9D,cAAe,CAAA,EACf,UAAW,CAAC,yBAA0B,oBAAoB,EAC1D,OAAQ,IACR,eAAgB,IAChB,iBAAkB,IAClB,sBAAuB,GACvB,gBAAiB,GACjB,eAAgB,GAChB,aAAc,GACd,cAAe,GACf,mBAAoB,CAAC,KAAM,KAAM,IAAI,CAAA,EAGvC,yBAA0B,CACxB,GAAI,yBACJ,MAAO,yBACP,YAAa,+CACb,KAAM,QACN,WAAY,WACZ,IAAK,0BACL,kBAAmB,EACnB,YAAa,aACb,QAAS,QACT,KAAM,CAAC,SAAU,cAAe,UAAW,IAAI,EAC/C,WAAY,CAAC,aAAc,aAAa,EACxC,kBAAmB,CAAC,OAAQ,OAAQ,QAAQ,EAC5C,iBAAkB,CAAC,aAAc,kBAAmB,UAAW,UAAU,EACzE,cAAe,CAAC,sBAAsB,EACtC,UAAW,CAAC,iBAAkB,oBAAoB,EAClD,OAAQ,IACR,eAAgB,IAChB,iBAAkB,IAClB,sBAAuB,GACvB,gBAAiB,GACjB,eAAgB,GAChB,aAAc,GACd,cAAe,GACf,mBAAoB,CAAC,IAAI,CAAA,EAG3B,yBAA0B,CACxB,GAAI,yBACJ,MAAO,mCACP,YAAa,oEACb,KAAM,gBACN,WAAY,eACZ,IAAK,gCACL,kBAAmB,GACnB,YAAa,aACb,QAAS,QACT,KAAM,CAAC,YAAa,gBAAiB,YAAa,SAAS,EAC3D,WAAY,CAAC,YAAa,WAAW,EACrC,kBAAmB,CAAC,GAAG,EACvB,iBAAkB,CAAC,GAAG,EACtB,cAAe,CAAC,uBAAwB,wBAAwB,EAChE,UAAW,CAAC,mBAAoB,kBAAkB,EAClD,OAAQ,IACR,eAAgB,IAChB,iBAAkB,IAClB,sBAAuB,GACvB,gBAAiB,GACjB,eAAgB,GAChB,aAAc,GACd,cAAe,GACf,mBAAoB,CAAC,IAAI,CAAA,EAG3B,yBAA0B,CACxB,GAAI,yBACJ,MAAO,2BACP,YAAa,6DACb,KAAM,kBACN,WAAY,WACZ,IAAK,0CACL,kBAAmB,GACnB,YAAa,aACb,QAAS,QACT,KAAM,CAAC,kBAAmB,SAAU,aAAc,WAAW,EAC7D,WAAY,CAAC,kBAAmB,YAAY,EAC5C,kBAAmB,CAAC,GAAG,EACvB,iBAAkB,CAAC,GAAG,EACtB,cAAe,CAAA,EACf,UAAW,CAAC,qBAAsB,gBAAgB,EAClD,OAAQ,IACR,eAAgB,IAChB,iBAAkB,IAClB,sBAAuB,GACvB,gBAAiB,GACjB,eAAgB,GAChB,aAAc,GACd,cAAe,GACf,mBAAoB,CAAC,KAAM,IAAI,CAAA,EAGjC,2BAA4B,CAC1B,GAAI,2BACJ,MAAO,6BACP,YAAa,2DACb,KAAM,iBACN,WAAY,WACZ,IAAK,2BACL,kBAAmB,GACnB,YAAa,aACb,QAAS,QACT,KAAM,CAAC,cAAe,eAAgB,iBAAkB,UAAU,EAClE,WAAY,CAAC,cAAe,cAAc,EAC1C,kBAAmB,CAAC,OAAQ,cAAe,OAAO,EAClD,iBAAkB,CAAC,UAAW,SAAS,EACvC,cAAe,CAAC,yBAA0B,qBAAqB,EAC/D,UAAW,CAAC,sBAAuB,qBAAqB,EACxD,OAAQ,IACR,eAAgB,IAChB,iBAAkB,IAClB,sBAAuB,GACvB,gBAAiB,GACjB,eAAgB,GAChB,aAAc,GACd,cAAe,GACf,mBAAoB,CAAC,IAAI,CAAA,CAE7B,EAKO,MAAMC,CAAsB,CAA5B,aAAA,CACLC,EAAA,KAAQ,cAA0C,IAAA,EAClDA,EAAA,KAAQ,iBAAiB,GAAoB,CAAA,CAK7C,2BAA2BC,EAMQ,CACjC,MAAMC,EAAoB,KAAK,sBAAsBD,CAAO,EAE5D,GAAIC,EAAkB,SAAW,EAC/B,OAAO,KAGT,MAAMC,EAAU,KAAK,sBAAsBD,EAAmBD,CAAO,EAC/DG,EAAU,KAAK,uBAAuBF,EAAmBC,CAAO,EAEtE,MAAO,CACL,QAAAA,EACA,QAAAC,EACA,UAAW,KAAK,kBAAkBD,EAASF,CAAO,EAClD,aAAc,KAAK,qBAAqBE,EAASF,CAAO,EACxD,eAAgB,KAAK,kBAAkBE,EAASF,CAAO,EACvD,aAAc,KAAK,qBAAqBE,CAAO,CAAA,CAEnD,CAKQ,sBAAsBF,EAMF,CAG1B,OAFkB,OAAO,OAAOH,CAAqB,EAEpC,OAAOO,GAAY,CAUlC,GARIJ,EAAQ,WACN,CAACI,EAAS,kBAAkB,SAASJ,EAAQ,SAAS,GACtD,CAACI,EAAS,kBAAkB,SAAS,GAAG,GAM1CJ,EAAQ,UACN,CAACI,EAAS,iBAAiB,SAASJ,EAAQ,QAAQ,GACpD,CAACI,EAAS,iBAAiB,SAAS,GAAG,EACzC,MAAO,GAKX,GAAIJ,EAAQ,YACNI,EAAS,OAAS,mBAClBA,EAAS,KAAK,SAASJ,EAAQ,SAAS,GAC1C,MAAO,GAKX,GAAIA,EAAQ,UAAW,CACrB,MAAMK,EAAa,CAAC,WAAY,eAAgB,WAAY,QAAQ,EAC9DC,EAAiBD,EAAW,QAAQL,EAAQ,SAAS,EAI3D,GAH2BK,EAAW,QAAQD,EAAS,UAAU,EAGxCE,EAAiB,EACxC,MAAO,EAEX,CAEA,MAAO,EACT,CAAC,CACH,CAKQ,sBACNC,EACAP,EACuB,CAEvB,MAAMQ,EAASD,EAAU,IAAIH,IAAa,CACxC,SAAAA,EACA,MAAO,KAAK,wBAAwBA,EAAUJ,CAAO,CAAA,EACrD,EAEF,OAAAQ,EAAO,KAAK,CAACC,EAAGC,IAAMA,EAAE,MAAQD,EAAE,KAAK,EAChCD,EAAO,CAAC,EAAE,QACnB,CAKQ,wBAAwBJ,EAAiCJ,EAAsB,CACrF,IAAIW,EAAQ,EAGZA,GAASP,EAAS,OAAS,GAC3BO,GAASP,EAAS,iBAAmB,GACrCO,GAASP,EAAS,eAAiB,GAG/BJ,EAAQ,WAAaI,EAAS,kBAAkB,SAASJ,EAAQ,SAAS,IAC5EW,GAAS,IAEPX,EAAQ,UAAYI,EAAS,iBAAiB,SAASJ,EAAQ,QAAQ,IACzEW,GAAS,IAEPX,EAAQ,WAAaI,EAAS,KAAK,SAASJ,EAAQ,SAAS,IAC/DW,GAAS,IAIP,KAAK,cACH,KAAK,YAAY,4BAA4B,SAASP,EAAS,IAAI,IACrEO,GAAS,IAEP,KAAK,YAAY,mBAAmB,SAASP,EAAS,EAAE,IAC1DO,GAAS,KAKb,MAAMC,EAAa,KAAK,WAAW,IAAIR,EAAS,EAAE,GAAK,EACvD,OAAAO,GAAS,KAAK,IAAIC,EAAa,IAAM,EAAG,EAEjCD,CACT,CAKQ,uBACNE,EACAX,EACyB,CAazB,OAZgBW,EACb,OAAOT,GAAYA,EAAS,KAAOF,EAAQ,EAAE,EAC7C,KAAK,CAACO,EAAGC,IAAM,CAEd,MAAMI,EAAUZ,EAAQ,UAAU,SAASO,EAAE,EAAE,EAAI,EAAI,EACjDM,EAAUb,EAAQ,UAAU,SAASQ,EAAE,EAAE,EAAI,EAAI,EACvD,OAAII,IAAYC,EAAgBA,EAAUD,EAGnCJ,EAAE,OAASD,EAAE,MACtB,CAAC,EAEY,MAAM,EAAGb,EAAU,eAAe,CACnD,CAKQ,kBAAkBM,EAAgCF,EAAsB,CAO9E,MANkD,CAChD,wBAAyB,iHACzB,yBAA0B,kHAC1B,sBAAuB,oHAAA,EAGAA,EAAQ,SAAS,GAAKE,EAAQ,WACzD,CAKQ,qBAAqBc,EAAiChB,EAI5D,CACA,MAAMiB,EAAW,CACf,MAAO;AAAA,kCACP,SAAU;AAAA,kCACV,UAAW;AAAA,iCAAA,EAIb,OAAIjB,EAAQ,YAAc,QACxBiB,EAAS,MAAQ,sBACjBA,EAAS,SAAW,wEACpBA,EAAS,UAAY,qEACZjB,EAAQ,YAAc,WAC/BiB,EAAS,MAAQ,kCACjBA,EAAS,SAAW,iGACpBA,EAAS,UAAY,8GAGhBA,CACT,CAKQ,kBAAkBD,EAAiCE,EAIvD,CAcF,MAbiB,CACf,CACE,MAAO,iCACP,SAAU,+DACV,QAAS;AAAA,2BAAA,EAEX,CACE,MAAO,+BACP,SAAU,+CACV,QAAS;AAAA,sCAAA,CACX,CAIJ,CAKQ,qBAAqBhB,EAI3B,CACA,MAAMiB,EAAgBjB,EAAQ,UAC3B,OAAUL,EAAsBuB,CAAE,CAAC,EACnC,OAAO,OAAO,EACd,MAAM,EAAG,CAAC,EAEb,IAAIC,EAAW,EACf,GAAI,KAAK,YAAa,CACpB,MAAMC,EAAmBpB,EAAQ,UAAU,OAASA,EAAQ,cAAc,OAAS,EAOnFmB,EANkB,CAChB,GAAGnB,EAAQ,cACXA,EAAQ,GACR,GAAGA,EAAQ,SAAA,EACX,OAAOkB,GAAM,KAAK,YAAa,mBAAmB,SAASA,CAAE,CAAC,EAAE,OAE3CE,CACzB,CAEA,MAAO,CACL,QAASpB,EACT,KAAMiB,EACN,SAAAE,CAAA,CAEJ,CAKA,eAAeE,EAAoC,CACjD,KAAK,YAAcA,CACrB,CAKA,mBAAmBC,EAA0B,CAC3C,MAAMC,EAAe,KAAK,WAAW,IAAID,CAAU,GAAK,EACxD,KAAK,WAAW,IAAIA,EAAYC,EAAe,CAAC,CAClD,CAKA,+BAA+BC,EAAgB,EAA4B,CACzE,GAAI,CAAC,KAAK,aAAe,CAAC9B,EAAU,sBAClC,MAAO,CAAA,EAWT,MAAMY,EARe,OAAO,OAAOX,CAAqB,EAGd,UAC5B,CAAC,KAAK,YAAa,mBAAmB,SAASO,EAAS,EAAE,CAAA,EAIpC,IAAIA,IAAa,CACnD,SAAAA,EACA,MAAO,KAAK,8BAA8BA,CAAQ,CAAA,EAClD,EAEF,OAAAI,EAAO,KAAK,CAACC,EAAGC,IAAMA,EAAE,MAAQD,EAAE,KAAK,EAChCD,EAAO,MAAM,EAAGkB,CAAK,EAAE,IAAIC,GAAQA,EAAK,QAAQ,CACzD,CAKQ,8BAA8BvB,EAAyC,CAC7E,GAAI,CAAC,KAAK,YAAa,MAAO,GAE9B,IAAIO,EAAQ,EAGZ,MAAMN,EAAa,CAAC,WAAY,eAAgB,WAAY,QAAQ,EAC9DC,EAAiBD,EAAW,QAAQ,KAAK,YAAY,UAAU,EAC/DuB,EAAqBvB,EAAW,QAAQD,EAAS,UAAU,EAE7DwB,IAAuBtB,EACzBK,GAAS,GACAiB,IAAuBtB,EAAiB,EACjDK,GAAS,GACAiB,EAAqBtB,IAC9BK,GAAS,IAIP,KAAK,YAAY,4BAA4B,SAASP,EAAS,IAAI,IACrEO,GAAS,IAIX,MAAMkB,EAAiB,KAAK,YAAY,mBAClCC,EAAgB,KAAK,YAAY,kBAEvC,OAAI1B,EAAS,kBAAkB,KAAK2B,GAAQF,EAAe,SAASE,CAAI,CAAC,IACvEpB,GAAS,IAGPP,EAAS,iBAAiB,KAAK4B,GAAOF,EAAc,SAASE,CAAG,CAAC,IACnErB,GAAS,IAGJA,CACT,CAKA,eAAgB,CACd,MAAO,CACL,eAAgB,OAAO,KAAKd,CAAqB,EAAE,OACnD,gBAAiB,KAAK,qBAAA,EACtB,sBAAuB,KAAK,2BAAA,EAC5B,YAAa,MAAM,KAAK,KAAK,WAAW,OAAA,CAAQ,EAAE,OAAO,CAACY,EAAGC,IAAMD,EAAIC,EAAG,CAAC,EAC3E,cAAe,KAAK,uBAAA,EACpB,gBAAiB,KAAK,mBAAA,CAAmB,CAE7C,CAKQ,sBAA0D,CAChE,MAAMuB,EAAkC,CAAA,EAExC,cAAO,OAAOpC,CAAqB,EAAE,QAAQO,GAAY,CACvD6B,EAAQ7B,EAAS,IAAI,GAAK6B,EAAQ7B,EAAS,IAAI,GAAK,GAAK,CAC3D,CAAC,EAEM6B,CACT,CAKQ,4BAA8D,CACpE,MAAMA,EAAkC,CAAA,EAExC,cAAO,OAAOpC,CAAqB,EAAE,QAAQO,GAAY,CACvD6B,EAAQ7B,EAAS,UAAU,GAAK6B,EAAQ7B,EAAS,UAAU,GAAK,GAAK,CACvE,CAAC,EAEM6B,CACT,CAKQ,wBAAiC,CACvC,MAAM1B,EAAY,OAAO,OAAOV,CAAqB,EAErD,OADoBU,EAAU,OAAO,CAAC2B,EAAK9B,IAAa8B,EAAM9B,EAAS,OAAQ,CAAC,EAC3DG,EAAU,MACjC,CAKQ,oBAAyF,CAC/F,MAAMA,EAAY,OAAO,OAAOV,CAAqB,EAE/CsC,EADkB5B,EAAU,OAAO,CAAC2B,EAAK9B,IAAa8B,EAAM9B,EAAS,eAAgB,CAAC,EAC1DG,EAAU,OAEtC6B,EAAuC,CAAA,EACvCC,EAAmB,KAAK,2BAAA,EAE9B,cAAO,KAAKA,CAAgB,EAAE,QAAQC,GAAc,CAClD,MAAMC,EAAsBhC,EAAU,OAAOiC,GAAKA,EAAE,aAAeF,CAAU,EACvEG,EAAuBF,EAAoB,OAAO,CAACL,EAAKM,IAAMN,EAAMM,EAAE,eAAgB,CAAC,EAC7FJ,EAAaE,CAAU,EAAIG,EAAuBF,EAAoB,MACxE,CAAC,EAEM,CACL,QAAAJ,EACA,aAAAC,CAAA,CAEJ,CACF,CAKO,SAASM,EAAkCC,EAA4C,CAC5F/C,EAAY,CAAE,GAAGA,EAAW,GAAG+C,CAAA,CACjC,CAKO,SAASC,GAA8C,CAC5D,MAAO,CAAE,GAAGhD,CAAA,CACd,CAGA,MAAMiD,EAAwB,IAAI/C,EAKrBgD,EAAgC,CAI3C,2BAA6B9C,GAC3B6C,EAAsB,2BAA2B7C,CAAO,EAK1D,mBAAqB0B,GACnBmB,EAAsB,+BAA+BnB,CAAK,EAK5D,eAAiBH,GACfsB,EAAsB,eAAetB,CAAO,EAK9C,WAAaC,GACXqB,EAAsB,mBAAmBrB,CAAU,EAKrD,UAAWkB,EAKX,UAAWE,EAKX,cAAe,IAAMC,EAAsB,cAAA,EAK3C,gBAAiB,IAAMhD,EAKvB,KAAM,IAAM,CACV,QAAQ,MAAM,0CAA0C,EAExD,GAAI,CAEF,MAAMkD,EAAiBF,EAAsB,2BAA2B,CACtE,UAAW,OACX,UAAW,wBACX,UAAW,UAAA,CACZ,EAED,QAAQ,KAAK,8BAA+B,CAAC,CAACE,CAAc,EACxDA,IACF,QAAQ,KAAK,sBAAuBA,EAAe,QAAQ,KAAK,EAChE,QAAQ,KAAK,uBAAwBA,EAAe,QAAQ,MAAM,EAClE,QAAQ,KAAK,0BAA2B,CAAC,CAACA,EAAe,SAAS,GAIpE,MAAMC,EAAkBH,EAAsB,+BAA+B,CAAC,EAC9E,QAAQ,KAAK,+BAAgCG,EAAgB,MAAM,EAGnE,MAAMC,EAAQJ,EAAsB,cAAA,EACpC,QAAQ,KAAK,qBAAsBI,EAAM,cAAc,EACvD,QAAQ,KAAK,oBAAqBA,EAAM,cAAc,QAAQ,CAAC,CAAC,EAEhE,QAAQ,KAAK,yDAAyD,CAExE,OAASC,EAAO,CACd,QAAQ,MAAM,2CAA4CA,CAAK,CACjE,CAEA,QAAQ,SAAA,CACV,CACF"}

package/dist/validation/documentation-integration.d.ts

@@ -1,269 +0,0 @@
-/**
- * Documentation Integration System - Phase 1D
- *
- * Context-aware help, intelligent documentation links,
- * and comprehensive learning resource management.
- */
-import type { ValidationErrorCategory } from './error-reporting';
-/**
- * Documentation resource types
- */
-export type DocumentationType = 'guide' | 'api-reference' | 'tutorial' | 'example' | 'video' | 'troubleshooting' | 'best-practices';
-/**
- * Learning difficulty levels
- */
-export type DifficultyLevel = 'beginner' | 'intermediate' | 'advanced' | 'expert';
-/**
- * Documentation resource
- */
-export interface DocumentationResource {
-    id: string;
-    title: string;
-    description: string;
-    type: DocumentationType;
-    difficulty: DifficultyLevel;
-    url: string;
-    estimatedReadTime: number;
-    lastUpdated: string;
-    version: string;
-    tags: string[];
-    categories: string[];
-    relatedComponents: string[];
-    relatedModifiers: string[];
-    prerequisites: string[];
-    nextSteps: string[];
-    rating: number;
-    completionRate: number;
-    helpfulnessScore: number;
-    hasInteractiveExample: boolean;
-    hasVideoContent: boolean;
-    hasCodeSandbox: boolean;
-    isAccessible: boolean;
-    hasTranscript: boolean;
-    supportedLanguages: string[];
-}
-/**
- * Context-aware documentation provider
- */
-export interface ContextualDocumentation {
-    primary: DocumentationResource;
-    related: DocumentationResource[];
-    quickHelp: string;
-    codeExamples: {
-        basic: string;
-        advanced: string;
-        realWorld: string;
-    };
-    commonPitfalls: {
-        issue: string;
-        solution: string;
-        example: string;
-    }[];
-    learningPath: {
-        current: DocumentationResource;
-        next: DocumentationResource[];
-        progress: number;
-    };
-}
-/**
- * User learning profile for personalization
- */
-export interface UserLearningProfile {
-    id: string;
-    skillLevel: DifficultyLevel;
-    preferredLearningStyle: 'visual' | 'reading' | 'hands-on' | 'video';
-    completedResources: string[];
-    bookmarkedResources: string[];
-    learningGoals: string[];
-    weakAreas: string[];
-    strongAreas: string[];
-    averageReadTime: number;
-    preferredDocumentationTypes: DocumentationType[];
-    mostUsedComponents: string[];
-    mostUsedModifiers: string[];
-    enablePersonalization: boolean;
-    enableProgressTracking: boolean;
-    enableRecommendations: boolean;
-}
-/**
- * Documentation integration configuration
- */
-export interface DocumentationConfig {
-    defaultDifficulty: DifficultyLevel;
-    preferredTypes: DocumentationType[];
-    maxRelatedItems: number;
-    enableLearningProfile: boolean;
-    enableRecommendations: boolean;
-    enableProgressTracking: boolean;
-    showEstimatedTime: boolean;
-    showRatings: boolean;
-    showPrerequisites: boolean;
-    groupByDifficulty: boolean;
-    enableInlineHelp: boolean;
-    enableContextualSuggestions: boolean;
-    enableLearningPaths: boolean;
-    enableOfflineMode: boolean;
-    cacheDocumentation: boolean;
-    offlineStorageLimit: number;
-}
-/**
- * Comprehensive documentation database
- */
-export declare const documentationDatabase: Record<string, DocumentationResource>;
-/**
- * Context-aware documentation provider
- */
-export declare class DocumentationProvider {
-    private userProfile;
-    private usageStats;
-    /**
-     * Get contextual documentation for an error or component
-     */
-    getContextualDocumentation(context: {
-        component?: string;
-        modifier?: string;
-        errorType?: string;
-        category?: ValidationErrorCategory;
-        userLevel?: DifficultyLevel;
-    }): ContextualDocumentation | null;
-    /**
-     * Find relevant documentation resources
-     */
-    private findRelevantResources;
-    /**
-     * Select primary documentation resource
-     */
-    private selectPrimaryResource;
-    /**
-     * Calculate relevance score for a resource
-     */
-    private calculateRelevanceScore;
-    /**
-     * Select related resources
-     */
-    private selectRelatedResources;
-    /**
-     * Generate quick help text
-     */
-    private generateQuickHelp;
-    /**
-     * Generate contextual code examples
-     */
-    private generateCodeExamples;
-    /**
-     * Get common pitfalls for a resource
-     */
-    private getCommonPitfalls;
-    /**
-     * Generate learning path
-     */
-    private generateLearningPath;
-    /**
-     * Set user learning profile
-     */
-    setUserProfile(profile: UserLearningProfile): void;
-    /**
-     * Track resource usage
-     */
-    trackResourceUsage(resourceId: string): void;
-    /**
-     * Get personalized recommendations
-     */
-    getPersonalizedRecommendations(limit?: number): DocumentationResource[];
-    /**
-     * Calculate personalization score
-     */
-    private calculatePersonalizationScore;
-    /**
-     * Get documentation statistics
-     */
-    getStatistics(): {
-        totalResources: number;
-        resourcesByType: Record<DocumentationType, number>;
-        resourcesByDifficulty: Record<DifficultyLevel, number>;
-        totalUsages: number;
-        averageRating: number;
-        completionRates: {
-            average: number;
-            byDifficulty: Record<DifficultyLevel, number>;
-        };
-    };
-    /**
-     * Group resources by type
-     */
-    private groupResourcesByType;
-    /**
-     * Group resources by difficulty
-     */
-    private groupResourcesByDifficulty;
-    /**
-     * Calculate average rating
-     */
-    private calculateAverageRating;
-    /**
-     * Get completion rates
-     */
-    private getCompletionRates;
-}
-/**
- * Configure documentation integration
- */
-export declare function configureDocumentationIntegration(config: Partial<DocumentationConfig>): void;
-/**
- * Get current documentation configuration
- */
-export declare function getDocumentationConfig(): DocumentationConfig;
-declare const documentationProvider: DocumentationProvider;
-/**
- * Documentation Integration utilities
- */
-export declare const DocumentationIntegrationUtils: {
-    /**
-     * Get contextual documentation
-     */
-    getContextualDocumentation: (context: any) => ContextualDocumentation | null;
-    /**
-     * Get personalized recommendations
-     */
-    getRecommendations: (limit?: number) => DocumentationResource[];
-    /**
-     * Set user profile
-     */
-    setUserProfile: (profile: UserLearningProfile) => void;
-    /**
-     * Track resource usage
-     */
-    trackUsage: (resourceId: string) => void;
-    /**
-     * Configure integration
-     */
-    configure: typeof configureDocumentationIntegration;
-    /**
-     * Get configuration
-     */
-    getConfig: typeof getDocumentationConfig;
-    /**
-     * Get statistics
-     */
-    getStatistics: () => {
-        totalResources: number;
-        resourcesByType: Record<DocumentationType, number>;
-        resourcesByDifficulty: Record<DifficultyLevel, number>;
-        totalUsages: number;
-        averageRating: number;
-        completionRates: {
-            average: number;
-            byDifficulty: Record<DifficultyLevel, number>;
-        };
-    };
-    /**
-     * Get all resources
-     */
-    getAllResources: () => Record<string, DocumentationResource>;
-    /**
-     * Test documentation system
-     */
-    test: () => void;
-};
-export { documentationProvider };
-//# sourceMappingURL=documentation-integration.d.ts.map

package/dist/validation/documentation-integration.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"documentation-integration.d.ts","sourceRoot":"","sources":["../../src/validation/documentation-integration.ts"],"names":[],"mappings":"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"}