driftdetect-detectors 0.1.0

package/dist/structural/file-naming.d.ts

@@ -0,0 +1,61 @@
+/**
+ * File Naming Detector - File naming convention detection
+ *
+ * Detects PascalCase, kebab-case, snake_case patterns
+ * and suffix patterns (.service.ts, .test.ts).
+ *
+ * @requirements 7.1 - THE Structural_Detector SHALL detect file naming conventions
+ */
+import type { Violation, QuickFix, Language } from 'driftdetect-core';
+import { StructuralDetector, type DetectionContext, type DetectionResult } from '../base/index.js';
+export type NamingConvention = 'PascalCase' | 'camelCase' | 'kebab-case' | 'snake_case' | 'SCREAMING_SNAKE_CASE' | 'unknown';
+export interface SuffixPattern {
+    suffix: string;
+    description: string;
+    expectedConvention?: NamingConvention;
+}
+export interface NamingPattern {
+    convention: NamingConvention;
+    extension: string;
+    suffix: string | undefined;
+    count: number;
+    examples: string[];
+}
+export interface FileNamingAnalysis {
+    fileName: string;
+    baseName: string;
+    convention: NamingConvention;
+    extension: string;
+    suffix: string | undefined;
+    followsPattern: boolean;
+    suggestedName: string | undefined;
+}
+export declare const COMMON_SUFFIXES: SuffixPattern[];
+export declare function detectNamingConvention(name: string): NamingConvention;
+export declare function convertToConvention(name: string, target: NamingConvention): string;
+export declare function splitIntoWords(name: string): string[];
+export declare function extractBaseName(fileName: string, suffixes?: SuffixPattern[]): {
+    baseName: string;
+    suffix: string | undefined;
+    extension: string;
+};
+export declare function analyzeFileName(filePath: string, dominant?: NamingConvention): FileNamingAnalysis;
+export declare class FileNamingDetector extends StructuralDetector {
+    readonly id = "structural/file-naming";
+    readonly category: "structural";
+    readonly subcategory = "naming-conventions";
+    readonly name = "File Naming Convention Detector";
+    readonly description = "Detects file naming patterns including PascalCase, kebab-case, snake_case conventions";
+    readonly supportedLanguages: Language[];
+    detect(context: DetectionContext): Promise<DetectionResult>;
+    generateQuickFix(violation: Violation): QuickFix | null;
+    private analyzeProjectFiles;
+    private getDominantConvention;
+    private createPatternMatch;
+    private createViolation;
+    private checkSuffixPattern;
+    private isSpecialFile;
+    private calcConfidence;
+}
+export declare function createFileNamingDetector(): FileNamingDetector;
+//# sourceMappingURL=file-naming.d.ts.map

package/dist/structural/file-naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-naming.d.ts","sourceRoot":"","sources":["../../src/structural/file-naming.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAgB,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAS,MAAM,kBAAkB,CAAC;AAC3F,OAAO,EAAE,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAMnG,MAAM,MAAM,gBAAgB,GACxB,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,YAAY,GACZ,sBAAsB,GACtB,SAAS,CAAC;AAEd,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,gBAAgB,CAAC;CACvC;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,eAAO,MAAM,eAAe,EAAE,aAAa,EAiB1C,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CASrE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAWlF;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAKrD;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,aAAa,EAAoB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAYlK;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,kBAAkB,CAWjG;AAGD,qBAAa,kBAAmB,SAAQ,kBAAkB;IACxD,QAAQ,CAAC,EAAE,4BAA4B;IACvC,QAAQ,CAAC,QAAQ,EAAG,YAAY,CAAU;IAC1C,QAAQ,CAAC,WAAW,wBAAwB;IAC5C,QAAQ,CAAC,IAAI,qCAAqC;IAClD,QAAQ,CAAC,WAAW,2FAA2F;IAC/G,QAAQ,CAAC,kBAAkB,EAAE,QAAQ,EAAE,CAAqF;IAEtH,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAsBjE,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,GAAG,IAAI;IAkBvD,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,kBAAkB;IAuB1B,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,cAAc;CAOvB;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CAAqC"}

package/dist/structural/file-naming.js

