@hub-kit/core 0.3.0

package/dist/pages/invoice-detail/history.js

@@ -0,0 +1,76 @@
+const KNOWN_TYPES = [
+    "notiz",
+    "statuswechsel",
+    "aenderung",
+    "zuweisung",
+    "zuordnung",
+    "loeschung",
+    "regel",
+    "nicht_relevant",
+    "archiviert",
+];
+export function historyTypeLabel(type, config, labels) {
+    const known = [...KNOWN_TYPES, ...config.approvalHistoryTypes];
+    return known.includes(type) ? labels.typeLabel(type) : type;
+}
+function legacyActionFromText(text, config, format) {
+    for (const id of config.legacyActionIds) {
+        const de = format.approvalActionLabelDe(id);
+        if (!de || de === id)
+            continue;
+        if (text === de || text.startsWith(`${de}: `))
+            return id;
+    }
+    return null;
+}
+function legacyCorrectionTarget(text, format) {
+    const match = /^Manuell korrigiert:\s*.+?\s*→\s*(.+)$/.exec(text.trim());
+    if (!match)
+        return null;
+    return format.workflowOrder.find((s) => format.workflowLabelDe(s) === match[1].trim()) ?? null;
+}
+export function historyComment(entry, config, format) {
+    const stored = entry.data?.kommentar;
+    if (typeof stored === "string" && stored.trim() !== "")
+        return stored.trim();
+    const text = entry.text?.trim();
+    if (!text)
+        return null;
+    const id = legacyActionFromText(text, config, format);
+    if (!id)
+        return null;
+    const de = format.approvalActionLabelDe(id);
+    return text.length > de.length + 2 ? text.slice(de.length + 2) : null;
+}
+export function historyTargetStatus(entry, config, format) {
+    const d = entry.data;
+    const raw = d?.korrektur_nach ?? d?.nach;
+    if (typeof raw === "string" && raw.trim() !== "")
+        return raw;
+    const from = entry.text ? legacyActionFromText(entry.text.trim(), config, format) : null;
+    return from ? (config.actionTargetStatus[from] ?? null) : legacyCorrectionTarget(entry.text ?? "", format);
+}
+export function historyStateLabel(entry, config, format, labels) {
+    const target = historyTargetStatus(entry, config, format);
+    return target ? labels.stateLabel(target) : historyTypeLabel(entry.type, config, labels);
+}
+export function historyQualifier(entry, labels) {
+    if (entry.type === "korrektur")
+        return labels.corrected;
+    if (entry.type === "rueckfrage")
+        return labels.queryAdditional;
+    return null;
+}
+export function historyLines(entry, config, format) {
+    const lines = entry.data?.lines;
+    if (Array.isArray(lines)) {
+        const strings = lines.filter((l) => typeof l === "string" && l.trim() !== "");
+        if (strings.length > 0)
+            return strings;
+    }
+    if (historyTargetStatus(entry, config, format) !== null || entry.type === "korrektur" || entry.type === "rueckfrage") {
+        const comment = historyComment(entry, config, format);
+        return comment ? [comment] : [];
+    }
+    return entry.text && entry.text.trim() !== "" ? [entry.text] : [];
+}

package/dist/pages/invoice-detail/index.d.ts

