driftdetect-core 0.4.6 → 0.6.0

package/dist/wpf/wpf-analyzer.js

@@ -0,0 +1,332 @@
+/**
+ * WPF Analyzer
+ *
+ * Main entry point for WPF framework analysis.
+ * Coordinates XAML parsing, ViewModel extraction, and linking.
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { minimatch } from 'minimatch';
+import { XamlHybridExtractor, createXamlHybridExtractor } from './extractors/xaml-hybrid-extractor.js';
+import { ViewModelHybridExtractor, createViewModelHybridExtractor } from './extractors/viewmodel-hybrid-extractor.js';
+import { DataContextResolver, createDataContextResolver } from './linkers/datacontext-resolver.js';
+import { ViewModelLinker, createViewModelLinker } from './linkers/viewmodel-linker.js';
+const DEFAULT_CONFIG = {
+    verbose: false,
+    includePatterns: ['**/*.xaml', '**/*.cs'],
+    excludePatterns: ['**/node_modules/**', '**/bin/**', '**/obj/**', '**/.git/**'],
+};
+// ============================================================================
+// WPF Analyzer
+// ============================================================================
+export class WpfAnalyzer {
+    config;
+    xamlExtractor;
+    viewModelExtractor;
+    dataContextResolver;
+    viewModelLinker;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.xamlExtractor = createXamlHybridExtractor();
+        this.viewModelExtractor = createViewModelHybridExtractor();
+        this.dataContextResolver = createDataContextResolver();
+        this.viewModelLinker = createViewModelLinker(this.dataContextResolver);
+    }
+    /**
+     * Analyze a WPF project
+     */
+    async analyze() {
+        const startTime = performance.now();
+        // Detect WPF project
+        const project = await this.detectWpfProject();
+        // Find and analyze XAML files
+        const xamlFiles = await this.analyzeXamlFiles();
+        // Find and analyze ViewModels
+        const viewModels = await this.analyzeViewModels();
+        // Register ViewModels with resolver
+        for (const vm of viewModels.values()) {
+            this.dataContextResolver.registerViewModel(vm);
+        }
+        // Register XAML files with resolver
+        for (const [filePath, result] of xamlFiles) {
+            this.dataContextResolver.registerXaml(filePath, result);
+        }
+        // Resolve DataContexts
+        const dataContexts = this.dataContextResolver.resolveAll();
+        // Link bindings to ViewModels
+        const { links, bindingErrors } = await this.linkAllBindings(xamlFiles, viewModels, dataContexts);
+        // Calculate statistics
+        const stats = this.calculateStats(xamlFiles, viewModels, links, bindingErrors, startTime);
+        return {
+            project,
+            xamlFiles,
+            viewModels,
+            links,
+            dataContexts,
+            bindingErrors,
+            stats,
+        };
+    }
+    /**
+     * Find files matching a pattern
+     */
+    async findFiles(pattern) {
+        const results = [];
+        const excludePatterns = this.config.excludePatterns ?? [];
+        const walk = async (dir, relativePath = '') => {
+            let entries;
+            try {
+                entries = await fs.readdir(dir, { withFileTypes: true });
+            }
+            catch {
+                return; // Skip inaccessible directories
+            }
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                const relPath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
+                // Check exclusions
+                const isExcluded = excludePatterns.some((p) => minimatch(relPath, p));
+                if (isExcluded)
+                    continue;
+                if (entry.isDirectory()) {
+                    await walk(fullPath, relPath);
+                }
+                else if (entry.isFile()) {
+                    if (minimatch(relPath, pattern)) {
+                        results.push(relPath);
+                    }
+                }
+            }
+        };
+        await walk(this.config.rootDir);
+        return results;
+    }
+    /**
+     * Detect if this is a WPF project
+     */
+    async detectWpfProject() {
+        const csprojFiles = await this.findFiles('**/*.csproj');
+        for (const csprojPath of csprojFiles) {
+            const fullPath = path.join(this.config.rootDir, csprojPath);
+            const content = await fs.readFile(fullPath, 'utf-8');
+            if (this.isWpfProject(content)) {
+                const xamlFiles = await this.findFiles('**/*.xaml');
+                const viewModels = await this.findFiles('**/*ViewModel*.cs');
+                const converters = await this.findFiles('**/*Converter*.cs');
+                const resourceDictionaries = xamlFiles.filter((f) => f.includes('Resources') || f.includes('Dictionary') || f.includes('Styles'));
+                const appXaml = xamlFiles.find((f) => f.toLowerCase().endsWith('app.xaml')) ?? null;
+                return {
+                    isWpfProject: true,
+                    projectFile: fullPath,
+                    targetFramework: this.extractTargetFramework(content),
+                    xamlFiles,
+                    viewModels,
+                    converters,
+                    resourceDictionaries,
+                    appXaml,
+                };
+            }
+        }
+        return null;
+    }
+    /**
+     * Check if csproj content indicates WPF project
+     */
+    isWpfProject(content) {
+        const indicators = [
+            /<UseWPF>true<\/UseWPF>/i,
+            /Microsoft\.NET\.Sdk\.WindowsDesktop/,
+            /<ProjectTypeGuids>.*60dc8134-eba5-43b8-bcc9-bb4bc16c2548/i,
+            /<Reference Include="PresentationCore"/,
+            /<Reference Include="PresentationFramework"/,
+        ];
+        return indicators.some(pattern => pattern.test(content));
+    }
+    /**
+     * Extract target framework from csproj
+     */
+    extractTargetFramework(content) {
+        const match = content.match(/<TargetFramework>([^<]+)<\/TargetFramework>/);
+        return match?.[1] ?? 'unknown';
+    }
+    /**
+     * Analyze all XAML files
+     */
+    async analyzeXamlFiles() {
+        const results = new Map();
+        const xamlFiles = await this.findFiles('**/*.xaml');
+        for (const xamlPath of xamlFiles) {
+            const fullPath = path.join(this.config.rootDir, xamlPath);
+            try {
+                const content = await fs.readFile(fullPath, 'utf-8');
+                const result = await this.xamlExtractor.extract(fullPath, content);
+                results.set(xamlPath, result);
+                if (this.config.verbose) {
+                    console.log(`  Analyzed XAML: ${xamlPath} (${result.bindings.length} bindings, ${result.commands.length} commands)`);
+                }
+            }
+            catch (error) {
+                if (this.config.verbose) {
+                    console.error(`  Error analyzing ${xamlPath}: ${error}`);
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Analyze all ViewModel files
+     */
+    async analyzeViewModels() {
+        const results = new Map();
+        const csFiles = await this.findFiles('**/*.cs');
+        for (const csPath of csFiles) {
+            const fullPath = path.join(this.config.rootDir, csPath);
+            try {
+                const content = await fs.readFile(fullPath, 'utf-8');
+                const result = await this.viewModelExtractor.extract(fullPath, content);
+                if (result) {
+                    results.set(result.className, result);
+                    if (this.config.verbose) {
+                        console.log(`  Found ViewModel: ${result.className} (${result.properties.length} properties, ${result.commands.length} commands)`);
+                    }
+                }
+            }
+            catch (error) {
+                if (this.config.verbose) {
+                    console.error(`  Error analyzing ${csPath}: ${error}`);
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Link all bindings to ViewModels
+     */
+    async linkAllBindings(xamlFiles, viewModels, dataContexts) {
+        const allLinks = [];
+        const allErrors = [];
+        // Create a map of XAML file to resolved ViewModel
+        const xamlToViewModel = new Map();
+        for (const dc of dataContexts) {
+            const vm = dc.resolvedType ? viewModels.get(dc.resolvedType) ?? null : null;
+            xamlToViewModel.set(dc.xamlFile, vm);
+        }
+        // Link each XAML file
+        for (const [xamlPath, xamlResult] of xamlFiles) {
+            const viewModel = xamlToViewModel.get(xamlPath) ?? null;
+            const linkingResult = this.viewModelLinker.linkBindings(xamlPath, xamlResult, viewModel);
+            allLinks.push(...linkingResult.links);
+            // Convert unresolved bindings to binding errors
+            for (const unresolved of linkingResult.unresolved) {
+                allErrors.push({
+                    type: viewModel ? 'missing-property' : 'missing-datacontext',
+                    xamlFile: unresolved.xamlFile,
+                    line: unresolved.location.line,
+                    bindingPath: unresolved.bindingPath,
+                    message: unresolved.reason,
+                    suggestion: unresolved.suggestion,
+                });
+            }
+        }
+        return { links: allLinks, bindingErrors: allErrors };
+    }
+    /**
+     * Calculate analysis statistics
+     */
+    calculateStats(xamlFiles, viewModels, links, bindingErrors, startTime) {
+        let totalBindings = 0;
+        let totalCommands = 0;
+        for (const result of xamlFiles.values()) {
+            totalBindings += result.bindings.length;
+            totalCommands += result.commands.length;
+        }
+        return {
+            xamlFileCount: xamlFiles.size,
+            viewModelCount: viewModels.size,
+            totalBindings,
+            resolvedBindings: links.length,
+            unresolvedBindings: bindingErrors.length,
+            totalCommands,
+            analysisTimeMs: performance.now() - startTime,
+        };
+    }
+    /**
+     * Check MVVM compliance
+     */
+    async checkMvvmCompliance() {
+        const violations = [];
+        const analysisResult = await this.analyze();
+        // Check ViewModels for INPC
+        for (const vm of analysisResult.viewModels.values()) {
+            if (!vm.implementsINPC) {
+                violations.push({
+                    type: 'missing-inpc',
+                    severity: 'warning',
+                    file: vm.filePath,
+                    line: vm.startLine,
+                    message: `ViewModel ${vm.className} does not implement INotifyPropertyChanged`,
+                    suggestion: 'Implement INotifyPropertyChanged or inherit from a base class that does',
+                });
+            }
+            // Check properties for PropertyChanged notification
+            for (const prop of vm.properties) {
+                if (prop.hasSetter && !prop.raisesPropertyChanged && !prop.isSourceGenerated) {
+                    violations.push({
+                        type: 'property-without-notification',
+                        severity: 'warning',
+                        file: vm.filePath,
+                        line: prop.location.line,
+                        message: `Property '${prop.name}' has a setter but does not raise PropertyChanged`,
+                        suggestion: 'Add OnPropertyChanged call in setter or use [ObservableProperty] attribute',
+                    });
+                }
+            }
+        }
+        // Calculate score
+        const maxScore = 100;
+        const deductions = violations.reduce((sum, v) => {
+            switch (v.severity) {
+                case 'error': return sum + 15;
+                case 'warning': return sum + 5;
+                case 'info': return sum + 1;
+                default: return sum;
+            }
+        }, 0);
+        const score = Math.max(0, maxScore - deductions);
+        // Generate recommendations
+        const recommendations = [];
+        if (violations.some(v => v.type === 'missing-inpc')) {
+            recommendations.push('Consider using a base ViewModel class that implements INotifyPropertyChanged');
+        }
+        if (violations.some(v => v.type === 'property-without-notification')) {
+            recommendations.push('Use MVVM Toolkit [ObservableProperty] attribute for automatic property notification');
+        }
+        return {
+            score,
+            violations,
+            recommendations,
+        };
+    }
+    /**
+     * Get all bindings with their resolution status
+     */
+    async getBindingsReport() {
+        const result = await this.analyze();
+        return {
+            resolved: result.links,
+            unresolved: result.bindingErrors,
+            stats: {
+                total: result.stats.totalBindings,
+                resolved: result.stats.resolvedBindings,
+                unresolved: result.stats.unresolvedBindings,
+            },
+        };
+    }
+}
+/**
+ * Factory function
+ */
+export function createWpfAnalyzer(config) {
+    return new WpfAnalyzer(config);
+}
+//# sourceMappingURL=wpf-analyzer.js.map

package/dist/wpf/wpf-analyzer.js.map

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

package/dist/wrappers/clustering/clusterer.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Wrapper Clustering
+ *
+ * Groups wrappers by their primitive signature to identify patterns.
+ */
+import type { WrapperFunction, WrapperCluster, WrapperCategory, DetectedPrimitive } from '../types.js';
+export interface ClusteringOptions {
+    minClusterSize?: number | undefined;
+    minTotalUsages?: number | undefined;
+    minConfidence?: number | undefined;
+}
+/**
+ * Cluster wrappers by their primitive signature
+ */
+export declare function clusterWrappers(wrappers: WrapperFunction[], primitives: DetectedPrimitive[], options?: ClusteringOptions): WrapperCluster[];
+/**
+ * Infer the category of a wrapper cluster based on its primitives
+ */
+export declare function inferCategory(primitives: string[], allPrimitives: DetectedPrimitive[]): WrapperCategory;
+/**
+ * Calculate confidence score for a cluster
+ */
+export declare function calculateConfidence(members: WrapperFunction[], primitives: string[], totalUsages: number, fileSpread: number): number;
+/**
+ * Detect naming patterns in wrapper members
+ */
+export declare function detectNamingPatterns(members: WrapperFunction[]): string[];
+/**
+ * Get clusters by category
+ */
+export declare function getClustersByCategory(clusters: WrapperCluster[]): Map<WrapperCategory, WrapperCluster[]>;
+/**
+ * Get the most common primitives across all clusters
+ */
+export declare function getMostCommonPrimitives(clusters: WrapperCluster[], limit?: number): {
+    primitive: string;
+    count: number;
+}[];
+/**
+ * Find clusters that share primitives
+ */
+export declare function findRelatedClusters(cluster: WrapperCluster, allClusters: WrapperCluster[]): WrapperCluster[];
+//# sourceMappingURL=clusterer.d.ts.map

package/dist/wrappers/clustering/clusterer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clusterer.d.ts","sourceRoot":"","sources":["../../../src/wrappers/clustering/clusterer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,eAAe,EACf,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAkBD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,eAAe,EAAE,EAC3B,UAAU,EAAE,iBAAiB,EAAE,EAC/B,OAAO,GAAE,iBAAsB,GAC9B,cAAc,EAAE,CAwDlB;AAOD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAAE,EACpB,aAAa,EAAE,iBAAiB,EAAE,GACjC,eAAe,CAmHjB;AAOD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,EAAE,EAC1B,UAAU,EAAE,MAAM,EAAE,EACpB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,MAAM,CAqCR;AA+BD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,EAAE,CAuBzE;AAiHD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,cAAc,EAAE,GACzB,GAAG,CAAC,eAAe,EAAE,cAAc,EAAE,CAAC,CASxC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,cAAc,EAAE,EAC1B,KAAK,SAAK,GACT;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAaxC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,cAAc,EAAE,GAC5B,cAAc,EAAE,CAOlB"}