@@ -0,0 +1,231 @@
+/**
+ * File Naming Detector - File naming convention detection
+ *
+ * Detects PascalCase, kebab-case, snake_case patterns
+ * and suffix patterns (.service.ts, .test.ts).
+ *
+ * @requirements 7.1 - THE Structural_Detector SHALL detect file naming conventions
+ */
+import { StructuralDetector } from '../base/index.js';
+export const COMMON_SUFFIXES = [
+    { suffix: '.service', description: 'Service file', expectedConvention: 'kebab-case' },
+    { suffix: '.controller', description: 'Controller file', expectedConvention: 'kebab-case' },
+    { suffix: '.model', description: 'Model file', expectedConvention: 'PascalCase' },
+    { suffix: '.test', description: 'Test file' },
+    { suffix: '.spec', description: 'Spec file' },
+    { suffix: '.stories', description: 'Storybook file', expectedConvention: 'PascalCase' },
+    { suffix: '.hook', description: 'Hook file', expectedConvention: 'camelCase' },
+    { suffix: '.utils', description: 'Utilities file', expectedConvention: 'kebab-case' },
+    { suffix: '.types', description: 'Types file', expectedConvention: 'kebab-case' },
+    { suffix: '.schema', description: 'Schema file', expectedConvention: 'kebab-case' },
+    { suffix: '.context', description: 'Context file', expectedConvention: 'PascalCase' },
+    { suffix: '.reducer', description: 'Reducer file', expectedConvention: 'camelCase' },
+    { suffix: '.page', description: 'Page file', expectedConvention: 'PascalCase' },
+    { suffix: '.layout', description: 'Layout file', expectedConvention: 'PascalCase' },
+    { suffix: '.component', description: 'Component file', expectedConvention: 'PascalCase' },
+    { suffix: '.styles', description: 'Styles file', expectedConvention: 'kebab-case' },
+];
+export function detectNamingConvention(name) {
+    if (!name || name.length === 0)
+        return 'unknown';
+    if (/^[A-Z][A-Z0-9]*(_[A-Z0-9]+)*$/.test(name))
+        return 'SCREAMING_SNAKE_CASE';
+    if (/^[A-Z][a-zA-Z0-9]*$/.test(name))
+        return 'PascalCase';
+    if (/^[a-z][a-zA-Z0-9]*$/.test(name) && /[A-Z]/.test(name))
+        return 'camelCase';
+    if (/^[a-z][a-z0-9]*(-[a-z0-9]+)*$/.test(name))
+        return 'kebab-case';
+    if (/^[a-z][a-z0-9]*(_[a-z0-9]+)*$/.test(name))
+        return 'snake_case';
+    if (/^[a-z][a-z0-9]*$/.test(name))
+        return 'kebab-case';
+    return 'unknown';
+}
+export function convertToConvention(name, target) {
+    const words = splitIntoWords(name);
+    if (words.length === 0)
+        return name;
+    switch (target) {
+        case 'PascalCase': return words.map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()).join('');
+        case 'camelCase': return words.map((w, i) => i === 0 ? w.toLowerCase() : w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()).join('');
+        case 'kebab-case': return words.map((w) => w.toLowerCase()).join('-');
+        case 'snake_case': return words.map((w) => w.toLowerCase()).join('_');
+        case 'SCREAMING_SNAKE_CASE': return words.map((w) => w.toUpperCase()).join('_');
+        default: return name;
+    }
+}
+export function splitIntoWords(name) {
+    let n = name.replace(/[-_]/g, ' ');
+    n = n.replace(/([a-z])([A-Z])/g, '$1 $2');
+    n = n.replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2');
+    return n.split(/\s+/).filter((w) => w.length > 0);
+}
+export function extractBaseName(fileName, suffixes = COMMON_SUFFIXES) {
+    const lastDot = fileName.lastIndexOf('.');
+    if (lastDot === -1)
+        return { baseName: fileName, suffix: undefined, extension: '' };
+    const ext = fileName.slice(lastDot);
+    const nameNoExt = fileName.slice(0, lastDot);
+    for (const { suffix } of suffixes) {
+        if (nameNoExt.toLowerCase().endsWith(suffix.toLowerCase())) {
+            const base = nameNoExt.slice(0, -suffix.length);
+            if (base.length > 0)
+                return { baseName: base, suffix, extension: ext };
+        }
+    }
+    return { baseName: nameNoExt, suffix: undefined, extension: ext };
+}
+export function analyzeFileName(filePath, dominant) {
+    const fileName = filePath.split(/[/\\]/).pop() ?? filePath;
+    const { baseName, suffix, extension } = extractBaseName(fileName);
+    const convention = detectNamingConvention(baseName);
+    const followsPattern = dominant === undefined || convention === dominant;
+    let suggestedName;
+    if (!followsPattern && dominant && dominant !== 'unknown') {
+        const converted = convertToConvention(baseName, dominant);
+        suggestedName = suffix ? `${converted}${suffix}${extension}` : `${converted}${extension}`;
+    }
+    return { fileName, baseName, convention, extension, suffix, followsPattern, suggestedName };
+}
+export class FileNamingDetector extends StructuralDetector {
+    id = 'structural/file-naming';
+    category = 'structural';
+    subcategory = 'naming-conventions';
+    name = 'File Naming Convention Detector';
+    description = 'Detects file naming patterns including PascalCase, kebab-case, snake_case conventions';
+    supportedLanguages = ['typescript', 'javascript', 'python', 'css', 'scss', 'json', 'yaml', 'markdown'];
+    async detect(context) {
+        const patterns = [];
+        const violations = [];
+        const analysis = analyzeFileName(context.file);
+        const projectAnalysis = this.analyzeProjectFiles(context.projectContext.files);
+        if (analysis.convention !== 'unknown') {
+            patterns.push(this.createPatternMatch(context.file, analysis, projectAnalysis));
+        }
+        const dominant = this.getDominantConvention(projectAnalysis);
+        if (dominant && analysis.convention !== dominant) {
+            const v = this.createViolation(context.file, analysis, dominant);
+            if (v)
+                violations.push(v);
+        }
+        const suffixV = this.checkSuffixPattern(context.file, analysis);
+        if (suffixV)
+            violations.push(suffixV);
+        return this.createResult(patterns, violations, this.calcConfidence(projectAnalysis));
+    }
+    generateQuickFix(violation) {
+        const match = violation.message.match(/renamed to '([^']+)'/);
+        if (!match || !match[1])
+            return null;
+        const suggested = match[1];
+        const newPath = violation.file.replace(/[^/\\]+$/, suggested);
+        return {
+            title: `Rename to ${suggested}`,
+            kind: 'quickfix',
+            edit: {
+                changes: {},
+                documentChanges: [{ uri: violation.file, edits: [] }, { uri: newPath, edits: [] }],
+            },
+            isPreferred: true,
+            confidence: 0.9,
+            preview: `Rename file from '${violation.file.split(/[/\\]/).pop()}' to '${suggested}'`,
+        };
+    }
+    analyzeProjectFiles(files) {
+        const patterns = new Map();
+        for (const file of files) {
+            const a = analyzeFileName(file);
+            if (a.convention === 'unknown')
+                continue;
+            const existing = patterns.get(a.convention);
+            if (existing) {
+                existing.count++;
+                if (existing.examples.length < 5)
+                    existing.examples.push(file);
+            }
+            else
+                patterns.set(a.convention, { convention: a.convention, extension: a.extension, suffix: a.suffix, count: 1, examples: [file] });
+        }
+        return patterns;
+    }
+    getDominantConvention(patterns) {
+        let maxCount = 0, dominant;
+        for (const [conv, p] of patterns) {
+            if (p.count > maxCount) {
+                maxCount = p.count;
+                dominant = conv;
+            }
+        }
+        const total = Array.from(patterns.values()).reduce((s, p) => s + p.count, 0);
+        return dominant && maxCount / total > 0.5 ? dominant : undefined;
+    }
+    createPatternMatch(file, analysis, projectAnalysis) {
+        const p = projectAnalysis.get(analysis.convention);
+        const total = Array.from(projectAnalysis.values()).reduce((s, x) => s + x.count, 0);
+        const freq = p ? p.count / total : 0;
+        return { patternId: `file-naming-${analysis.convention}`, location: { file, line: 1, column: 1 }, confidence: freq, isOutlier: freq < 0.5 };
+    }
+    createViolation(file, analysis, dominant) {
+        const fileName = file.split(/[/\\]/).pop() ?? '';
+        if (this.isSpecialFile(fileName))
+            return null;
+        const suggested = analysis.suggestedName ?? convertToConvention(analysis.baseName, dominant) + (analysis.suffix ?? '') + analysis.extension;
+        const range = { start: { line: 1, character: 1 }, end: { line: 1, character: 1 } };
+        return {
+            id: `file-naming-${file.replace(/[^a-zA-Z0-9]/g, '-')}`,
+            patternId: 'structural/file-naming',
+            severity: 'warning',
+            file,
+            range,
+            message: `File '${fileName}' uses ${analysis.convention} but project uses ${dominant}. It should be renamed to '${suggested}'`,
+            expected: `${dominant} naming convention`,
+            actual: `${analysis.convention} naming convention`,
+            aiExplainAvailable: false,
+            aiFixAvailable: true,
+            firstSeen: new Date(),
+            occurrences: 1,
+        };
+    }
+    checkSuffixPattern(file, analysis) {
+        if (!analysis.suffix)
+            return null;
+        const sp = COMMON_SUFFIXES.find((s) => s.suffix.toLowerCase() === analysis.suffix?.toLowerCase());
+        if (!sp?.expectedConvention || analysis.convention === sp.expectedConvention || analysis.convention === 'unknown')
+            return null;
+        const suggestedBase = convertToConvention(analysis.baseName, sp.expectedConvention);
+        const suggested = `${suggestedBase}${analysis.suffix}${analysis.extension}`;
+        const range = { start: { line: 1, character: 1 }, end: { line: 1, character: 1 } };
+        return {
+            id: `file-naming-suffix-${file.replace(/[^a-zA-Z0-9]/g, '-')}`,
+            patternId: 'structural/file-naming-suffix',
+            severity: 'info',
+            file,
+            range,
+            message: `${sp.description} '${analysis.fileName}' should use ${sp.expectedConvention} naming. It should be renamed to '${suggested}'`,
+            expected: `${sp.expectedConvention} naming for ${sp.description.toLowerCase()}`,
+            actual: `${analysis.convention} naming`,
+            aiExplainAvailable: false,
+            aiFixAvailable: true,
+            firstSeen: new Date(),
+            occurrences: 1,
+        };
+    }
+    isSpecialFile(fileName) {
+        const special = ['index', 'main', 'app', 'readme', 'license', 'changelog', 'dockerfile', 'makefile', 'package', 'tsconfig', 'eslint', 'prettier', 'jest', 'vitest', 'vite', 'webpack', 'rollup', 'babel', 'postcss', 'tailwind', 'next'];
+        const lower = fileName.toLowerCase().replace(/\.[^.]+$/, '');
+        return special.some((s) => lower === s || lower.startsWith(`${s}.`));
+    }
+    calcConfidence(patterns) {
+        const total = Array.from(patterns.values()).reduce((s, p) => s + p.count, 0);
+        if (total === 0)
+            return 0.5;
+        let max = 0;
+        for (const p of patterns.values())
+            if (p.count > max)
+                max = p.count;
+        return Math.min(max / total + 0.2, 1.0);
+    }
+}
+export function createFileNamingDetector() { return new FileNamingDetector(); }
+//# sourceMappingURL=file-naming.js.map

