@ngx-formly/core 7.1.0 → 9.0.0

package/fesm2022/ngx-formly-core.mjs

@@ -1,18 +1,22 @@
 import * as i0 from '@angular/core';
-import { Type, TemplateRef, ComponentRef, ChangeDetectorRef, ɵNoopNgZone as _NoopNgZone, VERSION, Input, ViewChildren, Directive, ChangeDetectionStrategy, Component, Injectable, ViewContainerRef, ViewChild, Optional, InjectionToken, inject, Inject, EventEmitter, ContentChildren, Output, NgModule } from '@angular/core';
+import { Type, TemplateRef, ComponentRef, ChangeDetectorRef, ɵNoopNgZone as _NoopNgZone, VERSION, Input, ViewChildren, Directive, ChangeDetectionStrategy, Component, Injectable, Injector, ViewContainerRef, ViewChild, Optional, InjectionToken, inject, Inject, EventEmitter, ContentChildren, Output, DOCUMENT, NgModule } from '@angular/core';
 import { isObservable, Observable, Subject, of, merge } from 'rxjs';
 import * as i2 from '@angular/forms';
 import { AbstractControl, UntypedFormArray, UntypedFormGroup, FormControl, UntypedFormControl, Validators, NgControl } from '@angular/forms';
-import { tap, map, distinctUntilChanged, startWith, debounceTime, filter, switchMap, take } from 'rxjs/operators';
+import { tap, map, startWith, distinctUntilChanged, skip, debounceTime, filter, switchMap, take } from 'rxjs/operators';
 import * as i1 from '@angular/platform-browser';
 import * as i2$1 from '@angular/common';
-import { DOCUMENT, AsyncPipe, CommonModule } from '@angular/common';
+import { AsyncPipe, CommonModule } from '@angular/common';
 
 function disableTreeValidityCall(form, callback) {
     const _updateTreeValidity = form._updateTreeValidity.bind(form);
     form._updateTreeValidity = () => { };
-    callback();
-    form._updateTreeValidity = _updateTreeValidity;
+    try {
+        callback();
+    }
+    finally {
+        form._updateTreeValidity = _updateTreeValidity;
+    }
 }
 function getFieldId(formId, field, index) {
     if (field.id) {
@@ -490,16 +494,31 @@ let FieldExpressionExtension$1 = class FieldExpressionExtension {
                     return;
                 }
                 checkLocked = true;
-                const fieldChanged = this.checkExpressions(f, ignoreCache);
-                const options = field.options;
-                options._hiddenFieldsForCheck
-                    .sort((f) => (f.field.hide ? -1 : 1))
-                    .forEach((f) => this.changeHideState(f.field, f.field.hide ?? f.default, !ignoreCache));
-                options._hiddenFieldsForCheck = [];
-                if (fieldChanged) {
-                    this.checkExpressions(field);
+                try {
+                    // ponytail: initial-tree budget; add an override if valid dynamic forms need more passes.
+                    const maxPasses = Math.max(100, 2 * this.countFields(field));
+                    const options = field.options;
+                    // Rebuilds preserve supplied values, but defaults may need clearing after visibility changes.
+                    const restoredDefaults = ignoreCache ? new Set() : undefined;
+                    const fieldChanged = this.checkExpressions(f, ignoreCache) || options._hiddenFieldsForCheck.length > 0;
+                    let passes = 0;
+                    do {
+                        if (passes++ === maxPasses) {
+                            console.warn('[Formly] The form may be inconsistent. Check for circular hide expressions');
+                            throw new Error(`[Formly Error] Expressions did not settle after ${maxPasses} passes.`);
+                        }
+                        options._hiddenFieldsForCheck
+                            .sort((f) => (f.field.hide ? -1 : 1))
+                            .forEach((f) => this.changeHideState(f.field, f.field.hide ?? f.default, !ignoreCache, f.emitEvent, restoredDefaults));
+                        options._hiddenFieldsForCheck = [];
+                        if (fieldChanged) {
+                            this.checkExpressions(field);
+                        }
+                    } while (options._hiddenFieldsForCheck.length > 0);
+                }
+                finally {
+                    checkLocked = false;
                 }
-                checkLocked = false;
             };
         }
     }
