/**
 * Core types for hayagriva-llm metadata generation.
 * Extensible for AI/adapters: extra fields are preserved.
 */
export type ExportKind = 'function' | 'class' | 'type';
/** Core export fields; AI/adapters may add more (params, returns, sideEffect, etc.). */
export interface ExportMeta {
    type: ExportKind;
    description: string;
    hook: boolean;
    /** Optional: for IDE/search (e.g. param names, signature). */
    params?: string;
    /** Optional: return type or one-liner. */
    returns?: string;
    /** Optional: true if has side effects (IO, mutates state). */
    sideEffect?: boolean;
    /** Optional: example usage or snippet. */
    example?: string;
    [key: string]: unknown;
}
export interface ExportsMap {
    [name: string]: ExportMeta;
}
/** Extended metadata for IDE/indexing and crawlers (Cursor, Antigravity, etc.). */
export interface LLMPackageJson {
    name: string;
    version: string;
    description: string;
    /** One-paragraph summary for search/context (AI mode). */
    summary?: string;
    /** Side effects at package level (e.g. "patches globals", "reads env"). */
    sideEffects?: string[];
    /** Search/keyword hints. */
    keywords?: string[];
    /** When to use this package (one paragraph; AI mode). */
    whenToUse?: string;
    /** Reasons to use (bullet-style; AI mode). */
    reasonToUse?: string[];
    /** Concrete use cases / scenarios (AI mode). */
    useCases?: string[];
    /** Documentation URL or short note (AI mode). */
    documentation?: string;
    /** Related packages (AI mode). */
    relatedPackages?: string[];
    /** Optional extensibility container for additional crawler/IDE metadata (AI mode). */
    extensions?: Record<string, unknown>;
    exports: ExportsMap;
    hooks: string[];
    frameworks: string[];
    generatedBy: string;
    mode: 'static' | 'ai';
    /** Preserve any extra fields from AI/adapters so structure doesn't break. */
    [key: string]: unknown;
}
export interface PackageJsonLike {
    name?: string;
    version?: string;
    description?: string;
    main?: string;
    module?: string;
    source?: string;
    [key: string]: unknown;
}
export interface GenerateOptions {
    mode: 'static' | 'ai';
    apiKey?: string;
    model: string;
    includeSrc: boolean;
    verbose: boolean;
    /** If true, also write a Cursor rule .mdc file to .cursor/rules/ */
    generateRule?: boolean;
    /**
     * Use [Free LLM Router](https://freellmrouter.com/docs) to pick ranked free OpenRouter models.
     * Requires FREE_LLM_ROUTER_API_KEY; chat requests still use OpenRouter with OPEN_ROUTER_API_KEY.
     */
    freeLlmRouter?: boolean;
}
/** AI response: only exports required; rest optional and extensible. */
export interface AIRawResponse {
    exports: Record<string, ExportMeta>;
    hooks?: string[];
    frameworks?: string[];
    summary?: string;
    sideEffects?: string[];
    keywords?: string[];
    whenToUse?: string;
    reasonToUse?: string[];
    useCases?: string[];
    documentation?: string;
    relatedPackages?: string[];
    extensions?: Record<string, unknown>;
    /** Optional: token usage from provider (for observability only). */
    usage?: {
        prompt_tokens: number;
        completion_tokens: number;
        total_tokens: number;
    };
    /** Optional: size of input (chars) for observability. */
    inputChars?: number;
    /** Optional: batching details for observability. */
    batches?: {
        size: number;
        batchCount: number;
    };
    [key: string]: unknown;
}
export declare const DEFAULT_MODEL = "openai/gpt-4o-mini";
//# sourceMappingURL=types.d.ts.map