@auditcore/ui-core 0.3.0

package/dist/screening/types.d.ts

@@ -0,0 +1,295 @@
+export declare const CONTRACT = "auditcore_registry_sources.screening_review/1";
+export type ScreeningKind = 'sanctions' | 'pep';
+export type Outcome = 'confirmed' | 'dismissed' | 'deferred';
+export type ReviewStatus = 'open' | 'pending_second_review' | Outcome;
+export type SubjectStatus = 'HITS' | 'NO_HITS' | 'INCOMPLETE' | 'NOT_SEARCHED';
+export type FreshnessStatus = 'current' | 'stale' | 'unknown' | 'not_judged';
+export interface ActorView {
+    id: string;
+    display_name: string;
+}
+export interface SubjectInput {
+    subject_id: string;
+    name: string;
+    birth_date: string | null;
+    country: string | null;
+    schema: string | null;
+    reference: string | null;
+}
+export interface EntryView {
+    entry_id: string;
+    schema: string;
+    name: string;
+    aliases: string[];
+    aliases_total: number;
+    birth_date: string;
+    countries: string;
+    addresses: string;
+    identifiers: string;
+    sanctions: string;
+    program_ids: string;
+    first_seen: string;
+    last_seen: string;
+    dataset: string;
+}
+export interface BreakdownStep {
+    step: 'normalization' | 'base' | 'adjustment' | 'clamp' | 'result';
+    label: string;
+    value?: string;
+    detail?: string;
+    points?: number;
+    kind?: string;
+}
+export interface ScoreClass {
+    class: string;
+    label: string;
+    from: number;
+}
+export interface Breakdown {
+    method: string;
+    scale: {
+        min: number;
+        max: number;
+    };
+    steps: BreakdownStep[];
+    min_score: number;
+    classes: ScoreClass[];
+    class: string;
+    class_label: string;
+    consistent: boolean;
+}
+export interface DecisionView {
+    outcome: Outcome;
+    reason: string;
+    four_eyes: boolean;
+    four_eyes_source: 'policy' | 'requested' | null;
+    actor: ActorView;
+    at: string;
+    sequence: number;
+}
+export interface SecondReviewView {
+    approve: boolean;
+    reason: string;
+    actor: ActorView;
+    at: string;
+    sequence: number;
+}
+export interface ReviewView {
+    status: ReviewStatus;
+    status_label: string;
+    sequence: number;
+    decision: DecisionView | null;
+    second_review: SecondReviewView | null;
+    events: number;
+}
+export interface HitView {
+    hit_id: string;
+    subject_id: string;
+    list_key: string;
+    list_name: string;
+    source_key: string | null;
+    entry: EntryView;
+    matched_name: string;
+    matched_field: 'name' | 'alias';
+    raw_score: number;
+    score: number;
+    confidence: string;
+    dob_conflict: boolean;
+    country_conflict: boolean;
+    below_min_score: boolean;
+    indicators: string[];
+    breakdown: Breakdown;
+    review: ReviewView;
+}
+export interface FindingView {
+    list_key: string;
+    list_name: string;
+    source_key: string | null;
+    searched: boolean;
+    entry_count: number;
+    as_of: string | null;
+    retrieved_at: string | null;
+    hit_count: number;
+    note: string | null;
+}
+export interface SubjectView {
+    subject_id: string;
+    input: SubjectInput;
+    status: SubjectStatus;
+    normalized_query: string;
+    min_score: number;
+    findings: FindingView[];
+    hits: HitView[];
+    hits_before_filter: number;
+    total_hits: number;
+    truncated: boolean;
+    notice: string;
+    limitations: string[];
+}
+export interface FreshnessView {
+    status: FreshnessStatus;
+    label: string;
+    age_days: number | null;
+    stale_after_days: number | null;
+}
+export interface ListInfo {
+    key: string;
+    source_key: string | null;
+    name: string;
+    issuer: string;
+    url: string;
+    format: string;
+    provider: string;
+    licence_claimed_in_source: string | null;
+    data_licence: {
+        status?: string;
+        note?: string;
+    };
+}
+export interface SourceView {
+    list: ListInfo;
+    kind: ScreeningKind;
+    entry_count: number;
+    as_of: string | null;
+    retrieved_at: string | null;
+    content_sha256: string | null;
+    note: string | null;
+    searchable: boolean;
+    freshness: FreshnessView;
+}
+export interface ProfileView {
+    id: string;
+    version: string;
+    fingerprint: string;
+    status: string;
+    kind: ScreeningKind;
+    legal_status: string;
+    default_min_score: number;
+    scale: {
+        min: number;
+        max: number;
+    };
+    recommended: boolean;
+}
+export interface SettingsView {
+    contract: string;
+    profiles: ProfileView[];
+    four_eyes_outcomes: Outcome[];
+    stale_after_days: number | null;
+}
+export interface SourcesView {
+    contract: string;
+    checked_at: string;
+    sources: SourceView[];
+}
+export interface RunSummary {
+    run_id: string;
+    created_at: string;
+    created_by: ActorView;
+    kind: ScreeningKind;
+    case_reference: string | null;
+    profile: {
+        id: string;
+        version: string;
+        fingerprint: string;
+        status: string;
+    };
+    subject_count: number;
+    subjects_with_hits: number;
+    subjects_incomplete: number;
+    hit_count: number;
+    review_counts: Record<ReviewStatus, number>;
+    review_complete: boolean;
+    last_sequence: number;
+}
+export interface RunRequestRecord {
+    kind: ScreeningKind;
+    profile: RunSummary['profile'];
+    lists: string[];
+    min_score: number | null;
+    limit: number;
+    case_reference: string | null;
+    subjects: SubjectInput[];
+}
+export interface RunView extends RunSummary {
+    contract: string;
+    request: RunRequestRecord;
+    sources: SourceView[];
+    subjects: SubjectView[];
+}
+export interface LogEntry {
+    run_id: string;
+    sequence: number;
+    type: 'run_created' | 'decision_recorded' | 'second_review_recorded';
+    type_label: string;
+    at: string;
+    actor: ActorView;
+    hit_id: string | null;
+    hit?: {
+        subject_name: string;
+        entry_name: string;
+        list_name: string;
+    } | null;
+    data: Record<string, unknown>;
+    outcome_label?: string;
+}
+export interface LogView {
+    contract: string;
+    run_id: string;
+    events: LogEntry[];
+}
+export interface SubjectRequest {
+    name: string;
+    birth_date?: string;
+    country?: string;
+    schema?: string;
+    reference?: string;
+}
+export interface RunRequest {
+    kind: ScreeningKind;
+    profile: {
+        id: string;
+        version: string;
+    };
+    subjects: SubjectRequest[];
+    lists?: string[];
+    min_score?: number;
+    limit?: number;
+    case_reference?: string;
+}
+export interface DecisionRequest {
+    outcome: Outcome;
+    reason: string;
+    four_eyes: boolean;
+    expected_sequence?: number;
+}
+export interface SecondReviewRequest {
+    approve: boolean;
+    reason: string;
+    expected_sequence?: number;
+}
+export interface ApiErrorBody {
+    error: {
+        code: string;
+        message: string;
+        details: Record<string, unknown>;
+    };
+}
+export type RunQuery = Partial<Record<'status' | 'list' | 'subject' | 'confidence' | 'min_score', string>>;
+/**
+ * Port der Screening-Trefferprüfung. Die Komponente ruft nie selbst `fetch`
+ * auf; `createScreeningRestPort` ist die mitgelieferte REST-Umsetzung.
+ */
+export interface ScreeningPort {
+    settings: () => Promise<SettingsView>;
+    sources: () => Promise<SourcesView>;
+    runs: () => Promise<{
+        contract: string;
+        runs: RunSummary[];
+    }>;
+    createRun: (request: RunRequest) => Promise<RunView>;
+    run: (runId: string, query?: RunQuery) => Promise<RunView>;
+    log: (runId: string) => Promise<LogView>;
+    decide: (runId: string, hitId: string, decision: DecisionRequest) => Promise<HitView>;
+    secondReview: (runId: string, hitId: string, review: SecondReviewRequest) => Promise<HitView>;
+}

