@dynamic-field-kit/angular 1.2.10 → 1.4.0

package/dist/fesm2022/dynamic-field-kit-angular.mjs

@@ -1,8 +1,9 @@
 import * as i0 from '@angular/core';
-import { EventEmitter, Output, Input, Component, SimpleChange, ViewContainerRef, ViewChild, NgModule } from '@angular/core';
+import { EventEmitter, Output, Input, Component, InjectionToken, inject, ViewContainerRef, ViewChild, ChangeDetectionStrategy, HostListener, NgModule } from '@angular/core';
+import * as i1 from '@angular/common';
 import { CommonModule, NgIf, NgClass, NgFor } from '@angular/common';
-import { fieldRegistry } from '@dynamic-field-kit/core';
-export { fieldRegistry } from '@dynamic-field-kit/core';
+import { fieldRegistry, applyComputedValues, validateFields, resolveOptions, resolveDisabled, resolveReadOnly, validateField, canAddGroupItem, canRemoveGroupItem, createGroupItem } from '@dynamic-field-kit/core';
+export { FieldRegistry, fieldRegistry, resolveDisabled, resolveOptions, resolveReadOnly, validateField, validateFieldAsync, validateFields, validateFieldsAsync, validators } from '@dynamic-field-kit/core';
 
 class BaseInputComponent {
     cdr;
@@ -11,21 +12,26 @@ class BaseInputComponent {
     placeholder;
     required;
     disabled;
+    readOnly;
+    error;
     options;
     className;
     description;
-    errorMessage;
-    acceptFile;
-    maxLength;
-    minNumber;
-    maxNumber;
-    // Add more from mplis as needed
     valueChange = new EventEmitter();
     constructor(cdr) {
         this.cdr = cdr;
     }
+    ngOnChanges(_changes) {
+        this.detectChanges();
+    }
+    detectChanges() {
+        this.cdr.markForCheck();
+    }
+    hasChanges(changes, prop) {
+        return changes[prop] !== undefined;
+    }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.20", ngImport: i0, type: BaseInputComponent, deps: [{ token: i0.ChangeDetectorRef }], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "19.2.20", type: BaseInputComponent, isStandalone: true, selector: "ng-component", inputs: { value: "value", label: "label", placeholder: "placeholder", required: "required", disabled: "disabled", options: "options", className: "className", description: "description", errorMessage: "errorMessage", acceptFile: "acceptFile", maxLength: "maxLength", minNumber: "minNumber", maxNumber: "maxNumber" }, outputs: { valueChange: "valueChange" }, ngImport: i0, template: '', isInline: true });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "19.2.20", type: BaseInputComponent, isStandalone: true, selector: "ng-component", inputs: { value: "value", label: "label", placeholder: "placeholder", required: "required", disabled: "disabled", readOnly: "readOnly", error: "error", options: "options", className: "className", description: "description" }, outputs: { valueChange: "valueChange" }, usesOnChanges: true, ngImport: i0, template: '', isInline: true });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.20", ngImport: i0, type: BaseInputComponent, decorators: [{
             type: Component,
@@ -42,49 +48,72 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.20", ngImpo
                 type: Input
             }], disabled: [{
                 type: Input
+            }], readOnly: [{
+                type: Input
+            }], error: [{
+                type: Input
             }], options: [{
                 type: Input
             }], className: [{
                 type: Input
             }], description: [{
                 type: Input
-            }], errorMessage: [{
-                type: Input
-            }], acceptFile: [{
-                type: Input
-            }], maxLength: [{
-                type: Input
-            }], minNumber: [{
-                type: Input
-            }], maxNumber: [{
-                type: Input
             }], valueChange: [{
                 type: Output
             }] } });
 
