@auditcore/ui-core 0.3.0

package/dist/download.d.ts

@@ -0,0 +1,14 @@
+/** Text als Datei anbieten (Blob-URL); ohne Blob-Unterstützung geschieht nichts. */
+export declare function downloadText(content: string, filename: string, mimeType: string): boolean;
+/**
+ * Druckansicht in einem unsichtbaren Rahmen öffnen („Als PDF speichern“ im
+ * Druckdialog). Kein Pop-up, daher auch mit Pop-up-Blocker nutzbar.
+ */
+export declare function printHtml(html: string): HTMLIFrameElement;
+/** Export ausliefern: Druckansicht (`print`) oder Datei. */
+export declare function deliverExport(payload: {
+    format: string;
+    content: string;
+    filename: string;
+    mimeType: string;
+}): void;

package/dist/extraction/controller.d.ts

@@ -0,0 +1,34 @@
+import { RequestState } from '../store';
+import { ExtractionCatalogue, ExtractionPort, ExtractionRun } from './types';
+export type ExtractionBusy = 'load' | 'run';
+export type ExtractionValidation = 'needFile' | 'tooLarge' | 'profile' | null;
+export interface ExtractionCallbacks {
+    completed?: (result: ExtractionRun) => void;
+    failed?: (message: string) => void;
+}
+export interface ExtractionData extends RequestState<string> {
+    catalogue: ExtractionCatalogue | null;
+    profileId: string | null;
+    file: Blob | null;
+    filename: string;
+    result: ExtractionRun | null;
+    validation: ExtractionValidation;
+}
+export interface ExtractionSource {
+    port: () => ExtractionPort | null | undefined;
+    callbacks?: () => ExtractionCallbacks;
+}
+export declare const INITIAL_EXTRACTION: ExtractionData;
+/** Prüfung vor dem Senden (reine Funktion). */
+export declare function extractionValidation(state: ExtractionData): ExtractionValidation;
+export declare function createExtractionController(source: ExtractionSource): {
+    store: import('..').Store<ExtractionData>;
+    load: () => Promise<void>;
+    extract: () => Promise<void>;
+    /** Datei wählen (`null` = Auswahl aufheben). */
+    selectFile: (file: File | null) => void;
+    setProfile: (profileId: string | null) => void;
+    /** Vorhandenes Ergebnis anzeigen (Eigenschaft `result`). */
+    showResult: (result: ExtractionRun | null) => void;
+};
+export type ExtractionController = ReturnType<typeof createExtractionController>;

package/dist/extraction/index.d.ts

@@ -0,0 +1,5 @@
+export { extractionMessages, type ExtractionMessageKey } from './messages';
+export { createExtractionRestPort } from './rest-port';
+export type * from './types';
+export * from './controller';
+export * from './view';

package/dist/extraction/messages.d.ts

@@ -0,0 +1,3 @@
+/** Texte der Belegerkennung (`<flowaudit-extraction>`). */
+export declare const extractionMessages: import('..').Catalogs<"loading" | "notice" | "title" | "profile" | "noPort" | "colDecision" | "result" | "failed" | "recommended" | "run" | "file" | "colValue" | "errorprofile" | "disabled" | "upload" | "fileHelp" | "unavailable" | "experimental" | "retention" | "errorneedFile" | "errortooLarge" | "statusok" | "statusreview_needed" | "statusrejected" | "statusfailed" | "statusOther" | "runError" | "retryable" | "document" | "documentValue" | "pages" | "ocr" | "ocrValue" | "qualityok" | "qualityreview" | "qualityrejected" | "fields" | "colField" | "colConfidence" | "noValue" | "noFields" | "confidenceHelp" | "decisionaccepted" | "decisionrejected" | "decisionunconfirmed" | "decisiondisagreement" | "decisionnot_taken" | "proposal" | "findings" | "findingsNone" | "passed" | "colRule" | "colSeverity" | "colOutcome" | "colMessage" | "severityINFO" | "severityWARN" | "severityCRITICAL" | "outcomePASS" | "outcomeFAIL" | "outcomeREVIEW" | "flags" | "pagesText" | "pageLabel" | "field_invoice_number" | "field_date" | "field_supply_date" | "field_due_date" | "field_supplier_name" | "field_net_amount" | "field_vat_amount" | "field_total" | "field_iban" | "field_bic" | "field_vat_id" | "field_vat_rates" | "rule_VAL_IBAN_CHECKSUM" | "rule_VAL_VAT_ID_FORMAT" | "rule_VAL_TOTAL_PLAUSIBILITY" | "rule_VAL_OCR_CONFIDENCE" | "rule_VAL_FRAUD_DETECTION" | "rule_VAL_AMOUNT_FORMAT" | "rule_VAL_DONUT_PLAUSIBILITY" | "rule_VAL_DONUT_DISAGREEMENT">;
+export type ExtractionMessageKey = keyof typeof extractionMessages.de;

