@auditcore/ui-core 0.3.0

package/dist/dataprotection/types.d.ts

@@ -0,0 +1,291 @@
+export declare const CONTRACT = "dataprotection_ui/1";
+export type FieldKind = 'text' | 'flag' | 'count';
+export type FieldValue = string | boolean | number | null;
+export interface RegisterColumn {
+    key: string;
+    title: string;
+    reference: string;
+    kind: FieldKind;
+    required: boolean;
+}
+export interface QuestionView {
+    key: string;
+    text: string;
+    reference: string;
+    /** `hart` = Muss-Kriterium, `punkt` = Kriterium WP 248, `fria` = Hochrisiko-KI. */
+    effect: string;
+    explanation: string;
+}
+export interface BlockView {
+    key: string;
+    title: string;
+    questions: QuestionView[];
+}
+export interface LevelView {
+    value: number;
+    label: string;
+}
+export interface MeasureView {
+    key: string;
+    title: string;
+    category: string;
+    reduces_severity: number;
+    reduces_likelihood: number;
+}
+export interface KeyTitle {
+    key: string;
+    title: string;
+}
+export interface DossierFieldView extends KeyTitle {
+    kind: 'text' | 'date' | 'choice';
+    required: boolean;
+    choices: KeyTitle[];
+}
+export interface DataProtectionProfile {
+    contract: string;
+    profile: {
+        id: string;
+        version: string;
+        fingerprint: string;
+        regime: string;
+        regime_title: string;
+        release_mode: string;
+    };
+    register: {
+        columns: RegisterColumn[];
+    };
+    screening: {
+        blocks: BlockView[];
+        points_threshold: number;
+    };
+    risk: {
+        scale_min: number;
+        scale_max: number;
+        severity_levels: LevelView[];
+        likelihood_levels: LevelView[];
+        dimensions: KeyTitle[];
+        measures: MeasureView[];
+        bands: string[];
+        method: string;
+    };
+    decisions: KeyTitle[];
+    dossier_fields: DossierFieldView[];
+}
+/** Hinweis der Vollständigkeitsprüfung; `subject` = `<Tätigkeits-ID>:<Feld>` oder `deckblatt:<Teil>`. */
+export interface Issue {
+    code: string;
+    message: string;
+    blocking: boolean;
+    subject: string;
+}
+export type Activity = Record<string, FieldValue> & {
+    id?: string;
+};
+export interface Person {
+    name?: string;
+    [field: string]: string | undefined;
+}
+export interface RegisterContent {
+    deckblatt: {
+        verantwortlicher?: Person;
+        dsb?: Person;
+        [part: string]: Person | undefined;
+    };
+    referate: string[];
+    taetigkeiten: Activity[];
+}
+export type RegisterStatus = 'entwurf' | 'freigegeben' | 'abgeloest';
+export interface VersionSummary {
+    version: number;
+    status: RegisterStatus;
+    created_by: string;
+    created_at: string;
+    released_by: string | null;
+    released_at: string | null;
+    activities: number;
+}
+export interface VersionView extends VersionSummary {
+    revision: number;
+    locked: boolean;
+    content: RegisterContent;
+    content_hash: string;
+    editors: string[];
+    predecessor_version: number | null;
+    issues: Issue[];
+}
+export interface RegisterState {
+    contract: string;
+    draft: VersionView | null;
+    released: VersionView | null;
+    versions: VersionSummary[];
+}
+export interface OverviewRow {
+    id: string;
+    position: number;
+    name: string;
+    referat: string;
+    zweck: string;
+    vvt_version: number;
+    vvt_status: RegisterStatus;
+    dsfa: null | {
+        id: string;
+        version: number;
+        status: AssessmentStatus;
+        entscheidung: string | null;
+        freigegeben_am: string | null;
+        pruefung_erforderlich: boolean;
+    };
+}
+export type AnswerValue = 'ja' | 'nein' | 'unbekannt';
+export type AssessmentStatus = 'entwurf' | 'dsb_beteiligung' | 'freigegeben' | 'abgeloest';
+export interface AnswerInput {
+    value: AnswerValue;
+    justification: string;
+}
+export interface ScenarioInput {
+    dimension: string;
+    description: string;
+    severity: number;
+    likelihood: number;
+    measures: string[];
+    residual_severity: number | null;
+    residual_likelihood: number | null;
+    residual_justification: string;
+}
+export interface ScenarioResult {
+    index: number;
+    dimension_title: string;
+    description: string;
+    gross: number;
+    gross_band: string;
+    net: number;
+    net_band: string;
+    net_severity: number;
+    net_likelihood: number;
+    measure_titles: string[];
+    explicit_residual: string[];
+}
+export interface Proposal {
+    profile: {
+        id: string;
+        version: string;
+        fingerprint: string;
+    };
+    recommendation: string;
+    recommendation_text: string;
+    reasoning: string;
+    consultation_required: boolean;
+    consultation_notice?: {
+        status: string;
+        text: string;
+        final: boolean;
+    };
+    issues: Issue[];
+    screening: {
+        outcome: 'pflicht' | 'keine_pflicht' | 'unvollstaendig';
+        points: number;
+        points_threshold: number;
+        hard_triggers: string[];
+        point_criteria: string[];
+        fria_required: boolean | null;
+        unanswered: string[];
+        unknown: string[];
+        complete: boolean;
+        reasoning: string;
+    };
+    risk: null | {
+        gross_maximum: number;
+        net_maximum: number;
+        net_band: string;
+        gross_band?: string;
+        scenarios: ScenarioResult[];
+    };
+}
+export interface AssessmentSummary {
+    id: string;
+    version: number;
+    status: AssessmentStatus;
+    decision: string | null;
+    created_at: string;
+    released_by: string | null;
+    released_at: string | null;
+}
+export interface AssessmentView extends AssessmentSummary {
+    contract: string;
+    activity_id: string;
+    activity_name: string;
+    revision: number;
+    locked: boolean;
+    register_version: number;
+    profile: {
+        id: string;
+        version: string;
+    };
+    answers: Record<string, AnswerInput>;
+    scenarios: ScenarioInput[];
+    necessity: string;
+    proportionality: string;
+    dossier: Record<string, string>;
+    proposal: Proposal;
+    created_by: string;
+    updated_at: string;
+    editors: string[];
+    deviation: boolean;
+    deviation_justification: string | null;
+    conditions: string[];
+    decided_by: string | null;
+    decided_at: string | null;
+    dpo_requested_from: string | null;
+    dpo_requested_on: string | null;
+    release_open_points: string[];
+    open_points: string[];
+    release_blockers: string[];
+    versions: AssessmentSummary[];
+}
+/** Erhebung einer Folgenabschätzung, wie sie `POST /assessments/{id}` erwartet. */
+export interface SurveyInput {
+    answers: Record<string, AnswerInput>;
+    scenarios: ScenarioInput[];
+    necessity: string;
+    proportionality: string;
+    /** Nur Profile nach Schema 2 (EDSA-Vorlage); sonst weglassen. */
+    dossier?: Record<string, string>;
+}
+export interface DecisionInput {
+    decision: string;
+    justification: string;
+    conditions: string[];
+}
+export type RegisterExportFormat = 'html' | 'markdown' | 'csv';
+export type AssessmentExportFormat = 'html' | 'markdown';
+export interface ExportedFile {
+    blob: Blob;
+    filename: string;
+    mediaType: string;
+}
+/**
+ * Datenzugang der Komponenten. Die mitgelieferte Umsetzung ist
+ * `createDataProtectionRestPort`; Anwendungen können eigene Ports übergeben.
+ */
+export interface DataProtectionPort {
+    profile: () => Promise<DataProtectionProfile>;
+    register: () => Promise<RegisterState>;
+    checkRegister: (content: RegisterContent) => Promise<{
+        issues: Issue[];
+    }>;
+    saveDraft: (content: RegisterContent, expectedRevision: number | null) => Promise<VersionView>;
+    releaseRegister: (expectedRevision: number) => Promise<VersionView>;
+    exportRegister: (format: RegisterExportFormat, source: 'draft' | 'released') => Promise<ExportedFile>;
+    overview: () => Promise<{
+        items: OverviewRow[];
+    }>;
+    startAssessment: (activityId: string) => Promise<AssessmentView>;
+    assessment: (id: string) => Promise<AssessmentView>;
+    calculate: (answers: Record<string, AnswerInput>, scenarios: ScenarioInput[]) => Promise<Proposal>;
+    updateAssessment: (id: string, expectedRevision: number, survey: SurveyInput) => Promise<AssessmentView>;
+    decide: (id: string, expectedRevision: number, decision: DecisionInput) => Promise<AssessmentView>;
+    requestDpo: (id: string, expectedRevision: number, requestedFrom: string, requestedOn: string) => Promise<AssessmentView>;
+    releaseAssessment: (id: string, expectedRevision: number) => Promise<AssessmentView>;
+    reassess: (id: string) => Promise<AssessmentView>;
+    exportAssessment: (id: string, format: AssessmentExportFormat) => Promise<ExportedFile>;
+}

