import type { BuildPageTitleOptions, BuildPageTitleResult } from './types.js';
/**
 * Builds a branded HTML `<title>` value with optional truncation.
 *
 * The output is normalized for whitespace and returns warning codes aligned
 * with snippet title thresholds.
 *
 * @param options - Page title composition options.
 * @returns Final title string, character count, and warning codes.
 *
 * @example
 * buildPageTitle({
 *   pageTitle: 'Project Brief Template',
 *   brand: 'Acme Agency',
 *   separator: ' | ',
 *   brandPosition: 'suffix',
 *   maxLength: 60,
 * });
 */
export declare const buildPageTitle: ({ pageTitle, brand, separator, brandPosition, maxLength, }: BuildPageTitleOptions) => BuildPageTitleResult;