import type { DocumentArea } from '../types/index.js';
/**
 * Resolves the docs directory path.
 * Tries environment variable first, then uses a persistent location in user's home directory.
 * This ensures docs persist across npm/npx package updates.
 */
export declare function resolveDocsPath(): string;
/**
 * Resolves cache directory path.
 * Default is in the user's home directory to persist across npm installs.
 */
export declare function resolveCacheDir(): string;
/**
 * Normalizes a file path (removes trailing slashes, normalizes separators)
 */
export declare function normalizePath(path: string): string;
/**
 * Resolves a relative link from a source file to an absolute path.
 *
 * @param sourcePath - Absolute path of the source file containing the link
 * @param linkHref - The href from the markdown link
 * @returns Absolute path to the linked file
 */
export declare function resolveRelativeLink(sourcePath: string, linkHref: string): string;
/**
 * Checks if a link is external (http://, https://, etc.)
 */
export declare function isExternalLink(href: string): boolean;
/**
 * Extracts the document area from a file path.
 * For the unified BTP documentation, always returns 'btp'.
 *
 * @returns The document area (always 'btp')
 */
export declare function getDocumentArea(_filePath: string): DocumentArea;
/**
 * Converts an absolute path to a path relative to the docs directory.
 */
export declare function getRelativePath(absolutePath: string, docsPath: string): string;
/**
 * Converts a relative path (from docs directory) to an absolute path.
 */
export declare function getAbsolutePath(relativePath: string, docsPath: string): string;
/**
 * Gets the area-specific directory path.
 *
 * @param area - The document area
 * @param docsPath - Base docs directory path
 * @returns Absolute path to the area directory
 */
export declare function getAreaPath(area: DocumentArea, docsPath: string): string;
/**
 * Gets the index.md file path for a specific area.
 */
export declare function getIndexPath(_area: DocumentArea, docsPath: string): string;
/**
 * Checks if a file path belongs to a specific area.
 * For unified BTP documentation, always returns true for 'btp' area.
 */
export declare function isInArea(_filePath: string, area: DocumentArea): boolean;
/**
 * Gets all area paths that should be searched.
 * For unified BTP documentation, returns the base docs path.
 *
 * @param _area - The area filter (ignored for unified BTP docs)
 * @param docsPath - Base docs directory path
 * @returns Array containing the docs path
 */
export declare function getAreaPaths(_area: DocumentArea | 'all', docsPath: string): string[];
//# sourceMappingURL=paths.d.ts.map