package/dist/extraction/rest-port.d.ts

@@ -0,0 +1,4 @@
+import { RestOptions } from '@auditcore/common';
+import { ExtractionPort } from './types';
+/** Port auf den REST-Vertrag `documents_extraction/1` von `auditcore_documents.web` (Starlette oder FastAPI). */
+export declare function createExtractionRestPort(options: RestOptions): ExtractionPort;

package/dist/extraction/types.d.ts

@@ -0,0 +1,115 @@
+/** Typen des REST-Vertrags `documents_extraction/1` (`docs/ui/extraction-rest.md`, auditcore_documents.web). */
+export interface ExtractionProfile {
+    id: string;
+    version: string;
+    fingerprint: string;
+    label: string;
+    status: string;
+    ocr_backend: string | null;
+    recommended: boolean;
+    min_field_confidence: number | null;
+    available: boolean;
+    retention_categories: readonly string[];
+}
+export interface ExtractionCatalogue {
+    contract: string;
+    library: string;
+    enabled: boolean;
+    engines: Readonly<Record<'router' | 'chandra' | 'tesseract' | 'donut', boolean>>;
+    profiles: readonly ExtractionProfile[];
+    default_profile: string | null;
+    accepted_types: readonly string[];
+    limits: {
+        max_upload_bytes: number;
+    };
+    thresholds: {
+        ok: number;
+        review: number;
+    };
+    retention: {
+        stored: boolean;
+        days: Readonly<Record<string, number>>;
+    };
+}
+export type ExtractionRunStatus = 'queued' | 'running' | 'ok' | 'review_needed' | 'rejected' | 'failed' | (string & {});
+export type ExtractionOcrQuality = 'ok' | 'review' | 'rejected';
+export type ExtractionFieldDecision = 'accepted' | 'rejected' | 'unconfirmed' | 'not_taken' | (string & {});
+export type ExtractionJson = string | number | boolean | null | readonly ExtractionJson[] | {
+    readonly [key: string]: ExtractionJson;
+};
+export interface ExtractedField {
+    name: string;
+    value: ExtractionJson;
+    raw: ExtractionJson;
+    /** Feldkonfidenz des Donut-Modells; `null` ohne Donut. */
+    confidence: number | null;
+    decision: ExtractionFieldDecision | null;
+    proposal: ExtractionJson;
+    text_match: boolean | null;
+    checks: readonly ExtractionJson[];
+}
+export interface ExtractionFinding {
+    rule_id: string;
+    rule_name: string;
+    severity: 'INFO' | 'WARN' | 'CRITICAL';
+    outcome: 'PASS' | 'FAIL' | 'REVIEW';
+    message: string;
+    evidence: ExtractionJson;
+}
+export interface ExtractionOcrSummary {
+    engine: string;
+    avg_confidence: number;
+    min_confidence: number;
+    max_confidence: number;
+    pages_processed: number;
+    pages_failed: number;
+    duration_ms: number;
+    retries: number;
+    quality: ExtractionOcrQuality;
+}
+export interface ExtractionRun {
+    contract: string;
+    library: string;
+    profile: {
+        id: string;
+        version: string;
+        fingerprint: string;
+        status: string;
+    };
+    run: {
+        run_id: string;
+        status: ExtractionRunStatus;
+        needs_review: boolean;
+        error_code: string | null;
+        error: string | null;
+        retryable: boolean;
+        completed_stages: readonly string[];
+        hash_chain: readonly string[];
+        duration_ms: number | null;
+    };
+    document: {
+        filename: string;
+        sha256: string;
+        size_bytes: number | null;
+        mime_type: string | null;
+        page_count: number | null;
+    };
+    ocr: ExtractionOcrSummary | null;
+    pages: readonly {
+        page: number;
+        confidence: number | null;
+        text: string;
+    }[];
+    fields: readonly ExtractedField[];
+    findings: readonly ExtractionFinding[];
+    flags: readonly string[];
+    stored: boolean;
+}
+/**
+ * Schnittstelle der Komponente zur Fachlogik; Standardumsetzung:
+ * `createExtractionRestPort`. Die Oberfläche erkennt nichts selbst.
+ */
+export interface ExtractionPort {
+    catalogue(): Promise<ExtractionCatalogue>;
+    run(file: Blob, filename: string, profile: string): Promise<ExtractionRun>;
+}

