@ng-forge/dynamic-forms 1.1.0-next.2 → 1.1.0-next.4

package/fesm2022/{ng-forge-dynamic-forms-ng-forge-dynamic-forms-fMB33l2f.mjs → ng-forge-dynamic-forms-ng-forge-dynamic-forms-BYyZ_cuA.mjs}

@@ -1,7 +1,7 @@
 import * as i0 from '@angular/core';
 import { reflectComponentType, Injector, inject, EnvironmentInjector, DestroyRef, computed, signal, input, ViewContainerRef, Directive, linkedSignal, ChangeDetectionStrategy, Component, Injectable, InjectionToken, isSignal, runInInjectionContext, afterNextRender, untracked, PendingTasks, ElementRef, PLATFORM_ID, isDevMode, TemplateRef, model, contentChildren, makeEnvironmentProviders } from '@angular/core';
 import { explicitEffect } from 'ngxtension/explicit-effect';
-import { DynamicFormLogger, WRAPPER_COMPONENT_CACHE, WRAPPER_REGISTRY, toReadonlyFieldTreeCached, writeToFieldValue, WRAPPER_AUTO_ASSOCIATIONS, DEFAULT_WRAPPERS, READONLY_FIELD_TREE_CACHE, EventBus, FieldContextRegistryService, FunctionRegistryService, FORM_OPTIONS, evaluateCondition, FIELD_SIGNAL_CONTEXT, isRowField, isContainerField, isArrayField, hasChildFields, isSimplifiedArrayField, DynamicFormError, isStateLogicConfig, isDerivationLogicConfig, createDebouncedLogicFunction, createLogicFunction, ExpressionParser, applyValidator, isPageField, isGenericContainerField, isGroupField, getFieldValueHandling, normalizeFieldsArray, getNestedValue, isCrossFieldValidator, extractStringDependencies, isCrossFieldBuiltInValidator, hasCrossFieldWhenCondition, extractExpressionDependencies, isCrossFieldStateLogic, isCrossFieldSchema, keyBy, mapValues, isEqual, hasTargetProperty, ARRAY_CONTEXT, GROUP_CONTEXT, FORM_ID_PREFIX, baseFieldMapper, detectFormMode, validatePageNesting, FIELD_REGISTRY, assertNever, ADDON_TYPE_REGISTRY, deepMergeDefaults, derivedFromDeferred, createWarningTracker, RootFormRegistryService, DEFAULT_PROPS, DEFAULT_VALIDATION_MESSAGES, EXTERNAL_DATA, DEPRECATION_WARNING_TRACKER, createAddonActionRegistry, ADDON_ACTION_REGISTRY, HttpConditionCache, HTTP_CONDITION_CACHE, HttpConditionFunctionCacheService, AsyncConditionFunctionCacheService, DynamicValueFunctionCacheService, LogicFunctionCacheService, setupInitializationTracking, ComponentInitializedEvent, DF_FIELD_TEMPLATES, rowFieldMapper, groupFieldMapper, arrayFieldMapper, pageFieldMapper, textFieldMapper, containerFieldMapper, isWrapperTypeDefinition, ADDON_TYPE_COMPONENT_CACHE, ADDON_TYPE_DEFINITIONS, createDefaultDerivationLogConfig, NoopLogger, EMIT_FORM_VALUE_ON_EVENTS, DynamicTextPipe, ADDON_ACTION_HANDLERS } from '@ng-forge/dynamic-forms/internal';
+import { DynamicFormLogger, WRAPPER_COMPONENT_CACHE, WRAPPER_REGISTRY, toReadonlyFieldTreeCached, writeToFieldValue, WRAPPER_AUTO_ASSOCIATIONS, DEFAULT_WRAPPERS, READONLY_FIELD_TREE_CACHE, getGridClassString, EventBus, FieldContextRegistryService, FunctionRegistryService, FORM_OPTIONS, evaluateCondition, FIELD_SIGNAL_CONTEXT, isRowField, isContainerField, isArrayField, hasChildFields, isSimplifiedArrayField, DynamicFormError, isStateLogicConfig, isDerivationLogicConfig, createDebouncedLogicFunction, createLogicFunction, ExpressionParser, requiresTreeValidation, applyValidator, isPageField, isGenericContainerField, isGroupField, getFieldValueHandling, normalizeFieldsArray, getNestedValue, extractStringDependencies, isCrossFieldStateLogic, extractExpressionDependencies, isCrossFieldSchema, keyBy, mapValues, isEqual, hasTargetProperty, ARRAY_CONTEXT, GROUP_CONTEXT, FORM_ID_PREFIX, baseFieldMapper, detectFormMode, validatePageNesting, FIELD_REGISTRY, assertNever, ADDON_TYPE_REGISTRY, deepMergeDefaults, derivedFromDeferred, createWarningTracker, RootFormRegistryService, DEFAULT_PROPS, DEFAULT_VALIDATION_MESSAGES, EXTERNAL_DATA, DEPRECATION_WARNING_TRACKER, createAddonActionRegistry, ADDON_ACTION_REGISTRY, HttpConditionCache, HTTP_CONDITION_CACHE, HttpConditionFunctionCacheService, AsyncConditionFunctionCacheService, DynamicValueFunctionCacheService, LogicFunctionCacheService, setupInitializationTracking, ComponentInitializedEvent, DF_FIELD_TEMPLATES, rowFieldMapper, groupFieldMapper, arrayFieldMapper, pageFieldMapper, textFieldMapper, containerFieldMapper, isWrapperTypeDefinition, ADDON_TYPE_COMPONENT_CACHE, ADDON_TYPE_DEFINITIONS, createDefaultDerivationLogConfig, NoopLogger, EMIT_FORM_VALUE_ON_EVENTS, DynamicTextPipe, ADDON_ACTION_HANDLERS } from '@ng-forge/dynamic-forms/internal';
 import { takeUntilDestroyed, toObservable, toSignal, outputFromObservable } from '@angular/core/rxjs-interop';
 import { of, forkJoin, from, catchError, map, switchMap, isObservable, firstValueFrom, exhaustMap, EMPTY, debounceTime, distinctUntilChanged, tap, pipe, scan, Observable, Subject, concatMap, filter, take } from 'rxjs';
 import { submit, required, disabled, readonly, hidden, applyEach, applyWhenValue, applyWhen, apply, email, minLength, maxLength, pattern, min, max, schema, validateStandardSchema, validateTree, form, provideSignalFormsConfig } from '@angular/forms/signals';
