@praxisui/dynamic-form 10.0.0-rc.31 → 10.0.0-rc.33

package/fesm2022/praxisui-dynamic-form.mjs

@@ -20,10 +20,10 @@ import * as i9 from '@angular/material/snack-bar';
 import { MatSnackBarModule } from '@angular/material/snack-bar';
 import * as i19 from '@angular/material/badge';
 import { MatBadgeModule } from '@angular/material/badge';
-import { map, Subscription, merge, of, timer, NEVER, EMPTY, defer, TimeoutError, Subject, firstValueFrom, BehaviorSubject, throwError, combineLatest, Observable, race, from, debounceTime as debounceTime$1, takeUntil as takeUntil$1 } from 'rxjs';
+import { map, Subscription, merge, of, timer, NEVER, EMPTY, defer, TimeoutError, Subject, firstValueFrom, BehaviorSubject, throwError, combineLatest, Observable, race, from, debounceTime as debounceTime$1, takeUntil as takeUntil$1, defaultIfEmpty, switchMap as switchMap$1, catchError as catchError$1, take as take$1, finalize as finalize$1 } from 'rxjs';
 import { filter, map as map$1, switchMap, take, timeout, throwIfEmpty, tap, catchError, ignoreElements, finalize, takeUntil, skip, debounceTime, startWith } from 'rxjs/operators';
 import * as i1 from '@praxisui/core';
-import { serializeEntityLookupValueForPayload, PraxisI18nService, PraxisIconButtonComponent, PraxisIconDirective, providePraxisI18nConfig, RULE_PROPERTY_SCHEMA, FIELD_METADATA_CAPABILITIES, migrateFormLayoutRule, PraxisJsonLogicService, normalizeFormLayoutItems, deepMerge, createDefaultFormConfig, normalizeFormConfig as normalizeFormConfig$1, ensureIds, createEmptyRichContentDocument, formIdentityIssues, resolveHidden, resolveOrder, resolveSpan, projectGroupedCommandPartialRows, isPraxisRuntimeGlobalActionEffect, ASYNC_CONFIG_STORAGE, withFormConfigSections, createFieldLayoutItem, getFormLayoutFieldNames, LoggerService, createCorporateLoggerConfig, ConsoleLoggerSink, ResourceDiscoveryService, GlobalActionService, SCHEMA_METADATA_CLIENT_OPTIONS, ResourceQuickConnectComponent, composeHeadersWithVersion, buildApiUrl, readStrongResourceEtag, ApiEndpoint, mapFieldDefinitionsToMetadata, reconcileFormConfig, applyLocalFormCustomizations, materializeFormLayoutFromMetadata, syncWithServerMetadata, PRAXIS_LOADING_CTX, evaluateFieldAccess, normalizeControlTypeKey, normalizePraxisEffectPolicy, buildPraxisEffectDistinctKey, getFormColumnFieldNames, resolveGroupedCommandPartialRowSpans, resolveOffset, buildSchemaIdStorageKeySegment, buildSchemaId, fetchWithETag, resolveControlTypeAlias, getTextTransformer, MemoryCacheAdapter, LocalStorageCacheAdapter, SchemaMetadataClient, DEFAULT_SCHEMA_REQUEST_TIMEOUT_MS, normalizeReactiveDeterminations, CONNECTION_STORAGE, API_URL, PRAXIS_LOADING_RENDERER, FORM_HOOKS_PRESETS, EmptyStateCardComponent, isValidFormConfig, ComponentMetadataRegistry, FieldControlType, isRequiredGlobalActionPayloadMissing, GLOBAL_ACTION_CATALOG, PRAXIS_GLOBAL_ACTION_CATALOG, getGlobalActionCatalog, SURFACE_OPEN_I18N_NAMESPACE, getGlobalActionUiSchema, getRequiredGlobalActionPayloadKeys, hasMeaningfulGlobalActionPayloadValue, SurfaceOpenActionEditorComponent, SURFACE_OPEN_I18N_CONFIG, IconPickerService, validateGlobalActionRefs, normalizeFormMetadata, DynamicFormService, projectComponentAuthoringManifest } from '@praxisui/core';
+import { serializeEntityLookupValueForPayload, PraxisI18nService, PraxisIconButtonComponent, PraxisIconDirective, providePraxisI18nConfig, RULE_PROPERTY_SCHEMA, FIELD_METADATA_CAPABILITIES, migrateFormLayoutRule, PraxisJsonLogicService, normalizeFormLayoutItems, deepMerge, createDefaultFormConfig, normalizeFormConfig as normalizeFormConfig$1, ensureIds, createEmptyRichContentDocument, formIdentityIssues, resolveHidden, resolveOrder, resolveSpan, projectGroupedCommandPartialRows, isPraxisRuntimeGlobalActionEffect, ASYNC_CONFIG_STORAGE, withFormConfigSections, createFieldLayoutItem, getFormLayoutFieldNames, LoggerService, createCorporateLoggerConfig, ConsoleLoggerSink, ResourceDiscoveryService, GlobalActionService, SCHEMA_METADATA_CLIENT_OPTIONS, ResourceQuickConnectComponent, composeHeadersWithVersion, buildApiUrl, readStrongResourceEtag, ApiEndpoint, mapFieldDefinitionsToMetadata, reconcileFormConfig, applyLocalFormCustomizations, materializeFormLayoutFromMetadata, syncWithServerMetadata, PRAXIS_LOADING_CTX, evaluateFieldAccess, normalizeControlTypeKey, normalizePraxisEffectPolicy, buildPraxisEffectDistinctKey, getFormColumnFieldNames, resolveGroupedCommandPartialRowSpans, resolveOffset, buildSchemaIdStorageKeySegment, buildSchemaId, fetchWithETag, resolveControlTypeAlias, getTextTransformer, MemoryCacheAdapter, LocalStorageCacheAdapter, SchemaMetadataClient, DEFAULT_SCHEMA_REQUEST_TIMEOUT_MS, normalizeReactiveDeterminations, CONNECTION_STORAGE, API_URL, PRAXIS_LOADING_RENDERER, FORM_HOOKS_PRESETS, EmptyStateCardComponent, isValidFormConfig, ComponentMetadataRegistry, FieldControlType, isRequiredGlobalActionPayloadMissing, GLOBAL_ACTION_CATALOG, PRAXIS_GLOBAL_ACTION_CATALOG, getGlobalActionCatalog, SURFACE_OPEN_I18N_NAMESPACE, getGlobalActionUiSchema, getRequiredGlobalActionPayloadKeys, hasMeaningfulGlobalActionPayloadValue, SurfaceOpenActionEditorComponent, SURFACE_OPEN_I18N_CONFIG, IconPickerService, validateGlobalActionRefs, normalizeFormMetadata, GenericCrudService, DynamicFormService, projectComponentAuthoringManifest } from '@praxisui/core';
 import * as i1$1 from '@praxisui/dynamic-fields';
 import { getControlTypeCatalog, SelectOptionRegistry, ConfirmDialogComponent, DynamicFieldLoaderDirective } from '@praxisui/dynamic-fields';
 import { BaseAiAdapter, AgenticAuthoringTurnClientService, PraxisAssistantSessionRegistryService, PraxisAssistantTurnOrchestratorService, createPraxisAssistantViewportLayout, PraxisAiAssistantShellComponent } from '@praxisui/ai';
@@ -12363,6 +12363,9 @@ class PraxisDynamicForm {
                 component: ResourceQuickConnectComponent,
                 inputs: {
                     resourcePath: this.resourcePath,
+                    intent: 'crud',
+                    endpointKey: this.apiEndpointKey ?? undefined,
+                    apiUrlEntry: this.apiUrlEntry ?? undefined,
                 },
             },
         });
