@quadrel-enterprise-ui/framework 20.26.0 → 20.26.1

package/fesm2022/quadrel-enterprise-ui-framework.mjs

@@ -8411,10 +8411,25 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.18", ngImpo
                 }]
         }] });
 
+/**
+ * Focuses its host element once, after the initial view init, when `qdAutofocus` is `true`.
+ *
+ * Init-only by design: the input is read in `ngAfterViewInit` only. A later `false -> true`
+ * change on an already-rendered element is intentionally ignored to avoid stealing focus
+ * mid-interaction (this mirrors the native `autofocus` attribute). An element that appears
+ * later (e.g. via `*ngIf`) still autofocuses, because `ngAfterViewInit` runs when it is created.
+ *
+ * Coordinated app-wide through {@link QdAutofocusService}: only one element may autofocus per
+ * view; the guard is released once the focused element blurs, so a newly opened view can
+ * autofocus again. Using it on more than one active element at a time logs a warning and is
+ * ignored for the surplus elements.
+ */
 class QdAutofocusDirective {
     autofocusService = inject(QdAutofocusService);
     elementRef = inject(ElementRef);
     qdAutofocus = false;
+    _timeoutId;
+    _blurHandler;
     ngAfterViewInit() {
         if (!this.qdAutofocus)
             return;
@@ -8423,14 +8438,22 @@ class QdAutofocusDirective {
             return;
         }
         this.autofocusService.isAutofocusActivated = true;
-        setTimeout(() => {
-            this.elementRef.nativeElement.focus();
-            this.elementRef.nativeElement.addEventListener('blur', () => {
+        this._timeoutId = setTimeout(() => {
+            const element = this.elementRef.nativeElement;
+            if (!element.isConnected) {
                 this.autofocusService.isAutofocusActivated = false;
-            });
+                return;
+            }
+            element.focus();
+            this._blurHandler = () => void (this.autofocusService.isAutofocusActivated = false);
+            element.addEventListener('blur', this._blurHandler, { once: true });
         }, 0);
     }
     ngOnDestroy() {
+        if (this._timeoutId)
+            clearTimeout(this._timeoutId);
+        if (this._blurHandler)
+            this.elementRef.nativeElement.removeEventListener('blur', this._blurHandler);
         this.autofocusService.isAutofocusActivated = false;
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.18", ngImport: i0, type: QdAutofocusDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });