import { Option } from '@webpieces/rules-config';
/**
 * Framework-owned `// webpieces-disable` escape hatch for a rule, gated by the team's
 * `disableAllowed` config (default true). `comment` is the exact suppress syntax to show
 * (usually `// webpieces-disable <rule> -- <reason>`; max-file-lines uses the eslint form).
 * When `allowed` is false the framework prints a "must be followed" line instead of the escape.
 */
export declare class DisableEscape {
    readonly allowed: boolean;
    readonly comment: string;
    constructor(allowed: boolean, comment: string);
}
/**
 * Structured fix guidance shown under a violation in a blocked-write / blocked-bash report.
 *
 * A rule authors its user-facing text once here: a required `violation` (the "what's wrong"
 * line — the rule-level default for the `→` line; a dynamic per-occurrence `Violation.message`
 * overrides it), a `mainMessage` (fix prose, or a lead-in to the options), an optional list of
 * genuinely distinct `fixOptions`, and — for the disable-able code-style rules — a framework-
 * owned `escape`.
 *
 * The framework (report.ts / `formatFixOptions`) — not the rule author — owns the "Fix Option N:"
 * numbering, the "(preferred)" tag, and the escape/`disableAllowed` rendering. So a multi-line
 * message can never be mis-split into fake options, and authors never hand-write those labels.
 *
 * `Option` is NOT defined here: it lives in `@webpieces/rules-config` (`fix-option.ts`) because
 * `RuleFailError` — thrown by BOTH engines — carries the same class. One cure shape, one definition,
 * one import path. Import it from `@webpieces/rules-config`, never from this module.
 */
export declare class FixHint {
    /** Required: the "what's wrong" line (rule-level default for the `→` line). */
    readonly violation: string;
    /** Required (may be ''): fix prose, or a lead-in to the options. Multi-line ok. */
    readonly mainMessage: string;
    /** Real fixes only — NEVER the disable escape (that is `escape`). */
    readonly fixOptions: readonly Option[];
    /** Present only for disable-able rules; absent for guards. */
    readonly escape?: DisableEscape;
    constructor(violation: string, mainMessage: string, fixOptions?: readonly Option[], escape?: DisableEscape);
}