package/dist/screening/view.d.ts

@@ -0,0 +1,84 @@
+import { Locale, MessageParams } from '../i18n';
+import { ScreeningKey, ScreeningTranslate } from './messages';
+import { Breakdown, FreshnessStatus, HitView, Outcome, ReviewStatus, ReviewView, RunView, SettingsView, SubjectRequest, SubjectView } from './types';
+export interface HitFilter {
+    statuses: ReviewStatus[];
+    lists: string[];
+    subjects: string[];
+    confidences: string[];
+    minScore: number | null;
+    text: string;
+}
+export declare function emptyFilter(): HitFilter;
+export declare function acceptsHit(hit: HitView, filter: HitFilter): boolean;
+/** Subjects with only the hits passing the filter; subjects themselves stay visible. */
+export declare function filterSubjects(subjects: SubjectView[], filter: HitFilter): SubjectView[];
+export interface FilterOptions {
+    lists: {
+        key: string;
+        name: string;
+    }[];
+    subjects: {
+        id: string;
+        name: string;
+    }[];
+    confidences: string[];
+}
+export declare function filterOptions(run: RunView): FilterOptions;
+export declare function formatScore(value: number, scale: {
+    max: number;
+}, locale?: Locale): string;
+export declare function formatPoints(value: number, scale: {
+    max: number;
+}, locale?: Locale): string;
+export declare function scorePercent(value: number, scale: {
+    min: number;
+    max: number;
+}): number;
+export type Tone = 'plus' | 'minus' | 'neutral' | 'result';
+export interface BreakdownRow {
+    label: string;
+    value: string;
+    points: string;
+    tone: Tone;
+}
+export declare function breakdownRows(breakdown: Breakdown, locale?: Locale): BreakdownRow[];
+export declare function formatDate(value: string | null | undefined): string;
+export declare function freshnessTone(status: FreshnessStatus): 'ok' | 'warn' | 'muted';
+export declare function formatAge(days: number | null, t: ScreeningTranslate): string;
+export type MatchState = 'match' | 'conflict' | 'not_compared' | 'info';
+export interface ComparisonRow {
+    label: string;
+    input: string;
+    entry: string;
+    state: MatchState;
+}
+export declare function comparisonRows(subject: SubjectView, hit: HitView, t: ScreeningTranslate): ComparisonRow[];
+export declare function indicatorLabels(hit: HitView, t: ScreeningTranslate): string[];
+export declare function requiresFourEyes(outcome: Outcome, settings: SettingsView | null): boolean;
+export declare const canDecide: (review: ReviewView) => boolean;
+export declare const awaitsSecondReview: (review: ReviewView) => boolean;
+export interface DecisionForm {
+    outcome: Outcome | null;
+    reason: string;
+    fourEyes: boolean;
+}
+/** Meldung als Katalogschlüssel mit Platzhaltern; die Komponente übersetzt sie. */
+export interface ViewMessage {
+    key: ScreeningKey;
+    params?: MessageParams;
+}
+export declare function validateDecision(form: DecisionForm): ViewMessage[];
+/** The next hit still needing work after ``currentId`` (open, deferred or pending). */
+export declare function nextOpenHit(subjects: SubjectView[], currentId: string | null): string | null;
+export declare function findHit(run: RunView | null, hitId: string | null): {
+    subject: SubjectView;
+    hit: HitView;
+} | null;
+/** One subject per line: ``Name; Geburtsdatum; Land; Bezug`` (only the name is required). */
+export declare function parseSubjects(text: string): {
+    subjects: SubjectRequest[];
+    errors: ViewMessage[];
+};
+/** Replace one hit (after a decision) without reloading the whole run. */
+export declare function replaceHit(run: RunView, updated: HitView): RunView;