package/dist/extraction/view.d.ts

@@ -0,0 +1,35 @@
+import { Locale, Translate } from '../i18n';
+import { ExtractionMessageKey } from './messages';
+import { ExtractedField, ExtractionCatalogue, ExtractionProfile, ExtractionRun, ExtractionJson, ExtractionFinding } from './types';
+export type ExtractionTranslate = Translate<ExtractionMessageKey>;
+export type ExtractionTone = 'success' | 'warning' | 'danger' | 'neutral';
+/** Dateigröße in MiB (bzw. KiB unter 1 MiB). */
+export declare function extractionSizeText(bytes: number, locale: Locale): string;
+export declare function extractionProfileText(profile: ExtractionProfile, t: ExtractionTranslate): string;
+export declare function extractionFieldLabel(name: string, t: ExtractionTranslate): string;
+export declare function extractionRuleLabel(finding: ExtractionFinding, t: ExtractionTranslate): string;
+/** Wert eines Feldes als Text (Zahlen sprachabhängig, Listen mit Komma). */
+export declare function extractionValueText(value: ExtractionJson, locale: Locale): string;
+export declare function extractionConfidenceText(value: number | null, locale: Locale): string;
+/** Ton einer Feldkonfidenz gegen den Schwellwert des Profils. */
+export declare function extractionConfidenceTone(value: number | null, threshold: number | null): ExtractionTone;
+export declare function extractionDecisionText(field: ExtractedField, t: ExtractionTranslate): string;
+export declare function extractionDecisionTone(field: ExtractedField): ExtractionTone;
+export declare function extractionStatusText(result: ExtractionRun, t: ExtractionTranslate): string;
+export declare function extractionStatusTone(result: ExtractionRun): ExtractionTone;
+export declare function extractionDocumentText(result: ExtractionRun, t: ExtractionTranslate): string;
+export declare function extractionOcrText(result: ExtractionRun, t: ExtractionTranslate, locale: Locale): string;
+/** Auffällige Befunde (nicht bestanden, prüfen) zuerst nach Gewicht; bestandene getrennt. */
+export declare function splitExtractionFindings(findings: readonly ExtractionFinding[]): {
+    open: ExtractionFinding[];
+    passed: ExtractionFinding[];
+};
+export declare function extractionOutcomeTone(finding: ExtractionFinding): ExtractionTone;
+/** Schwellwert der Feldkonfidenz des gelaufenen Profils (nur Donut). */
+export declare function extractionFieldThreshold(catalogue: ExtractionCatalogue | null, result: ExtractionRun): number | null;
+/** Dateiauswahl der Oberfläche (`accept`) aus den zulässigen Typen. */
+export declare function extractionAccept(catalogue: ExtractionCatalogue | null): string;
+/** Donut-Vorschlag, wenn er nicht übernommen wurde (sonst leer). */
+export declare function extractionProposalText(field: ExtractedField, t: ExtractionTranslate, locale: Locale): string;
+/** Meldung zur Prüfung vor dem Senden. */
+export declare function extractionValidationText(validation: 'needFile' | 'tooLarge' | 'profile', catalogue: ExtractionCatalogue | null, t: ExtractionTranslate, locale: Locale): string;

package/dist/extrapolation/controller-subsample.d.ts

