import type { TSESTree } from '@typescript-eslint/typescript-estree';
export interface ParsedFile {
    filePath: string;
    source: string;
    ast: TSESTree.Program;
    imports: Map<string, ImportInfo>;
    exportedComponents: Map<string, ComponentDef>;
    reExports: Map<string, ReExportInfo>;
}
export interface ImportInfo {
    sourcePath: string;
    resolvedPath: string | null;
    namedImports: string[];
    defaultImport: string | null;
}
export interface ComponentDef {
    name: string;
    node: TSESTree.FunctionDeclaration | TSESTree.ArrowFunctionExpression | TSESTree.FunctionExpression;
    returnJSX: TSESTree.JSXElement | TSESTree.JSXFragment | null;
    filePath: string;
}
export interface ReExportInfo {
    sourcePath: string;
    resolvedPath: string | null;
    specifiers: ReExportSpecifier[];
    isWildcard: boolean;
}
export interface ReExportSpecifier {
    exportedName: string;
    localName: string;
}
export interface SpacingTokens {
    marginTop?: number;
    marginBottom?: number;
    marginLeft?: number;
    marginRight?: number;
    marginVertical?: number;
    marginHorizontal?: number;
    margin?: number;
    padding?: number;
    paddingTop?: number;
    paddingBottom?: number;
    paddingLeft?: number;
    paddingRight?: number;
    paddingVertical?: number;
    paddingHorizontal?: number;
    gap?: number;
    rowGap?: number;
    columnGap?: number;
}
export interface LayoutProperties {
    flexDirection?: 'row' | 'column';
    justifyContent?: string;
    alignItems?: string;
    flexWrap?: 'wrap' | 'nowrap';
    position?: 'relative' | 'absolute';
    top?: number;
    bottom?: number;
    left?: number;
    right?: number;
    width?: number | string;
    height?: number | string;
    minWidth?: number | string;
    minHeight?: number | string;
    maxWidth?: number | string;
    maxHeight?: number | string;
    flex?: number;
    zIndex?: number;
    fontSize?: number;
}
export interface LayoutNode {
    id: string;
    componentName: string;
    tagName: string;
    filePath: string;
    lineNumber: number;
    spacing: SpacingTokens;
    layout: LayoutProperties;
    isPrimitive: boolean;
    isCustomComponent: boolean;
    children: LayoutNode[];
    parentId: string | null;
    hasOnLayout: boolean;
    isListItem: boolean;
    pollutionScore: number;
    tokenDeviations: TokenDeviation[];
    isSlot: boolean;
    contextCalls: string[];
}
export interface TokenDeviation {
    property: string;
    value: number;
    suggestion: string;
}
/**
 * v1.1.0: Reports why analysis was truncated (partial results).
 * Added for performance guards — maxFiles, file size, timeout.
 */
export interface TruncationInfo {
    /** True if analysis did not complete fully */
    truncated: boolean;
    /** Number of files parsed before hitting the limit */
    filesParsed: number;
    /** Maximum files allowed */
    maxFiles: number;
    /** Number of files skipped due to size */
    filesSkippedSize: number;
    /** Number of components that could not be resolved */
    unresolvedComponents: number;
    /** True if analysis timed out */
    timedOut: boolean;
    /** Elapsed time in ms */
    elapsedMs: number;
}
export interface InferenceResult {
    gapOpportunities: GapOpportunity[];
    stylePollution: StylePollution[];
    marginStacking: MarginStacking[];
    listItemIssues: ListItemIssue[];
    tokenDeviations: TokenDeviation[];
    rhythmViolations: RhythmViolation[];
    proximityIssues: ProximityIssue[];
    /** v2.0.0: Contextual gap violations (replaces simple rhythm check) */
    contextualGapViolations: ContextualGapViolation[];
    /** v2.0.0: Boundary rule violations (last child marginBottom) */
    boundaryViolations: BoundaryViolation[];
    /** v2.0.0: Grouping suggestions from Rule of Three */
    groupingSuggestions: GroupingSuggestion[];
    /** v2.3.0: Terminal padding violations (last child redundant padding) */
    terminalPaddingViolations: TerminalPaddingViolation[];
    /** v2.4.0: Dimension inconsistencies (same-type siblings with mismatched dimensions) */
    dimensionInconsistencies: DimensionInconsistency[];
    /** v2.4.0: Section merge suggestions (unary section adjacent to multi section) */
    sectionMergeSuggestions: SectionMergeSuggestion[];
    /** v2.5.0: Proportional incoherences (child fontSize vs parent height ratio) */
    proportionalIncoherences: ProportionalIncoherence[];
    /** v2.5.0: Opaque dimensions (string/percentage width/height that bypass static analysis) */
    opaqueDimensions: OpaqueDimension[];
    healthScore: number;
    /** v1.1.0: Truncation info for partial analysis */
    truncation?: TruncationInfo;
}
export interface GapOpportunity {
    node: LayoutNode;
    severity: 'high' | 'medium' | 'low';
    description: string;
    suggestion: string;
}
export interface StylePollution {
    node: LayoutNode;
    severity: 'high' | 'medium';
    description: string;
    suggestion: string;
}
export interface MarginStacking {
    parent: LayoutNode;
    child: LayoutNode;
    totalSpacing: number;
    severity: 'medium' | 'low';
}
export interface ListItemIssue {
    node: LayoutNode;
    severity: 'medium';
    description: string;
    suggestion: string;
}
export interface RhythmViolation {
    parent: LayoutNode;
    child: LayoutNode;
    parentGap: number;
    childGap: number;
    severity: 'high' | 'medium';
    description: string;
    suggestion: string;
}
/**
 * v2.0.0: A contextual gap violation replaces the simpler RhythmViolation.
 * It validates gaps based on the Proximity Score between siblings:
 *   - Intra-Section (Score > 6): Target gap = 8px, flag if > 8px
 *   - Inter-Section (Score < 4 OR Divider): Target gap = 16px, flag if < 16px
 */
