iss-ctrl 0.0.21 → 0.0.23

package/types/iss-ctrl.d.ts

@@ -1,1946 +1,399 @@
+import { Option, I18n } from 'iss-ctrl/base';
+export * from 'iss-ctrl/base';
+import { IssAttachment } from 'iss-ctrl/tokens';
+export * from 'iss-ctrl/tokens';
 import * as i0 from '@angular/core';
-import { InputSignal, WritableSignal, OutputEmitterRef, OnInit, OnDestroy, Signal, Type, DestroyRef, StaticProvider, InjectionToken, PipeTransform, Injector, Provider } from '@angular/core';
-import { ControlValueAccessor, Validator, FormControl, AbstractControl, ValidationErrors, NgControl, FormGroup, ValidatorFn, AsyncValidatorFn, ControlContainer } from '@angular/forms';
-import { ErrorStateMatcher, MatDateFormats, NativeDateAdapter } from '@angular/material/core';
-import { MatChipInputEvent } from '@angular/material/chips';
-import { MatDatepickerInputEvent } from '@angular/material/datepicker';
-import { PhoneNumber } from 'libphonenumber-js/mobile';
+import { Type, WritableSignal, OnInit, OnDestroy, OutputEmitterRef, InputSignal, PipeTransform, Injector, DestroyRef, StaticProvider, InjectionToken } from '@angular/core';
+import { AbstractControl, FormGroup, ValidatorFn, AsyncValidatorFn, ControlContainer, FormControl, ValidationErrors } from '@angular/forms';
 import { Observable, BehaviorSubject } from 'rxjs';
+import { IssFile } from 'iss-ctrl/file-picker';
 