@@ -0,0 +1,21 @@
+export type { Confidence, Validation, Extracted, InvoiceReviewFields, InvoiceHistoryEntry } from "./pipeline-types";
+export { VALIDATION_GATES, SEVERITY_INFORMATIONAL, SEVERITY_ACTION_REQUIRED, VALIDATION_FIELD_REASON, REVIEW_CHECK_REASON, SOURCE_HUMAN, reviewChecks, isManuallyCorrected, validationBase, validationCorrections, validationDetail, writeValidationDetail, validationFlat, reviewReasonsDetail, reviewReasonNumbers, buildReviewSummary, reviewReasonConfidence, reviewReasonIbanCount, reviewReasonIds, reviewScore, withoutEmDash, reviewLines, reviewCheckLabelDe, hasNoReviewChecks, } from "./review";
+export type { ValidationGateKey, ReviewReasonId, ReviewCheck, ValidationDetailEntry, ValidationDetail, ReviewReason, ReviewSummary, ReviewLine, ReviewLabels, } from "./review";
+export { ibanCandidates, ibanChecksumValid, invoiceRechecked } from "./review-recheck";
+export { historyTypeLabel, historyComment, historyTargetStatus, historyStateLabel, historyQualifier, historyLines, } from "./history";
+export type { HistoryConfig, HistoryFormat, HistoryLabels } from "./history";
+export { isOutgoingInvoice, OutgoingInvoiceBanner, OutgoingInvoiceBadge } from "./OutgoingInvoiceFlag";
+export type { OutgoingInvoiceLabels } from "./OutgoingInvoiceFlag";
+export { SideBySide } from "./SideBySide";
+export { WorkflowLadder } from "./WorkflowLadder";
+export type { LadderColors, WorkflowLadderLabels } from "./WorkflowLadder";
+export { WorkflowHistoryList } from "./WorkflowHistoryList";
+export type { WorkflowHistoryRow, WorkflowHistoryLabels } from "./WorkflowHistoryList";
+export { ReviewBadge } from "./ReviewBadge";
+export type { ReviewBadgeLabels } from "./ReviewBadge";
+export { ReviewCard } from "./ReviewCard";
+export type { ReviewCardLabels } from "./ReviewCard";
+export { englishInvoiceDetailLabels } from "./labels";
+export type { InvoiceDetailLabels, InvoiceDetailPageLabels } from "./labels";
+export { InvoiceDetailPage } from "./InvoiceDetailPage";
+export type { InvoiceDetailPageProps } from "./InvoiceDetailPage";

package/dist/pages/invoice-detail/index.js

@@ -0,0 +1,11 @@
+export { VALIDATION_GATES, SEVERITY_INFORMATIONAL, SEVERITY_ACTION_REQUIRED, VALIDATION_FIELD_REASON, REVIEW_CHECK_REASON, SOURCE_HUMAN, reviewChecks, isManuallyCorrected, validationBase, validationCorrections, validationDetail, writeValidationDetail, validationFlat, reviewReasonsDetail, reviewReasonNumbers, buildReviewSummary, reviewReasonConfidence, reviewReasonIbanCount, reviewReasonIds, reviewScore, withoutEmDash, reviewLines, reviewCheckLabelDe, hasNoReviewChecks, } from "./review.js";
+export { ibanCandidates, ibanChecksumValid, invoiceRechecked } from "./review-recheck.js";
+export { historyTypeLabel, historyComment, historyTargetStatus, historyStateLabel, historyQualifier, historyLines, } from "./history.js";
+export { isOutgoingInvoice, OutgoingInvoiceBanner, OutgoingInvoiceBadge } from "./OutgoingInvoiceFlag.js";
+export { SideBySide } from "./SideBySide.js";
+export { WorkflowLadder } from "./WorkflowLadder.js";
+export { WorkflowHistoryList } from "./WorkflowHistoryList.js";
+export { ReviewBadge } from "./ReviewBadge.js";
+export { ReviewCard } from "./ReviewCard.js";
+export { englishInvoiceDetailLabels } from "./labels.js";
+export { InvoiceDetailPage } from "./InvoiceDetailPage.js";

package/dist/pages/invoice-detail/labels.d.ts