export interface ContextualGapViolation {
    container: LayoutNode;
    childA: LayoutNode;
    childB: LayoutNode;
    actualGap: number;
    targetGap: number;
    proximityScore: number;
    violationType: 'loose-rhythm' | 'section-collision';
    severity: 'high' | 'medium';
    description: string;
    suggestion: string;
}
/**
 * v2.0.0: Boundary Rule violation — last child of a container
 * should have zero marginBottom (rely on container paddingBottom).
 */
export interface BoundaryViolation {
    container: LayoutNode;
    lastChild: LayoutNode;
    marginProperty: string;
    marginValue: number;
    severity: 'medium';
    description: string;
    suggestion: string;
}
export interface ProximityIssue {
    container: LayoutNode;
    siblings: LayoutNode[];
    sharedPrefix: string;
    severity: 'medium' | 'low';
    description: string;
    suggestion: string;
}
/**
 * v2.0.0: A grouping suggestion from the Rule of Three.
 * Triggered when 3+ consecutive siblings have high proximity scores
 * but no shared parent wrapper.
 */
export interface GroupingSuggestion {
    container: LayoutNode;
    siblings: LayoutNode[];
    averageScore: number;
    severity: 'medium' | 'low';
    description: string;
    suggestion: string;
}
/**
 * v2.4.0: A dimension inconsistency occurs when same-type siblings
 * have different width or height values. This flags components that
 * should be visually consistent but have mismatched dimensions.
 *
 * Example: Two <Card> siblings where one has height: 200 and the
 * other has height: 180 — they should match for visual consistency.
 */
export interface DimensionInconsistency {
    container: LayoutNode;
    siblings: LayoutNode[];
    property: 'width' | 'height';
    values: number[];
    outlierIndex: number;
    majorityValue: number;
    severity: 'medium' | 'low';
    description: string;
    suggestion: string;
}
/**
 * v2.4.0: A section merge suggestion occurs when a "Unary Section"
 * (a container with a single custom child) sits adjacent to a
 * "Multi Section" (a container with multiple children) and they
 * have high proximity (> 6). This suggests the unary section's
 * child should be merged into the multi section.
 *
 * Example:
 *   <ProfileSection>          <-- Multi Section (3 children)
 *     <Avatar />
 *     <Name />
 *     <Bio />
 *   </ProfileSection>
 *   <ProfileEditButton>       <-- Unary Section (1 child)
 *     <EditButton />
 *   </ProfileEditButton>
 *   → Merge EditButton into ProfileSection
 */
export interface SectionMergeSuggestion {
    unarySection: LayoutNode;
    multiSection: LayoutNode;
    childToMerge: LayoutNode;
    proximityScore: number;
    severity: 'medium' | 'low';
    description: string;
    suggestion: string;
}
/**
 * v2.3.0: A terminal padding violation occurs when the last child of a container
 * defines its own paddingBottom or marginBottom while the container already has
 * a gap or padding. This creates "Ghost Margin" layout pollution — redundant
 * boundary spacing that should be handled by the container alone.
 */
export interface TerminalPaddingViolation {
    container: LayoutNode;
    child: LayoutNode;
    property: string;
    value: number;
    severity: 'medium';
    description: string;
    suggestion: string;
}
/**
 * v2.5.0: A proportional incoherence occurs when a child's fontSize
 * is disproportionately small compared to its parent's height.
 * This detects elements where text is visually "lost" inside a large
 * container (e.g., tiny text inside a tall button).
 *
 * Threshold: fontSize < 15% of parent height.
 * Only checks when both values are numeric (no coordinate calculation).
 */
export interface ProportionalIncoherence {
    parent: LayoutNode;
    child: LayoutNode;
    parentHeight: number;
    childFontSize: number;
    ratio: number;
    severity: 'medium' | 'low';
    description: string;
    suggestion: string;
}
/**
 * v2.5.0: An opaque dimension occurs when width or height is set
 * as a string/percentage value (e.g., '100%') instead of a numeric
 * pixel value. These values bypass static dimension consistency
 * checks and create blind spots in sibling dimension auditing.
 *
 * Particularly problematic inside flexWrap: 'wrap' containers where
 * percentage widths create unpredictable wrapping behavior.
 */
export interface OpaqueDimension {
    node: LayoutNode;
    property: 'width' | 'height';
    value: string;
    containerHasFlexWrap: boolean;
    severity: 'low';
    description: string;
    suggestion: string;
}
export interface ResolvedComponent {
    name: string;
    returnJSX: TSESTree.JSXElement | TSESTree.JSXFragment | null;
    filePath: string;
    /** The AST node of the component function/arrow — used for enhanced slot detection */
    node?: TSESTree.FunctionDeclaration | TSESTree.ArrowFunctionExpression | TSESTree.FunctionExpression;
}
export interface ExtractedStyles {
    spacing: SpacingTokens;
    layout: LayoutProperties;
}
//# sourceMappingURL=types.d.ts.map