import type { PygmalionEndpoints } from './paths.js';
import type { ComponentBranchesRequest, InspectImpactRequest, MirrorRefreshRequest, PreviewCatalogRequest, PygmalionDesignSessionStatus, PygmalionDevMirrorStatus, PygmalionSourceRefs, QaCaptureEnvelope, SessionApplyVisualRequest, SessionApplyVisualResponse, SessionCheckRequest, SessionOpenRequest, SessionPreviewVisualRequest, SessionPreviewVisualResponse, SessionRevertVisualRequest, SessionRevertVisualResponse, SessionRestoreVisualRequest, SessionHistoryResponse, PygmalionHistoryResult, SourceUsageRequest } from './types.js';
import type { InspectImpactResult } from '../editor/host.js';
import type { InspectQaCaptureRequest } from '../editor/visualQa.js';
import type { PreviewArtifactTransportRequest } from '../editor/previewBootstrap.js';
import type { ComponentBranch } from '../editor/screenDimensions.js';
import type { CompositionSourceUsage } from '../editor/storyboardComposition.js';
export interface TransportCallOptions {
    signal?: AbortSignal;
}
/** The subset of RequestInit a transport sends; a real `fetch` accepts it as is. */
export interface TransportRequestInit {
    method: 'GET' | 'POST';
    headers: Record<string, string>;
    body?: string;
    cache?: 'no-store';
    credentials?: 'same-origin';
    signal?: AbortSignal;
}
/** The subset of Response a transport reads; a real Response satisfies it, and so does a test fake. */
export interface TransportResponse {
    readonly ok: boolean;
    readonly status?: number;
    readonly statusText?: string;
    json(): Promise<unknown>;
}
export type TransportFetch = (input: string, init: TransportRequestInit) => Promise<TransportResponse>;
export interface EditorTransport {
    /** The paths this transport talks on, after overrides. */
    readonly endpoints: PygmalionEndpoints;
    /** Turns a server-relative path (a QA PNG, an artifact asset) into a URL the document can load. */
    resolveUrl(path: string): string;
    readonly mirror: {
        status(options?: TransportCallOptions): Promise<PygmalionDevMirrorStatus>;
        refresh(request?: MirrorRefreshRequest, options?: TransportCallOptions): Promise<PygmalionDevMirrorStatus>;
        refs(options?: TransportCallOptions): Promise<PygmalionSourceRefs>;
    };
    readonly session: {
        open(request: SessionOpenRequest, options?: TransportCallOptions): Promise<PygmalionDesignSessionStatus>;
        check(request: SessionCheckRequest, options?: TransportCallOptions): Promise<PygmalionDesignSessionStatus>;
        previewVisual(request: SessionPreviewVisualRequest, options?: TransportCallOptions): Promise<SessionPreviewVisualResponse>;
        applyVisual(request: SessionApplyVisualRequest, options?: TransportCallOptions): Promise<SessionApplyVisualResponse>;
        revertVisual(request: SessionRevertVisualRequest, options?: TransportCallOptions): Promise<SessionRevertVisualResponse>;
        redoVisual(request: SessionRevertVisualRequest, options?: TransportCallOptions): Promise<PygmalionHistoryResult>;
        restoreVisual(request: SessionRestoreVisualRequest, options?: TransportCallOptions): Promise<PygmalionHistoryResult>;
        history(request: SessionCheckRequest, options?: TransportCallOptions): Promise<SessionHistoryResponse>;
    };
    readonly inspect: {
        impact(request: InspectImpactRequest, options?: TransportCallOptions): Promise<InspectImpactResult>;
    };
    readonly qa: {
        capture(request: InspectQaCaptureRequest, options?: TransportCallOptions): Promise<QaCaptureEnvelope>;
    };
    readonly preview: {
        /**
         * Probes or captures preview artifacts. Answers with the bundle, the
         * unwrapped `{ok, artifact}` bundle, or a frame resolution envelope, as
         * the server does; previewBootstrap.ts validates whichever arrives.
         */
        artifact(request: PreviewArtifactTransportRequest): Promise<unknown>;
        /** The raw `progress` value; previewCaptureProgress.ts normalizes it. */
        progress(options?: TransportCallOptions): Promise<unknown>;
        /** The unvalidated catalog (unwrapped from `{catalog}`); revisionCatalog.ts validates it. */
        catalog(request: PreviewCatalogRequest, options?: TransportCallOptions): Promise<unknown>;
    };
    readonly storyboard: {
        /** The raw manifest; storyboardDiscovery.ts validates it. */
        environment(options?: TransportCallOptions & {
            sourceRevision?: string;
        }): Promise<unknown>;
        sourceUsage(request: SourceUsageRequest, options?: TransportCallOptions): Promise<Record<string, CompositionSourceUsage>>;
        componentBranches(request: ComponentBranchesRequest, options?: TransportCallOptions): Promise<readonly ComponentBranch[]>;
    };
}