import type { Scene } from "../parsers/scene-extractor.js";
/** Aggregated profile for a single character across the entire screenplay. */
export interface CharacterProfile {
    /** Canonical uppercase character name (e.g. "MARCUS"). */
    name: string;
    /** Every line of action or dialogue text that mentions this character. */
    mentions: string[];
    /** Extracted physical-description fragments found in action lines. */
    physicalDescriptions: string[];
    /** 1-based scene numbers in which the character appears. */
    scenesPresent: number[];
    /** Total number of dialogue lines attributed to this character. */
    dialogueCount: number;
}
/**
 * Extract character profiles from an array of parsed scenes.
 *
 * The function iterates every scene and inspects both dialogue attributions
 * and action/description text to build a comprehensive profile for each
 * unique character. Profiles are sorted by `dialogueCount` descending so
 * that principal characters appear first.
 *
 * @param scenes - Array of `Scene` objects produced by the scene parser.
 * @returns Deduplicated, sorted array of `CharacterProfile` entries.
 */
export declare function extractCharacterProfiles(scenes: Scene[]): CharacterProfile[];
//# sourceMappingURL=extractor.d.ts.map