@praxisui/dynamic-fields 9.0.0-beta.46 → 9.0.0-beta.48

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-07-08T00:30:08.464Z",
+  "generatedAt": "2026-07-08T13:50:56.661Z",
   "packageName": "@praxisui/dynamic-fields",
-  "packageVersion": "9.0.0-beta.46",
+  "packageVersion": "9.0.0-beta.48",
   "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
@@ -3518,6 +3539,16 @@ class SimpleBaseSelectComponent extends SimpleBaseInputComponent {
                 this.scheduleRemoteOptionsLoad(remoteLoadSignature, () => this.loadOptions());
             }
         }
+        else {
+            this.clearRemoteOptionSourceState(metadata.filterCriteria ?? {});
+        }
+    }
+    clearRemoteOptionSourceState(filterCriteria = {}) {
+        this.resourcePath.set(null);
+        this.filterCriteria.set(filterCriteria);
+        this.loading.set(false);
+        this.error.set(null);
+        this.hasLoadedOnce = false;
     }
     scheduleRemoteOptionsLoad(signature, load) {
         if (signature === this.remoteOptionsLoadSignature &&
@@ -4263,13 +4294,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 +4373,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 +12473,9 @@ class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
                 this.lastConfiguredPath = path;
             }
         }
+        else {
+            this.clearRemoteConfiguration(metadata.filterCriteria ?? {});
+        }
     }
     errorStateMatcher() {
         return getErrorStateMatcherForField(this.metadata());
@@ -12464,6 +12489,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 +12502,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 +12521,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 +12553,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 +12691,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 +12807,8 @@ class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
         this.refocusSearchInput();
     }
     retry() {
+        if (!this.hasRemoteOptionsContract())
+            return;
         this.runQuery(true).subscribe();
     }
     handleKey(event) {
@@ -12804,7 +12839,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 +12865,7 @@ class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
             catch { }
             this.remoteSelectionHydrationSub = null;
         }
-        if (!this.resourcePath()) {
+        if (!this.hasRemoteOptionsContract()) {
             return;
         }
         const control = this.control();
@@ -12843,7 +12878,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 +12892,7 @@ class MaterialAsyncSelectComponent extends SimpleBaseSelectComponent {
         }
     }
     ensureCurrentValueLoadedByIds() {
-        if (!this.resourcePath() || this.loading()) {
+        if (!this.hasRemoteOptionsContract() || this.loading()) {
             return;
         }
         const selected = this.getSelectedIds();
@@ -12899,6 +12934,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 +14262,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 +14293,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 +16811,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.46",
+  "version": "9.0.0-beta.48",
   "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.46",
-    "@praxisui/cron-builder": "^9.0.0-beta.46"
+    "@praxisui/core": "^9.0.0-beta.48",
+    "@praxisui/cron-builder": "^9.0.0-beta.48"
   },
   "dependencies": {
     "libphonenumber-js": "^1.12.41",

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

@@ -1136,6 +1136,7 @@ declare abstract class SimpleBaseSelectComponent<T = any> extends SimpleBaseInpu
      * Applies typed metadata to the select component.
      */
     setSelectMetadata(metadata: SimpleSelectMetadata<T>): void;
+    protected clearRemoteOptionSourceState(filterCriteria?: Record<string, any>): void;
     private scheduleRemoteOptionsLoad;
     protected setMetadata(metadata: ComponentMetadata): void;
     protected registerMatSelect(select: MatSelect): void;
@@ -2756,6 +2757,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 +3055,7 @@ declare class InlineEntityLookupComponent extends MaterialAsyncSelectComponent {
     inlineTooltipText(): string;
     private resolveLookupText;
     private lookupViewFromValue;
+    private findKnownLookupOption;
     private resolveLookupData;
     private buildLookupPrimaryText;
     private fallbackLookupText;