@@ -81,6 +81,12 @@ function loadWrapperComponents(configs, registry, cache, logger) {
 function renderWrapperChain(options) {
     const refs = [];
     renderStep(options.outerContainer, options.loadedWrappers, options, refs);
+        if (options.outermostHostClasses && refs.length > 0) {
+        const tokens = options.outermostHostClasses.split(/\s+/).filter(Boolean);
+        if (tokens.length > 0) {
+            refs[0].location.nativeElement.classList.add(...tokens);
+        }
+    }
     return refs;
 }
 function renderStep(slot, remaining, options, refs) {
@@ -218,6 +224,7 @@ function applyEmission({ state, loaded }, ctx) {
         logger: deps.logger,
         fieldInputs: opts.fieldInputs?.(),
         fieldInjector: opts.fieldInjector?.(),
+        outermostHostClasses: opts.outermostHostClasses?.(),
         renderInnermost: opts.renderInnermost,
     });
     mounted.value = { wrappers: state.wrappers, rebuildKey: state.rebuildKey };
@@ -366,6 +373,8 @@ class DfFieldOutlet {
     ...(ngDevMode ? [{ debugName: "fieldEnvInjector" }] : /* istanbul ignore next */ []));
         fieldInjector = computed(() => this.dfFieldOutlet().injector, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "fieldInjector" }] : /* istanbul ignore next */ []));