-interface Option {
-    value: string;
-    label: string;
+declare class Loader {
+    #private;
+    loadComponent(field: IssField): Observable<Type<any> | null>;
+    loadViewer(type: string): Observable<Type<any> | null>;
+    loadService<T>(serviceName: string): undefined | (() => Promise<T>);
+    static ɵfac: i0.ɵɵFactoryDeclaration<Loader, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<Loader>;
 }
 
-type HintAlignment = "start" | "end";
-interface Hint {
-    key: string;
-    label: string;
-    valid: boolean | undefined;
-    align: HintAlignment;
+declare class FieldAsyncValidation {
+    alreadyExists: string | undefined;
+    constructor(asyncValidation: any);
 }
 
 /**
- * Base class for every `iss-ctrl-*` control.
- *
- * Controls are the presentational layer: they know nothing about {@link IssField} and are
- * driven purely by bindings, so they can be used standalone inside any reactive form.
- * Every control below inherits the properties declared here and adds its own on top.
- *
- * ### Inherited inputs
- * | Property | Type | Default | Description |
- * | --- | --- | --- | --- |
- * | `formControlName` | `string` | `""` | Name of the control in the surrounding `FormGroup`. |
- * | `placeholder` | `string` | `""` | Placeholder text shown while the field is empty. |
- * | `readonly` | `boolean` | `false` | Renders the value but blocks every interaction. |
- * | `multiple` | `boolean \| undefined` | `false` | Allows more than one value, where the control supports it. |
- * | `min` | `number \| string \| null` | `null` | Lower bound (number or date/time string). |
- * | `max` | `number \| string \| null` | `null` | Upper bound (number or date/time string). |
- * | `minLength` | `number \| null` | `null` | Minimum number of characters. |
- * | `maxLength` | `number \| null` | `null` | Maximum number of characters. |
- * | `hints` | `Hint[]` | `[]` | Helper messages rendered under the field. |
- * | `className` | `string \| null` | `null` | Extra CSS classes for the host. |
- *
- * ### Inherited outputs
- * | Event | Payload | Description |
- * | --- | --- | --- |
- * | `(onChange)` | `any` | Fires after every committed value change. |
+ * Per-field configuration, reachable as `field.config` and consumed by the `iss-field-*`
+ * components. Every entry is a signal, so it can be changed at runtime by field events.
  *
- * ### Not inputs
- * `disabled` and `touched` are signals owned by the control. Disable a control through the
- * forms API (`ctrl.disable()` or a `disabled` field config), never with a template binding.
+ * Not every key applies to every field — the class doc of each `iss-field-*` component
+ * lists exactly which of these it reads.
  *
- * ### Content projection
- * Controls that render a `mat-form-field` project `<label>` into the floating label.
- * `upgrade.scss` reveals that space only while the projected `<label>` carries text, so an
- * omitted label — or one that interpolates to an empty string — collapses it. No label markup
- * is removed at runtime, so a label that arrives later simply shows up.
+ * ### Keys by area
+ * - **Common:** `type` · `disabled` · `readonly` · `placeholder` · `suffix` · `hideLabel` · `multiple`
+ * - **Bounds:** `min` · `max` · `minLength` · `maxLength`
+ * - **Dates:** `minDate` · `maxDate` · `dateFilter` · `hijriCalendar` · `emitHijri`
+ * - **Attachments:** `allowedFileSize` · `allowedFileTypes` · `minFilesCount` · `maxFilesCount` · `templateId` · `templateUrl`
+ * - **Users:** `minUsersCount` · `maxUsersCount`
+ * - **Table:** `showInTableColumns` · `tableWithFilter` · `tableWithSort` · `tableWithPagination`
  *
  * @example
- * ```html
- * <iss-ctrl-input formControlName="email" [readonly]="false" (onChange)="save($event)">
- *   <label>Email</label>
- * </iss-ctrl-input>
+ * ```json
+ * { "name": "email", "type": "text_input", "config": { "type": "email", "maxLength": 120 } }
  * ```
  */
-declare class ControlBase implements ControlValueAccessor, Validator {
-    #private;
-    /**
-     * Name of this control inside the surrounding `FormGroup`.
-     */
-    formControlName: InputSignal<string>;
-    /**
-     * Lower bound forwarded to the underlying input — a number, or a date/time string.
-     */
-    min: InputSignal<number | string | null>;
-    /**
-     * Upper bound forwarded to the underlying input — a number, or a date/time string.
-     */
-    max: InputSignal<number | string | null>;
-    /**
-     * Minimum number of characters accepted by the underlying input.
-     */
-    minLength: InputSignal<number | null>;
-    /**
-     * Maximum number of characters accepted by the underlying input.
-     */
-    maxLength: InputSignal<number | null>;
+declare class FieldConfig {
     /**
-     * Disabled state. **Not an input** — it is set by the forms API through
-     * {@link ControlBase.setDisabledState}. Disable via `ctrl.disable()` or the field config.
+     * Native input type for `text_input` (`text`, `email`, `number`, `password`, …).
      */
-    disabled: WritableSignal<boolean>;
+    type: WritableSignal<string | undefined>;
     /**
-     * Renders the current value but blocks every user interaction.
+     * Disables the control; the underlying `FormControl` is disabled on init.
      */
-    readonly: InputSignal<boolean>;
+    disabled: WritableSignal<boolean | undefined>;
     /**
-     * Allows selecting/entering more than one value, on controls that support it.
+     * Shows the value but blocks interaction. Unlike `disabled`, the value is still submitted.
      */
-    multiple: InputSignal<boolean | undefined>;
+    readonly: WritableSignal<boolean | undefined>;
     /**
-     * Placeholder text shown while the control has no value.
+     * Placeholder text shown while the field is empty.
      */
-    placeholder: InputSignal<string>;
+    placeholder: WritableSignal<string | undefined>;
     /**
-     * Helper messages rendered beneath the field. See {@link Hint}.
+     * Text rendered after the value (a unit or currency, for example).
      */
-    hints: InputSignal<Hint[]>;
+    suffix: WritableSignal<string | undefined>;
     /**
-     * Extra CSS class names applied to the control host.
+     * Hides the field label without removing it from the accessibility tree.
      */
-    className: InputSignal<string | null>;
+    hideLabel: WritableSignal<boolean | undefined>;
     /**
-     * Whether the user has interacted with the control. Owned by the control, not an input.
+     * Allows more than one value — multi select, multi file upload, multi toggle.
      */
-    touched: WritableSignal<boolean>;
+    multiple: WritableSignal<boolean | undefined>;
     /**
-     * Emits the committed value after every change.
+     * Minimum number of characters. Source: `config.minLength`.
      */
-    onChange: OutputEmitterRef<any>;
-    protected ctrl: FormControl;
+    minLength: WritableSignal<number | undefined>;
     /**
-     * Error state for the inner `mat-form-field`, derived from the **host** control.
-     *
-     * Material reads `errorState` off the `NgControl` bound to its own `matInput` — here that is
-     * {@link ControlBase.ctrl}, which carries no validators and is therefore always valid. Every
-     * error a consumer cares about (the field config's validators plus the control's own
-     * {@link ControlBase.validate}) lives on the host control instead, so without this matcher an
-     * invalid `iss-ctrl-*` would keep rendering the valid outline. Bind it on the `matInput` as
-     * `[errorStateMatcher]="errorStateMatcher"`.
+     * Maximum number of characters. Source: `config.maxLength`.
      */
-    protected errorStateMatcher: ErrorStateMatcher;
-    registerOnChange(fn: () => void): void;
-    registerOnTouched(fn: () => void): void;
-    setDisabledState(isDisabled: boolean): void;
-    writeValue(value: string | FormData | Date | null): void;
-    markAsTouched(): void;
-    validate(control: AbstractControl): ValidationErrors | null;
+    maxLength: WritableSignal<number | undefined>;
     /**
-     * The `NgControl` this component is bound to from the outside (`formControlName`,
-     * `[formControl]` or `[ngModel]`), or `null` when it is used without one.
+     * Minimum numeric value (also the minimum user count for the user picker).
      */
-    protected hostControl(): NgControl | null;
+    min: WritableSignal<number | undefined>;
     /**
-     * Whether the control currently holds no value.
-     *
-     * Reflected on the host as `iss-ctrl-empty`, which is what `upgrade.scss` uses to keep the
-     * resting outline of an empty field: Material's own `mat-form-field-hide-placeholder` drops
-     * off the moment the field is focused, so the border would change colour on focus alone.
-     * Override it in a control whose value does not live on {@link ControlBase.ctrl}.
+     * Maximum numeric value (also the maximum user count for the user picker).
      */
-    protected isEmpty(): boolean;
-    protected onTouch: () => void;
-    protected onPropagateValue: (_: any) => void;
-    protected emitValue(value?: any): void;
-    protected propagateValue(value?: any): void;
-    protected emitOnChangeEvent($event?: any): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ControlBase, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ControlBase, "ng-component", never, { "formControlName": { "alias": "formControlName"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "hints": { "alias": "hints"; "required": false; "isSignal": true; }; "className": { "alias": "className"; "required": false; "isSignal": true; }; }, { "onChange": "onChange"; }, never, never, true, never>;
-}
-
-/**
- * `<iss-ctrl-checkbox>` — a list of checkboxes over a fixed set of options.
- *
- * The form value is the comma separated list of selected option values, while `(onChange)`
- * emits the resolved `Option[]` (or `null` when nothing is selected).
- *
- * @example
- * ```html
- * <iss-ctrl-checkbox formControlName="days" [options]="days" (onChange)="pick($event)"/>
- * ```
- *
- * ### Own inputs
- * | Property | Type | Default | Description |
- * | --- | --- | --- | --- |
- * | `options` | `Option[]` | **required** | The selectable choices. |
- *
- * ### Inherited from {@link ControlBase}
- * `formControlName` · `readonly` · `className` · `(onChange)`
- *
- * Does not project a label — the field label is rendered by the wrapping `iss-field-*`.
- */
-declare class CheckboxControl extends ControlBase {
-    #private;
+    max: WritableSignal<number | undefined>;
     /**
-     * Selectable choices, each a `{ value, label }` pair. Required.
+     * Earliest selectable date for date, datetime and date-range fields.
      */
-    options: InputSignal<Option[]>;
+    minDate: WritableSignal<Date | undefined>;
     /**
-     * Currently checked options, keyed by value. Internal state, not an input.
+     * Latest selectable date for date, datetime and date-range fields.
      */
-    selectedOptions: WritableSignal<Map<string, Option>>;
-    writeValue(value: string | null): void;
-    addToSelectedOptionsMap(option: Map<string, Option>): void;
-    onCheckboxChange(checked: boolean, value: string): void;
-    stringifySelectedOptions(): string | null;
-    getEmissionValue(options: any): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<CheckboxControl, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CheckboxControl, "iss-ctrl-checkbox", never, { "options": { "alias": "options"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
-/**
- * `<iss-ctrl-chips>` — free text entered as removable chips.
- *
- * Each `Enter` turns the typed text into a chip. The form value is the comma separated list
- * of chip labels.
- *
- * @example
- * ```html
- * <iss-ctrl-chips formControlName="tags" placeholder="Add a tag">
- *   <label>Tags</label>
- * </iss-ctrl-chips>
- * ```
- *
- * ### Own inputs
- * None — the control is configured entirely through the inherited properties.
- *
- * ### Inherited from {@link ControlBase}
- * `formControlName` · `readonly` · `className` · `(onChange)` · `placeholder`
- *
- * Projects `<label>` into the floating label; omit it to render the control without one.
- */
-declare class ChipsControl extends ControlBase {
-    #private;
+    maxDate: WritableSignal<Date | undefined>;
     /**
-     * The chips currently rendered. Internal state, not an input.
+     * Restricts the calendar to working days. Source: `config.acceptWorkDaysOnly`.
      */
-    readonly keywords: WritableSignal<string[]>;
-    writeValue(value: string | null): void;
-    remove(keyword: string): void;
-    add(event: MatChipInputEvent): void;
-    protected isEmpty(): boolean;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ChipsControl, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ChipsControl, "iss-ctrl-chips", never, {}, {}, never, ["label"], true, never>;
-}
-
-/**
- * `<iss-ctrl-date-picker>` — single date selection through a Material calendar.
- *
- * The input itself is read-only; clicking it opens the calendar. The emitted value is a
- * `yyyy-MM-dd` string, and a clear button appears once a date is picked.
- *
- * @example
- * ```html
- * <iss-ctrl-date-picker formControlName="startsOn" [minDate]="today" [disabledDays]="[5, 6]">
- *   <label>Start date</label>
- * </iss-ctrl-date-picker>
- * ```
- *
- * ### Own inputs
- * | Property | Type | Default | Description |
- * | --- | --- | --- | --- |
- * | `minDate` | `Date \| null` | `null` | Earliest selectable date. |
- * | `maxDate` | `Date \| null` | `null` | Latest selectable date. |
- * | `disabledDays` | `number[]` | `[]` | Week days to block, `0` = Sunday … `6` = Saturday. |
- * | `hijriCalendar` | `boolean` | `false` | Shows an Umm al-Qura Hijri calendar; the value stays Gregorian. |
- * | `emitHijri` | `boolean` | `false` | Emits the Hijri date instead of the Gregorian one. Implies `hijriCalendar`. |
- *
- * ### Hijri dates
- * `hijriCalendar` only changes what the user sees: the calendar is Hijri, the input reads
- * `dd/MM/yyyy` in Hijri, and a day shown as `16/03/1447` is still emitted as `2025-09-08`.
- * Turn on `emitHijri` as well when the form value itself has to be the Hijri date. `minDate` and
- * `maxDate` stay Gregorian in both cases — they are bounds on a day, not on a notation.
- *
- * ### Inherited from {@link ControlBase}
- * `formControlName` · `readonly` · `className` · `(onChange)`
- *
- * Projects `<label>` into the floating label; omit it to render the control without one.
- */
-declare class DatePickerControl extends ControlBase implements Validator {
-    #private;
+    dateFilter: WritableSignal<boolean | undefined>;
     /**
-     * Week days that cannot be selected — `0` is Sunday through `6` for Saturday.
+     * Renders the calendar as an Umm al-Qura Hijri calendar. The emitted value stays Gregorian
+     * unless {@link FieldConfig.emitHijri} is also on. Source: `config.hijriCalendar`, also
+     * accepted as `config.HijriCalendar`.
      */
-    disabledDays: InputSignal<number[]>;
+    hijriCalendar: WritableSignal<boolean | undefined>;
     /**
-     * Earliest selectable date.
+     * Emits the picked date as a Hijri date instead of a Gregorian one — the same day emitted
+     * as `1447-03-16` rather than `2025-09-08`. Implies {@link FieldConfig.hijriCalendar}: a
+     * Hijri value is always picked from a Hijri calendar.
      */
-    minDate: InputSignal<Date | null>;
+    emitHijri: WritableSignal<boolean | undefined>;
     /**
-     * Latest selectable date.
+     * Id of a downloadable template offered next to an attachment field.
      */
-    maxDate: InputSignal<Date | null>;
+    templateId: WritableSignal<string | undefined>;
     /**
-     * Renders the calendar as an Umm al-Qura Hijri calendar, leaving the emitted value Gregorian.
+     * Direct URL of the downloadable template for an attachment field.
      */
-    hijriCalendar: InputSignal<boolean>;
+    templateUrl: WritableSignal<string | undefined>;
     /**
-     * Emits the picked date as a Hijri `yyyy-MM-dd` string. Implies {@link hijriCalendar}.
+     * Maximum size per uploaded file. Source: `config.allowedSize`.
      */
-    emitHijri: InputSignal<boolean>;
+    allowedFileSize: WritableSignal<number | undefined>;
     /**
-     * Whether this picker is currently showing the Hijri calendar.
+     * Comma separated list of accepted file extensions or MIME types.
      */
-    isHijri(): boolean;
-    writeValue(value: string | Date | null): void;
-    clear(event: MouseEvent): void;
-    protected calendarDaysFilter: (d: Date | null) => boolean;
-    protected emit($event: MatDatepickerInputEvent<any>): void;
-    protected openPicker(picker: any): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DatePickerControl, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DatePickerControl, "iss-ctrl-date-picker", never, { "disabledDays": { "alias": "disabledDays"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "hijriCalendar": { "alias": "hijriCalendar"; "required": false; "isSignal": true; }; "emitHijri": { "alias": "emitHijri"; "required": false; "isSignal": true; }; }, {}, never, ["label"], true, never>;
-}
-
-interface DateRangeEmission {
-    duration: number;
-    start: string;
-    end: string;
-}
-
-/**
- * `<iss-ctrl-date-range-picker>` — a start/end date range in one field.
- *
- * A half-filled range is not a value: clearing either endpoint clears the form value and
- * emits `null`. The form value is a `yyyy-MM-dd` string pair; `(onDateRangeObjectChange)`
- * emits the same range as a {@link DateRangeEmission} object.
- *
- * @example
- * ```html
- * <iss-ctrl-date-range-picker formControlName="period" (onDateRangeObjectChange)="apply($event)">
- *   <label>Period</label>
- * </iss-ctrl-date-range-picker>
- * ```
- *
- * ### Own inputs
- * | Property | Type | Default | Description |
- * | --- | --- | --- | --- |
- * | `minDate` | `Date \| null` | `null` | Earliest selectable date. |
- * | `maxDate` | `Date \| null` | `null` | Latest selectable date. |
- * | `disabledDays` | `number[]` | `[]` | Week days to block, `0` = Sunday … `6` = Saturday. |
- * | `hijriCalendar` | `boolean` | `false` | Shows an Umm al-Qura Hijri calendar; the value stays Gregorian. |
- * | `emitHijri` | `boolean` | `false` | Emits both endpoints as Hijri dates. Implies `hijriCalendar`. |
- *
- * ### Hijri dates
- * `hijriCalendar` only changes what the user sees; the emitted range stays Gregorian until
- * `emitHijri` is on as well, at which point both endpoints carry Hijri dates. `duration` is
- * a count of days either way, and `minDate`/`maxDate` stay Gregorian.
- *
- * ### Inherited from {@link ControlBase}
- * `formControlName` · `readonly` · `className` · `(onChange)`
- *
- * ### Outputs
- * - `(onDateRangeObjectChange)` — `DateRangeEmission | null`, the range as an object.
- *
- * Projects `<label>` into the floating label; omit it to render the control without one.
- */
-declare class DateRangePickerControl extends ControlBase implements OnInit, OnDestroy {
-    #private;
+    allowedFileTypes: WritableSignal<string | undefined>;
     /**
-     * Week days that cannot be selected — `0` is Sunday through `6` for Saturday.
+     * Maximum number of files that may be attached.
      */
-    disabledDays: InputSignal<number[]>;
+    maxFilesCount: WritableSignal<number | undefined>;
     /**
-     * Earliest selectable date.
+     * Minimum number of files required.
      */
-    minDate: InputSignal<Date | null>;
+    minFilesCount: WritableSignal<number | undefined>;
     /**
-     * Latest selectable date.
+     * Maximum number of users selectable in a user picker.
      */
-    maxDate: InputSignal<Date | null>;
+    maxUsersCount: WritableSignal<number | undefined>;
     /**
-     * Renders the calendar as an Umm al-Qura Hijri calendar, leaving the emitted range Gregorian.
+     * Minimum number of users required in a user picker.
      */
-    hijriCalendar: InputSignal<boolean>;
+    minUsersCount: WritableSignal<number | undefined>;
     /**
-     * Emits both endpoints as Hijri dates. Implies {@link hijriCalendar}.
+     * Parsed from the field definition but not consumed yet — table columns currently come
+     * from `field.children`.
      */
-    emitHijri: InputSignal<boolean>;
+    showInTableColumns: WritableSignal<boolean | undefined>;
     /**
-     * Emits the selected range as an object, or `null` while the range is incomplete.
+     * Enables the filter row on a `table` field.
      */
-    onDateRangeObjectChange: OutputEmitterRef<DateRangeEmission | null>;
+    tableWithFilter: WritableSignal<boolean | undefined>;
     /**
-     * The `start`/`end` form group backing the range input. Internal state.
+     * Enables column sorting on a `table` field.
      */
-    readonly range: FormGroup;
+    tableWithSort: WritableSignal<boolean | undefined>;
     /**
-     * Whether this picker is currently showing the Hijri calendar.
+     * Enables the paginator on a `table` field.
      */
-    isHijri(): boolean;
-    ngOnInit(): void;
-    setDisabledState(isDisabled: boolean): void;
-    clear(event: MouseEvent): void;
-    writeValue(value: string | FormData | null): void;
-    ngOnDestroy(): void;
-    protected isEmpty(): boolean;
-    protected openPicker(picker: any): void;
-    protected calendarDaysFilter: (d: Date | null) => boolean;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DateRangePickerControl, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DateRangePickerControl, "iss-ctrl-date-range-picker", never, { "disabledDays": { "alias": "disabledDays"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "hijriCalendar": { "alias": "hijriCalendar"; "required": false; "isSignal": true; }; "emitHijri": { "alias": "emitHijri"; "required": false; "isSignal": true; }; }, { "onDateRangeObjectChange": "onDateRangeObjectChange"; }, never, ["label"], true, never>;
+    tableWithPagination: WritableSignal<boolean | undefined>;
+    constructor(config: any);
 }
 
-/**
- * `<iss-ctrl-datetime-picker>` — a date and a time in a single field.
- *
- * Combines the calendar of the date picker with the time list of the time picker; both parts
- * must be set before a value is emitted.
- *
- * @example
- * ```html
- * <iss-ctrl-datetime-picker formControlName="scheduledAt" [minDate]="today" minTime="08:00" maxTime="17:00">
- *   <label>Scheduled at</label>
- * </iss-ctrl-datetime-picker>
- * ```
- *
- * ### Own inputs
- * | Property | Type | Default | Description |
- * | --- | --- | --- | --- |
- * | `minDate` | `Date \| null` | `null` | Earliest selectable date. |
- * | `maxDate` | `Date \| null` | `null` | Latest selectable date. |
- * | `minTime` | `string \| null` | `null` | Earliest selectable time, `HH:mm`. |
- * | `maxTime` | `string \| null` | `null` | Latest selectable time, `HH:mm`. |
- * | `disabledDays` | `number[]` | `[]` | Week days to block, `0` = Sunday … `6` = Saturday. |
- * | `hijriCalendar` | `boolean` | `false` | Shows an Umm al-Qura Hijri calendar; the value stays Gregorian. |
- * | `emitHijri` | `boolean` | `false` | Emits the date half as a Hijri date. Implies `hijriCalendar`. |
- *
- * ### Hijri dates
- * Both flags are handed straight to the inner date picker; the time half is untouched, so a
- * Hijri value reads `1447-03-15T09:30:00`.
- *
- * ### Inherited from {@link ControlBase}
- * `formControlName` · `readonly` · `className` · `(onChange)`
- *
- * Projects `<label>` into the floating label; omit it to render the control without one.
- */
-declare class DatetimePickerControl extends ControlBase {
-    #private;
-    datetimeForm: FormGroup;
-    /**
-     * Week days that cannot be selected — `0` is Sunday through `6` for Saturday.
-     */
-    disabledDays: InputSignal<number[]>;
-    /**
-     * Earliest selectable date.
-     */
-    minDate: InputSignal<Date | null>;
-    /**
-     * Latest selectable date.
-     */
-    maxDate: InputSignal<Date | null>;
-    /**
-     * Earliest selectable time of day, as `HH:mm`.
-     */
-    minTime: InputSignal<string | null>;
-    /**
-     * Latest selectable time of day, as `HH:mm`.
-     */
-    maxTime: InputSignal<string | null>;
-    /**
-     * Renders the calendar as an Umm al-Qura Hijri calendar, leaving the emitted date Gregorian.
-     */
-    hijriCalendar: InputSignal<boolean>;
-    /**
-     * Emits the date half of the value as a Hijri date. Implies {@link hijriCalendar}.
-     */
-    emitHijri: InputSignal<boolean>;
-    setDisabledState(isDisabled: boolean): void;
-    emit(): void;
-    writeValue(value: string | Date | null): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DatetimePickerControl, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DatetimePickerControl, "iss-ctrl-datetime-picker", never, { "disabledDays": { "alias": "disabledDays"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "hijriCalendar": { "alias": "hijriCalendar"; "required": false; "isSignal": true; }; "emitHijri": { "alias": "emitHijri"; "required": false; "isSignal": true; }; }, {}, never, ["label"], true, never>;
+interface EventStrategy {
+    fire(args: EventArgument): void;
+    revert(args: EventArgument): void;
 }
-
-interface IssAttachment {
-    id: string;
-    name: string;
-    type: string;
-    size: number;
+interface EventArgument {
+    control: AbstractControl;
+    form: FormGroup;
+    field: IssField;
+    action: FieldEvent;
+    change: FieldChange;
 }
-
-interface IssFile {
-    id?: string;
-    name: string;
-    size: string | number;
-    type: string;
-    selected?: number;
-    errorMsg?: string;
-    file?: File;
+interface EventConfigFn {
+    execute(args: EventArgument): any | void;
+}
+interface FieldChange {
+    trackedField: IssField;
+    trackedControl: AbstractControl;
+    value: string;
 }
 
-/**
- * `<iss-ctrl-file-picker>` — attachment upload with a per-file progress and error state.
- *
- * Uploading is done by the host: the control emits the picked files and renders whatever is
- * fed back through `uploadedFiles`, `uploading` and `uploadingError`.
- *
- * @example
- * ```html
- * <iss-ctrl-file-picker
- *   formControlName="attachments"
- *   [multiple]="true"
- *   accept=".pdf,.png"
- *   [uploading]="uploading()"
- *   [uploadedFiles]="uploaded()"
- * />
- * ```
- *
- * ### Own inputs
- * | Property | Type | Default | Description |
- * | --- | --- | --- | --- |
- * | `accept` | `string \| undefined` | `undefined` | Accepted extensions or MIME types for the native picker. |
- * | `showDownloadButton` | `boolean` | `true` | Shows the download action on each attachment. |
- * | `showDeleteButton` | `boolean` | `true` | Shows the remove action on each attachment. |
- * | `uploading` | `boolean` | `false` | Renders the in-progress state. |
- * | `uploadedFiles` | `IssAttachment[]` | `[]` | Files already stored on the server. |
- * | `uploadingError` | `string \| undefined` | `undefined` | Error message attached to the failed upload. |
- *
- * ### Inherited from {@link ControlBase}
- * `formControlName` · `readonly` · `className` · `(onChange)` · `multiple` · `hints`
- *
- * Does not project a label — the field label is rendered by the wrapping `iss-field-*`.
- */
-declare class FilePickerControl extends ControlBase implements OnDestroy {
-    #private;
-    /**
-     * Accepted extensions or MIME types, passed straight to the native file input.
-     */
-    accept: InputSignal<string | undefined>;
-    /**
-     * Shows the download action on each listed attachment.
-     */
-    showDownloadButton: InputSignal<boolean>;
-    /**
-     * Shows the remove action on each listed attachment.
-     */
-    showDeleteButton: InputSignal<boolean>;
-    /**
-     * Renders the upload-in-progress state; set by the host that performs the upload.
-     */
-    uploading: InputSignal<boolean>;
-    /**
-     * Attachments already stored on the server, merged into the rendered list.
-     */
-    uploadedFiles: InputSignal<IssAttachment[]>;
-    /**
-     * Error message shown on the attachment whose upload failed.
-     */
-    uploadingError: InputSignal<string | undefined>;
-    readonly filesValue: Signal<any>;
-    protected attachments: WritableSignal<IssFile[]>;
-    ngOnDestroy(): void;
-    writeValue(val: FormData | string | null): void;
-    protected onDelete(files: IssFile[]): void;
-    protected captureFile($event: FileList): void;
-    protected openFilePicker(input: HTMLInputElement): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<FilePickerControl, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<FilePickerControl, "iss-ctrl-file-picker", never, { "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "showDownloadButton": { "alias": "showDownloadButton"; "required": false; "isSignal": true; }; "showDeleteButton": { "alias": "showDeleteButton"; "required": false; "isSignal": true; }; "uploading": { "alias": "uploading"; "required": false; "isSignal": true; }; "uploadedFiles": { "alias": "uploadedFiles"; "required": false; "isSignal": true; }; "uploadingError": { "alias": "uploadingError"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+interface ActionTriggerFn {
+    isTriggered(field: IssField, change: FieldChange, action: FieldEvent, masterField?: IssField): boolean;
 }
 
-/**
- * `<iss-ctrl-input>` — single line text input, the base for every scalar text field.
- *
- * `type` is forwarded to the native input, so `number`, `email` and `password` variants all
- * come from this one control.
- *
- * @example
- * ```html
- * <iss-ctrl-input formControlName="amount" type="number" [min]="0" suffixText="SAR">
- *   <label>Amount</label>
- * </iss-ctrl-input>
- * ```
- *
- * ### Own inputs
- * | Property | Type | Default | Description |
- * | --- | --- | --- | --- |
- * | `type` | `string` | `"text"` | Native input type: `text`, `number`, `email`, `password`, … |
- * | `prefixIcon` | `string` | `""` | Icon rendered before the value. |
- * | `prefixText` | `string` | `""` | Text rendered before the value. |
- * | `suffixIcon` | `string` | `""` | Icon rendered after the value. |
- * | `suffixText` | `string` | `""` | Text rendered after the value. |
- *
- * ### Inherited from {@link ControlBase}
- * `formControlName` · `readonly` · `className` · `(onChange)` · `placeholder` · `min` · `max` · `minLength` · `maxLength` · `hints`
- *
- * ### Outputs
- * - `(onPrefixClick)` — `string`, the prefix affix was clicked.
- * - `(onSuffixClick)` — `string`, the suffix affix was clicked.
- *
- * Projects `<label>` into the floating label; omit it to render the control without one.
- *
- * Also projects `[issPrefix]` and `[issSuffix]` for fully custom affixes.
- */
-declare class InputControl extends ControlBase implements Validator, OnDestroy {
-    #private;
-    /**
-     * Native input type — `text`, `number`, `email`, `password`, and so on.
-     */
-    type: InputSignal<string>;
-    /**
-     * Icon name rendered before the value.
-     */
-    prefixIcon: InputSignal<string>;
-    /**
-     * Static text rendered before the value.
-     */
-    prefixText: InputSignal<string>;
-    /**
-     * Icon name rendered after the value.
-     */
-    suffixIcon: InputSignal<string>;
-    /**
-     * Static text rendered after the value, a unit or currency for example.
-     */
-    suffixText: InputSignal<string>;
-    /**
-     * Emits when the prefix affix is clicked.
-     */
-    onPrefixClick: OutputEmitterRef<string>;
-    /**
-     * Emits when the suffix affix is clicked.
-     */
-    onSuffixClick: OutputEmitterRef<string>;
-    emitSuffixClick(): void;
-    emitPrefixClick(): void;
-    ngOnDestroy(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<InputControl, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<InputControl, "iss-ctrl-input", never, { "type": { "alias": "type"; "required": false; "isSignal": true; }; "prefixIcon": { "alias": "prefixIcon"; "required": false; "isSignal": true; }; "prefixText": { "alias": "prefixText"; "required": false; "isSignal": true; }; "suffixIcon": { "alias": "suffixIcon"; "required": false; "isSignal": true; }; "suffixText": { "alias": "suffixText"; "required": false; "isSignal": true; }; }, { "onPrefixClick": "onPrefixClick"; "onSuffixClick": "onSuffixClick"; }, never, ["label", "[issPrefix]", "[issSuffix]"], true, never>;
-}
-
-type ISO2 = "AF" | "AL" | "DZ" | "AS" | "AD" | "AO" | "AI" | "AG" | "AR" | "AM" | "AW" | "AU" | "AT" | "AZ" | "BS" | "BH" | "BD" | "BB" | "BY" | "BE" | "BZ" | "BJ" | "BM" | "BT" | "BO" | "BA" | "BW" | "BR" | "IO" | "VG" | "BN" | "BG" | "BF" | "BI" | "KH" | "CM" | "CA" | "CV" | "BQ" | "KY" | "CF" | "TD" | "CL" | "CN" | "CX" | "CC" | "CO" | "KM" | "CD" | "CG" | "CK" | "CR" | "CI" | "HR" | "CU" | "CW" | "CY" | "CZ" | "DK" | "DJ" | "DM" | "DO" | "EC" | "EG" | "SV" | "GQ" | "ER" | "EE" | "ET" | "FK" | "FO" | "FJ" | "FI" | "FR" | "GF" | "PF" | "GA" | "GM" | "GE" | "DE" | "GH" | "GI" | "GR" | "GL" | "GD" | "GP" | "GU" | "GT" | "GG" | "GN" | "GW" | "GY" | "HT" | "HN" | "HK" | "HU" | "IS" | "IN" | "ID" | "IR" | "IQ" | "IE" | "IM" | "IL" | "IT" | "JM" | "JP" | "JE" | "JO" | "KZ" | "KE" | "KI" | "XK" | "KW" | "KG" | "LA" | "LV" | "LB" | "LS" | "LR" | "LY" | "LI" | "LT" | "LU" | "MO" | "MK" | "MG" | "MW" | "MY" | "MV" | "ML" | "MT" | "MH" | "MQ" | "MR" | "MU" | "YT" | "MX" | "FM" | "MD" | "MC" | "MN" | "ME" | "MS" | "MA" | "MZ" | "MM" | "NA" | "NR" | "NP" | "NL" | "NC" | "NZ" | "NI" | "NE" | "NG" | "NU" | "NF" | "KP" | "MP" | "NO" | "OM" | "PK" | "PW" | "PS" | "PA" | "PG" | "PY" | "PE" | "PH" | "PL" | "PT" | "PR" | "QA" | "RE" | "RO" | "RU" | "RW" | "BL" | "SH" | "KN" | "LC" | "MF" | "PM" | "VC" | "WS" | "SM" | "ST" | "SA" | "SN" | "RS" | "SC" | "SL" | "SG" | "SX" | "SK" | "SI" | "SB" | "SO" | "ZA" | "KR" | "SS" | "ES" | "LK" | "SD" | "SR" | "SJ" | "SZ" | "SE" | "CH" | "SY" | "TW" | "TJ" | "TZ" | "TH" | "TL" | "TG" | "TK" | "TO" | "TT" | "TN" | "TR" | "TM" | "TC" | "TV" | "VI" | "UG" | "UA" | "AE" | "GB" | "US" | "UY" | "UZ" | "VU" | "VA" | "VE" | "VN" | "WF" | "EH" | "YE" | "ZM" | "ZW" | "AX";
-
-interface Country {
-    name: string;
-    code: ISO2;
-    dailCode: string;
-    areaCodes?: string[];
-    priority: number;
-    order: number;
-    placeholder: string;
+declare class FieldActionConfig {
+    operator: "or" | "and" | undefined;
+    setValueFromApiResponse: string | undefined;
+    setValueFromRequestDto: string | undefined;
+    setValueFromLoggedInUser: string | undefined;
+    setValueFromJsonValue: string | undefined;
+    triggerFromApiResponse: string | undefined;
+    triggerFromJsonValue: string | undefined;
+    replaceApiKeyFromField: string | undefined;
+    fn: EventConfigFn | undefined;
+    fnPromise: Promise<EventConfigFn> | undefined;
+    afterFetchFn: EventConfigFn | undefined;
+    afterFetchFnPromise: Promise<EventConfigFn> | undefined;
+    triggerFn: ActionTriggerFn;
+    triggerFnPromise: Promise<ActionTriggerFn> | undefined;
+    disableAfterFetching: boolean | undefined;
+    disableAfterSetValue: boolean | undefined;
+    constructor(action: any, loader: Loader);
 }
 
-interface Mobile {
-    dailCode: string;
-    code: ISO2;
-    nationalNumber: string;
-    internationalNumber: string;
-    placeholder: string;
-    name: string;
-    priority: 0;
-    order: 0;
-}
-
-declare class Phone {
-    parse(phoneNumber: string, countryCode?: ISO2): PhoneNumber | undefined;
-    getPhoneNumberObject(number: string): Mobile | undefined;
-    format(phoneNumber: string, countryCode: ISO2, numberFormat: "E.164" | "INTERNATIONAL" | "NATIONAL"): string;
-    validate(number: string): boolean;
-    getPlaceholder(countryCode: ISO2): string;
-    getCountryIsoCode(dailCode: string, number: PhoneNumber): string;
-    getCountryByDailCode(dailCode: string | undefined, number: PhoneNumber): Country | undefined;
-    static ɵfac: i0.ɵɵFactoryDeclaration<Phone, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<Phone>;
-}
-
-/**
- * `<iss-ctrl-mobile>` — international phone number with a country selector.
- *
- * The number is validated against the selected country and stored in its international form.
- *
- * @example
- * ```html
- * <iss-ctrl-mobile formControlName="mobile" [preferredCountries]="['SA', 'AE']">
- *   <label>Mobile</label>
- * </iss-ctrl-mobile>
- * ```
- *
- * ### Own inputs
- * | Property | Type | Default | Description |
- * | --- | --- | --- | --- |
- * | `preferredCountries` | `ISO2[]` | `["SA"]` | Countries pinned to the top of the country list. |
- *
- * ### Inherited from {@link ControlBase}
- * `formControlName` · `readonly` · `className` · `(onChange)`
- *
- * Projects `<label>` into the floating label; omit it to render the control without one.
- */
-declare class MobileControl extends ControlBase implements OnDestroy, Validator {
-    #private;
-    phoneService: Phone;
-    isOpen: WritableSignal<boolean>;
-    selectedCountry: WritableSignal<Country>;
-    /**
-     * ISO-2 country codes pinned to the top of the country list; the first one is preselected.
-     */
-    preferredCountries: InputSignal<ISO2[]>;
-    searchInput: FormControl;
-    filteredCountries: Signal<Country[]>;
-    writeValue(value: string | null): void;
-    emit(): void;
-    validate(control: AbstractControl): ValidationErrors | null;
-    ngOnDestroy(): void;
-    protected onInput(event: KeyboardEvent): void;
-    protected onSelectCountry(country: Country): void;
-    protected closeCountryCodeMenu(): void;
-    protected toggleCountryCodeMenu(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MobileControl, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MobileControl, "iss-ctrl-mobile", never, { "preferredCountries": { "alias": "preferredCountries"; "required": false; "isSignal": true; }; }, {}, never, ["label"], true, never>;
-}
-
-/**
- * `<iss-ctrl-plate-number>` — Saudi vehicle plate, entered as digits and letters in both
- * Arabic and English.
- *
- * Typing into one script fills the matching cell in the other automatically, and letters are
- * validated against the allowed plate alphabet.
- *
- * @example
- * ```html
- * <iss-ctrl-plate-number formControlName="plate" [readonly]="false"/>
- * ```
- *
- * ### Own inputs
- * None — the control is configured entirely through the inherited properties.
- *
- * ### Inherited from {@link ControlBase}
- * `formControlName` · `readonly` · `className` · `(onChange)`
- *
- * Does not project a label — the field label is rendered by the wrapping `iss-field-*`.
- */
-declare class PlateControl extends ControlBase {
-    #private;
-    numbersAr: i0.WritableSignal<string[]>;
-    numbersEn: i0.WritableSignal<string[]>;
-    lettersAr: i0.WritableSignal<string[]>;
-    lettersEn: i0.WritableSignal<string[]>;
-    letterErrors: i0.WritableSignal<boolean[]>;
-    writeValue(value: string | null): void;
-    onNumberInput(index: number, event: Event, lang: "ar" | "en"): void;
-    onLetterInput(index: number, event: Event, lang: "ar" | "en"): void;
-    protected preventNonDigits($event: KeyboardEvent, ar: string): void;
-    private emitPlate;
-    private stringifyPlate;
-    private focusInput;
-    private convertDigit;
-    static ɵfac: i0.ɵɵFactoryDeclaration<PlateControl, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PlateControl, "iss-ctrl-plate-number", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * `<iss-ctrl-radio>` — one choice out of a fixed set of options.
- *
- * @example
- * ```html
- * <iss-ctrl-radio formControlName="gender" [options]="genders"/>
- * ```
- *
- * ### Own inputs
- * | Property | Type | Default | Description |
- * | --- | --- | --- | --- |
- * | `options` | `Option[]` | **required** | The selectable choices. |
- *
- * ### Inherited from {@link ControlBase}
- * `formControlName` · `readonly` · `className` · `(onChange)`
- *
- * Does not project a label — the field label is rendered by the wrapping `iss-field-*`.
- */
-declare class RadioControl extends ControlBase {
-    /**
-     * Selectable choices, each a `{ value, label }` pair. Required.
-     */
-    options: InputSignal<Option[]>;
-    writeValue(value: string | null): void;
-    onRadioChange(value: string): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<RadioControl, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<RadioControl, "iss-ctrl-radio", never, { "options": { "alias": "options"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
-/**
- * `<iss-ctrl-select>` — dropdown selection, single or multiple, with a search box.
- *
- * Typing in the search box emits `(onQueryChange)`, so options can be loaded remotely; set
- * `loading` while that request is in flight.
- *
- * @example
- * ```html
- * <iss-ctrl-select
- *   formControlName="city"
- *   [options]="cities()"
- *   [multiple]="false"
- *   [loading]="loading()"
- *   (onQueryChange)="search($event)"
- * >
- *   <label>City</label>
- * </iss-ctrl-select>
- * ```
- *
- * ### Own inputs
- * | Property | Type | Default | Description |
- * | --- | --- | --- | --- |
- * | `options` | `Option[]` | **required** | The selectable choices. |
- * | `height` | `string` | `"150px"` | Max height of the open panel. |
- * | `loading` | `boolean` | `false` | Shows the loading state inside the panel. |
- *
- * ### Inherited from {@link ControlBase}
- * `formControlName` · `readonly` · `className` · `(onChange)` · `placeholder` · `multiple`
- *
- * ### Outputs
- * - `(onQueryChange)` — `string`, the current search text.
- *
- * Projects `<label>` into the floating label; omit it to render the control without one.
- */
-declare class SelectControl extends ControlBase implements OnDestroy {
-    #private;
-    selectedOptions: WritableSignal<Map<string, Option>>;
-    /**
-     * Selectable choices, each a `{ value, label }` pair. Required.
-     */
-    options: InputSignal<Option[]>;
-    /**
-     * Maximum height of the open options panel, as a CSS length.
-     */
-    height: InputSignal<string>;
-    query: Signal<string>;
-    readonly filteredOptions: Signal<Option[]>;
-    /**
-     * Shows the loading state inside the panel while options are being fetched.
-     */
-    loading: InputSignal<boolean>;
-    /**
-     * Emits the search text so the host can load matching options.
-     */
-    onQueryChange: OutputEmitterRef<string>;
-    protected optionTemplate: any;
-    protected cardViewerTemplate: any;
-    protected allSelected: WritableSignal<boolean>;
-    displayFn: (options: Option | Option[]) => string;
-    writeValue(value: string | null): void;
-    captureValue($event: any): void;
-    removeFromSelectedOptionsMap(option: Option): void;
-    clearSelection(): void;
-    toggleAllSelection(): void;
-    ngOnDestroy(): void;
-    protected isEmpty(): boolean;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SelectControl, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SelectControl, "iss-ctrl-select", never, { "options": { "alias": "options"; "required": true; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; }, { "onQueryChange": "onQueryChange"; }, ["optionTemplate", "cardViewerTemplate"], ["label"], true, never>;
-}
-
-/**
- * `<iss-ctrl-slide-toggle>` — an on/off switch for a boolean value.
- *
- * @example
- * ```html
- * <iss-ctrl-slide-toggle formControlName="active" (onChange)="save($event)"/>
- * ```
- *
- * ### Own inputs
- * None — the control is configured entirely through the inherited properties.
- *
- * ### Inherited from {@link ControlBase}
- * `formControlName` · `readonly` · `className` · `(onChange)`
- *
- * Does not project a label — the field label is rendered by the wrapping `iss-field-*`.
- */
-declare class SlideToggleControl extends ControlBase {
-    onSlideToggleChange(checked: boolean): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SlideToggleControl, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SlideToggleControl, "iss-ctrl-slide-toggle", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * `<iss-ctrl-textarea>` — multi line free text.
- *
- * @example
- * ```html
- * <iss-ctrl-textarea formControlName="notes" [maxLength]="500" placeholder="Add a note">
- *   <label>Notes</label>
- * </iss-ctrl-textarea>
- * ```
- *
- * ### Own inputs
- * None — the control is configured entirely through the inherited properties.
- *
- * ### Inherited from {@link ControlBase}
- * `formControlName` · `readonly` · `className` · `(onChange)` · `placeholder` · `minLength` · `maxLength` · `hints`
- *
- * Projects `<label>` into the floating label; omit it to render the control without one.
- */
-declare class TextareaControl extends ControlBase implements OnDestroy {
-    #private;
-    ngOnDestroy(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<TextareaControl, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<TextareaControl, "iss-ctrl-textarea", never, {}, {}, never, ["label"], true, never>;
-}
-
-/**
- * `<iss-ctrl-time-picker>` — time of day, picked from a list generated at a fixed interval.
- *
- * @example
- * ```html
- * <iss-ctrl-time-picker formControlName="startsAt" interval="15min" minTime="08:00" maxTime="17:00">
- *   <label>Starts at</label>
- * </iss-ctrl-time-picker>
- * ```
- *
- * ### Own inputs
- * | Property | Type | Default | Description |
- * | --- | --- | --- | --- |
- * | `interval` | `string` | `"30min"` | Step between the offered times. |
- * | `minTime` | `string \| null` | `null` | Earliest offered time, `HH:mm`. |
- * | `maxTime` | `string \| null` | `null` | Latest offered time, `HH:mm`. |
- *
- * ### Inherited from {@link ControlBase}
- * `formControlName` · `readonly` · `className` · `(onChange)`
- *
- * Projects `<label>` into the floating label; omit it to render the control without one.
- */
-declare class TimePickerControl extends ControlBase {
-    #private;
-    /**
-     * Step between the offered times, for example `"15min"` or `"30min"`.
-     */
-    interval: InputSignal<string>;
-    /**
-     * Earliest offered time of day, as `HH:mm`.
-     */
-    minTime: InputSignal<string | null>;
-    /**
-     * Latest offered time of day, as `HH:mm`.
-     */
-    maxTime: InputSignal<string | null>;
-    emit(evt: any): void;
-    clear(event: MouseEvent): void;
-    writeValue(value: any): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<TimePickerControl, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<TimePickerControl, "iss-ctrl-time-picker", never, { "interval": { "alias": "interval"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; }, {}, never, ["label"], true, never>;
-}
-
-/**
- * `<iss-ctrl-toggle-button>` — options rendered as a button group instead of a dropdown.
- *
- * With `multiple` set, several buttons can be active at once.
- *
- * @example
- * ```html
- * <iss-ctrl-toggle-button formControlName="priority" [options]="priorities" [multiple]="false"/>
- * ```
- *
- * ### Own inputs
- * | Property | Type | Default | Description |
- * | --- | --- | --- | --- |
- * | `options` | `Option[]` | **required** | The selectable choices. |
- *
- * ### Inherited from {@link ControlBase}
- * `formControlName` · `readonly` · `className` · `(onChange)` · `multiple`
- *
- * Does not project a label — the field label is rendered by the wrapping `iss-field-*`.
- */
-declare class ToggleButtonControl extends ControlBase {
-    #private;
-    /**
-     * Selectable choices, each a `{ value, label }` pair. Required.
-     */
-    options: InputSignal<Option[]>;
-    selectedOptions: WritableSignal<Map<string, Option>>;
-    writeValue(value: string | null): void;
-    addToSelectedOptionsMap(option: Map<string, Option>): void;
-    onToggleButtonChange(checked: boolean, value: string): void;
-    stringifySelectedOptions(): string | null;
-    getEmissionValue(options: any): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ToggleButtonControl, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ToggleButtonControl, "iss-ctrl-toggle-button", never, { "options": { "alias": "options"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
-declare class Loader {
-    #private;
-    loadComponent(field: IssField): Observable<Type<any> | null>;
-    loadViewer(type: string): Observable<Type<any> | null>;
-    loadService<T>(serviceName: string): undefined | (() => Promise<T>);
-    static ɵfac: i0.ɵɵFactoryDeclaration<Loader, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<Loader>;
-}
-
-declare class FieldAsyncValidation {
-    alreadyExists: string | undefined;
-    constructor(asyncValidation: any);
-}
-
-/**
- * Per-field configuration, reachable as `field.config` and consumed by the `iss-field-*`
- * components. Every entry is a signal, so it can be changed at runtime by field events.
- *
- * Not every key applies to every field — the class doc of each `iss-field-*` component
- * lists exactly which of these it reads.
- *
- * ### Keys by area
- * - **Common:** `type` · `disabled` · `readonly` · `placeholder` · `suffix` · `hideLabel` · `multiple`
- * - **Bounds:** `min` · `max` · `minLength` · `maxLength`
- * - **Dates:** `minDate` · `maxDate` · `dateFilter` · `hijriCalendar` · `emitHijri`
- * - **Attachments:** `allowedFileSize` · `allowedFileTypes` · `minFilesCount` · `maxFilesCount` · `templateId` · `templateUrl`
- * - **Users:** `minUsersCount` · `maxUsersCount`
- * - **Table:** `showInTableColumns` · `tableWithFilter` · `tableWithSort` · `tableWithPagination`
- *
- * @example
- * ```json
- * { "name": "email", "type": "text_input", "config": { "type": "email", "maxLength": 120 } }
- * ```
- */
-declare class FieldConfig {
-    /**
-     * Native input type for `text_input` (`text`, `email`, `number`, `password`, …).
-     */
-    type: WritableSignal<string | undefined>;
-    /**
-     * Disables the control; the underlying `FormControl` is disabled on init.
-     */
-    disabled: WritableSignal<boolean | undefined>;
-    /**
-     * Shows the value but blocks interaction. Unlike `disabled`, the value is still submitted.
-     */
-    readonly: WritableSignal<boolean | undefined>;
-    /**
-     * Placeholder text shown while the field is empty.
-     */
-    placeholder: WritableSignal<string | undefined>;
-    /**
-     * Text rendered after the value (a unit or currency, for example).
-     */
-    suffix: WritableSignal<string | undefined>;
-    /**
-     * Hides the field label without removing it from the accessibility tree.
-     */
-    hideLabel: WritableSignal<boolean | undefined>;
-    /**
-     * Allows more than one value — multi select, multi file upload, multi toggle.
-     */
-    multiple: WritableSignal<boolean | undefined>;
-    /**
-     * Minimum number of characters. Source: `config.minLength`.
-     */
-    minLength: WritableSignal<number | undefined>;
-    /**
-     * Maximum number of characters. Source: `config.maxLength`.
-     */
-    maxLength: WritableSignal<number | undefined>;
-    /**
-     * Minimum numeric value (also the minimum user count for the user picker).
-     */
-    min: WritableSignal<number | undefined>;
-    /**
-     * Maximum numeric value (also the maximum user count for the user picker).
-     */
-    max: WritableSignal<number | undefined>;
-    /**
-     * Earliest selectable date for date, datetime and date-range fields.
-     */
-    minDate: WritableSignal<Date | undefined>;
-    /**
-     * Latest selectable date for date, datetime and date-range fields.
-     */
-    maxDate: WritableSignal<Date | undefined>;
-    /**
-     * Restricts the calendar to working days. Source: `config.acceptWorkDaysOnly`.
-     */
-    dateFilter: WritableSignal<boolean | undefined>;
-    /**
-     * Renders the calendar as an Umm al-Qura Hijri calendar. The emitted value stays Gregorian
-     * unless {@link FieldConfig.emitHijri} is also on. Source: `config.hijriCalendar`, also
-     * accepted as `config.HijriCalendar`.
-     */
-    hijriCalendar: WritableSignal<boolean | undefined>;
-    /**
-     * Emits the picked date as a Hijri date instead of a Gregorian one — the same day emitted
-     * as `1447-03-16` rather than `2025-09-08`. Implies {@link FieldConfig.hijriCalendar}: a
-     * Hijri value is always picked from a Hijri calendar.
-     */
-    emitHijri: WritableSignal<boolean | undefined>;
-    /**
-     * Id of a downloadable template offered next to an attachment field.
-     */
-    templateId: WritableSignal<string | undefined>;
-    /**
-     * Direct URL of the downloadable template for an attachment field.
-     */
-    templateUrl: WritableSignal<string | undefined>;
-    /**
-     * Maximum size per uploaded file. Source: `config.allowedSize`.
-     */
-    allowedFileSize: WritableSignal<number | undefined>;
-    /**
-     * Comma separated list of accepted file extensions or MIME types.
-     */
-    allowedFileTypes: WritableSignal<string | undefined>;
-    /**
-     * Maximum number of files that may be attached.
-     */
-    maxFilesCount: WritableSignal<number | undefined>;
-    /**
-     * Minimum number of files required.
-     */
-    minFilesCount: WritableSignal<number | undefined>;
-    /**
-     * Maximum number of users selectable in a user picker.
-     */
-    maxUsersCount: WritableSignal<number | undefined>;
-    /**
-     * Minimum number of users required in a user picker.
-     */
-    minUsersCount: WritableSignal<number | undefined>;
-    /**
-     * Parsed from the field definition but not consumed yet — table columns currently come
-     * from `field.children`.
-     */
-    showInTableColumns: WritableSignal<boolean | undefined>;
-    /**
-     * Enables the filter row on a `table` field.
-     */
-    tableWithFilter: WritableSignal<boolean | undefined>;
-    /**
-     * Enables column sorting on a `table` field.
-     */
-    tableWithSort: WritableSignal<boolean | undefined>;
-    /**
-     * Enables the paginator on a `table` field.
-     */
-    tableWithPagination: WritableSignal<boolean | undefined>;
-    constructor(config: any);
-}
-
-interface EventStrategy {
-    fire(args: EventArgument): void;
-    revert(args: EventArgument): void;
-}
-interface EventArgument {
-    control: AbstractControl;
-    form: FormGroup;
-    field: IssField;
-    action: FieldEvent;
-    change: FieldChange;
-}
-interface EventConfigFn {
-    execute(args: EventArgument): any | void;
-}
-interface FieldChange {
-    trackedField: IssField;
-    trackedControl: AbstractControl;
-    value: string;
-}
-
-interface ActionTriggerFn {
-    isTriggered(field: IssField, change: FieldChange, action: FieldEvent, masterField?: IssField): boolean;
-}
-
-declare class FieldActionConfig {
-    operator: "or" | "and" | undefined;
-    setValueFromApiResponse: string | undefined;
-    setValueFromRequestDto: string | undefined;
-    setValueFromLoggedInUser: string | undefined;
-    setValueFromJsonValue: string | undefined;
-    triggerFromApiResponse: string | undefined;
-    triggerFromJsonValue: string | undefined;
-    replaceApiKeyFromField: string | undefined;
-    fn: EventConfigFn | undefined;
-    fnPromise: Promise<EventConfigFn> | undefined;
-    afterFetchFn: EventConfigFn | undefined;
-    afterFetchFnPromise: Promise<EventConfigFn> | undefined;
-    triggerFn: ActionTriggerFn;
-    triggerFnPromise: Promise<ActionTriggerFn> | undefined;
-    disableAfterFetching: boolean | undefined;
-    disableAfterSetValue: boolean | undefined;
-    constructor(action: any, loader: Loader);
-}
-
-declare class FieldEvent {
-    id: number;
+declare class FieldEvent {
+    id: number;
     name: string;
     value: string;
     trackedFieldName: string;
     triggered: boolean;
     config: FieldActionConfig;
-    fn: EventStrategy | undefined;
-    fnPromise: Promise<EventStrategy> | undefined;
-    constructor(action: any, loader: Loader);
-}
-
-/**
- * Runtime model of a single form field, built from the JSON definition returned by the API.
- *
- * It is what `iss-field-*` components inject through the `FIELD_DATA` token, and the object
- * field events read from and write to. Signal-valued members can be changed at runtime and
- * the rendered field reacts immediately.
- *
- * ### Properties
- * | Property | Type | Description |
- * | --- | --- | --- |
- * | `id` | `number` | Unique field id. |
- * | `name` | `string` | Control name inside the form group. |
- * | `type` | `string` | Key into the `COMPONENTS` index (`text_input`, `dropdown_list`, …). |
- * | `base` | `string` | Underlying data type of the field. |
- * | `label()` | `string` | Visible label. |
- * | `hint()` | `string` | Helper text under the field. |
- * | `options()` | `Option[]` | Choices for select, radio, checkbox and toggle fields. |
- * | `api()` | `string` | Endpoint used to load options or lookups. |
- * | `mode()` | `"edit" \| "view"` | Renders the control or the read-only viewer. |
- * | `visible()` | `boolean` | Whether the field is rendered at all. |
- * | `loading()` | `boolean` | Shows the field's own loading state. |
- * | `config` | `FieldConfig` | Per-type configuration — see {@link FieldConfig}. |
- * | `validation` | `any` | Synchronous validation rules, exactly as the JSON declared them. |
- * | `validationFns` | `Record<string, Function>` | Validator factory behind each active rule, resolved by the outlet. |
- * | `asyncValidation` | `FieldAsyncValidation` | Remote validation rules. |
- * | `events` | `FieldEvent[]` | Cross-field reactions (show, hide, set value, …). |
- * | `children` | `IssField[]` | Nested fields, used by table and group fields. |
- * | `value` / `defaultValue` | `string` | Initial and fallback raw values. |
- * | `jsonValue` | `any` | Initial resolved value for controls with a rich payload. |
- * | `ctrlValue()` | `string \| null` | Live raw value of the control. |
- * | `ctrlJsonValue()` | `any` | Live resolved value (selected options, files, users, …). |
- * | `response()` / `apiResponse` | `any` | Latest payload returned for this field. |
- */
-declare class IssField {
-    id: number;
-    name: string;
-    type: string;
-    base: string;
-    label: WritableSignal<string>;
-    hint: WritableSignal<string>;
-    options: WritableSignal<Option[]>;
-    api: WritableSignal<string>;
-    mode: WritableSignal<"edit" | "view">;
-    visible: WritableSignal<boolean>;
-    wasVisible: WritableSignal<boolean>;
-    events: FieldEvent[];
-    validation: any;
-    validationFns: Record<string, Function>;
-    asyncValidation: FieldAsyncValidation;
-    children: IssField[];
-    apiResponse: BehaviorSubject<any>;
-    response: WritableSignal<any>;
-    config: FieldConfig;
-    value: string;
-    jsonValue: any;
-    defaultValue: string;
-    ctrlValue: WritableSignal<string | null>;
-    ctrlJsonValue: WritableSignal<any>;
-    loading: WritableSignal<boolean>;
-    constructor(field: any, loader: Loader);
-    updateVisibility(value: boolean): void;
-}
-
-interface ComponentOutlet {
-    self$: Observable<Type<any> | null>;
-    data: IssField;
-}
-
-declare class Outlet implements OnInit, OnDestroy {
-    #private;
-    ready: OutputEmitterRef<boolean>;
-    formReady: WritableSignal<boolean>;
-    fields: InputSignal<IssField[]>;
-    components: WritableSignal<ComponentOutlet[] | null>;
-    get hostFormGroup(): FormGroup;
-    ngOnInit(): void;
-    ngOnDestroy(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<Outlet, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<Outlet, "iss-form-outlet", never, { "fields": { "alias": "fields"; "required": true; "isSignal": true; }; }, { "ready": "ready"; }, never, never, true, never>;
-}
-
-declare class EventHandler {
-    #private;
-    fire(control: AbstractControl, form: FormGroup, field: IssField, change: FieldChange): Promise<void>;
-    revert(control: AbstractControl, form: FormGroup, field: IssField, change: FieldChange): Promise<void>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<EventHandler, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<EventHandler>;
-}
-
-declare class FormEngine {
-    #private;
-    registerFields(form: FormGroup, owner: object, fields: IssField[]): void;
-    registerExpectedFieldNames(form: FormGroup, owner: object, names: string[]): void;
-    unregisterOutlet(form: FormGroup, owner: object): void;
-    getFields(form: FormGroup): IssField[];
-    getExpectedFieldNames(form: FormGroup): string[];
-    getField(form: FormGroup, name: string, fields?: IssField[]): IssField | undefined;
-    getControlValue(form: FormGroup, name: string): any;
-    createValidators(field: IssField): ValidatorFn[];
-    createAsyncValidators(field: IssField): AsyncValidatorFn[];
-    getFieldValue(field: IssField): string;
-    trackChangesEvents(field: IssField, form: FormGroup): Observable<FieldChange>;
-    trackChangesValidations(field: IssField, form: FormGroup): Observable<FieldChange>;
-    processTrackChanges(masterName: any, masterNames: Set<string>, changes$: Observable<FieldChange>[], field: IssField, form: FormGroup): void;
-    fieldHasValidation(field: IssField): boolean;
-    fieldHasAsyncValidation(field: IssField): boolean;
-    isFormValid(form: FormGroup, fields: IssField[]): boolean;
-    static ɵfac: i0.ɵɵFactoryDeclaration<FormEngine, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<FormEngine>;
-}
-
-/**
- * Base class for every `iss-field-*` field.
- *
- * A field is the form-engine layer around a control: it reads its whole configuration from
- * the injected {@link IssField} (label, options, config, validation, events), registers its
- * `FormControl` on the parent `FormGroup` on init and removes it again on destroy, and
- * switches between the control (`mode() === "edit"`) and the viewer (`mode() === "view"`).
- *
- * ### Inputs
- * | Property | Type | Description |
- * | --- | --- | --- |
- * | `issField` | `IssField` | **Required.** The field definition; also provided through the `FIELD_DATA` token. |
- * | `formReady` | `boolean \| undefined` | Set by the outlet once the whole form exists; gates event wiring. |
- *
- * ### Properties available on `field`
- * `name` · `type` · `base` · `label()` · `hint()` · `options()` · `api()` · `mode()` ·
- * `visible()` · `loading()` · `value` · `jsonValue` · `defaultValue` · `ctrlValue()` ·
- * `ctrlJsonValue()` · `events` · `validation` · `asyncValidation` · `children` ·
- * `response()` · `config` — see {@link IssField} and {@link FieldConfig}.
- *
- * Fields are not used directly in templates; the outlet resolves them from the field `type`
- * through the `COMPONENTS` index.
- */
-declare class FieldBase implements OnInit, OnDestroy {
-    #private;
-    /**
-     * The field definition rendered by this component. Required.
-     */
-    issField: InputSignal<IssField>;
-    /**
-     * Set by the outlet once every field is registered; field events start only after it turns true.
-     */
-    formReady: InputSignal<boolean | undefined>;
-    /**
-     * The {@link IssField} for this instance, injected through the `FIELD_DATA` token.
-     */
-    field: IssField;
-    parentFormGroup: ControlContainer;
-    formEngine: FormEngine;
-    eventHandler: EventHandler;
-    destroyRef: DestroyRef;
-    /**
-     * The `FormControl` this field registers on the parent form under `field.name`.
-     */
-    ctrl: FormControl;
-    ctrlValueChange: i0.Signal<any>;
-    get form(): FormGroup;
-    ngOnInit(): void;
-    ngOnDestroy(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<FieldBase, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<FieldBase, "ng-component", never, { "issField": { "alias": "issField"; "required": true; "isSignal": true; }; "formReady": { "alias": "formReady"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
-/**
- * `<iss-field-input>` — single line text, number, email or password entry.
- *
- * Rendered by the outlet for fields of type `text_input`. In `edit` mode it renders
- * {@link InputControl} plus the validation message; in `view` mode the matching viewer.
- *
- * ### Supported `config` keys
- * | Key | Type | Description |
- * | --- | --- | --- |
- * | `type` | `string` | Native input type — `text`, `number`, `email`, `password`, … |
- * | `placeholder` | `string` | Placeholder shown while empty. |
- * | `min` | `number` | Minimum numeric value. |
- * | `max` | `number` | Maximum numeric value. |
- * | `minLength` | `number` | Minimum number of characters. |
- * | `maxLength` | `number` | Maximum number of characters. |
- * | `readonly` | `boolean` | Shows the value but blocks interaction. |
- *
- * ### Other field members used
- * `label()`
- *
- * Every field also honours `visible`, `mode`, `validation`, `asyncValidation` and
- * `events` — see {@link IssField} for the full model and {@link FieldConfig} for all keys.
- *
- * @example
- * ```json
- * { "name": "email", "type": "text_input", "label": "Email", "config": { "type": "email", "maxLength": 120 } }
- * ```
- */
-declare class InputField extends FieldBase {
-    static ɵfac: i0.ɵɵFactoryDeclaration<InputField, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<InputField, "iss-field-input", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * `<iss-field-textarea>` — multi line free text.
- *
- * Rendered by the outlet for fields of type `textarea`. In `edit` mode it renders
- * {@link TextareaControl} plus the validation message; in `view` mode the matching viewer.
- *
- * ### Supported `config` keys
- * | Key | Type | Description |
- * | --- | --- | --- |
- * | `minLength` | `number` | Minimum number of characters. |
- * | `maxLength` | `number` | Maximum number of characters. |
- * | `readonly` | `boolean` | Shows the value but blocks interaction. |
- *
- * ### Other field members used
- * `label()`
- *
- * Every field also honours `visible`, `mode`, `validation`, `asyncValidation` and
- * `events` — see {@link IssField} for the full model and {@link FieldConfig} for all keys.
- *
- * @example
- * ```json
- * { "name": "notes", "type": "textarea", "label": "Notes", "config": { "maxLength": 500 } }
- * ```
- */
-declare class TextareaField extends FieldBase {
-    static ɵfac: i0.ɵɵFactoryDeclaration<TextareaField, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<TextareaField, "iss-field-textarea", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * `<iss-field-chips>` — free text entered as removable chips.
- *
- * Rendered by the outlet for fields of type `chips`. In `edit` mode it renders
- * {@link ChipsControl} plus the validation message; in `view` mode the matching viewer.
- *
- * ### Supported `config` keys
- * | Key | Type | Description |
- * | --- | --- | --- |
- * | `readonly` | `boolean` | Shows the value but blocks interaction. |
- *
- * ### Other field members used
- * `label()`
- *
- * Every field also honours `visible`, `mode`, `validation`, `asyncValidation` and
- * `events` — see {@link IssField} for the full model and {@link FieldConfig} for all keys.
- *
- * @example
- * ```json
- * { "name": "tags", "type": "chips", "label": "Tags" }
- * ```
- */
-declare class ChipsField extends FieldBase {
-    static ɵfac: i0.ɵɵFactoryDeclaration<ChipsField, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ChipsField, "iss-field-chips", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * `<iss-field-radio>` — one choice out of a fixed set of options.
- *
- * Rendered by the outlet for fields of type `radio`. In `edit` mode it renders
- * {@link RadioControl} plus the validation message; in `view` mode the matching viewer.
- *
- * ### Supported `config` keys
- * | Key | Type | Description |
- * | --- | --- | --- |
- * | `hideLabel` | `boolean` | Hides the field label. |
- * | `readonly` | `boolean` | Shows the value but blocks interaction. |
- *
- * ### Other field members used
- * `label()` · `options()`
- *
- * Every field also honours `visible`, `mode`, `validation`, `asyncValidation` and
- * `events` — see {@link IssField} for the full model and {@link FieldConfig} for all keys.
- *
- * @example
- * ```json
- * { "name": "gender", "type": "radio", "label": "Gender", "options": [{ "value": "m", "label": "Male" }] }
- * ```
- */
-declare class RadioField extends FieldBase {
-    onChange($event: any): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<RadioField, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<RadioField, "iss-field-radio", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * `<iss-field-select>` — single or multiple selection from a dropdown.
- *
- * Rendered by the outlet for fields of type `dropdown_list`. In `edit` mode it renders
- * {@link SelectControl} plus the validation message; in `view` mode the matching viewer.
- *
- * ### Supported `config` keys
- * | Key | Type | Description |
- * | --- | --- | --- |
- * | `multiple` | `boolean` | Allows selecting more than one option. |
- * | `readonly` | `boolean` | Shows the value but blocks interaction. |
- *
- * ### Other field members used
- * `label()` · `options()` · `ctrlJsonValue()`
- *
- * Every field also honours `visible`, `mode`, `validation`, `asyncValidation` and
- * `events` — see {@link IssField} for the full model and {@link FieldConfig} for all keys.
- *
- * The raw form value holds the selected option values; the resolved options are written
- * back to `field.ctrlJsonValue`.
- *
- * @example
- * ```json
- * { "name": "city", "type": "dropdown_list", "label": "City", "options": [{ "value": "1", "label": "Riyadh" }] }
- * ```
- */
-declare class SelectField extends FieldBase {
-    onChange($event: string | FormData): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SelectField, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SelectField, "iss-field-select", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * `<iss-field-mobile>` — an international phone number with a country selector.
- *
- * Rendered by the outlet for fields of the type `mobile`. In `edit` mode it renders
- * {@link MobileControl} plus the validation message; in `view` mode the matching viewer.
- *
- * ### Supported `config` keys
- * | Key | Type | Description |
- * | --- | --- | --- |
- * | `readonly` | `boolean` | Shows the value but blocks interaction. |
- *
- * ### Other field members used
- * `label()`
- *
- * Every field also honors `visible`, `mode`, `validation`, `asyncValidation` and
- * `events` — see {@link IssField} for the full model and {@link FieldConfig} for all keys.
- *
- * @example
- * ```json
- * { "name": "mobile", "type": "mobile", "label": "Mobile" }
- * ```
- */
-declare class MobileField extends FieldBase {
-    static ɵfac: i0.ɵɵFactoryDeclaration<MobileField, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MobileField, "iss-field-mobile", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * `<iss-field-checkbox>` — a list of checkboxes over a fixed set of options.
- *
- * Rendered by the outlet for fields of type `checkbox`. In `edit` mode it renders
- * {@link CheckboxControl} plus the validation message; in `view` mode the matching viewer.
- *
- * ### Supported `config` keys
- * | Key | Type | Description |
- * | --- | --- | --- |
- * | `hideLabel` | `boolean` | Hides the field label. |
- * | `readonly` | `boolean` | Shows the value but blocks interaction. |
- *
- * ### Other field members used
- * `label()` · `options()`
- *
- * Every field also honours `visible`, `mode`, `validation`, `asyncValidation` and
- * `events` — see {@link IssField} for the full model and {@link FieldConfig} for all keys.
- *
- * @example
- * ```json
- * { "name": "days", "type": "checkbox", "label": "Days", "options": [{ "value": "sun", "label": "Sunday" }] }
- * ```
- */
-declare class CheckboxField extends FieldBase {
-    updateField($event: any): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<CheckboxField, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CheckboxField, "iss-field-checkbox", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * `<iss-field-toggle-button>` — options rendered as a button group.
- *
- * Rendered by the outlet for fields of type `toggle_button`. In `edit` mode it renders
- * {@link ToggleButtonControl} plus the validation message; in `view` mode the matching viewer.
- *
- * ### Supported `config` keys
- * | Key | Type | Description |
- * | --- | --- | --- |
- * | `multiple` | `boolean` | Allows more than one active button. |
- * | `hideLabel` | `boolean` | Hides the field label. |
- * | `readonly` | `boolean` | Shows the value but blocks interaction. |
- *
- * ### Other field members used
- * `label()` · `options()`
- *
- * Every field also honours `visible`, `mode`, `validation`, `asyncValidation` and
- * `events` — see {@link IssField} for the full model and {@link FieldConfig} for all keys.
- *
- * @example
- * ```json
- * { "name": "priority", "type": "toggle_button", "label": "Priority", "options": [{ "value": "high", "label": "High" }] }
- * ```
- */
-declare class ToggleButtonField extends FieldBase {
-    onChange($event: any): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ToggleButtonField, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ToggleButtonField, "iss-field-toggle-button", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * `<iss-field-slide-toggle>` — an on/off switch for a boolean value.
- *
- * Rendered by the outlet for fields of type `switch`. In `edit` mode it renders
- * {@link SlideToggleControl} plus the validation message; in `view` mode the matching viewer.
- *
- * ### Supported `config` keys
- * | Key | Type | Description |
- * | --- | --- | --- |
- * | `hideLabel` | `boolean` | Hides the field label. |
- * | `readonly` | `boolean` | Shows the value but blocks interaction. |
- *
- * ### Other field members used
- * `label()`
- *
- * Every field also honours `visible`, `mode`, `validation`, `asyncValidation` and
- * `events` — see {@link IssField} for the full model and {@link FieldConfig} for all keys.
- *
- * @example
- * ```json
- * { "name": "active", "type": "switch", "label": "Active" }
- * ```
- */
-declare class SlideToggleField extends FieldBase {
-    onChange($event: any): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SlideToggleField, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SlideToggleField, "iss-field-slide-toggle", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * `<iss-field-plate-number>` — a Saudi vehicle plate in Arabic and English.
- *
- * Rendered by the outlet for fields of type `vehicle_plate`. In `edit` mode it renders
- * {@link PlateControl} plus the validation message; in `view` mode the matching viewer.
- *
- * ### Supported `config` keys
- * | Key | Type | Description |
- * | --- | --- | --- |
- * | `hideLabel` | `boolean` | Hides the field label. |
- * | `readonly` | `boolean` | Shows the value but blocks interaction. |
- *
- * ### Other field members used
- * `label()`
- *
- * Every field also honours `visible`, `mode`, `validation`, `asyncValidation` and
- * `events` — see {@link IssField} for the full model and {@link FieldConfig} for all keys.
- *
- * @example
- * ```json
- * { "name": "plate", "type": "vehicle_plate", "label": "Plate number" }
- * ```
- */
-declare class PlateField extends FieldBase {
-    updateField($event: any): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<PlateField, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PlateField, "iss-field-plate-number", never, {}, {}, never, never, true, never>;
-}
-
-declare class FileHandler {
-    #private;
-    ATTACHMENT_UPLOAD_URL: string;
-    ATTACHMENT_DOWNLOAD_URL: string;
-    attachmentAdapter: (res: any) => IssAttachment[];
-    upload(data: FormData): Observable<IssAttachment[]>;
-    formDataFactory(files: IssFile[], multiple: boolean): FormData | null;
-    formDataHasValue(formData: FormData): boolean;
-    getFileFromFormData(formData: FormData, name: string): IssFile[];
-    formatFileSize(x: string | number): string;
-    fetchFileInfo(id: string): Observable<IssFile>;
-    fetchFiles(ids: string): Observable<IssFile[]>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<FileHandler, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<FileHandler>;
-}
-
-/**
- * `<iss-field-file-picker>` — attachment upload.
- *
- * Rendered by the outlet for fields of type `attachment`. In `edit` mode it renders
- * {@link FilePickerControl} plus the validation message; in `view` mode the matching viewer.
- *
- * ### Supported `config` keys
- * | Key | Type | Description |
- * | --- | --- | --- |
- * | `multiple` | `boolean` | Allows attaching more than one file. |
- * | `readonly` | `boolean` | Shows the value but blocks interaction. |
- *
- * ### Other field members used
- * `label()` · `value` · `validation` · `ctrlJsonValue()`
- *
- * Every field also honours `visible`, `mode`, `validation`, `asyncValidation` and
- * `events` — see {@link IssField} for the full model and {@link FieldConfig} for all keys.
- *
- * The field uploads the picked files itself, stores the returned ids as the control value
- * and keeps the resolved attachments in `field.ctrlJsonValue`.
- *
- * Accepted extensions come from the `fileType` **validation** rule, not from `config`; the
- * `allowedFileSize`, `allowedFileTypes`, `minFilesCount`, `maxFilesCount`, `templateId` and
- * `templateUrl` config keys exist on {@link FieldConfig} but are not read here yet.
- *
- * @example
- * ```json
- * { "name": "attachments", "type": "attachment", "label": "Attachments", "config": { "multiple": true }, "validation": { "fileType": ["pdf", "png"] } }
- * ```
- */
-declare class FilePickerField extends FieldBase implements OnDestroy {
-    #private;
-    picker: FormControl<any>;
-    fileHandlerService: FileHandler;
-    uploading: WritableSignal<boolean>;
-    viewField: Signal<any>;
-    attachments: WritableSignal<IssAttachment[]>;
-    uploadingError: WritableSignal<string | undefined>;
-    accept: string;
-    captureFile(formData: FormData | null): void;
-    stringifyIssAttachment(attachments: IssAttachment[]): string;
-    ngOnDestroy(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<FilePickerField, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<FilePickerField, "iss-field-file-picker", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * `<iss-field-time-picker>` — a time of day, picked from a generated list.
- *
- * Rendered by the outlet for fields of type `time`. In `edit` mode it renders
- * {@link TimePickerControl} plus the validation message; in `view` mode the matching viewer.
- *
- * ### Supported `config` keys
- * | Key | Type | Description |
- * | --- | --- | --- |
- * | `readonly` | `boolean` | Shows the value but blocks interaction. |
- *
- * ### Other field members used
- * `label()`
- *
- * Every field also honours `visible`, `mode`, `validation`, `asyncValidation` and
- * `events` — see {@link IssField} for the full model and {@link FieldConfig} for all keys.
- *
- * @example
- * ```json
- * { "name": "startsAt", "type": "time", "label": "Starts at" }
- * ```
- */
-declare class TimePickerField extends FieldBase {
-    static ɵfac: i0.ɵɵFactoryDeclaration<TimePickerField, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<TimePickerField, "iss-field-time-picker", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * `<iss-field-date-picker>` — a single date, picked from a calendar.
- *
- * Rendered by the outlet for fields of type `date`. In `edit` mode it renders
- * {@link DatePickerControl} plus the validation message; in `view` mode the matching viewer.
- *
- * ### Supported `config` keys
- * | Key | Type | Description |
- * | --- | --- | --- |
- * | `minDate` | `Date` | Earliest selectable date. |
- * | `maxDate` | `Date` | Latest selectable date. |
- * | `readonly` | `boolean` | Shows the value but blocks interaction. |
- * | `hijriCalendar` | `boolean` | Renders an Umm al-Qura Hijri calendar while the emitted value stays Gregorian. |
- * | `emitHijri` | `boolean` | Emits the Hijri date instead of the Gregorian one. Implies `hijriCalendar`. |
- *
- * ### Other field members used
- * `label()`
- *
- * Every field also honours `visible`, `mode`, `validation`, `asyncValidation` and
- * `events` — see {@link IssField} for the full model and {@link FieldConfig} for all keys.
- *
- * @example
- * ```json
- * { "name": "startsOn", "type": "date", "label": "Start date", "config": { "minDate": "2026-01-01" } }
- * ```
- */
-declare class DatePickerField extends FieldBase {
-    static ɵfac: i0.ɵɵFactoryDeclaration<DatePickerField, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DatePickerField, "iss-field-date-picker", never, {}, {}, never, never, true, never>;
-}
-
-/**
- * `<iss-field-datetime-picker>` — a date and a time in one field.
- *
- * Rendered by the outlet for fields of type `datetime`. In `edit` mode it renders
- * {@link DatetimePickerControl} plus the validation message; in `view` mode the matching viewer.
- *
- * ### Supported `config` keys
- * | Key | Type | Description |
- * | --- | --- | --- |
- * | `minDate` | `Date` | Earliest selectable date. |
- * | `maxDate` | `Date` | Latest selectable date. |
- * | `readonly` | `boolean` | Shows the value but blocks interaction. |
- * | `hijriCalendar` | `boolean` | Renders an Umm al-Qura Hijri calendar while the emitted value stays Gregorian. |
- * | `emitHijri` | `boolean` | Emits the Hijri date instead of the Gregorian one. Implies `hijriCalendar`. |
- *
- * ### Other field members used
- * `label()`
- *
- * Every field also honours `visible`, `mode`, `validation`, `asyncValidation` and
- * `events` — see {@link IssField} for the full model and {@link FieldConfig} for all keys.
- *
- * @example
- * ```json
- * { "name": "scheduledAt", "type": "datetime", "label": "Scheduled at" }
- * ```
- */
-declare class DatetimePickerField extends FieldBase {
-    static ɵfac: i0.ɵɵFactoryDeclaration<DatetimePickerField, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DatetimePickerField, "iss-field-datetime-picker", never, {}, {}, never, never, true, never>;
+    fn: EventStrategy | undefined;
+    fnPromise: Promise<EventStrategy> | undefined;
+    constructor(action: any, loader: Loader);
 }
 
 /**
- * `<iss-field-date-range-picker>` — a start and end date in one field.
+ * Runtime model of a single form field, built from the JSON definition returned by the API.
  *
- * Rendered by the outlet for fields of type `date_range`. In `edit` mode it renders
- * {@link DateRangePickerControl} plus the validation message; in `view` mode the matching viewer.
+ * It is what `iss-field-*` components inject through the `FIELD_DATA` token, and the object
+ * field events read from and write to. Signal-valued members can be changed at runtime and
+ * the rendered field reacts immediately.
  *
- * ### Supported `config` keys
- * | Key | Type | Description |
+ * ### Properties
+ * | Property | Type | Description |
  * | --- | --- | --- |
- * | `minDate` | `Date` | Earliest selectable date. |
- * | `maxDate` | `Date` | Latest selectable date. |
- * | `readonly` | `boolean` | Shows the value but blocks interaction. |
- * | `hijriCalendar` | `boolean` | Renders an Umm al-Qura Hijri calendar while the emitted value stays Gregorian. |
- * | `emitHijri` | `boolean` | Emits the Hijri date instead of the Gregorian one. Implies `hijriCalendar`. |
- *
- * ### Other field members used
- * `label()`
- *
- * Every field also honours `visible`, `mode`, `validation`, `asyncValidation` and
- * `events` — see {@link IssField} for the full model and {@link FieldConfig} for all keys.
- *
- * A half-filled range is treated as no value at all.
- *
- * @example
- * ```json
- * { "name": "period", "type": "date_range", "label": "Period" }
- * ```
+ * | `id` | `number` | Unique field id. |
+ * | `name` | `string` | Control name inside the form group. |
+ * | `type` | `string` | Key into the `COMPONENTS` index (`text_input`, `dropdown_list`, …). |
+ * | `base` | `string` | Underlying data type of the field. |
+ * | `label()` | `string` | Visible label. |
+ * | `hint()` | `string` | Helper text under the field. |
+ * | `options()` | `Option[]` | Choices for select, radio, checkbox and toggle fields. |
+ * | `api()` | `string` | Endpoint used to load options or lookups. |
+ * | `mode()` | `"edit" \| "view"` | Renders the control or the read-only viewer. |
+ * | `visible()` | `boolean` | Whether the field is rendered at all. |
+ * | `loading()` | `boolean` | Shows the field's own loading state. |
+ * | `config` | `FieldConfig` | Per-type configuration — see {@link FieldConfig}. |
+ * | `validation` | `any` | Synchronous validation rules, exactly as the JSON declared them. |
+ * | `validationFns` | `Record<string, Function>` | Validator factory behind each active rule, resolved by the outlet. |
+ * | `asyncValidation` | `FieldAsyncValidation` | Remote validation rules. |
+ * | `events` | `FieldEvent[]` | Cross-field reactions (show, hide, set value, …). |
+ * | `children` | `IssField[]` | Nested fields, used by table and group fields. |
+ * | `value` / `defaultValue` | `string` | Initial and fallback raw values. |
+ * | `jsonValue` | `any` | Initial resolved value for controls with a rich payload. |
+ * | `ctrlValue()` | `string \| null` | Live raw value of the control. |
+ * | `ctrlJsonValue()` | `any` | Live resolved value (selected options, files, users, …). |
+ * | `response()` / `apiResponse` | `any` | Latest payload returned for this field. |
  */
-declare class DateRangePickerField extends FieldBase {
-    static ɵfac: i0.ɵɵFactoryDeclaration<DateRangePickerField, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DateRangePickerField, "iss-field-date-range-picker", never, {}, {}, never, never, true, never>;
-}
-
-declare class ViewerBase {
-    field: InputSignal<any>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ViewerBase, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ViewerBase, "ng-component", never, { "field": { "alias": "field"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
-declare class InputViewer extends ViewerBase {
-    static ɵfac: i0.ɵɵFactoryDeclaration<InputViewer, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<InputViewer, "iss-viewer-input", never, {}, {}, never, never, true, never>;
-}
-
-declare class TextareaViewer extends ViewerBase {
-    static ɵfac: i0.ɵɵFactoryDeclaration<TextareaViewer, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<TextareaViewer, "iss-viewer-textarea", never, {}, {}, never, never, true, never>;
-}
-
-declare class ChipsViewer extends ViewerBase {
-    keywords: i0.Signal<any>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ChipsViewer, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ChipsViewer, "iss-viewer-chips", never, {}, {}, never, never, true, never>;
-}
-
-declare class RadioViewer extends ViewerBase {
-    static ɵfac: i0.ɵɵFactoryDeclaration<RadioViewer, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<RadioViewer, "iss-viewer-radio", never, {}, {}, never, never, true, never>;
-}
-
-declare class SelectViewer extends ViewerBase {
-    static ɵfac: i0.ɵɵFactoryDeclaration<SelectViewer, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SelectViewer, "iss-viewer-select", never, {}, {}, never, never, true, never>;
-}
-
-declare class MobileViewer extends ViewerBase {
-    static ɵfac: i0.ɵɵFactoryDeclaration<MobileViewer, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MobileViewer, "iss-viewer-mobile", never, {}, {}, never, never, true, never>;
-}
-
-declare class CheckboxViewer extends ViewerBase {
-    static ɵfac: i0.ɵɵFactoryDeclaration<CheckboxViewer, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CheckboxViewer, "iss-viewer-checkbox", never, {}, {}, never, never, true, never>;
-}
-
-declare class ToggleButtonViewer extends ViewerBase {
-    static ɵfac: i0.ɵɵFactoryDeclaration<ToggleButtonViewer, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ToggleButtonViewer, "iss-viewer-toggle-button", never, {}, {}, never, never, true, never>;
-}
-
-declare class SlideToggleViewer extends ViewerBase {
-    isChecked(value: unknown): boolean;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SlideToggleViewer, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SlideToggleViewer, "iss-viewer-slide-toggle", never, {}, {}, never, never, true, never>;
+declare class IssField {
+    id: number;
+    name: string;
+    type: string;
+    base: string;
+    label: WritableSignal<string>;
+    hint: WritableSignal<string>;
+    options: WritableSignal<Option[]>;
+    api: WritableSignal<string>;
+    mode: WritableSignal<"edit" | "view">;
+    visible: WritableSignal<boolean>;
+    wasVisible: WritableSignal<boolean>;
+    events: FieldEvent[];
+    validation: any;
+    validationFns: Record<string, Function>;
+    asyncValidation: FieldAsyncValidation;
+    children: IssField[];
+    apiResponse: BehaviorSubject<any>;
+    response: WritableSignal<any>;
+    config: FieldConfig;
+    value: string;
+    jsonValue: any;
+    defaultValue: string;
+    ctrlValue: WritableSignal<string | null>;
+    ctrlJsonValue: WritableSignal<any>;
+    loading: WritableSignal<boolean>;
+    constructor(field: any, loader: Loader);
+    updateVisibility(value: boolean): void;
 }
 
-declare class PlateViewer extends ViewerBase {
-    numbersAr: i0.WritableSignal<string[]>;
-    numbersEn: i0.WritableSignal<string[]>;
-    lettersAr: i0.WritableSignal<string[]>;
-    lettersEn: i0.WritableSignal<string[]>;
-    effectRef: i0.EffectRef;
-    private convertDigit;
-    static ɵfac: i0.ɵɵFactoryDeclaration<PlateViewer, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PlateViewer, "iss-viewer-plate", never, {}, {}, never, never, true, never>;
+interface ComponentOutlet {
+    self$: Observable<Type<any> | null>;
+    data: IssField;
 }
 
-declare class AttachmentViewer extends ViewerBase {
+declare class Outlet implements OnInit, OnDestroy {
     #private;
-    uploading: InputSignal<boolean>;
-    uploadingError: InputSignal<string>;
-    deleteOut: OutputEmitterRef<File[]>;
-    attachments: i0.Signal<any>;
-    protected onDownload($event: any): void;
-    protected onDelete(index: number): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AttachmentViewer, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AttachmentViewer, "iss-viewer-attachment", never, { "uploading": { "alias": "uploading"; "required": false; "isSignal": true; }; "uploadingError": { "alias": "uploadingError"; "required": false; "isSignal": true; }; }, { "deleteOut": "deleteOut"; }, never, never, true, never>;
+    ready: OutputEmitterRef<boolean>;
+    formReady: WritableSignal<boolean>;
+    fields: InputSignal<IssField[]>;
+    components: WritableSignal<ComponentOutlet[] | null>;
+    get hostFormGroup(): FormGroup;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<Outlet, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<Outlet, "iss-form-outlet", never, { "fields": { "alias": "fields"; "required": true; "isSignal": true; }; }, { "ready": "ready"; }, never, never, true, never>;
 }
 
-declare class TimePickerViewer extends ViewerBase {
-    static ɵfac: i0.ɵɵFactoryDeclaration<TimePickerViewer, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<TimePickerViewer, "iss-viewer-time-picker", never, {}, {}, never, never, true, never>;
+declare class FieldDataInjector implements PipeTransform {
+    injector: Injector;
+    transform(field: IssField | null): Injector;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FieldDataInjector, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<FieldDataInjector, "FieldDataInjector", true>;
 }
 
-declare class DatePickerViewer extends ViewerBase {
-    protected hijriDate: Signal<string | null>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DatePickerViewer, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DatePickerViewer, "iss-viewer-date-picker", never, {}, {}, never, never, true, never>;
+declare class EventHandler {
+    #private;
+    fire(control: AbstractControl, form: FormGroup, field: IssField, change: FieldChange): Promise<void>;
+    revert(control: AbstractControl, form: FormGroup, field: IssField, change: FieldChange): Promise<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EventHandler, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<EventHandler>;
 }
 
-declare class DatePickerTimeViewer extends ViewerBase {
-    protected readonly DATETIME_FORMAT = "dd/MM/yyyy hh:mm a";
-    protected hijriDatetime: Signal<string | null>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DatePickerTimeViewer, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DatePickerTimeViewer, "iss-viewer-datetime-picker", never, {}, {}, never, never, true, never>;
+declare class FormEngine {
+    #private;
+    registerFields(form: FormGroup, owner: object, fields: IssField[]): void;
+    registerExpectedFieldNames(form: FormGroup, owner: object, names: string[]): void;
+    unregisterOutlet(form: FormGroup, owner: object): void;
+    getFields(form: FormGroup): IssField[];
+    getExpectedFieldNames(form: FormGroup): string[];
+    getField(form: FormGroup, name: string, fields?: IssField[]): IssField | undefined;
+    getControlValue(form: FormGroup, name: string): any;
+    createValidators(field: IssField): ValidatorFn[];
+    createAsyncValidators(field: IssField): AsyncValidatorFn[];
+    getFieldValue(field: IssField): string;
+    trackChangesEvents(field: IssField, form: FormGroup): Observable<FieldChange>;
+    trackChangesValidations(field: IssField, form: FormGroup): Observable<FieldChange>;
+    processTrackChanges(masterName: any, masterNames: Set<string>, changes$: Observable<FieldChange>[], field: IssField, form: FormGroup): void;
+    fieldHasValidation(field: IssField): boolean;
+    fieldHasAsyncValidation(field: IssField): boolean;
+    isFormValid(form: FormGroup, fields: IssField[]): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FormEngine, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<FormEngine>;
 }
 
-declare class DateRangePickerViewer extends ViewerBase implements OnInit {
-    dateRange: string[];
-    hijriDates: (string | null)[];
+/**
+ * Base class for every `iss-field-*` field.
+ *
+ * A field is the form-engine layer around a control: it reads its whole configuration from
+ * the injected {@link IssField} (label, options, config, validation, events), registers its
+ * `FormControl` on the parent `FormGroup` on init and removes it again on destroy, and
+ * switches between the control (`mode() === "edit"`) and the viewer (`mode() === "view"`).
+ *
+ * ### Inputs
+ * | Property | Type | Description |
+ * | --- | --- | --- |
+ * | `issField` | `IssField` | **Required.** The field definition; also provided through the `FIELD_DATA` token. |
+ * | `formReady` | `boolean \| undefined` | Set by the outlet once the whole form exists; gates event wiring. |
+ *
+ * ### Properties available on `field`
+ * `name` · `type` · `base` · `label()` · `hint()` · `options()` · `api()` · `mode()` ·
+ * `visible()` · `loading()` · `value` · `jsonValue` · `defaultValue` · `ctrlValue()` ·
+ * `ctrlJsonValue()` · `events` · `validation` · `asyncValidation` · `children` ·
+ * `response()` · `config` — see {@link IssField} and {@link FieldConfig}.
+ *
+ * Fields are not used directly in templates; the outlet resolves them from the field `type`
+ * through the `COMPONENTS` index.
+ */
+declare class FieldBase implements OnInit, OnDestroy {
+    #private;
+    /**
+     * The field definition rendered by this component. Required.
+     */
+    issField: InputSignal<IssField>;
+    /**
+     * Set by the outlet once every field is registered; field events start only after it turns true.
+     */
+    formReady: InputSignal<boolean | undefined>;
+    /**
+     * The {@link IssField} for this instance, injected through the `FIELD_DATA` token.
+     */
+    field: IssField;
+    parentFormGroup: ControlContainer;
+    formEngine: FormEngine;
+    eventHandler: EventHandler;
+    destroyRef: DestroyRef;
+    /**
+     * The `FormControl` this field registers on the parent form under `field.name`.
+     */
+    ctrl: FormControl;
+    ctrlValueChange: i0.Signal<any>;
+    get form(): FormGroup;
     ngOnInit(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DateRangePickerViewer, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DateRangePickerViewer, "iss-viewer-date-range-picker", never, {}, {}, never, never, true, never>;
-}
-
-declare const DEFAULT_COUNTRY: Country;
-declare const COUNTRIES: Country[];
-
-declare const DATE_FORMAT_ADAPTER: MatDateFormats;
-declare const DATETIME_FORMAT = "dd/MM/yyyy hh:mm a";
-
-interface PlateLetter {
-    label: {
-        ar: string;
-        en: string;
-    };
-    value: string;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FieldBase, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FieldBase, "ng-component", never, { "issField": { "alias": "issField"; "required": true; "isSignal": true; }; "formReady": { "alias": "formReady"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-declare const PLATE_LETTERS: PlateLetter[];
-
 declare const VIEW_PROVIDER: StaticProvider;
 
 declare const PLACEHOLDER_REGEX: RegExp;
 
-interface I18n {
-    ar: string;
-    en: string;
-}
-
 type ValidationMessageFn<T> = (args: T) => I18n;
 
 interface IssValidator {
@@ -1963,7 +416,7 @@ interface DynamicImport<T> {
  * | --- | --- | --- | --- |
  * | `text_input` | `InputField` | `iss-ctrl-input` | Single line text, number, email, password. |
  * | `textarea` | `TextareaField` | `iss-ctrl-textarea` | Multi line free text. |
- * | `dropdown_list` | `SelectField` | `iss-ctrl-select` | Searchable single/multi select. |
+ * | `dropdown_list` | `DropdownlistField` | `iss-ctrl-dropdownlist` | Searchable single/multi select. |
  * | `toggle_button` | `ToggleButtonField` | `iss-ctrl-toggle-button` | Options as a button group. |
  * | `checkbox` | `CheckboxField` | `iss-ctrl-checkbox` | Multi choice checkbox list. |
  * | `radio` | `RadioField` | `iss-ctrl-radio` | Single choice radio list. |
@@ -1972,7 +425,7 @@ interface DynamicImport<T> {
  * | `datetime` | `DatetimePickerField` | `iss-ctrl-datetime-picker` | Date and time together. |
  * | `date_range` | `DateRangePickerField` | `iss-ctrl-date-range-picker` | A start/end date range. |
  * | `attachment` | `FilePickerField` | `iss-ctrl-file-picker` | File upload. |
- * | `userPicker` | `UserPickerField` | `iss-ctrl-select` | Employee lookup. |
+ * | `userPicker` | `UserPickerField` | `iss-ctrl-dropdownlist` | Employee lookup. |
  * | `vehicle_plate` | `PlateField` | `iss-ctrl-plate-number` | Saudi vehicle plate. |
  * | `enrichment` | `NoteField` | — | Read-only explanatory text. |
  * | `mobile` | `MobileField` | `iss-ctrl-mobile` | International phone number. |
@@ -1996,25 +449,8 @@ declare const VALIDATORS: DynamicImport<Function>;
  */
 declare function isActiveValidationRule(value: unknown): boolean;
 
-declare const HOST: InjectionToken<string>;
-
 declare const FIELD_DATA: InjectionToken<IssField>;
 
-declare const UI_LANGUAGE: InjectionToken<string>;
-
-declare const ATTACHMENT_UPLOAD_URL: InjectionToken<string>;
-declare const ATTACHMENT_UPLOAD_RESPONSE_MAPPER: InjectionToken<(res: any) => IssAttachment[]>;
-declare const ATTACHMENT_DOWNLOAD_URL: InjectionToken<string>;
-
-declare const USER_SEARCH_API: InjectionToken<string>;
-
-declare class Hints {
-    hints: InputSignal<Hint[]>;
-    touched: InputSignal<boolean>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<Hints, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<Hints, "iss-ctrl-hints", never, { "hints": { "alias": "hints"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
 declare class ValidationMessage {
     errors: InputSignal<ValidationErrors | null>;
     showMessage: InputSignal<boolean>;
@@ -2050,47 +486,18 @@ declare class FieldViewer {
     static ɵcmp: i0.ɵɵComponentDeclaration<FieldViewer, "iss-field-viewer", never, {}, {}, never, ["label", "*"], true, never>;
 }
 
-declare class Droppable {
-    onDrop: OutputEmitterRef<FileList>;
-    onDragOver(evt: any): void;
-    onDragLeave(evt: any): void;
-    onDropped(evt: any): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<Droppable, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<Droppable, "[droppable]", never, {}, { "onDrop": "onDrop"; }, never, never, true, never>;
-}
-
 declare class ArabicNumberPipe implements PipeTransform {
     transform(n: string): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<ArabicNumberPipe, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<ArabicNumberPipe, "arabicNumber", true>;
 }
 
-declare class FieldDataInjector implements PipeTransform {
-    injector: Injector;
-    transform(field: IssField | null): Injector;
-    static ɵfac: i0.ɵɵFactoryDeclaration<FieldDataInjector, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<FieldDataInjector, "FieldDataInjector", true>;
-}
-
 declare class PlateLetterPipe implements PipeTransform {
     transform(value: string): unknown;
     static ɵfac: i0.ɵɵFactoryDeclaration<PlateLetterPipe, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<PlateLetterPipe, "plateLetter", true>;
 }
 
-declare class SelectStatusPipe implements PipeTransform {
-    transform(option: Option, ...args: unknown[]): boolean;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SelectStatusPipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<SelectStatusPipe, "selectStatus", true>;
-}
-
-declare class TranslatePipe implements PipeTransform {
-    currentLanguage: string;
-    transform(value: I18n | string, locale?: string): string;
-    static ɵfac: i0.ɵɵFactoryDeclaration<TranslatePipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<TranslatePipe, "translate", true>;
-}
-
 declare class Employee {
     #private;
     loggedInUserProfile: any;
@@ -2104,139 +511,30 @@ declare class Employee {
     static ɵprov: i0.ɵɵInjectableDeclaration<Employee>;
 }
 
-/**
- * The single date adapter behind every `iss-ctrl-*` picker.
- *
- * It behaves as a plain Gregorian adapter — `dd/MM/yyyy` in and out — until its locale is
- * switched to {@link HIJRI_LOCALE}, at which point the whole calendar grid becomes Umm
- * al-Qura Hijri: the month lengths, the year and month labels and the day numbers all come
- * from the Hijri calendar.
- *
- * The value never changes shape. The adapter always works on a `Date`, so a Hijri calendar
- * still hands the control an ordinary `Date`, and it stays the control's decision whether to
- * emit that as a Gregorian or a Hijri string.
- *
- * Switch modes through {@link setHijri}, never by assigning `locale` — `setLocale` is what
- * tells an open calendar to re-render.
- */
-declare class IssDateAdapter extends NativeDateAdapter {
+declare class FileHandler {
     #private;
-    /** The Gregorian locale to fall back to when the Hijri calendar is turned off. */
-    gregorianLocale: string;
-    /** Whether the adapter is currently presenting the Hijri calendar. */
-    get isHijri(): boolean;
-    /**
-     * Turns the Hijri calendar on or off. Goes through `setLocale` so that a calendar that is
-     * already open redraws itself.
-     */
-    setHijri(hijri: boolean): void;
-    getYear(date: Date): number;
-    getMonth(date: Date): number;
-    getDate(date: Date): number;
-    getMonthNames(style: "long" | "short" | "narrow"): string[];
-    getDateNames(): string[];
-    getDayOfWeekNames(style: "long" | "short" | "narrow"): string[];
-    getYearName(date: Date): string;
-    getFirstDayOfWeek(): number;
-    getNumDaysInMonth(date: Date): number;
-    createDate(year: number, month: number, date: number): Date;
-    addCalendarYears(date: Date, years: number): Date;
-    addCalendarMonths(date: Date, months: number): Date;
-    addCalendarDays(date: Date, days: number): Date;
-    parse(value: any, parseFormat?: any): Date | null;
-    format(date: Date, displayFormat: string): string;
-    deserialize(value: any): Date | null;
-    toIso8601(date: Date): string;
-    static ɵfac: i0.ɵɵFactoryDeclaration<IssDateAdapter, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<IssDateAdapter>;
+    ATTACHMENT_UPLOAD_URL: string;
+    ATTACHMENT_DOWNLOAD_URL: string;
+    attachmentAdapter: (res: any) => IssAttachment[];
+    upload(data: FormData): Observable<IssAttachment[]>;
+    formDataFactory(files: IssFile[], multiple: boolean): FormData | null;
+    formDataHasValue(formData: FormData): boolean;
+    getFileFromFormData(formData: FormData, name: string): IssFile[];
+    formatFileSize(x: string | number): string;
+    fetchFileInfo(id: string): Observable<IssFile>;
+    fetchFiles(ids: string): Observable<IssFile[]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FileHandler, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<FileHandler>;
 }
-/**
- * Providers every date-based control needs: the {@link IssDateAdapter} itself, the Gregorian
- * locale it falls back to, and the `dd/MM/yyyy` formats both of its calendars are rendered in.
- *
- * Declared per component, so each picker owns its adapter instance and one field switching to
- * the Hijri calendar leaves every other field on the form alone.
- */
-declare function provideIssDateAdapter(): Provider[];
 
 declare function arrayFrom<T>(length: number, valueFunction: (index: number) => T): T[];
 
-declare function formatFileSize(x: string | number): string;
-
 declare function getPropertyByPath(obj: any, path: string | undefined): any;
 
-/**
- * Umm al-Qura Hijri calendar helpers.
- *
- * Every function here works on a plain `Date`: a `Date` is an instant, and the Hijri
- * calendar is only another way of naming that instant. Nothing stores Hijri numbers on the
- * date itself, so a value converted to Hijri for display or emission is still the same day.
- *
- * The conversion is done by `Intl` with the `islamic-umalqura` calendar, which is the
- * calendar used officially in Saudi Arabia.
- */
-/** Locale used by the calendar UI when the Hijri calendar is on. */
-declare const HIJRI_LOCALE = "ar-SA-u-ca-islamic-umalqura";
-declare const HIJRI_MONTH_NAMES: {
-    ar: string[];
-    en: string[];
-    enShort: string[];
-};
-interface HijriParts {
-    /** Hijri year, for example `1447`. */
-    year: number;
-    /** Hijri month, **zero based** like `Date.getMonth()` — `0` is Muharram. */
-    month: number;
-    /** Hijri day of month, starting at `1`. */
-    day: number;
-}
-/**
- * Reads the Hijri year, month and day a `Date` falls on.
- */
-declare function getHijriParts(date: Date): HijriParts;
-/**
- * The Gregorian `Date` of the first day of the Hijri month `date` falls in, at midday.
- *
- * Midday, not midnight, so a daylight-saving shift can never push the result into the
- * previous day while the month is being walked.
- */
-declare function startOfHijriMonth(date: Date): Date;
-/**
- * Number of days in the Hijri month `date` falls in — 29 or 30, decided by Umm al-Qura.
- */
-declare function getHijriDaysInMonth(date: Date): number;
-/**
- * Builds the `Date` for a Hijri year/month/day. The month is zero based, and a day past the
- * end of the month is clamped to the last day of that month.
- */
-declare function createHijriDate(year: number, month: number, day: number): Date;
-/**
- * Formats a date as a Hijri `yyyy-MM-dd` string — the shape the form emits when
- * `emitHijri` is on.
- */
-declare function formatHijriDate(date: Date): string;
-/**
- * Reads a Hijri date back into a `Date`, accepting both the emitted `yyyy-MM-dd` shape and
- * the `dd/MM/yyyy` shape shown in the input. Returns `null` for anything else.
- */
-declare function parseHijriDate(value: string | null | undefined): Date | null;
-/**
- * Renders a stored form value as a Hijri `dd/MM/yyyy` string for the read-only viewers, or
- * returns `null` when the field is not on the Hijri calendar and the value should be shown
- * as an ordinary Gregorian date.
- *
- * The two Hijri modes store different things, so they are read differently: with `emitHijri`
- * the value already carries Hijri numbers and only its notation changes, while with
- * `hijriCalendar` alone the value is Gregorian and has to be converted.
- */
-declare function toHijriDisplay(value: string | null | undefined, options: {
-    hijriCalendar?: boolean;
-    emitHijri?: boolean;
-    withTime?: boolean;
-}): string | null;
-
 declare function replacePlaceholders(str: string, values: any): string;
 
+declare function formatFileSize(x: string | number): string;
+
 declare abstract class IssValidators {
     static required(): ValidatorFn;
     static max(maxValue: number): ValidatorFn;
@@ -2261,5 +559,5 @@ declare abstract class TimeValidator {
     static afterDate(otherFieldName: string): ValidatorFn;
 }
 
-export { ATTACHMENT_DOWNLOAD_URL, ATTACHMENT_UPLOAD_RESPONSE_MAPPER, ATTACHMENT_UPLOAD_URL, ArabicNumberPipe, AttachmentViewer, COMPONENTS, COUNTRIES, CheckboxControl, CheckboxField, CheckboxViewer, ChipsControl, ChipsField, ChipsViewer, ControlBase, DATETIME_FORMAT, DATE_FORMAT_ADAPTER, DEFAULT_COUNTRY, DatePickerControl, DatePickerField, DatePickerTimeViewer, DatePickerViewer, DateRangePickerControl, DateRangePickerField, DateRangePickerViewer, DatetimePickerControl, DatetimePickerField, Droppable, Employee, FIELD_DATA, FieldBase, FieldDataInjector, FieldViewer, FileHandler, FilePickerControl, FilePickerField, FileValidators, FormEngine, HIJRI_LOCALE, HIJRI_MONTH_NAMES, HOST, Hints, InputControl, InputField, InputViewer, IssDateAdapter, IssValidators, Loader, MobileControl, MobileField, MobileViewer, Outlet, PLACEHOLDER_REGEX, PLATE_LETTERS, Phone, PlateControl, PlateField, PlateLetterPipe, PlateViewer, RadioControl, RadioField, RadioViewer, SERVICES, SelectControl, SelectField, SelectStatusPipe, SelectViewer, SlideToggleControl, SlideToggleField, SlideToggleViewer, TextareaControl, TextareaField, TextareaViewer, TimePickerControl, TimePickerField, TimePickerViewer, TimeValidator, ToggleButtonControl, ToggleButtonField, ToggleButtonViewer, TranslatePipe, UI_LANGUAGE, USER_SEARCH_API, VALIDATION_MESSAGES, VALIDATORS, VIEW_PROVIDER, ValidationMessage, arrayFrom, createHijriDate, formatFileSize, formatHijriDate, getHijriDaysInMonth, getHijriParts, getPropertyByPath, isActiveValidationRule, parseHijriDate, provideIssDateAdapter, replacePlaceholders, startOfHijriMonth, toHijriDisplay };
-export type { ActionTriggerFn, ComponentOutlet, Country, DateRangeEmission, DynamicImport, EventArgument, EventConfigFn, EventStrategy, FieldChange, HijriParts, Hint, HintAlignment, I18n, ISO2, IssAttachment, IssFile, IssValidator, Mobile, Option, PlateLetter, ValidationMessageFn };
+export { ArabicNumberPipe, COMPONENTS, Employee, FIELD_DATA, FieldBase, FieldDataInjector, FieldViewer, FileHandler, FileValidators, FormEngine, IssValidators, Loader, Outlet, PLACEHOLDER_REGEX, PlateLetterPipe, SERVICES, TimeValidator, VALIDATION_MESSAGES, VALIDATORS, VIEW_PROVIDER, ValidationMessage, arrayFrom, formatFileSize, getPropertyByPath, isActiveValidationRule, replacePlaceholders };
+export type { ActionTriggerFn, ComponentOutlet, DynamicImport, EventArgument, EventConfigFn, EventStrategy, FieldChange, IssValidator, ValidationMessageFn };