import { type Dialect } from './dialects.js';
/** The native id for a dialect-parsed id: verbatim when already grammar-legal, else a hyphen
 *  inserted before the first digit run (`KQ3` -> `KQ-3`, `B3x` -> `B-3x`), else null (nothing
 *  the grammar could hold — the caller fails the whole file closed rather than inventing ids). */
export declare function nativeIdFor(id: string): string | null;
export interface MaterializedIssuePlan {
    nativeId: string;
    sourceId: string;
    status: string;
    statusExplicit: boolean;
    title: string;
}
export interface MaterializedLens {
    /** The rewritten file text (LF). */
    after: string;
    /** Only the ids that CHANGED: old file-native spelling -> new grammar-legal id. */
    aliases: Record<string, string>;
    issues: MaterializedIssuePlan[];
}
/** Materialize one lens file's text. Throws (nothing partial, caller skips the file) when the
 *  lens sees no issues, an id can't be made grammar-legal, or two ids normalize to a collision. */
export declare function materializeDialectText(text: string, dialect: Dialect): MaterializedLens;