@@ -0,0 +1,79 @@
+import { ReviewBadgeLabels } from "./ReviewBadge";
+import { ReviewCardLabels } from "./ReviewCard";
+import { WorkflowLadderLabels } from "./WorkflowLadder";
+import { WorkflowHistoryLabels } from "./WorkflowHistoryList";
+import { OutgoingInvoiceLabels } from "./OutgoingInvoiceFlag";
+import { ReviewLabels } from "./review";
+import { HistoryLabels } from "./history";
+export interface InvoiceDetailPageLabels {
+    backToList: string;
+    notFoundTitle: string;
+    notFoundBody: (id: string) => string;
+    noInvoiceNumber: string;
+    tabOverview: string;
+    tabApproval: string;
+    tabPayment: string;
+    tabDetails: string;
+    tabHistory: string;
+    edit: string;
+    save: string;
+    cancel: string;
+    saving: string;
+    saved: string;
+    saveFailed: (error: string) => string;
+    fieldIssuer: string;
+    fieldInvoiceNumber: string;
+    fieldOrderNumber: string;
+    fieldDocumentDate: string;
+    fieldDueDate: string;
+    fieldServiceDate: string;
+    fieldAmountNet: string;
+    fieldVatRate: string;
+    fieldVatAmount: string;
+    fieldAmountGross: string;
+    fieldCurrency: string;
+    fieldCompany: string;
+    fieldProperty: string;
+    fieldCategory: string;
+    fieldRecipientName: string;
+    fieldCustomerNumber: string;
+    fieldPaymentReference: string;
+    fieldPaymentMethod: string;
+    fieldTaxNote: string;
+    fieldServiceDescription: string;
+    unsavedTitle: string;
+    unsavedBody: (fields: string) => string;
+    unsavedDiscard: string;
+    unsavedKeepEditing: string;
+    addNotePlaceholder: string;
+    addNoteButton: string;
+    noteAdded: string;
+    deleteButton: string;
+    deleteDialogTitle: string;
+    deleteDialogDescription: string;
+    deleteReasonPlaceholder: string;
+    deleteConfirm: string;
+    deletedToast: string;
+    archiveButton: string;
+    unarchiveButton: string;
+    archivedBanner: (date: string) => string;
+    markPaid: string;
+    markUnpaid: string;
+    paidToast: string;
+    payableAccount: string;
+    noPayableAccount: string;
+    approvalComment: string;
+    approvalCommentPlaceholder: string;
+    runAction: string;
+    noActionsAvailable: string;
+    openSupplier: string;
+}
+export interface InvoiceDetailLabels {
+    review: ReviewBadgeLabels & ReviewCardLabels & ReviewLabels;
+    workflowLadder: WorkflowLadderLabels;
+    workflowHistory: WorkflowHistoryLabels;
+    outgoing: OutgoingInvoiceLabels;
+    history: HistoryLabels;
+    page: InvoiceDetailPageLabels;
+}
+export declare const englishInvoiceDetailLabels: InvoiceDetailLabels;

package/dist/pages/invoice-detail/labels.js

