/**
 * ブラウザ安全な生成サイドカーの型と純粋関数。
 * fs / crypto を使う読み取りは './generation-meta-node' を明示的に import すること
 * （ここへ Node 専用依存を戻すと browser バンドルに node builtins が混入するため分離している）。
 */
export type GenerationState = 'none' | 'planned' | 'generating' | 'stale' | 'done' | 'failed' | 'orphan';
export declare const GENERATION_META_KINDS: readonly ["still", "video", "frames", "audio"];
export declare function isGenerationMetaKind(kind: unknown): kind is GenerationMetaV1['kind'];
export interface GenerationFrameReference {
    sha256?: string;
    path?: string;
    source_id?: string | null;
}
export interface GenerationNextDraft {
    kind: 'video';
    status: 'planned';
    model: {
        id: string;
    };
    inputs: {
        first_frame?: GenerationFrameReference | null;
        last_frame?: GenerationFrameReference | null;
        prompt?: string;
        frames_or_refs?: 'frames' | 'references';
        [key: string]: unknown;
    };
    output: {
        duration_s: number;
        [key: string]: unknown;
    };
    updated_at: string;
}
export interface GenerationMetaV1 {
    version: 1;
    kind: (typeof GENERATION_META_KINDS)[number];
    status: 'planned' | 'generating' | 'done' | 'failed';
    next?: GenerationNextDraft;
    placeholder?: {
        path: string;
        sha256: string;
        item_id: string;
    };
    inputs?: {
        first_frame?: {
            sha256?: string;
            path?: string;
            source_id?: string | null;
        } | null;
        [key: string]: unknown;
    };
    job?: {
        started_at?: string;
        stale_after_s?: number;
        [key: string]: unknown;
    };
    result?: {
        sha256?: string;
        [key: string]: unknown;
    };
    [key: string]: unknown;
}
export interface GenerationBinding {
    expectedSha256: string;
    actualSha256: string | null;
    matches: boolean;
    source: 'result' | 'placeholder' | 'first_frame';
}
export interface ReadGenerationMetaResult {
    state: GenerationState;
    meta: GenerationMetaV1 | null;
    sidecarPath: string;
    binding: GenerationBinding | null;
}
export declare function sidecarPathFor(sourcePath: string): string;
export declare function bindingShaFor(meta: GenerationMetaV1 | null | undefined): {
    sha256: string;
    source: 'result' | 'placeholder' | 'first_frame';
} | null;
/**
 * fs に触れず、サイドカー自身が表す状態だけを解決する。
 * `job.stale_after_s` が未指定・不正な場合は既定 900 秒を使う。
 */
export declare function resolveGenerationState(meta: GenerationMetaV1 | null | undefined, now: Date | string | number): GenerationState;
/**
 * item が現在指している素材へ、生成物側の video サイドカーを逆引きする。
 * 選択だけを行い、各 surface 固有の orphan / 契約外 status の解決は呼び出し側へ残す。
 */
export declare function selectGenerationSidecarForSource<T extends {
    sourcePath: string;
    meta?: GenerationMetaV1 | null;
    binding?: {
        matches?: boolean;
    } | null;
}>(sourcePath: string | undefined, entries: readonly T[], now: Date | string | number): T | undefined;
/** 動画予定の入力を、描画と右パネルで共用する種類へまとめる。 */
export declare function describeNextDraft(meta: GenerationMetaV1 | null | undefined): {
    variety: 'prompt' | 'first' | 'first-last' | 'references';
    firstFrame: GenerationFrameReference | null;
    lastFrame: GenerationFrameReference | null;
    prompt: string;
    modelId: string;
} | null;