@@ -0,0 +1,20 @@
+import { Store } from '../store';
+import { ExtrapolationData } from './controller';
+import { SubItemRow, SubsampleRows, SubStratumRow } from './model-subsample';
+/** Gerade bearbeitete Teilstichprobe: die der Einheit oder die einer ihrer Teileinheiten. */
+export declare function openSubsample(state: ExtrapolationData): SubsampleRows | null;
+export declare function createSubsampleActions(store: Store<ExtrapolationData>, key: (prefix: string) => string): {
+    /** Teilstichprobe anlegen und öffnen bzw. entfernen (der Fehler kommt dann wieder aus dem Feld). */
+    toggleSubsample(index: number): void;
+    editSubsample: (index: number | null) => void;
+    /** Teilstichprobe einer Teileinheit anlegen bzw. entfernen (nur in der Teilstichprobe der Einheit). */
+    toggleNestedSubsample(item: number): void;
+    editNestedSubsample: (item: number | null) => void;
+    updateSubsample: (change: Partial<Pick<SubsampleRows, "estimator" | "populationSize">>) => void;
+    addSubStratum: () => void;
+    updateSubStratum: (index: number, change: Partial<SubStratumRow>) => void;
+    removeSubStratum: (index: number) => void;
+    addSubItem: () => void;
+    updateSubItem: (item: number, change: Partial<SubItemRow>) => void;
+    removeSubItem: (item: number) => void;
+};

package/dist/extrapolation/controller.d.ts

@@ -0,0 +1,72 @@
+import { DownloadFile } from '@auditcore/common';
+import { RequestState, Store } from '../store';
+import { ExtrapolationForm, ExtrapolationFormError, ExtrapolationIssues, ResidualForm, StratumRow, UnitRow } from './model';
+import { EvaluationRequest, EvaluationResult, ExtrapolationCatalogue, ExtrapolationExportFormat, ExtrapolationMethod, ExtrapolationPort, ResidualResult, StratumInput, UnitInput } from './types';
+export type ExtrapolationBusy = 'load' | 'evaluate' | 'residual' | 'export';
+export interface ExtrapolationCallbacks {
+    evaluated?: (result: EvaluationResult) => void;
+    residualComputed?: (result: ResidualResult) => void;
+    failed?: (message: string) => void;
+}
+/** Stand der Hochrechnung; `error` ist die Meldung der letzten abgelehnten Anfrage. */
+export interface ExtrapolationData extends RequestState<string> {
+    catalogue: ExtrapolationCatalogue | null;
+    form: ExtrapolationForm;
+    formError: ExtrapolationFormError | null;
+    issues: ExtrapolationIssues;
+    result: EvaluationResult | null;
+    lastRequest: EvaluationRequest | null;
+    residualForm: ResidualForm;
+    residualIssues: ExtrapolationIssues;
+    residual: ResidualResult | null;
+    /** Einheit, deren Teilstichprobe gerade bearbeitet wird. */
+    subsampleUnit: number | null;
+    /** Teileinheit dieser Teilstichprobe, deren eigene Teilstichprobe bearbeitet wird (dreistufig). */
+    subsampleItem: number | null;
+}
+export interface ExtrapolationSource {
+    port: () => ExtrapolationPort | null | undefined;
+    strata: () => readonly StratumInput[];
+    units: () => readonly UnitInput[];
+    /** Zahl → Eingabetext im Sprachformat. */
+    format: (value: number) => string;
+    callbacks?: () => ExtrapolationCallbacks;
+}
+export declare const INITIAL_EXTRAPOLATION: ExtrapolationData;
+export declare function extrapolationMethod(state: ExtrapolationData): ExtrapolationMethod | null;
+export declare function createExtrapolationController(source: ExtrapolationSource): {
+    setConfidence: (confidence: number | null) => void;
+    setProfile: (profileId: string | null) => void;
+    setSampleSize: (sampleSize: string) => void;
+    setMateriality: (materiality: string) => void;
+    setDesign: (design: ExtrapolationForm["design"]) => void;
+    setSystemAssessment: (systemAssessment: string) => void;
+    setPopulationUnits: (populationUnits: string) => void;
+    setResidual: (patch: Partial<ResidualForm>) => void;
+    toggleSubsample(index: number): void;
+    editSubsample: (index: number | null) => void;
+    toggleNestedSubsample(item: number): void;
+    editNestedSubsample: (item: number | null) => void;
+    updateSubsample: (change: Partial<Pick<import('./model-subsample').SubsampleRows, "estimator" | "populationSize">>) => void;
+    addSubStratum: () => void;
+    updateSubStratum: (index: number, change: Partial<import('./model-subsample').SubStratumRow>) => void;
+    removeSubStratum: (index: number) => void;
+    addSubItem: () => void;
+    updateSubItem: (item: number, change: Partial<import('./model-subsample').SubItemRow>) => void;
+    removeSubItem: (item: number) => void;
+    patchForm: (patch: Partial<ExtrapolationForm>) => void;
+    addStratum: () => void;
+    updateStratum: (index: number, patch: Partial<StratumRow>) => void;
+    removeStratum: (index: number) => void;
+    addUnit: () => void;
+    updateUnit: (index: number, patch: Partial<UnitRow>) => void;
+    removeUnit: (index: number) => void;
+    evaluate: () => Promise<void>;
+    computeResidual: () => Promise<void>;
+    exportEvaluation: (format: ExtrapolationExportFormat) => Promise<DownloadFile | null>;
+    store: Store<ExtrapolationData>;
+    load: () => Promise<void>;
+    applyInputs: () => void;
+    selectMethod: (methodId: string) => void;
+};
+export type ExtrapolationController = ReturnType<typeof createExtrapolationController>;

