@praxisui/dynamic-fields 9.0.0-beta.45 → 9.0.0-beta.47

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-07-07T23:17:36.844Z",
+  "generatedAt": "2026-07-08T03:07:40.937Z",
   "packageName": "@praxisui/dynamic-fields",
-  "packageVersion": "9.0.0-beta.45",
+  "packageVersion": "9.0.0-beta.47",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 76,

package/fesm2022/praxisui-dynamic-fields.mjs

@@ -3350,6 +3350,27 @@ function computeEffectiveState(metadata, overrides = {}) {
     return { readonly, disabled, presentation, visible };
 }
 
+function isSelectDebugEnabled() {
+    try {
+        if (globalThis.__PRAXIS_DEBUG_FIELDS__) {
+            return true;
+        }
+        if (typeof localStorage !== 'undefined') {
+            return localStorage.getItem('praxis.debug.fields') === 'true';
+        }
+    }
+    catch { }
+    return false;
+}
+function debugSelect(message, data) {
+    if (!isSelectDebugEnabled()) {
+        return;
+    }
+    try {
+        console.debug(message, data);
+    }
+    catch { }
+}
 /**
  * Base directive providing common select behaviour. Extends
  * `SimpleBaseInputComponent` and manages option handling, multiple
@@ -4263,13 +4284,10 @@ class SimpleBaseSelectComponent extends SimpleBaseInputComponent {
         }));
         const missing = controls.filter((c) => !c.control).map((c) => c.name);
         if (missing.length) {
-            try {
-                console.warn('[Select] dependency controls not found', {
-                    field: meta?.name,
-                    missing,
-                });
-            }
-            catch { }
+            debugSelect('[Select] dependency controls not found', {
+                field: meta?.name,
+                missing,
+            });
             // Continue with those available
         }
         const streams = controls
@@ -4345,19 +4363,13 @@ class SimpleBaseSelectComponent extends SimpleBaseInputComponent {
                     break;
             }
             // Dev log
-            try {
-                const isDev = typeof globalThis.ngDevMode !== 'undefined' ? !!globalThis.ngDevMode : false;
-                if (isDev || globalThis.__PRAXIS_DEBUG_FIELDS__) {
-                    console.debug('[Select] dependencies changed', {
-                        field: meta?.name,
-                        deps,
-                        fragment,
-                        mergeStrategy,
-                        reloaded: loadOnChange === 'immediate' || (loadOnChange === 'respectLoadOn' && this.hasLoadedOnce),
-                    });
-                }
-            }
-            catch { }
+            debugSelect('[Select] dependencies changed', {
+                field: meta?.name,
+                deps,
+                fragment,
+                mergeStrategy,
+                reloaded: loadOnChange === 'immediate' || (loadOnChange === 'respectLoadOn' && this.hasLoadedOnce),
+            });
         });
     }
     extractDependencyValue(raw, path) {
@@ -12451,6 +12463,9 @@ class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
                 this.lastConfiguredPath = path;
             }
         }
+        else {
+            this.clearRemoteConfiguration(metadata.filterCriteria ?? {});
+        }
     }
     errorStateMatcher() {
         return getErrorStateMatcherForField(this.metadata());
@@ -12464,6 +12479,9 @@ class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
         this.preloadSelected();
         this.termControl.valueChanges
             .pipe(debounceTime(300), distinctUntilChanged(), switchMap(() => {
+            if (!this.hasRemoteOptionsContract()) {
+                return of(void 0);
+            }
             this.pageIndex.set(0);
             this.cursorAfter = null;
             this.cursorPageIndex = 0;
@@ -12474,7 +12492,9 @@ class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
             .subscribe();
         // Perform initial load on init if configured so, otherwise load on first open
         queueMicrotask(() => {
-            if (this.initialLoadStrategy === 'init' && this.options().length === 0) {
+            if (this.hasRemoteOptionsContract() &&
+                this.initialLoadStrategy === 'init' &&
+                this.options().length === 0) {
                 this.pageIndex.set(0);
                 this.cursorAfter = null;
                 this.cursorPageIndex = 0;
@@ -12491,7 +12511,8 @@ class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
     }
     onOpened(opened) {
         if (opened) {
-            const shouldLoadOnOpen = this.initialLoadStrategy !== 'none' &&
+            const shouldLoadOnOpen = this.hasRemoteOptionsContract() &&
+                this.initialLoadStrategy !== 'none' &&
                 this.options().length === 0 &&
                 !this.loading();
             if (shouldLoadOnOpen) {
@@ -12522,6 +12543,8 @@ class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
         return (typeof val === 'string' || typeof val === 'number') ? [val] : [];
     }
     preloadSelected(ids = this.getSelectedIds()) {
+        if (!this.hasRemoteOptionsContract())
+            return;
         if (!this.crudService)
             return;
         if (!ids.length)
@@ -12658,7 +12681,7 @@ class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
         });
     }
     runQuery(reset) {
-        if (!this.crudService || !this.resourcePath()) {
+        if (!this.crudService || !this.hasRemoteOptionsContract()) {
             return of(void 0);
         }
         const term = this.termControl.value || '';
@@ -12774,6 +12797,8 @@ class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
         this.refocusSearchInput();
     }
     retry() {
+        if (!this.hasRemoteOptionsContract())
+            return;
         this.runQuery(true).subscribe();
     }
     handleKey(event) {
@@ -12804,7 +12829,7 @@ class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
     // Phase 1: explicit reload API and dependency handling
     // ---------------------------------------------------------------------------
     reload(reset) {
-        if (!this.crudService || !this.resourcePath())
+        if (!this.crudService || !this.hasRemoteOptionsContract())
             return;
         if (reset) {
             this.pageIndex.set(0);
@@ -12830,7 +12855,7 @@ class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
             catch { }
             this.remoteSelectionHydrationSub = null;
         }
-        if (!this.resourcePath()) {
+        if (!this.hasRemoteOptionsContract()) {
             return;
         }
         const control = this.control();
@@ -12843,7 +12868,7 @@ class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
     onDependenciesChanged() {
         const meta = this.metadata();
         const mode = meta?.dependencyLoadOnChange ?? 'respectLoadOn';
-        if (!this.resourcePath())
+        if (!this.hasRemoteOptionsContract())
             return;
         if (mode === 'manual')
             return;
@@ -12857,7 +12882,7 @@ class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
         }
     }
     ensureCurrentValueLoadedByIds() {
-        if (!this.resourcePath() || this.loading()) {
+        if (!this.hasRemoteOptionsContract() || this.loading()) {
             return;
         }
         const selected = this.getSelectedIds();
@@ -12899,6 +12924,22 @@ class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
         }
         return value;
     }
+    hasRemoteOptionsContract() {
+        return !!String(this.resourcePath() || '').trim();
+    }
+    clearRemoteConfiguration(filterCriteria) {
+        this.resourcePath.set('');
+        this.filterCriteria.set(filterCriteria);
+        this.lastConfiguredPath = undefined;
+        this.remoteTotalElements.set(null);
+        this.loading.set(false);
+        this.error.set(null);
+        this.endReached.set(false);
+        this.cursorAfter = null;
+        this.cursorPageIndex = 0;
+        this.store.clearPages();
+        this.hasPerformedInitialLoad = false;
+    }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: MaterialAsyncSelectComponent, deps: null, target: i0.ɵɵFactoryTarget.Component });
     static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: MaterialAsyncSelectComponent, isStandalone: true, selector: "pdx-material-async-select", inputs: { readonlyMode: "readonlyMode", disabledMode: "disabledMode", visible: "visible", presentationMode: "presentationMode" }, host: { properties: { "class": "componentCssClasses()", "class.praxis-disabled": "isInteractionDisabled()", "style.display": "visible ? null : \"none\"", "attr.aria-hidden": "visible ? null : \"true\"", "attr.data-field-type": "\"async-select\"", "attr.data-field-name": "metadata()?.name", "attr.data-component-id": "componentId()" } }, providers: [
             GenericCrudService,
@@ -14211,13 +14252,18 @@ class InlineEntityLookupComponent extends MaterialAsyncSelectComponent {
         return super.inlineTooltipText();
     }
     resolveLookupText(value) {
-        const matchedOption = this.options().find((option) => this.equalsOptionValue(option.value, value));
+        const matchedOption = this.findKnownLookupOption(value);
+        if (matchedOption &&
+            (value === null || typeof value !== 'object') &&
+            (matchedOption.value === null || typeof matchedOption.value !== 'object')) {
+            return this.fallbackLookupText(matchedOption.label, value);
+        }
         const lookup = this.resolveLookupData(matchedOption ? matchedOption.value : value, matchedOption?.label);
         const primary = this.buildLookupPrimaryText(lookup.id, lookup.label);
         return primary || this.fallbackLookupText(matchedOption?.label, value);
     }
     lookupViewFromValue(source, fallbackLabel) {
-        const matchedOption = this.options().find((option) => this.equalsOptionValue(option.value, source));
+        const matchedOption = this.findKnownLookupOption(source);
         const value = matchedOption ? matchedOption.value : source;
         const lookup = this.resolveLookupData(value, matchedOption?.label ?? fallbackLabel);
         return {
@@ -14237,6 +14283,10 @@ class InlineEntityLookupComponent extends MaterialAsyncSelectComponent {
             richFields: lookup.richFields,
         };
     }
+    findKnownLookupOption(value) {
+        return (this.options().find((option) => this.equalsOptionValue(option.value, value)) ||
+            this.staticOptions.find((option) => this.equalsOptionValue(option.value, value)));
+    }
     resolveLookupData(source, fallbackLabel) {
         const idKeys = this.lookupIdKeys();
         const labelKeys = this.lookupLabelKeys();
@@ -16751,6 +16801,10 @@ class EntityLookupDialogComponent {
             return;
         }
         this.activeResultIndex = index;
+        const option = this.resultOptions()[index];
+        if (option) {
+            this.setPreviewFromOption(option);
+        }
         target.focus();
     }
     normalizeOptionValue(value) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-fields",
-  "version": "9.0.0-beta.45",
+  "version": "9.0.0-beta.47",
   "description": "Angular Material-based dynamic form fields for Praxis UI with lazy loading and metadata-driven rendering.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -11,8 +11,8 @@
     "@angular/platform-browser": "^21.0.0",
     "@angular/router": "^21.0.0",
     "rxjs": "^7.8.0",
-    "@praxisui/core": "^9.0.0-beta.45",
-    "@praxisui/cron-builder": "^9.0.0-beta.45"
+    "@praxisui/core": "^9.0.0-beta.47",
+    "@praxisui/cron-builder": "^9.0.0-beta.47"
   },
   "dependencies": {
     "libphonenumber-js": "^1.12.41",

package/types/praxisui-dynamic-fields.d.ts

@@ -2756,6 +2756,8 @@ declare class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
     protected resolveRemoteOptionDisabled(option: AsyncOption): boolean;
     protected areOptionValuesEqual(left: unknown, right: unknown): boolean;
     private normalizeRemoteOptionValue;
+    protected hasRemoteOptionsContract(): boolean;
+    private clearRemoteConfiguration;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MaterialAsyncSelectComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MaterialAsyncSelectComponent, "pdx-material-async-select", never, { "readonlyMode": { "alias": "readonlyMode"; "required": false; }; "disabledMode": { "alias": "disabledMode"; "required": false; }; "visible": { "alias": "visible"; "required": false; }; "presentationMode": { "alias": "presentationMode"; "required": false; }; }, {}, never, never, true, never>;
 }
@@ -3052,6 +3054,7 @@ declare class InlineEntityLookupComponent extends MaterialAsyncSelectComponent {
     inlineTooltipText(): string;
     private resolveLookupText;
     private lookupViewFromValue;
+    private findKnownLookupOption;
     private resolveLookupData;
     private buildLookupPrimaryText;
     private fallbackLookupText;