ngx-dynamic-entity 2.1.1 → 2.3.0

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

@@ -1,6 +1,6 @@
 import * as i0 from '@angular/core';
 import { InjectionToken, Type, EnvironmentProviders, WritableSignal, OnInit, OnChanges, OnDestroy, EventEmitter, SimpleChanges, Provider } from '@angular/core';
-import { ReferenceOption, LocalizedText, EntityFormConfig, FormRule, ImportLookups, MappingPlan, ImportResult, TemplateSpec, SheetData, CommonModuleEntry, EntityReferenceLoader, LookupListSource, RecordMigration, FileUploadHandler, FieldValidators, NestedFieldConfig, ReferenceLoaderContext, DropdownOption, LookupListValue, NestedTabConfig, RuleEvaluationResult, FieldScopeEntry, EvaluateFormRulesOptions, ImportColumn, UnsupportedColumn, ImportRowError } from '@dynamic-entity/core';
+import { ReferenceOption, LocalizedText, EntityFormConfig, FormRule, ImportLookups, MappingPlan, CsvDelimiter, ImportResult, TemplateSpec, SheetGrid, CommonModuleEntry, EntityReferenceLoader, LookupListSource, RecordMigration, FileUploadHandler, FieldValidators, NestedFieldConfig, ReferenceLoaderContext, DropdownOption, LookupListValue, NestedTabConfig, RuleEvaluationResult, FieldScopeEntry, EvaluateFormRulesOptions, ImportColumn, MappingEntry, UnsupportedColumn, ImportRowError, SliderBounds } 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, AbstractControl, ValidationErrors, FormGroup, FormArray } from '@angular/forms';
 import * as rxjs from 'rxjs';