package/dist/extrapolation/index.d.ts

@@ -0,0 +1,9 @@
+export { extrapolationMessages, type ExtrapolationMessageKey } from './messages';
+export * from './model';
+export { createExtrapolationRestPort } from './rest-port';
+export type * from './types';
+export * from './controller';
+export * from './view';
+export * from './model-design';
+export * from './model-subsample';
+export * from './view-details';

package/dist/extrapolation/messages.d.ts

@@ -0,0 +1,3 @@
+/** Texte der Hochrechnung (TER) und der Restfehlerquote (RER). */
+export declare const extrapolationMessages: import('..').Catalogs<"close" | "loading" | "title" | "settings" | "method" | "exportCsv" | "explanation" | "failed" | "choose" | "colName" | "remove" | "fingerprint" | "colLabel" | "confidence" | "derivation" | "sampleSize" | "stratum" | "colValue" | "exportJson" | "errorprofile" | "statistical" | "nonStatistical" | "methodSource" | "factorProfile" | "sampleSizeHint" | "materiality" | "materialityHint" | "strata" | "strataHint" | "stratumName" | "bookValue" | "populationSize" | "systemicDelimited" | "addStratum" | "removeRow" | "units" | "unitsHint" | "unitId" | "randomError" | "systemicError" | "anomalousError" | "anomalousReason" | "anomalousCorrected" | "exhaustive" | "addUnit" | "noUnits" | "cellLabel" | "evaluate" | "issueRequired" | "issueInvalid" | "issueRange" | "issueReason" | "issueStratum" | "issueDuplicate" | "formIncomplete" | "errormethod" | "errorconfidence" | "errorstrata" | "errorunits" | "resultTitle" | "resultNotice" | "projected" | "systemic" | "anomalousUncorrected" | "anomalousExcluded" | "totalError" | "ter" | "tolerable" | "precision" | "upperLimit" | "notDeterminable" | "correctedBookValue" | "lowerLimit" | "warnings" | "colStep" | "colFormula" | "colSource" | "residualTitle" | "residualNotice" | "auditPopulation" | "terRate" | "ongoing" | "otherNegative" | "corrections" | "computeResidual" | "rer" | "rerExceeds" | "rerWithin" | "extrapolatedCorrection" | "rateAfter" | "colRow" | "colAmount" | "notApplicable" | "design" | "designsingle" | "designperiods" | "designgroups" | "designHint" | "systemAssessment" | "systemAssessmentHint" | "systemNone" | "populationUnits" | "populationUnitsHint" | "period" | "group" | "groupOptional" | "errorperiods" | "subsample" | "subsampleCreate" | "subsampleOpen" | "subsampleDrop" | "fromSubsample" | "subsampleTitle" | "subsampleHint" | "estimator" | "estimatorratio" | "estimatormean_per_unit" | "estimatorpps" | "subPopulation" | "subItems" | "subItemId" | "subStratum" | "subStrata" | "subStrataHint" | "addSubStratum" | "subsampleNestedTitle" | "nestedCreate" | "nestedOpen" | "nestedDrop" | "backToUnit" | "addSubItem" | "detailsPeriods" | "detailsGroups" | "detailsSubsamples" | "recalcTitle" | "recalcLevel" | "recalcCoefficient" | "recalcRequired" | "recalcSupports" | "recalcNotSupported" | "recalcNoRequirement" | "colBookValue" | "colProjected" | "colPrecision" | "colSampleSize" | "colObservations" | "colTer" | "colUpper" | "colConclusion" | "colRate" | "colCoverage" | "colItems">;
+export type ExtrapolationMessageKey = keyof typeof extrapolationMessages.de;

