Form

Deklarativní formulář: dostane pole a hodnoty, vrací změny přes onChange. Tvar formuláře jsou data, ne JSX.

Kdy použít

Pole přicházejí za běhu — ze schématu modulu nebo z manifestu integrace. fieldsFromConfigSchema a fieldsFromIntegrationManifest je převedou na IngotFieldSpec[].
Tvar formuláře jsou data: přidat pole znamená přidat řádek do pole, ne napsat další <label> a vlastní onChange.
Chceš, aby se převod hodnoty na typ (integer, number, boolean, secret) choval na všech obrazovkách stejně.

Rozvržení není svislý seznam — dvousloupcové sekce, pole vedle sebe, taby. Formulář umí jen space-y; poskládej si IngotFieldInput sám.
Potřebuješ validaci a chybové hlášky u jednotlivých polí. První verze je nemá — hlášku vykresluje volající nad formulářem. Rukou psaný formulář, který chybu u pole potřebuje, si ho složí z IngotField.
Je to jediné pole. Pak je IngotFieldInput přímo levnější a nemusíš vymýšlet testIdPrefix.

fields: readonly IngotFieldSpec[] — Popis polí. Pořadí v poli je pořadí na obrazovce.
values: Record<string, unknown> — Aktuální hodnoty klíčované podle field.key.
onChange: (key: string, next: unknown) => void — Formulář je řízený — stav drží volající.
testIdPrefix: string — data-testid vstupu je `${testIdPrefix}-${key}`.
renderOptions: IngotFieldInput['renderOptions'] — Výběr pro pole typu options. Bez něj se pole chová jako text.
secretPlaceholder: (field: IngotFieldSpec) => string — Přeložený placeholder tajného pole — Ingot překlady nemá.
className: string — Obal formuláře. Výchozí space-y-4.
inputClassName: string — Obrazovky se liší šířkou pole, ne tvarem formuláře.
labelClassName: string — Popisek pole. Výchozí block text-sm.