@pega/dx-component-builder-sdk 0.25.8 → 0.25.9

package/tests/assets/sdk-a/components/create/override-sdk/field/integer/config-ext.json

@@ -1,9 +1,8 @@
 {
-    "componentKey": "Integer",
-    "name": "Integer",
-    "label": "Integer",
-    "description": "Integer",
-    "type": "Field",
-    "subtype": "Integer",
-    "properties": []
-}
+  "name": "Integer",
+  "label": "Integer",
+  "description": "Integer",
+  "type": "Field",
+  "subtype": "Integer",
+  "properties": []
+}

package/tests/assets/sdk-a/components/create/override-sdk/field/integer/integer.component.html

@@ -1,5 +1,5 @@
 <div *ngIf="displayMode$; else noDisplayMode">
-  <component-mapper *ngIf="bVisible$ !== false" name="FieldValueList" [props]="{ label$, value$, displayMode$ }"></component-mapper>
+  <component-mapper *ngIf="bVisible$ !== false" name="FieldValueList" [props]="{ label$, value$: formattedValue, displayMode$ }"></component-mapper>
 </div>
 <ng-template #noDisplayMode>
   <div *ngIf="!bReadonly$ && bHasForm$; else noEdit">
@@ -8,10 +8,19 @@
         <mat-label>{{ label$ }}</mat-label>
         <input
           matInput
+          type="text"
+          currencyMask
+          [options]="{
+            prefix: '',
+            suffix: '',
+            thousands: thousandSeparator,
+            decimal: decimalSeparator,
+            align: 'left',
+            nullable: true,
+            precision: 0,
+            inputMode: inputMode
+          }"
           [placeholder]="placeholder"
-          type="number"
-          step="1"
-          [value]="value$"
           [required]="bRequired$"
           [formControl]="fieldControl"
           [attr.data-test-id]="testId"

package/tests/assets/sdk-a/components/create/override-sdk/field/integer/integer.component.ts

@@ -3,26 +3,48 @@ import { CommonModule } from '@angular/common';
 import { FormControl, ReactiveFormsModule } from '@angular/forms';
 import { MatInputModule } from '@angular/material/input';
 import { MatFormFieldModule } from '@angular/material/form-field';
+import { NgxCurrencyDirective, NgxCurrencyInputMode } from 'ngx-currency';
 
 import { FieldBase } from '@pega/angular-sdk-components';
 import { ComponentMapperComponent } from '@pega/angular-sdk-components';
-import { handleEvent } from '@pega/angular-sdk-components';
+import {
+  formatNumberFieldForDisplay,
+  getNumberInputFormat,
+  NumberInputFormat,
+  parseFormattedNumber,
+  saveNumberOnBlur
+} from '@pega/angular-sdk-components';
 import { PConnFieldProps } from '@pega/angular-sdk-components';
 