+// Injecting this token yields the process-wide singleton by default, so code
+// that never provides it keeps working. Provide it on a component/route to give
+// that subtree an isolated set of renderers:
+//
+//   providers: [{ provide: FIELD_REGISTRY, useValue: myScopedRegistry }]
+const FIELD_REGISTRY = new InjectionToken('dfk.FieldRegistry', {
+    providedIn: 'root',
+    factory: () => fieldRegistry,
+});
+
+// Only the framework-agnostic FieldRendererProps keys. Domain-specific props
+// reach the renderer through `extraProps` (FieldDescription.props) instead.
+const KNOWN_PROPS = [
+    'value',
+    'label',
+    'placeholder',
+    'required',
+    'disabled',
+    'readOnly',
+    'error',
+    'options',
+    'className',
+    'description',
+];
 class DynamicInput extends BaseInputComponent {
     type;
+    // Extra, framework-agnostic props forwarded verbatim to the renderer.
+    extraProps;
     valueChange = new EventEmitter();
-    onChange = new EventEmitter(); // backward compat
+    onChange = new EventEmitter();
+    registry = inject(FIELD_REGISTRY);
     host;
     compRef;
     inputInstance;
     subscriptions = [];
+    // Tracks which KNOWN_PROPS were actually supplied to DynamicInput (via
+    // SimpleChanges), independent of TS class-field emit. See applyProps.
+    supplied = new Set();
     ngOnChanges(changes) {
-        if (changes['type'] && !changes['type'].firstChange && this.host) {
-            this.render();
-            return;
+        super.ngOnChanges(changes);
+        for (const prop of KNOWN_PROPS) {
+            if (changes[prop]) {
+                this.supplied.add(prop);
+            }
         }
         if (this.inputInstance) {
-            this.applyKnownProps(this.inputInstance);
-            const childChanges = {};
-            for (const prop in changes) {
-                childChanges[prop] = new SimpleChange(changes[prop].previousValue, changes[prop].currentValue, changes[prop].firstChange);
-            }
-            this.inputInstance.ngOnChanges?.(childChanges);
-            this.compRef?.changeDetectorRef.detectChanges();
+            this.syncPropsToInstance(changes);
         }
-        else if (this.host) {
+        if (changes['type'] && !changes['type'].firstChange && this.host) {
+            this.render();
+        }
+        else if (!this.inputInstance && this.host) {
             this.render();
         }
     }
@@ -92,6 +121,23 @@ class DynamicInput extends BaseInputComponent {
         this.render();
     }
     ngOnDestroy() {
+        this.cleanup();
+    }
+    syncPropsToInstance(changes) {
+        if (!this.inputInstance) {
+            return;
+        }
+        for (const prop of KNOWN_PROPS) {
+            if (changes[prop] && this.inputInstance) {
+                this.inputInstance[prop] = this[prop];
+            }
+        }
+        if (changes['extraProps']) {
+            this.applyExtraProps(this.inputInstance);
+        }
+        this.compRef?.changeDetectorRef?.detectChanges();
+    }
+    cleanup() {
         this.cleanupSubscriptions();
         this.cleanupRenderedComponent();
     }
@@ -99,106 +145,149 @@ class DynamicInput extends BaseInputComponent {
         this.subscriptions.forEach((s) => s.unsubscribe());
         this.subscriptions = [];
     }
+    cleanupRenderedComponent() {
+        this.compRef?.destroy();
+        this.compRef = undefined;
+        this.inputInstance = undefined;
+    }
     render() {
-        const Renderer = fieldRegistry.get(this.type);
-        this.cleanupRenderedComponent();
-        this.cleanupSubscriptions();
+        const Renderer = this.registry.get(this.type);
+        this.cleanup();
         this.host.clear();
         if (!Renderer) {
-            const el = document.createElement('div');
-            el.textContent = `Unknown field type: ${this.type}`;
-            this.host.element.nativeElement.appendChild(el);
+            this.renderError(`Unknown field type: ${this.type}`);
             return;
         }
+        if (this.isComponentType(Renderer)) {
+            this.renderComponent(Renderer);
+        }
+        else if (typeof Renderer === 'function') {
+            this.renderFallback(Renderer);
+        }
+        else {
+            this.renderError(`Invalid renderer for type: ${this.type}`);
+        }
+    }
+    // Angular component classes carry a static ɵcmp. Checked instead of
+    // reflectComponentType() because the peer range starts at Angular 13 and
+    // reflectComponentType is v14+. Plain function renderers have no ɵcmp and
+    // fall through to renderFallback. Uses hasOwnProperty (not `in`) so a
+    // class that merely extends a component without its own @Component
+    // decorator - and would otherwise inherit the parent's static ɵcmp via the
+    // prototype chain - is not mistaken for a component in its own right.
+    isComponentType(renderer) {
+        return (typeof renderer === 'function' &&
+            Object.prototype.hasOwnProperty.call(renderer, 'ɵcmp'));
+    }
+    renderComponent(compType) {
         try {
-            const compType = Renderer;
             const compRef = this.host.createComponent(compType);
             const instance = compRef.instance;
             if (!instance) {
-                throw new Error(`Failed to create instance for ${this.type}`);
-            }
-            this.applyKnownProps(instance);
-            const subA = this.bindOutput(instance, 'valueChange');
-            if (subA) {
-                this.subscriptions.push(subA);
+                this.renderError(`Failed to create instance for ${this.type}`);
+                return;
             }
-            const subB = this.bindOutput(instance, 'onValueChange');
-            if (subB) {
-                this.subscriptions.push(subB);
-            }
-            instance.changeDetectorRef?.detectChanges();
+            this.applyProps(instance);
+            this.bindOutputs(instance);
             this.compRef = compRef;
             this.inputInstance = instance;
             compRef.changeDetectorRef.detectChanges();
         }
-        catch (err) {
-            // Fallback to function renderer
-            try {
-                const props = {
-                    value: this.value,
-                    onValueChange: (v) => this.emitValue(v),
-                    label: this.label,
-                    placeholder: this.placeholder,
-                    required: this.required,
-                    options: this.options,
-                    className: this.className,
-                    description: this.description,
-                    disabled: this.disabled,
-                    errorMessage: this.errorMessage,
-                };
-                const out = Renderer(props);
-                if (typeof out === 'string') {
-                    const el = document.createElement('div');
-                    el.innerHTML = out;
-                    this.host.element.nativeElement.appendChild(el);
-                }
-            }
-            catch (e) {
+        catch {
+            this.renderError(`Failed to render field: ${this.type}`);
+        }
+    }
+    renderFallback(renderer) {
+        try {
+            const props = this.getFallbackProps();
+            const result = renderer(props);
+            if (typeof result === 'string') {
                 const el = document.createElement('div');
-                el.textContent = `Failed to render field: ${this.type}`;
+                el.innerHTML = result;
                 this.host.element.nativeElement.appendChild(el);
             }
         }
+        catch {
+            this.renderError(`Failed to render field: ${this.type}`);
+        }
     }
-    applyKnownProps(instance) {
-        const knownProps = [
-            'value',
-            'label',
-            'placeholder',
-            'required',
-            'disabled',
-            'options',
-            'className',
-            'description',
-            'errorMessage',
-        ];
-        for (const prop of knownProps) {
-            if (prop in this && prop in instance) {
-                instance[prop] = this[prop];
+    getFallbackProps() {
+        return {
+            ...this.extraProps,
+            value: this.value,
+            onValueChange: (v) => this.emitValue(v),
+            label: this.label ?? '',
+            placeholder: this.placeholder ?? '',
+            required: this.required ?? false,
+            disabled: this.disabled ?? false,
+            readOnly: this.readOnly ?? false,
+            error: this.error,
+            options: this.options ?? [],
+            className: this.className ?? '',
+            description: this.description ?? '',
+        };
+    }
+    // Gates on `this.supplied` (populated from SimpleChanges in ngOnChanges),
+    // not on `prop in instanceObj` or `prop in this`. Both `in` checks test a
+    // TypeScript class-field emit artifact rather than intent: whether a
+    // property slot exists at runtime depends on the compile target
+    // (useDefineForClassFields is false below ES2022, true at ES2022+), so the
+    // same source can behave oppositely between this package's test build and
+    // its shipped ES2022 bundle, where every declared field is always an own
+    // property. `this.supplied` instead reflects only whether Angular ever
+    // fired a SimpleChange for that input, i.e. whether the prop was *bound*
+    // at all - it skips only props DynamicInput was never given a binding
+    // for. It is NOT a general "renderer defaults survive" guarantee: Angular
+    // fires a firstChange SimpleChange for every bound input even when the
+    // bound value is undefined, and FieldInput's template binds all
+    // KNOWN_PROPS unconditionally, so on the real
+    // MultiFieldInput -> FieldInput -> DynamicInput path every prop counts as
+    // supplied and renderer-side defaults (e.g. `@Input() label = 'None'`)
+    // are still overwritten with undefined. This only helps when DynamicInput
+    // is mounted directly with some inputs left unbound.
+    applyProps(instance) {
+        const instanceObj = instance;
+        for (const prop of KNOWN_PROPS) {
+            if (this.supplied.has(prop)) {
+                instanceObj[prop] = this[prop];
             }
         }
+        this.applyExtraProps(instance);
     }
-    bindOutput(instance, outputName) {
-        const output = instance?.[outputName];
-        if (!output || typeof output.subscribe !== 'function') {
+    applyExtraProps(instance) {
+        if (!instance || !this.extraProps) {
             return;
         }
-        const sub = output.subscribe((value) => {
-            this.emitValue(value);
-        });
-        return sub;
+        const instanceObj = instance;
+        for (const [key, value] of Object.entries(this.extraProps)) {
+            instanceObj[key] = value;
+        }
+    }
+    bindOutputs(instance) {
+        const outputNames = [
+            'valueChange',
+            'onValueChange',
+        ];
+        for (const outputName of outputNames) {
+            const output = instance[outputName];
+            if (output && typeof output === 'object' && 'subscribe' in output) {
+                const sub = output.subscribe((value) => this.emitValue(value));
+                this.subscriptions.push(sub);
+            }
+        }
     }
     emitValue(value) {
         this.valueChange.emit(value);
         this.onChange.emit(value);
     }
-    cleanupRenderedComponent() {
-        this.compRef?.destroy();
-        this.compRef = undefined;
-        this.inputInstance = undefined;
+    renderError(message) {
+        const el = document.createElement('div');
+        el.textContent = message;
+        el.style.color = 'red';
+        this.host.element.nativeElement.appendChild(el);
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.20", ngImport: i0, type: DynamicInput, deps: null, target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "19.2.20", type: DynamicInput, isStandalone: true, selector: "dfk-dynamic-input", inputs: { type: "type" }, outputs: { valueChange: "valueChange", onChange: "onChange" }, viewQueries: [{ propertyName: "host", first: true, predicate: ["host"], descendants: true, read: ViewContainerRef }], usesInheritance: true, usesOnChanges: true, ngImport: i0, template: `<div #host style="display: contents;"></div>`, isInline: true, dependencies: [{ kind: "ngmodule", type: CommonModule }] });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "19.2.20", type: DynamicInput, isStandalone: true, selector: "dfk-dynamic-input", inputs: { type: "type", extraProps: "extraProps" }, outputs: { valueChange: "valueChange", onChange: "onChange" }, viewQueries: [{ propertyName: "host", first: true, predicate: ["host"], descendants: true, read: ViewContainerRef }], usesInheritance: true, usesOnChanges: true, ngImport: i0, template: `<div #host style="display: contents;"></div>`, isInline: true, dependencies: [{ kind: "ngmodule", type: CommonModule }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.20", ngImport: i0, type: DynamicInput, decorators: [{
             type: Component,
@@ -206,10 +295,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.20", ngImpo
                     selector: 'dfk-dynamic-input',
                     standalone: true,
                     imports: [CommonModule],
+                    changeDetection: ChangeDetectionStrategy.OnPush,
                     template: `<div #host style="display: contents;"></div>`,
                 }]
         }], propDecorators: { type: [{
                 type: Input
+            }], extraProps: [{
+                type: Input
             }], valueChange: [{
                 type: Output
             }], onChange: [{
@@ -220,38 +312,55 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.20", ngImpo
             }] } });
 
 class FieldInput {
+    cdr;
     fieldDescription;
-    renderInfos;
+    value;
+    options;
+    disabled;
+    readOnly;
+    error;
     onValueChangeField = new EventEmitter();
-    getFieldValue() {
-        if (!this.fieldDescription || !this.renderInfos) {
+    shouldRender = false;
+    get resolvedOptions() {
+        if (this.options) {
+            return this.options;
+        }
+        if (!this.fieldDescription?.options) {
             return undefined;
         }
-        const value = this.renderInfos[this.fieldDescription.name];
-        if (value === undefined && this.fieldDescription.type === 'text') {
-            return '';
+        if (typeof this.fieldDescription.options === 'function') {
+            return undefined;
         }
-        return value;
+        return this.fieldDescription.options;
+    }
+    constructor(cdr) {
+        this.cdr = cdr;
+    }
+    ngOnChanges(_changes) {
+        this.shouldRender = !!this.fieldDescription;
+        this.cdr.markForCheck();
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.20", ngImport: i0, type: FieldInput, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "19.2.20", type: FieldInput, isStandalone: true, selector: "dfk-field-input", inputs: { fieldDescription: "fieldDescription", renderInfos: "renderInfos" }, outputs: { onValueChangeField: "onValueChangeField" }, ngImport: i0, template: `
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.20", ngImport: i0, type: FieldInput, deps: [{ token: i0.ChangeDetectorRef }], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "19.2.20", type: FieldInput, isStandalone: true, selector: "dfk-field-input", inputs: { fieldDescription: "fieldDescription", value: "value", options: "options", disabled: "disabled", readOnly: "readOnly", error: "error" }, outputs: { onValueChangeField: "onValueChangeField" }, usesOnChanges: true, ngImport: i0, template: `
     <dfk-dynamic-input
-      *ngIf="fieldDescription && renderInfos"
+      *ngIf="shouldRender"
       [type]="fieldDescription!.type"
-      [value]="getFieldValue()"
+      [value]="value"
       [label]="fieldDescription!.label"
       [placeholder]="fieldDescription!.placeholder"
       [required]="fieldDescription!.required"
-      [description]="fieldDescription!.description"
-      [options]="fieldDescription!.options"
+      [description]="$any(fieldDescription!.description)"
+      [options]="resolvedOptions"
       [className]="fieldDescription!.className"
       (valueChange)="
         onValueChangeField.emit({ value: $event, key: fieldDescription!.name })
       "
-      [disabled]="false"
-      [errorMessage]="''"
+      [disabled]="disabled"
+      [readOnly]="readOnly"
+      [error]="$any(error)"
+      [extraProps]="fieldDescription!.props"
     ></dfk-dynamic-input>
-  `, isInline: true, dependencies: [{ kind: "directive", type: NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }, { kind: "component", type: DynamicInput, selector: "dfk-dynamic-input", inputs: ["type"], outputs: ["valueChange", "onChange"] }] });
+  `, isInline: true, dependencies: [{ kind: "directive", type: NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }, { kind: "component", type: DynamicInput, selector: "dfk-dynamic-input", inputs: ["type", "extraProps"], outputs: ["valueChange", "onChange"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.20", ngImport: i0, type: FieldInput, decorators: [{
             type: Component,
@@ -259,121 +368,405 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.20", ngImpo
                     selector: 'dfk-field-input',
                     standalone: true,
                     imports: [NgIf, DynamicInput],
+                    changeDetection: ChangeDetectionStrategy.OnPush,
                     template: `
     <dfk-dynamic-input
-      *ngIf="fieldDescription && renderInfos"
+      *ngIf="shouldRender"
       [type]="fieldDescription!.type"
-      [value]="getFieldValue()"
+      [value]="value"
       [label]="fieldDescription!.label"
       [placeholder]="fieldDescription!.placeholder"
       [required]="fieldDescription!.required"
-      [description]="fieldDescription!.description"
-      [options]="fieldDescription!.options"
+      [description]="$any(fieldDescription!.description)"
+      [options]="resolvedOptions"
       [className]="fieldDescription!.className"
       (valueChange)="
         onValueChangeField.emit({ value: $event, key: fieldDescription!.name })
       "
-      [disabled]="false"
-      [errorMessage]="''"
+      [disabled]="disabled"
+      [readOnly]="readOnly"
+      [error]="$any(error)"
+      [extraProps]="fieldDescription!.props"
     ></dfk-dynamic-input>
   `,
                 }]
-        }], propDecorators: { fieldDescription: [{
+        }], ctorParameters: () => [{ type: i0.ChangeDetectorRef }], propDecorators: { fieldDescription: [{
                 type: Input
-            }], renderInfos: [{
+            }], value: [{
+                type: Input
+            }], options: [{
+                type: Input
+            }], disabled: [{
+                type: Input
+            }], readOnly: [{
+                type: Input
+            }], error: [{
                 type: Input
             }], onValueChangeField: [{
                 type: Output
             }] } });
 
+const DEFAULT_BREAKPOINT = 768;
 class MultiFieldInput {
+    cdr;
     fieldDescriptions = [];
     properties;
     onChange = new EventEmitter();
+    validityChange = new EventEmitter();
     layout = 'column';
+    // Top-level form data, threaded down through repeatable groups so a nested
+    // field's appearCondition/computeValue can read the root form. Omitted at
+    // the top level, where the form's own data is the root.
+    rootData;
     data = {};
     visibleFields = [];
+    isMobile = false;
+    constructor(cdr) {
+        this.cdr = cdr;
+    }
+    onWindowResize() {
+        const wasMobile = this.isMobile;
+        this.updateIsMobile();
+        if (wasMobile !== this.isMobile) {
+            this.cdr.markForCheck();
+        }
+    }
+    get resolvedLayout() {
+        if (typeof this.layout === 'object' && this.layout.type === 'responsive') {
+            return this.isMobile ? this.layout.mobile : this.layout.desktop;
+        }
+        return this.layout;
+    }
+    get resolvedLayoutType() {
+        const resolved = this.resolvedLayout;
+        return typeof resolved === 'string' ? resolved : resolved.type;
+    }
+    get gap() {
+        const resolved = this.resolvedLayout;
+        if (typeof resolved === 'object' && resolved.gap !== undefined) {
+            return resolved.gap;
+        }
+        return 12;
+    }
+    get columns() {
+        const resolved = this.resolvedLayout;
+        if (typeof resolved === 'object' && resolved.type === 'grid') {
+            return resolved.columns ?? 2;
+        }
+        return 2;
+    }
     trackByFn(index, field) {
         return field.name || index;
     }
+    trackByIndex(index) {
+        return index;
+    }
+    groupTrackByCache = new WeakMap();
+    // Returns a stable trackBy per group field: item[keyField] when configured,
+    // else the index. Cached by field reference so the template hands Angular the
+    // same function each change-detection pass.
+    groupTrackBy(field) {
+        let fn = this.groupTrackByCache.get(field);
+        if (!fn) {
+            fn = (index, item) => field.keyField ? item[field.keyField] ?? index : index;
+            this.groupTrackByCache.set(field, fn);
+        }
+        return fn;
+    }
     ngOnInit() {
+        this.updateIsMobile();
         this.init();
     }
     ngOnChanges(_changes) {
         this.init();
     }
+    updateIsMobile() {
+        const breakpoint = typeof this.layout === 'object' && this.layout.type === 'responsive'
+            ? this.layout.breakpoint ?? DEFAULT_BREAKPOINT
+            : DEFAULT_BREAKPOINT;
+        if (typeof window !== 'undefined' &&
+            typeof window.matchMedia === 'function') {
+            this.isMobile = window.matchMedia(`(max-width: ${breakpoint - 1}px)`).matches;
+        }
+        else {
+            this.isMobile =
+                typeof window !== 'undefined' && window.innerWidth < breakpoint;
+        }
+    }
     init() {
         if (this.properties) {
-            this.data = { ...this.properties };
+            this.data = applyComputedValues(this.fieldDescriptions, { ...this.properties }, this.rootData);
         }
         this.updateVisibleFields();
+        this.validityChange.emit(validateFields(this.fieldDescriptions, this.data, this.rootData));
     }
     updateVisibleFields() {
-        this.visibleFields = this.fieldDescriptions.filter((f) => !f.appearCondition || f.appearCondition(this.data));
+        const root = this.rootData ?? this.data;
+        this.visibleFields = this.fieldDescriptions.filter((f) => !f.appearCondition || f.appearCondition(this.data, root));
     }
     onFieldChange(event) {
-        this.data = { ...this.data, [event.key]: event.value };
+        this.commitData({ ...this.data, [event.key]: event.value });
+    }
+    getItems(field) {
+        const value = this.data[field.name];
+        return Array.isArray(value) ? value : [];
+    }
+    getResolvedOptions(field) {
+        return resolveOptions(field, this.data, this.rootData);
+    }
+    getDisabled(field) {
+        return resolveDisabled(field, this.data, this.rootData);
+    }
+    getReadOnly(field) {
+        return resolveReadOnly(field, this.data, this.rootData);
+    }
+    getError(field) {
+        if (this.getDisabled(field)) {
+            return undefined;
+        }
+        const errors = validateField(field, this.data[field.name], this.data, this.rootData);
+        return errors.length > 0 ? errors : undefined;
+    }
+    canAddItem(field) {
+        return canAddGroupItem(field, this.getItems(field));
+    }
+    canRemoveItem(field) {
+        return canRemoveGroupItem(field, this.getItems(field));
+    }
+    onGroupItemAdd(field) {
+        if (!this.canAddItem(field)) {
+            return;
+        }
+        const items = this.getItems(field);
+        this.commitData({
+            ...this.data,
+            [field.name]: [...items, createGroupItem(field)],
+        });
+    }
+    onGroupItemRemove(field, index) {
+        if (!this.canRemoveItem(field)) {
+            return;
+        }
+        const items = this.getItems(field).filter((_, i) => i !== index);
+        this.commitData({ ...this.data, [field.name]: items });
+    }
+    onGroupItemChange(field, index, next) {
+        const items = this.getItems(field).slice();
+        items[index] = next;
+        this.commitData({ ...this.data, [field.name]: items });
+    }
+    commitData(nextData) {
+        this.data = applyComputedValues(this.fieldDescriptions, nextData, this.rootData);
         this.updateVisibleFields();
         this.onChange.emit(this.data);
+        this.validityChange.emit(validateFields(this.fieldDescriptions, this.data, this.rootData));
+        this.cdr.markForCheck();
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.20", ngImport: i0, type: MultiFieldInput, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "19.2.20", type: MultiFieldInput, isStandalone: true, selector: "dfk-multi-field-input", inputs: { fieldDescriptions: "fieldDescriptions", properties: "properties", layout: "layout" }, outputs: { onChange: "onChange" }, usesOnChanges: true, ngImport: i0, template: `
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.20", ngImport: i0, type: MultiFieldInput, deps: [{ token: i0.ChangeDetectorRef }], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "19.2.20", type: MultiFieldInput, isStandalone: true, selector: "dfk-multi-field-input", inputs: { fieldDescriptions: "fieldDescriptions", properties: "properties", layout: "layout", rootData: "rootData" }, outputs: { onChange: "onChange", validityChange: "validityChange" }, host: { listeners: { "window:resize": "onWindowResize()" } }, usesOnChanges: true, ngImport: i0, template: `
     <div
-      class="flex flex-col gap-3 p-4 border rounded-lg bg-gray-50"
+      class="p-4 border rounded-lg bg-gray-50"
       [ngClass]="{
-        'flex-row gap-3': layout === 'row',
-        'grid grid-cols-2 gap-3': layout === 'grid'
+        'flex flex-col': resolvedLayoutType === 'column',
+        'flex flex-row': resolvedLayoutType === 'row',
+        grid: resolvedLayoutType === 'grid'
       }"
+      [style.gap.px]="gap"
+      [style.gridTemplateColumns]="
+        resolvedLayoutType === 'grid' ? 'repeat(' + columns + ', 1fr)' : null
+      "
     >
-      <dfk-field-input
-        *ngFor="let field of visibleFields; trackBy: trackByFn"
-        [fieldDescription]="field"
-        [renderInfos]="data"
-        (onValueChangeField)="onFieldChange($event)"
-      ></dfk-field-input>
+      <ng-container *ngFor="let field of visibleFields; trackBy: trackByFn">
+        <dfk-field-input
+          *ngIf="!field.fields"
+          [fieldDescription]="field"
+          [value]="data[field.name]"
+          [options]="getResolvedOptions(field)"
+          [disabled]="getDisabled(field)"
+          [readOnly]="getReadOnly(field)"
+          [error]="getError(field)"
+          (onValueChangeField)="onFieldChange($event)"
+        ></dfk-field-input>
+
+        <div *ngIf="field.fields" [class]="field.className">
+          <div *ngIf="field.label">{{ field.label }}</div>
+          <div
+            *ngFor="
+              let item of getItems(field);
+              let i = index;
+              trackBy: groupTrackBy(field)
+            "
+            style="display: flex; align-items: flex-start; gap: 8px;"
+          >
+            <div style="flex: 1">
+              <dfk-multi-field-input
+                [fieldDescriptions]="field.fields"
+                [properties]="item"
+                [rootData]="rootData ?? data"
+                (onChange)="onGroupItemChange(field, i, $event)"
+              ></dfk-multi-field-input>
+            </div>
+            <button
+              type="button"
+              [attr.aria-label]="
+                (field.removeLabel || 'Remove') +
+                ' ' +
+                (field.label || field.name) +
+                ' ' +
+                (i + 1)
+              "
+              (click)="onGroupItemRemove(field, i)"
+              [disabled]="!canRemoveItem(field)"
+            >
+              {{ field.removeLabel || 'Remove' }}
+            </button>
+          </div>
+          <button
+            type="button"
+            [attr.aria-label]="
+              (field.addLabel || 'Add') + ' ' + (field.label || field.name)
+            "
+            (click)="onGroupItemAdd(field)"
+            [disabled]="!canAddItem(field)"
+          >
+            {{ field.addLabel || 'Add' }}
+          </button>
+        </div>
+      </ng-container>
     </div>
-  `, isInline: true, dependencies: [{ kind: "directive", type: NgClass, selector: "[ngClass]", inputs: ["class", "ngClass"] }, { kind: "directive", type: NgFor, selector: "[ngFor][ngForOf]", inputs: ["ngForOf", "ngForTrackBy", "ngForTemplate"] }, { kind: "component", type: FieldInput, selector: "dfk-field-input", inputs: ["fieldDescription", "renderInfos"], outputs: ["onValueChangeField"] }] });
+  `, isInline: true, dependencies: [{ kind: "component", type: MultiFieldInput, selector: "dfk-multi-field-input", inputs: ["fieldDescriptions", "properties", "layout", "rootData"], outputs: ["onChange", "validityChange"] }, { kind: "directive", type: NgClass, selector: "[ngClass]", inputs: ["class", "ngClass"] }, { kind: "directive", type: NgFor, selector: "[ngFor][ngForOf]", inputs: ["ngForOf", "ngForTrackBy", "ngForTemplate"] }, { kind: "directive", type: NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }, { kind: "component", type: FieldInput, selector: "dfk-field-input", inputs: ["fieldDescription", "value", "options", "disabled", "readOnly", "error"], outputs: ["onValueChangeField"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.20", ngImport: i0, type: MultiFieldInput, decorators: [{
             type: Component,
             args: [{
                     selector: 'dfk-multi-field-input',
                     standalone: true,
-                    imports: [NgClass, NgFor, FieldInput],
+                    // Repeatable field groups render a nested <dfk-multi-field-input> per item
+                    // (see the #groupTpl below), so this component imports itself. That's the
+                    // supported way to give a standalone component recursive template usage
+                    // without a cross-file circular import between FieldInput and a separate
+                    // group component (whose `imports` arrays are evaluated eagerly at module
+                    // load time and would deadlock on an actual circular module reference).
+                    imports: [NgClass, NgFor, NgIf, FieldInput, MultiFieldInput],
+                    changeDetection: ChangeDetectionStrategy.OnPush,
                     template: `
     <div
-      class="flex flex-col gap-3 p-4 border rounded-lg bg-gray-50"
+      class="p-4 border rounded-lg bg-gray-50"
       [ngClass]="{
-        'flex-row gap-3': layout === 'row',
-        'grid grid-cols-2 gap-3': layout === 'grid'
+        'flex flex-col': resolvedLayoutType === 'column',
+        'flex flex-row': resolvedLayoutType === 'row',
+        grid: resolvedLayoutType === 'grid'
       }"
+      [style.gap.px]="gap"
+      [style.gridTemplateColumns]="
+        resolvedLayoutType === 'grid' ? 'repeat(' + columns + ', 1fr)' : null
+      "
     >
-      <dfk-field-input
-        *ngFor="let field of visibleFields; trackBy: trackByFn"
-        [fieldDescription]="field"
-        [renderInfos]="data"
-        (onValueChangeField)="onFieldChange($event)"
-      ></dfk-field-input>
+      <ng-container *ngFor="let field of visibleFields; trackBy: trackByFn">
+        <dfk-field-input
+          *ngIf="!field.fields"
+          [fieldDescription]="field"
+          [value]="data[field.name]"
+          [options]="getResolvedOptions(field)"
+          [disabled]="getDisabled(field)"
+          [readOnly]="getReadOnly(field)"
+          [error]="getError(field)"
+          (onValueChangeField)="onFieldChange($event)"
+        ></dfk-field-input>
+
+        <div *ngIf="field.fields" [class]="field.className">
+          <div *ngIf="field.label">{{ field.label }}</div>
+          <div
+            *ngFor="
+              let item of getItems(field);
+              let i = index;
+              trackBy: groupTrackBy(field)
+            "
+            style="display: flex; align-items: flex-start; gap: 8px;"
+          >
+            <div style="flex: 1">
+              <dfk-multi-field-input
+                [fieldDescriptions]="field.fields"
+                [properties]="item"
+                [rootData]="rootData ?? data"
+                (onChange)="onGroupItemChange(field, i, $event)"
+              ></dfk-multi-field-input>
+            </div>
+            <button
+              type="button"
+              [attr.aria-label]="
+                (field.removeLabel || 'Remove') +
+                ' ' +
+                (field.label || field.name) +
+                ' ' +
+                (i + 1)
+              "
+              (click)="onGroupItemRemove(field, i)"
+              [disabled]="!canRemoveItem(field)"
+            >
+              {{ field.removeLabel || 'Remove' }}
+            </button>
+          </div>
+          <button
+            type="button"
+            [attr.aria-label]="
+              (field.addLabel || 'Add') + ' ' + (field.label || field.name)
+            "
+            (click)="onGroupItemAdd(field)"
+            [disabled]="!canAddItem(field)"
+          >
+            {{ field.addLabel || 'Add' }}
+          </button>
+        </div>
+      </ng-container>
     </div>
   `,
                 }]
-        }], propDecorators: { fieldDescriptions: [{
+        }], ctorParameters: () => [{ type: i0.ChangeDetectorRef }], propDecorators: { fieldDescriptions: [{
                 type: Input
             }], properties: [{
                 type: Input
             }], onChange: [{
                 type: Output
+            }], validityChange: [{
+                type: Output
             }], layout: [{
                 type: Input
+            }], rootData: [{
+                type: Input
+            }], onWindowResize: [{
+                type: HostListener,
+                args: ['window:resize']
             }] } });
 
+class LayoutRegistry {
+    layouts = new Map();
+    register(type, component) {
+        if (this.layouts.has(type)) {
+            console.warn(`[dynamic-field-kit] Layout "${type}" already exists`);
+        }
+        this.layouts.set(type, component);
+    }
+    get(type) {
+        return this.layouts.get(type);
+    }
+}
+const layoutRegistry = new LayoutRegistry();
+
 class ColumnLayout {
+    config;
+    template;
+    get gap() {
+        return this.config?.gap ?? 12;
+    }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.20", ngImport: i0, type: ColumnLayout, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "19.2.20", type: ColumnLayout, isStandalone: true, selector: "dfk-column-layout", ngImport: i0, template: `<div
-    style="display:flex;flex-direction:column;gap:var(--dfk-gap,12px)"
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "19.2.20", type: ColumnLayout, isStandalone: true, selector: "dfk-column-layout", inputs: { config: "config", template: "template" }, ngImport: i0, template: `<div
+    [style.display]="'flex'"
+    [style.flexDirection]="'column'"
+    [style.gap]="gap + 'px'"
   >
-    <ng-content></ng-content>
-  </div>`, isInline: true, dependencies: [{ kind: "ngmodule", type: CommonModule }] });
+    <ng-container *ngTemplateOutlet="template"></ng-container>
+  </div>`, isInline: true, dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i1.NgTemplateOutlet, selector: "[ngTemplateOutlet]", inputs: ["ngTemplateOutletContext", "ngTemplateOutlet", "ngTemplateOutletInjector"] }] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.20", ngImport: i0, type: ColumnLayout, decorators: [{
             type: Component,
@@ -382,19 +775,32 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.20", ngImpo
                     standalone: true,
                     imports: [CommonModule],
                     template: `<div
-    style="display:flex;flex-direction:column;gap:var(--dfk-gap,12px)"
+    [style.display]="'flex'"
+    [style.flexDirection]="'column'"
+    [style.gap]="gap + 'px'"
   >
-    <ng-content></ng-content>
+    <ng-container *ngTemplateOutlet="template"></ng-container>
   </div>`,
                 }]
-        }] });
+        }], propDecorators: { config: [{
+                type: Input
+            }], template: [{
+                type: Input
+            }] } });
 class RowLayout {
+    config;
+    template;
+    get gap() {
+        return this.config?.gap ?? 12;
+    }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.20", ngImport: i0, type: RowLayout, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "19.2.20", type: RowLayout, isStandalone: true, selector: "dfk-row-layout", ngImport: i0, template: `<div
-    style="display:flex;flex-direction:row;gap:var(--dfk-gap,12px)"
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "19.2.20", type: RowLayout, isStandalone: true, selector: "dfk-row-layout", inputs: { config: "config", template: "template" }, ngImport: i0, template: `<div
+    [style.display]="'flex'"
+    [style.flexDirection]="'row'"
+    [style.gap]="gap + 'px'"
   >
-    <ng-content></ng-content>
-  </div>`, isInline: true, dependencies: [{ kind: "ngmodule", type: CommonModule }] });
+    <ng-container *ngTemplateOutlet="template"></ng-container>
+  </div>`, isInline: true, dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i1.NgTemplateOutlet, selector: "[ngTemplateOutlet]", inputs: ["ngTemplateOutletContext", "ngTemplateOutlet", "ngTemplateOutletInjector"] }] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.20", ngImport: i0, type: RowLayout, decorators: [{
             type: Component,
@@ -403,19 +809,35 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.20", ngImpo
                     standalone: true,
                     imports: [CommonModule],
                     template: `<div
-    style="display:flex;flex-direction:row;gap:var(--dfk-gap,12px)"
+    [style.display]="'flex'"
+    [style.flexDirection]="'row'"
+    [style.gap]="gap + 'px'"
   >
-    <ng-content></ng-content>
+    <ng-container *ngTemplateOutlet="template"></ng-container>
   </div>`,
                 }]
-        }] });
+        }], propDecorators: { config: [{
+                type: Input
+            }], template: [{
+                type: Input
+            }] } });
 class GridLayout {
+    config;
+    template;
+    get columns() {
+        return this.config?.columns ?? 2;
+    }
+    get gap() {
+        return this.config?.gap ?? 12;
+    }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.20", ngImport: i0, type: GridLayout, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "19.2.20", type: GridLayout, isStandalone: true, selector: "dfk-grid-layout", ngImport: i0, template: `<div
-    style="display:grid;grid-template-columns:repeat(var(--dfk-columns,2),1fr);gap:var(--dfk-gap,12px)"
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "19.2.20", type: GridLayout, isStandalone: true, selector: "dfk-grid-layout", inputs: { config: "config", template: "template" }, ngImport: i0, template: `<div
+    [style.display]="'grid'"
+    [style.gridTemplateColumns]="'repeat(' + columns + ', 1fr)'"
+    [style.gap]="gap + 'px'"
   >
-    <ng-content></ng-content>
-  </div>`, isInline: true, dependencies: [{ kind: "ngmodule", type: CommonModule }] });
+    <ng-container *ngTemplateOutlet="template"></ng-container>
+  </div>`, isInline: true, dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i1.NgTemplateOutlet, selector: "[ngTemplateOutlet]", inputs: ["ngTemplateOutletContext", "ngTemplateOutlet", "ngTemplateOutletInjector"] }] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.20", ngImport: i0, type: GridLayout, decorators: [{
             type: Component,
@@ -424,12 +846,21 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.20", ngImpo
                     standalone: true,
                     imports: [CommonModule],
                     template: `<div
-    style="display:grid;grid-template-columns:repeat(var(--dfk-columns,2),1fr);gap:var(--dfk-gap,12px)"
+    [style.display]="'grid'"
+    [style.gridTemplateColumns]="'repeat(' + columns + ', 1fr)'"
+    [style.gap]="gap + 'px'"
   >
-    <ng-content></ng-content>
+    <ng-container *ngTemplateOutlet="template"></ng-container>
   </div>`,
                 }]
-        }] });
+        }], propDecorators: { config: [{
+                type: Input
+            }], template: [{
+                type: Input
+            }] } });
+layoutRegistry.register('column', ColumnLayout);
+layoutRegistry.register('row', RowLayout);
+layoutRegistry.register('grid', GridLayout);
 
 class DynamicFieldKitModule {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.20", ngImport: i0, type: DynamicFieldKitModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
@@ -483,5 +914,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.20", ngImpo
  * Generated bundle index. Do not edit.
  */
 
-export { BaseInputComponent, ColumnLayout, DynamicFieldKitModule, DynamicInput, FieldInput, GridLayout, MultiFieldInput, RowLayout };
+export { BaseInputComponent, ColumnLayout, DynamicFieldKitModule, DynamicInput, FIELD_REGISTRY, FieldInput, GridLayout, LayoutRegistry, MultiFieldInput, RowLayout, layoutRegistry };
 //# sourceMappingURL=dynamic-field-kit-angular.mjs.map