@tachui/core 0.7.0-alpha1

package/dist/validation/developer-experience.d.ts

@@ -0,0 +1,243 @@
+/**
+ * Developer Experience Integration - Phase 1D
+ *
+ * Enhanced error message templates, intelligent fix suggestions,
+ * and comprehensive developer guidance system.
+ */
+import type { ValidationErrorCategory, ValidationErrorSeverity } from './error-reporting';
+import { EnhancedValidationError } from './enhanced-runtime';
+/**
+ * Intelligent fix suggestion with automated repair capability
+ */
+export interface IntelligentFixSuggestion {
+    id: string;
+    title: string;
+    description: string;
+    difficulty: 'easy' | 'medium' | 'hard';
+    confidence: number;
+    category: 'syntax' | 'logic' | 'performance' | 'accessibility' | 'best-practice';
+    before: string;
+    after: string;
+    canAutoFix: boolean;
+    autoFix?: () => string;
+    learnMore?: {
+        documentation: string;
+        examples: string[];
+        videoTutorial?: string;
+    };
+    relatedFixes: string[];
+}
+/**
+ * Enhanced error message template with rich formatting
+ */
+export interface DeveloperErrorMessageTemplate {
+    id: string;
+    title: string;
+    description: string;
+    severity: ValidationErrorSeverity;
+    category: ValidationErrorCategory;
+    emoji: string;
+    color: string;
+    quickFix: string;
+    explanation: string;
+    prevention: string;
+    suggestions: IntelligentFixSuggestion[];
+    examples: {
+        wrong: CodeExample[];
+        correct: CodeExample[];
+    };
+    documentation: {
+        primary: string;
+        related: string[];
+        apiReference?: string;
+    };
+    context: {
+        component?: string;
+        modifier?: string;
+        package?: string;
+        commonCause: string[];
+    };
+}
+/**
+ * Code example with syntax highlighting metadata
+ */
+export interface CodeExample {
+    code: string;
+    language: 'typescript' | 'javascript' | 'tsx' | 'jsx';
+    title: string;
+    description?: string;
+    highlights?: {
+        line: number;
+        type: 'error' | 'warning' | 'info' | 'success';
+        message: string;
+    }[];
+}
+/**
+ * Developer experience configuration
+ */
+export interface DeveloperExperienceConfig {
+    verbosity: 'minimal' | 'standard' | 'detailed' | 'comprehensive';
+    showEmojis: boolean;
+    showColors: boolean;
+    showCodeExamples: boolean;
+    showDocumentationLinks: boolean;
+    enableAutoFix: boolean;
+    suggestionCount: number;
+    minConfidenceScore: number;
+    enableInlineHelp: boolean;
+    enableHoverInfo: boolean;
+    enableQuickActions: boolean;
+    showLearningTips: boolean;
+    trackProgress: boolean;
+    personalization: boolean;
+}
+/**
+ * Comprehensive error message templates database
+ */
+export declare const errorMessageTemplates: Record<string, DeveloperErrorMessageTemplate>;
+/**
+ * Intelligent fix suggestion engine
+ */
+export declare class FixSuggestionEngine {
+    private suggestionDatabase;
+    private usageTracker;
+    constructor();
+    /**
+     * Get intelligent fix suggestions for a given error
+     */
+    getSuggestions(errorType: string, _context: {
+        component?: string;
+        modifier?: string;
+        code?: string;
+        severity?: ValidationErrorSeverity;
+    }): IntelligentFixSuggestion[];
+    /**
+     * Apply automatic fix
+     */
+    applyAutoFix(suggestionId: string, _code: string): string | null;
+    /**
+     * Track suggestion usage for improvement
+     */
+    private trackSuggestionUsage;
+    /**
+     * Initialize suggestion database with common fixes
+     */
+    private initializeSuggestionDatabase;
+    /**
+     * Get suggestion statistics
+     */
+    getStatistics(): {
+        totalSuggestions: number;
+        totalUsages: number;
+        topSuggestions: [string, number][];
+    };
+}
+/**
+ * Enhanced error message formatter with rich templates
+ */
+export declare class EnhancedErrorFormatter {
+    private fixEngine;
+    /**
+     * Format error with enhanced template
+     */
+    formatError(error: EnhancedValidationError, templateId?: string): FormattedErrorMessage;
+    /**
+     * Find the best template for an error
+     */
+    private findBestTemplate;
+    /**
+     * Render formatted message with rich content
+     */
+    private renderFormattedMessage;
+    /**
+     * Format basic error without template
+     */
+    private formatBasicError;
+    /**
+     * Generate quick actions for IDE integration
+     */
+    private generateQuickActions;
+}
+/**
+ * Formatted error message with rich content
+ */
+export interface FormattedErrorMessage {
+    id: string;
+    template: DeveloperErrorMessageTemplate | null;
+    error: EnhancedValidationError;
+    suggestions: IntelligentFixSuggestion[];
+    formatted: string;
+    interactive: {
+        canAutoFix: boolean;
+        quickActions: QuickAction[];
+        learnMore: {
+            primary: string;
+            related: string[];
+        };
+    };
+}
+/**
+ * Quick action for IDE integration
+ */
+export interface QuickAction {
+    id: string;
+    title: string;
+    description: string;
+    command: string;
+    arguments: any[];
+}
+/**
+ * Configure developer experience
+ */
+export declare function configureDeveloperExperience(config: Partial<DeveloperExperienceConfig>): void;
+/**
+ * Get current developer experience configuration
+ */
+export declare function getDeveloperExperienceConfig(): DeveloperExperienceConfig;
+declare const enhancedFormatter: EnhancedErrorFormatter;
+declare const fixEngine: FixSuggestionEngine;
+/**
+ * Developer Experience utilities
+ */
+export declare const DeveloperExperienceUtils: {
+    /**
+     * Format error with enhanced template
+     */
+    formatError: (error: EnhancedValidationError, templateId?: string) => FormattedErrorMessage;
+    /**
+     * Get fix suggestions
+     */
+    getSuggestions: (errorType: string, context: any) => IntelligentFixSuggestion[];
+    /**
+     * Apply automatic fix
+     */
+    applyAutoFix: (suggestionId: string, code: string) => string | null;
+    /**
+     * Get available error templates
+     */
+    getErrorTemplates: () => Record<string, DeveloperErrorMessageTemplate>;
+    /**
+     * Configure experience
+     */
+    configure: typeof configureDeveloperExperience;
+    /**
+     * Get statistics
+     */
+    getStatistics: () => {
+        formatter: {
+            templatesAvailable: number;
+        };
+        fixEngine: {
+            totalSuggestions: number;
+            totalUsages: number;
+            topSuggestions: [string, number][];
+        };
+        config: DeveloperExperienceConfig;
+    };
+    /**
+     * Test developer experience system
+     */
+    test: () => void;
+};
+export { enhancedFormatter, fixEngine };
+//# sourceMappingURL=developer-experience.d.ts.map

