@pega/angular-sdk-overrides 0.25.15 → 0.26.2

package/lib/field/decimal/decimal.component.ts

@@ -6,6 +6,7 @@ import { MatFormFieldModule } from '@angular/material/form-field';
 import { NgxCurrencyDirective, NgxCurrencyInputMode } from 'ngx-currency';
 
 import { FieldBase } from '@pega/angular-sdk-components';
+import { FieldWarningDirective } from '@pega/angular-sdk-components';
 import { ComponentMapperComponent } from '@pega/angular-sdk-components';
 import { handleEvent } from '@pega/angular-sdk-components';
 import { getCurrencyCharacters, getCurrencyOptions } from '@pega/angular-sdk-components';
@@ -31,6 +32,7 @@ interface DecimalProps extends PConnFieldProps {
     MatFormFieldModule,
     MatInputModule,
     NgxCurrencyDirective,
+    FieldWarningDirective,
     forwardRef(() => ComponentMapperComponent)
   ]
 })

package/lib/field/dropdown/dropdown.component.html

@@ -8,7 +8,7 @@
 <ng-template #noDisplayMode>
   <div *ngIf="!bReadonly$ && bHasForm$; else noEdit">
     <div [formGroup]="formGroup$" *ngIf="bVisible$">
-      <mat-form-field class="psdk-full-width" subscriptSizing="dynamic" [hintLabel]="helperText">
+      <mat-form-field class="psdk-full-width" subscriptSizing="dynamic">
         <mat-select
           [value]="value$"
           [required]="bRequired$"
@@ -22,6 +22,7 @@
           </mat-option>
         </mat-select>
         <mat-label>{{ label$ }}</mat-label>
+        <mat-hint *ngIf="helperText" [appFieldWarning]="bFieldMessageVisible$">{{ helperText }}</mat-hint>
         <mat-error *ngIf="fieldControl.invalid">{{ getErrorMessage() }}</mat-error>
       </mat-form-field>
     </div>

package/lib/field/dropdown/dropdown.component.ts

@@ -7,6 +7,7 @@ import { MatFormFieldModule } from '@angular/material/form-field';
 import isEqual from 'fast-deep-equal';
 
 import { FieldBase } from '@pega/angular-sdk-components';
+import { FieldWarningDirective } from '@pega/angular-sdk-components';
 import { ComponentMapperComponent } from '@pega/angular-sdk-components';
 import { handleEvent } from '@pega/angular-sdk-components';
 import { PConnFieldProps } from '@pega/angular-sdk-components';