-interface IntegerProps extends PConnFieldProps {
+interface IntegerProps extends Omit<PConnFieldProps, 'value'> {
   // If any, enter additional props that only exist on Integer here
+  value?: number | string;
+  showGroupSeparators?: boolean | string;
+  formatter?: string;
+  decimalPrecision?: number | string;
+  currencyISOCode?: string;
+  currencyDisplay?: 'symbol' | 'code' | 'name';
+  negative?: 'minus-sign' | 'parentheses';
+  notation?: 'standard' | 'compact';
+  currencyDecimalPrecision?: string;
 }
 
 @Component({
   selector: 'app-integer',
   templateUrl: './integer.component.html',
   styleUrls: ['./integer.component.scss'],
-  imports: [CommonModule, ReactiveFormsModule, MatFormFieldModule, MatInputModule, forwardRef(() => ComponentMapperComponent)]
+  imports: [CommonModule, ReactiveFormsModule, MatFormFieldModule, MatInputModule, NgxCurrencyDirective, forwardRef(() => ComponentMapperComponent)]
 })
 export class IntegerComponent extends FieldBase {
   configProps$: IntegerProps;
   override fieldControl = new FormControl<number | null>(null, null);
 
+  decimalSeparator: string;
+  thousandSeparator: string;
+  formattedValue: string;
+  inputMode: any = NgxCurrencyInputMode.Natural;
+  private inputFormat: NumberInputFormat;
+
   /**
    * Updates the component when there are changes in the state.
    */
@@ -35,8 +57,25 @@ export class IntegerComponent extends FieldBase {
 
     // Extract and normalize the value property
     const { value } = this.configProps$;
-    if (value) {
-      this.value$ = typeof value === 'string' ? parseInt(value, 10) : value;
+    this.value$ = value === undefined || value === null || value === '' ? '' : Number(value);
+    this.fieldControl.setValue(this.value$ === '' ? null : this.value$);
+
+    this.updateIntegerProperties(this.configProps$);
+  }
+
+  /**
+   * Updates the input mask and read-only value, matching the Constellation DX Integer component.
+   */
+  protected updateIntegerProperties(configProps: IntegerProps): void {
+    const { showGroupSeparators = true } = configProps;
+    const groupSeparators = this.utils.getBooleanValue(showGroupSeparators);
+
+    this.inputFormat = getNumberInputFormat();
+    this.decimalSeparator = this.inputFormat.decimalSeparator;
+    this.thousandSeparator = groupSeparators ? this.inputFormat.thousandSeparator : '';
+
+    if (['DISPLAY_ONLY', 'STACKED_LARGE_VAL'].includes(this.displayMode$)) {
+      this.formattedValue = formatNumberFieldForDisplay('Integer', this.value$, configProps);
     }
   }
 
@@ -52,12 +91,7 @@ export class IntegerComponent extends FieldBase {
   }
 
   fieldOnBlur(event: any) {
-    const oldVal = this.value$ ?? '';
-    const isValueChanged = event.target.value.toString() !== oldVal.toString();
-
-    if (isValueChanged) {
-      const value = event?.target?.value;
-      handleEvent(this.actionsApi, 'changeNblur', this.propName, value);
-    }
+    const parsed = parseFormattedNumber(event?.target?.value, this.inputFormat);
+    saveNumberOnBlur(this.pConn$, parsed !== '' ? Number(parsed) : '', this.configProps$?.value);
   }
 }

package/tests/assets/sdk-a/components/create/override-sdk/field/location/config-ext.json

@@ -1,9 +1,8 @@
 {
-    "componentKey": "Location",
-    "name": "Location",
-    "label": "Location",
-    "description": "Location",
-    "type": "Field",
-    "subtype": "Location",
-    "properties": []
-}
+  "name": "Location",
+  "label": "Location",
+  "description": "Location",
+  "type": "Field",
+  "subtype": "Location",
+  "properties": []
+}

package/tests/assets/sdk-a/components/create/override-sdk/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>
+    <mat-chip-grid #chipGrid [required]="bRequired$">
       <ng-container *ngFor="let select of selectedItems">
         <mat-chip-row (removed)="removeChip(select)">
           {{ select.primary }}

package/tests/assets/sdk-a/components/create/override-sdk/field/percentage/config-ext.json

@@ -1,9 +1,8 @@
 {
-    "componentKey": "Percentage",
-    "name": "Percentage",
-    "label": "Percentage",
-    "description": "Percentage",
-    "type": "Field",
-    "subtype": "Decimal-Percentage",
-    "properties": []
-}
+  "name": "Percentage",
+  "label": "Percentage",
+  "description": "Percentage",
+  "type": "Field",
+  "subtype": "Decimal-Percentage",
+  "properties": []
+}

package/tests/assets/sdk-a/components/create/override-sdk/field/percentage/percentage.component.html

@@ -11,8 +11,8 @@
           matInput
           currencyMask
           [options]="{
-            prefix: '',
-            suffix: '%',
+            prefix: prefix,
+            suffix: suffix,
             thousands: thousandSeparator,
             decimal: decimalSeparator,
             align: 'left',

package/tests/assets/sdk-a/components/create/override-sdk/field/percentage/percentage.component.ts

@@ -7,16 +7,24 @@ import { NgxCurrencyDirective, NgxCurrencyInputMode } from 'ngx-currency';
 
 import { FieldBase } from '@pega/angular-sdk-components';
 import { ComponentMapperComponent } from '@pega/angular-sdk-components';