package/dist/extrapolation/model-design.d.ts

@@ -0,0 +1,28 @@
+import { ExtrapolationDesign, StratumInput } from './types';
+export type DesignIssue = 'required' | 'invalid' | 'range' | 'reason' | 'stratum' | 'duplicate';
+export interface DesignRule {
+    required?: boolean;
+    positive?: boolean;
+    integer?: boolean;
+    max?: number;
+}
+/** Sammelt Feldbefunde (von `model.ts` bereitgestellt). */
+export interface IssueSink {
+    take(key: string, text: string, rule?: DesignRule): number;
+    flag(key: string, issue: DesignIssue): void;
+}
+/** Aufbau aus vorbelegten Schichten: Zeitraum oder Gruppe gesetzt? */
+export declare function designOf(strata: readonly StratumInput[]): ExtrapolationDesign;
+export declare function stratumPart(stratum: StratumInput): string;
+/** Zeiträume in der Reihenfolge ihres ersten Auftretens. */
+export declare function periodNames(parts: readonly string[]): string[];
+/** Ergänzungen der Anfrage je Aufbau (Zeitraumliste, Zahl der Einheiten, Systembewertung). */
+export declare function designRequest(design: ExtrapolationDesign, parts: readonly string[], populationUnits: string, systemAssessment: string, out: IssueSink): {
+    system_assessment?: number | undefined;
+    population_units?: number | undefined;
+    periods?: {
+        name: string;
+    }[] | undefined;
+};
+/** Schlüssel einer Schicht für die Zuordnung der Einheiten (je Zeitraum eindeutig). */
+export declare function stratumKey(design: ExtrapolationDesign, part: string, name: string): string;

package/dist/extrapolation/model-subsample.d.ts

@@ -0,0 +1,40 @@
+import { IssueSink } from './model-design';
+import { SubsampleEstimator, SubsampleInput } from './types';
+export declare const SAMPLED_PART = "Stichprobe";
+export declare const EXHAUSTIVE_PART = "Vollerhebung";
+/** Einheit (Stufe 1) → Teileinheit (Stufe 2) → Teileinheit (Stufe 3). */
+export declare const MAX_SUBSAMPLE_DEPTH = 2;
+export interface SubStratumRow {
+    key: string;
+    name: string;
+    bookValue: string;
+    populationSize: string;
+}
+export interface SubItemRow {
+    key: string;
+    id: string;
+    /** Teilschicht (nur mit eigenen Teilschichten). */
+    stratum: string;
+    bookValue: string;
+    random: string;
+    exhaustive: boolean;
+    /** Teilstichprobe der Teileinheit (dreistufig). */
+    subsample: SubsampleRows | null;
+}
+export interface SubsampleRows {
+    estimator: SubsampleEstimator;
+    /** Anzahl Teileinheiten der Stichprobenschicht (einfache Form, Mittelwertschätzung). */
+    populationSize: string;
+    /** Eigene Teilschichten; leer = einfache Form. */
+    strata: readonly SubStratumRow[];
+    items: readonly SubItemRow[];
+}
+export declare function emptySubItem(key: string, stratum?: string): SubItemRow;
+export declare function emptySubStratum(key: string): SubStratumRow;
+export declare function emptySubsample(): SubsampleRows;
+type Format = (value: number) => string;
+/** Formularzeilen einer vorbelegten Teilstichprobe (einfache Form oder mit Teilschichten). */
+export declare function subsampleRows(sub: SubsampleInput | undefined, format: Format, prefix?: string): SubsampleRows | null;
+/** Teilstichprobe für die Anfrage (`depth` 1 = Teilstichprobe der Einheit). */
+export declare function readSubsample(rows: SubsampleRows, unitBook: number, key: string, out: IssueSink, depth?: number): SubsampleInput;
+export {};

package/dist/extrapolation/model.d.ts

