commons-shared-web-ui 0.0.59 → 0.0.61

package/index.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { OnChanges, EventEmitter, SimpleChanges, ChangeDetectorRef, OnInit, OnDestroy, ElementRef, QueryList, PipeTransform, AfterViewInit, NgZone } from '@angular/core';
+import { OnChanges, EventEmitter, SimpleChanges, ChangeDetectorRef, OnInit, AfterViewInit, OnDestroy, ElementRef, QueryList, PipeTransform, NgZone } from '@angular/core';
 import * as i2 from '@angular/material/snack-bar';
 import { MatSnackBar, MatSnackBarRef } from '@angular/material/snack-bar';
 import * as i2$1 from '@angular/common';
@@ -258,6 +258,14 @@ interface FieldConfig {
     subType?: string;
     visible?: boolean;
     visibilityExpression?: string;
+    /**
+     * A boolean expression string (same syntax as visibilityExpression) evaluated
+     * at runtime to dynamically toggle the `required` validator on this control.
+     * When omitted, the static `required` boolean governs validation as before —
+     * fully backwards-compatible.
+     * Example: "[12,15].indexOf(Number(sessionTypeId)) !== -1"
+     */
+    requiredExpression?: string;
     isEnabled?: boolean;
     required?: boolean;
     disabled?: boolean;
@@ -1387,10 +1395,11 @@ interface TimePickerConfig {
     disabledColor?: string;
 }
 
-declare class FormFieldComponent implements OnInit, OnDestroy {
+declare class FormFieldComponent implements OnInit, AfterViewInit, OnDestroy {
     private fb;
     private expressionService;
     private http;
+    private hostRef;
     config: FieldConfig;
     controller: SmartFormController;
     /**
@@ -1446,6 +1455,7 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
     mediaDeviceInput: ElementRef<HTMLInputElement>;
     /** Host div for the library picker — always in DOM, moved to body to escape parent transforms */
     libraryModalRef: ElementRef<HTMLDivElement>;
+    private portalElement;
     showMediaMenu: boolean;
     showYoutubeInput: boolean;
     youtubeUrlInput: string;
@@ -1525,7 +1535,9 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
      * Priority: sectionConfig.name > field.name > camelCase(label) > '__group__'
      */
     get groupKey(): string;
-    constructor(fb: FormBuilder, expressionService: ExpressionService, http: HttpClient);
+    constructor(fb: FormBuilder, expressionService: ExpressionService, http: HttpClient, hostRef: ElementRef<HTMLElement>);
+    /** Portal root, resolved from this component's own node rather than the global document. */
+    private get portalRoot();
     ngOnInit(): void;
     get addMultiLabel(): string;
     /** Getter for Select placeholder label */
@@ -1588,6 +1600,25 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
      */
     setupMatchValidation(): void;
     setupVisibility(): void;
+    /**
+     * When config.requiredExpression is set, dynamically re-evaluates the required
+     * validator whenever any referenced variable changes in the controller.
+     * Fully backwards-compatible: fields without requiredExpression are unaffected.
+     */
+    setupRequiredExpression(): void;
+    /**
+     * Returns all validators from getValidators() except Validators.required.
+     * Used by setupRequiredExpression() to rebuild the validator list without
+     * duplicating the required validator.
+     */
+    private getValidatorsWithoutRequired;
+    /**
+     * trackBy function for field *ngFor loops in ROW containers.
+     * Keying by field name (or type as fallback for unnamed containers) prevents
+     * Angular from destroying and recreating FormFieldComponent instances on re-render,
+     * preserving localOptionList cache and avoiding duplicate API calls.
+     */
+    trackByFieldName(_: number, field: FieldConfig): string;
     setupMinDateField(): void;
     /**
      * Wires up a dynamic minimum for a TIME field from a sibling TIME field
@@ -1684,7 +1715,7 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
     /** Execute client-side or server-side dropdown search. */
     private executeDropdownSearch;
     /** Resets the dropdown search text and filtered list. */
-    resetDropdownSearch(): void;
+    resetDropdownSearch(forceLoad?: boolean, bypassCache?: boolean): void;
     /** Merges option(s) from selectedOptionsData into the local dropdown options list */
     mergeSelectedOptionsIntoList(): void;
     /**
@@ -2034,6 +2065,14 @@ declare class FormSectionComponent implements OnInit, OnDestroy {
     get flatFormGroup(): FormGroup;
     /** Flatten a field tree to get all leaf fields (for ROW children etc.) */
     getFlatFields(fields: FieldConfig[]): FieldConfig[];
+    /**
+     * trackBy function for field *ngFor loops.
+     * Keying by field name (or type as fallback for unnamed containers) prevents
+     * Angular from destroying and recreating FormFieldComponent instances when the
+     * parent re-renders — preserving localOptionList cache and avoiding duplicate
+     * API calls.
+     */
+    trackByFieldName(_: number, field: FieldConfig): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<FormSectionComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<FormSectionComponent, "lib-form-section", never, { "config": { "alias": "config"; "required": false; }; "controller": { "alias": "controller"; "required": false; }; "formGroup": { "alias": "formGroup"; "required": false; }; }, {}, never, never, false, never>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "commons-shared-web-ui",
-  "version": "0.0.59",
+  "version": "0.0.61",
   "peerDependencies": {
     "@angular/animations": "20.3.15",
     "@angular/cdk": "20.2.14",