-import { handleEvent } from '@pega/angular-sdk-components';
-import { getCurrencyCharacters } from '@pega/angular-sdk-components';
-import { format } from '@pega/angular-sdk-components';
+import {
+  decimalsToPercentage,
+  formatNumberFieldForDisplay,
+  getNumberInputFormat,
+  NumberInputFormat,
+  parseDecimalPrecision,
+  parseFormattedNumber,
+  percentageToDecimals,
+  saveNumberOnBlur
+} from '@pega/angular-sdk-components';
 import { PConnFieldProps } from '@pega/angular-sdk-components';
 
 interface PercentageProps extends Omit<PConnFieldProps, 'value'> {
-  value?: number;
-  showGroupSeparators?: string;
-  decimalPrecision?: number;
+  value?: number | string;
+  showGroupSeparators?: boolean | string;
+  decimalPrecision?: number | string;
   currencyISOCode?: string;
+  storePercentageAsDecimal?: boolean | string;
   // If any, enter additional props that only exist on Percentage here
 }
 
@@ -30,11 +38,16 @@ export class PercentageComponent extends FieldBase {
   configProps$: PercentageProps;
   override fieldControl = new FormControl<number | null>(null, null);
 
+  prefix: string;
+  suffix: string;
   decimalSeparator: string;
   thousandSeparator: string;
   inputMode: any = NgxCurrencyInputMode.Natural;
   decimalPrecision: number | undefined;
   formattedValue: string;
+  private inputFormat: NumberInputFormat;
+  private numberOfDecimals: number | undefined;
+  private storeAsDecimal = false;
 
   /**
    * Updates the component when there are changes in the state.
@@ -46,34 +59,39 @@ export class PercentageComponent extends FieldBase {
     // Update component common properties
     this.updateComponentCommonProperties(this.configProps$);
 
-    // Set component specific properties
-    const { value } = this.configProps$;
-    if (value) {
-      this.value$ = value;
-      this.fieldControl.setValue(value);
+    const { value, decimalPrecision, storePercentageAsDecimal } = this.configProps$;
+    this.numberOfDecimals = parseDecimalPrecision(decimalPrecision, 2);
+    this.storeAsDecimal = this.utils.getBooleanValue(storePercentageAsDecimal);
+
+    // The stored value may be a fraction (0.25); the field always shows/edits the percentage (25)
+    if (value === undefined || value === null || value === '') {
+      this.value$ = '';
+    } else {
+      this.value$ = this.storeAsDecimal && Number(value) ? decimalsToPercentage(Number(value), this.numberOfDecimals) : Number(value);
     }
+    this.fieldControl.setValue(this.value$ === '' ? null : this.value$);
 
     // update percentage properties
     this.updatePercentageProperties(this.configProps$);
   }
 
   /**
-   * Updates the percentage properties
-   *
-   * @param {Object} configProps - Configuration properties.
-   * @param {boolean} configProps.showGroupSeparators - Whether to show group separators.
-   * @param {number} configProps.decimalPrecision - The number of decimal places to display.
+   * Updates the input mask and read-only value, matching the Constellation DX Percentage component.
    */
-  updatePercentageProperties(configProps): void {
-    const { showGroupSeparators, decimalPrecision } = configProps;
+  updatePercentageProperties(configProps: PercentageProps): void {
+    const { showGroupSeparators = false } = configProps;
+    const groupSeparators = this.utils.getBooleanValue(showGroupSeparators);
 
-    const theSymbols = getCurrencyCharacters('');
-    this.decimalSeparator = theSymbols.theDecimalIndicator;
-    this.thousandSeparator = showGroupSeparators ? theSymbols.theDigitGroupSeparator : '';
-    this.decimalPrecision = decimalPrecision ?? 2;
+    this.inputFormat = getNumberInputFormat('percent');
+    this.prefix = this.inputFormat.prefix;
+    this.suffix = this.inputFormat.suffix;
+    this.decimalSeparator = this.inputFormat.decimalSeparator;
+    this.thousandSeparator = groupSeparators ? this.inputFormat.thousandSeparator : '';
+    // ngx-currency needs a fixed precision; Constellation allows any number of decimals when none is configured
+    this.decimalPrecision = this.numberOfDecimals ?? 2;
 
     if (['DISPLAY_ONLY', 'STACKED_LARGE_VAL'].includes(this.displayMode$)) {
-      this.formattedValue = this.value$ ? format(this.value$, 'percentage') : '';
+      this.formattedValue = formatNumberFieldForDisplay('Percentage', this.value$, configProps);
     }
   }
 
@@ -89,24 +107,11 @@ export class PercentageComponent extends FieldBase {
   }
 
   fieldOnBlur(event: any) {
-    const oldVal = this.value$ ?? '';
-    const isValueChanged = event.target.value.toString() !== oldVal.toString();
-
-    if (isValueChanged) {
-      let value = event?.target?.value;
-      value = value ? value.replace(/%/g, '') : '';
-      // replacing thousand separator with empty string as not required in api call
-      if (this.configProps$.showGroupSeparators) {
-        const thousandSep = this.thousandSeparator === '.' ? '\\.' : this.thousandSeparator;
-        const regExp = new RegExp(String.raw`${thousandSep}`, 'g');
-        value = value?.replace(regExp, '');
-      }
-      // replacing decimal separator with '.'
-      if (this.decimalSeparator !== '.') {
-        const regExp = new RegExp(String.raw`${this.decimalSeparator}`, 'g');
-        value = value.replace(regExp, '.');
-      }
-      handleEvent(this.actionsApi, 'changeNblur', this.propName, value);
+    const parsed = parseFormattedNumber(event?.target?.value, this.inputFormat);
+    let newValue: number | '' = parsed !== '' ? Number(parsed) : '';
+    if (this.storeAsDecimal && newValue !== '') {
+      newValue = percentageToDecimals(newValue, this.numberOfDecimals);
     }
+    saveNumberOnBlur(this.pConn$, newValue, this.configProps$?.value);
   }
 }

package/tests/assets/sdk-a/components/create/override-sdk/field/phone/config-ext.json

@@ -1,9 +1,8 @@
 {
-    "componentKey": "Phone",
-    "name": "Phone",
-    "label": "Phone",
-    "description": "Phone",
-    "type": "Field",
-    "subtype": "Text-Phone",
-    "properties": []
-}
+  "name": "Phone",
+  "label": "Phone",
+  "description": "Phone",
+  "type": "Field",
+  "subtype": "Text-Phone",
+  "properties": []
+}

package/tests/assets/sdk-a/components/create/override-sdk/field/radio-buttons/config-ext.json

@@ -1,9 +1,8 @@
 {
-    "componentKey": "RadioButtons",
-    "name": "RadioButtons",
-    "label": "Radio buttons",
-    "description": "Picklist",
-    "type": "Field",
-    "subtype": "Picklist",
-    "properties": []
-}
+  "name": "RadioButtons",
+  "label": "Radio buttons",
+  "description": "Picklist",
+  "type": "Field",
+  "subtype": "Picklist",
+  "properties": []
+}

