@ng-forge/dynamic-forms 0.8.0-next.1 → 0.8.0-next.2

package/fesm2022/{ng-forge-dynamic-forms-css-wrapper.component-Civn5kLJ.mjs → ng-forge-dynamic-forms-css-wrapper.component-CGNGJoqv.mjs}

@@ -2,7 +2,7 @@ import * as i0 from '@angular/core';
 import { viewChild, ViewContainerRef, input, ChangeDetectionStrategy, Component } from '@angular/core';
 import { pipe, switchMap } from 'rxjs';
 import { derivedFrom } from 'ngxtension/derived-from';
-import { f as dynamicTextToObservable } from './ng-forge-dynamic-forms-ng-forge-dynamic-forms-D276M2vh.mjs';
+import { f as dynamicTextToObservable } from './ng-forge-dynamic-forms-ng-forge-dynamic-forms-BwoONrnj.mjs';
 
 /**
  * Built-in CSS wrapper component.
@@ -47,4 +47,4 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.8", ngImpor
         }], propDecorators: { fieldComponent: [{ type: i0.ViewChild, args: ['fieldComponent', { ...{ read: ViewContainerRef }, isSignal: true }] }], cssClasses: [{ type: i0.Input, args: [{ isSignal: true, alias: "cssClasses", required: false }] }], fieldInputs: [{ type: i0.Input, args: [{ isSignal: true, alias: "fieldInputs", required: false }] }] } });
 
 export { CssWrapperComponent, CssWrapperComponent as default };
-//# sourceMappingURL=ng-forge-dynamic-forms-css-wrapper.component-Civn5kLJ.mjs.map
+//# sourceMappingURL=ng-forge-dynamic-forms-css-wrapper.component-CGNGJoqv.mjs.map

package/fesm2022/{ng-forge-dynamic-forms-css-wrapper.component-Civn5kLJ.mjs.map → ng-forge-dynamic-forms-css-wrapper.component-CGNGJoqv.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"ng-forge-dynamic-forms-css-wrapper.component-Civn5kLJ.mjs","sources":["../../../../packages/dynamic-forms/src/lib/wrappers/css/css-wrapper.component.ts"],"sourcesContent":["import { ChangeDetectionStrategy, Component, input, Signal, ViewContainerRef, viewChild } from '@angular/core';\nimport { pipe, switchMap } from 'rxjs';\nimport { derivedFrom } from 'ngxtension/derived-from';\nimport { FieldWrapperContract } from '../../models/wrapper-type';\nimport { DynamicText } from '../../models/types/dynamic-text';\nimport { dynamicTextToObservable } from '../../utils/dynamic-text-to-observable';\nimport { WrapperFieldInputs } from '../wrapper-field-inputs';\n\n/**\n * Built-in CSS wrapper component.\n *\n * Applies CSS classes from the `cssClasses` config property to the host element,\n * wrapping the inner content (next wrapper or children) in its ViewContainerRef slot.\n *\n * Receives `cssClasses` as an individual Angular input (set by the outlet via\n * `setInput()`). `fieldInputs` carries the wrapped field's mapper outputs +\n * a read-only view of its form state (via `ReadonlyFieldTree`).\n *\n * @example\n * ```typescript\n * {\n *   type: 'container',\n *   key: 'styled',\n *   wrappers: [{ type: 'css', cssClasses: 'card p-4' }],\n *   fields: [...]\n * }\n * ```\n */\n@Component({\n  selector: 'df-css-wrapper',\n  template: `<ng-container #fieldComponent></ng-container>`,\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  host: {\n    '[class]': 'resolvedClasses()',\n  },\n})\nexport default class CssWrapperComponent implements FieldWrapperContract {\n  readonly fieldComponent = viewChild.required('fieldComponent', { read: ViewContainerRef });\n\n  readonly cssClasses = input<DynamicText>();\n  readonly fieldInputs = input<WrapperFieldInputs>();\n\n  readonly resolvedClasses: Signal<string> = derivedFrom([this.cssClasses], pipe(switchMap(([value]) => dynamicTextToObservable(value))), {\n    initialValue: '',\n  });\n}\n\nexport { CssWrapperComponent };\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"ng-forge-dynamic-forms-css-wrapper.component-CGNGJoqv.mjs","sources":["../../../../packages/dynamic-forms/src/lib/wrappers/css/css-wrapper.component.ts"],"sourcesContent":["import { ChangeDetectionStrategy, Component, input, Signal, ViewContainerRef, viewChild } from '@angular/core';\nimport { pipe, switchMap } from 'rxjs';\nimport { derivedFrom } from 'ngxtension/derived-from';\nimport { FieldWrapperContract } from '../../models/wrapper-type';\nimport { DynamicText } from '../../models/types/dynamic-text';\nimport { dynamicTextToObservable } from '../../utils/dynamic-text-to-observable';\nimport { WrapperFieldInputs } from '../wrapper-field-inputs';\n\n/**\n * Built-in CSS wrapper component.\n *\n * Applies CSS classes from the `cssClasses` config property to the host element,\n * wrapping the inner content (next wrapper or children) in its ViewContainerRef slot.\n *\n * Receives `cssClasses` as an individual Angular input (set by the outlet via\n * `setInput()`). `fieldInputs` carries the wrapped field's mapper outputs +\n * a read-only view of its form state (via `ReadonlyFieldTree`).\n *\n * @example\n * ```typescript\n * {\n *   type: 'container',\n *   key: 'styled',\n *   wrappers: [{ type: 'css', cssClasses: 'card p-4' }],\n *   fields: [...]\n * }\n * ```\n */\n@Component({\n  selector: 'df-css-wrapper',\n  template: `<ng-container #fieldComponent></ng-container>`,\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  host: {\n    '[class]': 'resolvedClasses()',\n  },\n})\nexport default class CssWrapperComponent implements FieldWrapperContract {\n  readonly fieldComponent = viewChild.required('fieldComponent', { read: ViewContainerRef });\n\n  readonly cssClasses = input<DynamicText>();\n  readonly fieldInputs = input<WrapperFieldInputs>();\n\n  readonly resolvedClasses: Signal<string> = derivedFrom([this.cssClasses], pipe(switchMap(([value]) => dynamicTextToObservable(value))), {\n    initialValue: '',\n  });\n}\n\nexport { CssWrapperComponent };\n"],"names":[],"mappings":"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"}

