@flagshark/core 1.0.0

package/dist/detection/helpers.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Shared detection helper utilities.
+ * Ported from Go: internal/languages/helpers/helpers.go
+ */
+import type { FeatureFlag } from './feature-flag.js';
+import type { MethodConfig, FeatureFlagProvider, Language } from './interface.js';
+/** Extracts method names from a list of MethodConfig. */
+export declare function extractMethodNames(methods: MethodConfig[]): string[];
+/** Returns the flagKeyIndex from the first method, or 0 if empty. */
+export declare function getDefaultKeyIndex(methods: MethodConfig[]): number;
+/**
+ * Deduplicates feature flags based on filePath + name + lineNumber.
+ * Keeps the first occurrence.
+ */
+export declare function deduplicateFlags(flags: FeatureFlag[]): FeatureFlag[];
+/**
+ * Extracts a string argument from a method call at a given parameter index.
+ * Handles both single-quoted and double-quoted strings, and backtick template literals.
+ *
+ * @param callText - The full method call text (e.g., `client.variation("flag-key", ctx, false)`)
+ * @param paramIndex - The 0-based index of the parameter to extract
+ * @returns The extracted string value (without quotes), or null if not found
+ */
+export declare function extractStringArgument(callText: string, paramIndex: number): string | null;
+/**
+ * Splits a comma-separated argument list, respecting nested parentheses,
+ * brackets, braces, and string literals.
+ */
+export declare function splitArguments(argsStr: string): string[];
+/**
+ * Builds a regex pattern that matches any of the given method names being called.
+ * Supports both dot-notation (obj.method) and standalone function calls.
+ *
+ * @returns A RegExp that captures the full call expression, including the first string argument.
+ */
+export declare function buildMethodCallPattern(methodNames: string[]): RegExp;
+/** Escapes special regex characters in a string. */
+export declare function escapeRegExp(str: string): string;
+/**
+ * Detects feature flags in source code using regex-based pattern matching.
+ * This is used by all language detectors as the primary detection mechanism.
+ */
+export declare function detectFlagsWithRegex(filename: string, content: string, language: Language, providers: FeatureFlagProvider[]): FeatureFlag[];
+/** Checks whether a string looks like a valid feature flag key. */
+export declare function isValidFlagKey(key: string): boolean;
+/**
+ * Merges custom providers with defaults.
+ * Custom providers override defaults with the same import pattern.
+ */
+export declare function mergeProviders(defaults: FeatureFlagProvider[], custom: FeatureFlagProvider[]): FeatureFlagProvider[];
+//# sourceMappingURL=helpers.d.ts.map

package/dist/detection/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/detection/helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEjF,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAEpE;AAED,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAKlE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAapE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwBzF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAkDxD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAQpE;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,mBAAmB,EAAE,GAC/B,WAAW,EAAE,CA6Df;AAkDD,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAanD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,MAAM,EAAE,mBAAmB,EAAE,GAC5B,mBAAmB,EAAE,CAuBvB"}

package/dist/detection/helpers.js

@@ -0,0 +1,266 @@
+/**
+ * Shared detection helper utilities.
+ * Ported from Go: internal/languages/helpers/helpers.go
+ */
+import { getImportPattern } from './interface.js';
+/** Extracts method names from a list of MethodConfig. */
+export function extractMethodNames(methods) {
+    return methods.map((m) => m.name);
+}
+/** Returns the flagKeyIndex from the first method, or 0 if empty. */
+export function getDefaultKeyIndex(methods) {
+    if (methods.length > 0) {
+        return methods[0].flagKeyIndex;
+    }
+    return 0;
+}
+/**
+ * Deduplicates feature flags based on filePath + name + lineNumber.
+ * Keeps the first occurrence.
+ */
+export function deduplicateFlags(flags) {
+    const seen = new Set();
+    const result = [];
+    for (const flag of flags) {
+        const key = `${flag.filePath}:${flag.name}:${flag.lineNumber}`;
+        if (!seen.has(key)) {
+            seen.add(key);
+            result.push(flag);
+        }
+    }
+    return result;
+}
+/**
+ * Extracts a string argument from a method call at a given parameter index.
+ * Handles both single-quoted and double-quoted strings, and backtick template literals.
+ *
+ * @param callText - The full method call text (e.g., `client.variation("flag-key", ctx, false)`)
+ * @param paramIndex - The 0-based index of the parameter to extract
+ * @returns The extracted string value (without quotes), or null if not found
+ */
+export function extractStringArgument(callText, paramIndex) {
+    // Find the opening parenthesis
+    const parenStart = callText.indexOf('(');
+    if (parenStart === -1) {
+        return null;
+    }
+    const parenEnd = callText.lastIndexOf(')');
+    if (parenEnd === -1) {
+        return null;
+    }
+    const argsStr = callText.slice(parenStart + 1, parenEnd);
+    const args = splitArguments(argsStr);
+    if (paramIndex < 0 || paramIndex >= args.length) {
+        return null;
+    }
+    const arg = args[paramIndex].trim();
+    // Match quoted strings: "value", 'value', or `value`
+    const match = arg.match(/^["'`](.*)["'`]$/);
+    return match ? match[1] : null;
+}
+/**
+ * Splits a comma-separated argument list, respecting nested parentheses,
+ * brackets, braces, and string literals.
+ */
+export function splitArguments(argsStr) {
+    const args = [];
+    let depth = 0;
+    let current = '';
+    let inString = null;
+    for (let i = 0; i < argsStr.length; i++) {
+        const ch = argsStr[i];
+        const prev = i > 0 ? argsStr[i - 1] : '';
+        if (inString) {
+            current += ch;
+            if (ch === inString && prev !== '\\') {
+                inString = null;
+            }
+            continue;
+        }
+        if (ch === '"' || ch === "'" || ch === '`') {
+            inString = ch;
+            current += ch;
+            continue;
+        }
+        if (ch === '(' || ch === '[' || ch === '{') {
+            depth++;
+            current += ch;
+            continue;
+        }
+        if (ch === ')' || ch === ']' || ch === '}') {
+            depth--;
+            current += ch;
+            continue;
+        }
+        if (ch === ',' && depth === 0) {
+            args.push(current);
+            current = '';
+            continue;
+        }
+        current += ch;
+    }
+    if (current.trim().length > 0) {
+        args.push(current);
+    }
+    return args;
+}
+/**
+ * Builds a regex pattern that matches any of the given method names being called.
+ * Supports both dot-notation (obj.method) and standalone function calls.
+ *
+ * @returns A RegExp that captures the full call expression, including the first string argument.
+ */
+export function buildMethodCallPattern(methodNames) {
+    if (methodNames.length === 0) {
+        return /(?!)/; // Never matches
+    }
+    const escaped = methodNames.map((n) => escapeRegExp(n));
+    const alternation = escaped.join('|');
+    // Match: optional_receiver.methodName( ... ) capturing the call
+    return new RegExp(`(?:^|[^\\w.])(?:\\w+\\.)?(?:${alternation})\\s*\\(`, 'gm');
+}
+/** Escapes special regex characters in a string. */
+export function escapeRegExp(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Detects feature flags in source code using regex-based pattern matching.
+ * This is used by all language detectors as the primary detection mechanism.
+ */
+export function detectFlagsWithRegex(filename, content, language, providers) {
+    const flags = [];
+    const lines = content.split('\n');
+    for (const provider of providers) {
+        if (!provider.enabled) {
+            continue;
+        }
+        if (provider.methods.length === 0) {
+            continue;
+        }
+        const providerName = provider.name;
+        const importPat = getImportPattern(provider);
+        // Import check: skip this provider if file doesn't import its SDK.
+        // Providers with no importPattern (e.g., "Custom Feature Flags") are kept as fallbacks.
+        if (importPat) {
+            const hasImport = content.includes(importPat) || lines.some((line) => line.includes(importPat));
+            if (!hasImport) {
+                continue;
+            }
+        }
+        for (const method of provider.methods) {
+            // Skip methods that return all flags (flagKeyIndex = -1)
+            if (method.flagKeyIndex < 0) {
+                continue;
+            }
+            const pattern = buildSingleMethodPattern(method.name);
+            for (let lineIdx = 0; lineIdx < lines.length; lineIdx++) {
+                const line = lines[lineIdx];
+                let match;
+                while ((match = pattern.exec(line)) !== null) {
+                    const callStart = match.index;
+                    // Extract the full call from this position
+                    const restOfContent = getCallExpression(lines, lineIdx, callStart);
+                    if (!restOfContent) {
+                        continue;
+                    }
+                    const flagKey = extractStringArgument(restOfContent, method.flagKeyIndex);
+                    if (flagKey && isValidFlagKey(flagKey)) {
+                        flags.push({
+                            name: flagKey,
+                            filePath: filename,
+                            lineNumber: lineIdx + 1,
+                            language,
+                            provider: importPat || providerName,
+                        });
+                    }
+                }
+            }
+        }
+    }
+    return deduplicateFlags(flags);
+}
+/** Builds a regex for a single method name that matches calls. */
+function buildSingleMethodPattern(methodName) {
+    const escaped = escapeRegExp(methodName);
+    return new RegExp(`(?:^|[^\\w])(?:\\w+[.:])?${escaped}\\s*\\(`, 'g');
+}
+/**
+ * Extracts a full call expression starting from a match position,
+ * handling multi-line calls by tracking parenthesis depth.
+ */
+function getCallExpression(lines, startLine, startCol) {
+    let result = lines[startLine].slice(startCol);
+    let depth = 0;
+    let foundOpen = false;
+    for (let i = 0; i < result.length; i++) {
+        if (result[i] === '(') {
+            depth++;
+            foundOpen = true;
+        }
+        else if (result[i] === ')') {
+            depth--;
+            if (foundOpen && depth === 0) {
+                return result.slice(0, i + 1);
+            }
+        }
+    }
+    // Multi-line call: continue scanning subsequent lines (up to 10)
+    const maxLines = Math.min(startLine + 10, lines.length);
+    for (let lineIdx = startLine + 1; lineIdx < maxLines; lineIdx++) {
+        const line = lines[lineIdx];
+        result += '\n' + line;
+        for (let i = 0; i < line.length; i++) {
+            if (line[i] === '(') {
+                depth++;
+                foundOpen = true;
+            }
+            else if (line[i] === ')') {
+                depth--;
+                if (foundOpen && depth === 0) {
+                    return result;
+                }
+            }
+        }
+    }
+    return foundOpen ? result : null;
+}
+/** Checks whether a string looks like a valid feature flag key. */
+export function isValidFlagKey(key) {
+    if (key.length === 0 || key.length > 256) {
+        return false;
+    }
+    const invalidPrefixes = ['http://', 'https://', 'file://', '/'];
+    for (const prefix of invalidPrefixes) {
+        if (key.startsWith(prefix)) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Merges custom providers with defaults.
+ * Custom providers override defaults with the same import pattern.
+ */
+export function mergeProviders(defaults, custom) {
+    const result = [...defaults];
+    const byPattern = new Map();
+    for (let i = 0; i < result.length; i++) {
+        const pattern = getImportPattern(result[i]);
+        if (pattern) {
+            byPattern.set(pattern, i);
+        }
+    }
+    for (const customProvider of custom) {
+        const pattern = getImportPattern(customProvider);
+        const idx = byPattern.get(pattern);
+        if (idx !== undefined) {
+            result[idx] = customProvider;
+        }
+        else {
+            result.push(customProvider);
+            byPattern.set(pattern, result.length - 1);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/detection/helpers.js.map

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

package/dist/detection/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Detection module barrel export.
+ * Re-exports registry, interfaces, and provides factory for a fully-loaded registry.
+ */
+import { LanguageRegistry } from './registry.js';
+export type { FeatureFlag } from './feature-flag.js';
+export type { Language, LanguageDetector, FeatureFlagProvider, MethodConfig, DetectionResult, } from './interface.js';
+export { Languages, getImportPattern } from './interface.js';
+export { LanguageRegistry, getDefaultRegistry, resetDefaultRegistry } from './registry.js';
+export { PolyglotAnalyzer, compareResults } from './polyglot-analyzer.js';
+export type { FlagDetector, LanguageRegistry as PolyglotLanguageRegistry, FileAnalysisStatus, FileAnalysisResult, RepositoryAnalysisResult, AnalysisProgressCallback, FlagOccurrence, OccurrenceChange, ComparisonResult, Language as PolyglotLanguage, } from './polyglot-analyzer.js';
+export { GoDetector, TypeScriptDetector, JavaScriptDetector, PythonDetector, JavaDetector, KotlinDetector, SwiftDetector, RubyDetector, CSharpDetector, PHPDetector, RustDetector, CPPDetector, ObjectiveCDetector, } from './detectors/index.js';
+export { detectFlagsWithRegex, deduplicateFlags, extractStringArgument, splitArguments, buildMethodCallPattern, escapeRegExp, isValidFlagKey, mergeProviders, extractMethodNames, getDefaultKeyIndex, } from './helpers.js';
+export { convertConfigProviders, languageToConfigLanguage, loadProvidersForLanguage, } from './config-adapter.js';
+/**
+ * Creates a LanguageRegistry pre-loaded with all 13 language detectors.
+ */
+export declare function createDefaultRegistry(): LanguageRegistry;
+//# sourceMappingURL=index.d.ts.map

package/dist/detection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/detection/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAGhD,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,eAAe,GAChB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAG5D,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAG1F,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACzE,YAAY,EACV,YAAY,EACZ,gBAAgB,IAAI,wBAAwB,EAC5C,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,EACxB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,IAAI,gBAAgB,GAC7B,MAAM,wBAAwB,CAAA;AAG/B,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,aAAa,EACb,YAAY,EACZ,cAAc,EACd,WAAW,EACX,YAAY,EACZ,WAAW,EACX,kBAAkB,GACnB,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,sBAAsB,EACtB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,qBAAqB,CAAA;AAE5B;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,gBAAgB,CAmBxD"}

package/dist/detection/index.js

@@ -0,0 +1,53 @@
+/**
+ * Detection module barrel export.
+ * Re-exports registry, interfaces, and provides factory for a fully-loaded registry.
+ */
+import { CPPDetector } from './detectors/cpp.js';
+import { CSharpDetector } from './detectors/csharp.js';
+import { GoDetector } from './detectors/go.js';
+import { JavaDetector } from './detectors/java.js';
+import { JavaScriptDetector } from './detectors/javascript.js';
+import { KotlinDetector } from './detectors/kotlin.js';
+import { ObjectiveCDetector } from './detectors/objectivec.js';
+import { PHPDetector } from './detectors/php.js';
+import { PythonDetector } from './detectors/python.js';
+import { RubyDetector } from './detectors/ruby.js';
+import { RustDetector } from './detectors/rust.js';
+import { SwiftDetector } from './detectors/swift.js';
+import { TypeScriptDetector } from './detectors/typescript.js';
+import { LanguageRegistry } from './registry.js';
+export { Languages, getImportPattern } from './interface.js';
+// Registry
+export { LanguageRegistry, getDefaultRegistry, resetDefaultRegistry } from './registry.js';
+// Polyglot analyzer
+export { PolyglotAnalyzer, compareResults } from './polyglot-analyzer.js';
+// All 13 detectors
+export { GoDetector, TypeScriptDetector, JavaScriptDetector, PythonDetector, JavaDetector, KotlinDetector, SwiftDetector, RubyDetector, CSharpDetector, PHPDetector, RustDetector, CPPDetector, ObjectiveCDetector, } from './detectors/index.js';
+// Helpers
+export { detectFlagsWithRegex, deduplicateFlags, extractStringArgument, splitArguments, buildMethodCallPattern, escapeRegExp, isValidFlagKey, mergeProviders, extractMethodNames, getDefaultKeyIndex, } from './helpers.js';
+// Config adapter
+export { convertConfigProviders, languageToConfigLanguage, loadProvidersForLanguage, } from './config-adapter.js';
+/**
+ * Creates a LanguageRegistry pre-loaded with all 13 language detectors.
+ */
+export function createDefaultRegistry() {
+    const registry = new LanguageRegistry();
+    registry.register(new GoDetector());
+    registry.register(new TypeScriptDetector());
+    registry.register(new PythonDetector());
+    registry.register(new JavaDetector());
+    registry.register(new KotlinDetector());
+    registry.register(new SwiftDetector());
+    registry.register(new RubyDetector());
+    registry.register(new CSharpDetector());
+    registry.register(new PHPDetector());
+    registry.register(new RustDetector());
+    registry.register(new CPPDetector());
+    registry.register(new ObjectiveCDetector());
+    // JavaScriptDetector has its own provider list (different from TypeScript).
+    // Both can be registered since they have different language keys.
+    // TypeScriptDetector is checked first for .js files (first-match wins).
+    registry.register(new JavaScriptDetector());
+    return registry;
+}
+//# sourceMappingURL=index.js.map

package/dist/detection/index.js.map

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

package/dist/detection/interface.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Language detection interfaces and types.
+ * Ported from Go: internal/languages/interface.go
+ */
+import type { FeatureFlag } from './feature-flag.js';
+/** Supported programming language identifiers. */
+export type Language = 'go' | 'typescript' | 'javascript' | 'python' | 'java' | 'kotlin' | 'swift' | 'ruby' | 'csharp' | 'php' | 'rust' | 'cpp' | 'objc';
+/** All supported language constants for convenience. */
+export declare const Languages: {
+    readonly Go: Language;
+    readonly TypeScript: Language;
+    readonly JavaScript: Language;
+    readonly Python: Language;
+    readonly Java: Language;
+    readonly Kotlin: Language;
+    readonly Swift: Language;
+    readonly Ruby: Language;
+    readonly CSharp: Language;
+    readonly PHP: Language;
+    readonly Rust: Language;
+    readonly CPP: Language;
+    readonly ObjectiveC: Language;
+};
+/** Defines how to detect a specific feature flag method call. */
+export interface MethodConfig {
+    /** Method name to match (e.g., "BoolVariation", "isEnabled") */
+    name: string;
+    /** Regex pattern override (optional; defaults to method name) */
+    pattern?: string;
+    /** Index of the flag key parameter in the method call (0-based) */
+    flagKeyIndex: number;
+    /** Index of the context parameter (optional) */
+    contextIndex?: number;
+    /** Example usages for documentation */
+    examples?: string[];
+}
+/** Represents a feature flag library/service provider for a language. */
+export interface FeatureFlagProvider {
+    /** Display name (e.g., "LaunchDarkly Go SDK") */
+    name: string;
+    /** Import/package path for the SDK */
+    packagePath?: string;
+    /** Import pattern to match in source code */
+    importPattern?: string;
+    /** Methods to detect */
+    methods: MethodConfig[];
+    /** Human-readable description */
+    description?: string;
+    /** Whether detection is enabled for this provider */
+    enabled: boolean;
+}
+/** Returns the effective import pattern, supporting backward compatibility. */
+export declare function getImportPattern(provider: FeatureFlagProvider): string;
+/**
+ * LanguageDetector defines the interface for language-specific feature flag detection.
+ * Each supported language implements this interface.
+ */
+export interface LanguageDetector {
+    /** Returns the language this detector supports. */
+    language(): Language;
+    /** Returns the file extensions this detector handles (e.g., [".go", ".py"]). */
+    fileExtensions(): string[];
+    /** Detects feature flags in the given source code. */
+    detectFlags(filename: string, content: string): FeatureFlag[];
+    /** Checks if this detector can handle the given file. */
+    supportsFile(filename: string): boolean;
+    /** Returns the feature flag providers supported by this language. */
+    getProviders(): FeatureFlagProvider[];
+}
+/** Detailed detection result with metadata. */
+export interface DetectionResult {
+    flags: FeatureFlag[];
+    language: Language;
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/detection/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/detection/interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,kDAAkD;AAClD,MAAM,MAAM,QAAQ,GAChB,IAAI,GACJ,YAAY,GACZ,YAAY,GACZ,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,OAAO,GACP,MAAM,GACN,QAAQ,GACR,KAAK,GACL,MAAM,GACN,KAAK,GACL,MAAM,CAAA;AAEV,wDAAwD;AACxD,eAAO,MAAM,SAAS;iBACR,QAAQ;yBACQ,QAAQ;yBACR,QAAQ;qBAChB,QAAQ;mBACZ,QAAQ;qBACJ,QAAQ;oBACV,QAAQ;mBACV,QAAQ;qBACJ,QAAQ;kBACd,QAAQ;mBACN,QAAQ;kBACV,QAAQ;yBACA,QAAQ;CACtB,CAAA;AAEV,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAA;IACZ,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mEAAmE;IACnE,YAAY,EAAE,MAAM,CAAA;IACpB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,yEAAyE;AACzE,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAA;IACZ,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,6CAA6C;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,wBAAwB;IACxB,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CAEtE;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,QAAQ,IAAI,QAAQ,CAAA;IAEpB,gFAAgF;IAChF,cAAc,IAAI,MAAM,EAAE,CAAA;IAE1B,sDAAsD;IACtD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAAA;IAE7D,yDAAyD;IACzD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;IAEvC,qEAAqE;IACrE,YAAY,IAAI,mBAAmB,EAAE,CAAA;CACtC;AAED,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,QAAQ,EAAE,QAAQ,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC"}

package/dist/detection/interface.js

@@ -0,0 +1,25 @@
+/**
+ * Language detection interfaces and types.
+ * Ported from Go: internal/languages/interface.go
+ */
+/** All supported language constants for convenience. */
+export const Languages = {
+    Go: 'go',
+    TypeScript: 'typescript',
+    JavaScript: 'javascript',
+    Python: 'python',
+    Java: 'java',
+    Kotlin: 'kotlin',
+    Swift: 'swift',
+    Ruby: 'ruby',
+    CSharp: 'csharp',
+    PHP: 'php',
+    Rust: 'rust',
+    CPP: 'cpp',
+    ObjectiveC: 'objc',
+};
+/** Returns the effective import pattern, supporting backward compatibility. */
+export function getImportPattern(provider) {
+    return provider.importPattern || provider.packagePath || '';
+}
+//# sourceMappingURL=interface.js.map

package/dist/detection/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/detection/interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoBH,wDAAwD;AACxD,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,EAAE,EAAE,IAAgB;IACpB,UAAU,EAAE,YAAwB;IACpC,UAAU,EAAE,YAAwB;IACpC,MAAM,EAAE,QAAoB;IAC5B,IAAI,EAAE,MAAkB;IACxB,MAAM,EAAE,QAAoB;IAC5B,KAAK,EAAE,OAAmB;IAC1B,IAAI,EAAE,MAAkB;IACxB,MAAM,EAAE,QAAoB;IAC5B,GAAG,EAAE,KAAiB;IACtB,IAAI,EAAE,MAAkB;IACxB,GAAG,EAAE,KAAiB;IACtB,UAAU,EAAE,MAAkB;CACtB,CAAA;AAgCV,+EAA+E;AAC/E,MAAM,UAAU,gBAAgB,CAAC,QAA6B;IAC5D,OAAO,QAAQ,CAAC,aAAa,IAAI,QAAQ,CAAC,WAAW,IAAI,EAAE,CAAA;AAC7D,CAAC"}

package/dist/detection/polyglot-analyzer.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Polyglot Analyzer -- multi-language feature flag detection coordinator.
+ * Ported from Go: internal/processor/polyglot_analyzer.go
+ *
+ * This module coordinates analysis across multiple programming languages,
+ * delegating to language-specific detectors registered in a language registry.
+ */
+import type { FeatureFlag } from './feature-flag.js';
+interface Logger {
+    debug(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+}
+export type Language = string;
+export interface FlagDetector {
+    language(): Language;
+    detectFlags(filePath: string, content: string): Promise<FeatureFlag[]> | FeatureFlag[];
+}
+export interface LanguageRegistry {
+    getDetectorForFile(filePath: string): FlagDetector | undefined;
+    getSupportedExtensions(): string[];
+    getSupportedLanguages(): Language[];
+}
+export type FileAnalysisStatus = 'ok' | 'partial' | 'skipped' | 'unsupported';
+export interface FileAnalysisResult {
+    filePath: string;
+    language: Language;
+    flags: FeatureFlag[];
+    parseErrors: Error[];
+    status: FileAnalysisStatus;
+    skippedReason?: string;
+}
+export interface RepositoryAnalysisResult {
+    commitSha?: string;
+    files: Map<string, FileAnalysisResult>;
+    /** Map of flag name to all occurrences. */
+    totalFlags: Map<string, FeatureFlag[]>;
+    /** Count of files per language. */
+    languages: Map<Language, number>;
+    skippedFiles: string[];
+    partialFiles: string[];
+}
+export type AnalysisProgressCallback = (analyzed: number, total: number) => void;
+export declare class PolyglotAnalyzer {
+    private registry;
+    private logger;
+    constructor(registry: LanguageRegistry, logger: Logger);
+    /** Analyzes multiple files using appropriate language detectors. */
+    analyzeFiles(files: Map<string, string>, signal?: AbortSignal): Promise<RepositoryAnalysisResult>;
+    /** Analyzes multiple files with progress reporting. */
+    analyzeFilesWithProgress(files: Map<string, string>, progressCallback?: AnalysisProgressCallback, signal?: AbortSignal): Promise<RepositoryAnalysisResult>;
+    /** Analyzes a single file using the appropriate language detector. */
+    analyzeSingleFile(filePath: string, content: string): Promise<FileAnalysisResult>;
+    /** Determines if a file should be analyzed based on language support. */
+    shouldAnalyzeFile(filePath: string, status: string): boolean;
+    /** Returns all supported file extensions. */
+    getSupportedExtensions(): string[];
+    private analyzeFile;
+}
+export interface FlagOccurrence {
+    name: string;
+    filePath: string;
+    lineNumber: number;
+    language: string;
+    provider?: string;
+}
+export interface OccurrenceChange {
+    flagName: string;
+    beforeCount: number;
+    afterCount: number;
+    addedIn: FlagOccurrence[];
+    removedFrom: FlagOccurrence[];
+}
+export interface ComparisonResult {
+    added: Map<string, FlagOccurrence[]>;
+    removed: Map<string, FlagOccurrence[]>;
+    occurrenceChanges: Map<string, OccurrenceChange>;
+}
+/** Compares two analysis results to find flag changes. */
+export declare function compareResults(before: RepositoryAnalysisResult, after: RepositoryAnalysisResult): ComparisonResult;
+export {};
+//# sourceMappingURL=polyglot-analyzer.d.ts.map

package/dist/detection/polyglot-analyzer.d.ts.map

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