package/tests/assets/sdk-a/components/create/override-sdk/field/rich-text/config-ext.json

@@ -1,11 +1,10 @@
 {
-    "componentKey": "RichText",
-    "name": "RichText",
-    "label": "Rich text editor",
-    "description": "Text (paragraph)",
-    "type": "Field",
-    "subtype": "Text-Paragraph",
-    "icon": "images/pz-text-area-active.svg",
-    "properties": [],
-    "defaultConfig": {}
-}
+  "name": "RichText",
+  "label": "Rich text editor",
+  "description": "Text (paragraph)",
+  "type": "Field",
+  "subtype": "Text-Paragraph",
+  "icon": "images/pz-text-area-active.svg",
+  "properties": [],
+  "defaultConfig": {}
+}

package/tests/assets/sdk-a/components/create/override-sdk/field/scalar-list/config-ext.json

@@ -1,9 +1,8 @@
 {
-    "componentKey": "ScalarList",
-    "name": "ScalarList",
-    "label": "ScalarList",
-    "description": "ScalarList",
-    "type": "Field",
-    "subtype": "ScalarList",
-    "properties": []
-}
+  "name": "ScalarList",
+  "label": "ScalarList",
+  "description": "ScalarList",
+  "type": "Field",
+  "subtype": "ScalarList",
+  "properties": []
+}