+        outermostHostClasses = computed(() => getGridClassString(this.dfFieldOutlet().fieldDef) || undefined, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "outermostHostClasses" }] : /* istanbul ignore next */ []));
     constructor() {
         createWrapperChainController({
             vcr: this.vcr,
@@ -374,6 +383,7 @@ class DfFieldOutlet {
             rebuildKey: this.componentIdentity,
             fieldInputs: this.fieldInputs,
             fieldInjector: this.fieldInjector,
+            outermostHostClasses: this.outermostHostClasses,
             beforeRebuild: () => this.fieldComponent.detach(),
             renderInnermost: (slot) => {
                 const resolved = this.dfFieldOutlet();
@@ -822,11 +832,11 @@ class PageOrchestratorComponent {
       }
     }
   `, isInline: true, styles: [":host{display:block;position:relative;width:100%}\n"], changeDetection: i0.ChangeDetectionStrategy.OnPush, deferBlockDependencies: [() => [/* @ts-ignore */
-                import('./ng-forge-dynamic-forms-page-field.component-C9bQkVjQ.mjs').then(m => m.default)], () => [/* @ts-ignore */
-                import('./ng-forge-dynamic-forms-page-field.component-C9bQkVjQ.mjs').then(m => m.default)]] });
+                import('./ng-forge-dynamic-forms-page-field.component-Vvk3fYZp.mjs').then(m => m.default)], () => [/* @ts-ignore */
+                import('./ng-forge-dynamic-forms-page-field.component-Vvk3fYZp.mjs').then(m => m.default)]] });
 }
 i0.ɵɵngDeclareClassMetadataAsync({ minVersion: "18.0.0", version: "22.0.1", ngImport: i0, type: PageOrchestratorComponent, resolveDeferredDeps: () => [/* @ts-ignore */
-        import('./ng-forge-dynamic-forms-page-field.component-C9bQkVjQ.mjs').then(m => m.default)], resolveMetadata: PageFieldComponent => ({ decorators: [{
+        import('./ng-forge-dynamic-forms-page-field.component-Vvk3fYZp.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) {
@@ -1215,7 +1225,7 @@ function applySchema(config, fieldPath) {
             `Ensure the schema is registered in your schema registry.`);
         return;
     }
-    const schemaFn = createSchemaFunction(schema);
+    const schemaFn = createSchemaFunction(schema, logger);
         const path = fieldPath;
     switch (config.type) {
         case 'apply':
@@ -1238,9 +1248,14 @@ function applySchema(config, fieldPath) {
             break;
     }
 }
-function createSchemaFunction(schema) {
+function createSchemaFunction(schema, logger) {
     return (path) => {
                 schema.validators?.forEach((validatorConfig) => {
+                                    if (requiresTreeValidation(validatorConfig)) {
+                logger?.warn(`Validator "${validatorConfig.type}" in schema definition "${schema.name}" uses a cross-field expression, ` +
+                    `which is not supported on schema definition validators; it was skipped.`);
+                return;
+            }
             applyValidator(validatorConfig, path);
         });
                 schema.logic?.forEach((logicConfig) => {
@@ -1702,7 +1717,6 @@ const VALIDATION_EXECUTION_DEFAULTS = new InjectionToken('VALIDATION_EXECUTION_D
     }),
 });
 
-const emailPattern = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
 function getFieldTreeByKey(ctx, key) {
         if (!key.includes('.')) {
         return ctx.fieldTree[key];
@@ -1765,12 +1779,19 @@ function createSchemaFromFields(fields, registry, optionsOrValidators) {
 }
 function applyCrossFieldTreeValidator(rootPath, validators, functionRegistry, logger) {
         const customFunctions = functionRegistry.getCustomFunctions();
+                const customValidators = validators.filter((entry) => {
+        if (entry.config.type !== 'custom') {
+            logger.warn(`Unexpected non-custom validator in cross-field tree for "${entry.sourceFieldKey}"; ignoring.`);
+            return false;
+        }
+        return true;
+    });
     validateTree(rootPath, (ctx) => {
-        if (validators.length === 0) {
+        if (customValidators.length === 0) {
             return null;         }
                 const formValue = ctx.value();
         const errors = [];
-        for (const entry of validators) {
+        for (const entry of customValidators) {
             const { sourceFieldKey, config } = entry;
             try {
                 const error = evaluateCrossFieldValidator(entry, formValue, sourceFieldKey, ctx, customFunctions, logger);
@@ -1803,12 +1824,7 @@ function evaluateCrossFieldValidator(entry, formValue, sourceFieldKey, ctx, cust
         customFunctions,
         logger,
     };
-        if (config.type === 'custom') {
         return evaluateCustomCrossFieldValidator(config, evaluationContext, sourceFieldKey, ctx);
-    }
-    else {
-                return evaluateBuiltInCrossFieldValidator(config, evaluationContext, sourceFieldKey, ctx);
-    }
 }
 function evaluateCustomCrossFieldValidator(config, evaluationContext, sourceFieldKey, ctx) {
     if (!config.expression) {
@@ -1851,95 +1867,6 @@ function evaluateCustomCrossFieldValidator(config, evaluationContext, sourceFiel
     }
     return errorObj;
 }
-function evaluateBuiltInCrossFieldValidator(config, evaluationContext, sourceFieldKey, ctx) {
-    const { fieldValue, formValue, logger, customFunctions } = evaluationContext;
-            if (config.when) {
-        const conditionMet = evaluateCondition(config.when, {
-            fieldValue,
-            formValue,
-            fieldPath: sourceFieldKey,
-            customFunctions: customFunctions || {},
-            logger,
-        });
-        if (!conditionMet) {
-            return null;         }
-    }
-        const isValid = applyBuiltInValidationLogic(config, fieldValue);
-    if (isValid) {
-        return null;     }
-        const targetField = getFieldTreeByKey(ctx, sourceFieldKey);
-    if (!targetField) {
-        logger.warn(`Cross-field validator references non-existent field "${sourceFieldKey}"`);
-        return null;
-    }
-    const errorObj = {
-        kind: config.type,
-        fieldTree: targetField,
-    };
-            if ('value' in config && config.value !== undefined) {
-        errorObj[config.type] = config.value;
-    }
-    return errorObj;
-}
-function applyBuiltInValidationLogic(config, fieldValue) {
-    switch (config.type) {
-        case 'required':
-                        if (fieldValue === null || fieldValue === undefined) {
-                return false;
-            }
-            if (typeof fieldValue === 'string' && fieldValue.trim() === '') {
-                return false;
-            }
-            return true;
-        case 'min':
-                        if (fieldValue === null || fieldValue === undefined) {
-                return true;             }
-            if ('value' in config && typeof config.value === 'number') {
-                return fieldValue >= config.value;
-            }
-            return true;
-        case 'max':
-                        if (fieldValue === null || fieldValue === undefined) {
-                return true;
-            }
-            if ('value' in config && typeof config.value === 'number') {
-                return fieldValue <= config.value;
-            }
-            return true;
-        case 'minLength':
-                        if (fieldValue === null || fieldValue === undefined || fieldValue === '') {
-                return true;
-            }
-            if ('value' in config && typeof config.value === 'number') {
-                return String(fieldValue).length >= config.value;
-            }
-            return true;
-        case 'maxLength':
-                        if (fieldValue === null || fieldValue === undefined || fieldValue === '') {
-                return true;
-            }
-            if ('value' in config && typeof config.value === 'number') {
-                return String(fieldValue).length <= config.value;
-            }
-            return true;
-        case 'email':
-                        if (fieldValue === null || fieldValue === undefined || fieldValue === '') {
-                return true;
-            }
-            return emailPattern.test(String(fieldValue));
-        case 'pattern':
-                        if (fieldValue === null || fieldValue === undefined || fieldValue === '') {
-                return true;
-            }
-            if ('value' in config && config.value) {
-                const regex = config.value instanceof RegExp ? config.value : new RegExp(String(config.value));
-                return regex.test(String(fieldValue));
-            }
-            return true;
-        default:
-                        return true;
-    }
-}
 function fieldsToDefaultValues(fields, registry) {
     const defaultValues = {};
     for (const field of fields) {
@@ -2011,38 +1938,25 @@ function collectFromField(field, collection, pathPrefix) {
     }
 }
 function tryCreateValidatorEntry(fieldKey, config) {
-        if (config.type === 'custom') {
+    if (!requiresTreeValidation(config)) {
+        return null;     }
+    if (config.type === 'custom') {
         const customConfig = config;
-        if (isCrossFieldValidator(customConfig)) {
-            return {
-                sourceFieldKey: fieldKey,
-                config,
-                dependsOn: extractStringDependencies(customConfig.expression || ''),
-                category: 'validator',
-            };
-        }
-    }
-        if (isCrossFieldBuiltInValidator(config)) {
-        const builtInConfig = config;
-        return {
-            sourceFieldKey: fieldKey,
-            config: convertBuiltInToCustomValidator(builtInConfig),
-            validatorType: config.type,
-            dependsOn: extractStringDependencies(builtInConfig.expression || ''),
-            category: 'validator',
-        };
-    }
-        if (hasCrossFieldWhenCondition(config)) {
-        const whenCondition = config.when;
         return {
             sourceFieldKey: fieldKey,
             config,
-            validatorType: config.type,
-            dependsOn: extractExpressionDependencies(whenCondition),
+            dependsOn: extractStringDependencies(customConfig.expression || ''),
             category: 'validator',
         };
     }
-    return null;
+    const builtInConfig = config;
+    return {
+        sourceFieldKey: fieldKey,
+        config: convertBuiltInToCustomValidator(builtInConfig),
+        validatorType: config.type,
+        dependsOn: extractStringDependencies(builtInConfig.expression || ''),
+        category: 'validator',
+    };
 }
 function tryCreateLogicEntry(fieldKey, config) {
             if (!isStateLogicConfig(config)) {
@@ -4180,7 +4094,7 @@ function createDerivationRenderGate() {
         if (!has || engine() !== 'idle')
             return;
         engine.set('loading');
-                pendingTasks.run(() => import('./ng-forge-dynamic-forms-bootstrap-derivation-orchestrator-CFSJLZPZ.mjs')
+                pendingTasks.run(() => import('./ng-forge-dynamic-forms-bootstrap-derivation-orchestrator-DWIWQjjZ.mjs')
             .then(({ bootstrapDerivationOrchestrator }) => {
             runInInjectionContext(injector, () => bootstrapDerivationOrchestrator());
             engine.set('wired');
@@ -4679,28 +4593,28 @@ const DISPLAY_FIELD_TYPES_BASE = {
 const BUILT_IN_FIELDS = [
     {
         name: 'row',
-                                loadComponent: () => import('./ng-forge-dynamic-forms-container-field.component-B_bQ-f2g.mjs'),
+                                loadComponent: () => import('./ng-forge-dynamic-forms-container-field.component-CSYhRBe6.mjs'),
         mapper: rowFieldMapper,
         valueHandling: 'flatten',
         ...CONTAINER_FIELD_TYPES_BASE,
     },
     {
         name: 'group',
-        loadComponent: () => import('./ng-forge-dynamic-forms-group-field.component-Bl9WRPvF.mjs'),
+        loadComponent: () => import('./ng-forge-dynamic-forms-group-field.component-DqhHzVsN.mjs'),
         mapper: groupFieldMapper,
         valueHandling: 'include',
         ...CONTAINER_FIELD_TYPES_BASE,
     },
     {
         name: 'array',
-        loadComponent: () => import('./ng-forge-dynamic-forms-array-field.component-CftX-bCB.mjs'),
+        loadComponent: () => import('./ng-forge-dynamic-forms-array-field.component-DCHrAcfd.mjs'),
         mapper: arrayFieldMapper,
         valueHandling: 'include',
         ...CONTAINER_FIELD_TYPES_BASE,
     },
     {
         name: 'page',
-        loadComponent: () => import('./ng-forge-dynamic-forms-page-field.component-C9bQkVjQ.mjs'),
+        loadComponent: () => import('./ng-forge-dynamic-forms-page-field.component-Vvk3fYZp.mjs'),
         mapper: pageFieldMapper,
         valueHandling: 'flatten',
         ...CONTAINER_FIELD_TYPES_BASE,
@@ -4718,7 +4632,7 @@ const BUILT_IN_FIELDS = [
     },
     {
         name: 'container',
-        loadComponent: () => import('./ng-forge-dynamic-forms-container-field.component-B_bQ-f2g.mjs'),
+        loadComponent: () => import('./ng-forge-dynamic-forms-container-field.component-CSYhRBe6.mjs'),
         mapper: containerFieldMapper,
         valueHandling: 'flatten',
         ...CONTAINER_FIELD_TYPES_BASE,
@@ -5122,4 +5036,4 @@ function arrayEvent(arrayKey) {
 
 
 export { withValueExclusionDefaults as $, ArrayItemRegistryService as A, BUILT_IN_FIELDS as B, CONTAINER_FIELD_PROCESSORS as C, DfFieldOutlet as D, EventDispatcher as E, FormStateManager as F, PrependArrayItemEvent as G, PreviousPageEvent as H, InsertArrayItemEvent as I, TextAddonComponent as J, arrayEvent as K, createWrappers as L, MoveArrayItemEvent as M, NextPageEvent as N, isWrappersBundle as O, PROPERTY_OVERRIDE_STORE as P, provideDynamicForm as Q, RemoveAtIndexEvent as R, ShiftArrayItemEvent as S, TemplateAddonComponent as T, sanitizeFormConfig as U, withAddonActions as V, withCustomAddon as W, withEventFormValue as X, withLegacyStatusClasses as Y, withLoggerConfig as Z, withValidationExecutionDefaults as _, isSameWrapperChain as a, wrapperProps as a0, createWrapperChainController as b, createFieldResolutionPipe as c, createSchemaFromFields as d, createHiddenSignal as e, createRenderReadySignal as f, getNormalizedArrayMetadata as g, getFieldDefaultValue as h, injectFieldRegistry as i, DEV_MODE as j, DEFAULT_DEBOUNCE_MS as k, DERIVATION_WARNING_TRACKER as l, mapFieldToInputs as m, DERIVATION_LOG_CONFIG as n, AppendArrayItemEvent as o, ComponentAddonComponent as p, ConsoleLogger as q, resolveWrappers as r, DfTemplate as s, traverseFieldsWithContext as t, DynamicForm as u, FormClearEvent as v, FormResetEvent as w, FormSubmitEvent as x, PageChangeEvent as y, PopArrayItemEvent as z };
-//# sourceMappingURL=ng-forge-dynamic-forms-ng-forge-dynamic-forms-fMB33l2f.mjs.map
+//# sourceMappingURL=ng-forge-dynamic-forms-ng-forge-dynamic-forms-BYyZ_cuA.mjs.map