@@ -0,0 +1,92 @@
+import { SubsampleRows } from './model-subsample';
+import { EvaluationRequest, EvaluationResult, ExtrapolationCatalogue, ExtrapolationDesign, ExtrapolationMethod, ResidualRequest, StratumInput, UnitInput } from './types';
+export interface StratumRow {
+    key: string;
+    name: string;
+    bookValue: string;
+    populationSize: string;
+    systemic: string;
+    /** Zeitraum bzw. Programm (Aufbau `periods` bzw. `groups`). */
+    part: string;
+    /** Programm bei mehreren Zeiträumen (optional, Leitfaden 6.3.4 und 7.8). */
+    group: string;
+}
+export interface UnitRow {
+    key: string;
+    id: string;
+    stratum: string;
+    bookValue: string;
+    random: string;
+    systemic: string;
+    anomalous: string;
+    reason: string;
+    corrected: boolean;
+    exhaustive: boolean;
+    period: string;
+    subsample: SubsampleRows | null;
+}
+export interface ExtrapolationForm {
+    methodId: string;
+    confidence: number | null;
+    profileId: string | null;
+    sampleSize: string;
+    /** Wesentlichkeitsschwelle in Prozent. */
+    materiality: string;
+    strata: readonly StratumRow[];
+    units: readonly UnitRow[];
+    design: ExtrapolationDesign;
+    /** Kategorie 1–4 der Systembewertung (Tabelle 1, Leitfaden 3.2.1) oder leer. */
+    systemAssessment: string;
+    /** Verschiedene Einheiten aller Zeiträume (nicht-statistisch, 6.4.9). */
+    populationUnits: string;
+}
+export type ExtrapolationIssue = 'required' | 'invalid' | 'range' | 'reason' | 'stratum' | 'duplicate';
+export type ExtrapolationFormError = 'method' | 'confidence' | 'profile' | 'strata' | 'units' | 'periods';
+export type ExtrapolationIssues = Readonly<Record<string, ExtrapolationIssue>>;
+export type EvaluationValidation = {
+    ok: true;
+    request: EvaluationRequest;
+} | {
+    ok: false;
+    error: ExtrapolationFormError | null;
+    issues: ExtrapolationIssues;
+};
+export interface ResidualForm {
+    auditPopulation: string;
+    /** Gesamtfehlerquote in Prozent. */
+    terRate: string;
+    ongoing: string;
+    otherNegative: string;
+    corrections: string;
+}
+export type ResidualValidation = {
+    ok: true;
+    request: ResidualRequest;
+} | {
+    ok: false;
+    issues: ExtrapolationIssues;
+};
+export declare const EMPTY_RESIDUAL: ResidualForm;
+export declare function emptyStratum(key: string): StratumRow;
+export declare function emptyUnit(key: string, stratum?: string, period?: string): UnitRow;
+type Format = (value: number) => string;
+export declare function stratumRows(strata: readonly StratumInput[], format: Format): StratumRow[];
+export declare function unitRows(units: readonly UnitInput[], format: Format): UnitRow[];
+interface Rule {
+    required?: boolean;
+    positive?: boolean;
+    integer?: boolean;
+    max?: number;
+}
+/** Zahl eines Textfelds oder der Befund; leere, nicht verlangte Felder ergeben 0. */
+export declare function readExtrapolationAmount(text: string, rule?: Rule): number | ExtrapolationIssue;
+/** Anfrage für `POST /evaluate`; bei Befunden die Feldschlüssel mit ihrem Fehler. */
+export declare function buildEvaluationRequest(catalogue: ExtrapolationCatalogue, form: ExtrapolationForm): EvaluationValidation;
+/** RER-Formular aus einer Auswertung: A = Buchwert, D = Gesamtfehlerquote (in Prozent). */
+export declare function residualFormFrom(result: EvaluationResult, current: ResidualForm, format: (value: number) => string): ResidualForm;
+/** Anfrage für `POST /residual`; die Gesamtfehlerquote wird in Prozent eingegeben. */
+export declare function buildResidualRequest(form: ResidualForm, materialityRate: number): ResidualValidation;
+export declare function extrapolationMethodById(catalogue: ExtrapolationCatalogue | null, id: string): ExtrapolationMethod | null;
+/** Konfidenzniveaus, die die gewählte Methode mit Tabellenwerten erlaubt. */
+export declare function confidenceChoices(catalogue: ExtrapolationCatalogue, method: ExtrapolationMethod | null): readonly number[];
+export {};

package/dist/extrapolation/rest-port.d.ts

@@ -0,0 +1,4 @@
+import { RestOptions } from '@auditcore/common';
+import { ExtrapolationPort } from './types';
+/** Port auf den REST-Vertrag von `auditcore_extrapolation.web` (Starlette oder FastAPI). */
+export declare function createExtrapolationRestPort(options: RestOptions): ExtrapolationPort;