package/tests/assets/sdk-a/components/create/override-sdk/field/semantic-link/config-ext.json

@@ -1,9 +1,7 @@
 {
-    "label": "SemanticLink",
-    "componentKey": "SemanticLink",
-    "name": "SemanticLink",
-    "description": "SemanticLink",
-    "type": "Field",
-    "subtype": "ACTION",
-    "properties": []
-}
+  "name": "SemanticLink",
+  "description": "SemanticLink",
+  "type": "Field",
+  "subtype": "ACTION",
+  "properties": []
+}

package/tests/assets/sdk-a/components/create/override-sdk/field/text-area/config-ext.json

@@ -1,9 +1,8 @@
 {
-    "componentKey": "TextArea",
-    "name": "TextArea",
-    "label": "Text area",
-    "description": "Text (paragraph)",
-    "type": "Field",
-    "subtype": "Text-Paragraph",
-    "properties": []
-}
+  "name": "TextArea",
+  "label": "Text area",
+  "description": "Text (paragraph)",
+  "type": "Field",
+  "subtype": "Text-Paragraph",
+  "properties": []
+}

package/tests/assets/sdk-a/components/create/override-sdk/field/text-content/config-ext.json

@@ -1,9 +1,7 @@
 {
-    "label": "TextContent",
-    "componentKey": "TextContent",
-    "name": "TextContent",
-    "description": "Text",
-    "type": "Field",
-    "subtype": "DATA_CAPTURE",
-    "properties": []
-}
+  "name": "TextContent",
+  "description": "Text",
+  "type": "Field",
+  "subtype": "DATA_CAPTURE",
+  "properties": []
+}

package/tests/assets/sdk-a/components/create/override-sdk/field/text-input/config-ext.json

@@ -1,9 +1,8 @@
 {
-    "componentKey": "TextInput",
-    "name": "TextInput",
-    "label": "Text input",
-    "description": "Text (single line)",
-    "type": "Field",
-    "subtype": "Text",
-    "properties": []
-}
+  "name": "TextInput",
+  "label": "Text input",
+  "description": "Text (single line)",
+  "type": "Field",
+  "subtype": "Text",
+  "properties": []
+}

package/tests/assets/sdk-a/components/create/override-sdk/field/time/config-ext.json

@@ -1,9 +1,8 @@
 {
-    "componentKey": "Time",
-    "name": "Time",
-    "label": "Time only",
-    "description": "Time only",
-    "type": "Field",
-    "subtype": "TimeOfDay",
-    "properties": []
-}
+  "name": "Time",
+  "label": "Time only",
+  "description": "Time only",
+  "type": "Field",
+  "subtype": "TimeOfDay",
+  "properties": []
+}

package/tests/assets/sdk-a/components/create/override-sdk/field/url/config-ext.json

@@ -1,9 +1,8 @@
 {
-    "componentKey": "URL",
-    "name": "URL",
-    "label": "URL",
-    "description": "URL",
-    "type": "Field",
-    "subtype": "Text-URL",
-    "properties": []
-}
+  "name": "URL",
+  "label": "URL",
+  "description": "URL",
+  "type": "Field",
+  "subtype": "Text-URL",
+  "properties": []
+}

package/tests/assets/sdk-a/components/create/override-sdk/field/user-reference/config-ext.json

@@ -1,9 +1,7 @@
 {
-    "label": "UserReference",
-    "componentKey": "UserReference",
-    "name": "UserReference",
-    "description": "User reference",
-    "type": "Field",
-    "subtype": "DATA_CAPTURE",
-    "properties": []
-}
+  "name": "UserReference",
+  "description": "User reference",
+  "type": "Field",
+  "subtype": "DATA_CAPTURE",
+  "properties": []
+}

package/tests/assets/sdk-a/components/create/override-sdk/infra/assignment/assignment.component.ts

