driftdetect-core 0.1.0

package/dist/matcher/pattern-matcher.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Pattern Matcher - Match code against pattern definitions
+ *
+ * Provides pattern matching capabilities using AST-based, regex-based,
+ * and structural matching methods. Supports caching of match results
+ * for improved performance.
+ *
+ * @requirements 5.1 - Pattern matching with confidence scoring
+ */
+import type { PatternDefinition, PatternMatchResult, MatcherContext, MatcherConfig, MatchingResult } from './types.js';
+/**
+ * Options for matching operations
+ */
+export interface MatchOptions {
+    /** Whether to use cached results */
+    useCache?: boolean;
+    /** Maximum matches to return */
+    maxMatches?: number;
+    /** Minimum confidence threshold */
+    minConfidence?: number;
+}
+/**
+ * PatternMatcher class for matching code against pattern definitions.
+ *
+ * Supports multiple matching methods:
+ * - AST-based matching: Uses AST node types and properties
+ * - Regex-based matching: Uses regular expressions
+ * - Structural matching: Uses file paths and naming conventions
+ *
+ * @requirements 5.1 - Pattern matching with confidence scoring
+ */
+export declare class PatternMatcher {
+    private config;
+    private cache;
+    private cacheMaxSize;
+    private cacheTTL;
+    /**
+     * Create a new PatternMatcher instance.
+     *
+     * @param config - Matcher configuration options
+     */
+    constructor(config?: MatcherConfig);
+    /**
+     * Match code against a single pattern definition.
+     *
+     * @param context - The matcher context containing file info and AST
+     * @param pattern - The pattern definition to match against
+     * @param options - Optional matching options
+     * @returns Array of pattern match results
+     */
+    match(context: MatcherContext, pattern: PatternDefinition, options?: MatchOptions): PatternMatchResult[];
+    /**
+     * Match code against multiple pattern definitions.
+     *
+     * @param context - The matcher context containing file info and AST
+     * @param patterns - Array of pattern definitions to match against
+     * @param options - Optional matching options
+     * @returns Matching result with all matches and errors
+     */
+    matchAll(context: MatcherContext, patterns: PatternDefinition[], options?: MatchOptions): MatchingResult;
+    /**
+     * Clear the match cache.
+     */
+    clearCache(): void;
+    /**
+     * Get cache statistics.
+     */
+    getCacheStats(): {
+        size: number;
+        maxSize: number;
+    };
+    /**
+     * Perform AST-based pattern matching.
+     */
+    private matchAST;
+    /**
+     * Match a single AST node against an AST match config.
+     */
+    private matchASTNode;
+    /**
+     * Match AST children against child patterns.
+     */
+    private matchASTChildren;
+    /**
+     * Get all descendants of an AST node.
+     */
+    private getAllDescendants;
+    /**
+     * Traverse AST depth-first.
+     */
+    private traverseAST;
+    /**
+     * Match a property value against an expected value.
+     */
+    private matchPropertyValue;
+    /**
+     * Perform regex-based pattern matching.
+     */
+    private matchRegex;
+    /**
+     * Create a RegExp from regex config.
+     */
+    private createRegex;
+    /**
+     * Extract named captures from a regex match.
+     */
+    private extractCaptures;
+    /**
+     * Convert a string index to a location.
+     */
+    private indexToLocation;
+    /**
+     * Perform structural pattern matching.
+     */
+    private matchStructural;
+    /**
+     * Match a path against a glob pattern.
+     */
+    private matchGlobPattern;
+    /**
+     * Match a filename against a naming pattern.
+     */
+    private matchNamingPattern;
+    /**
+     * Get the directory part of a path.
+     */
+    private getDirectory;
+    /**
+     * Get the filename without extension.
+     */
+    private getFileName;
+    /**
+     * Get the file extension.
+     */
+    private getExtension;
+    /**
+     * Check if a file matches the pattern's include/exclude patterns.
+     */
+    private matchesFilePatterns;
+    /**
+     * Generate a cache key for a context and pattern.
+     */
+    private getCacheKey;
+    /**
+     * Generate a content hash for cache validation.
+     */
+    private getContentHash;
+    /**
+     * Get cached results if available and valid.
+     */
+    private getCachedResults;
+    /**
+     * Cache match results.
+     */
+    private cacheResults;
+    /**
+     * Evict the oldest cache entry.
+     */
+    private evictOldestEntry;
+    /**
+     * Filter results based on options.
+     */
+    private filterResults;
+    /**
+     * Convert an AST node to a Location.
+     */
+    private nodeToLocation;
+}
+//# sourceMappingURL=pattern-matcher.d.ts.map

package/dist/matcher/pattern-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-matcher.d.ts","sourceRoot":"","sources":["../../src/matcher/pattern-matcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,cAAc,EAKf,MAAM,YAAY,CAAC;AAcpB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAS;IAEzB;;;;OAIG;gBACS,MAAM,GAAE,aAAkB;IAOtC;;;;;;;OAOG;IACH,KAAK,CACH,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,GAAE,YAAiB,GACzB,kBAAkB,EAAE;IAiEvB;;;;;;;OAOG;IACH,QAAQ,CACN,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,OAAO,GAAE,YAAiB,GACzB,cAAc;IA4BjB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAWlD;;OAEG;IACH,OAAO,CAAC,QAAQ;IAgDhB;;OAEG;IACH,OAAO,CAAC,YAAY;IAgDpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA+BxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAWnB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkB1B;;OAEG;IACH,OAAO,CAAC,UAAU;IAoDlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAenB;;OAEG;IACH,OAAO,CAAC,eAAe;IAoBvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiCvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiFvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA2B3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA2BxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAkBpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoBxB;;OAEG;IACH,OAAO,CAAC,aAAa;IAyBrB;;OAEG;IACH,OAAO,CAAC,cAAc;CASvB"}