package/dist/dataprotection/vvt.d.ts

@@ -0,0 +1,69 @@
+import { RequestState, Store } from '../store';
+import { ExportTexts } from './exporters';
+import { DataProtectionTranslate } from './messages';
+import { DataProtectionError, RequestHooks } from './requests';
+import { DataProtectionPort, DataProtectionProfile, FieldValue, Issue, Person, RegisterContent, RegisterState, VersionView } from './types';
+export type VvtExportFormat = 'print' | 'markdown' | 'csv';
+export interface VvtExport {
+    format: VvtExportFormat;
+    filename: string;
+    mimeType: string;
+    content: string;
+}
+export interface VvtHooks extends RequestHooks {
+    onSaved?: (version: VersionView) => void;
+    onReleased?: (version: VersionView) => void;
+    /** Wartezeit der Vollständigkeitsprüfung nach einer Eingabe (ms). */
+    checkDelay?: number;
+}
+export interface VvtData extends RequestState<DataProtectionError> {
+    profile: DataProtectionProfile | null;
+    register: RegisterState | null;
+    showing: 'draft' | 'released';
+    working: RegisterContent | null;
+    checked: Issue[] | null;
+    /** Ausgewählte Tätigkeit (Index in `content.taetigkeiten`). */
+    selected: number | null;
+    history: boolean;
+}
+/** Abgeleitete Werte eines Stands (reine Funktion, von beiden Oberflächen genutzt). */
+export interface VvtView {
+    version: VersionView | null;
+    editing: boolean;
+    content: RegisterContent;
+    dirty: boolean;
+    issues: Issue[];
+}
+export declare function vvtView(state: VvtData): VvtView;
+/** Vier-Augen-Hinweis: die angemeldete Person hat den offenen Entwurf bearbeitet. */
+export declare function vvtFourEyes(state: VvtData, actor: string): boolean;
+export declare function vvtVersionLabel(t: DataProtectionTranslate, version: VersionView | null): string;
+/** Beschriftungen der Exporte (Druckansicht, Markdown, CSV). */
+export declare function vvtExportTexts(t: DataProtectionTranslate): ExportTexts;
+export declare function buildVvtExport(state: VvtData, format: VvtExportFormat, t: DataProtectionTranslate, lang: string): VvtExport;
+export interface VvtControllerOptions extends VvtHooks {
+    port: () => DataProtectionPort | null;
+    t: () => DataProtectionTranslate;
+}
+export declare function createVvtController(options: VvtControllerOptions): {
+    save: () => Promise<VersionView | null>;
+    release: () => Promise<VersionView | null>;
+    select: (index: number | null) => void;
+    toggleHistory: () => void;
+    changeField(key: string, value: FieldValue): void;
+    addActivity(department: string): void;
+    removeActivity(): void;
+    changePerson: (part: "verantwortlicher" | "dsb", person: Person) => void;
+    changeDepartments: (departments: readonly string[]) => void;
+    check: () => Promise<void>;
+    update: (next: RegisterContent) => void;
+    show: (which: "draft" | "released") => void;
+    startDraft: () => void;
+    discard: () => void;
+    dispose: () => void;
+    store: Store<VvtData>;
+    load: (editable: boolean) => Promise<void>;
+    exportAs: (format: VvtExportFormat, lang: string) => VvtExport;
+    setNotice: (notice: string) => void;
+};
+export type VvtController = ReturnType<typeof createVvtController>;

