/**
 * v0/v1 -> v2 凍結変換ユニット。
 *
 * 変換器は機能追加禁止・バグ修正のみ。未知ケースは「このプロジェクトは
 * 変換できません」と正直に止まる。将来 `akari-migrate` へそのまま切り出すため、
 * ファイル変換の意味論はこの 1 ファイルに閉じる。
 */
import type { EditV2 } from '../edit-v2';
import { type DimensionsOf, type GeometryChange } from './geometry';
export { LegacyEditVersionError } from './error';
export { parseEdit } from './legacy-parse';
export type { EditParseOrigins } from './legacy-parse';
export { collectFitBasisCandidates, GEOMETRY_SOURCE, hasCutLayerStyleVisual, normalizeGeometry, round6 } from './geometry';
export type { DimensionsOf, FitBasisCandidate, GeometryChange, GeometryNormalizationResult, MediaDimensions } from './geometry';
export type LegacyVersion = 0 | 1;
export interface MigrateChange {
    path: string;
    note: string;
}
export type MigrateResult = {
    ok: true;
    version: LegacyVersion;
    doc: EditV2;
    changes: MigrateChange[];
    warnings: string[];
} | {
    ok: false;
    version: number;
    blockers: string[];
};
export interface MigrationProposal {
    filePath: string;
    version: LegacyVersion;
    changes: MigrateChange[];
    warnings: string[];
    nextText: string;
    previousText: string;
    backupPath: string;
    /** version の無い、キー 0 個の edit.json を初期化する提案。 */
    emptyProject?: true;
    captions?: {
        filePath: string;
        nextText: string;
        previousText: string;
        backupPath: string;
    };
}
export interface V2NormalizationProposal {
    filePath: string;
    version: 2;
    changes: MigrateChange[];
    warnings: string[];
    nextText: string;
    previousText: string;
    backupPath: string;
    captions?: {
        filePath: string;
        nextText: string;
        previousText: string;
        backupPath: string;
    };
    motion?: Array<{
        filePath: string;
        nextText: string;
        previousText: string;
        backupPath: string;
    }>;
}
export interface MigrationNoop extends V2NormalizationProposal {
    ok: true;
    noop: true;
    version: 2;
}
/** 幾何の統一 G1 の提案。`changes` は表示用の要約、`geometry` は焼き込みの実測値。 */
export interface GeometryNormalizationProposal extends V2NormalizationProposal {
    geometry: GeometryChange[];
}
export interface GeometryNormalizationNoop extends MigrationNoop {
    geometry: GeometryChange[];
}
export interface MigrationBlocked {
    ok: false;
    version: number;
    blockers: string[];
}
export declare function detectEditVersion(raw: unknown): number | undefined;
/** captions.json / legacy captions[] に描画対象の cue が 1 件以上あるかを判定する。 */
export declare function captionsHaveRenderableCues(root: unknown): boolean;
export declare function migrateEditToV2(raw: unknown, options?: {
    hasCaptions?: boolean;
}): MigrateResult;
export declare function planMigration(projectRoot: string, editPath: string, text: string, options?: {
    hasCaptions?: boolean;
    now?: Date;
}): MigrationProposal | MigrationBlocked;
/** 承認後のみ実行する。先に全原文を .akari/backup/ へ退避し、次に atomic rename する。 */
export declare function applyMigration(proposal: MigrationProposal | V2NormalizationProposal): Promise<void>;
/** 退避した原文を 1 手で edit.json / captions.json へ戻す。backup 自体は監査記録として残す。 */
export declare function revertMigration(proposal: MigrationProposal | V2NormalizationProposal): Promise<void>;
export declare function planV2Normalization(projectRoot: string, editPath: string, previousText: string, options?: {
    now?: Date;
}): V2NormalizationProposal | MigrationBlocked | MigrationNoop;
/**
 * 幾何の統一 G1: `scale × fit` の一度きりの焼き込みと `output.geometry: "source"` の付与を
 * `planV2Normalization` と同じ形（backup パス付き提案・`applyMigration` / `revertMigration` で扱える）
 * で提案する。素材の寸法は呼び出し側が `dimensionsOf` で渡す（I/O はこの層に持ち込まない）。
 */
export declare function planGeometryNormalization(projectRoot: string, editPath: string, previousText: string, options: {
    dimensionsOf: DimensionsOf;
    now?: Date;
}): GeometryNormalizationProposal | MigrationBlocked | GeometryNormalizationNoop;