/**
 * --------------------------------------------------------------------
 * docmd : the zero-config documentation engine.
 *
 * @package     @docmd/utils
 * @website     https://docmd.io
 * @repository  https://github.com/docmd-io/docmd
 * @license     MIT
 * @copyright   Copyright (c) 2025-present docmd.io
 *
 * [docmd-source] - Please do not remove this header.
 * --------------------------------------------------------------------
 */
/**
 * Formats a title separator string.
 * Trims surrounding whitespace and, if non-empty, wraps with a single space on each side.
 * E.g. "-" -> " - ", "|" -> " | ", " · " -> " · ", "" -> ""
 */
export declare function formatTitleSeparator(rawSeparator?: string): string;
/**
 * Resolves the titleAppend boolean setting with hierarchy:
 * 1. frontmatter.titleAppend
 * 2. frontmatter.seo?.titleAppend
 * 3. config.layout?.titleAppend
 * 4. config.plugins?.seo?.titleAppend
 * 5. config.seo?.titleAppend
 * 6. config.titleAppend (root fallback)
 * Default: true
 */
export declare function resolveTitleAppend(config?: any, frontmatter?: any): boolean;
/**
 * Resolves the titleSeparator string setting with hierarchy:
 * 1. frontmatter.titleSeparator
 * 2. frontmatter.seo?.titleSeparator
 * 3. config.layout?.titleSeparator
 * 4. config.plugins?.seo?.titleSeparator
 * 5. config.seo?.titleSeparator
 * 6. config.titleSeparator (root fallback)
 * Default: "-" (formatted to " - ")
 */
export declare function resolveTitleSeparator(config?: any, frontmatter?: any): string;
/**
 * Resolves the canonical full document title for <title> and social meta tags.
 */
export declare function resolveTitle(pageTitle: string | undefined, siteTitle: string | undefined, config?: any, frontmatter?: any): string;