@@ -0,0 +1,139 @@
+const DURATION_UNIT_WORD = {
+    minuten: "minute",
+    stunden: "hour",
+    tage: "day",
+};
+function pluralize(count, word) {
+    return `${count} ${word}${count === 1 ? "" : "s"}`;
+}
+const REASON_TEXT = {
+    brutto_fehlt: () => "The gross amount is missing.",
+    steller_fehlt: () => "The issuer is missing.",
+    summe_stimmt_nicht: () => "Net + VAT does not add up to the total.",
+    ust_satz_ungueltig: () => "The VAT rate is not one of the active rates.",
+    iban_ungueltig: () => "The IBAN's checksum does not check out.",
+    datum_zukunft: () => "The document date is in the future.",
+    rechnungsnr_fehlt: () => "The invoice number is missing.",
+    datum_fehlt: () => "The document date is missing.",
+    iban_fehlt: () => "No IBAN was found to pay this to.",
+    empfaenger_fehlt: () => "The recipient name is missing.",
+    iban_mehrere: (p) => `${p.ibanCount ?? "Several"} IBANs were found; which one is unclear.`,
+    konfidenz_unter_schwelle: (p) => p.confidence ? `Extraction confidence ${p.confidence.found}% is below the ${p.confidence.required}% required.` : "Extraction confidence is below the required threshold.",
+    nicht_relevant: () => "This does not read as an invoice this pipeline handles.",
+    gesellschaft_fehlt: () => "No company could be resolved for this invoice.",
+    manuell_markiert: () => "Marked for review by hand.",
+    keine_ueberweisung_belegt: () => "No transfer proof was found for this payment.",
+    lastschrift_erkannt: () => "This looks like a direct debit, not a transfer.",
+    ocr_ohne_sichtpruefung: () => "OCR text with no visual check yet.",
+    keine_rechnung_bestaetigt: () => "Not yet confirmed as an invoice.",
+    konfidenz_unter_sicherheitsgrenze: () => "Confidence is below the safety floor.",
+    zahlungsnachweis_veraltet: () => "The payment proof is out of date.",
+    nicht_lesbar: () => "The document could not be read.",
+    ausgeschlossen: () => "Excluded by an exclusion rule.",
+};
+export const englishInvoiceDetailLabels = {
+    review: {
+        none: "Reviewed",
+        duplicate: "Duplicate",
+        excluded: "Excluded",
+        alreadyPaid: "Already paid",
+        needed: "Needs review",
+        title: "Needs review",
+        checks: (count) => pluralize(count, "check"),
+        choose: "Choose",
+        fix: "Fix",
+        gateLabel: () => undefined,
+        gateHint: (field) => field,
+        reasonText: (id, params) => REASON_TEXT[id](params),
+        sumComparison: (expected, found) => `Expected ${expected}, document says ${found}.`,
+        formatMoney: (value) => value.toFixed(2),
+    },
+    workflowLadder: {
+        navAriaLabel: "Workflow stage",
+        stepLabel: (step) => step,
+    },
+    workflowHistory: {
+        emptyText: "No history yet.",
+        actorSystem: "System",
+        actingAs: (name) => `acting as ${name}`,
+        reason: "Reason",
+        arrivedLabel: "Arrived",
+        formatDateTime: (iso) => iso,
+        durationShort: (value, unit) => pluralize(value, DURATION_UNIT_WORD[unit]),
+    },
+    outgoing: {
+        banner: (issuer, recipient) => `Outgoing invoice: from ${issuer} to ${recipient}.`,
+        bannerShort: "Outgoing",
+        unknownIssuer: "unknown issuer",
+        unknownRecipient: "unknown recipient",
+    },
+    history: {
+        typeLabel: (type) => type,
+        stateLabel: (targetStatus) => targetStatus,
+        corrected: "Manually corrected",
+        queryAdditional: "Sent back with a query",
+    },
+    page: {
+        backToList: "Back to invoices",
+        notFoundTitle: "Invoice not found",
+        notFoundBody: (id) => `No invoice matches "${id}".`,
+        noInvoiceNumber: "No invoice number",
+        tabOverview: "Overview",
+        tabApproval: "Approval",
+        tabPayment: "Payment",
+        tabDetails: "Details",
+        tabHistory: "History",
+        edit: "Edit",
+        save: "Save",
+        cancel: "Cancel",
+        saving: "Saving…",
+        saved: "Saved.",
+        saveFailed: (error) => `Save failed: ${error}`,
+        fieldIssuer: "Issuer",
+        fieldInvoiceNumber: "Invoice number",
+        fieldOrderNumber: "Order number",
+        fieldDocumentDate: "Document date",
+        fieldDueDate: "Due date",
+        fieldServiceDate: "Service date",
+        fieldAmountNet: "Net amount",
+        fieldVatRate: "VAT rate",
+        fieldVatAmount: "VAT amount",
+        fieldAmountGross: "Gross amount",
+        fieldCurrency: "Currency",
+        fieldCompany: "Company",
+        fieldProperty: "Property",
+        fieldCategory: "Category",
+        fieldRecipientName: "Recipient",
+        fieldCustomerNumber: "Customer number",
+        fieldPaymentReference: "Payment reference",
+        fieldPaymentMethod: "Payment method",
+        fieldTaxNote: "Tax note",
+        fieldServiceDescription: "Service description",
+        unsavedTitle: "Unsaved changes",
+        unsavedBody: (fields) => `You have unsaved changes to: ${fields}. Discard them?`,
+        unsavedDiscard: "Discard",
+        unsavedKeepEditing: "Keep editing",
+        addNotePlaceholder: "Add a note…",
+        addNoteButton: "Add note",
+        noteAdded: "Note added.",
+        deleteButton: "Delete",
+        deleteDialogTitle: "Delete this invoice?",
+        deleteDialogDescription: "This moves the invoice to trash. It can be restored later.",
+        deleteReasonPlaceholder: "Reason (optional)",
+        deleteConfirm: "Delete",
+        deletedToast: "Invoice deleted.",
+        archiveButton: "Archive",
+        unarchiveButton: "Restore from archive",
+        archivedBanner: (date) => `Archived on ${date}.`,
+        markPaid: "Mark as paid",
+        markUnpaid: "Mark as unpaid",
+        paidToast: "Payment status updated.",
+        payableAccount: "Payable account",
+        noPayableAccount: "No payable account on file.",
+        approvalComment: "Comment",
+        approvalCommentPlaceholder: "Add a comment (optional)…",
+        runAction: "Confirm",
+        noActionsAvailable: "No approval action is available right now.",
+        openSupplier: "View supplier",
+    },
+};