@@ -7,7 +7,6 @@ import { AngularPConnectData, AngularPConnectService } from '@pega/angular-sdk-c
 import { ErrorMessagesService } from '@pega/angular-sdk-components';
 import { ProgressSpinnerService } from '@pega/angular-sdk-components';
 import { BannerService } from '@pega/angular-sdk-components';
-import { ReferenceComponent } from '@pega/angular-sdk-components';
 import { ComponentMapperComponent } from '@pega/angular-sdk-components';
 
 function getRefreshProps(refreshConditions) {
@@ -149,8 +148,7 @@ export class AssignmentComponent implements OnInit, OnDestroy, OnChanges {
 
     this.registerForRefresh();
 
-    // pConn$ may be a 'reference' component, so normalize it
-    this.newPConn$ = ReferenceComponent.normalizePConn(this.pConn$);
+    this.newPConn$ = this.pConn$;
 
     if (this.arChildren$) {
       this.createButtons();
@@ -158,9 +156,7 @@ export class AssignmentComponent implements OnInit, OnDestroy, OnChanges {
   }
 
   initComponent() {
-    // pConn$ may be a 'reference' component, so normalize it
-    // this.pConn$ = ReferenceComponent.normalizePConn(this.pConn$);
-    this.newPConn$ = ReferenceComponent.normalizePConn(this.pConn$);
+    this.newPConn$ = this.pConn$;
 
     // prevent re-intializing with flowContainer update unless an action is taken
     this.bReInit = false;
@@ -203,7 +199,6 @@ export class AssignmentComponent implements OnInit, OnDestroy, OnChanges {
     this.cancelCreateStageAssignment = actionsAPI.cancelCreateStageAssignment.bind(actionsAPI);
     this.approveCase = actionsAPI.approveCase?.bind(actionsAPI);
     this.rejectCase = actionsAPI.rejectCase?.bind(actionsAPI);
-
     if (this.arChildren$) {
       this.createButtons();
     }

package/tests/assets/sdk-a/components/create/override-sdk/infra/assignment-card/assignment-card.component.html

@@ -2,6 +2,7 @@
   <div *ngFor="let kid of childrenArray" class="psdk-assignment-card-child">
     <div [ngSwitch]="kid.getPConnect().getComponentName()">
       <component-mapper *ngSwitchCase="'View'" name="View" [props]="{ formGroup$, pConn$: kid.getPConnect() }"></component-mapper>
+      <component-mapper *ngSwitchCase="'reference'" name="reference" [props]="{ formGroup$, pConn$: kid.getPConnect() }"></component-mapper>
       <component-mapper
         *ngSwitchCase="'CaseCreateStage'"
         name="CaseCreateStage"

package/tests/assets/sdk-a/components/create/override-sdk/infra/assignment-card/assignment-card.component.ts

@@ -1,7 +1,6 @@
 import { Component, OnInit, Input, Output, EventEmitter, forwardRef, OnChanges, SimpleChanges } from '@angular/core';
 import { CommonModule } from '@angular/common';
 import { FormGroup, ReactiveFormsModule } from '@angular/forms';
-import { ReferenceComponent } from '@pega/angular-sdk-components';
 import { ComponentMapperComponent } from '@pega/angular-sdk-components';
 
 function isChildrenUpdated(children) {
@@ -34,18 +33,13 @@ export class AssignmentCardComponent implements OnInit, OnChanges {
   @Output() actionButtonClick: EventEmitter<any> = new EventEmitter();
 
   ngOnInit(): void {
-    // Children may contain 'reference' component, so we need to
-    //  normalize them
-    this.childrenArray = ReferenceComponent.normalizePConnArray(this.arChildren$);
+    this.childrenArray = this.arChildren$;
   }
 
   ngOnChanges(changes: SimpleChanges) {
-    // Children may contain 'reference' component, so we need to
-    //  normalize them
-
     const { arChildren$ } = changes;
     if (isChildrenUpdated(arChildren$)) {
-      this.childrenArray = ReferenceComponent.normalizePConnArray(this.arChildren$);
+      this.childrenArray = this.arChildren$;
     }
   }