package/dist/dbkanban/controller.d.ts

@@ -0,0 +1,54 @@
+import { RecordPort, RecordRow, RecordTable } from '@auditcore/kanban-core';
+import { RequestState, Store } from '../store';
+import { DbKanbanTranslate } from './messages';
+export interface DbKanbanError {
+    code: string;
+    message: string;
+    status: number;
+}
+export type DbKanbanBusy = 'load' | 'move' | 'add';
+export interface DbKanbanData extends RequestState<DbKanbanError> {
+    table: RecordTable | null;
+    /** Eigenschaft, nach der gruppiert wird (`select`). */
+    groupBy: string;
+    query: string;
+    /** Gezogene Karte (Maus) bzw. aufgenommene Karte (Tastatur). */
+    dragging: string | null;
+    /** Spalte unter dem Mauszeiger beim Ziehen. */
+    dropTarget: string | null;
+}
+/** Verschiebung einer Karte: der gesetzte Zellwert (`null` = ohne Wert). */
+export interface RecordMove {
+    rowId: string;
+    propertyId: string;
+    value: string | null;
+}
+export interface DbKanbanHooks {
+    onMoved?: (move: RecordMove) => void;
+    onAdded?: (row: RecordRow) => void;
+    onGroupBy?: (propertyId: string) => void;
+    onError?: (error: DbKanbanError) => void;
+}
+export interface DbKanbanControllerOptions extends DbKanbanHooks {
+    port: () => RecordPort | null;
+    t: () => DbKanbanTranslate;
+    editable?: () => boolean;
+    lang?: () => string;
+}
+export declare const INITIAL_DB_KANBAN: DbKanbanData;
+export declare function asDbKanbanError(error: unknown, t: DbKanbanTranslate): DbKanbanError;
+/** Vorgabe: gewünschte Eigenschaft, falls gruppierbar, sonst die erste Auswahl-Eigenschaft. */
+export declare function initialGroupBy(table: RecordTable, preferred: string | undefined): string;
+export declare function createDbKanbanController(options: DbKanbanControllerOptions): {
+    setQuery: (query: string) => void;
+    startDrag: (rowId: string | null) => void;
+    setDropTarget: (column: string | null) => void;
+    dismissError: () => void;
+    move: (rowId: string, column: string) => Promise<boolean>;
+    moveBy: (rowId: string, direction: 1 | -1) => Promise<boolean>;
+    addCard: (column: string) => Promise<RecordRow | null>;
+    store: Store<DbKanbanData>;
+    load: (preferredGroupBy?: string) => Promise<void>;
+    setGroupBy: (propertyId: string) => void;
+};
+export type DbKanbanController = ReturnType<typeof createDbKanbanController>;

