import type { DocHeading, ParsedMarkdownDocument } from "./types.js";
/**
 * Create a stable slug for a Markdown heading.
 *
 * @param text - Heading text to normalize.
 * @returns Lowercase slug suitable for chunk ids and outline references.
 *
 * @example
 * ```typescript
 * slugifyHeading("Install Guide") // "install-guide"
 * ```
 */
export declare function slugifyHeading(text: string): string;
/**
 * Extract Markdown headings in source order using a minimal heading parser.
 *
 * @param markdown - Markdown body content without frontmatter.
 * @param lineOffset - Number of frontmatter lines before the body starts.
 * @returns Heading outline with one-based source line numbers.
 */
export declare function extractMarkdownOutline(markdown: string, lineOffset?: number): DocHeading[];
/**
 * Parse a Markdown document into lightweight intelligence metadata.
 *
 * @param relativePath - Project-root-relative POSIX document path.
 * @param content - Raw Markdown content.
 * @returns Parsed document metadata including frontmatter and heading outline.
 *
 * @example
 * ```typescript
 * const doc = parseMarkdownDocument("docs/guide.md", "# Guide")
 * console.log(doc.outline[0]?.text) // "Guide"
 * ```
 */
export declare function parseMarkdownDocument(relativePath: string, content: string): ParsedMarkdownDocument;
/**
 * Parse JSON content: extract title from "title" key, return flat metadata.
 *
 * @param relativePath - Project-root-relative POSIX document path.
 * @param content - Raw JSON content.
 * @returns Parsed document metadata (outline will be empty).
 */
export declare function parseJsonDocument(relativePath: string, content: string): ParsedMarkdownDocument;
/**
 * Parse YAML content: extract title from "title" key, return flat metadata.
 *
 * @param relativePath - Project-root-relative POSIX document path.
 * @param content - Raw YAML content.
 * @returns Parsed document metadata (outline will be empty).
 */
export declare function parseYamlDocument(relativePath: string, content: string): ParsedMarkdownDocument;
/**
 * Parse XML content: extract title from <title> element, return minimal metadata.
 *
 * @param relativePath - Project-root-relative POSIX document path.
 * @param content - Raw XML content.
 * @returns Parsed document metadata (outline will be empty).
 */
export declare function parseXmlDocument(relativePath: string, content: string): ParsedMarkdownDocument;
/**
 * Parse plain text: extract title from first line, minimal metadata.
 *
 * @param relativePath - Project-root-relative POSIX document path.
 * @param content - Raw text content.
 * @returns Parsed document metadata (outline will be empty).
 */
export declare function parsePlainTextDocument(relativePath: string, content: string): ParsedMarkdownDocument;
/**
 * Parse a document based on its file extension.
 * Returns a uniform `ParsedMarkdownDocument`-shaped result.
 *
 * @param relativePath - Project-root-relative POSIX path.
 * @param content - Raw file content.
 * @returns Parsed document metadata.
 */
export declare function parseDocument(relativePath: string, content: string): ParsedMarkdownDocument;
//# sourceMappingURL=parser.d.ts.map