ngx-dynamic-entity 1.8.1 → 1.9.0

package/types/ngx-dynamic-entity.d.ts

@@ -1,7 +1,7 @@
 import * as i0 from '@angular/core';
 import { InjectionToken, Type, EnvironmentProviders, WritableSignal, OnInit, OnChanges, OnDestroy, EventEmitter, SimpleChanges } from '@angular/core';
-import { ReferenceOption as ReferenceOption$1, EntityReferenceLoader as EntityReferenceLoader$1, LookupListSource as LookupListSource$1, RecordMigration as RecordMigration$1, FieldValidators, NestedFieldConfig, ReferenceLoaderContext, EntityFormConfig, DropdownOption, LookupListValue, NestedTabConfig, FormRule, RuleEvaluationResult as RuleEvaluationResult$1 } from '@dynamic-entity/core';
-export { AutoPatchConfig, CommonModuleEntry, DropdownOption, EntityFormConfig, EntityPermissions, EntityReferenceConfig, EntityReferenceLoader, FieldTableConfig, FieldValidators, FileRef, FormRule, LocalizedText, NestedFieldConfig, NestedTabConfig, PatchOnTrueMapping, RbacContext, ReferenceLoaderContext, ReferenceOption, RichFieldType, RuleAction, RuleCondition, RuleEvaluationResult, VersionedRecord, formatDisplayValue, normalizeConfig, normalizeOption, resolveLabel, resolveOptionLabel, resolveOptionValue, valuesMatch } from '@dynamic-entity/core';
+import { ReferenceOption as ReferenceOption$1, LocalizedText, EntityReferenceLoader as EntityReferenceLoader$1, LookupListSource as LookupListSource$1, RecordMigration as RecordMigration$1, FieldValidators, NestedFieldConfig, ReferenceLoaderContext, EntityFormConfig, DropdownOption, LookupListValue, NestedTabConfig, FormRule, RuleEvaluationResult as RuleEvaluationResult$1 } from '@dynamic-entity/core';
+export { AutoPatchConfig, CommonModuleEntry, ComponentClass, DropdownOption, EntityFormConfig, EntityPermissions, EntityReferenceConfig, EntityReferenceLoader, FieldTableConfig, FieldValidators, FileRef, FormRule, LocalizedText, NestedFieldConfig, NestedTabConfig, PatchOnTrueMapping, RbacContext, ReferenceLoaderContext, ReferenceOption, RichFieldType, RuleAction, RuleCondition, RuleEvaluationResult, VersionedRecord, formatDisplayValue, normalizeConfig, normalizeOption, resolveLabel, resolveOptionLabel, resolveOptionValue, valuesMatch } from '@dynamic-entity/core';
 import { ValidatorFn, AsyncValidatorFn, ValidationErrors, FormGroup, FormArray, AbstractControl } from '@angular/forms';
 import * as rxjs from 'rxjs';
 
@@ -32,6 +32,134 @@ declare class InMemoryEntityRefCacheStore implements EntityRefCacheStore {
     clear(): void;
 }
 
