/**
 * pi-doc — API documentation generator for pi.dev extensions.
 *
 * Three tools:
 *   doc_generate  — Parse TypeBox schemas from extension source and generate Markdown/HTML docs
 *   doc_serve     — Serve generated docs locally via a simple HTTP server
 *   doc_validate  — Check documentation coverage against registered tools
 */
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
export interface ToolInfo {
    name: string;
    description: string;
    parameters: Record<string, PropertyInfo>;
    required: string[];
}
export interface PropertyInfo {
    type: string;
    description: string;
    required: boolean;
    default?: string;
    enum?: string[];
    minimum?: number;
    maximum?: number;
}
export interface ParsedExtension {
    name: string;
    description: string;
    tools: ToolInfo[];
}
/**
 * Parse TypeScript source files to extract tool registrations and TypeBox schemas.
 */
export declare function parseExtensionSources(sourceDir: string): ParsedExtension;
/**
 * Generate Markdown documentation from parsed extension info.
 */
export declare function generateMarkdown(ext: ParsedExtension): string;
/**
 * Generate HTML documentation from parsed extension info.
 */
export declare function generateHTML(ext: ParsedExtension): string;
interface CoverageReport {
    totalTools: number;
    documentedTools: number;
    coverage: number;
    meetsMinCoverage: boolean;
    minCoverage: number;
    undocumented: string[];
    details: Array<{
        tool: string;
        hasDescription: boolean;
        documentedParams: number;
        totalParams: number;
    }>;
}
/**
 * Validate documentation coverage for an extension.
 */
export declare function validateCoverage(ext: ParsedExtension, minCoverage: number): CoverageReport;
export default function register(pi: ExtensionAPI): void;
export {};
//# sourceMappingURL=index.d.ts.map