@@ -547,15 +566,29 @@ let FieldExpressionExtension$1 = class FieldExpressionExtension {
     _evalStringExpression(expression, argNames) {
         return evalStringExpressionLegacy(expression, argNames);
     }
+    countFields(field) {
+        return field ? 1 + (field.fieldGroup?.reduce((count, f) => count + this.countFields(f), 0) ?? 0) : 0;
+    }
     checkExpressions(field, ignoreCache = false) {
         if (!field) {
             return false;
         }
         let fieldChanged = false;
         if (field._expressions) {
+            const hide = field.hide;
             for (const key of Object.keys(field._expressions)) {
                 field._expressions[key].callback?.(ignoreCache) && (fieldChanged = true);
             }
+            if (ignoreCache && field._expressions.hide && hide === false && field.hide === false) {
+                let parent = field.parent;
+                while (parent && !parent.hide) {
+                    parent = parent.parent;
+                }
+                if (!parent) {
+                    // Restore defaults after rebuilding without reporting a visibility change.
+                    field.options._hiddenFieldsForCheck.push({ field, emitEvent: false });
+                }
+            }
         }
         field.fieldGroup?.forEach((f) => this.checkExpressions(f, ignoreCache) && (fieldChanged = true));
         return fieldChanged;
@@ -570,11 +603,12 @@ let FieldExpressionExtension$1 = class FieldExpressionExtension {
             field.props.disabled = value;
         }
     }
-    changeHideState(field, hide, resetOnHide) {
+    changeHideState(field, hide, resetOnHide, emitEvent = true, restoredDefaults) {
+        hide = field.hide || hide;
         if (field.fieldGroup) {
             field.fieldGroup
                 .filter((f) => f && !f._expressions.hide)
-                .forEach((f) => this.changeHideState(f, hide, resetOnHide));
+                .forEach((f) => this.changeHideState(f, hide, resetOnHide, emitEvent, restoredDefaults));
         }
         if (field.formControl && hasKey(field)) {
             defineHiddenProp(field, '_hide', !!(hide || field.hide));
@@ -584,8 +618,9 @@ let FieldExpressionExtension$1 = class FieldExpressionExtension {
             }
             if (hide === true && (!c._fields || c._fields.every((f) => !!f._hide))) {
                 unregisterControl(field, true);
-                if (resetOnHide && field.resetOnHide) {
+                if ((resetOnHide || restoredDefaults?.has(c)) && field.resetOnHide) {
                     assignFieldValue(field, undefined);
+                    restoredDefaults?.delete(c);
                     field.formControl.reset({ value: undefined, disabled: field.formControl.disabled });
                     field.options.fieldChanges.next({ value: undefined, field, type: 'valueChanges' });
                     if (field.fieldGroup && field.formControl instanceof UntypedFormArray) {
@@ -596,6 +631,7 @@ let FieldExpressionExtension$1 = class FieldExpressionExtension {
             else if (hide === false) {
                 if (field.resetOnHide && !isUndefined(field.defaultValue) && isUndefined(getFieldValue(field))) {
                     assignFieldValue(field, field.defaultValue);
+                    restoredDefaults?.add(c);
                 }
                 registerControl(field, undefined, true);
                 if (field.resetOnHide && field.fieldArray && field.fieldGroup?.length !== field.model?.length) {
@@ -603,7 +639,7 @@ let FieldExpressionExtension$1 = class FieldExpressionExtension {
                 }
             }
         }
-        if (field.options.fieldChanges) {
+        if (emitEvent && field.options.fieldChanges) {
             field.options.fieldChanges.next({ field, type: 'hidden', value: hide });
         }
     }
@@ -1594,10 +1630,10 @@ class FieldType {
     get formState() {
         return this.options?.formState || {};
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FieldType, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
-    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "18.2.13", type: FieldType, inputs: { field: "field" }, viewQueries: [{ propertyName: "_formlyControls", predicate: NgControl, descendants: true }], ngImport: i0 }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FieldType, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "20.3.33", type: FieldType, isStandalone: true, inputs: { field: "field" }, viewQueries: [{ propertyName: "_formlyControls", predicate: NgControl, descendants: true }], ngImport: i0 }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FieldType, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FieldType, decorators: [{
             type: Directive
         }], propDecorators: { _formlyControls: [{
                 type: ViewChildren,
@@ -1624,15 +1660,16 @@ class FormlyTemplateType extends FieldType {
         this.sanitizer = sanitizer;
         this.innerHtml = {};
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyTemplateType, deps: [{ token: i1.DomSanitizer }], target: i0.ɵɵFactoryTarget.Component }); }
-    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "18.2.13", type: FormlyTemplateType, selector: "formly-template", usesInheritance: true, ngImport: i0, template: `<div [innerHtml]="template"></div>`, isInline: true, changeDetection: i0.ChangeDetectionStrategy.OnPush }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyTemplateType, deps: [{ token: i1.DomSanitizer }], target: i0.ɵɵFactoryTarget.Component }); }
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.3.33", type: FormlyTemplateType, isStandalone: false, selector: "formly-template", usesInheritance: true, ngImport: i0, template: `<div [innerHtml]="template"></div>`, isInline: true, changeDetection: i0.ChangeDetectionStrategy.OnPush }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyTemplateType, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyTemplateType, decorators: [{
             type: Component,
             args: [{
                     selector: 'formly-template',
                     template: `<div [innerHtml]="template"></div>`,
                     changeDetection: ChangeDetectionStrategy.OnPush,
+                    standalone: false,
                 }]
         }], ctorParameters: () => [{ type: i1.DomSanitizer }] });
 
@@ -1861,10 +1898,10 @@ class FormlyConfig {
             this.types[name].wrappers = extendedType.wrappers;
         }
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyConfig, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyConfig, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyConfig, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyConfig, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyConfig, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyConfig, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
@@ -1876,10 +1913,10 @@ class FormlyTemplate {
     ngOnChanges() {
         this.name = this.name || 'formly-group';
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyTemplate, deps: [{ token: i0.TemplateRef }], target: i0.ɵɵFactoryTarget.Directive }); }
-    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "18.2.13", type: FormlyTemplate, isStandalone: true, selector: "[formlyTemplate]", inputs: { name: ["formlyTemplate", "name"] }, usesOnChanges: true, ngImport: i0 }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyTemplate, deps: [{ token: i0.TemplateRef }], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "20.3.33", type: FormlyTemplate, isStandalone: true, selector: "[formlyTemplate]", inputs: { name: ["formlyTemplate", "name"] }, usesOnChanges: true, ngImport: i0 }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyTemplate, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyTemplate, decorators: [{
             type: Directive,
             args: [{ selector: '[formlyTemplate]', standalone: true }]
         }], ctorParameters: () => [{ type: i0.TemplateRef }], propDecorators: { name: [{
@@ -1887,19 +1924,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImpo
                 args: ['formlyTemplate']
             }] } });
 class LegacyFormlyTemplate extends FormlyTemplate {
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: LegacyFormlyTemplate, deps: null, target: i0.ɵɵFactoryTarget.Directive }); }
-    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "18.2.13", type: LegacyFormlyTemplate, selector: "[formlyTemplate]", usesInheritance: true, ngImport: i0 }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: LegacyFormlyTemplate, deps: null, target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "20.3.33", type: LegacyFormlyTemplate, isStandalone: false, selector: "[formlyTemplate]", usesInheritance: true, ngImport: i0 }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: LegacyFormlyTemplate, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: LegacyFormlyTemplate, decorators: [{
             type: Directive,
             args: [{ selector: '[formlyTemplate]', standalone: false }]
         }] });
 // workarround for https://github.com/angular/angular/issues/43227#issuecomment-904173738
 class FormlyFieldTemplates {
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyFieldTemplates, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyFieldTemplates }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyFieldTemplates, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyFieldTemplates }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyFieldTemplates, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyFieldTemplates, decorators: [{
             type: Injectable
         }] });
 