package/dist/store.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Kleinster gemeinsamer Zustandsspeicher der Controller. Jeder Stand ist ein
+ * neues, unveränderliches Objekt; React liest ihn über
+ * `useSyncExternalStore`, Vue spiegelt ihn in ein `shallowRef`.
+ */
+export interface Store<S extends object> {
+    get: () => S;
+    /** Teilstand übernehmen; Beobachter werden nur bei einer Änderung benachrichtigt. */
+    set: (patch: Partial<S> | ((state: S) => Partial<S>)) => void;
+    subscribe: (listener: () => void) => () => void;
+}
+export declare function createStore<S extends object>(initial: S): Store<S>;
+/** Beschäftigt-Status, Fehler und Erfolgsmeldung einer Portanfrage (gemeinsam für alle Controller). */
+export interface RequestState<E> {
+    busy: string | null;
+    error: E | null;
+    /** Letzte Erfolgsmeldung (für `aria-live`). */
+    notice: string;
+}
+export declare const IDLE: RequestState<never>;
+/**
+ * Führt eine Portanfrage aus: setzt `busy`, fängt Fehler (über `toError`) und
+ * meldet sie an `onError`. Ohne Port geschieht nichts (`null`).
+ */
+export declare function createRunner<P, E, S extends RequestState<E>>(store: Store<S>, port: () => P | null, toError: (error: unknown) => E, onError?: (error: E) => void): <T>(kind: string, task: (active: P) => Promise<T>) => Promise<T | null>;
+/** Verzögerter Aufruf, der bei jeder neuen Eingabe neu startet (Vorschau, Vollständigkeitsprüfung). */
+export declare function createDelay(ms: () => number): {
+    schedule(task: () => void): void;
+    cancel(): void;
+};