package/dist/pages/invoice-detail/pipeline-types.d.ts

@@ -0,0 +1,58 @@
+export interface Confidence {
+    issuer?: number;
+    invoiceNumber?: number;
+    documentDate?: number;
+    amountNet?: number;
+    vatAmount?: number;
+    amountGross?: number;
+    companyCode?: number;
+    propertyCode?: number;
+    [field: string]: number | undefined;
+}
+export interface Validation {
+    summe_ok?: boolean;
+    datum_vorhanden?: boolean;
+    brutto_vorhanden?: boolean;
+    steller_vorhanden?: boolean;
+    rechnungsnr_vorhanden?: boolean;
+    ust_satz_ok?: boolean | null;
+    iban_ok?: boolean | null;
+    datum_plausibel?: boolean | null;
+    kleinbetrag?: boolean;
+    decision_reason?: string;
+    [field: string]: unknown;
+}
+export interface Extracted {
+    konfidenz?: Confidence;
+    validation_detail?: Record<string, unknown> | null;
+    validation?: Validation | null;
+    richtung?: string | null;
+    zwischensumme_brutto?: number | string | null;
+    iban?: string | null;
+    review_checks?: unknown;
+    [field: string]: unknown;
+}
+export interface InvoiceReviewFields {
+    extracted: Extracted | null;
+    validation: Validation | null;
+    validation_detail?: Record<string, unknown> | null;
+    status: string | null;
+    issuer: string | null;
+    document_date: string | null;
+    invoice_number: string | null;
+    amount_net: number | null;
+    vat_amount: number | null;
+    amount_gross: number | null;
+    vat_rate: number | null;
+    recipient_name: string | null;
+    company_code: string | null;
+}
+export interface InvoiceHistoryEntry {
+    id: number;
+    invoiceId: string;
+    type: string;
+    text: string | null;
+    data: Record<string, unknown> | null;
+    actor: string | null;
+    createdAt: string;
+}

package/dist/pages/invoice-detail/pipeline-types.js

@@ -0,0 +1 @@
+export {};

package/dist/pages/invoice-detail/review-recheck.d.ts

@@ -0,0 +1,8 @@
+import { InvoiceReviewFields } from "./pipeline-types";
+export declare function ibanCandidates(raw: string | null | undefined): string[];
+export declare function ibanChecksumValid(candidate: string): boolean;
+export declare function invoiceRechecked<T extends InvoiceReviewFields>(invoice: T, opts?: {
+    supplierIban?: string | null;
+    actor?: string | null;
+    now?: string;
+}): T;

package/dist/pages/invoice-detail/review-recheck.js