package/dist/dbkanban/index.d.ts

@@ -0,0 +1,3 @@
+export { dbKanbanMessages, type DbKanbanMessageKey, type DbKanbanTranslate } from './messages';
+export * from './controller';
+export * from './view';

package/dist/dbkanban/messages.d.ts

@@ -0,0 +1,5 @@
+import { Translate } from '../i18n';
+/** Texte der Datenbankansicht als Kanban (`<flowaudit-db-kanban>`). */
+export declare const dbKanbanMessages: import('..').Catalogs<"title" | "noMatches" | "added" | "moved" | "noPort" | "networkError" | "yes" | "no" | "searchLabel" | "busy_load" | "readOnly" | "addCard" | "addCardIn" | "groupByLabel" | "noGroupable" | "noGroupBy" | "withoutValue" | "columnCount" | "columnCountOne" | "columnEmpty" | "untitled" | "cardLabel" | "moveHint" | "busy_move" | "busy_add">;
+export type DbKanbanMessageKey = keyof typeof dbKanbanMessages.de;
+export type DbKanbanTranslate = Translate<DbKanbanMessageKey>;

package/dist/dbkanban/view.d.ts

@@ -0,0 +1,39 @@
+import { RecordValue, RecordProperty, RecordTable } from '@auditcore/kanban-core';
+import { DbKanbanData } from './controller';
+import { DbKanbanTranslate } from './messages';
+export interface DbFieldView {
+    id: string;
+    label: string;
+    text: string;
+}
+export interface DbCardView {
+    id: string;
+    title: string;
+    fields: DbFieldView[];
+    /** Spalte der Karte (`""` = ohne Wert). */
+    column: string;
+}
+export interface DbColumnView {
+    value: string;
+    label: string;
+    countText: string;
+    cards: DbCardView[];
+}
+export interface DbGroupOption {
+    value: string;
+    label: string;
+}
+export interface DbKanbanView {
+    groupOptions: DbGroupOption[];
+    columns: DbColumnView[];
+    /** Hinweis statt Spalten (keine Gruppierung möglich/gewählt), sonst `null`. */
+    notice: string | null;
+    noMatches: boolean;
+    busyText: string;
+}
+/** Anzeigetext eines Zellwerts; leere Werte ergeben `""`. */
+export declare function cellText(value: RecordValue | undefined, t: DbKanbanTranslate, lang: string): string;
+/** Titel-Eigenschaft: die erste Texteigenschaft (wie die erste Spalte der Tabellenansicht). */
+export declare function titleProperty(table: RecordTable): RecordProperty | undefined;
+export declare function columnLabel(value: string, t: DbKanbanTranslate): string;
+export declare function dbKanbanView(state: DbKanbanData, t: DbKanbanTranslate, lang?: string): DbKanbanView;