@@ -83,6 +83,10 @@ declare const DEFAULT_UI_TEXT: {
     noImage: string;
     uploadImage: string;
     changeImage: string;
+    ratingValue: string;
+    clearValue: string;
+    addTagPlaceholder: string;
+    removeTag: string;
     month: string;
     year: string;
     write: string;
@@ -116,7 +120,15 @@ declare const DEFAULT_UI_TEXT: {
     importGuessed: string;
     importMappedCount: string;
     importRequiredUnmapped: string;
+    importConstant: string;
+    importAddSlot: string;
+    importStaleHeading: string;
+    importStaleExplain: string;
+    importRemoveEntry: string;
     importPreviewHeading: string;
+    importDelimiterComma: string;
+    importDelimiterSemicolon: string;
+    importDelimiterTab: string;
     importRowRejected: string;
     importRunImport: string;
     importImporting: string;
@@ -215,27 +227,35 @@ declare class UiTextService {
 /**
  * Reads an uploaded file into headers and positional rows.
  *
- * Positional (`string[][]`), not keyed by header, because a real sheet carries duplicate
- * headers and blank ones — and because a mapping entry addresses a column by index for
- * exactly that reason. A parser that returned objects keyed by header would silently lose
- * the second of two columns both called "Notes".
+ * Positional, not keyed by header, because a real sheet carries duplicate headers and blank
+ * ones — and because a mapping entry addresses a column by index for exactly that reason. A
+ * parser that returned objects keyed by header would silently lose the second of two columns
+ * both called "Notes".
  *
- * The library ships a CSV implementation and no more. Registering one that understands
+ * Cells may keep their types (`SheetGrid`): a date cell handed over as a `Date` at UTC midnight
+ * is imported as that calendar date, exactly as the server reads the same workbook, where its
+ * text is whatever a library's formatter printed. A parser returning text (`SheetData`, as 2.2's
+ * did) still fits.
+ *
+ * The library ships a delimited-text reader and no more. Registering one that understands
  * `.xlsx` is how a consumer adds it, and which spreadsheet library they use stays their
  * choice — this package has no runtime dependency and gains none here.
  *
  * @example
+ * // SheetJS 0.20.3+ from https://cdn.sheetjs.com — the npm `xlsx` package stopped at 0.18.5,
+ * // which has known vulnerabilities. `UTC: true` matters: without it a date cell arrives at
+ * // *local* midnight, which is the previous day in UTC for anyone east of Greenwich.
  * provideNgxDynamicEntity({
  *   sheetParser: async file => {
- *     const workbook = XLSX.read(await file.arrayBuffer());
+ *     const workbook = XLSX.read(await file.arrayBuffer(), { cellDates: true });
  *     const rows = XLSX.utils.sheet_to_json(workbook.Sheets[workbook.SheetNames[0]], {
- *       header: 1, raw: false, defval: '',
- *     }) as string[][];
- *     return { headers: rows[0] ?? [], rows: rows.slice(1) };
+ *       header: 1, raw: true, defval: '', UTC: true,
+ *     }) as unknown[][];
+ *     return { headers: (rows[0] ?? []).map(cellText), rows: rows.slice(1) };
  *   },
  * })
  */
-type SheetParser = (file: File) => SheetData | Promise<SheetData>;
+type SheetParser = (file: File) => SheetGrid | Promise<SheetGrid>;
 /** The formats a generated template can be written in. CSV needs no dependency. */
 type TemplateFormat = 'csv' | 'xlsx';
 /** What the wizard needs to know about the entity it is importing into. */
@@ -262,6 +282,13 @@ interface ImportPreview {
     suggestion: MappingPlan;
     /** Total data rows in the file, which may be far more than `sample` holds. */
     rowCount: number;
+    /**
+     * Rows of each repeating field the suggestion was sized for (`arrayBoundFor`). Optional so a
+     * transport written for 2.2 keeps compiling; the mapper sizes itself the same way regardless.
+     */
+    arrayBound?: number;
+    /** The field separator a delimited-text file used. Absent for a workbook. */
+    delimiter?: CsvDelimiter;
 }
 /**
  * Where the work happens.
@@ -616,7 +643,7 @@ declare const provideNgxDynamicEntity: (config?: NgxDynamicEntityConfig) => Envi
  *
  * `FieldRegistryService` imports no components. Whatever you register here is what gets
  * bundled, so an app that only uses text/number/dropdown pays for three components and
- * their imports, not twenty-one.
+ * their imports, not twenty-seven.
  *
  * ```ts
  * // Everything (convenient; bundles all built-ins):
@@ -632,7 +659,7 @@ declare const provideNgxDynamicEntity: (config?: NgxDynamicEntityConfig) => Envi
 declare function builtInFieldTypes(): Record<string, Type<any>>;
 /** Register a specific set of field types. Only the components you name are bundled. */
 declare function provideFieldTypes(types: Record<string, Type<any>>): EnvironmentProviders;
-/** Register all 21 built-in field type keys. Convenience for apps that use most of them. */
+/** Register all 27 built-in field type keys. Convenience for apps that use most of them. */
 declare function provideBuiltInFieldTypes(): EnvironmentProviders;
 
 /**
@@ -678,6 +705,10 @@ declare class HookRegistryService {
     static ɵprov: i0.ɵɵInjectableDeclaration<HookRegistryService>;
 }
 
+/** The built-in web address check. The rule itself is in core, so an import applies the same one. */
+declare const urlValidator: ValidatorFn;
+/** The built-in phone number check. The rule itself is in core, so an import applies the same one. */
+declare const phoneValidator: ValidatorFn;
 /**
  * ValidatorRegistryService — resolves validator configs / key strings to Angular ValidatorFns.
  */
@@ -993,6 +1024,11 @@ interface RuleSyncContext {
     addressOf(field: NestedFieldConfig): string;
     /** The control a scope entry addresses, or `null` when it has no static path. */
     controlFor(entry: FieldScopeEntry): AbstractControl | null;
+    /**
+     * The config the entries came from. Needed to know which tab owns each field: a tab that is
+     * not rendered hides every field it owns. Omitted, only field-level visibility applies.
+     */
+    config?: EntityFormConfig | null;
 }
 /**
  * RulesEvaluationService — evaluates rules, and owns what a result *means*.
@@ -1038,12 +1074,25 @@ declare class RulesEvaluationService {
      * The predicate is `isFieldVisible`, the same one the render filter uses, so what is on
      * screen and what counts toward validity cannot drift apart.
      *
+     * A tab that is not rendered — hidden by a rule, or `visibility: false` with no rule showing
+     * it — hides everything it owns, sub-tabs and container children included. Only fields were
+     * checked here, so a rule hiding a tab with a required field on it left the form invalid
+     * with the field out of sight and out of the error summary: Save did nothing, silently.
+     * Import already relaxed a hidden tab's fields, so the form refused rows import accepted.
+     *
      * Entries must arrive parent-first, which is what `collectFieldScopes` yields: a container's
      * children are skipped once the container itself is hidden, because Angular's `disable()`
      * cascades to descendants and a child's `enable()` walks back up recalculating ancestors.
      * Toggling a child inside a hidden group would fight its parent.
      */
     syncHiddenFieldState(entries: readonly FieldScopeEntry[], ctx: RuleSyncContext): void;
+    /**
+     * Every field owned by a tab that does not render, under `isTabVisible`'s precedence.
+     *
+     * Stops descending at the first hidden tab: `fieldsUnderTab` already covers its sub-tabs,
+     * and a sub-tab of a hidden tab is not rendered whatever its own visibility says.
+     */
+    private fieldsOnHiddenTabs;
     /**
      * The hidden and shown names as sets, memoised against the result they came from.
      *
@@ -2127,6 +2176,8 @@ declare class EntityImportComponent {
     protected readonly headers: i0.WritableSignal<string[]>;
     protected readonly sample: i0.WritableSignal<string[][]>;
     protected readonly rowCount: i0.WritableSignal<number>;
+    /** The separator a delimited file turned out to use, so the user can see how it was read. */
+    protected readonly delimiter: i0.WritableSignal<CsvDelimiter>;
     protected readonly fileName: i0.WritableSignal<string>;
     protected readonly plan: i0.WritableSignal<MappingPlan>;
     protected readonly result: i0.WritableSignal<ImportResult>;
@@ -2178,6 +2229,10 @@ declare class EntityImportComponent {
      * exact and `failed` is absent.
      */
     protected failedRowCount(result: ImportResult): number;
+    /** The decimal mark the commit will read numbers with, so the preview reads them the same. */
+    protected decimal(): '.' | ',';
+    /** How the file's columns were split, in words — or nothing for a workbook. */
+    protected delimiterText(): string | null;
     protected restart(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<EntityImportComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<EntityImportComponent, "ngx-entity-import", never, { "config": { "alias": "config"; "required": true; }; "rules": { "alias": "rules"; "required": false; }; "lookups": { "alias": "lookups"; "required": false; }; "language": { "alias": "language"; "required": false; }; "templateFormat": { "alias": "templateFormat"; "required": false; }; }, { "importComplete": "importComplete"; "templateReady": "templateReady"; }, never, never, true, never>;
@@ -2186,9 +2241,18 @@ declare class EntityImportComponent {
 /** One target field, and which of the sheet's columns feeds it. */
 interface MappingRow {
     column: ImportColumn;
-    /** Index into the sheet's headers, or `null` for "not imported". */
+    /** Index into the sheet's headers, `CONSTANT` for a fixed value, or `null` for "not imported". */
     source: number | null;
     guessed: boolean;
+    /** The incoming plan's entry for this field, emitted untouched until the user changes it. */
+    entry?: MappingEntry;
+    /** The user changed this row, so `entry` no longer describes it. */
+    dirty: boolean;
+}
+/** A repeating field, for its "Add a row" button. */
+interface ArraySlots {
+    arrayRef: string;
+    label: string;
 }
 /**
  * Match the sheet's columns to the config's fields.
@@ -2219,11 +2283,39 @@ declare class ImportMapperComponent implements OnChanges {
      * attachment column was never going to arrive.
      */
     protected readonly unsupported: i0.WritableSignal<number>;
+    /** A plan entry whose field this config no longer has. Kept, and emitted, until removed. */
+    protected readonly stale: i0.WritableSignal<MappingEntry[]>;
+    /** Repeating fields the user can add a row to. */
+    protected readonly arrays: i0.WritableSignal<ArraySlots[]>;
+    protected readonly constant = -1;
+    /** Rows added by hand per repeating field, on top of what the sheet and plan imply. */
+    private readonly extraSlots;
+    /** The incoming plan, read through the 2.2 alias. Every entry in it survives `toPlan`. */
+    private incoming;
     ngOnChanges(): void;
+    /**
+     * Rows for every field, sized so nothing the plan or the sheet names is out of reach.
+     *
+     * Sizing from the default three meant a sheet with `Phone 4` could not be mapped at all,
+     * and a stored plan reaching further lost those entries on the next change — `toPlan` only
+     * ever emitted rows, and there were none for them.
+     */
+    private rebuild;
     protected mappedCount(): number;
     protected missingRequired(): number;
+    protected hasConstant(row: MappingRow): boolean;
+    protected constantText(entry: MappingEntry): string;
     protected choose(row: MappingRow, source: number | null): void;
-    /** The current selections as the plan that will be applied. */
+    /** One more row for one repeating field, for this session. */
+    protected addSlot(arrayRef: string): void;
+    protected removeStale(entry: MappingEntry): void;
+    /**
+     * The current selections as the plan that will be applied.
+     *
+     * Every entry of the incoming plan survives in its own position — a fixed value, a ref the
+     * config no longer has — unless the user changed or removed it, and an untouched entry is
+     * emitted exactly as it arrived. New selections follow, in field order.
+     */
     private toPlan;
     static ɵfac: i0.ɵɵFactoryDeclaration<ImportMapperComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<ImportMapperComponent, "ngx-import-mapper", never, { "config": { "alias": "config"; "required": true; }; "headers": { "alias": "headers"; "required": false; }; "plan": { "alias": "plan"; "required": false; }; "language": { "alias": "language"; "required": false; }; }, { "planChange": "planChange"; }, never, never, true, never>;
@@ -2271,13 +2363,15 @@ declare class ImportPreviewComponent implements OnChanges {
     /** The same rules the commit will apply; without them a rule-driven rejection is invisible. */
     rules?: readonly FormRule[];
     language: string;
+    /** The decimal mark number cells use — the one the commit will read them with. */
+    decimal: '.' | ',';
     protected readonly ui: UiTextService;
     /** The columns this plan fills, in the plan's own order. */
     protected readonly columns: i0.WritableSignal<ImportColumn[]>;
     protected readonly grid: i0.WritableSignal<PreviewRow[]>;
     ngOnChanges(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ImportPreviewComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ImportPreviewComponent, "ngx-import-preview", never, { "config": { "alias": "config"; "required": true; }; "plan": { "alias": "plan"; "required": true; }; "rows": { "alias": "rows"; "required": false; }; "lookups": { "alias": "lookups"; "required": false; }; "rules": { "alias": "rules"; "required": false; }; "language": { "alias": "language"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ImportPreviewComponent, "ngx-import-preview", never, { "config": { "alias": "config"; "required": true; }; "plan": { "alias": "plan"; "required": true; }; "rows": { "alias": "rows"; "required": false; }; "lookups": { "alias": "lookups"; "required": false; }; "rules": { "alias": "rules"; "required": false; }; "language": { "alias": "language"; "required": false; }; "decimal": { "alias": "decimal"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 /** One field offered for the template, with the guidance that belongs to it. */
@@ -3257,5 +3351,261 @@ declare class FileFieldComponent {
     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_UI_TEXT, DEFAULT_VALIDATION_MESSAGES, DateFieldComponent, DateTimeFieldComponent, DropdownFieldComponent, DynamicFieldComponent, DynamicFormComponent, DynamicRecordFormComponent, ENTITY_REF_CACHE_STORE, ENTITY_REF_REGISTRY, EmailFieldComponent, EntityImportComponent, EntityRefFieldComponent, EntityRefRegistryService, EntityRefSelectionService, EntityReferenceService, FIELD_TYPE_REGISTRY, FIELD_TYPE_SETS, FieldRegistryService, FileFieldComponent, GroupFieldComponent, HOOK_REGISTRY, HookRegistryService, HttpImportTransport, IMPORT_TRANSPORT, ImageFieldComponent, ImportErrorsComponent, ImportMapperComponent, ImportPreviewComponent, ImportTemplateComponent, InMemoryEntityRefCacheStore, LOOKUP_REGISTRY, LocalImportTransport, LookupRegistryService, MARKDOWN_RENDERER, MASKED_PLACEHOLDER, MASKED_ROLES, MarkdownFieldComponent, MonthYearFieldComponent, MultiSelectFieldComponent, NumberFieldComponent, PasswordFieldComponent, RECORD_MIGRATIONS, RadioFieldComponent, RbacService, RulesEvaluationService, SHEET_PARSER, SYSTEM_DEFAULT_CAN_EDIT, TextFieldComponent, TextareaFieldComponent, TimeFieldComponent, UI_TEXT, UPLOAD_HANDLER, UiTextService, VALIDATION_MESSAGES, VALIDATOR_REGISTRY, ValidationMessagesService, ValidatorRegistryService, builtInFieldTypes, defaultSheetParser, fieldDescribedBy, fieldDomId, nextFieldInstanceId, provideBuiltInFieldTypes, provideFieldTypes, provideHttpImportTransport, provideNgxDynamicEntity, refreshChoiceOptions, resolveUiText };
+/**
+ * URL field: a `type="url"` input, and a link when read-only.
+ *
+ * The read-only link is rendered only for a value that passes `isValidUrl`, meaning an http or
+ * https address. A record can hold anything, including `javascript:`, and a field whose job is
+ * to show an address must not turn a stored script into something to click. Anything else is
+ * shown as plain text.
+ */
+declare class UrlFieldComponent {
+    /**
+     * 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;
+    readonly: boolean;
+    masked: boolean;
+    get label(): string;
+    get placeholder(): string;
+    /** Author help text, shown under the control and named by `aria-describedby`. */
+    get hint(): string;
+    /** Whether the stored value is an http(s) address, and so safe to render as a link. */
+    get linkable(): boolean;
+    /** The ids of whatever is describing this control right now. */
+    protected describedBy(): string | null;
+    get errorMessage(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UrlFieldComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UrlFieldComponent, "ngx-url-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>;
+}
+
+/**
+ * Phone field: a `type="tel"` input, and a `tel:` link when read-only.
+ *
+ * The value is stored exactly as typed, spaces and brackets included. The number is shown back
+ * to people far more often than it is dialled, and `+44 20 7946 0958` is easier to read than
+ * its digits run together. Only the link target is stripped down to what a dialler needs.
+ */
+declare class PhoneFieldComponent {
+    /**
+     * 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;
+    readonly: boolean;
+    masked: boolean;
+    get label(): string;
+    get placeholder(): string;
+    /** Author help text, shown under the control and named by `aria-describedby`. */
+    get hint(): string;
+    /** `tel:` plus the digits and a leading `+`, or null for a value that is not a phone number. */
+    get dialHref(): string | null;
+    /** The ids of whatever is describing this control right now. */
+    protected describedBy(): string | null;
+    get errorMessage(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PhoneFieldComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PhoneFieldComponent, "ngx-phone-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>;
+}
+
+/**
+ * Slider field: a range input over `validators.min`–`validators.max` in steps of `field.step`.
+ *
+ * A range input cannot show that it is empty. With no value it puts the thumb at the midpoint,
+ * which looks exactly like a chosen value. The readout beside it is therefore the value itself,
+ * and shows a dash until someone moves the thumb. Without it, a required slider nobody touched
+ * would look answered and still fail at save.
+ */
+declare class SliderFieldComponent {
+    /**
+     * 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;
+    readonly: boolean;
+    masked: boolean;
+    get label(): string;
+    /** Author help text, shown under the control and named by `aria-describedby`. */
+    get hint(): string;
+    get bounds(): SliderBounds;
+    /** Whether the control holds a number. The thumb's position cannot say. */
+    get hasValue(): boolean;
+    get display(): string;
+    /** The ids of whatever is describing this control right now. */
+    protected describedBy(): string | null;
+    get errorMessage(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SliderFieldComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SliderFieldComponent, "ngx-slider-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>;
+}
+
+/**
+ * Rating field: 1 to `validators.max` stars (default 5), stored as a number.
+ *
+ * Built from native radio inputs in a fieldset, not clickable spans. That gives it the
+ * behaviour a radio group already has: arrow keys move the choice, Tab enters and leaves the
+ * group once, and a screen reader announces "3 of 5, radio button, 3 of 5". Each star's
+ * label is text a host can translate (`ratingValue`), because a star glyph read aloud is
+ * "black star".
+ */
+declare class RatingFieldComponent 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 readonly cdr;
+    protected readonly ui: UiTextService;
+    field: NestedFieldConfig;
+    language: string;
+    readonly: boolean;
+    masked: boolean;
+    private _control;
+    private _controlSub?;
+    /**
+     * Subscribed because the radios are not bound through a form directive. A value patched in
+     * from outside (a reset, an autoPatch) would otherwise leave an OnPush view showing the old
+     * stars.
+     */
+    set control(value: AbstractControl);
+    get control(): AbstractControl;
+    ngOnDestroy(): void;
+    get label(): string;
+    /** Author help text, shown under the control and named by `aria-describedby`. */
+    get hint(): string;
+    get scale(): number;
+    get stars(): number[];
+    /** The stored rating, or null when there is none or it is not a star on this scale. */
+    get current(): number | null;
+    select(star: number): void;
+    clear(): void;
+    /** The ids of whatever is describing this control right now. */
+    protected describedBy(): string | null;
+    get errorMessage(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RatingFieldComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RatingFieldComponent, "ngx-rating-field", never, { "field": { "alias": "field"; "required": false; }; "language": { "alias": "language"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "masked": { "alias": "masked"; "required": false; }; "control": { "alias": "control"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Colour field: a native colour picker, storing `#rrggbb`.
+ *
+ * Like a range input, a colour input has no empty state and shows black. The code beside it is
+ * therefore the real value, a dash until a colour is chosen, and a clear button sets the value
+ * back to nothing. Without them, "no colour" and "black" would look the same.
+ *
+ * Only a value that passes `normalizeHexColor` reaches a `style` binding. A record can hold
+ * any string, and a colour swatch is no place to interpret one.
+ */
+declare class ColorFieldComponent {
+    /**
+     * 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;
+    protected readonly ui: UiTextService;
+    field: NestedFieldConfig;
+    control: AbstractControl;
+    language: string;
+    readonly: boolean;
+    masked: boolean;
+    get label(): string;
+    /** Author help text, shown under the control and named by `aria-describedby`. */
+    get hint(): string;
+    /** The stored colour as `#rrggbb`, or null when there is none or it is not a colour. */
+    get hex(): string | null;
+    clear(): void;
+    /** The ids of whatever is describing this control right now. */
+    protected describedBy(): string | null;
+    get errorMessage(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ColorFieldComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ColorFieldComponent, "ngx-color-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>;
+}
+
+/**
+ * Tags field: free text entered as a list of chips, stored as `string[]`.
+ *
+ * Unlike `multiSelect`, the values are whatever the user types, so there is no option list to
+ * keep in step. Enter or a comma ends a tag, Backspace in an empty box removes the last one,
+ * and pasted text is split on commas, semicolons and line breaks. Leaving the box commits
+ * what is in it, so a tag someone typed and then tabbed away from is not silently lost.
+ *
+ * The control holds the array. The text box is only a draft, which is why it is not bound
+ * with a form directive.
+ */
+declare class TagsFieldComponent 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 readonly cdr;
+    protected readonly ui: UiTextService;
+    field: NestedFieldConfig;
+    language: string;
+    readonly: boolean;
+    masked: boolean;
+    private _control;
+    private _controlSub?;
+    /** Subscribed for the same reason as the rating field: nothing here is a form directive. */
+    set control(value: AbstractControl);
+    get control(): AbstractControl;
+    ngOnDestroy(): void;
+    get label(): string;
+    get placeholder(): string;
+    /** Author help text, shown under the control and named by `aria-describedby`. */
+    get hint(): string;
+    /** The stored tags, read leniently. A record may hold a single string or anything else. */
+    get tags(): string[];
+    onKeydown(event: KeyboardEvent, entry: HTMLInputElement): void;
+    onPaste(event: ClipboardEvent, entry: HTMLInputElement): void;
+    onBlur(entry: HTMLInputElement): void;
+    /** Add whatever is in the draft box, split on separators, and empty it. */
+    commit(entry: HTMLInputElement): void;
+    private add;
+    remove(tag: string): void;
+    /**
+     * An empty list is stored as `[]`, not `null`. `required` treats both as empty, and `[]`
+     * stays the same shape as every other value this field holds.
+     */
+    private write;
+    /** The ids of whatever is describing this control right now. */
+    protected describedBy(): string | null;
+    get errorMessage(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TagsFieldComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TagsFieldComponent, "ngx-tags-field", never, { "field": { "alias": "field"; "required": false; }; "language": { "alias": "language"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "masked": { "alias": "masked"; "required": false; }; "control": { "alias": "control"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+export { ASYNC_VALIDATOR_REGISTRY, ArrayFieldComponent, BooleanFieldComponent, COMMON_MODULES_REGISTRY, CONFIG_SOURCE, CascadeDataService, CheckboxFieldComponent, ColorFieldComponent, ConfigSourceService, CurrencyFieldComponent, DEFAULT_UI_TEXT, DEFAULT_VALIDATION_MESSAGES, DateFieldComponent, DateTimeFieldComponent, DropdownFieldComponent, DynamicFieldComponent, DynamicFormComponent, DynamicRecordFormComponent, ENTITY_REF_CACHE_STORE, ENTITY_REF_REGISTRY, EmailFieldComponent, EntityImportComponent, EntityRefFieldComponent, EntityRefRegistryService, EntityRefSelectionService, EntityReferenceService, FIELD_TYPE_REGISTRY, FIELD_TYPE_SETS, FieldRegistryService, FileFieldComponent, GroupFieldComponent, HOOK_REGISTRY, HookRegistryService, HttpImportTransport, IMPORT_TRANSPORT, ImageFieldComponent, ImportErrorsComponent, ImportMapperComponent, ImportPreviewComponent, ImportTemplateComponent, InMemoryEntityRefCacheStore, LOOKUP_REGISTRY, LocalImportTransport, LookupRegistryService, MARKDOWN_RENDERER, MASKED_PLACEHOLDER, MASKED_ROLES, MarkdownFieldComponent, MonthYearFieldComponent, MultiSelectFieldComponent, NumberFieldComponent, PasswordFieldComponent, PhoneFieldComponent, RECORD_MIGRATIONS, RadioFieldComponent, RatingFieldComponent, RbacService, RulesEvaluationService, SHEET_PARSER, SYSTEM_DEFAULT_CAN_EDIT, SliderFieldComponent, TagsFieldComponent, TextFieldComponent, TextareaFieldComponent, TimeFieldComponent, UI_TEXT, UPLOAD_HANDLER, UiTextService, UrlFieldComponent, VALIDATION_MESSAGES, VALIDATOR_REGISTRY, ValidationMessagesService, ValidatorRegistryService, builtInFieldTypes, defaultSheetParser, fieldDescribedBy, fieldDomId, nextFieldInstanceId, phoneValidator, provideBuiltInFieldTypes, provideFieldTypes, provideHttpImportTransport, provideNgxDynamicEntity, refreshChoiceOptions, resolveUiText, urlValidator };
 export type { ChoiceOptionHost, ConfigSourceHandler, DynamicFieldComponentContract, EntityRefCacheStore, EntityRefSelection, HookFn, HttpImportTransportOptions, ImportContext, ImportPreview, ImportTransport, InvalidField, MessageOrderEntry, NgxDynamicEntityConfig, RuleSyncContext, SheetParser, TemplateFormat, UiTextKey, UiTextOverrides, UiTextOverridesFor, UiTextParams, UiTextResolver, UiTextResolverFor, UiTextValue, ValidationMessage };