/**
 * Shared pattern-label helper for user-facing headlines + summaries.
 *
 * BURNED RULE (memory: feedback_no_hash_in_user_headlines):
 *   Lead with pattern name + service + state, NOT raw symbol_message
 *   blobs (underscored token sequences like
 *   "terror_v_logger_go_failed_t_resource_service_instance_id_...").
 *
 * Math-lens workflows surfaced this defect in SIX separate tools across
 * this session (whats_changing, pattern_mitigate, top_patterns,
 * whats_new, pattern_detail, pattern_trend). Each tool had its own
 * formatHeadlineDescriptor-like function with the same shape, all
 * subtly different. Refactored to a single shared helper so the next
 * tool can't re-introduce the bug.
 *
 * The label format:
 *   - With service + severity: "<service> <SEVERITY> pattern (<hint>)"
 *   - With service only:       "<service> pattern (<hint>)"
 *   - With hint only:          "<hint>"
 *   - Fallback:                "pattern"
 *
 * <hint> is the symbol_message rendered for humans. When a per-env
 * document-frequency context (`df`) is supplied it is the discriminator-
 * first display_name (Layer 2, lib/pattern-df.ts); otherwise it is the
 * '_'->space name codepoint-safe mid-ellipsis'd to maxHintChars (Layer 1,
 * lib/text-crop.ts) — NOT a front-slice + "...", which drops the tail
 * discriminator and can bisect a surrogate pair. When the
 * symbol_message is empty, the hint is dropped and we render just the
 * service-led lead.
 *
 * Callers should keep the raw underscored symbol_message + pattern_hash
 * in the payload (machine fields) for round-trip and downstream tool
 * chaining; this helper is for prose only.
 */
import { type DfContext } from './pattern-df.js';
export interface PatternLabelInput {
    /** Raw symbol_message (underscored tokens) or descriptor. May be null/undefined. */
    symbol_message?: string | null;
    /** Top service name when available (from services[0].name or scope_service). */
    service?: string | null;
    /** Severity of the top service when available (ERROR, INFO, DEBUG, etc.). */
    severity?: string | null;
    /** Override the default 40-char hint cap. */
    maxHintChars?: number;
    /** Fallback string when no signal at all is available. */
    fallback?: string;
    /**
     * Optional shared per-env df-context. When present the hint is the
     * discriminator-first display_name (boilerplate dropped, tail surfaced);
     * when absent the hint degrades to a plain mid-ellipsis. Pass the SAME
     * context used by top_patterns so a pattern reads identically on both.
     */
    df?: DfContext | null;
}
export declare function formatPatternLabel(input: PatternLabelInput): string;
/**
 * Convenience wrapper that pulls service + severity from a typical
 * services[] array shape used across whats_changing, pattern_mitigate,
 * pattern_detail, etc.
 */
export declare function formatPatternLabelFromServices(input: {
    symbol_message?: string | null;
    services?: Array<{
        name?: string;
        service?: string;
        severity?: string;
    }>;
    maxHintChars?: number;
    fallback?: string;
    df?: DfContext | null;
}): string;