@@ -0,0 +1,103 @@
+import { SOURCE_HUMAN, validationBase, writeValidationDetail, } from "./review.js";
+const IBAN_CHARS = /^[A-Z0-9]{15,34}$/;
+const IBAN_SEPARATOR = /[;,/|]|\s{2,}|\bund\b/i;
+export function ibanCandidates(raw) {
+    if (!raw)
+        return [];
+    return String(raw)
+        .split(new RegExp(IBAN_SEPARATOR.source, "gi"))
+        .map((part) => (part ?? "").trim())
+        .filter(Boolean);
+}
+export function ibanChecksumValid(candidate) {
+    const s = candidate.trim().toUpperCase().replace(/\s/g, "");
+    if (!IBAN_CHARS.test(s))
+        return false;
+    if (!/^[A-Z]{2}[0-9]{2}/.test(s))
+        return false;
+    const rearranged = s.slice(4) + s.slice(0, 4);
+    let expanded = "";
+    for (const c of rearranged) {
+        const value = parseInt(c, 36);
+        if (Number.isNaN(value))
+            return false;
+        expanded += String(value);
+    }
+    return BigInt(expanded) % 97n === 1n;
+}
+const SUM_TOLERANCE = 0.02;
+function statusFor(ok) {
+    if (ok === null)
+        return "not_applicable";
+    return ok ? "ok" : "failed";
+}
+function num(v) {
+    const n = typeof v === "string" ? Number(v) : v;
+    return typeof n === "number" && Number.isFinite(n) ? n : null;
+}
+function applied(entry) {
+    return (entry?.status ?? "").trim().toLowerCase() !== "not_applicable";
+}
+function ibanSource(invoice, supplierIban) {
+    const own = (supplierIban ?? "").trim();
+    if (own)
+        return own;
+    const fromDocument = invoice.extracted?.iban;
+    return typeof fromDocument === "string" ? fromDocument : null;
+}
+function results(invoice, pipeline, supplierIban, today) {
+    const net = num(invoice.amount_net);
+    const vat = num(invoice.vat_amount);
+    const gross = num(invoice.amount_gross);
+    const subtotal = num(invoice.extracted?.zwischensumme_brutto) ?? gross;
+    const rate = num(invoice.vat_rate);
+    const activeRates = pipeline.vat_rate_valid?.values?.active_rates
+        ?.map(num)
+        .filter((n) => n != null);
+    const candidates = ibanCandidates(ibanSource(invoice, supplierIban));
+    const count = candidates.length;
+    return {
+        iban_checksum_valid: count === 0 ? null : candidates.every(ibanChecksumValid),
+        payable_iban_present: applied(pipeline.payable_iban_present) ? count > 0 : null,
+        iban_unambiguous: applied(pipeline.iban_unambiguous) && count > 0 ? count <= 1 : null,
+        gross_present: gross != null,
+        issuer_present: !!(invoice.issuer ?? "").trim(),
+        date_present: !!(invoice.document_date ?? "").trim(),
+        invoice_number_present: !!(invoice.invoice_number ?? "").trim(),
+        sum_matches: subtotal != null && net != null && vat != null
+            ? Math.abs(net + vat - subtotal) <= SUM_TOLERANCE
+            : null,
+        vat_rate_valid: rate == null || !activeRates?.length ? null : activeRates.includes(Math.round(rate)),
+        date_not_future: invoice.document_date ? invoice.document_date.slice(0, 10) <= today : null,
+        recipient_present: applied(pipeline.recipient_present) ? !!(invoice.recipient_name ?? "").trim() : null,
+        assignment_resolved: !!(invoice.company_code ?? "").trim(),
+    };
+}
+export function invoiceRechecked(invoice, opts = {}) {
+    const base = validationBase(invoice);
+    if (!base)
+        return invoice;
+    const now = opts.now ?? new Date().toISOString();
+    const next = results(invoice, base, opts.supplierIban ?? null, now.slice(0, 10));
+    const corrections = {};
+    for (const [field, ok] of Object.entries(next)) {
+        const original = base[field];
+        if (!original)
+            continue;
+        const newStatus = statusFor(ok);
+        if (newStatus === (original.status ?? "").trim().toLowerCase())
+            continue;
+        corrections[field] = {
+            ...original,
+            status: newStatus,
+            message: "Re-checked against the current data.",
+            source: SOURCE_HUMAN,
+            edited_at: now,
+            edited_by: opts.actor ?? null,
+        };
+    }
+    return {
+        ...invoice,
+        validation_detail: writeValidationDetail(base, corrections),
+    };
+}

package/dist/pages/invoice-detail/review.d.ts