package/dist/structural/file-naming.js.map

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

package/dist/structural/import-ordering.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Import Ordering Detector - Import organization detection
+ *
+ * Detects import grouping patterns and import sorting patterns.
+ * Identifies how imports are organized (external packages first, then internal modules,
+ * then relative imports), whether they are sorted alphabetically within groups,
+ * and whether blank lines separate groups.
+ *
+ * @requirements 7.5 - THE Structural_Detector SHALL detect import ordering and grouping patterns
+ */
+import type { Violation, QuickFix, Language } from 'driftdetect-core';
+import { StructuralDetector, type DetectionContext, type DetectionResult } from '../base/index.js';
+/**
+ * Types of import grouping patterns
+ */
+export type ImportGroupingPattern = 'grouped' | 'ungrouped' | 'mixed' | 'unknown';
+/**
+ * Types of import sorting patterns
+ */
+export type ImportSortingPattern = 'alphabetical' | 'unsorted' | 'mixed' | 'unknown';
+/**
+ * Types of imports based on their source
+ */
+export type ImportType = 'builtin' | 'external' | 'internal' | 'parent' | 'sibling' | 'index';
+/**
+ * Common Node.js built-in modules
+ */
+export declare const BUILTIN_MODULES: readonly ["assert", "buffer", "child_process", "cluster", "console", "constants", "crypto", "dgram", "dns", "domain", "events", "fs", "http", "https", "module", "net", "os", "path", "perf_hooks", "process", "punycode", "querystring", "readline", "repl", "stream", "string_decoder", "sys", "timers", "tls", "tty", "url", "util", "v8", "vm", "worker_threads", "zlib", "node:assert", "node:buffer", "node:child_process", "node:cluster", "node:console", "node:constants", "node:crypto", "node:dgram", "node:dns", "node:domain", "node:events", "node:fs", "node:http", "node:https", "node:module", "node:net", "node:os", "node:path", "node:perf_hooks", "node:process", "node:punycode", "node:querystring", "node:readline", "node:repl", "node:stream", "node:string_decoder", "node:sys", "node:timers", "node:tls", "node:tty", "node:url", "node:util", "node:v8", "node:vm", "node:worker_threads", "node:zlib"];
+/**
+ * Common internal alias patterns
+ * Note: @types/ is excluded as it's an external package namespace
+ */
+export declare const INTERNAL_ALIAS_PATTERNS: readonly [RegExp, RegExp, RegExp, RegExp];
+/**
+ * Information about a single import statement
+ */
+export interface ImportInfo {
+    /** The import source/specifier */
+    source: string;
+    /** The type of import */
+    type: ImportType;
+    /** Line number where the import appears */
+    line: number;
+    /** The full import statement text */
+    statement: string;
+    /** Whether this is a type-only import */
+    isTypeOnly: boolean;
+    /** Whether this is a side-effect import (no specifiers) */
+    isSideEffect: boolean;
+}
+/**
+ * Information about a group of imports
+ */
+export interface ImportGroup {
+    /** The type of imports in this group */
+    type: ImportType;
+    /** Imports in this group */
+    imports: ImportInfo[];
+    /** Starting line of the group */
+    startLine: number;
+    /** Ending line of the group */
+    endLine: number;
+    /** Whether imports in this group are sorted alphabetically */
+    isSorted: boolean;
+}
+/**
+ * Analysis of import ordering patterns in a file
+ */
+export interface FileImportAnalysis {
+    /** All imports found in the file */
+    imports: ImportInfo[];
+    /** Import groups detected */
+    groups: ImportGroup[];
+    /** Whether imports are grouped by type */
+    isGrouped: boolean;
+    /** Whether blank lines separate groups */
+    hasBlankLineSeparators: boolean;
+    /** Whether imports are sorted within groups */
+    isSortedWithinGroups: boolean;
+    /** The detected group order (e.g., ['builtin', 'external', 'internal', 'parent', 'sibling']) */
+    groupOrder: ImportType[];
+}
+/**
+ * Analysis of import ordering patterns across a project
+ */
+export interface ImportOrderingAnalysis {
+    /** Detected grouping pattern */
+    groupingPattern: ImportGroupingPattern;
+    /** Detected sorting pattern */
+    sortingPattern: ImportSortingPattern;
+    /** Confidence in the detection (0-1) */
+    confidence: number;
+    /** Files analyzed */
+    filesAnalyzed: number;
+    /** Files with grouped imports */
+    filesWithGroupedImports: number;
+    /** Files with sorted imports */
+    filesWithSortedImports: number;
+    /** Files with blank line separators */
+    filesWithBlankLineSeparators: number;
+    /** Most common group order */
+    dominantGroupOrder: ImportType[];
+    /** Percentage of files following the dominant pattern */
+    patternConsistency: number;
+}
+/**
+ * Python standard library modules (subset of most common)
+ */
+export declare const PYTHON_STDLIB_MODULES: readonly ["abc", "argparse", "asyncio", "base64", "collections", "contextlib", "copy", "csv", "dataclasses", "datetime", "decimal", "enum", "functools", "hashlib", "http", "importlib", "inspect", "io", "itertools", "json", "logging", "math", "multiprocessing", "os", "pathlib", "pickle", "random", "re", "shutil", "socket", "sqlite3", "ssl", "string", "subprocess", "sys", "tempfile", "threading", "time", "traceback", "typing", "unittest", "urllib", "uuid", "warnings", "xml", "zipfile"];
+/**
+ * Determine the type of a Python import based on its source
+ */
+export declare function getPythonImportType(source: string): ImportType;
+/**
+ * Parse Python import statements from file content
+ */
+export declare function parsePythonImports(content: string): ImportInfo[];
+/**
+ * Determine the type of an import based on its source
+ */
+export declare function getImportType(source: string): ImportType;
+/**
+ * Parse import statements from file content
+ */
+export declare function parseImports(content: string, filePath?: string): ImportInfo[];
+/**
+ * Check if imports are sorted alphabetically
+ */
+export declare function areImportsSorted(imports: ImportInfo[]): boolean;
+/**
+ * Detect import groups based on blank lines and import types
+ */
+export declare function detectImportGroups(imports: ImportInfo[], content: string): ImportGroup[];
+/**
+ * Check if groups are separated by blank lines
+ */
+export declare function hasBlankLineSeparators(groups: ImportGroup[], content: string): boolean;
+/**
+ * Check if imports are grouped by type
+ */
+export declare function areImportsGroupedByType(groups: ImportGroup[]): boolean;
+/**
+ * Get the order of import types from groups
+ */
+export declare function getGroupOrder(groups: ImportGroup[]): ImportType[];
+/**
+ * Analyze import ordering in a single file
+ */
+export declare function analyzeFileImports(content: string, filePath?: string): FileImportAnalysis;
+/**
+ * Analyze import ordering patterns across multiple files
+ */
+export declare function analyzeImportOrdering(fileContents: Map<string, string>): ImportOrderingAnalysis;
+/**
+ * Get the expected group order description
+ */
+export declare function getGroupOrderDescription(order: ImportType[]): string;
+/**
+ * Detector for import ordering and grouping patterns
+ *
+ * Identifies how imports are organized in a project:
+ * - Grouping by type (external, internal, relative)
+ * - Alphabetical sorting within groups
+ * - Blank line separators between groups
+ *
+ * @requirements 7.5 - THE Structural_Detector SHALL detect import ordering and grouping patterns
+ */
+export declare class ImportOrderingDetector extends StructuralDetector {
+    readonly id = "structural/import-ordering";
+    readonly category: "structural";
+    readonly subcategory = "import-ordering";
+    readonly name = "Import Ordering Detector";
+    readonly description = "Detects import grouping and sorting patterns";
+    readonly supportedLanguages: Language[];
+    /**
+     * Detect import ordering patterns in the project
+     */
+    detect(context: DetectionContext): Promise<DetectionResult>;
+    /**
+     * Generate a quick fix for import ordering violations
+     */
+    generateQuickFix(violation: Violation): QuickFix | null;
+    /**
+     * Create a pattern match for import grouping
+     */
+    private createGroupingPattern;
+    /**
+     * Create a pattern match for import sorting
+     */
+    private createSortingPattern;
+    /**
+     * Create a pattern match for group order
+     */
+    private createGroupOrderPattern;
+    /**
+     * Check if the file's import grouping follows the project pattern
+     */
+    private checkGroupingConsistency;
+    /**
+     * Check if the file's import sorting follows the project pattern
+     */
+    private checkSortingConsistency;
+    /**
+     * Check if the file uses blank line separators between import groups
+     */
+    private checkBlankLineSeparators;
+}
+/**
+ * Create a new ImportOrderingDetector instance
+ */
+export declare function createImportOrderingDetector(): ImportOrderingDetector;
+//# sourceMappingURL=import-ordering.d.ts.map

package/dist/structural/import-ordering.d.ts.map

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