+/**
+ * Every word this library puts on screen that does not come from a config.
+ *
+ * Field labels, placeholders and options are `LocalizedText` and already follow the form's
+ * `language`. The library's *own* chrome — Save, Reset, "No rows yet." — was English
+ * literals in twenty-odd templates, so an application in German rendered German labels
+ * around English buttons. There was no way to change them short of forking a component.
+ *
+ * This map is the whole surface: the keys are what a host translates, and the values are
+ * the English source strings to translate *from*. It is exported so a translation file can
+ * be generated from it rather than transcribed by hand.
+ *
+ * Keys are grouped by where they appear rather than alphabetically, because a translator
+ * works screen by screen and a list sorted by name hides which strings sit together.
+ */
+declare const DEFAULT_UI_TEXT: {
+    save: string;
+    saving: string;
+    reset: string;
+    saveShortcutHint: string;
+    loading: string;
+    editSection: string;
+    saveSection: string;
+    editingSection: string;
+    cancel: string;
+    edit: string;
+    delete: string;
+    addRow: string;
+    addItem: string;
+    itemNumber: string;
+    addRowTitle: string;
+    editRowTitle: string;
+    saveRow: string;
+    remove: string;
+    noRows: string;
+    noItems: string;
+    selectPlaceholder: string;
+    selectParentFirst: string;
+    yes: string;
+    no: string;
+    uploading: string;
+    chooseFile: string;
+    replaceFile: string;
+    removeFile: string;
+    downloadFile: string;
+    noImage: string;
+    uploadImage: string;
+    changeImage: string;
+    month: string;
+    year: string;
+    write: string;
+    preview: string;
+    markdownEditorMode: string;
+    showPassword: string;
+    hidePassword: string;
+    lockField: string;
+    unlockField: string;
+    criticalFieldLockHint: string;
+    criticalFieldUnlockHint: string;
+    dismissBanner: string;
+    jumpToField: string;
+    entityLabel: string;
+    criticalFieldChanged: string;
+    recordModified: string;
+    accessDenied: string;
+};
+/**
+ * The keys above, as a union. Templates are checked against it, so a mistyped key is an
+ * AOT error rather than a blank button, and a host writing overrides gets completion.
+ */
+type UiTextKey = keyof typeof DEFAULT_UI_TEXT;
+/**
+ * One replacement: a plain string, or the same `LocalizedText` map a config uses for a
+ * field label — `{ en: 'Save', de: 'Speichern' }`, resolved against the form's `language`
+ * by the very function that resolves the labels beside it.
+ */
+type UiTextValue = string | LocalizedText;
+/**
+ * Asked for one key at render time, given the English default to fall back on and the
+ * form's active language.
+ *
+ * This is the seam for an existing i18n setup — `$localize`, ngx-translate, Transloco —
+ * whose catalogue is language-first (`de.json`) rather than key-first, and which already
+ * holds its own idea of the current language. Take `language` or ignore it accordingly.
+ */
+type UiTextResolverFor<K extends string> = (key: K, defaultText: string, language: string) => string;
+/** The resolver for this library's own keys. */
+type UiTextResolver = UiTextResolverFor<UiTextKey>;
+/**
+ * Values substituted into a `{placeholder}` in the text.
+ *
+ * A sentence with a name in the middle has to travel as one string: word order moves
+ * between languages, so splitting it into fragments around an interpolation produces
+ * grammatical nonsense in the ones it was not written for.
+ */
+type UiTextParams = Record<string, string | number>;
+/** Either a partial map of replacements, or a resolver that answers per key. */
+type UiTextOverridesFor<K extends string> = Partial<Record<K, UiTextValue>> | UiTextResolverFor<K>;
+/** The overrides for this library's own keys. */
+type UiTextOverrides = UiTextOverridesFor<UiTextKey>;
+/**
+ * The resolution rule itself, over any key vocabulary.
+ *
+ * Exported because the builder package renders a second, disjoint set of words and needs
+ * the same rule — overrides first, then the English default, per key, with `{placeholder}`
+ * substitution. Sharing the function rather than the vocabulary is what keeps a renderer
+ * consumer from seeing a hundred and fifty builder keys in completion.
+ */
+declare function resolveUiText<K extends string>(overrides: UiTextOverridesFor<K> | null | undefined, defaults: Readonly<Record<K, string>>, key: K, language: string, params?: UiTextParams): string;
+/**
+ * Resolves the library's own UI text, honouring `UI_TEXT` before the defaults.
+ *
+ * Resolution is per key, not all-or-nothing, so a host replacing three buttons does not
+ * have to supply the other thirty — and an override that yields nothing for a key still
+ * renders English rather than a gap, which is what a translation catalogue asked for a
+ * missing entry typically hands back.
+ */
+declare class UiTextService {
+    private readonly overrides;
+    /**
+     * One label by key, in `language`; English if nothing overrides it. `params` fill the
+     * `{placeholder}` slots, in whatever position the translation puts them.
+     */
+    text(key: UiTextKey, language?: string, params?: UiTextParams): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiTextService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<UiTextService>;
+}
+
 /** Roles that see XXXXXXXXX for masked fields. Presentational only — enforce authz server-side. */
 declare const MASKED_ROLES: InjectionToken<string[]>;
 /**
@@ -122,13 +250,18 @@ declare const HOOK_REGISTRY: InjectionToken<Map<string, HookFn>>;
  * The library ships no built-in implementations. Consumers provide their own list
  * so the builder's module-picker and the renderer's tab switcher know what's available.
  *
+ * `component` must be the component **class**: it is mounted through `ngComponentOutlet`,
+ * which takes a type, not a selector. An entry naming a selector string renders nothing and
+ * warns — `COMMON_MODULES` in core is a catalogue of names for the builder's picker, and
+ * offering a module the renderer cannot mount is the one way to get this wrong.
+ *
  * @example
  * providers: [
  *   {
  *     provide: COMMON_MODULES_REGISTRY,
  *     useValue: [
- *       { id: 'documents', label: { en: 'Documents' }, component: 'app-documents-view' },
- *       { id: 'audit',     label: { en: 'Audit Log'  }, component: 'app-audit' },
+ *       { id: 'documents', label: { en: 'Documents' }, component: DocumentsViewComponent },
+ *       { id: 'audit',     label: { en: 'Audit Log'  }, component: AuditLogComponent },
  *     ] satisfies CommonModuleEntry[]
  *   }
  * ]
@@ -182,6 +315,54 @@ declare const CONFIG_SOURCE: InjectionToken<ConfigSourceHandler>;
  * { provide: MARKDOWN_RENDERER, useValue: (src: string) => marked.parse(src) as string }
  */
 declare const MARKDOWN_RENDERER: InjectionToken<(source: string) => string>;