package/fesm2022/{ng-forge-dynamic-forms-ng-forge-dynamic-forms-D276M2vh.mjs → ng-forge-dynamic-forms-ng-forge-dynamic-forms-BwoONrnj.mjs}

@@ -8293,9 +8293,9 @@ class PageOrchestratorComponent {
         }
       }
     }
-  `, isInline: true, styles: [":host{display:block;position:relative;width:100%}\n"], changeDetection: i0.ChangeDetectionStrategy.OnPush, deferBlockDependencies: [() => [import('./ng-forge-dynamic-forms-page-field.component-CEN5u1dd.mjs').then(m => m.default)], () => [import('./ng-forge-dynamic-forms-page-field.component-CEN5u1dd.mjs').then(m => m.default)]] });
+  `, isInline: true, styles: [":host{display:block;position:relative;width:100%}\n"], changeDetection: i0.ChangeDetectionStrategy.OnPush, deferBlockDependencies: [() => [import('./ng-forge-dynamic-forms-page-field.component-DV-EX9U0.mjs').then(m => m.default)], () => [import('./ng-forge-dynamic-forms-page-field.component-DV-EX9U0.mjs').then(m => m.default)]] });
 }
-i0.ɵɵngDeclareClassMetadataAsync({ minVersion: "18.0.0", version: "21.2.8", ngImport: i0, type: PageOrchestratorComponent, resolveDeferredDeps: () => [import('./ng-forge-dynamic-forms-page-field.component-CEN5u1dd.mjs').then(m => m.default)], resolveMetadata: PageFieldComponent => ({ decorators: [{
+i0.ɵɵngDeclareClassMetadataAsync({ minVersion: "18.0.0", version: "21.2.8", ngImport: i0, type: PageOrchestratorComponent, resolveDeferredDeps: () => [import('./ng-forge-dynamic-forms-page-field.component-DV-EX9U0.mjs').then(m => m.default)], resolveMetadata: PageFieldComponent => ({ decorators: [{
                 type: Component,
                 args: [{ selector: 'div[page-orchestrator]', imports: [PageFieldComponent], template: `
     @for (pageField of pageFields(); track pageField.key; let i = $index) {
@@ -8495,14 +8495,24 @@ function expandSimplifiedArray(field) {
     }
     // Safe cast: we're constructing a valid ArrayField shape with key, type, and fields
     const arrayField = arrayFieldObj;
-    // Store normalization metadata via Symbol property instead of a runtime property
+    // Store normalization metadata via Symbol property instead of a runtime property.
+    // `template` always gets populated so the array component can resolve untracked
+    // items (e.g., from external form-value updates).
+    //
+    // For object templates, we must include the auto-generated remove button in the stored
+    // template because object arrays embed the button inside each item's fields (via
+    // buildObjectItem) rather than via the `autoRemoveButton` metadata. Without this,
+    // items resolved from metadata would render without the remove button that
+    // originally-declared items have. Primitive templates keep the button as separate
+    // metadata and pass the raw template through — withAutoRemove() appends the button
+    // at resolution time from autoRemoveButton.
     const primitiveFieldKey = !isObjectTemplate ? template.key : undefined;
-    if (hasAutoRemove || primitiveFieldKey) {
-        setNormalizedArrayMetadata(arrayFieldObj, {
-            ...(hasAutoRemove && { autoRemoveButton: buildRemoveButton(removeButton) }),
-            ...(primitiveFieldKey && { primitiveFieldKey }),
-        });
-    }
+    const metadataTemplate = isObjectTemplate ? buildObjectItemTemplate(template, removeButton) : template;
+    setNormalizedArrayMetadata(arrayFieldObj, {
+        ...(hasAutoRemove && { autoRemoveButton: buildRemoveButton(removeButton) }),
+        ...(primitiveFieldKey && { primitiveFieldKey }),
+        template: metadataTemplate,
+    });
     // Construct the add button (sibling, placed after the array)
     let addButtonField;
     if (addButton !== false) {
@@ -14641,13 +14651,13 @@ const BUILT_IN_FIELDS = [
     },
     {
         name: 'page',
-        loadComponent: () => import('./ng-forge-dynamic-forms-page-field.component-CEN5u1dd.mjs'),
+        loadComponent: () => import('./ng-forge-dynamic-forms-page-field.component-DV-EX9U0.mjs'),
         mapper: pageFieldMapper,
         valueHandling: 'flatten',
     },
     {
         name: 'text',
-        loadComponent: () => import('./ng-forge-dynamic-forms-text-field.component-9OIByjZZ.mjs'),
+        loadComponent: () => import('./ng-forge-dynamic-forms-text-field.component-CHC8v87r.mjs'),
         mapper: textFieldMapper,
         valueHandling: 'exclude',
         ...DISPLAY_FIELD_TYPES_BASE,
@@ -14667,7 +14677,7 @@ const BUILT_IN_FIELDS = [
 const BUILT_IN_WRAPPERS = [
     {
         wrapperName: 'css',
-        loadComponent: () => import('./ng-forge-dynamic-forms-css-wrapper.component-Civn5kLJ.mjs'),
+        loadComponent: () => import('./ng-forge-dynamic-forms-css-wrapper.component-CGNGJoqv.mjs'),
     },
     {
         wrapperName: 'row',
@@ -16204,6 +16214,23 @@ class ArrayFieldComponent {
             return (Array.isArray(def) ? def : [def]);
         });
     }, ...(ngDevMode ? [{ debugName: "rawItemTemplates" }] : /* istanbul ignore next */ []));
+    /**
+     * Resolves the effective fallback template for this array — used when the form
+     * value contains an item with no registered template (i.e., items that were
+     * neither added via event handlers nor covered by a positional entry in `fields`).
+     *
+     * Populated from `SimplifiedArrayField.template` via normalization metadata, so every
+     * simplified array gets an automatic default. Returns undefined for full-API arrays;
+     * `createResolveItemObservable` then falls back to warn-and-drop.
+     *
+     * Homogeneous arrays only — all fallback items receive the same template.
+     */
+    fallbackTemplate = computed(() => {
+        const raw = getNormalizedArrayMetadata(this.field())?.template;
+        if (!raw)
+            return undefined;
+        return (Array.isArray(raw) ? [...raw] : [raw]);
+    }, ...(ngDevMode ? [{ debugName: "fallbackTemplate" }] : /* istanbul ignore next */ []));
     /**
      * Gets the item templates (field definitions) for the array.
      * Each element can be either:
@@ -16542,7 +16569,12 @@ class ArrayFieldComponent {
      * Template resolution order:
      * 1. Use overrideTemplate if provided (from recreate with stored templates)
      * 2. Use itemTemplates[index] if within defined templates range
-     * 3. Return undefined (item cannot be resolved without a template)
+     * 3. Use the simplified-array fallback template (from normalization metadata) for
+     *    untracked items present in the form value (e.g., external `value.set`, parent
+     *    two-way binding, initial values beyond what was declared via simplified `value`).
+     *    Registers the resolved item in templateRegistry so subsequent recreates use
+     *    Priority 1.
+     * 4. Return undefined (item cannot be resolved without a template)
      */
     createResolveItemObservable(index, overrideTemplate) {
         const itemTemplates = this.itemTemplates();
@@ -16580,10 +16612,35 @@ class ArrayFieldComponent {
                 primitiveFieldKey: primitiveKey,
             });
         }
-        // No template available - this shouldn't happen in normal operation.
-        // Dynamically added items should always have their template stored in the registry.
-        this.logger.warn(`No template found for array item at index ${index}. ` +
-            'This may indicate a bug - dynamically added items should have their templates stored.');
+        // Priority 3: Use the metadata fallback template for untracked items in the form value.
+        // Homogeneous only — every fallback item receives the same template regardless of value shape.
+        const fallback = this.fallbackTemplate();
+        if (fallback && fallback.length > 0) {
+            return resolveArrayItem({
+                index,
+                templates: this.withAutoRemove(fallback),
+                arrayField: this.field(),
+                itemPositionMap: this.itemPositionMap,
+                parentFieldSignalContext: this.parentFieldSignalContext,
+                parentInjector: this.parentInjector,
+                registry: this.rawFieldRegistry(),
+                destroyRef: this.destroyRef,
+                loadTypeComponent: (type) => this.fieldRegistry.loadTypeComponent(type),
+                generateItemId: this.generateItemId,
+                primitiveFieldKey: primitiveKey,
+            }).pipe(tap((item) => {
+                // Register the fallback template against the generated item id so subsequent
+                // recreates hit Priority 1 instead of re-resolving via this branch.
+                if (item)
+                    this.templateRegistry.set(item.id, fallback);
+            }));
+        }
+        // Priority 4: no template available. Full-API arrays are positional by design —
+        // `fields` declares one template per item, so values extending past `fields.length`
+        // (e.g., from external `value.set`, parent two-way binding, or initial values on a
+        // `fields: []` array) have no template to render. Use the simplified array API
+        // (`template` + `value`) when you need homogeneous arrays with value-driven items.
+        this.logger.warn(`No template found for array item at index ${index}. This likely occured for a Full-API array element that was created from the DynamicForm's value being set directly, which is currently not supported. Consider using the simplified array API.`);
         return of(undefined);
     }
     /**
@@ -16994,4 +17051,4 @@ function extractErrorParams(error) {
  */
 
 export { evaluateNonFieldDisabled as $, ARRAY_CONTEXT as A, BUILT_IN_FIELDS as B, ConsoleLogger as C, DynamicFormLogger as D, EventBus as E, FIELD_REGISTRY as F, GroupFieldComponent as G, PreviousPageEvent as H, INITIALIZATION_TIMEOUT_MS as I, RootFormRegistryService as J, SubmitEvent as K, applyMetaToElement as L, MoveArrayItemEvent as M, NextPageEvent as N, applyValidator as O, PageChangeEvent as P, applyValidators as Q, RemoveAtIndexEvent as R, ShiftArrayItemEvent as S, arrayEvent as T, arrayFieldMapper as U, baseFieldMapper as V, WRAPPER_REGISTRY as W, buildBaseInputs as X, containerFieldMapper as Y, createField as Z, createWrappers as _, createFieldResolutionPipe as a, evaluateNonFieldHidden as a0, field as a1, formConfig as a2, getArrayLength as a3, groupFieldMapper as a4, hasFormValue as a5, interpolateParams as a6, isArrayField as a7, isCheckedField as a8, isContainerField as a9, withPreviousValue as aA, withValueExclusionDefaults as aB, wrapperProps as aC, isContainerTypedField as aa, isDisplayOnlyField as ab, isEqual as ac, isFormStateCondition as ad, isGroupField as ae, isLeafField as af, isPageField as ag, isRowField as ah, isSimplifiedArrayField as ai, isValueBearingField as aj, isValueField as ak, isWrapperTypeDefinition as al, isWrappersBundle as am, omit as an, pageFieldMapper as ao, provideDynamicForm as ap, resolveNextButtonDisabled as aq, resolveNonFieldDisabled as ar, resolveNonFieldHidden as as, resolveSubmitButtonDisabled as at, resolveTokens as au, rowFieldMapper as av, textFieldMapper as aw, toReadonlyFieldTree as ax, withEventFormValue as ay, withLoggerConfig as az, DfFieldOutlet as b, computeContainerHostClasses as c, derivedFromDeferred as d, DynamicTextPipe as e, dynamicTextToObservable as f, AppendArrayItemEvent as g, ArrayFieldComponent as h, injectFieldRegistry as i, ContainerFieldComponent as j, DEFAULT_PROPS as k, DEFAULT_VALIDATION_MESSAGES as l, DEFAULT_WRAPPERS as m, DynamicForm as n, DynamicFormError as o, EventDispatcher as p, FIELD_SIGNAL_CONTEXT as q, FORM_OPTIONS as r, setupContainerInitEffect as s, FormClearEvent as t, FormResetEvent as u, validatePageNesting as v, InsertArrayItemEvent as w, NoopLogger as x, PopArrayItemEvent as y, PrependArrayItemEvent as z };
-//# sourceMappingURL=ng-forge-dynamic-forms-ng-forge-dynamic-forms-D276M2vh.mjs.map
+//# sourceMappingURL=ng-forge-dynamic-forms-ng-forge-dynamic-forms-BwoONrnj.mjs.map