package/dist/documents/controller.d.ts

@@ -0,0 +1,63 @@
+import { RequestState, Store } from '../store';
+import { SynopsisPort, SynopsisRestClient } from '../synopsis/port';
+import { Comparison, ComparisonProfile, ComparisonSummary, RowStatus } from '../synopsis/types';
+import { CompareForm } from './form';
+import { ComparisonsTranslate } from './messages';
+/**
+ * Port zur Anwendung: {@link createSynopsisRestClient} erfüllt ihn vollständig.
+ * `load`/`updateRows`/`exportUrl` braucht nur die eingebettete Synopse,
+ * `importResult` nur der Import.
+ */
+export type ComparisonsPort = Pick<SynopsisRestClient, 'profiles' | 'list' | 'create' | 'remove'> & Partial<Pick<SynopsisRestClient, 'importResult' | 'load' | 'updateRows' | 'exportUrl'>>;
+/** Der Port als Datenzugang der eingebetteten Synopse, wenn er Vergleiche laden kann. */
+export declare function synopsisPortOf(port: ComparisonsPort | null | undefined): SynopsisPort | null;
+/** Fehler einer Portanfrage: Meldung des Servers bzw. `network_error` mit Status 0. */
+export interface ComparisonsError {
+    code: string;
+    message: string;
+    status: number;
+}
+export type ComparisonsBusy = 'load' | 'create' | 'import' | 'remove';
+export interface ComparisonsData extends RequestState<ComparisonsError> {
+    profiles: ComparisonProfile[];
+    items: ComparisonSummary[];
+    loaded: boolean;
+    query: string;
+    form: CompareForm;
+    /** Nach dem ersten Absenden werden Befunde der Formularprüfung angezeigt. */
+    submitted: boolean;
+    /** Geöffneter Vergleich (Synopse). */
+    openId: string | null;
+    /** Vergleich, dessen Löschen bestätigt werden soll. */
+    pendingRemove: string | null;
+}
+export interface ComparisonsHooks {
+    onCreated?: (comparison: Comparison) => void;
+    onImported?: (comparison: Comparison) => void;
+    onRemoved?: (id: string) => void;
+    onError?: (error: ComparisonsError) => void;
+}
+export interface ComparisonsControllerOptions extends ComparisonsHooks {
+    port: () => ComparisonsPort | null;
+    t: () => ComparisonsTranslate;
+    maxBytes?: () => number;
+    lang?: () => string;
+}
+export declare const INITIAL_COMPARISONS: ComparisonsData;
+export declare function asComparisonsError(error: unknown, t: ComparisonsTranslate): ComparisonsError;
+export declare function createComparisonsController(options: ComparisonsControllerOptions): {
+    setQuery: (query: string) => void;
+    open: (id: string | null) => void;
+    askRemove: (id: string) => void;
+    cancelRemove: () => void;
+    dismissError: () => void;
+    submit: () => Promise<Comparison | null>;
+    importText: (text: string) => Promise<Comparison | null>;
+    confirmRemove: () => Promise<boolean>;
+    updateForm: (patch: Partial<CompareForm>) => void;
+    toggleSection: (status: RowStatus, enabled: boolean) => void;
+    resetForm: () => void;
+    store: Store<ComparisonsData>;
+    load: () => Promise<void>;
+};
+export type ComparisonsController = ReturnType<typeof createComparisonsController>;

