@conuti-das/prince-ui-bo4e 0.3.0

package/dist/index.d.ts

@@ -0,0 +1,235 @@
+import { ZonedDateTime } from '@internationalized/date';
+import * as react from 'react';
+import { ReactNode } from 'react';
+
+type Bo4eObject = {
+    boTyp?: string;
+} & Record<string, unknown>;
+type Stammdaten = Record<string, Bo4eObject[]>;
+interface DirectionDoc {
+    stammdaten: Stammdaten;
+    transaktionsdaten?: Bo4eObject;
+    zusatzdaten?: Bo4eObject;
+}
+interface CDoc {
+    id: string;
+    businessKey: string;
+    content: Partial<Record<string, DirectionDoc>>;
+}
+interface EnumDoc {
+    description?: string;
+    values: string[];
+}
+interface FieldDoc {
+    translation?: string;
+    description?: string;
+    example?: string;
+    pattern?: string;
+    enumRef?: string;
+    enum?: EnumDoc;
+}
+interface MarktpartnerInfo {
+    name: string;
+    rolle?: string;
+}
+interface Bo4eResolvers {
+    marktpartner?: (codenr: string, codetyp?: string) => MarktpartnerInfo | undefined;
+    enumLabel?: (enumName: string, value: string) => string | undefined;
+    obis?: (obis: string) => string | undefined;
+    pruefId?: (pi: string) => string | undefined;
+}
+
+declare function isIsoDate(v: unknown): v is string;
+declare function formatDateDE(iso: string, opts?: {
+    withTime?: boolean;
+}): string;
+declare function toUtcLabel(iso: string): string;
+declare function zonedLabelWithTz(iso: string): string;
+
+type ValidityState = "zukuenftig" | "aktiv" | "laeuftBald" | "abgelaufen";
+declare function validityStatus(range: {
+    startdatum?: string | null;
+    enddatum?: string | null;
+}, now?: Date): ValidityState;
+
+interface Anomaly {
+    severity: "warn" | "error";
+    path: string;
+    value: unknown;
+    rule: "placeholder" | "suspiciousChar" | "defaultValue" | "implausibleDate" | "expired" | "placeholderObject";
+    message: string;
+}
+declare function scanAnomalies(node: unknown, opts?: {
+    now?: Date;
+}): Anomaly[];
+
+declare function humanize(key: string): string;
+
+/** ISO-UTC string -> ZonedDateTime in Europe/Berlin (for the date/time picker). */
+declare function isoToBerlin(iso: string): ZonedDateTime;
+/** ZonedDateTime (any zone) -> normalized ISO-UTC string ("…Z", no millis). */
+declare function berlinToIso(z: ZonedDateTime): string;
+
+interface RawField {
+    translation?: string;
+    description?: string;
+    example?: string;
+    pattern?: string;
+    enumRef?: string;
+}
+interface RawEnumValue {
+    value: string;
+}
+interface RawEnum {
+    description?: string;
+    values: RawEnumValue[];
+}
+interface RawBo {
+    description?: string;
+    properties?: string[];
+}
+interface Bo4eSchema {
+    fields: Record<string, Record<string, RawField>>;
+    enums: Record<string, RawEnum>;
+    bos: Record<string, RawBo>;
+}
+declare function loadBo4eSchema(src: {
+    fields: unknown;
+    enums: unknown;
+    bos: unknown;
+}): Bo4eSchema;
+declare function resolveField(schema: Bo4eSchema, boTyp: string, key: string): FieldDoc;
+declare function getFieldOrder(schema: Bo4eSchema, boTyp: string): string[];
+
+/** A SydocView accepts a full cDoc, a single BO, or an array of BOs. */
+type SydocInput = CDoc | Bo4eObject | Bo4eObject[];
+/** Wrap a single BO or a BO array into a minimal cDoc (grouped by boTyp under OUTBOUND). */
+declare function normalizeToCDoc(input: SydocInput): CDoc;
+
+interface ValidityRangeProps {
+    start?: string | null;
+    end?: string | null;
+    now?: Date;
+}
+declare function ValidityRange({ start, end, now }: ValidityRangeProps): react.JSX.Element;
+
+interface Adresse {
+    strasse?: string;
+    hausnummer?: string;
+    postleitzahl?: string;
+    ort?: string;
+    ortsteil?: string;
+    landescode?: string;
+}
+declare function AddressBlock({ adresse }: {
+    adresse: Adresse;
+}): react.JSX.Element;
+
+interface CodeResolvedProps {
+    code: string;
+    codetyp?: string;
+    resolvers?: Bo4eResolvers;
+}
+declare function CodeResolved({ code, codetyp, resolvers }: CodeResolvedProps): react.JSX.Element;
+
+interface IdentityHeaderProps {
+    icon?: ReactNode;
+    title: ReactNode;
+    subtitle?: ReactNode;
+    trailing?: ReactNode;
+}
+declare function IdentityHeader({ icon, title, subtitle, trailing }: IdentityHeaderProps): react.JSX.Element;
+
+declare function EnumIcon({ enumName, value }: {
+    enumName: string;
+    value: string;
+}): react.JSX.Element | null;
+
+type Tone = "neutral" | "positive" | "info" | "critical" | "negative";
+declare function EnumBadge({ tone, icon, children }: {
+    tone?: Tone;
+    icon?: ReactNode;
+    children: ReactNode;
+}): react.JSX.Element;
+
+declare function SchemaPopoverBody({ fieldKey, doc, value }: {
+    fieldKey: string;
+    doc: FieldDoc;
+    value: unknown;
+}): react.JSX.Element;
+
+interface SchemaFieldProps {
+    schema: Bo4eSchema;
+    boTyp: string;
+    fieldKey: string;
+    value: unknown;
+    children: ReactNode;
+}
+declare function SchemaField({ schema, boTyp, fieldKey, value, children }: SchemaFieldProps): react.JSX.Element;
+
+interface ContactPerson {
+    anrede?: string;
+    name1?: string;
+    name2?: string;
+    name3?: string;
+    eMailAdresse?: string;
+    kontaktweg?: string[];
+    geschaeftspartnerrolle?: string[];
+}
+declare function ContactLine({ person }: {
+    person: ContactPerson;
+}): react.JSX.Element;
+
+declare function MarktpartnerRow({ row, resolvers, now }: {
+    row: Bo4eObject;
+    resolvers?: Bo4eResolvers;
+    now?: Date;
+}): react.JSX.Element;
+
+interface FullDetailProps {
+    schema: Bo4eSchema;
+    boTyp: string;
+    obj: Bo4eObject;
+    editable?: boolean;
+}
+declare function FullDetail({ schema, boTyp, obj, editable }: FullDetailProps): react.JSX.Element;
+
+interface SmartObjectCardProps {
+    schema: Bo4eSchema;
+    boTyp: string;
+    obj: Bo4eObject;
+    header?: ReactNode;
+    children: ReactNode;
+}
+declare function SmartObjectCard({ schema, boTyp, obj, header, children }: SmartObjectCardProps): react.JSX.Element;
+
+interface SmartObjectViewProps {
+    schema: Bo4eSchema;
+    obj: Bo4eObject;
+    resolvers?: Bo4eResolvers;
+    now?: Date;
+}
+declare function SmartObjectView({ schema, obj, resolvers, now }: SmartObjectViewProps): react.JSX.Element;
+
+interface EditableValueProps {
+    doc: FieldDoc;
+    value: unknown;
+    onChange: (value: unknown) => void;
+}
+/**
+ * Schema-getriebenes Eingabe-Widget für ein einzelnes Feld:
+ * Enum → Select, Boolean → Switch, Zahl → NumberField, ISO-Datum → DateField
+ * (Anzeige in Europe/Berlin, Rückgabe als ISO-UTC), sonst Freitext.
+ */
+declare function EditableValue({ doc, value, onChange }: EditableValueProps): react.JSX.Element;
+
+interface SydocViewProps {
+    /** Full cDoc, a single BO, or an array of BOs. */
+    doc: SydocInput;
+    schema: Bo4eSchema;
+    resolvers?: Bo4eResolvers;
+    now?: Date;
+}
+declare function SydocView({ doc, schema, resolvers, now }: SydocViewProps): react.JSX.Element | null;
+
+export { AddressBlock, type Adresse, type Anomaly, type Bo4eObject, type Bo4eResolvers, type Bo4eSchema, type CDoc, CodeResolved, type CodeResolvedProps, ContactLine, type ContactPerson, type DirectionDoc, EditableValue, type EditableValueProps, EnumBadge, type EnumDoc, EnumIcon, type FieldDoc, FullDetail, type FullDetailProps, IdentityHeader, type IdentityHeaderProps, type MarktpartnerInfo, MarktpartnerRow, SchemaField, type SchemaFieldProps, SchemaPopoverBody, SmartObjectCard, type SmartObjectCardProps, SmartObjectView, type SmartObjectViewProps, type Stammdaten, type SydocInput, SydocView, type SydocViewProps, type Tone, ValidityRange, type ValidityRangeProps, type ValidityState, berlinToIso, formatDateDE, getFieldOrder, humanize, isIsoDate, isoToBerlin, loadBo4eSchema, normalizeToCDoc, resolveField, scanAnomalies, toUtcLabel, validityStatus, zonedLabelWithTz };