package/dist/synopsis/controller.d.ts

@@ -0,0 +1,68 @@
+import { SynopsisPort } from './port';
+import { ClientExportFormat, Comparison, ComparisonResult, CompareRow, ExportPayload, RowUpdate } from './types';
+import { RowView, SynopsisTranslate, SynopsisView } from './viewModel';
+/** Eingaben der Komponente (Props). */
+export interface SynopsisInputs {
+    comparison?: Comparison | null;
+    result?: ComparisonResult | null;
+    comparisonId?: string;
+    port?: SynopsisPort | null;
+    title?: string;
+    oldLabel?: string;
+    newLabel?: string;
+}
+export interface SynopsisFilterState {
+    statuses: string[];
+    query: string;
+    onlySelected: boolean;
+    /** `null`: Vorgabe aus `metadata.highlight_words`. */
+    highlight: boolean | null;
+}
+export interface SynopsisData {
+    loaded: Comparison | null;
+    loading: boolean;
+    error: string;
+    overrides: ReadonlyMap<string, Partial<CompareRow>>;
+    filter: SynopsisFilterState;
+    activeId: string | null;
+}
+export interface ServerExportLink {
+    label: string;
+    href: string;
+}
+/** Alles, was die Oberfläche aus Stand und Eingaben anzeigt (reine Funktion). */
+export interface SynopsisSelection {
+    currentId: string | undefined;
+    result: ComparisonResult | null;
+    view: SynopsisView | null;
+    rows: RowView[];
+    selectedText: string;
+    highlight: boolean;
+    activeId: string | null;
+    position: string;
+    canPrev: boolean;
+    canNext: boolean;
+    serverExports: ServerExportLink[];
+}
+/** Kennung des angezeigten Vergleichs (für Speichern und Server-Exporte). */
+export declare function synopsisId(state: SynopsisData, inputs: SynopsisInputs): string | undefined;
+/** Ergebnisobjekt vor lokalen Änderungen: Prop `result`, sonst gespeicherter oder geladener Vergleich. */
+export declare function synopsisBase(state: SynopsisData, inputs: SynopsisInputs): ComparisonResult | null;
+export declare function selectSynopsis(state: SynopsisData, inputs: SynopsisInputs, t: SynopsisTranslate): SynopsisSelection;
+/** Export der sichtbaren Zeilen (HTML, Markdown, Druckansicht). */
+export declare function buildSynopsisExport(selection: SynopsisSelection, format: ClientExportFormat, t: SynopsisTranslate, lang: string): ExportPayload | null;
+export declare function createSynopsisController(t: () => SynopsisTranslate): {
+    store: import('..').Store<SynopsisData>;
+    reload: (inputs: SynopsisInputs) => Promise<void>;
+    updateRow: (inputs: SynopsisInputs, id: string, patch: Omit<RowUpdate, "row_id">) => Promise<RowUpdate>;
+    toggleStatus: (status: string, enabled: boolean) => void;
+    go: (selection: SynopsisSelection, direction: 1 | -1) => string | null;
+    setAllChanges: () => void;
+    setQuery: (query: string) => void;
+    setOnlySelected: (onlySelected: boolean) => void;
+    setHighlight: (highlight: boolean) => void;
+    activate: (id: string | null) => void;
+    /** Neues Ergebnisobjekt: lokale Zeilenänderungen verwerfen. */
+    resetOverrides: () => void;
+};
+export type SynopsisController = ReturnType<typeof createSynopsisController>;

package/dist/synopsis/exporters.d.ts

@@ -0,0 +1,16 @@
+import { SynopsisTranslate, RowView, SynopsisView } from './viewModel';
+export interface ExportInput {
+    view: SynopsisView;
+    rows: readonly RowView[];
+    t: SynopsisTranslate;
+    /** Zeitpunkt der Ausgabe (Standard: jetzt), für reproduzierbare Tests injizierbar. */
+    generatedAt?: string;
+    lang?: string;
+}
+export declare function escapeHtml(text: string): string;
+export declare function escapeMarkdown(text: string): string;
+export declare function exportFilename(title: string, extension: string): string;
+/** Eigenständiges HTML-Dokument mit Druck-CSS (keine externen Ressourcen). */
+export declare function toHtml(input: ExportInput): string;
+/** Markdown: gestrichene Wörter als ~~…~~, neue als **…**. */
+export declare function toMarkdown(input: ExportInput): string;

