@quadrel-enterprise-ui/framework 20.27.1 → 20.27.3-beta.234.1

package/index.d.ts

@@ -7,14 +7,14 @@ import { InjectionToken, EventEmitter, OnInit, PipeTransform, TemplateRef, After
 import { HttpInterceptor, HttpRequest, HttpHandler, HttpEvent, HttpParams } from '@angular/common/http';
 import * as i2 from '@angular/common';
 import { Moment } from 'moment/moment';
-import * as i31 from '@angular/forms';
+import * as i30 from '@angular/forms';
 import { AbstractControl, UntypedFormGroup, ControlValueAccessor, UntypedFormControl, ValidationErrors, FormControlOptions, AsyncValidatorFn, ValidatorFn, UntypedFormArray, AbstractControlOptions, ɵTypedOrUntyped as _TypedOrUntyped, UntypedFormBuilder, FormGroup, FormArray } from '@angular/forms';
 import * as i9 from '@ngx-translate/core';
 import { TranslateService } from '@ngx-translate/core';
 import { OverlayRef, OverlayPositionBuilder, Overlay, ConnectedPosition } from '@angular/cdk/overlay';
 import * as i4 from '@angular/router';
 import { Params } from '@angular/router';
-import * as i39 from 'ngx-editor';
+import * as i38 from 'ngx-editor';
 import { Editor, Toolbar } from 'ngx-editor';
 import { Moment as Moment$1 } from 'moment';
 import { Highlightable, ActiveDescendantKeyManager } from '@angular/cdk/a11y';
@@ -628,7 +628,9 @@ declare class QdMockPopoverOnClickDirective {
     qdPopoverHeight: any;
     qdPopoverMinHeight: any;
     qdPopoverMaxHeight: any;
-    positionStrategy: any;
+    qdPopoverPlacement: any;
+    qdPopoverOffsetX: any;
+    qdPopoverOffsetY: any;
     qdPopoverCloseStrategy: any;
     qdPopoverDisabled: any;
     qdPopoverStopPropagation: boolean;
@@ -644,7 +646,7 @@ declare class QdMockPopoverOnClickDirective {
     private isElementInTemplateClicked;
     private getTemplateRootNode;
     static ɵfac: i0.ɵɵFactoryDeclaration<QdMockPopoverOnClickDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<QdMockPopoverOnClickDirective, "[qdPopoverOnClick]", ["qdPopoverOnClick"], { "qdPopoverOnClick": { "alias": "qdPopoverOnClick"; "required": false; }; "qdPopoverWidth": { "alias": "qdPopoverWidth"; "required": false; }; "qdPopoverMinWidth": { "alias": "qdPopoverMinWidth"; "required": false; }; "qdPopoverMaxWidth": { "alias": "qdPopoverMaxWidth"; "required": false; }; "qdPopoverHeight": { "alias": "qdPopoverHeight"; "required": false; }; "qdPopoverMinHeight": { "alias": "qdPopoverMinHeight"; "required": false; }; "qdPopoverMaxHeight": { "alias": "qdPopoverMaxHeight"; "required": false; }; "positionStrategy": { "alias": "positionStrategy"; "required": false; }; "qdPopoverCloseStrategy": { "alias": "qdPopoverCloseStrategy"; "required": false; }; "qdPopoverDisabled": { "alias": "qdPopoverDisabled"; "required": false; }; "qdPopoverStopPropagation": { "alias": "qdPopoverStopPropagation"; "required": false; }; }, { "opened": "opened"; "closed": "closed"; }, never, never, false, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<QdMockPopoverOnClickDirective, "[qdPopoverOnClick]", ["qdPopoverOnClick"], { "qdPopoverOnClick": { "alias": "qdPopoverOnClick"; "required": false; }; "qdPopoverWidth": { "alias": "qdPopoverWidth"; "required": false; }; "qdPopoverMinWidth": { "alias": "qdPopoverMinWidth"; "required": false; }; "qdPopoverMaxWidth": { "alias": "qdPopoverMaxWidth"; "required": false; }; "qdPopoverHeight": { "alias": "qdPopoverHeight"; "required": false; }; "qdPopoverMinHeight": { "alias": "qdPopoverMinHeight"; "required": false; }; "qdPopoverMaxHeight": { "alias": "qdPopoverMaxHeight"; "required": false; }; "qdPopoverPlacement": { "alias": "qdPopoverPlacement"; "required": false; }; "qdPopoverOffsetX": { "alias": "qdPopoverOffsetX"; "required": false; }; "qdPopoverOffsetY": { "alias": "qdPopoverOffsetY"; "required": false; }; "qdPopoverCloseStrategy": { "alias": "qdPopoverCloseStrategy"; "required": false; }; "qdPopoverDisabled": { "alias": "qdPopoverDisabled"; "required": false; }; "qdPopoverStopPropagation": { "alias": "qdPopoverStopPropagation"; "required": false; }; }, { "opened": "opened"; "closed": "closed"; }, never, never, false, never>;
 }
 
 declare class QdMockCoreModule {
@@ -3688,7 +3690,7 @@ declare class QdMockCheckboxChipsItemComponent {
 
 declare class QdMockFormsModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<QdMockFormsModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<QdMockFormsModule, [typeof QdMockCalendarComponent, typeof QdMockCheckboxChipsComponent, typeof QdMockCheckboxChipsItemComponent, typeof QdMockCheckboxComponent, typeof QdMockCheckboxesComponent, typeof QdMockDatepickerComponent, typeof QdMockDropdownComponent, typeof QdMockFilterFormItemsComponent, typeof QdMockFormErrorComponent, typeof QdMockFormGroupErrorComponent, typeof QdMockFormHintComponent, typeof QdMockFormLabelComponent, typeof QdMockFormReadonlyComponent, typeof QdMockFormViewonlyComponent, typeof QdMockInputComponent, typeof QdMockPinCodeComponent, typeof QdMockRadioButtonsComponent, typeof QdMockSwitchComponent, typeof QdMockSwitchesComponent, typeof QdMockTextareaComponent], [typeof i2.CommonModule, typeof i31.FormsModule], [typeof QdMockCalendarComponent, typeof QdMockCheckboxChipsComponent, typeof QdMockCheckboxComponent, typeof QdMockCheckboxesComponent, typeof QdMockDatepickerComponent, typeof QdMockDropdownComponent, typeof QdMockFilterFormItemsComponent, typeof QdMockFormErrorComponent, typeof QdMockFormGroupErrorComponent, typeof QdMockFormHintComponent, typeof QdMockFormLabelComponent, typeof QdMockFormReadonlyComponent, typeof QdMockFormViewonlyComponent, typeof QdMockInputComponent, typeof QdMockPinCodeComponent, typeof QdMockRadioButtonsComponent, typeof QdMockSwitchComponent, typeof QdMockSwitchesComponent, typeof QdMockTextareaComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<QdMockFormsModule, [typeof QdMockCalendarComponent, typeof QdMockCheckboxChipsComponent, typeof QdMockCheckboxChipsItemComponent, typeof QdMockCheckboxComponent, typeof QdMockCheckboxesComponent, typeof QdMockDatepickerComponent, typeof QdMockDropdownComponent, typeof QdMockFilterFormItemsComponent, typeof QdMockFormErrorComponent, typeof QdMockFormGroupErrorComponent, typeof QdMockFormHintComponent, typeof QdMockFormLabelComponent, typeof QdMockFormReadonlyComponent, typeof QdMockFormViewonlyComponent, typeof QdMockInputComponent, typeof QdMockPinCodeComponent, typeof QdMockRadioButtonsComponent, typeof QdMockSwitchComponent, typeof QdMockSwitchesComponent, typeof QdMockTextareaComponent], [typeof i2.CommonModule, typeof i30.FormsModule], [typeof QdMockCalendarComponent, typeof QdMockCheckboxChipsComponent, typeof QdMockCheckboxComponent, typeof QdMockCheckboxesComponent, typeof QdMockDatepickerComponent, typeof QdMockDropdownComponent, typeof QdMockFilterFormItemsComponent, typeof QdMockFormErrorComponent, typeof QdMockFormGroupErrorComponent, typeof QdMockFormHintComponent, typeof QdMockFormLabelComponent, typeof QdMockFormReadonlyComponent, typeof QdMockFormViewonlyComponent, typeof QdMockInputComponent, typeof QdMockPinCodeComponent, typeof QdMockRadioButtonsComponent, typeof QdMockSwitchComponent, typeof QdMockSwitchesComponent, typeof QdMockTextareaComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<QdMockFormsModule>;
 }
 
@@ -5231,6 +5233,7 @@ declare class QdPopoverParentService {
     static ɵprov: i0.ɵɵInjectableDeclaration<QdPopoverParentService>;
 }
 
+type QdPopoverPlacement = 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end';
 /**
  * **QdPopoverOnClickDirective**
  *
@@ -5258,19 +5261,108 @@ declare class QdPopoverOnClickDirective implements OnInit, OnDestroy {
     protected popoverService: QdPopoverService;
     protected sizingService: QdPopoverSizingService;
     protected popoverParentService: QdPopoverParentService;
+    private readonly _topFirst;
+    /**
+     * The template shown inside the popover.
+     *
+     * Pass the `ng-template` that holds the menu, option list or panel.
+     */
     qdPopoverOnClick: TemplateRef<unknown>;
-    positionStrategy?: ConnectedPosition | ConnectedPosition[];
+    /**
+     * Which corner of the host the popover opens from.
+     *
+     * One of `bottom-start`, `bottom-end`, `top-start` or `top-end`. When unset,
+     * the popover uses the default end-aligned position below the host.
+     */
+    qdPopoverPlacement?: QdPopoverPlacement;
+    /**
+     * Fine-tunes the horizontal position, in pixels.
+     *
+     * A negative value moves the popover left, a positive value moves it right.
+     */
+    qdPopoverOffsetX: number;
+    /**
+     * Fine-tunes the vertical gap to the host, in pixels.
+     *
+     * A negative value moves the popover up, a positive value moves it down. The
+     * value is mirrored when the popover flips, so the gap looks the same whether
+     * it opens downward or upward.
+     */
+    qdPopoverOffsetY: number;
+    /**
+     * Decides when a click closes the popover.
+     *
+     * `onEveryClick` (default) closes it on the next click anywhere, including
+     * inside the popover. `onOutsideClick` keeps it open while you click inside
+     * and only closes on a click outside.
+     */
     qdPopoverCloseStrategy: 'onEveryClick' | 'onOutsideClick';
+    /**
+     * Turns the popover off.
+     *
+     * While `true`, clicks and keys on the host no longer open it.
+     */
     qdPopoverDisabled: boolean;
+    /**
+     * Stops the opening click from bubbling to parent elements.
+     *
+     * Keep it `true` so an outer click handler does not fire as well. Set it
+     * `false` when a parent must react to the same click.
+     */
     qdPopoverStopPropagation: boolean;
+    /**
+     * Background colour of the popover panel.
+     *
+     * When unset, the panel uses its default colour.
+     */
     qdPopoverBackgroundColor?: QdPopoverBackgroundColor;
+    /**
+     * Tallest the popover may get, in pixels.
+     *
+     * Once the content is taller, it scrolls inside the popover. `none` removes
+     * the limit.
+     */
     qdPopoverMaxHeight: number | 'none';
+    /**
+     * Narrowest the popover may get, in pixels.
+     *
+     * `none` removes the lower limit.
+     */
     qdPopoverMinWidth: number | 'none';
+    /**
+     * Widest the popover may get, in pixels.
+     *
+     * `none` removes the upper limit. The popover is never wider than the screen,
+     * even if a larger value is set.
+     */
     qdPopoverMaxWidth: number | 'none';
+    /**
+     * Matches the popover size to the host or its content.
+     *
+     * Set `width` and/or `height` to `true`. An empty object keeps the natural
+     * content size. The min and max limits still apply.
+     */
     qdPopoverAutoSize: QdPopoverAutoSizeConfig;
+    /**
+     * Turns on keyboard control.
+     *
+     * While `true`, Enter and Space open the popover and Escape and Tab close it.
+     */
     qdPopoverEnableKeyControl: boolean;
+    /**
+     * Lets the popover flip to the side that has room.
+     *
+     * While `true`, a popover that would open past the screen edge opens to the
+     * opposite side instead. It is opt-in, so popovers that already fit stay put.
+     */
     qdPopoverFlipIntoViewport: boolean;
+    /**
+     * Emits after the popover has opened.
+     */
     readonly opened: EventEmitter<any>;
+    /**
+     * Emits after the popover has closed.
+     */
     readonly closed: EventEmitter<any>;
     handleClick(event: MouseEvent): void;
     handleDocumentClick(event: PointerEvent): void;
@@ -5299,6 +5391,8 @@ declare class QdPopoverOnClickDirective implements OnInit, OnDestroy {
     close(): void;
     private popoverInstance;
     private initPositionStrategy;
+    private buildPlacementPositions;
+    private applyOffsets;
     private withHorizontalFallbacks;
     private createOverlay;
     private runSizingAndOpen;
@@ -5309,7 +5403,7 @@ declare class QdPopoverOnClickDirective implements OnInit, OnDestroy {
     private unsubscribeAll;
     private cleanup;
     static ɵfac: i0.ɵɵFactoryDeclaration<QdPopoverOnClickDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<QdPopoverOnClickDirective, "[qdPopoverOnClick]", ["qdPopoverOnClick"], { "qdPopoverOnClick": { "alias": "qdPopoverOnClick"; "required": false; }; "positionStrategy": { "alias": "positionStrategy"; "required": false; }; "qdPopoverCloseStrategy": { "alias": "qdPopoverCloseStrategy"; "required": false; }; "qdPopoverDisabled": { "alias": "qdPopoverDisabled"; "required": false; }; "qdPopoverStopPropagation": { "alias": "qdPopoverStopPropagation"; "required": false; }; "qdPopoverBackgroundColor": { "alias": "qdPopoverBackgroundColor"; "required": false; }; "qdPopoverMaxHeight": { "alias": "qdPopoverMaxHeight"; "required": false; }; "qdPopoverMinWidth": { "alias": "qdPopoverMinWidth"; "required": false; }; "qdPopoverMaxWidth": { "alias": "qdPopoverMaxWidth"; "required": false; }; "qdPopoverAutoSize": { "alias": "qdPopoverAutoSize"; "required": false; }; "qdPopoverEnableKeyControl": { "alias": "qdPopoverEnableKeyControl"; "required": false; }; "qdPopoverFlipIntoViewport": { "alias": "qdPopoverFlipIntoViewport"; "required": false; }; }, { "opened": "opened"; "closed": "closed"; }, never, never, false, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<QdPopoverOnClickDirective, "[qdPopoverOnClick]", ["qdPopoverOnClick"], { "qdPopoverOnClick": { "alias": "qdPopoverOnClick"; "required": false; }; "qdPopoverPlacement": { "alias": "qdPopoverPlacement"; "required": false; }; "qdPopoverOffsetX": { "alias": "qdPopoverOffsetX"; "required": false; }; "qdPopoverOffsetY": { "alias": "qdPopoverOffsetY"; "required": false; }; "qdPopoverCloseStrategy": { "alias": "qdPopoverCloseStrategy"; "required": false; }; "qdPopoverDisabled": { "alias": "qdPopoverDisabled"; "required": false; }; "qdPopoverStopPropagation": { "alias": "qdPopoverStopPropagation"; "required": false; }; "qdPopoverBackgroundColor": { "alias": "qdPopoverBackgroundColor"; "required": false; }; "qdPopoverMaxHeight": { "alias": "qdPopoverMaxHeight"; "required": false; }; "qdPopoverMinWidth": { "alias": "qdPopoverMinWidth"; "required": false; }; "qdPopoverMaxWidth": { "alias": "qdPopoverMaxWidth"; "required": false; }; "qdPopoverAutoSize": { "alias": "qdPopoverAutoSize"; "required": false; }; "qdPopoverEnableKeyControl": { "alias": "qdPopoverEnableKeyControl"; "required": false; }; "qdPopoverFlipIntoViewport": { "alias": "qdPopoverFlipIntoViewport"; "required": false; }; }, { "opened": "opened"; "closed": "closed"; }, never, never, false, never>;
 }
 
 /**
@@ -6600,7 +6694,6 @@ declare class QdDropdownComponent implements ControlValueAccessor, OnInit, OnCha
     options: QdFormOption[];
     filterText: '';
     control: AbstractControl;
-    positionStrategy: ConnectedPosition[];
     private _value;
     private _selectedOption;
     private _subs;
@@ -6634,7 +6727,6 @@ declare class QdDropdownComponent implements ControlValueAccessor, OnInit, OnCha
     handleFilterChange($event: any): void;
     onOpenDropdown(): void;
     onDropdownClosed(): void;
-    private getPositionStrategy;
     private loadOptionsForCurrentConfig;
     private resolveControl;
     private updateConfiguration;
@@ -7094,7 +7186,7 @@ declare class QdFileUploadService {
  */
 declare class QdInputComponent implements OnInit, OnChanges, OnDestroy, ControlValueAccessor, QdFocusable {
     private readonly actionEmitterService;
-    private readonly resolverRegistry;
+    private readonly optionsService;
     private readonly controlContainer;
     private readonly eventBrokerService;
     private readonly numberInputService;
@@ -7173,6 +7265,8 @@ declare class QdInputComponent implements OnInit, OnChanges, OnDestroy, ControlV
      * }
      */
     readonly optionsResolved: EventEmitter<QdFormOptionsResolvedEvent>;
+    closeOptions(): void;
+    openOptionsOnArrow(event: KeyboardEvent): void;
     readonly: boolean;
     readonlyAction: boolean;
     viewonly: boolean;
@@ -7185,6 +7279,8 @@ declare class QdInputComponent implements OnInit, OnChanges, OnDestroy, ControlV
     get isErrorFromOutside(): boolean;
     get isAmbiguousState(): boolean;
     inputElement: ElementRef;
+    private popover?;
+    isOptionsOpen: boolean;
     inputType: QdInputType;
     inputMode: QdInputMode;
     htmlInputType: string;
@@ -7197,8 +7293,8 @@ declare class QdInputComponent implements OnInit, OnChanges, OnDestroy, ControlV
     _value: QdInputValueWithUnit;
     _displayValue: string;
     control: AbstractControl | QdFormControl<any>;
-    private _optionsResolver;
     private _subs;
+    private _filteredOptions;
     private _isUserTyped;
     private _onChange;
     private _onTouch;
@@ -7219,6 +7315,8 @@ declare class QdInputComponent implements OnInit, OnChanges, OnDestroy, ControlV
     setDisabledState(disabled: boolean): void;
     handleInput(event: any): void;
     handleOptionSelected(option: QdFormInputOption): void;
+    onOptionsOpened(): void;
+    onOptionsClosed(): void;
     handleUnitChange(unit: any): void;
     handleInputFocus(): void;
     handleInputBlur(): void;
@@ -7228,7 +7326,8 @@ declare class QdInputComponent implements OnInit, OnChanges, OnDestroy, ControlV
     focus(): void;
     emitEnterClick(): void;
     private updateConfig;
-    private initializeOptionsResolver;
+    private subscribeToOptions;
+    private loadOptionsForTypedValue;
     private emitValue;
     private initOpModeSubscription;
     private normalizeInitialControlValueIfNeeded;
@@ -8830,118 +8929,24 @@ declare class QdInputUnitsComponent implements OnInit, OnChanges {
     static ɵcmp: i0.ɵɵComponentDeclaration<QdInputUnitsComponent, "qd-input-units", never, { "config": { "alias": "config"; "required": false; }; "unitValue": { "alias": "unit"; "required": false; }; }, { "unitChange": "unitChange"; "opened": "opened"; "closed": "closed"; }, never, never, false, never>;
 }
 
-/**
- * Manages the options popover of a form input, including resolver-based options.
- * The resolver trigger rules are defined on {@link QdFormOptionsResolver}.
- *
- * Invariant: the `value` setter resolves options only on actual value changes. Selecting
- * an option assigns the option's i18n key as the new value right away, because the host
- * component writes exactly that key back into the `value` binding for display purposes —
- * the write-back therefore arrives as a no-op instead of resolving with the i18n key.
- */
-declare class QdInputOptionsDirective extends QdPopoverOnClickDirective implements OnInit, OnChanges, OnDestroy, AfterViewInit {
-    private readonly translateService;
-    private readonly viewContainerRef;
-    private readonly changeDetectorRef;
+declare class QdInputOptionsComponent implements OnInit, AfterViewInit {
     private readonly resolverRegistry;
-    private readonly controlContainer;
-    get value(): QdInputValue;
-    /**
-     * The value of the form input
-     */
-    set value(value: QdInputValue);
-    /**
-     * The configuration of the form input
-     *
-     * @example
-     * {
-     *   label: { i18n: 'label' },
-     *   placeholder: { i18n: 'placeholder' },
-     *   hint: { i18n: 'hint' }
-     * };
-     */
-    config: QdFormInputConfiguration;
-    /**
-     * Emits event when the value has changed. Note: Emits on keyup (no longer on click, as before)!
-     */
-    readonly enterClick: EventEmitter<any>;
-    /**
-     * Emits event when an option in the fly out has been selected.
-     */
+    private readonly keyboardService;
+    private readonly optionsService;
     readonly optionSelected: EventEmitter<_quadrel_enterprise_ui_framework.QdFormBaseOption>;
-    /**
-     * Emits the resolved options and the depended-on values they were resolved with,
-     * after every resolver run.
-     *
-     * The resolver fetches the options; this output lets the component react to them —
-     * typically to drop a selection the new options no longer contain (e.g. clear the
-     * chosen city once the country changed).
-     *
-     * @example
-     * onCityOptionsResolved(event: QdFormOptionsResolvedEvent): void {
-     *   const city = this.form.get('city');
-     *   if (city?.value && !event.options.some(o => o.value === city.value)) city.reset();
-     * }
-     */
-    readonly optionsResolved: EventEmitter<QdFormOptionsResolvedEvent>;
-    onSpace(): void;
-    onEscape(): void;
-    onTab(): void;
+    optionComponents: QueryList<QdFormInputComponent>;
+    readonly filteredOptions$: Observable<QdFormResolvedOptions>;
+    readonly optionsRequestState$: Observable<QdFormOptionsRequestState>;
+    protected readonly QdFormOptionsRequestState: typeof QdFormOptionsRequestState;
     private _optionsResolver;
-    private _optionsRequestStateSubject;
-    private readonly _optionsLoadingHintDelay;
-    private readonly _optionsLoadingHintMinTime;
-    private _hostElement;
-    private _keyManager?;
-    private _value;
-    private _filteredOptionsSubject;
-    private _destroyed$;
-    private _dependsOnSubscription;
-    private readonly _resolveRequests$;
-    filteredOptions$: rxjs.Observable<QdFormResolvedOptions>;
-    optionsRequestState$: rxjs.Observable<QdFormOptionsRequestState>;
-    formInputComponents: QueryList<QdFormInputComponent>;
-    constructor();
-    ngOnInit(): void;
-    private initializeOptionsResolver;
-    ngOnChanges(changes: SimpleChanges): void;
-    ngOnDestroy(): void;
-    ngAfterViewInit(): void;
-    onKeyDown(event: KeyboardEvent): void;
-    selectOption(option: QdFormResolvedOption): void;
-    private logWarningIfBothOptionsAndResolverAreUsed;
-    private logWarningIfDependsOnWithoutFormGroup;
-    private closePopover;
-    private createKeyManager;
-    private setPopoverProperties;
-    private hasOptions;
-    private updateOptions;
-    private updateOptionsWhenDependsOnControlsChange;
-    private updateOptionsWithResolver;
-    private publishLatestResolvedOptions;
-    private filterOptions;
-    static ɵfac: i0.ɵɵFactoryDeclaration<QdInputOptionsDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<QdInputOptionsDirective, "[qdInputOptions]", never, { "value": { "alias": "value"; "required": false; }; "config": { "alias": "config"; "required": false; }; }, { "enterClick": "enterClick"; "optionSelected": "optionSelected"; "optionsResolved": "optionsResolved"; }, never, never, false, never>;
-}
-
-declare class QdInputOptionsComponent implements OnInit, AfterViewInit {
-    private readonly resolverRegistry;
-    filteredOptions$: Observable<QdFormResolvedOptions>;
-    optionsRequestState$: Observable<QdFormOptionsRequestState>;
-    template: EventEmitter<TemplateRef<any>>;
-    formInputComponents: EventEmitter<QueryList<QdFormInputComponent>>;
-    optionSelected: EventEmitter<_quadrel_enterprise_ui_framework.QdFormBaseOption>;
-    private _template;
-    _formInputComponents: QueryList<QdFormInputComponent>;
     get requestLoadingHintI18n(): string;
     get requestErrorHintI18n(): string;
-    protected readonly QdFormOptionsRequestState: typeof QdFormOptionsRequestState;
-    private _optionsResolver;
+    onKeyDown(event: KeyboardEvent): void;
     ngOnInit(): void;
     ngAfterViewInit(): void;
     selectOption(option: QdFormResolvedOption): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<QdInputOptionsComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<QdInputOptionsComponent, "qd-input-options", never, { "filteredOptions$": { "alias": "filteredOptions$"; "required": false; }; "optionsRequestState$": { "alias": "optionsRequestState$"; "required": false; }; }, { "template": "template"; "formInputComponents": "formInputComponents"; "optionSelected": "optionSelected"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<QdInputOptionsComponent, "qd-input-options", never, {}, { "optionSelected": "optionSelected"; }, never, never, false, never>;
 }
 
 type QdMultiInputChipColor = 'default' | 'error' | 'pending';
@@ -9076,7 +9081,7 @@ declare class QdTooltipModule {
 
 declare class QdFormModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<QdFormModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<QdFormModule, [typeof QdCalendarComponent, typeof QdCheckboxChipsComponent, typeof QdCheckboxChipsItemComponent, typeof QdCheckboxComponent, typeof QdCheckboxesComponent, typeof QdDatepickerComponent, typeof QdDropdownComponent, typeof QdDropdownOptionsComponent, typeof QdFilterFormItemsComponent, typeof QdFormErrorComponent, typeof QdFormHintComponent, typeof QdFormLabelComponent, typeof QdFormReadonlyComponent, typeof QdFormViewonlyComponent, typeof QdInputComponent, typeof QdInputUnitsComponent, typeof QdInputOptionsDirective, typeof QdInputOptionsComponent, typeof QdMultiInputChipComponent, typeof QdMultiInputMenuComponent, typeof QdMultiInputComponent, typeof QdPinCodeComponent, typeof QdRadioButtonsComponent, typeof QdSwitchComponent, typeof QdSwitchesComponent, typeof QdTextareaComponent, typeof QdFormInputComponent, typeof QdRichtextComponent, typeof QdFileUploadComponent], [typeof i2.CommonModule, typeof i31.FormsModule, typeof i31.ReactiveFormsModule, typeof i9.TranslateModule, typeof QdAutofocusModule, typeof QdChipModule, typeof QdCoreModule, typeof QdIconModule, typeof QdPopoverModule, typeof QdTooltipModule, typeof i39.NgxEditorModule], [typeof QdCheckboxChipsComponent, typeof QdCheckboxComponent, typeof QdCheckboxesComponent, typeof QdDatepickerComponent, typeof QdDropdownComponent, typeof QdFilterFormItemsComponent, typeof QdInputComponent, typeof QdMultiInputComponent, typeof QdPinCodeComponent, typeof QdRadioButtonsComponent, typeof QdSwitchComponent, typeof QdSwitchesComponent, typeof QdTextareaComponent, typeof QdRichtextComponent, typeof QdFileUploadComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<QdFormModule, [typeof QdCalendarComponent, typeof QdCheckboxChipsComponent, typeof QdCheckboxChipsItemComponent, typeof QdCheckboxComponent, typeof QdCheckboxesComponent, typeof QdDatepickerComponent, typeof QdDropdownComponent, typeof QdDropdownOptionsComponent, typeof QdFilterFormItemsComponent, typeof QdFormErrorComponent, typeof QdFormHintComponent, typeof QdFormLabelComponent, typeof QdFormReadonlyComponent, typeof QdFormViewonlyComponent, typeof QdInputComponent, typeof QdInputUnitsComponent, typeof QdInputOptionsComponent, typeof QdMultiInputChipComponent, typeof QdMultiInputMenuComponent, typeof QdMultiInputComponent, typeof QdPinCodeComponent, typeof QdRadioButtonsComponent, typeof QdSwitchComponent, typeof QdSwitchesComponent, typeof QdTextareaComponent, typeof QdFormInputComponent, typeof QdRichtextComponent, typeof QdFileUploadComponent], [typeof i2.CommonModule, typeof i30.FormsModule, typeof i30.ReactiveFormsModule, typeof i9.TranslateModule, typeof QdAutofocusModule, typeof QdChipModule, typeof QdCoreModule, typeof QdIconModule, typeof QdPopoverModule, typeof QdTooltipModule, typeof i38.NgxEditorModule], [typeof QdCheckboxChipsComponent, typeof QdCheckboxComponent, typeof QdCheckboxesComponent, typeof QdDatepickerComponent, typeof QdDropdownComponent, typeof QdFilterFormItemsComponent, typeof QdInputComponent, typeof QdMultiInputComponent, typeof QdPinCodeComponent, typeof QdRadioButtonsComponent, typeof QdSwitchComponent, typeof QdSwitchesComponent, typeof QdTextareaComponent, typeof QdRichtextComponent, typeof QdFileUploadComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<QdFormModule>;
 }
 
@@ -12084,7 +12089,6 @@ declare class QdFilterItemSelectCategoryComponent implements OnInit {
     dependsOn: string[];
     showSelectButton$: Observable<boolean>;
     itemsLoading$: Observable<boolean>;
-    positionStrategy: ConnectedPosition[];
     maxFlyoutHeight: number;
     private _destroyRef;
     private frozenSelectedKeys;
@@ -12157,7 +12161,7 @@ declare class QdFilterItemSingleSelectComponent implements OnInit, OnDestroy {
 
 declare class QdFilterModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<QdFilterModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<QdFilterModule, [typeof LocaleDatePipe, typeof QdFilterComponent, typeof QdFilterCategoryComponent, typeof QdFilterCategoryBooleanComponent, typeof QdFilterItemBooleanComponent, typeof QdFilterItemDateCategoryComponent, typeof QdFilterItemDateComponent, typeof QdFilterItemDateRangeCategoryComponent, typeof QdFilterItemDateRangeComponent, typeof QdFilterItemFreeTextCategoryComponent, typeof QdFilterItemFreeTextComponent, typeof QdFilterItemSelectCategoryComponent, typeof QdFilterItemMultiSelectComponent, typeof QdFilterItemSingleSelectComponent], [typeof i2.CommonModule, typeof i31.FormsModule, typeof i9.TranslateModule, typeof QdButtonModule, typeof QdChipModule, typeof QdCoreModule, typeof QdFormModule, typeof QdIconModule, typeof QdPopoverModule, typeof QdTooltipModule, typeof i25.StoreFeatureModule], [typeof QdFilterComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<QdFilterModule, [typeof LocaleDatePipe, typeof QdFilterComponent, typeof QdFilterCategoryComponent, typeof QdFilterCategoryBooleanComponent, typeof QdFilterItemBooleanComponent, typeof QdFilterItemDateCategoryComponent, typeof QdFilterItemDateComponent, typeof QdFilterItemDateRangeCategoryComponent, typeof QdFilterItemDateRangeComponent, typeof QdFilterItemFreeTextCategoryComponent, typeof QdFilterItemFreeTextComponent, typeof QdFilterItemSelectCategoryComponent, typeof QdFilterItemMultiSelectComponent, typeof QdFilterItemSingleSelectComponent], [typeof i2.CommonModule, typeof i30.FormsModule, typeof i9.TranslateModule, typeof QdButtonModule, typeof QdChipModule, typeof QdCoreModule, typeof QdFormModule, typeof QdIconModule, typeof QdPopoverModule, typeof QdTooltipModule, typeof i25.StoreFeatureModule], [typeof QdFilterComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<QdFilterModule>;
 }
 
@@ -14308,6 +14312,7 @@ declare class QdPageComponent<T extends object> implements OnInit, OnChanges, Af
     private bottomOffset$;
     private readonly dialogRef;
     private readonly navigationInterceptor;
+    private readonly injector;
     private readonly confirmationDialogService;
     /**
      * This property defines the configuration for the QdPage component, including the page type,
@@ -14396,6 +14401,10 @@ declare class QdPageComponent<T extends object> implements OnInit, OnChanges, Af
  * - Snapshots store only raw values and are taken by the page/header workflow (e.g. on init, edit, save). The confirmation dialog may restore all registered form groups from the snapshot.
  * - FormArrays are restored with dynamic resizing (length is aligned to snapshot before values are reset).
  *
+ * ### **Filling a form right after connecting it**
+ * - You can fill a connected form right after registration — e.g. an `effect` that adds controls or pushes `FormArray` rows. This first fill is the form's starting point, not a user change.
+ * - So loading data into a fresh form never triggers a false "unsaved changes" prompt. Only later edits count.
+ *
  * ### **Page-Dialog (FullWidth) – Unsaved-Changes Close Contract**
  * - When a QdPage is embedded in a full-width page dialog, the directive’s registered form groups are also used to guard dialog closing.
  * - The page dialog can only close (e.g. via ESC or backdrop) if no unsaved changes are detected ($hasValuesChanged() is false).
@@ -14408,8 +14417,10 @@ declare class QdPageComponent<T extends object> implements OnInit, OnChanges, Af
  * ```html
  * <qd-page [config]="pageConfig">
  *   <qd-section [config]="sectionConfig">
- *     <qd-grid [formGroup]="myFormGroup" qdConnectFormStateToPage="myFormGroup">
- *       My Section
+ *     <qd-grid
+ *        qdConnectFormStateToPage="myFormGroup"
+ *        [formGroup]="myFormGroup">
+ *          My Section
  *     </qd-grid>
  *   </qd-section>
  * </qd-page>
@@ -14429,13 +14440,14 @@ declare class QdPageComponent<T extends object> implements OnInit, OnChanges, Af
 declare class QdConnectFormStateToPageDirective implements OnInit, OnDestroy {
     private formGroupManagerService;
     private formGroupDirective;
+    private closeInitialBuildupHandle?;
     /**
      * This key is used to manage and track the form state within the page. It has to be unique for each FormGroup Connector. Use the property name of the FormGroup in your component.
      */
     qdConnectFormStateToPage: string;
     ngOnInit(): void;
     ngOnDestroy(): void;
-    isValid(): boolean;
+    private scheduleInitialBaseline;
     static ɵfac: i0.ɵɵFactoryDeclaration<QdConnectFormStateToPageDirective, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<QdConnectFormStateToPageDirective, "[qdConnectFormStateToPage]", never, { "qdConnectFormStateToPage": { "alias": "qdConnectFormStateToPage"; "required": false; }; }, {}, never, never, false, never>;
 }
@@ -14509,6 +14521,7 @@ declare class QdPageObjectHeaderComponent<T extends object> implements OnInit, O
     private confirmationDialogService;
     private contextService;
     private resolverTriggerService;
+    private readonly injector;
     private pageStoreService;
     config: QdPageConfig<T>;
     hasNavigation: boolean;
@@ -18193,7 +18206,7 @@ declare class QdStriphtmlPipe implements PipeTransform {
 
 declare class QdCommentsModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<QdCommentsModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<QdCommentsModule, [typeof QdCommentsComponent, typeof QdCommentMenuComponent, typeof AddCommentDialogComponent, typeof QdStriphtmlPipe], [typeof i2.CommonModule, typeof i9.TranslateModule, typeof QdPopoverModule, typeof QdIconModule, typeof QdButtonModule, typeof QdFormModule, typeof QdDialogModule, typeof i31.FormsModule, typeof i31.ReactiveFormsModule, typeof QdCoreModule], [typeof QdCommentsComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<QdCommentsModule, [typeof QdCommentsComponent, typeof QdCommentMenuComponent, typeof AddCommentDialogComponent, typeof QdStriphtmlPipe], [typeof i2.CommonModule, typeof i9.TranslateModule, typeof QdPopoverModule, typeof QdIconModule, typeof QdButtonModule, typeof QdFormModule, typeof QdDialogModule, typeof i30.FormsModule, typeof i30.ReactiveFormsModule, typeof QdCoreModule], [typeof QdCommentsComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<QdCommentsModule>;
 }
 
@@ -18750,7 +18763,7 @@ declare class QdFocusableModule {
 
 declare class QdQuickEditModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<QdQuickEditModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<QdQuickEditModule, [typeof QdQuickEditComponent, typeof QdCustomForDirective], [typeof QdCoreModule, typeof QdButtonModule, typeof i2.CommonModule, typeof QdFormModule, typeof i31.ReactiveFormsModule, typeof QdIconModule, typeof QdPopoverModule, typeof i9.TranslateModule, typeof QdPageModule, typeof QdFocusableModule, typeof QdTooltipModule], [typeof QdQuickEditComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<QdQuickEditModule, [typeof QdQuickEditComponent, typeof QdCustomForDirective], [typeof QdCoreModule, typeof QdButtonModule, typeof i2.CommonModule, typeof QdFormModule, typeof i30.ReactiveFormsModule, typeof QdIconModule, typeof QdPopoverModule, typeof i9.TranslateModule, typeof QdPageModule, typeof QdFocusableModule, typeof QdTooltipModule], [typeof QdQuickEditComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<QdQuickEditModule>;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quadrel-enterprise-ui/framework",
-  "version": "20.27.1",
+  "version": "20.27.3-beta.234.1",
   "exports": {
     "./jest-preset": "./jest-preset.js",
     "./package.json": {