@@ -13474,6 +13477,16 @@ class PraxisDynamicForm {
                 if (this.hasRenderableConfig(hostConfig)) {
                     await this.reconcileLoadedConfigWithServerSchema(false);
                 }
+                else if (localConfig && this.hasRenderableConfig(localConfig)) {
+                    const hostTitle = hostConfig.title;
+                    this.config = normalizeFormConfig$1({
+                        ...localConfig,
+                        ...(hostTitle ? { title: hostTitle } : {}),
+                        ...(hostConfig.actions ? { actions: hostConfig.actions } : {}),
+                        ...(hostConfig.helpPresentation ? { helpPresentation: hostConfig.helpPresentation } : {}),
+                    });
+                    await this.reconcileLoadedConfigWithServerSchema();
+                }
                 else {
                     await this.createDefaultConfig();
                 }
@@ -21340,34 +21353,125 @@ class PraxisDynamicForm {
                 ? new MemoryCacheAdapter()
                 : new LocalStorageCacheAdapter({ ttlMs: 30 * 60 * 1000, maxEntries: 200 });
             const client = new SchemaMetadataClient(adapter, this.schemaTransportOptions);
-            const loadLegacySchema = async (reason) => {
+            let discoveryAttempted = false;
+            const loadDiscoverySchema = async (reason) => {
+                discoveryAttempted = true;
                 if (this.isDestroyed)
                     throw new PraxisDynamicFormDestroyedError();
-                try {
-                    this.warnLog('[PDF] schema:metadata-fallback', reason);
-                }
-                catch { }
-                const legacyGetSchema = this.crud?.getSchema;
-                if (typeof legacyGetSchema !== 'function') {
+                const rp = String(this.resourcePath || '').trim();
+                const discoveryOptions = {
+                    ...(this.apiEndpointKey ? { endpointKey: this.apiEndpointKey } : {}),
+                    ...(this.apiUrlEntry ? { apiUrlEntry: this.apiUrlEntry } : {}),
+                };
+                const canLoadViaDiscovery = !!rp &&
+                    typeof this.resourceDiscovery?.getResourceSchemaFields === 'function' &&
+                    (typeof this.resourceDiscovery.canResolveSchemas !== 'function' ||
+                        this.resourceDiscovery.canResolveSchemas(discoveryOptions));
+                if (!canLoadViaDiscovery) {
                     throw reason instanceof Error
                         ? reason
                         : new Error('Schema metadata unavailable and legacy crud.getSchema() not found.');
                 }
-                const legacyResult = legacyGetSchema.call(this.crud);
+                const inferredFilter = /(^|[-_])filter($|[-_])/i.test(this.formId || '');
+                const useFilterSchema = this.schemaSource === 'filter' || inferredFilter;
+                const hasDedicatedOptions = !!(discoveryOptions.endpointKey || discoveryOptions.apiUrlEntry);
+                const discoveryCall$ = useFilterSchema && typeof this.resourceDiscovery.getResourceFilterSchemaFields === 'function'
+                    ? (hasDedicatedOptions
+                        ? this.resourceDiscovery.getResourceFilterSchemaFields(rp, discoveryOptions)
+                        : this.resourceDiscovery.getResourceFilterSchemaFields(rp))
+                    : (hasDedicatedOptions
+                        ? this.resourceDiscovery.getResourceSchemaFields(rp, discoveryOptions)
+                        : this.resourceDiscovery.getResourceSchemaFields(rp));
                 controller.signal.throwIfAborted();
                 const cancelled$ = new Observable(subscriber => {
                     const abort = () => subscriber.error(controller.signal.reason ?? new DOMException('Schema read cancelled.', 'AbortError'));
                     controller.signal.addEventListener('abort', abort, { once: true });
                     return () => controller.signal.removeEventListener('abort', abort);
                 });
-                let legacyRead$ = race(from(legacyResult), cancelled$).pipe(take(1));
+                let discoveryRead$ = race(from(discoveryCall$), cancelled$).pipe(take(1));
                 const timeoutMs = this.schemaTransportOptions.requestTimeoutMs ?? DEFAULT_SCHEMA_REQUEST_TIMEOUT_MS;
                 if (timeoutMs > 0)
-                    legacyRead$ = legacyRead$.pipe(timeout(timeoutMs));
-                const legacyDefs = await firstValueFrom(legacyRead$);
+                    discoveryRead$ = discoveryRead$.pipe(timeout(timeoutMs));
+                const discoveryDefs = await firstValueFrom(discoveryRead$);
+                controller.signal.throwIfAborted();
+                if (this.isDestroyed)
+                    throw new PraxisDynamicFormDestroyedError();
+                if (!Array.isArray(discoveryDefs) || discoveryDefs.length === 0) {
+                    throw reason instanceof Error
+                        ? reason
+                        : new Error('Schema metadata unavailable via ResourceDiscoveryService.');
+                }
+                try {
+                    const schemaId = buildSchemaId(schemaContext);
+                    this.lastSchemaMeta = { schemaId, context: schemaContext };
+                }
+                catch { }
+                this.schemaCache = discoveryDefs;
+                this.emitLoadingState('schema', 'success', 'Schema carregado.');
+                return discoveryDefs;
+            };
+            const loadLegacySchema = async (reason) => {
+                if (this.isDestroyed)
+                    throw new PraxisDynamicFormDestroyedError();
+                try {
+                    this.warnLog('[PDF] schema:metadata-fallback', reason);
+                }
+                catch { }
+                const legacyGetSchema = this.crud?.getSchema;
+                if (typeof legacyGetSchema !== 'function') {
+                    if (discoveryAttempted) {
+                        throw reason instanceof Error
+                            ? reason
+                            : new Error('Schema metadata unavailable and legacy crud.getSchema() not found.');
+                    }
+                    return await loadDiscoverySchema(reason);
+                }
+                const isMockedLegacy = !!legacyGetSchema?.and;
+                let legacyDefs;
+                try {
+                    const legacyResult = legacyGetSchema.call(this.crud);
+                    controller.signal.throwIfAborted();
+                    const cancelled$ = new Observable(subscriber => {
+                        const abort = () => subscriber.error(controller.signal.reason ?? new DOMException('Schema read cancelled.', 'AbortError'));
+                        controller.signal.addEventListener('abort', abort, { once: true });
+                        return () => controller.signal.removeEventListener('abort', abort);
+                    });
+                    let legacyRead$ = race(from(legacyResult), cancelled$).pipe(take(1));
+                    const timeoutMs = this.schemaTransportOptions.requestTimeoutMs ?? DEFAULT_SCHEMA_REQUEST_TIMEOUT_MS;
+                    if (timeoutMs > 0)
+                        legacyRead$ = legacyRead$.pipe(timeout(timeoutMs));
+                    legacyDefs = await firstValueFrom(legacyRead$);
+                }
+                catch (legacyError) {
+                    if (this.isDestroyed || legacyError instanceof PraxisDynamicFormDestroyedError) {
+                        throw new PraxisDynamicFormDestroyedError();
+                    }
+                    if (this.isSchemaTransportInterruption(legacyError) ||
+                        controller.signal.aborted ||
+                        isMockedLegacy ||
+                        discoveryAttempted) {
+                        throw legacyError;
+                    }
+                    return await loadDiscoverySchema(legacyError);
+                }
                 controller.signal.throwIfAborted();
                 if (this.isDestroyed)
                     throw new PraxisDynamicFormDestroyedError();
+                if (!isMockedLegacy &&
+                    !discoveryAttempted &&
+                    (!Array.isArray(legacyDefs) || legacyDefs.length === 0)) {
+                    try {
+                        return await loadDiscoverySchema(reason);
+                    }
+                    catch (discoveryError) {
+                        if (this.isDestroyed || discoveryError instanceof PraxisDynamicFormDestroyedError) {
+                            throw new PraxisDynamicFormDestroyedError();
+                        }
+                        if (this.isSchemaTransportInterruption(discoveryError) || controller.signal.aborted) {
+                            throw discoveryError;
+                        }
+                    }
+                }
                 try {
                     const schemaId = buildSchemaId(schemaContext);
                     this.lastSchemaMeta = { schemaId, context: schemaContext };
@@ -21384,6 +21488,14 @@ class PraxisDynamicForm {
                 if (preferLegacySchema) {
                     return await loadLegacySchema(new Error('Using legacy schema source (mocked crud.getSchema).'));
                 }
+                const rp = String(this.resourcePath || '').trim();
+                const isCatalogResourceKey = !!rp &&
+                    !String(this.schemaUrl || '').trim() &&
+                    !rp.includes('/') &&
+                    rp.includes('.');
+                if (isCatalogResourceKey) {
+                    return await loadDiscoverySchema(new Error(`Resolving catalog resourceKey "${rp}" via ResourceDiscoveryService.`));
+                }
                 if (!ctx.baseUrl) {
                     return await loadLegacySchema(new Error('Missing schema metadata base URL.'));
                 }
@@ -33487,6 +33599,14 @@ class PraxisFilterForm {
     config;
     formId;
     resourcePath;
+    /**
+     * Optional logical endpoint key for multi-gateway filter schema resolution.
+     */
+    endpointKey;
+    /**
+     * Optional explicit API URL entry override for filter schema resolution.
+     */
+    apiUrlEntry;
     mode;
     formReady = new EventEmitter();
     valueChange = new EventEmitter();
@@ -33497,26 +33617,153 @@ class PraxisFilterForm {
     form = new FormGroup({});
     valueChangesSub;
     statusChangesSub;
+    schemaSub;
+    hydratedFieldMetadata = [];
+    lastHydratedResourceKey = '';
     columnFieldsCache = new WeakMap();
     singleFieldCache = new WeakMap();
+    crudService = (() => {
+        try {
+            return inject(GenericCrudService, { optional: true });
+        }
+        catch {
+            return null;
+        }
+    })();
+    resourceDiscovery = (() => {
+        try {
+            return inject(ResourceDiscoveryService, { optional: true });
+        }
+        catch {
+            return null;
+        }
+    })();
+    cdr = (() => {
+        try {
+            return inject(ChangeDetectorRef, { optional: true });
+        }
+        catch {
+            return null;
+        }
+    })();
     constructor(dynamicForm) {
         this.dynamicForm = dynamicForm;
     }
     ngOnChanges(changes) {
+        const hasConfiguredFields = Array.isArray(this.config?.fieldMetadata) && this.config.fieldMetadata.length > 0;
+        if (hasConfiguredFields) {
+            this.schemaSub?.unsubscribe();
+            this.hydratedFieldMetadata = [];
+            this.lastHydratedResourceKey = '';
+        }
         if ('config' in changes && this.config?.fieldMetadata) {
             this.buildForm();
         }
+        if (!hasConfiguredFields &&
+            ('config' in changes ||
+                'resourcePath' in changes ||
+                'endpointKey' in changes ||
+                'apiUrlEntry' in changes)) {
+            this.loadFilterSchemaFieldsIfNeeded();
+        }
     }
     ngOnDestroy() {
+        this.schemaSub?.unsubscribe();
         this.valueChangesSub?.unsubscribe();
         this.statusChangesSub?.unsubscribe();
     }
+    loadFilterSchemaFieldsIfNeeded() {
+        const rp = String(this.resourcePath ||
+            (this.config?.resourcePath ?? '')).trim();
+        if (!rp) {
+            this.schemaSub?.unsubscribe();
+            if (this.hydratedFieldMetadata.length > 0) {
+                this.hydratedFieldMetadata = [];
+                this.lastHydratedResourceKey = '';
+                this.buildForm();
+            }
+            return;
+        }
+        const discoveryOptions = this.endpointKey || this.apiUrlEntry
+            ? {
+                ...(this.endpointKey ? { endpointKey: this.endpointKey } : {}),
+                ...(this.apiUrlEntry ? { apiUrlEntry: this.apiUrlEntry } : {}),
+            }
+            : undefined;
+        const hydrationKey = JSON.stringify({
+            rp,
+            endpointKey: this.endpointKey ?? null,
+            apiUrlEntry: this.apiUrlEntry ?? null,
+        });
+        if (this.lastHydratedResourceKey === hydrationKey && this.hydratedFieldMetadata.length > 0) {
+            return;
+        }
+        const canLoadViaDiscovery = typeof this.resourceDiscovery?.getResourceFilterSchemaFields === 'function' &&
+            (typeof this.resourceDiscovery.canResolveSchemas !== 'function' ||
+                this.resourceDiscovery.canResolveSchemas(discoveryOptions));
+        const canLoadViaCrud = typeof this.crudService?.getFilterSchema === 'function' ||
+            typeof this.crudService?.getSchema === 'function';
+        if (!canLoadViaCrud && !canLoadViaDiscovery) {
+            return;
+        }
+        const loadFromDiscovery = () => discoveryOptions
+            ? this.resourceDiscovery.getResourceFilterSchemaFields(rp, discoveryOptions)
+            : this.resourceDiscovery.getResourceFilterSchemaFields(rp);
+        const loadFromCrud = () => {
+            if (!canLoadViaCrud || !this.crudService) {
+                return of([]);
+            }
+            if (discoveryOptions) {
+                this.crudService.configure?.(rp, discoveryOptions);
+            }
+            else {
+                this.crudService.configure?.(rp);
+            }
+            return typeof this.crudService.getFilterSchema === 'function'
+                ? this.crudService.getFilterSchema()
+                : this.crudService.getSchema();
+        };
+        const isCatalogResourceKey = !rp.includes('/') && rp.includes('.');
+        let source$;
+        if (isCatalogResourceKey && canLoadViaDiscovery) {
+            source$ = loadFromDiscovery().pipe(defaultIfEmpty([]), switchMap$1((defs) => Array.isArray(defs) && defs.length === 0 && canLoadViaCrud
+                ? loadFromCrud()
+                : of(defs)), catchError$1(() => (canLoadViaCrud ? loadFromCrud() : of([]))));
+        }
+        else if (canLoadViaCrud) {
+            source$ = loadFromCrud().pipe(defaultIfEmpty([]), switchMap$1((defs) => Array.isArray(defs) && defs.length === 0 && canLoadViaDiscovery
+                ? loadFromDiscovery()
+                : of(defs)), catchError$1(() => (canLoadViaDiscovery ? loadFromDiscovery() : of([]))));
+        }
+        else {
+            source$ = loadFromDiscovery();
+        }
+        this.schemaSub?.unsubscribe();
+        this.schemaSub = source$
+            .pipe(take$1(1), catchError$1(() => of([])))
+            .subscribe((defs) => {
+            if (!Array.isArray(defs) || defs.length === 0) {
+                return;
+            }
+            if (Array.isArray(this.config?.fieldMetadata) && this.config.fieldMetadata.length > 0) {
+                return;
+            }
+            const metadata = mapFieldDefinitionsToMetadata(defs);
+            if (!metadata.length) {
+                return;
+            }
+            this.hydratedFieldMetadata = metadata;
+            this.lastHydratedResourceKey = hydrationKey;
+            this.buildForm();
+            this.cdr?.markForCheck();
+        });
+    }
     buildForm() {
         this.valueChangesSub?.unsubscribe();
         this.statusChangesSub?.unsubscribe();
         this.columnFieldsCache = new WeakMap();
         this.singleFieldCache = new WeakMap();
-        const fields = this.config.fieldMetadata || [];
+        const fields = this.fieldMetadata;
         const previous = this.form.getRawValue?.() || {};
         this.form = this.dynamicForm.createFormGroupFromMetadata(fields);
         // Preserve previous values only for fields that did not declare a new explicit seed.
@@ -33576,7 +33823,9 @@ class PraxisFilterForm {
         return className || null;
     }
     get fieldMetadata() {
-        return this.config?.fieldMetadata || [];
+        return this.config?.fieldMetadata?.length
+            ? this.config.fieldMetadata
+            : this.hydratedFieldMetadata;
     }
     get hasLayout() {
         return (Array.isArray(this.config?.sections) && this.config.sections.length > 0);
@@ -33592,7 +33841,7 @@ class PraxisFilterForm {
         return `col-${i}-${col.fields.join(',')}`;
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: PraxisFilterForm, deps: [{ token: i1.DynamicFormService }], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: PraxisFilterForm, isStandalone: true, selector: "praxis-filter-form", inputs: { config: "config", formId: "formId", resourcePath: "resourcePath", mode: "mode" }, outputs: { formReady: "formReady", valueChange: "valueChange", submit: "submit", requestSearch: "requestSearch", validityChange: "validityChange" }, usesOnChanges: true, ngImport: i0, template: "<form\n  [formGroup]=\"form\"\n  class=\"praxis-filter-form\"\n  (change)=\"$event.stopPropagation()\"\n  (ngSubmit)=\"onFormSubmit(); $event.preventDefault(); $event.stopPropagation()\"\n>\n  @if (hasLayout) { @for (section of (config.sections || []); track section?.id ??\n  $index) {\n  <div class=\"filter-section\">\n    @if (section.title) {\n    <h3>{{ section.title }}</h3>\n    } @for (row of section.rows; track $index) {\n    <div class=\"filter-row\">\n      @for ( column of row.columns; track (column?.fields?.join(',') ?? $index)\n      ) {\n      <div class=\"filter-column\" [ngClass]=\"getColumnClasses(column)\">\n        <ng-container\n          dynamicFieldLoader\n          [fields]=\"getColumnFields(column)\"\n          [formGroup]=\"form\"\n          [enableExternalControlBinding]=\"true\"\n        ></ng-container>\n      </div>\n      }\n    </div>\n    }\n  </div>\n  } } @else {\n  <div class=\"filter-row\">\n    @for (field of fieldMetadata; track field?.name ?? $index) {\n    <div class=\"filter-column\">\n      <ng-container\n        dynamicFieldLoader\n        [fields]=\"getSingleField(field)\"\n        [formGroup]=\"form\"\n        [enableExternalControlBinding]=\"true\"\n      ></ng-container>\n    </div>\n    }\n  </div>\n  }\n  <!-- Bot\u00E3o de submit invis\u00EDvel para garantir submit ao pressionar Enter -->\n  <button\n    type=\"submit\"\n    class=\"hidden-submit\"\n    aria-hidden=\"true\"\n    tabindex=\"-1\"\n  ></button>\n</form>\n", styles: [":host{display:block}.praxis-filter-form{padding-top:6px}.filter-row{display:grid;grid-template-columns:repeat(auto-fit,minmax(260px,1fr));gap:12px 16px}.filter-column{min-width:0}.filter-column--full{grid-column:1/-1}.hidden-submit{display:none;width:0;height:0;padding:0;border:0}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i1$2.NgClass, selector: "[ngClass]", inputs: ["class", "ngClass"] }, { kind: "ngmodule", type: ReactiveFormsModule }, { kind: "directive", type: i1$3.ɵNgNoValidate, selector: "form:not([ngNoForm]):not([ngNativeValidate])" }, { kind: "directive", type: i1$3.NgControlStatusGroup, selector: "[formGroupName],[formArrayName],[ngModelGroup],[formGroup],[formArray],form:not([ngNoForm]),[ngForm]" }, { kind: "directive", type: i1$3.FormGroupDirective, selector: "[formGroup]", inputs: ["formGroup"], outputs: ["ngSubmit"], exportAs: ["ngForm"] }, { kind: "directive", type: DynamicFieldLoaderDirective, selector: "[dynamicFieldLoader]", inputs: ["fields", "formGroup", "enableExternalControlBinding", "itemTemplate", "debugTrace", "debugTraceLabel", "readonlyMode", "disabledMode", "presentationMode", "visible", "canvasMode"], outputs: ["componentsCreated", "fieldCreated", "fieldDestroyed", "renderError", "canvasMouseEnter", "canvasMouseLeave", "canvasClick", "canvasFocus"] }] });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: PraxisFilterForm, isStandalone: true, selector: "praxis-filter-form", inputs: { config: "config", formId: "formId", resourcePath: "resourcePath", endpointKey: "endpointKey", apiUrlEntry: "apiUrlEntry", mode: "mode" }, outputs: { formReady: "formReady", valueChange: "valueChange", submit: "submit", requestSearch: "requestSearch", validityChange: "validityChange" }, usesOnChanges: true, ngImport: i0, template: "<form\n  [formGroup]=\"form\"\n  class=\"praxis-filter-form\"\n  (change)=\"$event.stopPropagation()\"\n  (ngSubmit)=\"onFormSubmit(); $event.preventDefault(); $event.stopPropagation()\"\n>\n  @if (hasLayout) { @for (section of (config.sections || []); track section?.id ??\n  $index) {\n  <div class=\"filter-section\">\n    @if (section.title) {\n    <h3>{{ section.title }}</h3>\n    } @for (row of section.rows; track $index) {\n    <div class=\"filter-row\">\n      @for ( column of row.columns; track (column?.fields?.join(',') ?? $index)\n      ) {\n      <div class=\"filter-column\" [ngClass]=\"getColumnClasses(column)\">\n        <ng-container\n          dynamicFieldLoader\n          [fields]=\"getColumnFields(column)\"\n          [formGroup]=\"form\"\n          [enableExternalControlBinding]=\"true\"\n        ></ng-container>\n      </div>\n      }\n    </div>\n    }\n  </div>\n  } } @else {\n  <div class=\"filter-row\">\n    @for (field of fieldMetadata; track field?.name ?? $index) {\n    <div class=\"filter-column\">\n      <ng-container\n        dynamicFieldLoader\n        [fields]=\"getSingleField(field)\"\n        [formGroup]=\"form\"\n        [enableExternalControlBinding]=\"true\"\n      ></ng-container>\n    </div>\n    }\n  </div>\n  }\n  <!-- Bot\u00E3o de submit invis\u00EDvel para garantir submit ao pressionar Enter -->\n  <button\n    type=\"submit\"\n    class=\"hidden-submit\"\n    aria-hidden=\"true\"\n    tabindex=\"-1\"\n  ></button>\n</form>\n", styles: [":host{display:block}.praxis-filter-form{padding-top:6px}.filter-row{display:grid;grid-template-columns:repeat(auto-fit,minmax(260px,1fr));gap:12px 16px}.filter-column{min-width:0}.filter-column--full{grid-column:1/-1}.hidden-submit{display:none;width:0;height:0;padding:0;border:0}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i1$2.NgClass, selector: "[ngClass]", inputs: ["class", "ngClass"] }, { kind: "ngmodule", type: ReactiveFormsModule }, { kind: "directive", type: i1$3.ɵNgNoValidate, selector: "form:not([ngNoForm]):not([ngNativeValidate])" }, { kind: "directive", type: i1$3.NgControlStatusGroup, selector: "[formGroupName],[formArrayName],[ngModelGroup],[formGroup],[formArray],form:not([ngNoForm]),[ngForm]" }, { kind: "directive", type: i1$3.FormGroupDirective, selector: "[formGroup]", inputs: ["formGroup"], outputs: ["ngSubmit"], exportAs: ["ngForm"] }, { kind: "directive", type: DynamicFieldLoaderDirective, selector: "[dynamicFieldLoader]", inputs: ["fields", "formGroup", "enableExternalControlBinding", "itemTemplate", "debugTrace", "debugTraceLabel", "readonlyMode", "disabledMode", "presentationMode", "visible", "canvasMode"], outputs: ["componentsCreated", "fieldCreated", "fieldDestroyed", "renderError", "canvasMouseEnter", "canvasMouseLeave", "canvasClick", "canvasFocus"] }] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: PraxisFilterForm, decorators: [{
             type: Component,
@@ -33604,6 +33853,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                 type: Input
             }], resourcePath: [{
                 type: Input
+            }], endpointKey: [{
+                type: Input
+            }], apiUrlEntry: [{
+                type: Input
             }], mode: [{
                 type: Input
             }], formReady: [{
@@ -33709,7 +33962,19 @@ const PRAXIS_FILTER_FORM_COMPONENT_METADATA = {
             name: 'resourcePath',
             type: 'string',
             label: 'Resource',
-            description: 'Resource path used by filter schema.',
+            description: 'Resource path or catalog resourceKey used to resolve the filter schema.',
+        },
+        {
+            name: 'endpointKey',
+            type: 'ApiEndpoint',
+            label: 'Endpoint Key',
+            description: 'Canonical endpoint key used to resolve the filter schema in multi-endpoint hosts.',
+        },
+        {
+            name: 'apiUrlEntry',
+            type: 'ApiUrlEntry | null',
+            label: 'API URL Entry',
+            description: 'Explicit API URL entry for detached hosts that render the filter form outside the route injector.',
         },
         {
             name: 'mode',
@@ -33767,18 +34032,89 @@ class PraxisFilterFormWidgetConfigEditor {
     isDirty$ = new BehaviorSubject(false);
     isValid$ = new BehaviorSubject(true);
     isBusy$ = new BehaviorSubject(false);
+    schemaWarning = '';
     subscription = new Subscription();
+    schemaSubscription;
+    childBusy = false;
+    schemaLoading = false;
+    resourcePathDraft;
+    crudService = (() => {
+        try {
+            return inject(GenericCrudService, { optional: true });
+        }
+        catch {
+            return null;
+        }
+    })();
+    resourceDiscovery = (() => {
+        try {
+            return inject(ResourceDiscoveryService, { optional: true });
+        }
+        catch {
+            return null;
+        }
+    })();
+    cdr = (() => {
+        try {
+            return inject(ChangeDetectorRef, { optional: true });
+        }
+        catch {
+            return null;
+        }
+    })();
+    get effectiveResourcePath() {
+        if (this.resourcePathDraft !== undefined) {
+            return this.resourcePathDraft;
+        }
+        return String(this.inputs?.resourcePath || '').trim();
+    }
+    get effectiveEndpointKey() {
+        return this.buildDiscoveryOptions()?.endpointKey;
+    }
+    get effectiveApiUrlEntry() {
+        return this.buildDiscoveryOptions()?.apiUrlEntry;
+    }
+    onResourceQuickConnect(resourcePath) {
+        const normalized = String(resourcePath ?? '').trim();
+        if (!normalized) {
+            this.onResourceQuickClear();
+            return;
+        }
+        this.resourcePathDraft = normalized;
+        this.updateDirtyState(this.formEditor?.isDirty$.value ?? false);
+        if (this.formEditor) {
+            const currentDoc = parseLegacyOrDynamicFormDocument(this.formEditor.getSettingsValue?.() ?? this.createDocumentFromInputs());
+            this.loadFilterSchemaFieldsIfNeeded(normalized, currentDoc, true);
+        }
+    }
+    onResourceQuickClear() {
+        this.schemaSubscription?.unsubscribe();
+        this.schemaLoading = false;
+        this.publishBusy();
+        this.resourcePathDraft = '';
+        this.schemaWarning = '';
+        this.updateDirtyState(this.formEditor?.isDirty$.value ?? false);
+    }
+    updateDirtyState(editorDirty) {
+        const baseline = String(this.inputs?.resourcePath || '').trim();
+        const resourceChanged = this.resourcePathDraft !== undefined && this.resourcePathDraft !== baseline;
+        this.isDirty$.next(editorDirty || resourceChanged);
+    }
     ngAfterViewInit() {
         if (!this.formEditor) {
             return;
         }
         this.formEditor.supportsPresentationSettings = false;
-        this.initializeChildEditor();
-        this.subscription.add(this.formEditor.isDirty$.subscribe((value) => this.isDirty$.next(value)));
+        this.subscription.add(this.formEditor.isDirty$.subscribe((value) => this.updateDirtyState(value)));
         this.subscription.add(this.formEditor.isValid$.subscribe((value) => this.isValid$.next(value)));
-        this.subscription.add(this.formEditor.isBusy$.subscribe((value) => this.isBusy$.next(value)));
+        this.subscription.add(this.formEditor.isBusy$.subscribe((value) => {
+            this.childBusy = value;
+            this.publishBusy();
+        }));
+        this.initializeChildEditor();
     }
     ngOnDestroy() {
+        this.schemaSubscription?.unsubscribe();
         this.subscription.unsubscribe();
     }
     getSettingsValue() {
@@ -33788,27 +34124,146 @@ class PraxisFilterFormWidgetConfigEditor {
         return this.buildValue(this.formEditor?.onSave?.() ?? this.formEditor?.getSettingsValue());
     }
     reset() {
+        this.schemaSubscription?.unsubscribe();
+        this.schemaLoading = false;
+        this.resourcePathDraft = undefined;
+        this.publishBusy();
         this.formEditor?.reset?.();
+        this.updateDirtyState(this.formEditor?.isDirty$.value ?? false);
+    }
+    publishBusy() {
+        this.isBusy$.next(this.childBusy || this.schemaLoading);
     }
     initializeChildEditor() {
         const document = this.createDocumentFromInputs();
+        this.applyBaselineDocumentToChildEditor(document, 'filter-form-widget-config-init');
+        const resourcePath = this.effectiveResourcePath;
+        if (resourcePath &&
+            (!Array.isArray(document.config.fieldMetadata) || document.config.fieldMetadata.length === 0)) {
+            this.loadFilterSchemaFieldsIfNeeded(resourcePath, document);
+        }
+    }
+    applyBaselineDocumentToChildEditor(document, reason) {
         const serialized = serializeDynamicFormAuthoringDocument(document);
         const editor = this.formEditor;
         editor.onJsonConfigChange?.(serialized);
         editor.initialDocument = document;
         editor.initialConfig = document.config;
-        editor.updateDirtyState?.('filter-form-widget-config-init');
+        editor.updateDirtyState?.(reason);
         editor.isDirty$?.next(false);
         editor.isValid$?.next(true);
     }
+    loadFilterSchemaFieldsIfNeeded(resourcePath, baselineDocument, forceReload = false) {
+        const discoveryOptions = this.buildDiscoveryOptions();
+        const canLoadViaDiscovery = typeof this.resourceDiscovery?.getResourceFilterSchemaFields === 'function' &&
+            (typeof this.resourceDiscovery.canResolveSchemas !== 'function' ||
+                this.resourceDiscovery.canResolveSchemas(discoveryOptions));
+        const canLoadViaCrud = typeof this.crudService?.getFilterSchema === 'function' ||
+            typeof this.crudService?.getSchema === 'function';
+        if (!canLoadViaCrud && !canLoadViaDiscovery) {
+            return;
+        }
+        const loadFromDiscovery = () => discoveryOptions
+            ? this.resourceDiscovery.getResourceFilterSchemaFields(resourcePath, discoveryOptions)
+            : this.resourceDiscovery.getResourceFilterSchemaFields(resourcePath);
+        const loadFromCrud = () => {
+            if (!canLoadViaCrud || !this.crudService) {
+                return of([]);
+            }
+            if (discoveryOptions?.endpointKey || discoveryOptions?.apiUrlEntry) {
+                this.crudService.configure?.(resourcePath, {
+                    ...(discoveryOptions.endpointKey ? { endpointKey: discoveryOptions.endpointKey } : {}),
+                    ...(discoveryOptions.apiUrlEntry ? { apiUrlEntry: discoveryOptions.apiUrlEntry } : {}),
+                });
+            }
+            else {
+                this.crudService.configure?.(resourcePath);
+            }
+            return typeof this.crudService.getFilterSchema === 'function'
+                ? this.crudService.getFilterSchema()
+                : this.crudService.getSchema();
+        };
+        const isCatalogResourceKey = !resourcePath.includes('/') && resourcePath.includes('.');
+        let source$;
+        if (isCatalogResourceKey && canLoadViaDiscovery) {
+            source$ = loadFromDiscovery().pipe(defaultIfEmpty([]), switchMap$1((defs) => Array.isArray(defs) && defs.length === 0 && canLoadViaCrud
+                ? loadFromCrud()
+                : of(defs)), catchError$1(() => (canLoadViaCrud ? loadFromCrud() : of([]))));
+        }
+        else if (canLoadViaCrud) {
+            source$ = loadFromCrud().pipe(defaultIfEmpty([]), switchMap$1((defs) => Array.isArray(defs) && defs.length === 0 && canLoadViaDiscovery
+                ? loadFromDiscovery()
+                : of(defs)), catchError$1(() => (canLoadViaDiscovery ? loadFromDiscovery() : of([]))));
+        }
+        else {
+            source$ = loadFromDiscovery();
+        }
+        this.schemaSubscription?.unsubscribe();
+        this.schemaWarning = '';
+        this.schemaLoading = true;
+        this.publishBusy();
+        this.schemaSubscription = source$
+            .pipe(take$1(1), catchError$1(() => of([])), finalize$1(() => {
+            this.schemaLoading = false;
+            this.publishBusy();
+            this.cdr?.markForCheck();
+        }))
+            .subscribe((defs) => {
+            if (!Array.isArray(defs) || defs.length === 0) {
+                this.schemaWarning = `No filter schema fields were returned for resource "${resourcePath}".`;
+                this.cdr?.markForCheck();
+                return;
+            }
+            if ((!forceReload && this.isDirty$.value) || !this.formEditor) {
+                return;
+            }
+            const fieldMetadata = mapFieldDefinitionsToMetadata(defs);
+            if (!fieldMetadata.length) {
+                this.schemaWarning = `No filter schema fields were returned for resource "${resourcePath}".`;
+                this.cdr?.markForCheck();
+                return;
+            }
+            const newFieldNames = new Set(fieldMetadata.map((f) => f.name));
+            const existingSectionFields = (baselineDocument.config.sections ?? []).flatMap((section) => (section.rows ?? []).flatMap((row) => (row.columns ?? []).flatMap((col) => (col.fields ?? []).map((f) => typeof f === 'string' ? f : f?.name ?? '')))).filter(Boolean);
+            const shouldResetSections = forceReload &&
+                existingSectionFields.length > 0 &&
+                !existingSectionFields.some((fieldName) => newFieldNames.has(fieldName));
+            const nextDocument = {
+                ...baselineDocument,
+                config: {
+                    ...baselineDocument.config,
+                    ...(shouldResetSections ? { sections: [] } : {}),
+                    fieldMetadata,
+                },
+            };
+            this.applyBaselineDocumentToChildEditor(nextDocument, 'filter-form-widget-config-schema');
+            this.updateDirtyState(this.formEditor.isDirty$.value);
+            this.cdr?.markForCheck();
+        });
+    }
+    buildDiscoveryOptions() {
+        const rawEndpointKey = this.inputs?.apiEndpointKey ?? this.inputs?.endpointKey;
+        const endpointKey = String(rawEndpointKey ?? '').trim();
+        const apiUrlEntry = this.inputs?.apiUrlEntry;
+        if (!endpointKey && !apiUrlEntry) {
+            return undefined;
+        }
+        return {
+            ...(endpointKey ? { endpointKey } : {}),
+            ...(apiUrlEntry ? { apiUrlEntry } : {}),
+        };
+    }
     buildValue(rawDocument) {
         const document = parseLegacyOrDynamicFormDocument(rawDocument ?? this.createDocumentFromInputs());
+        const resolvedResourcePath = this.resourcePathDraft !== undefined
+            ? this.resourcePathDraft || undefined
+            : this.inputs?.resourcePath;
         return {
             inputs: {
                 ...(this.inputs ?? {}),
                 config: document.config,
                 formId: this.inputs?.formId ?? this.widgetKey,
-                resourcePath: this.inputs?.resourcePath,
+                resourcePath: resolvedResourcePath,
                 mode: document.bindings?.mode ?? this.inputs?.mode ?? 'create',
             },
         };
@@ -33829,25 +34284,47 @@ class PraxisFilterFormWidgetConfigEditor {
             : undefined;
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: PraxisFilterFormWidgetConfigEditor, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "21.2.14", type: PraxisFilterFormWidgetConfigEditor, isStandalone: true, selector: "praxis-filter-form-widget-config-editor", inputs: { inputs: "inputs", widgetKey: "widgetKey" }, viewQueries: [{ propertyName: "formEditor", first: true, predicate: ["formEditor"], descendants: true }], ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: PraxisFilterFormWidgetConfigEditor, isStandalone: true, selector: "praxis-filter-form-widget-config-editor", inputs: { inputs: "inputs", widgetKey: "widgetKey" }, providers: [{ provide: SETTINGS_PANEL_DATA, useValue: null }], viewQueries: [{ propertyName: "formEditor", first: true, predicate: ["formEditor"], descendants: true }], ngImport: i0, template: `
     <section data-testid="filter-form-widget-config-editor">
+      <div class="filter-form-resource-quick-connect" data-testid="filter-form-resource-quick-connect">
+        <praxis-resource-quick-connect
+          [resourcePath]="effectiveResourcePath"
+          [endpointKey]="effectiveEndpointKey"
+          [apiUrlEntry]="effectiveApiUrlEntry"
+          intent="filter"
+          (resourcePathChange)="onResourceQuickConnect($event)"
+        ></praxis-resource-quick-connect>
+      </div>
+      @if (schemaWarning) {
+        <p class="filter-form-editor-schema-warning" data-testid="filter-form-schema-warning" role="status">
+          {{ schemaWarning }}
+        </p>
+      }
       <praxis-dynamic-form-config-editor #formEditor />
     </section>
-  `, isInline: true, dependencies: [{ kind: "component", type: PraxisDynamicFormConfigEditor, selector: "praxis-dynamic-form-config-editor" }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+  `, isInline: true, styles: [".filter-form-resource-quick-connect{padding:var(--p-space-4, 16px) var(--p-space-4, 16px) var(--p-space-2, 8px)}\n"], dependencies: [{ kind: "component", type: PraxisDynamicFormConfigEditor, selector: "praxis-dynamic-form-config-editor" }, { kind: "component", type: ResourceQuickConnectComponent, selector: "praxis-resource-quick-connect", inputs: ["resourcePath", "endpointKey", "apiUrlEntry", "intent", "resources", "label", "placeholder", "hint", "disabled"], outputs: ["resourcePathChange"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: PraxisFilterFormWidgetConfigEditor, decorators: [{
             type: Component,
-            args: [{
-                    selector: 'praxis-filter-form-widget-config-editor',
-                    standalone: true,
-                    imports: [PraxisDynamicFormConfigEditor],
-                    template: `
+            args: [{ providers: [{ provide: SETTINGS_PANEL_DATA, useValue: null }], selector: 'praxis-filter-form-widget-config-editor', standalone: true, imports: [PraxisDynamicFormConfigEditor, ResourceQuickConnectComponent], template: `
     <section data-testid="filter-form-widget-config-editor">
+      <div class="filter-form-resource-quick-connect" data-testid="filter-form-resource-quick-connect">
+        <praxis-resource-quick-connect
+          [resourcePath]="effectiveResourcePath"
+          [endpointKey]="effectiveEndpointKey"
+          [apiUrlEntry]="effectiveApiUrlEntry"
+          intent="filter"
+          (resourcePathChange)="onResourceQuickConnect($event)"
+        ></praxis-resource-quick-connect>
+      </div>
+      @if (schemaWarning) {
+        <p class="filter-form-editor-schema-warning" data-testid="filter-form-schema-warning" role="status">
+          {{ schemaWarning }}
+        </p>
+      }
       <praxis-dynamic-form-config-editor #formEditor />
     </section>
-  `,
-                    changeDetection: ChangeDetectionStrategy.OnPush,
-                }]
+  `, changeDetection: ChangeDetectionStrategy.OnPush, styles: [".filter-form-resource-quick-connect{padding:var(--p-space-4, 16px) var(--p-space-4, 16px) var(--p-space-2, 8px)}\n"] }]
         }], propDecorators: { inputs: [{
                 type: Input
             }], widgetKey: [{
@@ -33863,40 +34340,97 @@ var praxisFilterFormWidgetConfigEditor = /*#__PURE__*/Object.freeze({
 });
 
 class PraxisDynamicFormWidgetConfigEditor {
+    crudService = this.optionalInject(GenericCrudService);
+    resourceDiscovery = this.optionalInject(ResourceDiscoveryService);
+    cdr = this.optionalInject(ChangeDetectorRef);
     inputs = null;
     widgetKey;
     appliedValues$;
     appliedSource;
+    appliedResourcePath;
     /** Runtime evidence supplied by the existing component editor context resolver. */
     context = {};
     formEditor;
     isDirty$ = new BehaviorSubject(false);
     isValid$ = new BehaviorSubject(true);
     isBusy$ = new BehaviorSubject(false);
+    schemaWarning = '';
     subscription = new Subscription();
+    schemaSubscription;
+    childBusy = false;
+    schemaLoading = false;
     initialEditorConfig;
     sourceDraft;
+    resourcePathDraft;
+    optionalInject(token) {
+        try {
+            return inject(token, { optional: true });
+        }
+        catch {
+            return null;
+        }
+    }
     get configurationSource() {
         return this.sourceDraft ?? this.inputs?.configPersistenceStrategy ?? 'local-first';
     }
+    get effectiveResourcePath() {
+        if (this.resourcePathDraft !== undefined) {
+            return this.resourcePathDraft;
+        }
+        return String(this.inputs?.resourcePath ?? this.context['resourcePath'] ?? '').trim();
+    }
+    get effectiveEndpointKey() {
+        return this.buildDiscoveryOptions()?.endpointKey;
+    }
+    get effectiveApiUrlEntry() {
+        return this.buildDiscoveryOptions()?.apiUrlEntry;
+    }
+    get effectiveDiscoveryIntent() {
+        return (this.inputs?.schemaSource ?? this.context['schemaSource']) === 'filter'
+            ? 'filter'
+            : 'crud';
+    }
     changeConfigurationSource(value) {
         if (value !== 'local-first' && value !== 'input-first')
             return;
         this.sourceDraft = value;
         this.updateDirtyState(this.formEditor?.isDirty$.value ?? false);
     }
-    updateDirtyState(editorDirty) {
-        this.isDirty$.next(editorDirty || (this.sourceDraft !== undefined &&
-            this.sourceDraft !== (this.appliedSource ?? this.inputs?.configPersistenceStrategy ?? 'local-first')));
-    }
-    cdr = (() => {
-        try {
-            return inject(ChangeDetectorRef, { optional: true });
+    onResourceQuickConnect(resourcePath) {
+        const normalized = String(resourcePath ?? '').trim();
+        if (!normalized) {
+            this.onResourceQuickClear();
+            return;
         }
-        catch {
-            return null;
+        this.resourcePathDraft = normalized;
+        this.updateDirtyState(this.formEditor?.isDirty$.value ?? false);
+        this.loadResourceSchemaFieldsIfNeeded(true);
+    }
+    onResourceQuickClear() {
+        this.schemaSubscription?.unsubscribe();
+        this.schemaLoading = false;
+        this.publishBusy();
+        this.resourcePathDraft = '';
+        this.schemaWarning = '';
+        this.updateDirtyState(this.formEditor?.isDirty$.value ?? false);
+    }
+    baselineResourcePath() {
+        if (this.appliedResourcePath !== undefined) {
+            return this.appliedResourcePath;
         }
-    })();
+        return String(this.inputs?.resourcePath ?? this.context['resourcePath'] ?? '').trim();
+    }
+    updateDirtyState(editorDirty) {
+        const sourceChanged = this.sourceDraft !== undefined &&
+            this.sourceDraft !==
+                (this.appliedSource ?? this.inputs?.configPersistenceStrategy ?? 'local-first');
+        const resourceChanged = this.resourcePathDraft !== undefined &&
+            this.resourcePathDraft !== this.baselineResourcePath();
+        this.isDirty$.next(editorDirty || sourceChanged || resourceChanged);
+    }
+    publishBusy() {
+        this.isBusy$.next(this.childBusy || this.schemaLoading);
+    }
     ngAfterViewInit() {
         if (!this.formEditor) {
             return;
@@ -33909,9 +34443,14 @@ class PraxisDynamicFormWidgetConfigEditor {
         this.initialEditorConfig = structuredClone(parseLegacyOrDynamicFormDocument(this.formEditor.getSettingsValue?.() ?? this.createDocumentFromInputs()).config);
         this.subscription.add(this.formEditor.isDirty$.subscribe((value) => this.updateDirtyState(value)));
         this.subscription.add(this.formEditor.isValid$.subscribe((value) => this.isValid$.next(value)));
-        this.subscription.add(this.formEditor.isBusy$.subscribe((value) => this.isBusy$.next(value)));
+        this.subscription.add(this.formEditor.isBusy$.subscribe((value) => {
+            this.childBusy = value;
+            this.publishBusy();
+        }));
+        this.loadResourceSchemaFieldsIfNeeded();
     }
     ngOnDestroy() {
+        this.schemaSubscription?.unsubscribe();
         this.subscription.unsubscribe();
     }
     getSettingsValue() {
@@ -33925,25 +34464,173 @@ class PraxisDynamicFormWidgetConfigEditor {
             return;
         // The owner acknowledges the current draft only after committing its inputs.
         this.appliedSource = this.configurationSource;
+        if (this.resourcePathDraft !== undefined) {
+            this.appliedResourcePath = this.resourcePathDraft;
+        }
         this.formEditor?.acceptAppliedValue(this.formEditor.getSettingsValue());
         this.updateDirtyState(this.formEditor?.isDirty$.value ?? false);
     }
     reset() {
+        this.schemaSubscription?.unsubscribe();
+        this.schemaLoading = false;
+        this.publishBusy();
         this.sourceDraft = undefined;
+        this.resourcePathDraft = undefined;
         this.formEditor?.reset?.();
         this.updateDirtyState(this.formEditor?.isDirty$.value ?? false);
+        this.loadResourceSchemaFieldsIfNeeded();
     }
     initializeChildEditor() {
         const document = this.createDocumentFromInputs();
+        this.applyBaselineDocumentToChildEditor(document, 'widget-config-init');
+    }
+    applyBaselineDocumentToChildEditor(document, reason) {
         const serialized = serializeDynamicFormAuthoringDocument(document);
         const editor = this.formEditor;
         editor.onJsonConfigChange?.(serialized);
         editor.initialDocument = document;
         editor.initialConfig = document.config;
-        editor.updateDirtyState?.('widget-config-init');
+        editor.updateDirtyState?.(reason);
         editor.isDirty$?.next(false);
         editor.isValid$?.next(true);
     }
+    loadResourceSchemaFieldsIfNeeded(forceReload = false) {
+        if (!this.formEditor) {
+            return;
+        }
+        const resourcePath = this.effectiveResourcePath;
+        const currentDoc = parseLegacyOrDynamicFormDocument(this.formEditor.getSettingsValue?.() ?? this.createDocumentFromInputs());
+        if (!resourcePath ||
+            (!forceReload &&
+                Array.isArray(currentDoc.config.fieldMetadata) &&
+                currentDoc.config.fieldMetadata.length > 0)) {
+            return;
+        }
+        const isFilterSource = (this.inputs?.schemaSource ?? this.context['schemaSource']) === 'filter';
+        const discoveryOptions = this.buildDiscoveryOptions();
+        const discoveryMethodName = isFilterSource
+            ? 'getResourceFilterSchemaFields'
+            : 'getResourceSchemaFields';
+        const canLoadViaDiscovery = typeof this.resourceDiscovery?.[discoveryMethodName] === 'function' &&
+            (typeof this.resourceDiscovery?.canResolveSchemas !== 'function' ||
+                this.resourceDiscovery.canResolveSchemas(discoveryOptions));
+        const canLoadViaCrud = isFilterSource
+            ? typeof this.crudService?.getFilterSchema === 'function' ||
+                typeof this.crudService?.getSchema === 'function'
+            : typeof this.crudService?.getSchema === 'function';
+        if (!canLoadViaCrud && !canLoadViaDiscovery) {
+            return;
+        }
+        const loadFromDiscovery = () => {
+            if (isFilterSource) {
+                return discoveryOptions
+                    ? this.resourceDiscovery.getResourceFilterSchemaFields(resourcePath, discoveryOptions)
+                    : this.resourceDiscovery.getResourceFilterSchemaFields(resourcePath);
+            }
+            return discoveryOptions
+                ? this.resourceDiscovery.getResourceSchemaFields(resourcePath, discoveryOptions)
+                : this.resourceDiscovery.getResourceSchemaFields(resourcePath);
+        };
+        const loadFromCrud = () => {
+            if (!canLoadViaCrud || !this.crudService) {
+                return of([]);
+            }
+            if (discoveryOptions?.endpointKey || discoveryOptions?.apiUrlEntry) {
+                this.crudService.configure?.(resourcePath, {
+                    ...(discoveryOptions.endpointKey ? { endpointKey: discoveryOptions.endpointKey } : {}),
+                    ...(discoveryOptions.apiUrlEntry ? { apiUrlEntry: discoveryOptions.apiUrlEntry } : {}),
+                });
+            }
+            else {
+                this.crudService.configure?.(resourcePath);
+            }
+            if (isFilterSource && typeof this.crudService.getFilterSchema === 'function') {
+                return this.crudService.getFilterSchema();
+            }
+            return this.crudService.getSchema();
+        };
+        const isCatalogResourceKey = !resourcePath.includes('/') && resourcePath.includes('.');
+        let source$;
+        if (isCatalogResourceKey && canLoadViaDiscovery) {
+            source$ = loadFromDiscovery().pipe(defaultIfEmpty([]), switchMap$1((defs) => Array.isArray(defs) && defs.length === 0 && canLoadViaCrud
+                ? loadFromCrud()
+                : of(defs)), catchError$1(() => canLoadViaCrud ? loadFromCrud() : of([])));
+        }
+        else if (canLoadViaCrud) {
+            source$ = loadFromCrud().pipe(defaultIfEmpty([]), switchMap$1((defs) => Array.isArray(defs) && defs.length === 0 && canLoadViaDiscovery
+                ? loadFromDiscovery()
+                : of(defs)), catchError$1(() => canLoadViaDiscovery ? loadFromDiscovery() : of([])));
+        }
+        else {
+            source$ = loadFromDiscovery();
+        }
+        this.schemaSubscription?.unsubscribe();
+        this.schemaWarning = '';
+        this.schemaLoading = true;
+        this.publishBusy();
+        this.schemaSubscription = source$
+            .pipe(take$1(1), catchError$1(() => of([])), finalize$1(() => {
+            this.schemaLoading = false;
+            this.publishBusy();
+            this.cdr?.markForCheck();
+        }))
+            .subscribe((defs) => {
+            if (!Array.isArray(defs) || defs.length === 0) {
+                this.schemaWarning = `No schema fields were returned for resource "${resourcePath}".`;
+                this.cdr?.markForCheck();
+                return;
+            }
+            if ((!forceReload && this.isDirty$.value) || !this.formEditor) {
+                return;
+            }
+            const fieldMetadata = mapFieldDefinitionsToMetadata(defs);
+            if (!fieldMetadata.length) {
+                this.schemaWarning = `No schema fields were returned for resource "${resourcePath}".`;
+                this.cdr?.markForCheck();
+                return;
+            }
+            const latestDoc = parseLegacyOrDynamicFormDocument(this.formEditor.getSettingsValue?.() ?? currentDoc);
+            if (!forceReload &&
+                Array.isArray(latestDoc.config.fieldMetadata) &&
+                latestDoc.config.fieldMetadata.length > 0) {
+                return;
+            }
+            const newFieldNames = new Set(fieldMetadata.map((f) => f.name));
+            const existingSectionFields = (latestDoc.config.sections ?? []).flatMap((section) => (section.rows ?? []).flatMap((row) => (row.columns ?? []).flatMap((col) => (col.fields ?? []).map((f) => typeof f === 'string' ? f : f?.name ?? '')))).filter(Boolean);
+            const shouldResetSections = forceReload &&
+                existingSectionFields.length > 0 &&
+                !existingSectionFields.some((fieldName) => newFieldNames.has(fieldName));
+            const nextDocument = {
+                ...latestDoc,
+                config: {
+                    ...latestDoc.config,
+                    ...(shouldResetSections ? { sections: [] } : {}),
+                    fieldMetadata,
+                },
+            };
+            this.applyBaselineDocumentToChildEditor(nextDocument, 'widget-config-schema-hydrate');
+            this.cdr?.detectChanges();
+            this.initialEditorConfig = structuredClone(parseLegacyOrDynamicFormDocument(this.formEditor.getSettingsValue?.() ?? nextDocument).config);
+            this.updateDirtyState(this.formEditor.isDirty$.value);
+            this.cdr?.markForCheck();
+        });
+    }
+    buildDiscoveryOptions() {
+        const rawEndpointKey = this.inputs?.apiEndpointKey ??
+            this.inputs?.endpointKey ??
+            this.context['apiEndpointKey'] ??
+            this.context['endpointKey'];
+        const endpointKey = String(rawEndpointKey ?? '').trim();
+        const apiUrlEntry = this.inputs?.apiUrlEntry ??
+            this.context['apiUrlEntry'];
+        if (!endpointKey && !apiUrlEntry) {
+            return undefined;
+        }
+        return {
+            ...(endpointKey ? { endpointKey } : {}),
+            ...(apiUrlEntry ? { apiUrlEntry } : {}),
+        };
+    }
     buildValue(rawDocument) {
         const document = parseLegacyOrDynamicFormDocument(rawDocument ?? this.createDocumentFromInputs());
         const schemaPrefs = document.contextSnapshot?.schemaPrefs;
@@ -33955,6 +34642,9 @@ class PraxisDynamicFormWidgetConfigEditor {
             inputs: {
                 ...(this.inputs ?? {}),
                 ...(this.sourceDraft !== undefined ? { configPersistenceStrategy: this.sourceDraft } : {}),
+                ...(this.resourcePathDraft !== undefined
+                    ? { resourcePath: this.resourcePathDraft || null }
+                    : {}),
                 // An explicit layout edit authors sections; merely inspecting generated layout does not.
                 ...(layoutChanged && layoutPolicy?.source === 'schema'
                     ? { layoutPolicy: { ...layoutPolicy, source: 'authored' } } : {}),
@@ -34002,7 +34692,7 @@ class PraxisDynamicFormWidgetConfigEditor {
         });
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: PraxisDynamicFormWidgetConfigEditor, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "21.2.14", type: PraxisDynamicFormWidgetConfigEditor, isStandalone: true, selector: "praxis-dynamic-form-widget-config-editor", inputs: { inputs: "inputs", widgetKey: "widgetKey", appliedValues$: "appliedValues$", context: "context" }, providers: [{ provide: SETTINGS_PANEL_DATA, useValue: null }], viewQueries: [{ propertyName: "formEditor", first: true, predicate: ["formEditor"], descendants: true }], ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.14", type: PraxisDynamicFormWidgetConfigEditor, isStandalone: true, selector: "praxis-dynamic-form-widget-config-editor", inputs: { inputs: "inputs", widgetKey: "widgetKey", appliedValues$: "appliedValues$", context: "context" }, providers: [{ provide: SETTINGS_PANEL_DATA, useValue: null }], viewQueries: [{ propertyName: "formEditor", first: true, predicate: ["formEditor"], descendants: true }], ngImport: i0, template: `
     <section data-testid="dynamic-form-widget-config-editor">
       <div class="configuration-source">
         <mat-form-field appearance="outline" subscriptSizing="dynamic">
@@ -34014,14 +34704,33 @@ class PraxisDynamicFormWidgetConfigEditor {
           <mat-hint>{{ formEditor.tx(configurationSource === 'input-first' ? 'config.general.configurationSource.pageHelp' : 'config.general.configurationSource.preferencesHelp') }}</mat-hint>
         </mat-form-field>
       </div>
+      <div class="resource-quick-connect-host" data-testid="form-widget-resource-quick-connect">
+        <praxis-resource-quick-connect
+          [resourcePath]="effectiveResourcePath"
+          [endpointKey]="effectiveEndpointKey"
+          [apiUrlEntry]="effectiveApiUrlEntry"
+          [intent]="effectiveDiscoveryIntent"
+          (resourcePathChange)="onResourceQuickConnect($event)"
+        ></praxis-resource-quick-connect>
+      </div>
+      @if (schemaWarning) {
+        <p class="form-widget-schema-warning" data-testid="form-widget-schema-warning" role="status">
+          {{ schemaWarning }}
+        </p>
+      }
       <praxis-dynamic-form-config-editor #formEditor />
       <p class="widget-save-hint">{{ formEditor.tx('config.general.pageSaveHint') }}</p>
     </section>
-  `, isInline: true, styles: [".configuration-source{padding:var(--p-space-4, 16px)}.configuration-source mat-form-field{width:100%}.widget-save-hint{margin:12px 20px;color:var(--md-sys-color-on-surface-variant);font:var(--md-sys-typescale-body-small)}\n"], dependencies: [{ kind: "component", type: PraxisDynamicFormConfigEditor, selector: "praxis-dynamic-form-config-editor" }, { kind: "ngmodule", type: MatFormFieldModule }, { kind: "component", type: i4$1.MatFormField, selector: "mat-form-field", inputs: ["hideRequiredMarker", "color", "floatLabel", "appearance", "subscriptSizing", "hintLabel"], exportAs: ["matFormField"] }, { kind: "directive", type: i4$1.MatLabel, selector: "mat-label" }, { kind: "directive", type: i4$1.MatHint, selector: "mat-hint", inputs: ["align", "id"] }, { kind: "ngmodule", type: MatSelectModule }, { kind: "component", type: i5$1.MatSelect, selector: "mat-select", inputs: ["aria-describedby", "panelClass", "disabled", "disableRipple", "tabIndex", "hideSingleSelectionIndicator", "placeholder", "required", "multiple", "disableOptionCentering", "compareWith", "value", "aria-label", "aria-labelledby", "errorStateMatcher", "typeaheadDebounceInterval", "sortComparator", "id", "panelWidth", "canSelectNullableOptions"], outputs: ["openedChange", "opened", "closed", "selectionChange", "valueChange"], exportAs: ["matSelect"] }, { kind: "component", type: i5$1.MatOption, selector: "mat-option", inputs: ["value", "id", "disabled"], outputs: ["onSelectionChange"], exportAs: ["matOption"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+  `, isInline: true, styles: [".configuration-source{padding:var(--p-space-4, 16px)}.configuration-source mat-form-field{width:100%}.resource-quick-connect-host{padding:0 var(--p-space-4, 16px) var(--p-space-3, 12px)}.form-widget-schema-warning{margin:0 16px 8px;color:var(--md-sys-color-on-surface-variant);font:var(--md-sys-typescale-body-small)}.widget-save-hint{margin:12px 20px;color:var(--md-sys-color-on-surface-variant);font:var(--md-sys-typescale-body-small)}\n"], dependencies: [{ kind: "component", type: PraxisDynamicFormConfigEditor, selector: "praxis-dynamic-form-config-editor" }, { kind: "component", type: ResourceQuickConnectComponent, selector: "praxis-resource-quick-connect", inputs: ["resourcePath", "endpointKey", "apiUrlEntry", "intent", "resources", "label", "placeholder", "hint", "disabled"], outputs: ["resourcePathChange"] }, { kind: "ngmodule", type: MatFormFieldModule }, { kind: "component", type: i4$1.MatFormField, selector: "mat-form-field", inputs: ["hideRequiredMarker", "color", "floatLabel", "appearance", "subscriptSizing", "hintLabel"], exportAs: ["matFormField"] }, { kind: "directive", type: i4$1.MatLabel, selector: "mat-label" }, { kind: "directive", type: i4$1.MatHint, selector: "mat-hint", inputs: ["align", "id"] }, { kind: "ngmodule", type: MatSelectModule }, { kind: "component", type: i5$1.MatSelect, selector: "mat-select", inputs: ["aria-describedby", "panelClass", "disabled", "disableRipple", "tabIndex", "hideSingleSelectionIndicator", "placeholder", "required", "multiple", "disableOptionCentering", "compareWith", "value", "aria-label", "aria-labelledby", "errorStateMatcher", "typeaheadDebounceInterval", "sortComparator", "id", "panelWidth", "canSelectNullableOptions"], outputs: ["openedChange", "opened", "closed", "selectionChange", "valueChange"], exportAs: ["matSelect"] }, { kind: "component", type: i5$1.MatOption, selector: "mat-option", inputs: ["value", "id", "disabled"], outputs: ["onSelectionChange"], exportAs: ["matOption"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: PraxisDynamicFormWidgetConfigEditor, decorators: [{
             type: Component,
-            args: [{ providers: [{ provide: SETTINGS_PANEL_DATA, useValue: null }], selector: 'praxis-dynamic-form-widget-config-editor', standalone: true, imports: [PraxisDynamicFormConfigEditor, MatFormFieldModule, MatSelectModule], template: `
+            args: [{ providers: [{ provide: SETTINGS_PANEL_DATA, useValue: null }], selector: 'praxis-dynamic-form-widget-config-editor', standalone: true, imports: [
+                        PraxisDynamicFormConfigEditor,
+                        ResourceQuickConnectComponent,
+                        MatFormFieldModule,
+                        MatSelectModule,
+                    ], template: `
     <section data-testid="dynamic-form-widget-config-editor">
       <div class="configuration-source">
         <mat-form-field appearance="outline" subscriptSizing="dynamic">
@@ -34033,10 +34742,24 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
           <mat-hint>{{ formEditor.tx(configurationSource === 'input-first' ? 'config.general.configurationSource.pageHelp' : 'config.general.configurationSource.preferencesHelp') }}</mat-hint>
         </mat-form-field>
       </div>
+      <div class="resource-quick-connect-host" data-testid="form-widget-resource-quick-connect">
+        <praxis-resource-quick-connect
+          [resourcePath]="effectiveResourcePath"
+          [endpointKey]="effectiveEndpointKey"
+          [apiUrlEntry]="effectiveApiUrlEntry"
+          [intent]="effectiveDiscoveryIntent"
+          (resourcePathChange)="onResourceQuickConnect($event)"
+        ></praxis-resource-quick-connect>
+      </div>
+      @if (schemaWarning) {
+        <p class="form-widget-schema-warning" data-testid="form-widget-schema-warning" role="status">
+          {{ schemaWarning }}
+        </p>
+      }
       <praxis-dynamic-form-config-editor #formEditor />
       <p class="widget-save-hint">{{ formEditor.tx('config.general.pageSaveHint') }}</p>
     </section>
-  `, changeDetection: ChangeDetectionStrategy.OnPush, styles: [".configuration-source{padding:var(--p-space-4, 16px)}.configuration-source mat-form-field{width:100%}.widget-save-hint{margin:12px 20px;color:var(--md-sys-color-on-surface-variant);font:var(--md-sys-typescale-body-small)}\n"] }]
+  `, changeDetection: ChangeDetectionStrategy.OnPush, styles: [".configuration-source{padding:var(--p-space-4, 16px)}.configuration-source mat-form-field{width:100%}.resource-quick-connect-host{padding:0 var(--p-space-4, 16px) var(--p-space-3, 12px)}.form-widget-schema-warning{margin:0 16px 8px;color:var(--md-sys-color-on-surface-variant);font:var(--md-sys-typescale-body-small)}.widget-save-hint{margin:12px 20px;color:var(--md-sys-color-on-surface-variant);font:var(--md-sys-typescale-body-small)}\n"] }]
         }], propDecorators: { inputs: [{
                 type: Input
             }], widgetKey: [{
@@ -34371,6 +35094,21 @@ const PRAXIS_DYNAMIC_FORM_COMPONENT_METADATA = {
             context: {
                 effectiveConfig: materializedInputs?.['config'],
                 layoutPolicy: materializedInputs?.['layoutPolicy'],
+                ...(materializedInputs?.['resourcePath'] !== undefined
+                    ? { resourcePath: materializedInputs['resourcePath'] }
+                    : {}),
+                ...(materializedInputs?.['apiEndpointKey'] !== undefined
+                    ? { apiEndpointKey: materializedInputs['apiEndpointKey'] }
+                    : {}),
+                ...(materializedInputs?.['endpointKey'] !== undefined
+                    ? { endpointKey: materializedInputs['endpointKey'] }
+                    : {}),
+                ...(materializedInputs?.['apiUrlEntry'] !== undefined
+                    ? { apiUrlEntry: materializedInputs['apiUrlEntry'] }
+                    : {}),
+                ...(materializedInputs?.['schemaSource'] !== undefined
+                    ? { schemaSource: materializedInputs['schemaSource'] }
+                    : {}),
             },
         }),
         title: 'Configurar formulário',