@@ -0,0 +1,91 @@
+import { InvoiceReviewFields, Validation } from "./pipeline-types";
+export type ValidationGateKey = "brutto_vorhanden" | "steller_vorhanden" | "datum_vorhanden" | "rechnungsnr_vorhanden" | "summe_ok" | "ust_satz_ok" | "iban_ok" | "datum_plausibel";
+export declare const VALIDATION_GATES: ValidationGateKey[];
+export type ReviewReasonId = "brutto_fehlt" | "steller_fehlt" | "summe_stimmt_nicht" | "ust_satz_ungueltig" | "iban_ungueltig" | "datum_zukunft" | "rechnungsnr_fehlt" | "datum_fehlt" | "iban_fehlt" | "empfaenger_fehlt" | "iban_mehrere" | "konfidenz_unter_schwelle" | "nicht_relevant" | "gesellschaft_fehlt" | "manuell_markiert" | "keine_ueberweisung_belegt" | "lastschrift_erkannt" | "ocr_ohne_sichtpruefung" | "keine_rechnung_bestaetigt" | "konfidenz_unter_sicherheitsgrenze" | "zahlungsnachweis_veraltet" | "nicht_lesbar" | "ausgeschlossen";
+export interface ReviewCheck {
+    field?: string;
+    status?: string;
+    severity?: string;
+    message?: string;
+    values?: Record<string, unknown>;
+}
+export declare const SEVERITY_INFORMATIONAL = "informational";
+export declare const SEVERITY_ACTION_REQUIRED = "action_required";
+export declare function reviewChecks(invoice: Pick<InvoiceReviewFields, "extracted">): ReviewCheck[] | null;
+export interface ValidationDetailEntry {
+    field?: string;
+    status?: string;
+    values?: Record<string, unknown>;
+    message?: string;
+    source?: string;
+    edited_at?: string;
+    edited_by?: string | null;
+}
+export type ValidationDetail = Record<string, ValidationDetailEntry>;
+export declare const VALIDATION_FIELD_REASON: Record<string, ReviewReasonId>;
+export declare const REVIEW_CHECK_REASON: Record<string, ReviewReasonId>;
+export declare const SOURCE_HUMAN = "human";
+export declare function isManuallyCorrected(entry: ValidationDetailEntry | undefined): boolean;
+export declare function validationBase(invoice: Pick<InvoiceReviewFields, "extracted" | "validation_detail">): ValidationDetail | null;
+export declare function validationCorrections(invoice: Pick<InvoiceReviewFields, "extracted" | "validation_detail">): ValidationDetail | null;
+export declare function validationDetail(invoice: Pick<InvoiceReviewFields, "extracted" | "validation_detail">): ValidationDetail | null;
+export declare function writeValidationDetail(base: ValidationDetail | null, corrections: ValidationDetail | null): Record<string, unknown>;
+export declare function validationFlat(invoice: Pick<InvoiceReviewFields, "extracted" | "validation">): Validation;
+export interface ReviewReason {
+    id: ReviewReasonId | null;
+    field: string;
+    severity?: string;
+    message?: string;
+    values?: Record<string, unknown>;
+}
+export declare function reviewReasonsDetail(invoice: Pick<InvoiceReviewFields, "validation" | "extracted" | "validation_detail">): ReviewReason[];
+export declare function reviewReasonNumbers(reason: ReviewReason): {
+    expected: number;
+    found: number;
+} | null;
+export interface ReviewSummary {
+    reasons: ReviewReason[];
+    passed: {
+        field: string;
+        id: ReviewReasonId | null;
+    }[];
+}
+export declare function buildReviewSummary(invoice: Pick<InvoiceReviewFields, "validation" | "extracted" | "validation_detail">): ReviewSummary;
+export declare function reviewReasonConfidence(reason: ReviewReason): {
+    found: number;
+    required: number;
+} | null;
+export declare function reviewReasonIbanCount(reason: ReviewReason): number | null;
+export declare function reviewReasonIds(invoice: Pick<InvoiceReviewFields, "validation" | "extracted" | "validation_detail">): ReviewReasonId[];
+export declare function reviewScore(invoice: Pick<InvoiceReviewFields, "validation" | "status" | "extracted" | "validation_detail">): number;
+export declare function withoutEmDash(text: string): string;
+export interface ReviewLine {
+    field: string;
+    title?: string;
+    text: string;
+    numbers?: string;
+    severity?: string;
+    jumpTo?: {
+        tab: string;
+        anchor: string;
+    };
+}
+export interface ReviewLabels {
+    gateLabel: (field: string) => string | undefined;
+    gateHint: (field: string) => string;
+    reasonText: (id: ReviewReasonId, params: {
+        confidence?: {
+            found: number;
+            required: number;
+        };
+        ibanCount?: number;
+    }) => string;
+    sumComparison: (expected: string, found: string) => string;
+    formatMoney: (value: number) => string;
+}
+export declare function reviewLines(reasons: ReviewReason[], labels: ReviewLabels, jumpTargets: Record<string, {
+    tab: string;
+    anchor: string;
+}>): ReviewLine[];
+export declare function reviewCheckLabelDe(field: string, labelDe: (field: string) => string | undefined): string;
+export declare function hasNoReviewChecks(invoice: Pick<InvoiceReviewFields, "validation" | "extracted" | "validation_detail">): boolean;