/**
 * v0.8.4 §10 — Deprecation warning helper.
 *
 * Used to surface "this flag/command is going away" notices to users without
 * breaking existing scripts. Writes to stderr so stdout pipelines stay clean.
 *
 * Silenceable via `SOLOSQUAD_NO_DEPRECATION_WARN=1` (CI/script noise control).
 *
 * Per `docs/plan/v0.8.4-cli-surface-reduction.md` §10:
 * - v0.8.4: alias still works, but emits a deprecation warning.
 * - v1.0: alias removed entirely (matches `docs/policy/schema-stability.md` §4 —
 *   "removing a flag is major").
 */
export declare function warnDeprecated(args: {
    oldName: string;
    newName: string;
    removalVersion?: string;
    hint?: string;
}): void;
export declare function warnDeprecatedOnce(args: Parameters<typeof warnDeprecated>[0]): void;