package/dist/documents/form.d.ts

@@ -0,0 +1,52 @@
+import { CompareFields } from '../synopsis/port';
+import { ComparisonProfile, RowStatus } from '../synopsis/types';
+import { ComparisonsMessageKey } from './messages';
+export type ComparisonKind = 'standard' | 'article_law';
+export type ComparisonMode = 'auto' | 'checklist' | 'text';
+export declare const COMPARISON_KINDS: readonly ComparisonKind[];
+export declare const COMPARISON_MODES: readonly ComparisonMode[];
+export declare const ACCEPTED_EXTENSIONS: readonly string[];
+/** Vorgabe des Servers (`ServiceSettings.max_upload_bytes`). */
+export declare const DEFAULT_MAX_UPLOAD_BYTES: number;
+export declare const MIN_THRESHOLD = 70;
+export declare const MAX_THRESHOLD = 100;
+export declare const MAX_TITLE = 255;
+/** Datei aus einem Eingabefeld (im Browser `File`). */
+export interface UploadFile extends Blob {
+    readonly name: string;
+}
+export interface CompareForm {
+    oldFile: UploadFile | null;
+    newFile: UploadFile | null;
+    title: string;
+    kind: ComparisonKind;
+    mode: ComparisonMode;
+    threshold: number;
+    includeAnswers: boolean;
+    includeNotes: boolean;
+    includeEditorial: boolean;
+    highlightWords: boolean;
+    sections: readonly RowStatus[];
+    /** Leer: Standardprofil des Servers. */
+    profile: string;
+}
+export declare const DEFAULT_FORM: CompareForm;
+/** Ein Befund der Formularprüfung: Textschlüssel und Platzhalter. */
+export interface FormProblem {
+    key: Extract<ComparisonsMessageKey, `problem_${string}`>;
+    field: 'oldFile' | 'newFile' | 'threshold' | 'sections' | 'title';
+    params?: Readonly<Record<string, string>>;
+}
+/** Größenangabe wie „20 MiB“ oder „512 KiB“. */
+export declare function formatBytes(bytes: number, lang?: string): string;
+export declare function hasAcceptedExtension(name: string): boolean;
+/** Alle Befunde in Formularreihenfolge; leer heißt: absendbar. */
+export declare function formProblems(form: CompareForm, maxBytes?: number, lang?: string): FormProblem[];
+/** PDF-Dateien vergleicht der Server immer als Fließtext. */
+export declare function involvesPdf(form: CompareForm): boolean;
+/** Formularfelder für `POST /comparisons`; Gesetzessynopse ohne die Optionen des Standardvergleichs. */
+export declare function toCompareFields(form: CompareForm): CompareFields;
+/** Abschnitt ein- oder ausschalten; Reihenfolge wie `ROW_STATUSES`. */
+export declare function toggleSection(sections: readonly RowStatus[], status: RowStatus, enabled: boolean): RowStatus[];
+/** Standardprofil des Servers (`default: true`), sonst das erste. */
+export declare function defaultProfile(profiles: readonly ComparisonProfile[]): ComparisonProfile | null;

package/dist/documents/importing.d.ts

@@ -0,0 +1,12 @@
+import { ImportRequest } from '../synopsis/port';
+import { ComparisonResult } from '../synopsis/types';
+export type ImportParse = {
+    ok: true;
+    request: ImportRequest;
+} | {
+    ok: false;
+    key: 'importUnreadable' | 'importInvalid';
+};
+/** Kennzeichen eines `ComparisonResult.to_dict()`; Einzelheiten prüft `ComparisonResult.from_dict`. */
+export declare function looksLikeResult(value: unknown): value is ComparisonResult;
+export declare function parseImport(text: string): ImportParse;

package/dist/documents/index.d.ts

@@ -0,0 +1,6 @@
+export { comparisonsMessages, type ComparisonsMessageKey, type ComparisonsTranslate } from './messages';
+export * from './form';
+export * from './importing';
+export * from './list';
+export * from './controller';
+export * from './view';

package/dist/documents/list.d.ts