package/dist/synopsis/index.d.ts

@@ -0,0 +1,8 @@
+export { synopsisMessages, type SynopsisMessageKey } from './messages';
+export * from './types';
+export * from './wordDiff';
+export * from './viewModel';
+export * from './exporters';
+export * from './port';
+export * from './controller';
+export { navigationDirection, focusRow } from './navigation';

package/dist/synopsis/messages.d.ts

@@ -0,0 +1,3 @@
+/** Sichtbare Texte der Synopse; Begriffe wie im audit_designer und in ecohesion. */
+export declare const synopsisMessages: import('..').Catalogs<"loading" | "search" | "title" | "empty" | "statusChanged" | "statusRemoved" | "statusAdded" | "statusMoved" | "statusUnchanged" | "oldLabel" | "newLabel" | "reasonLabel" | "location" | "emptyOld" | "emptyNew" | "fieldAnswer" | "fieldComment" | "fieldNote" | "counts" | "modeChecklist" | "modeText" | "detected" | "files" | "hashes" | "workAid" | "commands" | "openCommands" | "consolidated" | "consolidatedEntry" | "repealed" | "inserted" | "toolbar" | "layout" | "layoutSideBySide" | "layoutInline" | "filterLegend" | "filterAll" | "onlySelected" | "highlight" | "prevChange" | "nextChange" | "position" | "positionNone" | "keyboardHint" | "noMatches" | "exportLabel" | "exportHtml" | "exportMarkdown" | "exportPrint" | "serverDocx" | "serverPdf" | "serverJson" | "include" | "reasonPlaceholder" | "flowagent" | "flowagentVerified" | "flowagentCheck" | "srRemoved" | "srAdded" | "srEnd" | "selectedCount" | "loadError" | "saveError" | "generated">;
+export type SynopsisMessageKey = keyof typeof synopsisMessages.de;

package/dist/synopsis/navigation.d.ts

@@ -0,0 +1,5 @@
+/** Tastatur- und Fokussteuerung der Synopse (framework-frei). */
+/** Richtung für N/J (nächste) bzw. P/K (vorige Änderung); in Eingabefeldern und mit Modifikatoren `null`. */
+export declare function navigationDirection(event: Pick<KeyboardEvent, 'key' | 'altKey' | 'ctrlKey' | 'metaKey' | 'target'>): 1 | -1 | null;
+/** Zeile fokussieren und sichtbar machen; Zeilen tragen `data-row-id` und `tabindex="-1"`. */
+export declare function focusRow(root: HTMLElement | null, id: string): void;

package/dist/synopsis/port.d.ts

@@ -0,0 +1,38 @@
+import { RestOptions } from '@auditcore/common';
+import { Comparison, ComparisonProfile, ComparisonResult, ComparisonSummary, RowUpdate, ServerExportFormat } from './types';
+export interface SynopsisPort {
+    /** Vergleich laden (`GET /comparisons/{id}`). */
+    load(id: string): Promise<Comparison>;
+    /** Auswahl/Grund speichern (`PATCH /comparisons/{id}/rows`); liefert den neuen Stand. */
+    updateRows?(id: string, rows: readonly RowUpdate[]): Promise<Comparison>;
+    /** Adresse einer Server-Ausgabe (DOCX, PDF, JSON, Markdown) für einen Download-Link. */
+    exportUrl?(id: string, format: ServerExportFormat): string;
+}
+/** Optionen wie bei `src/rest`: `baseUrl` (z. B. `/api/synopsis`), injizierbares `fetch`, Kopfzeilen. */
+export type RestClientOptions = RestOptions;
+export interface CompareFields {
+    title?: string;
+    comparison_type?: 'standard' | 'article_law';
+    mode?: 'auto' | 'checklist' | 'text';
+    threshold?: number;
+    include_answers?: boolean;
+    include_notes?: boolean;
+    include_editorial?: boolean;
+    highlight_words?: boolean;
+    output_sections?: readonly string[];
+    profile?: string;
+}
+/** Anfrage von `POST /comparisons/import`: ein fertiges Ergebnis aus der Auftragssteuerung ablegen. */
+export interface ImportRequest {
+    title?: string;
+    result: ComparisonResult;
+}
+export interface SynopsisRestClient extends Required<SynopsisPort> {
+    profiles(): Promise<ComparisonProfile[]>;
+    list(): Promise<ComparisonSummary[]>;
+    create(oldFile: Blob, oldName: string, newFile: Blob, newName: string, fields?: CompareFields): Promise<Comparison>;
+    /** `POST /comparisons/import`. */
+    importResult(request: ImportRequest): Promise<Comparison>;
+    remove(id: string): Promise<void>;
+}
+export declare function createSynopsisRestClient(options: RestClientOptions): SynopsisRestClient;