@@ -66,7 +67,15 @@ interface DropdownProps extends PConnFieldProps {
   selector: 'app-dropdown',
   templateUrl: './dropdown.component.html',
   styleUrls: ['./dropdown.component.scss'],
-  imports: [CommonModule, ReactiveFormsModule, MatFormFieldModule, MatSelectModule, MatOptionModule, forwardRef(() => ComponentMapperComponent)]
+  imports: [
+    CommonModule,
+    ReactiveFormsModule,
+    MatFormFieldModule,
+    MatSelectModule,
+    MatOptionModule,
+    FieldWarningDirective,
+    forwardRef(() => ComponentMapperComponent)
+  ]
 })
 export class DropdownComponent extends FieldBase implements OnInit, OnDestroy {
   @Output() onRecordChange: EventEmitter<any> = new EventEmitter();

package/lib/field/email/email.component.html

@@ -4,7 +4,7 @@
 <ng-template #noDisplayMode>
   <div *ngIf="!bReadonly$ && bHasForm$; else noEdit">
     <div [formGroup]="formGroup$" *ngIf="bVisible$">
-      <mat-form-field class="psdk-full-width" subscriptSizing="dynamic" [hintLabel]="helperText">
+      <mat-form-field class="psdk-full-width" subscriptSizing="dynamic">
         <mat-label>{{ label$ }}</mat-label>
         <input
           matInput
@@ -17,6 +17,7 @@
           (change)="fieldOnChange($event)"
           (blur)="fieldOnBlur($event)"
         />
+        <mat-hint *ngIf="helperText" [appFieldWarning]="bFieldMessageVisible$">{{ helperText }}</mat-hint>
         <mat-error *ngIf="fieldControl.invalid">{{ getErrorMessage() }}</mat-error>
       </mat-form-field>
     </div>

package/lib/field/email/email.component.ts

@@ -5,6 +5,7 @@ import { MatInputModule } from '@angular/material/input';
 import { MatFormFieldModule } from '@angular/material/form-field';
 
 import { FieldBase } from '@pega/angular-sdk-components';
+import { FieldWarningDirective } from '@pega/angular-sdk-components';
 import { ComponentMapperComponent } from '@pega/angular-sdk-components';
 import { handleEvent } from '@pega/angular-sdk-components';
 import { PConnFieldProps } from '@pega/angular-sdk-components';
@@ -17,7 +18,7 @@ interface EmailProps extends PConnFieldProps {
   selector: 'app-email',
   templateUrl: './email.component.html',
   styleUrls: ['./email.component.scss'],
-  imports: [CommonModule, ReactiveFormsModule, MatFormFieldModule, MatInputModule, forwardRef(() => ComponentMapperComponent)]
+  imports: [CommonModule, ReactiveFormsModule, MatFormFieldModule, MatInputModule, FieldWarningDirective, forwardRef(() => ComponentMapperComponent)]
 })
 export class EmailComponent extends FieldBase implements OnInit, OnDestroy {
   configProps$: EmailProps;
@@ -28,7 +29,6 @@ export class EmailComponent extends FieldBase implements OnInit, OnDestroy {
   override updateSelf(): void {
     // Resolve configuration properties
     this.configProps$ = this.pConn$.resolveConfigProps(this.pConn$.getConfigProps()) as EmailProps;
-
     // Update component common properties
     this.updateComponentCommonProperties(this.configProps$);
 

package/lib/field/embedded-data-multi/embedded-data-multi.component.html

@@ -0,0 +1,3 @@
+<div *ngIf="bVisible$ && simpleTableComponentName">
+  <component-mapper [name]="simpleTableComponentName" [props]="{ pConn$: simpleTablePConn, formGroup$ }"></component-mapper>
+</div>

package/lib/field/embedded-data-multi/embedded-data-multi.component.ts

@@ -0,0 +1,173 @@
+import { CommonModule } from '@angular/common';
+import { Component, Input, OnInit, OnDestroy, forwardRef } from '@angular/core';
+import { FormGroup } from '@angular/forms';
+
+import { AngularPConnectData, AngularPConnectService } from '@pega/angular-sdk-components';
+import { ComponentMapperComponent } from '@pega/angular-sdk-components';
+
+interface EmbeddedDataMultiProps {
+  addEditAction?: string;
+  addEditView?: string;
+  displayAs?: string;
+  editAction?: string;
+  editMode?: string;
+  editType?: string;
+  editView?: string;
+  readOnly?: boolean;
+  repeatingView?: string;
+  targetObjectClass?: string;
+  useSeparateActionForEdit?: boolean;
+  useSeparateViewForEdit?: boolean;
+  visibility?: boolean;
+}
+
+@Component({
+  selector: 'app-embedded-data-multi',
+  templateUrl: './embedded-data-multi.component.html',
+  styleUrls: ['./embedded-data-multi.component.scss'],
+  imports: [CommonModule, forwardRef(() => ComponentMapperComponent)]
+})
+export class EmbeddedDataMultiComponent implements OnInit, OnDestroy {
+  @Input() pConn$: typeof PConnect;
+  @Input() formGroup$: FormGroup;
+
+  angularPConnectData: AngularPConnectData = {};
+  simpleTablePConn: typeof PConnect;
+  simpleTableComponentName = '';
+  bVisible$ = true;
+
+  constructor(private angularPConnect: AngularPConnectService) {}
+
+  ngOnInit(): void {
+    this.angularPConnectData = this.angularPConnect.registerAndSubscribeComponent(this, this.onStateChange);
+    this.checkAndUpdate();
+  }
+
+  ngOnDestroy(): void {
+    if (this.angularPConnectData.unsubscribeFn) {
+      this.angularPConnectData.unsubscribeFn();
+    }
+  }
+
+  onStateChange = () => {
+    this.checkAndUpdate();
+  };
+
+  checkAndUpdate() {
+    const bUpdateSelf = this.angularPConnect.shouldComponentUpdate(this);
+    if (bUpdateSelf) {
+      this.updateSelf();
+    }
+  }
+
+  updateSelf() {
+    const configProps = this.pConn$.resolveConfigProps(this.pConn$.getConfigProps()) as EmbeddedDataMultiProps;
+    const {
+      addEditAction,
+      addEditView,
+      displayAs,
+      editAction,
+      editMode,
+      editType,
+      editView,
+      readOnly = false,
+      repeatingView,
+      targetObjectClass,
+      useSeparateActionForEdit,
+      useSeparateViewForEdit,
+      visibility = true
+    } = configProps;
+
+    this.bVisible$ = visibility !== false;
+
+    const rawMetadata = this.pConn$.getRawMetadata();
+    const rawMetadataConfig = rawMetadata?.config as any;
+
+    if (!rawMetadataConfig) {
+      return;
+    }
+
+    const renderMode = readOnly ? 'ReadOnly' : 'Editable';
+
+    let columnsChildren;
+    if (displayAs === 'table' || displayAs === 'simpleTable') {
+      columnsChildren = [
+        {
+          children: rawMetadataConfig.columns || [],
+          name: 'Columns',
+          type: 'Region'
+        }
+      ];
+    }
+
+    let regionWithView: any[] = [];
+    if (displayAs === 'repeatingView') {
+      regionWithView = [
+        {
+          children: [
+            {
+              type: 'reference',
+              config: {
+                type: 'view',
+                name: repeatingView
+              }
+            }
+          ],
+          name: 'view',
+          type: 'Region'
+        }
+      ];
+    }
+
+    const { pagelistValue } = rawMetadataConfig;
+    const authorContext = pagelistValue?.startsWith('@P') ? pagelistValue?.substring(3) : pagelistValue;
+
+    const componentConfig = {
+      type: 'View',
+      config: {
+        template: 'SimpleTable',
+        type: 'multirecordlist',
+        authorContext,
+        name: authorContext?.substring(1),
+        renderMode,
+        multiRecordDisplayAs: displayAs === 'repeatingView' ? 'fieldGroup' : displayAs,
+        referenceList: pagelistValue,
+        contextClass: targetObjectClass,
+        editMode,
+        editModeConfig: {
+          editType,
+          defaultView: addEditView,
+          defaultAction: addEditAction,
+          useSeparateViewForEdit,
+          useSeparateActionForEdit,
+          editView,
+          editAction
+        },
+        label: rawMetadataConfig.label,
+        hideLabel: rawMetadataConfig.hideLabel,
+        children: columnsChildren,
+        displayField: rawMetadataConfig.displayField,
+        uniqueField: rawMetadataConfig.uniqueField,
+        targetClassLabel: rawMetadataConfig.targetClassLabel,
+        targetClassLabelOption: rawMetadataConfig.targetClassLabelOption,
+        fieldHeader: rawMetadataConfig.repeatingViewHeadingSource,
+        heading: rawMetadataConfig.repeatingViewHeading,
+        allowActions: {
+          allowAdd: rawMetadataConfig.allowAdd ?? true,
+          allowEdit: rawMetadataConfig.allowEdit ?? true,
+          allowDelete: rawMetadataConfig.allowDelete ?? true,
+          allowDragDrop: rawMetadataConfig.allowDragDrop ?? true
+        },
+        allowRowDelete: rawMetadataConfig.allowRowDelete ?? true,
+        allowRowEdit: rawMetadataConfig.allowRowEdit ?? true
+      },
+      children: regionWithView
+    };
+
+    const component = this.pConn$.createComponent(componentConfig as any, '', 0, {});
+    if (component) {
+      this.simpleTablePConn = component.getPConnect();
+      this.simpleTableComponentName = this.simpleTablePConn.getComponentName() ?? '';
+    }
+  }
+}

package/lib/field/field.base.ts

@@ -3,6 +3,7 @@ import { FormControl, FormGroup } from '@angular/forms';
 
 import { AngularPConnectData, AngularPConnectService } from '@pega/angular-sdk-components';
 import { Utils } from '@pega/angular-sdk-components';
+import type { PConnFieldProps } from '../../_types/PConnProps.interface';
 
 @Directive()
 export class FieldBase implements OnInit, OnDestroy {
@@ -31,6 +32,10 @@ export class FieldBase implements OnInit, OnDestroy {
   bDisabled$ = false;
   bVisible$ = true;
   displayMode$ = '';
+  bFieldMessageVisible$ = false;
+  fieldMessage = '';
+
+  private defaultHelperText = '';
 
   /**
    * Initializes the component, registers with AngularPConnect, and sets up form control.
@@ -101,7 +106,7 @@ export class FieldBase implements OnInit, OnDestroy {
     this.label$ = label;
     this.hideLabel = hideLabel;
     this.displayMode$ = displayMode;
-    this.helperText = helperText;
+    this.defaultHelperText = helperText ?? '';
     this.placeholder = placeholder || '';
 
     // Convert boolean properties
@@ -113,10 +118,27 @@ export class FieldBase implements OnInit, OnDestroy {
     // Enable or disable field control
     this.fieldControl[this.bDisabled$ ? 'disable' : 'enable']();
 
+    this.updateFieldMessage(configProps);
+
     // Display error message if validation message exists
     this.displayValidationMessage();
   }
 
+  /**
+   * Updates the contextual field message state for fields that support it.
+   *
+   * @param configProps The resolved field configuration.
+   */
+  protected updateFieldMessage(configProps: Pick<PConnFieldProps, 'messageConfig' | 'showFieldMessage'>): void {
+    const { messageConfig = {}, showFieldMessage } = configProps;
+    const isVisible = this.utils.getBooleanValue(messageConfig.visibility);
+    const shouldShowFieldMessage = this.utils.getBooleanValue(showFieldMessage) && isVisible && !this.bReadonly$;
+
+    this.bFieldMessageVisible$ = shouldShowFieldMessage;
+    this.fieldMessage = shouldShowFieldMessage ? (messageConfig.content ?? '') : '';
+    this.updateHelperText();
+  }
+
   /**
    * Displays the validation message if it exists.
    */
@@ -129,6 +151,10 @@ export class FieldBase implements OnInit, OnDestroy {
     }
   }
 
+  private updateHelperText(): void {
+    this.helperText = this.bFieldMessageVisible$ ? this.fieldMessage : this.defaultHelperText;
+  }
+
   /**
    * Retrieves the error message for the current field control.
    *

package/lib/field/integer/integer.component.html

@@ -4,7 +4,7 @@
 <ng-template #noDisplayMode>
   <div *ngIf="!bReadonly$ && bHasForm$; else noEdit">
     <div [formGroup]="formGroup$" *ngIf="bVisible$">
-      <mat-form-field class="psdk-full-width" subscriptSizing="dynamic" [hintLabel]="helperText">
+      <mat-form-field class="psdk-full-width" subscriptSizing="dynamic">
         <mat-label>{{ label$ }}</mat-label>
         <input
           matInput
@@ -18,6 +18,7 @@
           (change)="fieldOnChange($event)"
           (blur)="fieldOnBlur($event)"
         />
+        <mat-hint *ngIf="helperText" [appFieldWarning]="bFieldMessageVisible$">{{ helperText }}</mat-hint>
         <mat-error *ngIf="fieldControl.invalid">{{ getErrorMessage() }}</mat-error>
       </mat-form-field>
     </div>

package/lib/field/integer/integer.component.ts

@@ -5,6 +5,7 @@ import { MatInputModule } from '@angular/material/input';
 import { MatFormFieldModule } from '@angular/material/form-field';
 
 import { FieldBase } from '@pega/angular-sdk-components';
+import { FieldWarningDirective } from '@pega/angular-sdk-components';
 import { ComponentMapperComponent } from '@pega/angular-sdk-components';
 import { handleEvent } from '@pega/angular-sdk-components';
 import { PConnFieldProps } from '@pega/angular-sdk-components';
@@ -17,7 +18,7 @@ interface IntegerProps extends PConnFieldProps {
   selector: 'app-integer',
   templateUrl: './integer.component.html',
   styleUrls: ['./integer.component.scss'],
-  imports: [CommonModule, ReactiveFormsModule, MatFormFieldModule, MatInputModule, forwardRef(() => ComponentMapperComponent)]
+  imports: [CommonModule, ReactiveFormsModule, MatFormFieldModule, MatInputModule, FieldWarningDirective, forwardRef(() => ComponentMapperComponent)]
 })
 export class IntegerComponent extends FieldBase {
   configProps$: IntegerProps;
@@ -57,7 +58,8 @@ export class IntegerComponent extends FieldBase {
 
     if (isValueChanged) {
       const value = event?.target?.value;
-      handleEvent(this.actionsApi, 'changeNblur', this.propName, value);
+      const normalizedValue = value === '' ? '' : Number(value);
+      handleEvent(this.actionsApi, 'changeNblur', this.propName, normalizedValue);
     }
   }
 }

package/lib/field/location/location.component.html

@@ -1,6 +1,6 @@
 <div *ngIf="mapReady && bVisible$">
   <!-- Google suggestions -->
-  <mat-form-field class="psdk-full-width" [hintLabel]="helperText">
+  <mat-form-field class="psdk-full-width">
     <mat-label>{{ label$ }}</mat-label>
     <input
       matInput
@@ -14,6 +14,7 @@
       (blur)="fieldOnBlur()"
     />
     <mat-error *ngIf="fieldControl.invalid">{{ getErrorMessage() }}</mat-error>
+    <mat-hint *ngIf="helperText" [appFieldWarning]="bFieldMessageVisible$">{{ helperText }}</mat-hint>
     <button
       mat-icon-button
       matSuffix

package/lib/field/location/location.component.ts

@@ -11,6 +11,7 @@ import { GoogleMapsModule } from '@angular/google-maps';
 import { debounceTime, from, of, switchMap } from 'rxjs';
 
 import { FieldBase } from '@pega/angular-sdk-components';
+import { FieldWarningDirective } from '@pega/angular-sdk-components';
 import { GoogleMapsLoaderService } from '@pega/angular-sdk-components';
 import { handleEvent } from '@pega/angular-sdk-components';
 
@@ -34,7 +35,8 @@ interface LocationProps extends PConnFieldProps {
     MatIconModule,
     MatInputModule,
     MatProgressSpinnerModule,
-    ReactiveFormsModule
+    ReactiveFormsModule,
+    FieldWarningDirective
   ],
   templateUrl: './location.component.html',
   styleUrl: './location.component.scss'

package/lib/field/multiselect/multiselect.component.html

@@ -1,7 +1,7 @@
 <div [formGroup]="formGroup$">
   <mat-form-field class="psdk-full-width" subscriptSizing="dynamic">
     <mat-label>{{ label$ }}</mat-label>
-    <mat-chip-grid #chipGrid [required]="bRequired$">
+    <mat-chip-grid #chipGrid>
       <ng-container *ngFor="let select of selectedItems">
         <mat-chip-row (removed)="removeChip(select)">
           {{ select.primary }}

package/lib/field/multiselect/multiselect.component.ts

@@ -91,13 +91,32 @@ export class MultiselectComponent extends FieldBase {
         }
       ];
       let secondaryColumns: any = [];
-      if (secondaryFields) {
-        secondaryColumns = secondaryFields.map(secondaryField => ({
-          value: secondaryField,
+      // Read columnsFormatter from raw (unresolved) metadata to get field property paths
+      // (e.g. "@P .pyLabel") instead of resolved data values (e.g. "New Complex Fields").
+      // This matches Constellation's approach: pConn.getRawMetadata()?.config?.columnsFormatter
+      const columnsFormatter = (this.pConn$.getRawMetadata()?.config as any)?.columnsFormatter;
+      const secondaryFieldsFromFormatter = columnsFormatter
+        ? columnsFormatter
+            .map(item => {
+              const property = item?.config?.value;
+              if (typeof property === 'string') {
+                if (property.startsWith('@USER ')) return property.substring(6);
+                if (property.startsWith('@P ')) return property.substring(3);
+                return property;
+              }
+              return undefined;
+            })
+            .filter(Boolean)
+        : undefined;
+      const updatedSecondaryFields = secondaryFieldsFromFormatter || secondaryFields;
+      if (updatedSecondaryFields) {
+        secondaryColumns = updatedSecondaryFields.map(secondaryField => ({
+          value: typeof secondaryField === 'string' ? secondaryField : undefined,
           display: 'true',
           secondary: 'true',
           useForSearch: 'true'
         }));
+        secondaryColumns = secondaryColumns.filter(col => col.value);
       } else {
         secondaryColumns = [
           {

package/lib/field/multiselect/utils.ts

@@ -11,9 +11,11 @@ export function setVisibilityForList(c11nEnv, visibility) {
 function preProcessColumns(columns) {
   return columns?.map(col => {
     const tempColObj = { ...col };
-    tempColObj.value = col.value && col.value.startsWith('.') ? col.value.substring(1) : col.value;
-    if (tempColObj.setProperty) {
-      tempColObj.setProperty = col.setProperty && col.setProperty.startsWith('.') ? col.setProperty.substring(1) : col.setProperty;
+    if (typeof col.value === 'string') {
+      tempColObj.value = col.value.startsWith('.') ? col.value.substring(1) : col.value;
+    }
+    if (typeof col.setProperty === 'string') {
+      tempColObj.setProperty = col.setProperty.startsWith('.') ? col.setProperty.substring(1) : col.setProperty;
     }
     return tempColObj;
   });

package/lib/field/object-reference/object-reference.component.html

@@ -1,17 +1,32 @@
-<div *ngIf="isDisplayModeEnabled && !canBeChangedInReviewMode; else semanticLinkCheck">
-  <component-mapper name="SingleReferenceReadOnly" [props]="{ pConn$ }"></component-mapper>
-</div>
-<ng-template #semanticLinkCheck>
-  <div *ngIf="type === 'SemanticLink' && !canBeChangedInReviewMode; else loadDynamicComp">
+<ng-container *ngIf="bVisible$" [ngSwitch]="renderMode">
+  <!-- SingleReferenceReadOnly mode -->
+  <div *ngSwitchCase="'singleReferenceReadonly'">
+    <component-mapper name="SingleReferenceReadOnly" [props]="{ pConn$, isDetails$, dataRelationshipContext }"></component-mapper>
+  </div>
+
+  <!-- MultiReferenceReadonly mode -->
+  <div *ngSwitchCase="'multiReferenceReadonly'">
+    <component-mapper name="MultiReferenceReadOnly" [props]="{ pConn$ }"></component-mapper>
+  </div>
+
+  <!-- SemanticLink mode -->
+  <div *ngSwitchCase="'semanticLink'">
     <component-mapper name="SemanticLink" [props]="{ pConn$: newPconn }"></component-mapper>
   </div>
-</ng-template>
-<ng-template #loadDynamicComp>
-  <component-mapper
-    *ngIf="newComponentName"
-    [name]="newComponentName"
-    [props]="{ pConn$: newPconn, formGroup$ }"
-    [parent]="this"
-    [outputEvents]="{ onRecordChange: onRecordChange }"
-  ></component-mapper>
-</ng-template>
+
+  <!-- SearchAndSelect mode -->
+  <div *ngSwitchCase="'searchAndSelect'">
+    <component-mapper name="SearchForm" [props]="{ pConn$, formGroup$, searchSelectCacheKey, type: 'ObjectReference' }"></component-mapper>
+  </div>
+
+  <!-- Dynamic component mode (Cards, Map, CheckboxGroup, Table, Multiselect, Dropdown, AutoComplete, etc.) -->
+  <div *ngSwitchCase="'dynamicComponent'">
+    <component-mapper
+      *ngIf="newComponentName"
+      [name]="newComponentName"
+      [props]="{ pConn$: newPconn, formGroup$ }"
+      [parent]="this"
+      [outputEvents]="useOutputEvents ? { onRecordChange: onRecordChange } : undefined"
+    ></component-mapper>
+  </div>
+</ng-container>