@@ -1919,11 +1956,12 @@ class FormlyField {
         }
         return null;
     }
-    constructor(config, renderer, _elementRef, hostContainerRef, form) {
+    constructor(config, renderer, _elementRef, hostContainerRef, injector, form) {
         this.config = config;
         this.renderer = renderer;
         this._elementRef = _elementRef;
         this.hostContainerRef = hostContainerRef;
+        this.injector = injector;
         this.form = form;
         this.hostObservers = [];
         this.componentRefs = [];
@@ -1986,7 +2024,7 @@ class FormlyField {
             const inlineType = this.form?.templates?.find((ref) => ref.name === f.type);
             let ref;
             if (inlineType) {
-                ref = containerRef.createEmbeddedView(inlineType.ref, { $implicit: f });
+                ref = containerRef.createEmbeddedView(inlineType.ref, { $implicit: f }, { injector: this.createFieldInjector() });
             }
             else {
                 const { component } = this.config.getType(f.type, true);
@@ -2014,6 +2052,28 @@ class FormlyField {
             this.render();
         }
     }
+    attachLocalField(field, previousField) {
+        const currentField = this.field;
+        if (!currentField) {
+            return;
+        }
+        const localFields = (currentField._localFields || []).filter((f) => f !== field && f !== previousField);
+        if (field && field !== currentField) {
+            localFields.push(field);
+        }
+        if (currentField._localFields) {
+            currentField._localFields = localFields;
+        }
+        else if (localFields.length > 0) {
+            defineHiddenProp(currentField, '_localFields', localFields);
+        }
+    }
+    createFieldInjector() {
+        return Injector.create({
+            providers: [{ provide: FormlyField, useValue: this }],
+            parent: this.injector,
+        });
+    }
     attachComponentRef(ref, field) {
         this.componentRefs.push(ref);
         field._componentRefs.push(ref);
@@ -2123,7 +2183,7 @@ class FormlyField {
         }
         if (field.formControl && !field.fieldGroup) {
             const control = field.formControl;
-            let valueChanges = control.valueChanges.pipe(map((value) => {
+            let valueChanges = control.valueChanges.pipe(startWith(control.value), map((value) => {
                 field.parsers?.map((parserFn) => (value = parserFn(value, field)));
                 if (!Object.is(value, field.formControl.value)) {
                     field.formControl.setValue(value);
@@ -2134,7 +2194,7 @@ class FormlyField {
                     return false;
                 }
                 return true;
-            }));
+            }), skip(1));
             if (control.value !== getFieldValue(field)) {
                 valueChanges = valueChanges.pipe(startWith(control.value));
             }
@@ -2164,13 +2224,13 @@ class FormlyField {
             templateFieldsSubs.forEach((unsubscribe) => unsubscribe());
         };
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyField, deps: [{ token: FormlyConfig }, { token: i0.Renderer2 }, { token: i0.ElementRef }, { token: i0.ViewContainerRef }, { token: FormlyFieldTemplates, optional: true }], target: i0.ɵɵFactoryTarget.Component }); }
-    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "18.2.13", type: FormlyField, isStandalone: true, selector: "formly-field", inputs: { field: "field" }, viewQueries: [{ propertyName: "viewContainerRef", first: true, predicate: ["container"], descendants: true, read: ViewContainerRef, static: true }], usesOnChanges: true, ngImport: i0, template: '<ng-template #container></ng-template>', isInline: true, styles: [":host:empty{display:none}\n"] }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyField, deps: [{ token: FormlyConfig }, { token: i0.Renderer2 }, { token: i0.ElementRef }, { token: i0.ViewContainerRef }, { token: i0.Injector }, { token: FormlyFieldTemplates, optional: true }], target: i0.ɵɵFactoryTarget.Component }); }
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.3.33", type: FormlyField, isStandalone: true, selector: "formly-field", inputs: { field: "field" }, viewQueries: [{ propertyName: "viewContainerRef", first: true, predicate: ["container"], descendants: true, read: ViewContainerRef, static: true }], usesOnChanges: true, ngImport: i0, template: '<ng-template #container></ng-template>', isInline: true, styles: [":host:empty{display:none}\n"] }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyField, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyField, decorators: [{
             type: Component,
             args: [{ selector: 'formly-field', template: '<ng-template #container></ng-template>', standalone: true, styles: [":host:empty{display:none}\n"] }]
