mn-angular-lib 1.0.25 → 1.0.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mn-angular-lib",
-  "version": "1.0.25",
+  "version": "1.0.26",
   "peerDependencies": {
     "@angular/common": "^21.1.3",
     "@angular/core": "^21.1.3"

package/types/mn-angular-lib.d.ts

@@ -2343,6 +2343,11 @@ type ModalInputMap = Record<string, unknown>;
  * whether the field should be visible.
  */
 type FieldVisibilityCondition<TModel = any> = (formValue: Partial<TModel>) => boolean;
+/**
+ * A condition function that receives the current form values and returns
+ * whether the field should be required.
+ */
+type FieldRequiredCondition<TModel = any> = (formValue: Partial<TModel>) => boolean;
 /**
  * A form-level validator that receives the entire form value
  * and returns an error map or null.
@@ -2441,6 +2446,8 @@ interface TextFieldConfig<TModel = unknown> {
     disabled?: boolean;
     /** Condition to show/hide this field based on other field values */
     visible?: FieldVisibilityCondition<TModel>;
+    /** Condition to dynamically mark this field as required based on other field values */
+    conditionallyRequired?: FieldRequiredCondition<TModel>;
     /** Input mask (e.g., '(000) 000-0000') */
     mask?: string;
     /** Autocomplete attribute */
@@ -2463,6 +2470,8 @@ interface NumberFieldConfig<TModel = unknown> {
     readOnly?: boolean;
     disabled?: boolean;
     visible?: FieldVisibilityCondition<TModel>;
+    /** Condition to dynamically mark this field as required based on other field values */
+    conditionallyRequired?: FieldRequiredCondition<TModel>;
     autoFocus?: boolean;
     updateOn?: 'change' | 'blur' | 'submit';
 }
@@ -2477,6 +2486,8 @@ interface SelectFieldConfig<TModel = unknown, TValue = unknown> {
     readOnly?: boolean;
     disabled?: boolean;
     visible?: FieldVisibilityCondition<TModel>;
+    /** Condition to dynamically mark this field as required based on other field values */
+    conditionallyRequired?: FieldRequiredCondition<TModel>;
     autoFocus?: boolean;
     updateOn?: 'change' | 'blur' | 'submit';
     /** Async data source for loading options dynamically */
@@ -2492,6 +2503,8 @@ interface CheckboxFieldConfig<TModel = unknown> {
     readOnly?: boolean;
     disabled?: boolean;
     visible?: FieldVisibilityCondition<TModel>;
+    /** Condition to dynamically mark this field as required based on other field values */
+    conditionallyRequired?: FieldRequiredCondition<TModel>;
     autoFocus?: boolean;
     updateOn?: 'change' | 'blur' | 'submit';
 }
@@ -2507,6 +2520,8 @@ interface DateFieldConfig<TModel = unknown> {
     readOnly?: boolean;
     disabled?: boolean;
     visible?: FieldVisibilityCondition<TModel>;
+    /** Condition to dynamically mark this field as required based on other field values */
+    conditionallyRequired?: FieldRequiredCondition<TModel>;
     autoFocus?: boolean;
     updateOn?: 'change' | 'blur' | 'submit';
 }
@@ -2521,6 +2536,8 @@ interface TextareaFieldConfig<TModel = unknown> {
     readOnly?: boolean;
     disabled?: boolean;
     visible?: FieldVisibilityCondition<TModel>;
+    /** Condition to dynamically mark this field as required based on other field values */
+    conditionallyRequired?: FieldRequiredCondition<TModel>;
     autoFocus?: boolean;
     updateOn?: 'change' | 'blur' | 'submit';
 }
@@ -2538,6 +2555,8 @@ interface DatetimeFieldConfig<TModel = unknown> {
     readOnly?: boolean;
     disabled?: boolean;
     visible?: FieldVisibilityCondition<TModel>;
+    /** Condition to dynamically mark this field as required based on other field values */
+    conditionallyRequired?: FieldRequiredCondition<TModel>;
     autoFocus?: boolean;
     updateOn?: 'change' | 'blur' | 'submit';
 }
@@ -2554,6 +2573,8 @@ interface MultiSelectFieldConfig<TModel = unknown, TValue = unknown> {
     readOnly?: boolean;
     disabled?: boolean;
     visible?: FieldVisibilityCondition<TModel>;
+    /** Condition to dynamically mark this field as required based on other field values */
+    conditionallyRequired?: FieldRequiredCondition<TModel>;
     autoFocus?: boolean;
     updateOn?: 'change' | 'blur' | 'submit';
     /** Async data source for loading options dynamically */
@@ -2569,6 +2590,8 @@ interface PasswordFieldConfig<TModel = unknown> {
     readOnly?: boolean;
     disabled?: boolean;
     visible?: FieldVisibilityCondition<TModel>;
+    /** Condition to dynamically mark this field as required based on other field values */
+    conditionallyRequired?: FieldRequiredCondition<TModel>;
     autoFocus?: boolean;
     updateOn?: 'change' | 'blur' | 'submit';
 }
@@ -2585,6 +2608,8 @@ interface MultiSelectTableFieldConfig<TModel = unknown, TRow = any> {
     readOnly?: boolean;
     disabled?: boolean;
     visible?: FieldVisibilityCondition<TModel>;
+    /** Condition to dynamically mark this field as required based on other field values */
+    conditionallyRequired?: FieldRequiredCondition<TModel>;
     autoFocus?: boolean;
     updateOn?: 'change' | 'blur' | 'submit';
 }
@@ -2601,6 +2626,8 @@ interface SingleSelectTableFieldConfig<TModel = unknown, TRow = any> {
     readOnly?: boolean;
     disabled?: boolean;
     visible?: FieldVisibilityCondition<TModel>;
+    /** Condition to dynamically mark this field as required based on other field values */
+    conditionallyRequired?: FieldRequiredCondition<TModel>;
     autoFocus?: boolean;
     updateOn?: 'change' | 'blur' | 'submit';
 }
@@ -2617,6 +2644,8 @@ interface ColorFieldConfig<TModel = unknown> {
     readOnly?: boolean;
     disabled?: boolean;
     visible?: FieldVisibilityCondition<TModel>;
+    /** Condition to dynamically mark this field as required based on other field values */
+    conditionallyRequired?: FieldRequiredCondition<TModel>;
     autoFocus?: boolean;
     updateOn?: 'change' | 'blur' | 'submit';
 }
@@ -2635,6 +2664,8 @@ interface RatingFieldConfig<TModel = unknown> {
     readOnly?: boolean;
     disabled?: boolean;
     visible?: FieldVisibilityCondition<TModel>;
+    /** Condition to dynamically mark this field as required based on other field values */
+    conditionallyRequired?: FieldRequiredCondition<TModel>;
     autoFocus?: boolean;
     updateOn?: 'change' | 'blur' | 'submit';
 }
@@ -2657,6 +2688,8 @@ interface SliderFieldConfig<TModel = unknown> {
     readOnly?: boolean;
     disabled?: boolean;
     visible?: FieldVisibilityCondition<TModel>;
+    /** Condition to dynamically mark this field as required based on other field values */
+    conditionallyRequired?: FieldRequiredCondition<TModel>;
     autoFocus?: boolean;
     updateOn?: 'change' | 'blur' | 'submit';
 }
@@ -2677,6 +2710,8 @@ interface FileFieldConfig<TModel = unknown> {
     readOnly?: boolean;
     disabled?: boolean;
     visible?: FieldVisibilityCondition<TModel>;
+    /** Condition to dynamically mark this field as required based on other field values */
+    conditionallyRequired?: FieldRequiredCondition<TModel>;
     autoFocus?: boolean;
     updateOn?: 'change' | 'blur' | 'submit';
 }
@@ -2689,6 +2724,8 @@ interface CustomFieldConfig<TModel = unknown> {
     validators?: any[];
     asyncValidators?: any[];
     visible?: FieldVisibilityCondition<TModel>;
+    /** Condition to dynamically mark this field as required based on other field values */
+    conditionallyRequired?: FieldRequiredCondition<TModel>;
     autoFocus?: boolean;
     updateOn?: 'change' | 'blur' | 'submit';
 }
@@ -3296,6 +3333,8 @@ declare class MnFormBodyComponent<TModel = any, TResult = TModel> implements OnI
     formErrors: Record<string, string>;
     /** Track which fields are currently visible (for conditional fields) */
     fieldVisibility: Record<string, boolean>;
+    /** Track which fields are currently conditionally required */
+    fieldConditionallyRequired: Record<string, boolean>;
     /** Track loading state per field for async data sources */
     fieldLoading: Record<string, boolean>;
     /** Dynamic options loaded from data sources */
@@ -3339,6 +3378,19 @@ declare class MnFormBodyComponent<TModel = any, TResult = TModel> implements OnI
     isGroupVisible(group: FormFieldGroup<TModel>): boolean;
     private initializeVisibility;
     private updateVisibility;
+    /**
+     * Builds the full validator array for a field, including conditionallyRequired.
+     * @param fieldAny The field configuration.
+     * @param formValue The current form values.
+     * @returns Array of validators to apply.
+     */
+    private buildValidators;
+    /**
+     * Updates the conditionallyRequired state for a single field and adjusts validators.
+     * @param fieldAny The field configuration.
+     * @param formValue The current form values.
+     */
+    private updateConditionallyRequired;
     isFieldVisible(field: FormFieldConfig<TModel>): boolean;
     private runFormValidators;
     getFieldError(key: string): string | null;
@@ -5032,4 +5084,4 @@ interface MnPreviewMessage {
 declare function enableMnPreviewMode(configService: MnConfigService, langService: MnLanguageService, allowedOrigins?: string[]): void;
 
 export { API_BASE_URL, ActionStyle, BackdropMode, BaseModalBuilder, CALENDAR_CONFIG, CALENDAR_DATE_FORMATTER, CalendarDayComponent, CalendarEventComponent, CalendarEventDefaultComponent, CalendarEventLayoutService, CalendarMonthComponent, CalendarUtility, CalendarView, CalendarViewComponent, CalendarWeekComponent, CloseMode, ColumnSortType, ConfirmationModalBuilder, ConfirmationTone, CrudService, CustomModalBuilder, DEFAULT_CALENDAR_CONFIG, DEFAULT_MN_ALERT_CONFIG, DefaultCalendarDateFormatter, FieldAppearance, FieldKind, FormLayoutMode, FormModalBuilder, KeyboardMode, MN_ALERT_CONFIG, MN_CALENDAR_COMPONENT_NAME, MN_CALENDAR_CONFIG, MN_CHECKBOX_CONFIG, MN_DATETIME_CONFIG, MN_INPUT_FIELD_CONFIG, MN_INSTANCE_ID, MN_LIB_DUAL_HORIZONTAL_IMAGE, MN_MULTI_SELECT_CONFIG, MN_SECTION_PATH, MN_SELECT_CONFIG, MN_TEXTAREA_CONFIG, MnAlertOutletComponent, MnAlertService, MnAlertStore, MnBadge, MnButton, MnCheckbox, MnConfigService, MnConfirmationBodyComponent, MnCustomBodyHostComponent, MnDatetime, MnDualHorizontalImage, MnFormBodyComponent, MnHiddenBelowDirective, MnInformationCard, MnInputField, MnInstanceDirective, MnLanguageService, MnList, MnModalRef, MnModalService, MnModalShellComponent, MnMultiSelect, MnSectionDirective, MnSelect, MnTabComponent, MnTable, MnTextarea, MnTranslatePipe, MnWizardBodyComponent, ModalBuilder, ModalCloseReason, ModalIntent, ModalKind, ModalSize, NavigationDirection, OptionState, SelectionMode, StepBuilder, StepState, SubmitMode, UpcomingEventRowComponent, UpcomingEventsComponent, ValidationCode, ValidationStatus, WizardFlowMode, WizardModalBuilder, dateTimeAdapter, defaultTextAdapter, enableMnPreviewMode, isTranslatable, mnAlertVariants, mnBadgeVariants, mnButtonVariants, mnCheckboxVariants, mnCheckboxWrapperVariants, mnDatetimeVariants, mnInformationCardVariants, mnInputFieldVariants, mnMultiSelectVariants, mnSelectVariants, mnTextareaVariants, numberAdapter, pickAdapter, provideMnAlerts, provideMnCalendarConfig, provideMnComponentConfig, provideMnConfig, provideMnLanguage, resolveCalendarConfig };
-export type { AnimationOptions, ApiError, BaseModalConfig, CalendarButton, CalendarConfig, CalendarDateFormatter, CalendarEvent, CalendarEventData, CancellationActionConfig, CheckboxFieldConfig, ColorFieldConfig, ColorPreset, ColumnDay, ColumnDefinition, ColumnFilterOption, ColumnFilterState, ColumnFilterType, ConfirmationActionConfig, ConfirmationModalConfig, CrudConfig, CurrentTimeCalendarEvent, CursorPaginationStrategy, CustomFieldConfig, CustomModalConfig, DateFieldConfig, DatetimeFieldConfig, FailureResult, FieldDataSource, FieldValidator, FieldVisibilityCondition, FileFieldConfig, FormFieldConfig, FormFieldGroup, FormModalConfig, FormRow, FormRowField, FormValidator, HourRow, ListAppearance, ListDataSource, ListLabels, MnAlert, MnAlertConfig, MnAlertId, MnAlertKind, MnAlertTemplateContext, MnAlertVariants, MnBadgeTypes, MnBadgeVariants, MnButtonTypes, MnButtonVariants, MnCheckboxErrorMessageData, MnCheckboxErrorMessagesData, MnCheckboxProps, MnCheckboxUIConfig, MnCheckboxVariants, MnCheckboxWrapperVariants, MnConfigFile, MnConfigSettings, MnConfigValue, MnDatetimeErrorMessageData, MnDatetimeErrorMessagesData, MnDatetimeMode, MnDatetimeProps, MnDatetimeUIConfig, MnDatetimeVariants, MnDomAttrs, MnDualHorizontalImageConfig, MnDualHorizontalImageTypes, MnErrorMessageData, MnErrorMessagesData, MnImageType, MnInformationCardBaseData, MnInformationCardData, MnInformationCardVariants, MnInputAdapter, MnInputBaseProps, MnInputDateTimeProps, MnInputFieldProps, MnInputFieldUIConfig, MnInputProps, MnInputType, MnInputVariants, MnLanguageConfig, MnMultiSelectErrorMessageData, MnMultiSelectErrorMessagesData, MnMultiSelectOption, MnMultiSelectProps, MnMultiSelectUIConfig, MnMultiSelectVariants, MnPreviewMessage, MnSelectErrorMessageData, MnSelectErrorMessagesData, MnSelectOption, MnSelectProps, MnSelectUIConfig, MnSelectVariants, MnShowInput, MnTabDataSource, MnTabItem, MnTextareaErrorMessageData, MnTextareaErrorMessagesData, MnTextareaProps, MnTextareaUIConfig, MnTextareaVariants, MnTranslatable, MnTranslationMap, MnTranslations, ModalCancelHandler, ModalCloseEvent, ModalConfig, ModalFooterAction, ModalI18nLabels, ModalInputMap, ModalPollingConfig, ModalRef, ModalResultHandler, ModalStepId, MonthItem, MultiSelectFieldConfig, MultiSelectTableFieldConfig, NumberFieldConfig, OffsetPaginationStrategy, PaginationStrategy, PasswordFieldConfig, Primitive, QueryParams, QueryValue, RatingFieldConfig, Result, ResultMeta, SelectFieldConfig, SelectOption, SingleSelectTableFieldConfig, SliderFieldConfig, SortState, StepBodyConfig, StepGuard, StepValidator, SuccessResult, TableAppearance, TableDataSource, TableLabels, TextFieldConfig, TextareaFieldConfig, ValidationResult, WizardBeforeCompleteValidator, WizardModalConfig, WizardResult, WizardStepChangeEvent, WizardStepChangeHandler, WizardStepConfig };
+export type { AnimationOptions, ApiError, BaseModalConfig, CalendarButton, CalendarConfig, CalendarDateFormatter, CalendarEvent, CalendarEventData, CancellationActionConfig, CheckboxFieldConfig, ColorFieldConfig, ColorPreset, ColumnDay, ColumnDefinition, ColumnFilterOption, ColumnFilterState, ColumnFilterType, ConfirmationActionConfig, ConfirmationModalConfig, CrudConfig, CurrentTimeCalendarEvent, CursorPaginationStrategy, CustomFieldConfig, CustomModalConfig, DateFieldConfig, DatetimeFieldConfig, FailureResult, FieldDataSource, FieldRequiredCondition, FieldValidator, FieldVisibilityCondition, FileFieldConfig, FormFieldConfig, FormFieldGroup, FormModalConfig, FormRow, FormRowField, FormValidator, HourRow, ListAppearance, ListDataSource, ListLabels, MnAlert, MnAlertConfig, MnAlertId, MnAlertKind, MnAlertTemplateContext, MnAlertVariants, MnBadgeTypes, MnBadgeVariants, MnButtonTypes, MnButtonVariants, MnCheckboxErrorMessageData, MnCheckboxErrorMessagesData, MnCheckboxProps, MnCheckboxUIConfig, MnCheckboxVariants, MnCheckboxWrapperVariants, MnConfigFile, MnConfigSettings, MnConfigValue, MnDatetimeErrorMessageData, MnDatetimeErrorMessagesData, MnDatetimeMode, MnDatetimeProps, MnDatetimeUIConfig, MnDatetimeVariants, MnDomAttrs, MnDualHorizontalImageConfig, MnDualHorizontalImageTypes, MnErrorMessageData, MnErrorMessagesData, MnImageType, MnInformationCardBaseData, MnInformationCardData, MnInformationCardVariants, MnInputAdapter, MnInputBaseProps, MnInputDateTimeProps, MnInputFieldProps, MnInputFieldUIConfig, MnInputProps, MnInputType, MnInputVariants, MnLanguageConfig, MnMultiSelectErrorMessageData, MnMultiSelectErrorMessagesData, MnMultiSelectOption, MnMultiSelectProps, MnMultiSelectUIConfig, MnMultiSelectVariants, MnPreviewMessage, MnSelectErrorMessageData, MnSelectErrorMessagesData, MnSelectOption, MnSelectProps, MnSelectUIConfig, MnSelectVariants, MnShowInput, MnTabDataSource, MnTabItem, MnTextareaErrorMessageData, MnTextareaErrorMessagesData, MnTextareaProps, MnTextareaUIConfig, MnTextareaVariants, MnTranslatable, MnTranslationMap, MnTranslations, ModalCancelHandler, ModalCloseEvent, ModalConfig, ModalFooterAction, ModalI18nLabels, ModalInputMap, ModalPollingConfig, ModalRef, ModalResultHandler, ModalStepId, MonthItem, MultiSelectFieldConfig, MultiSelectTableFieldConfig, NumberFieldConfig, OffsetPaginationStrategy, PaginationStrategy, PasswordFieldConfig, Primitive, QueryParams, QueryValue, RatingFieldConfig, Result, ResultMeta, SelectFieldConfig, SelectOption, SingleSelectTableFieldConfig, SliderFieldConfig, SortState, StepBodyConfig, StepGuard, StepValidator, SuccessResult, TableAppearance, TableDataSource, TableLabels, TextFieldConfig, TextareaFieldConfig, ValidationResult, WizardBeforeCompleteValidator, WizardModalConfig, WizardResult, WizardStepChangeEvent, WizardStepChangeHandler, WizardStepConfig };