package/dist/validation/developer-experience.d.ts.map

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

package/dist/validation/developer-experience.js

@@ -0,0 +1,433 @@
+import { EnhancedValidationError as x } from "./enhanced-runtime.js";
+var h = Object.defineProperty, y = (i, e, t) => e in i ? h(i, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : i[e] = t, d = (i, e, t) => y(i, typeof e != "symbol" ? e + "" : e, t);
+let s = {
+  verbosity: "standard",
+  showEmojis: !0,
+  showColors: !0,
+  showCodeExamples: !0,
+  showDocumentationLinks: !0,
+  enableAutoFix: !0,
+  suggestionCount: 3,
+  minConfidenceScore: 0.7,
+  enableInlineHelp: !0,
+  enableHoverInfo: !0,
+  enableQuickActions: !0,
+  showLearningTips: !0,
+  trackProgress: !1,
+  personalization: !1
+};
+const a = {
+  "missing-required-prop": {
+    id: "missing-required-prop",
+    title: "Missing Required Property",
+    description: "Component is missing a required property that is necessary for proper functionality.",
+    severity: "error",
+    category: "component-construction",
+    emoji: "❌",
+    color: "#ff4444",
+    quickFix: "Add the required property to the component",
+    explanation: "This component requires specific properties to function correctly. Missing required properties can cause runtime errors or unexpected behavior.",
+    prevention: "Always check component documentation for required properties and use TypeScript for compile-time validation.",
+    suggestions: [
+      {
+        id: "add-required-prop",
+        title: "Add Required Property",
+        description: "Add the missing required property with an appropriate value",
+        difficulty: "easy",
+        confidence: 0.95,
+        category: "syntax",
+        before: "Text()",
+        after: 'Text("Hello World")',
+        canAutoFix: !0,
+        autoFix: () => 'Text("Hello World")',
+        learnMore: {
+          documentation: "/docs/components/text#required-properties",
+          examples: ["/examples/text-basic-usage", "/examples/text-with-signals"]
+        },
+        relatedFixes: ["use-signal-content", "add-type-annotation"]
+      }
+    ],
+    examples: {
+      wrong: [{
+        code: "Text()",
+        language: "typescript",
+        title: "Missing content parameter",
+        description: "Text component requires content to display",
+        highlights: [{
+          line: 1,
+          type: "error",
+          message: 'Missing required "content" parameter'
+        }]
+      }],
+      correct: [{
+        code: 'Text("Hello World")',
+        language: "typescript",
+        title: "Correct usage with content",
+        description: "Text component with required content parameter"
+      }, {
+        code: "Text(() => dynamicContent.value)",
+        language: "typescript",
+        title: "Using reactive content",
+        description: "Text component with reactive content function"
+      }]
+    },
+    documentation: {
+      primary: "/docs/components/text",
+      related: ["/docs/concepts/required-properties", "/docs/guides/component-construction"],
+      apiReference: "/api/components/text"
+    },
+    context: {
+      component: "Text",
+      package: "core",
+      commonCause: ["Forgot to pass content parameter", "Copy-paste error", "Incomplete refactoring"]
+    }
+  },
+  "invalid-modifier-usage": {
+    id: "invalid-modifier-usage",
+    title: "Invalid Modifier Usage",
+    description: "Modifier is not compatible with this component type or is being used incorrectly.",
+    severity: "error",
+    category: "modifier-usage",
+    emoji: "🔧",
+    color: "#ff8800",
+    quickFix: "Remove the incompatible modifier or use it on a compatible component",
+    explanation: "Components have specific modifiers that are compatible with their functionality. Using incompatible modifiers can cause rendering issues.",
+    prevention: "Check component documentation for supported modifiers and use IDE autocomplete for guidance.",
+    suggestions: [
+      {
+        id: "remove-incompatible-modifier",
+        title: "Remove Incompatible Modifier",
+        description: "Remove the modifier that is not supported by this component",
+        difficulty: "easy",
+        confidence: 0.9,
+        category: "syntax",
+        before: "VStack({ children: [] }).fontSize(16)",
+        after: "VStack({ children: [] })",
+        canAutoFix: !0,
+        autoFix: () => "VStack({ children: [] })",
+        learnMore: {
+          documentation: "/docs/modifiers/compatibility",
+          examples: ["/examples/modifier-usage", "/examples/component-styling"]
+        },
+        relatedFixes: ["use-compatible-modifier", "wrap-in-container"]
+      }
+    ],
+    examples: {
+      wrong: [{
+        code: "VStack({ children: [] }).fontSize(16)",
+        language: "typescript",
+        title: "Text modifier on layout component",
+        description: "fontSize is only applicable to text components",
+        highlights: [{
+          line: 1,
+          type: "error",
+          message: "fontSize modifier not compatible with VStack"
+        }]
+      }],
+      correct: [{
+        code: 'Text("Hello").fontSize(16)',
+        language: "typescript",
+        title: "Correct fontSize usage",
+        description: "fontSize modifier used on Text component"
+      }, {
+        code: "VStack({ children: [] }).padding(16)",
+        language: "typescript",
+        title: "Compatible VStack modifier",
+        description: "padding modifier is compatible with VStack"
+      }]
+    },
+    documentation: {
+      primary: "/docs/modifiers/overview",
+      related: ["/docs/modifiers/compatibility", "/docs/components/modifier-support"],
+      apiReference: "/api/modifiers"
+    },
+    context: {
+      modifier: "fontSize",
+      component: "VStack",
+      package: "core",
+      commonCause: ["Confusion about modifier compatibility", "Copy-paste from different component", "Misunderstanding of component types"]
+    }
+  },
+  "performance-warning": {
+    id: "performance-warning",
+    title: "Performance Optimization Available",
+    description: "Code pattern detected that could impact performance with optimization suggestions.",
+    severity: "warning",
+    category: "performance",
+    emoji: "⚡",
+    color: "#ffaa00",
+    quickFix: "Apply performance optimization suggestions",
+    explanation: "This pattern works correctly but may impact performance in certain scenarios. Consider the suggested optimizations for better user experience.",
+    prevention: "Follow performance best practices and use the TachUI performance monitoring tools during development.",
+    suggestions: [
+      {
+        id: "optimize-list-rendering",
+        title: "Use Virtual Scrolling",
+        description: "For large lists, consider using virtual scrolling to improve performance",
+        difficulty: "medium",
+        confidence: 0.8,
+        category: "performance",
+        before: "List({ children: largeDataset.map(item => ListItem(item)) })",
+        after: "VirtualList({ data: largeDataset, renderItem: item => ListItem(item) })",
+        canAutoFix: !1,
+        learnMore: {
+          documentation: "/docs/performance/virtual-scrolling",
+          examples: ["/examples/virtual-list", "/examples/performance-optimization"],
+          videoTutorial: "/videos/optimizing-large-lists"
+        },
+        relatedFixes: ["add-key-prop", "memo-optimization"]
+      }
+    ],
+    examples: {
+      wrong: [{
+        code: "List({ children: items.map(item => Item(item)) })",
+        language: "typescript",
+        title: "Large list without optimization",
+        description: "Rendering all items at once can impact performance",
+        highlights: [{
+          line: 1,
+          type: "warning",
+          message: "Consider virtual scrolling for large datasets"
+        }]
+      }],
+      correct: [{
+        code: "VirtualList({ data: items, renderItem: item => Item(item) })",
+        language: "typescript",
+        title: "Optimized virtual list",
+        description: "Virtual scrolling only renders visible items"
+      }]
+    },
+    documentation: {
+      primary: "/docs/performance/optimization",
+      related: ["/docs/components/virtual-list", "/docs/guides/performance-best-practices"]
+    },
+    context: {
+      component: "List",
+      package: "core",
+      commonCause: ["Large datasets", "Unaware of optimization options", "Premature optimization concerns"]
+    }
+  }
+};
+class f {
+  constructor() {
+    d(this, "suggestionDatabase", /* @__PURE__ */ new Map()), d(this, "usageTracker", /* @__PURE__ */ new Map()), this.initializeSuggestionDatabase();
+  }
+  /**
+   * Get intelligent fix suggestions for a given error
+   */
+  getSuggestions(e, t) {
+    return (this.suggestionDatabase.get(e) || []).filter(
+      (p) => p.confidence >= s.minConfidenceScore
+    ).sort((p, r) => {
+      const l = p.confidence + (this.usageTracker.get(p.id) || 0) * 0.1;
+      return r.confidence + (this.usageTracker.get(r.id) || 0) * 0.1 - l;
+    }).slice(0, s.suggestionCount);
+  }
+  /**
+   * Apply automatic fix
+   */
+  applyAutoFix(e, t) {
+    for (const n of this.suggestionDatabase.values()) {
+      const o = n.find((c) => c.id === e);
+      if (o && o.canAutoFix && o.autoFix)
+        return this.trackSuggestionUsage(e), o.autoFix();
+    }
+    return null;
+  }
+  /**
+   * Track suggestion usage for improvement
+   */
+  trackSuggestionUsage(e) {
+    const t = this.usageTracker.get(e) || 0;
+    this.usageTracker.set(e, t + 1);
+  }
+  /**
+   * Initialize suggestion database with common fixes
+   */
+  initializeSuggestionDatabase() {
+    for (const e of Object.values(a))
+      this.suggestionDatabase.set(e.id, e.suggestions);
+    this.suggestionDatabase.set("common-typos", [
+      {
+        id: "fix-typo-background",
+        title: "Fix Background Color Typo",
+        description: "Correct common typo in background color property",
+        difficulty: "easy",
+        confidence: 0.9,
+        category: "syntax",
+        before: '.backround("blue")',
+        after: '.background("blue")',
+        canAutoFix: !0,
+        autoFix: () => '.background("blue")',
+        relatedFixes: []
+      }
+    ]);
+  }
+  /**
+   * Get suggestion statistics
+   */
+  getStatistics() {
+    return {
+      totalSuggestions: Array.from(this.suggestionDatabase.values()).reduce((e, t) => e + t.length, 0),
+      totalUsages: Array.from(this.usageTracker.values()).reduce((e, t) => e + t, 0),
+      topSuggestions: Array.from(this.usageTracker.entries()).sort(([, e], [, t]) => t - e).slice(0, 5)
+    };
+  }
+}
+class b {
+  constructor() {
+    d(this, "fixEngine", new f());
+  }
+  /**
+   * Format error with enhanced template
+   */
+  formatError(e, t) {
+    const n = t ? a[t] : this.findBestTemplate(e);
+    if (!n)
+      return this.formatBasicError(e);
+    const o = this.fixEngine.getSuggestions(n.id, {
+      component: e.context.component,
+      severity: n.severity
+    });
+    return {
+      id: `error-${Date.now()}`,
+      template: n,
+      error: e,
+      suggestions: o,
+      formatted: this.renderFormattedMessage(n, e, o),
+      interactive: {
+        canAutoFix: o.some((c) => c.canAutoFix),
+        quickActions: this.generateQuickActions(o),
+        learnMore: n.documentation
+      }
+    };
+  }
+  /**
+   * Find the best template for an error
+   */
+  findBestTemplate(e) {
+    return e.message.includes("required") ? a["missing-required-prop"] : e.message.includes("modifier") ? a["invalid-modifier-usage"] : e.message.includes("performance") ? a["performance-warning"] : null;
+  }
+  /**
+   * Render formatted message with rich content
+   */
+  renderFormattedMessage(e, t, n) {
+    const { verbosity: o, showEmojis: c, showCodeExamples: p } = s;
+    let r = "";
+    return c && (r += `${e.emoji} `), r += `${e.title}: ${t.message}
+`, o !== "minimal" && (r += `
+${e.description}
+`), (o === "standard" || o === "detailed" || o === "comprehensive") && (r += `
+💡 Quick Fix: ${e.quickFix}
+`), p && e.examples.wrong.length > 0 && (r += `
+❌ Wrong:
+${e.examples.wrong[0].code}
+`, r += `✅ Correct:
+${e.examples.correct[0].code}
+`), n.length > 0 && (r += `
+🔧 Suggestions:
+`, n.forEach((l, u) => {
+      r += `${u + 1}. ${l.title}: ${l.description}
+`;
+    })), s.showDocumentationLinks && e.documentation.primary && (r += `
+📚 Documentation: ${e.documentation.primary}
+`), r;
+  }
+  /**
+   * Format basic error without template
+   */
+  formatBasicError(e) {
+    return {
+      id: `basic-error-${Date.now()}`,
+      template: null,
+      error: e,
+      suggestions: [],
+      formatted: e.getFormattedMessage(),
+      interactive: {
+        canAutoFix: !1,
+        quickActions: [],
+        learnMore: { primary: "/docs/troubleshooting", related: [] }
+      }
+    };
+  }
+  /**
+   * Generate quick actions for IDE integration
+   */
+  generateQuickActions(e) {
+    return e.filter((t) => t.canAutoFix).map((t) => ({
+      id: t.id,
+      title: `Fix: ${t.title}`,
+      description: t.description,
+      command: "tachui.applyFix",
+      arguments: [t.id]
+    }));
+  }
+}
+function v(i) {
+  s = { ...s, ...i };
+}
+function k() {
+  return { ...s };
+}
+const g = new b(), m = new f(), w = {
+  /**
+   * Format error with enhanced template
+   */
+  formatError: (i, e) => g.formatError(i, e),
+  /**
+   * Get fix suggestions
+   */
+  getSuggestions: (i, e) => m.getSuggestions(i, e),
+  /**
+   * Apply automatic fix
+   */
+  applyAutoFix: (i, e) => m.applyAutoFix(i, e),
+  /**
+   * Get available error templates
+   */
+  getErrorTemplates: () => a,
+  /**
+   * Configure experience
+   */
+  configure: v,
+  /**
+   * Get statistics
+   */
+  getStatistics: () => ({
+    formatter: {
+      templatesAvailable: Object.keys(a).length
+    },
+    fixEngine: m.getStatistics(),
+    config: s
+  }),
+  /**
+   * Test developer experience system
+   */
+  test: () => {
+    console.group("🎨 Developer Experience System Test");
+    try {
+      const i = new x("Test missing required property", {
+        component: "Text",
+        property: "content",
+        recoveryStrategy: "fallback"
+      }), e = g.formatError(i, "missing-required-prop");
+      console.info("✅ Error formatting:", e.template?.title), console.info("✅ Suggestions count:", e.suggestions.length), console.info("✅ Quick actions:", e.interactive.quickActions.length);
+      const t = m.getSuggestions("missing-required-prop", { component: "Text" });
+      console.info("✅ Fix suggestions:", t.length), console.info("✅ Developer experience system is working correctly");
+    } catch (i) {
+      console.error("❌ Developer experience test failed:", i);
+    }
+    console.groupEnd();
+  }
+};
+export {
+  w as DeveloperExperienceUtils,
+  b as EnhancedErrorFormatter,
+  f as FixSuggestionEngine,
+  v as configureDeveloperExperience,
+  g as enhancedFormatter,
+  a as errorMessageTemplates,
+  m as fixEngine,
+  k as getDeveloperExperienceConfig
+};
+//# sourceMappingURL=developer-experience.js.map