-        }], ctorParameters: () => [{ type: FormlyConfig }, { type: i0.Renderer2 }, { type: i0.ElementRef }, { type: i0.ViewContainerRef }, { type: FormlyFieldTemplates, decorators: [{
+        }], ctorParameters: () => [{ type: FormlyConfig }, { type: i0.Renderer2 }, { type: i0.ElementRef }, { type: i0.ViewContainerRef }, { type: i0.Injector }, { type: FormlyFieldTemplates, decorators: [{
                     type: Optional
                 }] }], propDecorators: { field: [{
                 type: Input
@@ -2179,25 +2239,25 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImpo
                 args: ['container', { read: ViewContainerRef, static: true }]
             }] } });
 class LegacyFormlyField extends FormlyField {
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: LegacyFormlyField, deps: null, target: i0.ɵɵFactoryTarget.Component }); }
-    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "18.2.13", type: LegacyFormlyField, selector: "formly-field", usesInheritance: true, ngImport: i0, template: '<ng-template #container></ng-template>', isInline: true, styles: [":host:empty{display:none}\n"] }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: LegacyFormlyField, deps: null, target: i0.ɵɵFactoryTarget.Component }); }
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.3.33", type: LegacyFormlyField, isStandalone: false, selector: "formly-field", usesInheritance: true, ngImport: i0, template: '<ng-template #container></ng-template>', isInline: true, styles: [":host:empty{display:none}\n"] }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: LegacyFormlyField, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: LegacyFormlyField, decorators: [{
             type: Component,
             args: [{ selector: 'formly-field', template: '<ng-template #container></ng-template>', standalone: false, styles: [":host:empty{display:none}\n"] }]
         }] });
 
 /** @ignore */
 class FormlyGroup extends FieldType {
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyGroup, deps: null, target: i0.ɵɵFactoryTarget.Component }); }
-    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "18.2.13", type: FormlyGroup, selector: "formly-group", host: { properties: { "class": "field.fieldGroupClassName || \"\"" } }, usesInheritance: true, ngImport: i0, template: `
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyGroup, deps: null, target: i0.ɵɵFactoryTarget.Component }); }
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "20.3.33", type: FormlyGroup, isStandalone: false, selector: "formly-group", host: { properties: { "class": "field.fieldGroupClassName || \"\"" } }, usesInheritance: true, ngImport: i0, template: `
     @for (f of field.fieldGroup; track $index) {
       <formly-field [field]="f"></formly-field>
     }
     <ng-content></ng-content>
   `, isInline: true, dependencies: [{ kind: "component", type: LegacyFormlyField, selector: "formly-field" }], changeDetection: i0.ChangeDetectionStrategy.OnPush }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyGroup, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyGroup, decorators: [{
             type: Component,
             args: [{
                     selector: 'formly-group',
@@ -2211,6 +2271,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImpo
                         '[class]': 'field.fieldGroupClassName || ""',
                     },
                     changeDetection: ChangeDetectionStrategy.OnPush,
+                    standalone: false,
                 }]
         }] });
 
@@ -2249,6 +2310,7 @@ function withFormlyFieldExpression() {
 }
 const provideFormlyCore = (configs = []) => {
     return [
+        FormlyConfig,
         { provide: FORMLY_CONFIG, multi: true, useFactory: withDefaultConfig, deps: [FormlyConfig] },
         provideFormlyConfig(configs),
     ];
@@ -2262,8 +2324,9 @@ const provideFormlyConfig = (configs = []) => {
                 skipSelf: true,
                 optional: true,
             });
-            if (currentConfig) {
-                currentConfig.push(configs);
+            if (currentConfig && inject(FormlyConfig) === inject(FormlyConfig, { skipSelf: true, optional: true })) {
+                configs = Array.isArray(configs) ? configs : [configs];
+                currentConfig.push(...configs);
                 return currentConfig;
             }
             return configs;
@@ -2345,10 +2408,10 @@ class FormlyFormBuilder {
             }
         }
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyFormBuilder, deps: [{ token: FormlyConfig }, { token: i0.Injector }, { token: i0.ViewContainerRef, optional: true }, { token: i2.FormGroupDirective, optional: true }, { token: FORMLY_CONFIG, optional: true }], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyFormBuilder, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyFormBuilder, deps: [{ token: FormlyConfig }, { token: i0.Injector }, { token: i0.ViewContainerRef, optional: true }, { token: i2.FormGroupDirective, optional: true }, { token: FORMLY_CONFIG, optional: true }], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyFormBuilder, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyFormBuilder, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyFormBuilder, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }], ctorParameters: () => [{ type: FormlyConfig }, { type: i0.Injector }, { type: i0.ViewContainerRef, decorators: [{
@@ -2472,18 +2535,18 @@ class FormlyForm {
             Object.keys(field).forEach((p) => (this.field[p] = field[p]));
         }
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyForm, deps: [{ token: FormlyFormBuilder }, { token: FormlyConfig }, { token: i0.NgZone }, { token: FormlyFieldTemplates }], target: i0.ɵɵFactoryTarget.Component }); }
-    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "18.2.13", type: FormlyForm, isStandalone: true, selector: "formly-form", inputs: { form: "form", model: "model", fields: "fields", options: "options" }, outputs: { modelChange: "modelChange" }, providers: [FormlyFormBuilder, FormlyFieldTemplates], queries: [{ propertyName: "templates", predicate: FormlyTemplate }], usesOnChanges: true, ngImport: i0, template: '<formly-field [field]="field"></formly-field>', isInline: true, dependencies: [{ kind: "component", type: FormlyField, selector: "formly-field", inputs: ["field"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyForm, deps: [{ token: FormlyFormBuilder }, { token: FormlyConfig }, { token: i0.NgZone }, { token: FormlyFieldTemplates }], target: i0.ɵɵFactoryTarget.Component }); }
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.3.33", type: FormlyForm, isStandalone: true, selector: "formly-form", inputs: { form: "form", model: "model", fields: "fields", options: "options" }, outputs: { modelChange: "modelChange" }, providers: [FormlyFormBuilder, FormlyFieldTemplates], queries: [{ propertyName: "templates", predicate: FormlyTemplate }], usesOnChanges: true, ngImport: i0, template: '<formly-field [field]="field"></formly-field>', isInline: true, dependencies: [{ kind: "component", type: FormlyField, selector: "formly-field", inputs: ["field"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyForm, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyForm, decorators: [{
             type: Component,
             args: [{
                     selector: 'formly-form',
                     template: '<formly-field [field]="field"></formly-field>',
                     providers: [FormlyFormBuilder, FormlyFieldTemplates],
+                    standalone: true,
                     imports: [FormlyField],
                     changeDetection: ChangeDetectionStrategy.OnPush,
-                    standalone: true,
                 }]
         }], ctorParameters: () => [{ type: FormlyFormBuilder }, { type: FormlyConfig }, { type: i0.NgZone }, { type: FormlyFieldTemplates }], propDecorators: { form: [{
                 type: Input
@@ -2503,10 +2566,10 @@ class LegacyFormlyForm extends FormlyForm {
     set templates(templates) {
         this.fieldTemplates.templates = templates;
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: LegacyFormlyForm, deps: null, target: i0.ɵɵFactoryTarget.Component }); }
-    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "18.2.13", type: LegacyFormlyForm, selector: "formly-form", providers: [FormlyFormBuilder, FormlyFieldTemplates], queries: [{ propertyName: "templates", predicate: LegacyFormlyTemplate }], usesInheritance: true, ngImport: i0, template: '<formly-field [field]="field"></formly-field>', isInline: true, dependencies: [{ kind: "component", type: LegacyFormlyField, selector: "formly-field" }], changeDetection: i0.ChangeDetectionStrategy.OnPush }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: LegacyFormlyForm, deps: null, target: i0.ɵɵFactoryTarget.Component }); }
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.3.33", type: LegacyFormlyForm, isStandalone: false, selector: "formly-form", providers: [FormlyFormBuilder, FormlyFieldTemplates], queries: [{ propertyName: "templates", predicate: LegacyFormlyTemplate }], usesInheritance: true, ngImport: i0, template: '<formly-field [field]="field"></formly-field>', isInline: true, dependencies: [{ kind: "component", type: LegacyFormlyField, selector: "formly-field" }], changeDetection: i0.ChangeDetectionStrategy.OnPush }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: LegacyFormlyForm, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: LegacyFormlyForm, decorators: [{
             type: Component,
             args: [{
                     selector: 'formly-form',
@@ -2530,9 +2593,10 @@ class FormlyAttributes {
     get fieldAttrElements() {
         return this.field?.['_elementRefs'] || [];
     }
-    constructor(renderer, elementRef, _document) {
+    constructor(renderer, elementRef, _document, formlyField) {
         this.renderer = renderer;
         this.elementRef = elementRef;
+        this.formlyField = formlyField;
         this.uiAttributesCache = {};
         /**
          * HostBinding doesn't register listeners conditionally which may produce some perf issues.
@@ -2580,8 +2644,10 @@ class FormlyAttributes {
                     }
                 });
             }
-            this.detachElementRef(changes.field.previousValue);
+            const previousField = changes.field.previousValue;
+            this.detachElementRef(previousField);
             this.attachElementRef(changes.field.currentValue);
+            this.formlyField?.attachLocalField(changes.field.currentValue, previousField?._elementRefs?.length ? undefined : previousField);
             if (this.fieldAttrElements.length === 1) {
                 !this.id && this.field.id && this.setAttribute('id', this.field.id);
                 this.focusObserver = observe(this.field, ['focus'], ({ currentValue }) => {
@@ -2613,7 +2679,7 @@ class FormlyAttributes {
                 (!this.props.attributes || !this.props.attributes.hasOwnProperty(attr.toLowerCase()))) {
                 this.uiAttributesCache[attr] = value;
                 if (value || value === 0) {
-                    this.setAttribute(attr, value === true ? attr : `${value}`);
+                    this.setAttribute(attr, this.getSafeAttributeValue(attr, value));
                 }
                 else {
                     this.removeAttribute(attr);
@@ -2624,6 +2690,9 @@ class FormlyAttributes {
     ngOnDestroy() {
         this.uiEvents.listeners.forEach((listener) => listener());
         this.detachElementRef(this.field);
+        if (!this.field?._elementRefs?.length) {
+            this.formlyField?.attachLocalField(undefined, this.field);
+        }
         this.focusObserver?.unsubscribe();
     }
     toggleFocus(value) {
@@ -2671,10 +2740,22 @@ class FormlyAttributes {
         }
     }
     detachElementRef(f) {
-        const index = f?.['_elementRefs'] ? this.fieldAttrElements.indexOf(this.elementRef) : -1;
+        const elements = f?.['_elementRefs'] || [];
+        const index = elements.indexOf(this.elementRef);
         if (index !== -1) {
-            f['_elementRefs'].splice(index, 1);
+            elements.splice(index, 1);
+        }
+    }
+    getSafeAttributeValue(attr, value) {
+        if (attr === 'pattern') {
+            let pattern = value instanceof RegExp ? value.source : value;
+            // 1. Safely escape unescaped hyphens inside character classes for 'v' flag compatibility
+            pattern = pattern.replace(/(\[[^\]]*?)(?<!\\)-(.*?\])/g, '$1\\-$2');
+            // 2. Cleanly strip leading ^ and trailing $ so HTML5 handles the boundaries natively
+            pattern = pattern.replace(/^^\^/, '').replace(/\$$/, '');
+            return pattern;
         }
+        return value === true ? attr : `${value}`;
     }
     setAttribute(attr, value) {
         this.renderer.setAttribute(this.elementRef.nativeElement, attr, value);
@@ -2682,10 +2763,10 @@ class FormlyAttributes {
     removeAttribute(attr) {
         this.renderer.removeAttribute(this.elementRef.nativeElement, attr);
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyAttributes, deps: [{ token: i0.Renderer2 }, { token: i0.ElementRef }, { token: DOCUMENT }], target: i0.ɵɵFactoryTarget.Directive }); }
-    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "18.2.13", type: FormlyAttributes, isStandalone: true, selector: "[formlyAttributes]", inputs: { field: ["formlyAttributes", "field"], id: "id" }, host: { listeners: { "change": "onHostChange($event)" } }, usesOnChanges: true, ngImport: i0 }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyAttributes, deps: [{ token: i0.Renderer2 }, { token: i0.ElementRef }, { token: DOCUMENT }, { token: FormlyField, optional: true }], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "20.3.33", type: FormlyAttributes, isStandalone: true, selector: "[formlyAttributes]", inputs: { field: ["formlyAttributes", "field"], id: "id" }, host: { listeners: { "change": "onHostChange($event)" } }, usesOnChanges: true, ngImport: i0 }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyAttributes, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyAttributes, decorators: [{
             type: Directive,
             args: [{
                     selector: '[formlyAttributes]',
@@ -2697,6 +2778,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImpo
         }], ctorParameters: () => [{ type: i0.Renderer2 }, { type: i0.ElementRef }, { type: undefined, decorators: [{
                     type: Inject,
                     args: [DOCUMENT]
+                }] }, { type: FormlyField, decorators: [{
+                    type: Optional
                 }] }], propDecorators: { field: [{
                 type: Input,
                 args: ['formlyAttributes']
@@ -2704,16 +2787,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImpo
                 type: Input
             }] } });
 class LegacyFormlyAttributes extends FormlyAttributes {
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: LegacyFormlyAttributes, deps: null, target: i0.ɵɵFactoryTarget.Directive }); }
-    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "18.2.13", type: LegacyFormlyAttributes, selector: "[formlyAttributes]", host: { listeners: { "change": "onHostChange($event)" } }, usesInheritance: true, ngImport: i0 }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: LegacyFormlyAttributes, deps: null, target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "20.3.33", type: LegacyFormlyAttributes, isStandalone: false, selector: "[formlyAttributes]", host: { listeners: { "change": "onHostChange($event)" } }, usesInheritance: true, ngImport: i0 }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: LegacyFormlyAttributes, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: LegacyFormlyAttributes, decorators: [{
             type: Directive,
             args: [{
                     selector: '[formlyAttributes]',
                     host: {
                         '(change)': 'onHostChange($event)',
                     },
+                    standalone: false,
                 }]
         }] });
 
@@ -2764,10 +2848,10 @@ class FormlyValidationMessage {
         }
         return undefined;
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyValidationMessage, deps: [{ token: FormlyConfig }], target: i0.ɵɵFactoryTarget.Component }); }
-    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "18.2.13", type: FormlyValidationMessage, isStandalone: true, selector: "formly-validation-message", inputs: { field: "field" }, usesOnChanges: true, ngImport: i0, template: '{{ errorMessage$ | async }}', isInline: true, dependencies: [{ kind: "pipe", type: AsyncPipe, name: "async" }], changeDetection: i0.ChangeDetectionStrategy.OnPush }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyValidationMessage, deps: [{ token: FormlyConfig }], target: i0.ɵɵFactoryTarget.Component }); }
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.3.33", type: FormlyValidationMessage, isStandalone: true, selector: "formly-validation-message", inputs: { field: "field" }, usesOnChanges: true, ngImport: i0, template: '{{ errorMessage$ | async }}', isInline: true, dependencies: [{ kind: "pipe", type: AsyncPipe, name: "async" }], changeDetection: i0.ChangeDetectionStrategy.OnPush }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyValidationMessage, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyValidationMessage, decorators: [{
             type: Component,
             args: [{
                     selector: 'formly-validation-message',
@@ -2780,15 +2864,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImpo
                 type: Input
             }] } });
 class LegacyFormlyValidationMessage extends FormlyValidationMessage {
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: LegacyFormlyValidationMessage, deps: null, target: i0.ɵɵFactoryTarget.Component }); }
-    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "18.2.13", type: LegacyFormlyValidationMessage, selector: "formly-validation-message", usesInheritance: true, ngImport: i0, template: '{{ errorMessage$ | async }}', isInline: true, dependencies: [{ kind: "pipe", type: i2$1.AsyncPipe, name: "async" }], changeDetection: i0.ChangeDetectionStrategy.OnPush }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: LegacyFormlyValidationMessage, deps: null, target: i0.ɵɵFactoryTarget.Component }); }
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.3.33", type: LegacyFormlyValidationMessage, isStandalone: false, selector: "formly-validation-message", usesInheritance: true, ngImport: i0, template: '{{ errorMessage$ | async }}', isInline: true, dependencies: [{ kind: "pipe", type: i2$1.AsyncPipe, name: "async" }], changeDetection: i0.ChangeDetectionStrategy.OnPush }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: LegacyFormlyValidationMessage, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: LegacyFormlyValidationMessage, decorators: [{
             type: Component,
             args: [{
                     selector: 'formly-validation-message',
                     template: '{{ errorMessage$ | async }}',
                     changeDetection: ChangeDetectionStrategy.OnPush,
+                    standalone: false,
                 }]
         }] });
 
@@ -2863,10 +2948,10 @@ class FieldArrayType extends FieldType {
             this.options._hiddenFieldsForCheck.push({ field: f });
         }
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FieldArrayType, deps: null, target: i0.ɵɵFactoryTarget.Directive }); }
-    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "18.2.13", type: FieldArrayType, usesInheritance: true, ngImport: i0 }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FieldArrayType, deps: null, target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "20.3.33", type: FieldArrayType, isStandalone: true, usesInheritance: true, ngImport: i0 }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FieldArrayType, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FieldArrayType, decorators: [{
             type: Directive
         }] });
 
@@ -2875,10 +2960,10 @@ class FieldWrapper extends FieldType {
     set _staticContent(content) {
         this.fieldComponent = content;
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FieldWrapper, deps: null, target: i0.ɵɵFactoryTarget.Directive }); }
-    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "18.2.13", type: FieldWrapper, viewQueries: [{ propertyName: "fieldComponent", first: true, predicate: ["fieldComponent"], descendants: true, read: ViewContainerRef }, { propertyName: "_staticContent", first: true, predicate: ["fieldComponent"], descendants: true, read: ViewContainerRef, static: true }], usesInheritance: true, ngImport: i0 }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FieldWrapper, deps: null, target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "20.3.33", type: FieldWrapper, isStandalone: true, viewQueries: [{ propertyName: "fieldComponent", first: true, predicate: ["fieldComponent"], descendants: true, read: ViewContainerRef }, { propertyName: "_staticContent", first: true, predicate: ["fieldComponent"], descendants: true, read: ViewContainerRef, static: true }], usesInheritance: true, ngImport: i0 }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FieldWrapper, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FieldWrapper, decorators: [{
             type: Directive
         }], propDecorators: { fieldComponent: [{
                 type: ViewChild,
@@ -2888,6 +2973,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImpo
                 args: ['fieldComponent', { read: ViewContainerRef, static: true }]
             }] } });
 
+/**
+ * Registers Formly components and configuration for NgModule-based applications.
+ *
+ * `forRoot()` provides the shared `FormlyConfig` at the application root, while
+ * `forChild()` adds feature configuration using the inherited service. This follows
+ * Angular's [root/child module registration convention](https://frontendatlas.com/angular/trivia/angular-forroot-forchild).
+ */
 class FormlyModule {
     static forRoot(config = {}) {
         return {
@@ -2910,8 +3002,8 @@ class FormlyModule {
             ],
         };
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
-    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "18.2.13", ngImport: i0, type: FormlyModule, declarations: [LegacyFormlyTemplate,
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
+    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "20.3.33", ngImport: i0, type: FormlyModule, declarations: [LegacyFormlyTemplate,
             LegacyFormlyForm,
             LegacyFormlyField,
             LegacyFormlyAttributes,
@@ -2923,9 +3015,9 @@ class FormlyModule {
             LegacyFormlyAttributes,
             LegacyFormlyValidationMessage,
             FormlyGroup] }); }
-    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyModule, imports: [CommonModule] }); }
+    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyModule, imports: [CommonModule] }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.13", ngImport: i0, type: FormlyModule, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.33", ngImport: i0, type: FormlyModule, decorators: [{
             type: NgModule,
             args: [{
                     declarations: [