package/dist/synopsis/types.d.ts

@@ -0,0 +1,121 @@
+/**
+ * JSON-Formen des REST-Vertrags (docs/ui/synopsis-rest.md). Sie entsprechen
+ * `ComparisonResult.to_dict()` aus `auditcore_documents`; die Oberfläche kennt
+ * keine zweite Datenform.
+ */
+export type RowStatus = 'changed' | 'removed' | 'added' | 'moved' | 'unchanged';
+export declare const ROW_STATUSES: readonly RowStatus[];
+/** Vorgabe des Filters „Alle Änderungen“: alles außer unverändert. */
+export declare const CHANGE_STATUSES: readonly RowStatus[];
+export type DiffField = 'text' | 'answer' | 'comment' | 'note';
+export interface CompareRow {
+    row_id: string;
+    status: RowStatus | string;
+    location: string;
+    old_text: string;
+    new_text: string;
+    old_answer?: string;
+    new_answer?: string;
+    old_comment?: string;
+    new_comment?: string;
+    old_note?: string;
+    new_note?: string;
+    reason?: string;
+    /** `''`, `flowagent` (KI-Vorschlag) oder `article_law` (Änderungsbefehl). */
+    reason_source?: string;
+    reason_verified?: boolean | null;
+    reason_warning?: string;
+    selected?: boolean;
+    /** Wortdifferenz im Format von `difflib.ndiff` je Feld. */
+    diff?: Partial<Record<DiffField, readonly string[]>>;
+}
+export interface ConsolidatedParagraph {
+    section: string;
+    paragraph: number;
+    text: string;
+    repealed: boolean;
+    inserted: boolean;
+}
+export interface ComparisonMetadata {
+    comparison_type?: 'standard' | 'article_law' | string;
+    detected_mode?: string;
+    highlight_words?: boolean;
+    output_sections?: readonly string[];
+    pdf_notice?: string;
+    profile?: {
+        id: string;
+        version: string;
+        fingerprint: string;
+    };
+    old_label?: string;
+    new_label?: string;
+    reason_label?: string;
+    recognised_commands?: number;
+    open_commands?: readonly string[];
+    open_command_count?: number;
+    consolidated_text?: readonly ConsolidatedParagraph[];
+    work_aid_notice?: string;
+    [key: string]: unknown;
+}
+export interface ComparisonResult {
+    version: string;
+    mode: 'checklist' | 'text' | string;
+    old_filename: string;
+    new_filename: string;
+    old_sha256: string;
+    new_sha256: string;
+    old_count: number;
+    new_count: number;
+    matched_count: number;
+    changed_count: number;
+    removed_count: number;
+    added_count: number;
+    moved_count?: number;
+    rows: readonly CompareRow[];
+    created_at: string;
+    metadata?: ComparisonMetadata;
+}
+/** Ein gespeicherter Vergleich (`GET /comparisons/{id}`). */
+export interface Comparison {
+    id: string;
+    title: string;
+    created_at: string;
+    result: ComparisonResult;
+}
+export interface ComparisonSummary {
+    id: string;
+    title: string;
+    created_at: string;
+    old_filename: string;
+    new_filename: string;
+    comparison_type: string;
+    counts: {
+        changed: number;
+        removed: number;
+        added: number;
+        moved: number;
+    };
+}
+export interface ComparisonProfile {
+    id: string;
+    version: string;
+    fingerprint: string;
+    status: string;
+    default: boolean;
+}
+/** Änderung einer Zeile (`PATCH /comparisons/{id}/rows`). */
+export interface RowUpdate {
+    row_id: string;
+    selected?: boolean;
+    reason?: string;
+}
+export type SynopsisLayout = 'side-by-side' | 'inline';
+export type ClientExportFormat = 'html' | 'markdown' | 'print';
+export type ServerExportFormat = 'json' | 'markdown' | 'docx' | 'pdf';
+/** Ergebnis eines Exports in der Oberfläche (Ereignis `export`). */
+export interface ExportPayload {
+    format: ClientExportFormat;
+    filename: string;
+    mimeType: string;
+    content: string;
+}