+/**
+ * The text a masked field shows in place of its value. Defaults to `XXXXXXXXX`.
+ *
+ * Masking is presentational — see SECURITY.md — and what it prints is a product decision:
+ * `••••••••` reads as a redaction, "Hidden" reads as a permission, and a localized string
+ * reads as neither in English. It was a literal repeated across every field component, so
+ * there was no way to choose.
+ *
+ * @example
+ * { provide: MASKED_PLACEHOLDER, useValue: '••••••••' }
+ */
+declare const MASKED_PLACEHOLDER: InjectionToken<string>;
+/**
+ * Overrides for the library's own chrome — Save, Reset, "No rows yet.", and the rest.
+ *
+ * Field labels and options come from the config as `LocalizedText` and already follow the
+ * form's `language`. This is the text *around* them, which was English literals in the
+ * templates: an application in German rendered German labels around English buttons.
+ *
+ * The library does no translating — it publishes the keys it renders and resolves whatever
+ * a host hands back. `DEFAULT_UI_TEXT` is the full list of keys with their English source
+ * strings, so a translation file can be generated from it rather than transcribed. Anything
+ * left out keeps its English default.
+ *
+ * @example The config's own shape — `LocalizedText` per key, resolved against `language`
+ * {
+ *   provide: UI_TEXT,
+ *   useValue: {
+ *     save: { en: 'Save', de: 'Speichern' },
+ *     reset: { en: 'Reset', de: 'Zurücksetzen' },
+ *   },
+ * }
+ *
+ * @example One language, or a host that re-provides on switch
+ * { provide: UI_TEXT, useValue: { save: 'Speichern', reset: 'Zurücksetzen' } }
+ *
+ * @example An existing i18n layer (ngx-translate, Transloco, $localize)
+ * {
+ *   provide: UI_TEXT,
+ *   useFactory: () => {
+ *     const translate = inject(TranslateService);
+ *     return (key, defaultText) => translate.instant(`dynamicEntity.${key}`) || defaultText;
+ *   },
+ * }
+ *
+ * A resolver is read during change detection, so it must be synchronous and cheap.
+ */
+declare const UI_TEXT: InjectionToken<UiTextOverrides>;
 
 interface NgxDynamicEntityConfig {
     /** Roles that see masked field values as XXXXXXXXX */
@@ -205,6 +386,14 @@ interface NgxDynamicEntityConfig {
      * Unlisted keys keep their English default.
      */
     validationMessages?: Record<string, string | ((language: string, error: any) => string)>;
+    /**
+     * Override the library's own chrome — Save, Reset, "No rows yet.". Either a partial map
+     * keyed by `UiTextKey`, whose values are strings or the same `LocalizedText` a field label
+     * uses (`{ en, de }`, resolved against the form's `language`), or a resolver
+     * `(key, defaultText, language) => string` that hands the key to an existing i18n layer.
+     * `DEFAULT_UI_TEXT` lists every key with its English source string; unlisted keys keep it.
+     */
+    uiText?: UiTextOverrides;
     /**
      * Async validator functions keyed by name, for checks that need a server — uniqueness,
      * availability, a remote rule. Name them from a schema with
@@ -665,6 +854,8 @@ declare class ValidationMessagesService {
  * keyboard shortcuts (Ctrl+S, Esc), and RBAC-gated submission.
  */
 declare class DynamicFormComponent implements OnInit, OnChanges, OnDestroy {
+    /** Library chrome, overridable via UI_TEXT. */
+    protected readonly ui: UiTextService;
     /**
      * The schema to render.
      *
@@ -761,7 +952,21 @@ declare class DynamicFormComponent implements OnInit, OnChanges, OnDestroy {
     get activeTabConfig(): NestedTabConfig | null;
     get visibleSubTabs(): NestedTabConfig[];
     get activeSubTabConfig(): NestedTabConfig | null;
+    /**
+     * The component to mount for the active tab, or `null` if there is nothing to mount.
+     *
+     * A registry entry may name its component with a **selector string** — `COMMON_MODULES`
+     * is a catalogue of names for the builder's picker, and the token's own example showed
+     * one. `ngComponentOutlet` mounts a component *type*, so a string reached it and Angular
+     * threw an assertion the moment somebody opened that tab. Following the documented shape
+     * broke the feature, which is worse than the feature not existing.
+     *
+     * A string now resolves to nothing renderable and says why, once per module.
+     */
     get activeTabModuleComponent(): any | null;
+    /** Warned once per module id, because a getter runs on every change-detection pass. */
+    private readonly warnedSelectorModules;
+    private warnSelectorModule;
     get fieldsForActiveTab(): NestedFieldConfig[];
     /**
      * Entity-level permissions for the current roles.
@@ -850,6 +1055,14 @@ declare class DynamicFormComponent implements OnInit, OnChanges, OnDestroy {
     isFieldReadonly(field: NestedFieldConfig): boolean;
     toggleFieldLock(field: NestedFieldConfig): void;
     resolveFieldLabel(field: NestedFieldConfig): string;
+    /**
+     * The changed critical fields as one comma-separated string.
+     *
+     * Joined here rather than looped in the template because the banner is a sentence with the
+     * list inside it, and a sentence has to reach `UI_TEXT` whole — a translation moves the
+     * list somewhere else in the clause.
+     */
+    changedCriticalFieldLabels(): string;
     private buildForm;
     private buildFieldControl;
     /** One row of an `array` field: a FormGroup when the field declares columns, else a bare control. */
@@ -1009,6 +1222,8 @@ declare class DynamicFormComponent implements OnInit, OnChanges, OnDestroy {
  * interactive quick-jump links, and baseline modification tracking.
  */
 declare class DynamicRecordFormComponent implements OnChanges {
+    /** Library chrome, overridable via UI_TEXT. */
+    protected readonly ui: UiTextService;
     config: EntityFormConfig;
     rules?: FormRule[];
     initialData?: Record<string, any>;
@@ -1185,6 +1400,8 @@ declare class DynamicRecordFormComponent implements OnChanges {
     onFormSubmit(data: Record<string, any>): void;
     onFormReset(): void;
     formatFieldLabel(field: NestedFieldConfig): string;
+    /** "Add <field> row" / "Edit <field> row" — one key each, because word order moves. */
+    rowDrawerTitle(field: NestedFieldConfig): string;
     /** Summary values render through the shared core formatter, not a local stringifier. */
     formatFieldValue(field: NestedFieldConfig): string;
     /**
@@ -1318,6 +1535,12 @@ declare class DynamicFieldComponent implements OnChanges, OnDestroy {
  * - `masked` means the value must not be displayed. Render a placeholder rather than the
  *   control's value. This is presentational: the real value stays in the control and is
  *   included in the submitted record, so it is not an access-control boundary.
+ * - If you emit a DOM `id` — for a `<label for>`, or an `aria-describedby` — do not build it
+ *   from `field.id` alone. An `array` renders the same field once per row, so `field.id` is
+ *   unique in a config and not in a document, and `for` resolves to the first match on the
+ *   page. `nextFieldInstanceId()` and `fieldDomId()` are what the built-in types use; a
+ *   counter of your own does just as well. Address controls in tests through `data-testid`
+ *   or their label, never through these ids.
  */
 interface DynamicFieldComponentContract {
     /** The field's schema entry: id, type, label, validators, options, and so on. */
@@ -1332,7 +1555,28 @@ interface DynamicFieldComponentContract {
     masked: boolean;
 }
 
+/** A token unique to one component instance, for the lifetime of the page. */
+declare function nextFieldInstanceId(): string;
+/**
+ * `{fieldId}-{instance}{suffix}` — the field first, so the id still reads as the field it
+ * belongs to when someone is looking at the DOM.
+ *
+ * `field` is undefined until the renderer assigns it, and a template can be checked once
+ * before that happens.
+ */
+declare function fieldDomId(field: {
+    id?: string;
+} | undefined, instance: string, suffix?: string): string;
+
 declare class TextFieldComponent implements OnDestroy {
+    /**
+     * Unique to this component instance: an `array` renders the same field once per row, and a
+     * DOM id may not repeat. See `field-dom-id.ts`.
+     */
+    private readonly instanceId;
+    protected domId(suffix?: string): string;
+    /** Overridable via MASKED_PLACEHOLDER; the default is the historic literal. */
+    protected readonly maskedText: string;
     private readonly messages;
     private displaySub?;
     field: NestedFieldConfig;
@@ -1353,6 +1597,15 @@ declare class TextFieldComponent implements OnDestroy {
 }
 
 declare class TextareaFieldComponent {
+    /**
+     * Unique to this component instance: an `array` renders the same field once per row, and a
+     * DOM id may not repeat. See `field-dom-id.ts`.
+     */
+    private readonly instanceId;
+    protected domId(suffix?: string): string;
+    /** Overridable via MASKED_PLACEHOLDER; the default is the historic literal. */
+    protected readonly maskedText: string;
+    private readonly messages;
     field: NestedFieldConfig;
     control: AbstractControl;
     language: string;
@@ -1360,6 +1613,13 @@ declare class TextareaFieldComponent {
     masked: boolean;
     get label(): string;
     get placeholder(): string;
+    /**
+     * Resolved through `ValidationMessagesService`, so `provideNgxDynamicEntity({
+     * validationMessages })` reaches this field. It used to render a fixed
+     * "This field has an error", which made a documented, configurable feature work on three
+     * of fifteen field types.
+     */
+    get errorMessage(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<TextareaFieldComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<TextareaFieldComponent, "ngx-textarea-field", never, { "field": { "alias": "field"; "required": false; }; "control": { "alias": "control"; "required": false; }; "language": { "alias": "language"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "masked": { "alias": "masked"; "required": false; }; }, {}, never, never, true, never>;
 }
@@ -1381,6 +1641,17 @@ declare class TextareaFieldComponent {
  * the token's own note on why that is a backstop rather than a licence.
  */
 declare class MarkdownFieldComponent implements OnChanges {
+    /**
+     * Unique to this component instance: an `array` renders the same field once per row, and a
+     * DOM id may not repeat. See `field-dom-id.ts`.
+     */
+    private readonly instanceId;
+    protected domId(suffix?: string): string;
+    /** Overridable via MASKED_PLACEHOLDER; the default is the historic literal. */
+    protected readonly maskedText: string;
+    private readonly messages;
+    /** Library chrome, overridable via UI_TEXT. */
+    protected readonly ui: UiTextService;
     field: NestedFieldConfig;
     control: AbstractControl;
     language: string;
@@ -1414,11 +1685,26 @@ declare class MarkdownFieldComponent implements OnChanges {
      * source text — which is what the field would have shown with no renderer at all.
      */
     protected rendered(): string | null;
+    /**
+     * Resolved through `ValidationMessagesService`, so `provideNgxDynamicEntity({
+     * validationMessages })` reaches this field. It used to render a fixed
+     * "This field has an error", which made a documented, configurable feature work on three
+     * of fifteen field types.
+     */
+    get errorMessage(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<MarkdownFieldComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MarkdownFieldComponent, "ngx-markdown-field", never, { "field": { "alias": "field"; "required": false; }; "control": { "alias": "control"; "required": false; }; "language": { "alias": "language"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "masked": { "alias": "masked"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 declare class NumberFieldComponent {
+    /**
+     * Unique to this component instance: an `array` renders the same field once per row, and a
+     * DOM id may not repeat. See `field-dom-id.ts`.
+     */
+    private readonly instanceId;
+    protected domId(suffix?: string): string;
+    /** Overridable via MASKED_PLACEHOLDER; the default is the historic literal. */
+    protected readonly maskedText: string;
     private readonly messages;
     field: NestedFieldConfig;
     control: AbstractControl;
@@ -1434,6 +1720,15 @@ declare class NumberFieldComponent {
 
 /** Currency field: number input with locale-aware currency symbol prefix. */
 declare class CurrencyFieldComponent {
+    /**
+     * Unique to this component instance: an `array` renders the same field once per row, and a
+     * DOM id may not repeat. See `field-dom-id.ts`.
+     */
+    private readonly instanceId;
+    protected domId(suffix?: string): string;
+    /** Overridable via MASKED_PLACEHOLDER; the default is the historic literal. */
+    protected readonly maskedText: string;
+    private readonly messages;
     field: NestedFieldConfig;
     control: AbstractControl;
     language: string;
@@ -1443,12 +1738,28 @@ declare class CurrencyFieldComponent {
     get placeholder(): string;
     /** Picks the currency symbol from the locale — defaults to '$'. */
     get symbol(): string;
+    /**
+     * Resolved through `ValidationMessagesService`, so `provideNgxDynamicEntity({
+     * validationMessages })` reaches this field. It used to render a fixed
+     * "This field has an error", which made a documented, configurable feature work on three
+     * of fifteen field types.
+     */
+    get errorMessage(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<CurrencyFieldComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<CurrencyFieldComponent, "ngx-currency-field", never, { "field": { "alias": "field"; "required": false; }; "control": { "alias": "control"; "required": false; }; "language": { "alias": "language"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "masked": { "alias": "masked"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 /** Email field: type="email" input with inline validation hint. */
 declare class EmailFieldComponent {
+    /**
+     * Unique to this component instance: an `array` renders the same field once per row, and a
+     * DOM id may not repeat. See `field-dom-id.ts`.
+     */
+    private readonly instanceId;
+    protected domId(suffix?: string): string;
+    /** Overridable via MASKED_PLACEHOLDER; the default is the historic literal. */
+    protected readonly maskedText: string;
+    private readonly messages;
     field: NestedFieldConfig;
     control: AbstractControl;
     language: string;
@@ -1456,12 +1767,30 @@ declare class EmailFieldComponent {
     masked: boolean;
     get label(): string;
     get placeholder(): string;
+    /**
+     * Resolved through `ValidationMessagesService`, so `provideNgxDynamicEntity({
+     * validationMessages })` reaches this field. It used to render a fixed
+     * "This field has an error", which made a documented, configurable feature work on three
+     * of fifteen field types.
+     */
+    get errorMessage(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<EmailFieldComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<EmailFieldComponent, "ngx-email-field", never, { "field": { "alias": "field"; "required": false; }; "control": { "alias": "control"; "required": false; }; "language": { "alias": "language"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "masked": { "alias": "masked"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 /** Password field: masked input with show/hide eye toggle. */
 declare class PasswordFieldComponent {
+    /**
+     * Unique to this component instance: an `array` renders the same field once per row, and a
+     * DOM id may not repeat. See `field-dom-id.ts`.
+     */
+    private readonly instanceId;
+    protected domId(suffix?: string): string;
+    /** Overridable via MASKED_PLACEHOLDER; the default is the historic literal. */
+    protected readonly maskedText: string;
+    private readonly messages;
+    /** Library chrome, overridable via UI_TEXT. */
+    protected readonly ui: UiTextService;
     field: NestedFieldConfig;
     control: AbstractControl;
     language: string;
@@ -1471,17 +1800,42 @@ declare class PasswordFieldComponent {
     get label(): string;
     get placeholder(): string;
     toggleVisibility(): void;
+    /**
+     * Resolved through `ValidationMessagesService`, so `provideNgxDynamicEntity({
+     * validationMessages })` reaches this field. It used to render a fixed
+     * "This field has an error", which made a documented, configurable feature work on three
+     * of fifteen field types.
+     */
+    get errorMessage(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<PasswordFieldComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PasswordFieldComponent, "ngx-password-field", never, { "field": { "alias": "field"; "required": false; }; "control": { "alias": "control"; "required": false; }; "language": { "alias": "language"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "masked": { "alias": "masked"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 declare class CheckboxFieldComponent {
+    /**
+     * Unique to this component instance: an `array` renders the same field once per row, and a
+     * DOM id may not repeat. See `field-dom-id.ts`.
+     */
+    private readonly instanceId;
+    protected domId(suffix?: string): string;
+    /** Library chrome, overridable via UI_TEXT. */
+    protected readonly ui: UiTextService;
+    /** Overridable via MASKED_PLACEHOLDER; the default is the historic literal. */
+    protected readonly maskedText: string;
+    private readonly messages;
     field: NestedFieldConfig;
     control: AbstractControl;
     language: string;
     readonly: boolean;
     masked: boolean;
     get label(): string;
+    /**
+     * Configured messages reach this field too.
+     *
+     * It rendered no error element at all, so a required checkbox left unticked told the user
+     * nothing — and `validationMessages` could not reach a field that never displayed one.
+     */
+    get errorMessage(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<CheckboxFieldComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<CheckboxFieldComponent, "ngx-checkbox-field", never, { "field": { "alias": "field"; "required": false; }; "control": { "alias": "control"; "required": false; }; "language": { "alias": "language"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "masked": { "alias": "masked"; "required": false; }; }, {}, never, never, true, never>;
 }
@@ -1492,17 +1846,38 @@ declare class CheckboxFieldComponent {
  * toggle switch with Yes/No labels for clearer binary state communication.
  */
 declare class BooleanFieldComponent {
+    /** Library chrome, overridable via UI_TEXT. */
+    protected readonly ui: UiTextService;
+    /** Overridable via MASKED_PLACEHOLDER; the default is the historic literal. */
+    protected readonly maskedText: string;
+    private readonly messages;
     field: NestedFieldConfig;
     control: AbstractControl;
     language: string;
     readonly: boolean;
     masked: boolean;
     get label(): string;
+    /**
+     * Configured messages reach this field too.
+     *
+     * It rendered no error element at all, so a required checkbox left unticked told the user
+     * nothing — and `validationMessages` could not reach a field that never displayed one.
+     */
+    get errorMessage(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<BooleanFieldComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<BooleanFieldComponent, "ngx-boolean-field", never, { "field": { "alias": "field"; "required": false; }; "control": { "alias": "control"; "required": false; }; "language": { "alias": "language"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "masked": { "alias": "masked"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 declare class DateFieldComponent {
+    /**
+     * Unique to this component instance: an `array` renders the same field once per row, and a
+     * DOM id may not repeat. See `field-dom-id.ts`.
+     */
+    private readonly instanceId;
+    protected domId(suffix?: string): string;
+    /** Overridable via MASKED_PLACEHOLDER; the default is the historic literal. */
+    protected readonly maskedText: string;
+    private readonly messages;
     field: NestedFieldConfig;
     control: AbstractControl;
     language: string;
@@ -1511,6 +1886,13 @@ declare class DateFieldComponent {
     get label(): string;
     /** ISO 8601 date → locale display string (ONEHERMES convention: always UTC, display in user locale) */
     formatDate(value: string | null): string;
+    /**
+     * Resolved through `ValidationMessagesService`, so `provideNgxDynamicEntity({
+     * validationMessages })` reaches this field. It used to render a fixed
+     * "This field has an error", which made a documented, configurable feature work on three
+     * of fifteen field types.
+     */
+    get errorMessage(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<DateFieldComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DateFieldComponent, "ngx-date-field", never, { "field": { "alias": "field"; "required": false; }; "control": { "alias": "control"; "required": false; }; "language": { "alias": "language"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "masked": { "alias": "masked"; "required": false; }; }, {}, never, never, true, never>;
 }
@@ -1523,6 +1905,15 @@ declare class DateFieldComponent {
  * conversions here are what keep a value stable across a round trip.
  */
 declare class DateTimeFieldComponent {
+    /**
+     * Unique to this component instance: an `array` renders the same field once per row, and a
+     * DOM id may not repeat. See `field-dom-id.ts`.
+     */
+    private readonly instanceId;
+    protected domId(suffix?: string): string;
+    /** Overridable via MASKED_PLACEHOLDER; the default is the historic literal. */
+    protected readonly maskedText: string;
+    private readonly messages;
     field: NestedFieldConfig;
     control: AbstractControl;
     language: string;
@@ -1539,6 +1930,13 @@ declare class DateTimeFieldComponent {
      * summary — which goes through core's `formatDisplayValue` — showed it.
      */
     formatDateTime(value: unknown): string;
+    /**
+     * Resolved through `ValidationMessagesService`, so `provideNgxDynamicEntity({
+     * validationMessages })` reaches this field. It used to render a fixed
+     * "This field has an error", which made a documented, configurable feature work on three
+     * of fifteen field types.
+     */
+    get errorMessage(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<DateTimeFieldComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DateTimeFieldComponent, "ngx-date-time-field", never, { "field": { "alias": "field"; "required": false; }; "control": { "alias": "control"; "required": false; }; "language": { "alias": "language"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "masked": { "alias": "masked"; "required": false; }; }, {}, never, never, true, never>;
 }
@@ -1552,6 +1950,15 @@ declare class DateTimeFieldComponent {
  * and converting it to UTC would move it whenever the offset changed.
  */
 declare class TimeFieldComponent {
+    /**
+     * Unique to this component instance: an `array` renders the same field once per row, and a
+     * DOM id may not repeat. See `field-dom-id.ts`.
+     */
+    private readonly instanceId;
+    protected domId(suffix?: string): string;
+    /** Overridable via MASKED_PLACEHOLDER; the default is the historic literal. */
+    protected readonly maskedText: string;
+    private readonly messages;
     field: NestedFieldConfig;
     control: AbstractControl;
     language: string;
@@ -1564,6 +1971,13 @@ declare class TimeFieldComponent {
      * another in the record summary because the two drifted apart.
      */
     formatTime(value: unknown): string;
+    /**
+     * Resolved through `ValidationMessagesService`, so `provideNgxDynamicEntity({
+     * validationMessages })` reaches this field. It used to render a fixed
+     * "This field has an error", which made a documented, configurable feature work on three
+     * of fifteen field types.
+     */
+    get errorMessage(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<TimeFieldComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<TimeFieldComponent, "ngx-time-field", never, { "field": { "alias": "field"; "required": false; }; "control": { "alias": "control"; "required": false; }; "language": { "alias": "language"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "masked": { "alias": "masked"; "required": false; }; }, {}, never, never, true, never>;
 }
@@ -1573,6 +1987,17 @@ declare class TimeFieldComponent {
  * Value stored as ISO partial date string "YYYY-MM" for unambiguous storage.
  */
 declare class MonthYearFieldComponent {
+    /**
+     * Unique to this component instance: an `array` renders the same field once per row, and a
+     * DOM id may not repeat. See `field-dom-id.ts`.
+     */
+    private readonly instanceId;
+    protected domId(suffix?: string): string;
+    /** Library chrome, overridable via UI_TEXT. */
+    protected readonly ui: UiTextService;
+    /** Overridable via MASKED_PLACEHOLDER; the default is the historic literal. */
+    protected readonly maskedText: string;
+    private readonly messages;
     field: NestedFieldConfig;
     control: AbstractControl;
     language: string;
@@ -1590,11 +2015,28 @@ declare class MonthYearFieldComponent {
     onMonthChange(month: string): void;
     onYearChange(year: string): void;
     formatValue(value: unknown): string;
+    /**
+     * Resolved through `ValidationMessagesService`, so `provideNgxDynamicEntity({
+     * validationMessages })` reaches this field. It used to render a fixed
+     * "This field has an error", which made a documented, configurable feature work on three
+     * of fifteen field types.
+     */
+    get errorMessage(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<MonthYearFieldComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MonthYearFieldComponent, "ngx-month-year-field", never, { "field": { "alias": "field"; "required": false; }; "control": { "alias": "control"; "required": false; }; "language": { "alias": "language"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "masked": { "alias": "masked"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 declare class DropdownFieldComponent {
+    /**
+     * Unique to this component instance: an `array` renders the same field once per row, and a
+     * DOM id may not repeat. See `field-dom-id.ts`.
+     */
+    private readonly instanceId;
+    protected domId(suffix?: string): string;
+    /** Library chrome, overridable via UI_TEXT. */
+    protected readonly ui: UiTextService;
+    /** Overridable via MASKED_PLACEHOLDER; the default is the historic literal. */
+    protected readonly maskedText: string;
     private readonly lookups;
     private readonly messages;
     private _field;
@@ -1628,6 +2070,15 @@ declare class DropdownFieldComponent {
 
 /** Radio field: a group of radio buttons built from field.options. */
 declare class RadioFieldComponent {
+    /**
+     * Unique to this component instance: an `array` renders the same field once per row, and a
+     * DOM id may not repeat. See `field-dom-id.ts`.
+     */
+    private readonly instanceId;
+    protected domId(suffix?: string): string;
+    /** Overridable via MASKED_PLACEHOLDER; the default is the historic literal. */
+    protected readonly maskedText: string;
+    private readonly messages;
     private readonly lookups;
     private _field;
     private _language;
@@ -1649,15 +2100,39 @@ declare class RadioFieldComponent {
      * into an id attribute.
      */
     getRadioId(option: DropdownOption): string;
+    /**
+     * The option's part of an id or a test hook.
+     *
+     * `??` cannot fire here: `resolveOptionValue` returns '' for an empty option, not null, so
+     * every valueless option produced the same slug — and two radios sharing an id break the
+     * `for` that ties each label to its input.
+     */
+    optionSlug(option: DropdownOption): string;
     getOptVal(option: DropdownOption): string | number | boolean;
     getOptLabel(option: DropdownOption): string;
     /** Read-only display — synchronous, per §6.2. See `DropdownFieldComponent.getLabel`. */
     getSelectedLabel(): string;
+    /**
+     * Resolved through `ValidationMessagesService`, so `provideNgxDynamicEntity({
+     * validationMessages })` reaches this field. It used to render a fixed
+     * "This field has an error", which made a documented, configurable feature work on three
+     * of fifteen field types.
+     */
+    get errorMessage(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<RadioFieldComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<RadioFieldComponent, "ngx-radio-field", never, { "field": { "alias": "field"; "required": false; }; "language": { "alias": "language"; "required": false; }; "control": { "alias": "control"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "masked": { "alias": "masked"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 declare class MultiSelectFieldComponent {
+    /**
+     * Unique to this component instance: an `array` renders the same field once per row, and a
+     * DOM id may not repeat. See `field-dom-id.ts`.
+     */
+    private readonly instanceId;
+    protected domId(suffix?: string): string;
+    /** Overridable via MASKED_PLACEHOLDER; the default is the historic literal. */
+    protected readonly maskedText: string;
+    private readonly messages;
     private readonly lookups;
     private _field;
     private _language;
@@ -1678,6 +2153,13 @@ declare class MultiSelectFieldComponent {
     getOptLabel(option: DropdownOption): string;
     /** Read-only display — synchronous, per §6.2. See `DropdownFieldComponent.getLabel`. */
     getLabels(values: unknown): string;
+    /**
+     * Resolved through `ValidationMessagesService`, so `provideNgxDynamicEntity({
+     * validationMessages })` reaches this field. It used to render a fixed
+     * "This field has an error", which made a documented, configurable feature work on three
+     * of fifteen field types.
+     */
+    get errorMessage(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<MultiSelectFieldComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MultiSelectFieldComponent, "ngx-multi-select-field", never, { "field": { "alias": "field"; "required": false; }; "language": { "alias": "language"; "required": false; }; "control": { "alias": "control"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "masked": { "alias": "masked"; "required": false; }; }, {}, never, never, true, never>;
 }
@@ -1691,6 +2173,17 @@ declare class MultiSelectFieldComponent {
  * `EntityRefSelectionService` so the owning form can run `autoPatch`.
  */
 declare class EntityRefFieldComponent implements OnInit {
+    /**
+     * Unique to this component instance: an `array` renders the same field once per row, and a
+     * DOM id may not repeat. See `field-dom-id.ts`.
+     */
+    private readonly instanceId;
+    protected domId(suffix?: string): string;
+    /** Library chrome, overridable via UI_TEXT. */
+    protected readonly ui: UiTextService;
+    /** Overridable via MASKED_PLACEHOLDER; the default is the historic literal. */
+    protected readonly maskedText: string;
+    private readonly messages;
     field: NestedFieldConfig;
     control: AbstractControl;
     language: string;
@@ -1724,12 +2217,21 @@ declare class EntityRefFieldComponent implements OnInit {
     private parentValue;
     /** Reload (and drop a stale selection) whenever the parent control changes. */
     private watchParent;
+    /**
+     * Resolved through `ValidationMessagesService`, so `provideNgxDynamicEntity({
+     * validationMessages })` reaches this field. It used to render a fixed
+     * "This field has an error", which made a documented, configurable feature work on three
+     * of fifteen field types.
+     */
+    get errorMessage(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<EntityRefFieldComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<EntityRefFieldComponent, "ngx-entity-ref-field", never, { "field": { "alias": "field"; "required": false; }; "control": { "alias": "control"; "required": false; }; "language": { "alias": "language"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "masked": { "alias": "masked"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 /** Renders a nested fieldset container for a group field's children. */
 declare class GroupFieldComponent {
+    /** Overridable via MASKED_PLACEHOLDER; the default is the historic literal. */
+    protected readonly maskedText: string;
     field: NestedFieldConfig;
     control: AbstractControl;
     config: EntityFormConfig;
@@ -1745,6 +2247,10 @@ declare class GroupFieldComponent {
 
 /** Renders repeating rows for a FormArray, with Add Item and Remove. */
 declare class ArrayFieldComponent {
+    /** Library chrome, overridable via UI_TEXT. */
+    protected readonly ui: UiTextService;
+    /** Overridable via MASKED_PLACEHOLDER; the default is the historic literal. */
+    protected readonly maskedText: string;
     /**
      * addItem/removeItem are public and may be called from outside this component's template,
      * which under OnPush would not re-render. The host also watches the control, but this
@@ -1776,6 +2282,17 @@ declare class ArrayFieldComponent {
  * it is stored as `{ file }` and previewed from an object URL (revoked when replaced/destroyed).
  */
 declare class ImageFieldComponent implements OnDestroy {
+    /**
+     * Unique to this component instance: an `array` renders the same field once per row, and a
+     * DOM id may not repeat. See `field-dom-id.ts`.
+     */
+    private readonly instanceId;
+    protected domId(suffix?: string): string;
+    /** Library chrome, overridable via UI_TEXT. */
+    protected readonly ui: UiTextService;
+    /** Overridable via MASKED_PLACEHOLDER; the default is the historic literal. */
+    protected readonly maskedText: string;
+    private readonly messages;
     field: NestedFieldConfig;
     control: AbstractControl;
     language: string;
@@ -1792,6 +2309,8 @@ declare class ImageFieldComponent implements OnDestroy {
     onFileSelect(file: File | undefined): Promise<void>;
     remove(): void;
     ngOnDestroy(): void;
+    /** Validation, as distinct from the upload failures this field already reported. */
+    get errorMessage(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<ImageFieldComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<ImageFieldComponent, "ngx-image-field", never, { "field": { "alias": "field"; "required": false; }; "control": { "alias": "control"; "required": false; }; "language": { "alias": "language"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "masked": { "alias": "masked"; "required": false; }; }, {}, never, never, true, never>;
 }
@@ -1801,6 +2320,17 @@ declare class ImageFieldComponent implements OnDestroy {
  * Shares the `FileRef` / `UPLOAD_HANDLER` contract with image-field via FileUploadService.
  */
 declare class FileFieldComponent {
+    /**
+     * Unique to this component instance: an `array` renders the same field once per row, and a
+     * DOM id may not repeat. See `field-dom-id.ts`.
+     */
+    private readonly instanceId;
+    protected domId(suffix?: string): string;
+    /** Library chrome, overridable via UI_TEXT. */
+    protected readonly ui: UiTextService;
+    /** Overridable via MASKED_PLACEHOLDER; the default is the historic literal. */
+    protected readonly maskedText: string;
+    private readonly messages;
     field: NestedFieldConfig;
     control: AbstractControl;
     language: string;
@@ -1815,9 +2345,11 @@ declare class FileFieldComponent {
     fileName(): string | null;
     onFileSelect(file: File | undefined): Promise<void>;
     remove(): void;
+    /** Validation, as distinct from the upload failures this field already reported. */
+    get errorMessage(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<FileFieldComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<FileFieldComponent, "ngx-file-field", never, { "field": { "alias": "field"; "required": false; }; "control": { "alias": "control"; "required": false; }; "language": { "alias": "language"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "masked": { "alias": "masked"; "required": false; }; }, {}, never, never, true, never>;
 }
 
-export { ASYNC_VALIDATOR_REGISTRY, ArrayFieldComponent, BooleanFieldComponent, COMMON_MODULES_REGISTRY, CONFIG_SOURCE, CascadeDataService, CheckboxFieldComponent, ConfigSourceService, CurrencyFieldComponent, DEFAULT_VALIDATION_MESSAGES, DateFieldComponent, DateTimeFieldComponent, DropdownFieldComponent, DynamicFieldComponent, DynamicFormComponent, DynamicRecordFormComponent, ENTITY_REF_CACHE_STORE, ENTITY_REF_REGISTRY, EmailFieldComponent, EntityRefFieldComponent, EntityRefRegistryService, EntityRefSelectionService, EntityReferenceService, FIELD_TYPE_REGISTRY, FIELD_TYPE_SETS, FieldRegistryService, FileFieldComponent, GroupFieldComponent, HOOK_REGISTRY, HookRegistryService, ImageFieldComponent, InMemoryEntityRefCacheStore, LOOKUP_REGISTRY, LookupRegistryService, MARKDOWN_RENDERER, MASKED_ROLES, MarkdownFieldComponent, MonthYearFieldComponent, MultiSelectFieldComponent, NumberFieldComponent, PasswordFieldComponent, RECORD_MIGRATIONS, RadioFieldComponent, RbacService, RulesEvaluationService, SYSTEM_DEFAULT_CAN_EDIT, TextFieldComponent, TextareaFieldComponent, TimeFieldComponent, UPLOAD_HANDLER, VALIDATION_MESSAGES, VALIDATOR_REGISTRY, ValidationMessagesService, ValidatorRegistryService, builtInFieldTypes, provideBuiltInFieldTypes, provideFieldTypes, provideNgxDynamicEntity, refreshChoiceOptions };
-export type { ChoiceOptionHost, ConfigSourceHandler, DynamicFieldComponentContract, EntityRefCacheStore, EntityRefSelection, HookFn, NgxDynamicEntityConfig, ValidationMessage };
+export { ASYNC_VALIDATOR_REGISTRY, ArrayFieldComponent, BooleanFieldComponent, COMMON_MODULES_REGISTRY, CONFIG_SOURCE, CascadeDataService, CheckboxFieldComponent, ConfigSourceService, CurrencyFieldComponent, DEFAULT_UI_TEXT, DEFAULT_VALIDATION_MESSAGES, DateFieldComponent, DateTimeFieldComponent, DropdownFieldComponent, DynamicFieldComponent, DynamicFormComponent, DynamicRecordFormComponent, ENTITY_REF_CACHE_STORE, ENTITY_REF_REGISTRY, EmailFieldComponent, EntityRefFieldComponent, EntityRefRegistryService, EntityRefSelectionService, EntityReferenceService, FIELD_TYPE_REGISTRY, FIELD_TYPE_SETS, FieldRegistryService, FileFieldComponent, GroupFieldComponent, HOOK_REGISTRY, HookRegistryService, ImageFieldComponent, InMemoryEntityRefCacheStore, LOOKUP_REGISTRY, LookupRegistryService, MARKDOWN_RENDERER, MASKED_PLACEHOLDER, MASKED_ROLES, MarkdownFieldComponent, MonthYearFieldComponent, MultiSelectFieldComponent, NumberFieldComponent, PasswordFieldComponent, RECORD_MIGRATIONS, RadioFieldComponent, RbacService, RulesEvaluationService, SYSTEM_DEFAULT_CAN_EDIT, TextFieldComponent, TextareaFieldComponent, TimeFieldComponent, UI_TEXT, UPLOAD_HANDLER, UiTextService, VALIDATION_MESSAGES, VALIDATOR_REGISTRY, ValidationMessagesService, ValidatorRegistryService, builtInFieldTypes, fieldDomId, nextFieldInstanceId, provideBuiltInFieldTypes, provideFieldTypes, provideNgxDynamicEntity, refreshChoiceOptions, resolveUiText };
+export type { ChoiceOptionHost, ConfigSourceHandler, DynamicFieldComponentContract, EntityRefCacheStore, EntityRefSelection, HookFn, NgxDynamicEntityConfig, UiTextKey, UiTextOverrides, UiTextOverridesFor, UiTextParams, UiTextResolver, UiTextResolverFor, UiTextValue, ValidationMessage };