@@ -0,0 +1,21 @@
+import { Comparison, ComparisonSummary } from '../synopsis/types';
+import { ComparisonsTranslate } from './messages';
+export interface SummaryView {
+    id: string;
+    title: string;
+    kind: string;
+    kindLabel: string;
+    files: string;
+    counts: string;
+    /** Summe der Änderungen (für Badges). */
+    changes: number;
+    created: string;
+    createdIso: string;
+}
+/** Datum und Uhrzeit in der Sprache der Oberfläche; ungültige Angaben bleiben stehen. */
+export declare function formatDateTime(iso: string, lang: string): string;
+export declare function summaryView(summary: ComparisonSummary, t: ComparisonsTranslate, lang: string): SummaryView;
+/** Suche in Titel und Dateinamen, ohne Groß-/Kleinschreibung; neueste zuerst wie der Server. */
+export declare function filterSummaries(items: readonly ComparisonSummary[], query: string): ComparisonSummary[];
+/** Eintrag der Liste aus einem gespeicherten Vergleich (nach Anlegen oder Import). */
+export declare function summaryOf(comparison: Comparison): ComparisonSummary;

package/dist/documents/messages.d.ts

@@ -0,0 +1,8 @@
+import { Translate } from '../i18n';
+/**
+ * Texte der Vergleichsverwaltung (`<flowaudit-comparisons>`): Hochladen,
+ * gespeicherte Vergleiche, Import und Löschen. Begriffe wie in der Synopse.
+ */
+export declare const comparisonsMessages: import('..').Catalogs<"title" | "cancel" | "reset" | "submit" | "empty" | "counts" | "files" | "workAid" | "noMatches" | "removed" | "noPort" | "networkError" | "open" | "remove" | "imported" | "formHeading" | "oldFile" | "newFile" | "oldFileArticleLaw" | "newFileArticleLaw" | "fileHint" | "fileChosen" | "titleLabel" | "titlePlaceholder" | "typeLabel" | "kind_standard" | "kind_article_law" | "modeLabel" | "mode_auto" | "mode_checklist" | "mode_text" | "pdfHint" | "thresholdLabel" | "optionsLegend" | "includeAnswers" | "includeNotes" | "includeEditorial" | "highlightWords" | "sectionsLegend" | "section_changed" | "section_removed" | "section_added" | "section_moved" | "section_unchanged" | "profileLabel" | "profileDefault" | "profileOption" | "problemsHeading" | "problem_oldMissing" | "problem_newMissing" | "problem_type" | "problem_size" | "problem_threshold" | "problem_sections" | "problem_title" | "listHeading" | "searchLabel" | "listCount" | "openLabel" | "removeLabel" | "confirmTitle" | "confirmText" | "importLabel" | "importInvalid" | "importUnreadable" | "importUnsupported" | "created" | "back" | "busy_load" | "busy_create" | "busy_import" | "busy_remove">;
+export type ComparisonsMessageKey = keyof typeof comparisonsMessages.de;
+export type ComparisonsTranslate = Translate<ComparisonsMessageKey>;

package/dist/documents/view.d.ts

@@ -0,0 +1,36 @@
+import { ComparisonsData } from './controller';
+import { FormProblem } from './form';
+import { SummaryView } from './list';
+import { ComparisonsTranslate } from './messages';
+export interface ProblemView {
+    field: FormProblem['field'];
+    text: string;
+}
+export interface ProfileOption {
+    /** Leer: Vorgabe des Servers. */
+    value: string;
+    label: string;
+}
+export interface ComparisonsView {
+    rows: SummaryView[];
+    total: number;
+    countText: string;
+    /** Hinweis bei leerer Liste, sonst `null`. */
+    emptyText: string | null;
+    problems: ProblemView[];
+    profileOptions: ProfileOption[];
+    sizeHint: string;
+    oldFileText: string;
+    newFileText: string;
+    oldFileLabel: string;
+    newFileLabel: string;
+    pdfHint: boolean;
+    busyText: string;
+    pendingTitle: string | null;
+    openTitle: string | null;
+}
+export interface ComparisonsViewOptions {
+    lang: string;
+    maxBytes?: number;
+}
+export declare function comparisonsView(state: ComparisonsData, t: ComparisonsTranslate, options: ComparisonsViewOptions): ComparisonsView;