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

package/src/tasks/create/templates/SDK-Angular/field/DateTime/date-time.component.scss.mustache

@@ -20,61 +20,67 @@
     width: auto;
   }
 
-  .mat-datepicker-content,
-  .time-container {
-    box-shadow:
-      0px 2px 4px -1px rgba(0, 0, 0, 0.2),
-      0px 4px 5px 0px rgba(0, 0, 0, 0.14),
-      0px 1px 10px 0px rgba(0, 0, 0, 0.12);
-    display: block;
-    border-radius: 4px;
-    background-color: var(--mat-datepicker-calendar-container-background-color);
-    color: var(--mat-datepicker-calendar-container-text-color);
+  .owl-dt-container {
+    background-color: var(--mat-sys-surface-container);
+    color: var(--mat-sys-on-surface);
   }
 
-  .mat-calendar-body-cell-content {
-    color: var(--mat-datepicker-calendar-date-text-color);
-    border-color: var(--mat-datepicker-calendar-date-outline-color);
+  .owl-dt-container-row,
+  .owl-dt-container-info .owl-dt-container-range:last-child {
+    border-color: var(--mat-sys-outline-variant);
   }
 
-  .mat-calendar-body-selected {
-    background-color: var(--mat-datepicker-calendar-date-selected-state-background-color);
-    color: var(--mat-datepicker-calendar-date-selected-state-text-color);
+  .owl-dt-calendar-control,
+  .owl-dt-calendar-table .owl-dt-calendar-cell {
+    color: var(--mat-sys-on-surface);
   }
 
-  .mat-calendar-body-cell-content {
-    border: none !important;
+  .owl-dt-calendar-table .owl-dt-calendar-header,
+  .owl-dt-calendar-table .owl-dt-calendar-cell-disabled > .owl-dt-calendar-cell-content:not(.owl-dt-calendar-cell-selected) {
+    color: var(--mat-sys-on-surface-variant);
   }
 
-  .mat-calendar-body-cell:not(.mat-calendar-body-disabled):hover
-    > .mat-calendar-body-cell-content:not(.mat-calendar-body-selected):not(.mat-calendar-body-comparison-identical) {
-    background-color: var(--mat-datepicker-calendar-date-hover-state-background-color);
+  .owl-dt-calendar-table .owl-dt-calendar-header .owl-dt-calendar-table-divider::after {
+    background-color: var(--mat-sys-outline-variant);
   }
 
-  .mat-calendar-arrow {
-    fill: var(--mat-datepicker-calendar-period-button-icon-color);
+  .owl-dt-calendar-table .owl-dt-calendar-cell-today:not(.owl-dt-calendar-cell-selected) {
+    border-color: var(--mat-sys-outline);
   }
 
-  .mat-calendar-table-header th {
-    text-align: center;
-    padding: 0 0 8px 0;
-    color: var(--mat-datepicker-calendar-header-text-color);
-    font-size: var(--mat-datepicker-calendar-header-text-size);
-    font-weight: var(--mat-datepicker-calendar-header-text-weight);
+  .owl-dt-calendar-table .owl-dt-calendar-cell-selected {
+    background-color: var(--mat-sys-primary);
+    color: var(--mat-sys-on-primary);
   }
 
-  .mat-datepicker-content .mat-calendar-previous-button,
-  .mat-datepicker-content .mat-calendar-next-button {
-    color: var(--mat-datepicker-calendar-navigation-button-icon-color);
+  .owl-dt-calendar-table .owl-dt-calendar-cell-active:focus > .owl-dt-calendar-cell-content:not(.owl-dt-calendar-cell-selected),
+  .owl-dt-calendar-table :not(.owl-dt-calendar-cell-disabled):hover > .owl-dt-calendar-cell-content:not(.owl-dt-calendar-cell-selected),
+  .owl-dt-calendar-control .owl-dt-calendar-control-content .owl-dt-calendar-control-button:hover,
+  .owl-dt-control-period-button:hover > .owl-dt-control-button-content,
+  .owl-dt-container-control-button:hover .owl-dt-control-button-content,
+  .owl-dt-control:focus > .owl-dt-control-content {
+    background-color: var(--mat-sys-surface-container-high);
   }
 
-  .mat-calendar-table-header-divider::after {
-    content: '';
-    position: absolute;
-    top: 0;
-    left: -8px;
-    right: -8px;
-    height: 1px;
-    background: var(--mat-datepicker-calendar-header-divider-color);
+  .owl-dt-timer-content .owl-dt-timer-input {
+    border-color: var(--mat-sys-outline);
+    background-color: var(--mat-sys-surface-container-highest);
+    color: var(--mat-sys-on-surface);
+  }
+
+  .owl-dt-container-buttons,
+  .owl-dt-container-info .owl-dt-container-info-active,
+  .owl-dt-timer-hour12 {
+    color: var(--mat-sys-primary);
+  }
+
+  .owl-dt-control-arrow-button[disabled] {
+    color: var(--mat-sys-on-surface-variant);
+  }
+
+  .owl-dt-timer-hour12 .owl-dt-timer-hour12-box:focus .owl-dt-control-button-content,
+  .owl-dt-timer-hour12 .owl-dt-timer-hour12-box:hover .owl-dt-control-button-content {
+    background-color: var(--mat-sys-primary);
+    color: var(--mat-sys-on-primary);
   }
 }

package/src/tasks/create/templates/SDK-Angular/field/DateTime/date-time.component.ts.mustache

@@ -95,6 +95,12 @@ export class {{COMPONENT_CLASS_NAME}}Component extends FieldBase implements OnIn
   }
 
   fieldOnDateChange(event: any) {
+    // owl picker emits null when the typed text can't be parsed; clear the input instead of defaulting to now
+    if (!event.value) {
+      this.fieldControl.setValue('');
+      handleEvent(this.actionsApi, 'changeNblur', this.propName, '');
+      return;
+    }
     // this comes from the date pop up
     if (typeof event.value === 'object') {
       // convert date to pega "date" format
@@ -104,4 +110,25 @@ export class {{COMPONENT_CLASS_NAME}}Component extends FieldBase implements OnIn
     }
     handleEvent(this.actionsApi, 'changeNblur', this.propName, event.value);
   }
+
+  override getErrorMessage() {
+    // look for validation messages for json, pre-defined or just an error pushed from workitem (400)
+    if (this.fieldControl.hasError('message')) {
+      return this.angularPConnectData.validateMessage ?? '';
+    }
+
+    if (this.fieldControl.hasError('required')) {
+      return 'You must enter a value';
+    }
+
+    if (this.fieldControl.hasError('owlDateTimeParse')) {
+      return `${this.fieldControl.errors?.['owlDateTimeParse'].text} is not a valid date time value`;
+    }
+
+    if (this.fieldControl.errors) {
+      return 'Invalid date time value';
+    }
+
+    return '';
+  }
 }

package/src/tasks/create/templates/SDK-Angular/field/DateTime/demo.stories.tsx.mustache

@@ -9,7 +9,7 @@ const meta: Meta<{{COMPONENT_CLASS_NAME}}Component> = {
   title: '{{COMPONENT_CLASS_NAME}}',
   component: {{COMPONENT_CLASS_NAME}}Component,
   excludeStories: /.*Data$/,
-  render: (args) => ({
+  render: args => ({
     props: {
       ...args,
       pConn$: {

package/src/tasks/create/templates/SDK-Angular/field/Decimal/decimal.component.html.mustache

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

package/src/tasks/create/templates/SDK-Angular/field/Decimal/decimal.component.ts.mustache

@@ -4,19 +4,30 @@ import { FormControl, FormsModule, 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 { getCurrencyCharacters, getCurrencyOptions } from '@pega/angular-sdk-components';
-import { format } from '@pega/angular-sdk-components';
+import {
+  formatNumberFieldForDisplay,
+  getNumberInputFormat,
+  NumberInputFormat,
+  parseDecimalPrecision,
+  parseFormattedNumber,
+  saveNumberOnBlur
+} from '@pega/angular-sdk-components';
 import { PConnFieldProps } from '@pega/angular-sdk-components';
 
-interface {{COMPONENT_CLASS_NAME}}Props extends PConnFieldProps {
+interface {{COMPONENT_CLASS_NAME}}Props extends Omit<PConnFieldProps, 'value'> {
   // If any, enter additional props that only exist on Decimal here
+  value?: number | string;
   currencyISOCode?: string;
-  decimalPrecision?: number;
-  showGroupSeparators?: string;
+  decimalPrecision?: number | string;
+  showGroupSeparators?: boolean | string;
   formatter?: string;
+  currencyDisplay?: 'symbol' | 'code' | 'name';
+  negative?: 'minus-sign' | 'parentheses';
+  notation?: 'standard' | 'compact';
+  currencyDecimalPrecision?: string;
 }
 
 @Component({
@@ -39,12 +50,10 @@ export class {{COMPONENT_CLASS_NAME}}Component extends FieldBase {
 
   decimalSeparator: string;
   thousandSeparator: string;
-  currencySymbol = '';
   decimalPrecision: number | undefined;
-  formatter;
   formattedValue: any;
   inputMode: any = NgxCurrencyInputMode.Natural;
-  suffix = '';
+  private inputFormat: NumberInputFormat;
 
   /**
    * Updates the component when there are changes in the state.
@@ -58,66 +67,34 @@ export class {{COMPONENT_CLASS_NAME}}Component extends FieldBase {
 
     // Extract and normalize the value property
     const { value } = this.configProps$;
-    if (value) {
-      this.value$ = typeof value === 'string' ? parseFloat(value) : value;
-      this.fieldControl.setValue(this.value$);
-    }
+    this.value$ = value === undefined || value === null || value === '' ? '' : Number(value);
+    this.fieldControl.setValue(this.value$ === '' ? null : this.value$);
 
     // updates decimal properties
     this.updateDecimalProperties(this.configProps$);
   }
 
   /**
-   * Updates decimal properties based on the provided configuration.
-   *
-   * @param {Object} configProps - Configuration properties.
-   * @param {string} configProps.currencyISOCode - ISO code of the currency.
-   * @param {string} configProps.formatter - Formatter type (e.g., 'decimal', 'currency').
-   * @param {boolean} configProps.showGroupSeparators - Whether to show group separators.
+   * Updates the input mask and read-only value, matching the Constellation DX Decimal component.
    */
-  protected updateDecimalProperties(configProps): void {
-    const { currencyISOCode = '', formatter, showGroupSeparators } = configProps;
-
-    // Extract currency symbols and options
-    const theSymbols = getCurrencyCharacters(currencyISOCode);
-    this.decimalSeparator = theSymbols.theDecimalIndicator;
-    this.thousandSeparator = showGroupSeparators ? theSymbols.theDigitGroupSeparator : '';
-
-    const theCurrencyOptions = getCurrencyOptions(currencyISOCode);
-    const formatterLower = formatter?.toLowerCase() || 'decimal';
-    this.formattedValue = format(this.value$, formatterLower, theCurrencyOptions);
+  protected updateDecimalProperties(configProps: {{COMPONENT_CLASS_NAME}}Props): void {
+    const { decimalPrecision, showGroupSeparators = true } = configProps;
+    const numberOfDecimals = parseDecimalPrecision(decimalPrecision, 2);
+    const groupSeparators = this.utils.getBooleanValue(showGroupSeparators);
 
-    if (this.bReadonly$ && formatter === 'Currency') {
-      this.currencySymbol = theSymbols.theCurrencySymbol;
-    }
+    this.inputFormat = getNumberInputFormat();
+    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 = numberOfDecimals ?? 2;
 
-    if (this.bReadonly$ && formatter === 'Percentage') {
-      this.suffix = '%';
+    if (['DISPLAY_ONLY', 'STACKED_LARGE_VAL'].includes(this.displayMode$)) {
+      this.formattedValue = formatNumberFieldForDisplay('Decimal', this.value$, configProps);
     }
-
-    this.decimalPrecision = this.configProps$?.decimalPrecision ?? 2;
   }
 
   fieldOnBlur(event: any) {
-    const oldVal = this.value$ ?? '';
-    const isValueChanged = event.target.value.toString() !== oldVal.toString();
-
-    if (isValueChanged) {
-      const actionsApi = this.pConn$?.getActionsApi();
-      const propName = this.pConn$?.getStateProps().value;
-      let value = event?.target?.value;
-      // 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(actionsApi, 'changeNblur', propName, value);
-    }
+    const parsed = parseFormattedNumber(event?.target?.value, this.inputFormat);
+    saveNumberOnBlur(this.pConn$, parsed !== '' ? Number(parsed) : '', this.configProps$?.value);
   }
 }

package/src/tasks/create/templates/SDK-Angular/field/Decimal/demo.stories.tsx.mustache

@@ -9,7 +9,7 @@ const meta: Meta<{{COMPONENT_CLASS_NAME}}Component> = {
   title: '{{COMPONENT_CLASS_NAME}}',
   component: {{COMPONENT_CLASS_NAME}}Component,
   excludeStories: /.*Data$/,
-  render: (args) => ({
+  render: args => ({
     props: {
       ...args,
       pConn$: {

package/src/tasks/create/templates/SDK-Angular/field/Decimal-Currency/decimal-currency.component.html.mustache

@@ -16,6 +16,7 @@
             currencyMask
             [options]="{
               prefix: currencySymbol,
+              suffix: currencySuffix,
               thousands: thousandSeparator,
               decimal: decimalSeparator,
               align: 'left',

package/src/tasks/create/templates/SDK-Angular/field/Decimal-Currency/decimal-currency.component.ts.mustache

@@ -4,18 +4,30 @@ 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 { getCurrencyCharacters, getCurrencyOptions } from '@pega/angular-sdk-components';
-import { format } from '@pega/angular-sdk-components';
+import {
+  formatNumberFieldForDisplay,
+  getCurrencyInputFormat,
+  NumberInputFormat,
+  parseFormattedNumber,
+  saveNumberOnBlur
+} from '@pega/angular-sdk-components';
 import { PConnFieldProps } from '@pega/angular-sdk-components';
 
-interface {{COMPONENT_CLASS_NAME}}Props extends PConnFieldProps {
+interface {{COMPONENT_CLASS_NAME}}Props extends Omit<PConnFieldProps, 'value'> {
   // If any, enter additional props that only exist on Currency here
+  value?: number | string;
   currencyISOCode?: string;
+  alwaysShowISOCode?: boolean;
   allowDecimals: boolean;
   formatter?: string;
+  currencyDisplay?: 'symbol' | 'code' | 'name';
+  negative?: 'minus-sign' | 'parentheses';
+  notation?: 'standard' | 'compact';
+  currencyDecimalPrecision?: string;
+  decimalPrecision?: number | string;
 }
 
 @Component({
@@ -28,14 +40,14 @@ export class {{COMPONENT_CLASS_NAME}}Component extends FieldBase {
   configProps$: {{COMPONENT_CLASS_NAME}}Props;
   override fieldControl = new FormControl<number | null>(null, { updateOn: 'blur' });
 
-  currencyOptions: object = {};
   currencySymbol: string;
+  currencySuffix: string;
   thousandSeparator: string;
   decimalSeparator: string;
   decimalPrecision: number | undefined;
   formattedValue: string;
-  formatter;
   inputMode = NgxCurrencyInputMode.Natural;
+  private inputFormat: NumberInputFormat;
 
   /**
    * Updates the component when there are changes in the state.
@@ -49,56 +61,38 @@ export class {{COMPONENT_CLASS_NAME}}Component extends FieldBase {
 
     // Extract and normalize the value property
     const { value } = this.configProps$;
-    if (value) {
-      this.value$ = typeof value === 'string' ? parseFloat(value) : value;
-      this.fieldControl.setValue(this.value$);
-    }
+    this.value$ = value === undefined || value === null || value === '' ? '' : Number(value);
+    this.fieldControl.setValue(this.value$ === '' ? null : this.value$);
 
     // update currency properties
     this.updateCurrencyProperties(this.configProps$);
   }
 
   /**
-   * Updates the currency properties
-   *
-   * @param {Object} configProps - Configuration properties.
-   * @param {boolean} configProps.allowDecimals - Whether to allow decimal values.
-   * @param {string} configProps.currencyISOCode - The ISO code of the currency.
-   * @param {string} configProps.formatter - The formatter type (e.g., 'currency').
+   * Updates the input mask and read-only value, matching the Constellation DX Currency component.
    */
-  protected updateCurrencyProperties(configProps): void {
-    const { allowDecimals, currencyISOCode = 'USD', formatter } = configProps;
+  protected updateCurrencyProperties(configProps: {{COMPONENT_CLASS_NAME}}Props): void {
+    const { allowDecimals = true, currencyISOCode = 'USD', alwaysShowISOCode = false } = configProps;
 
-    const theSymbols = getCurrencyCharacters(currencyISOCode);
-    this.currencySymbol = theSymbols.theCurrencySymbol;
-    this.thousandSeparator = theSymbols.theDigitGroupSeparator;
-    this.decimalSeparator = theSymbols.theDecimalIndicator;
-    this.decimalPrecision = allowDecimals ? 2 : 0;
+    const inputFormat = getCurrencyInputFormat(
+      currencyISOCode,
+      this.utils.getBooleanValue(alwaysShowISOCode),
+      this.utils.getBooleanValue(allowDecimals)
+    );
+    this.inputFormat = inputFormat;
+    this.currencySymbol = inputFormat.prefix;
+    this.currencySuffix = inputFormat.suffix;
+    this.thousandSeparator = inputFormat.thousandSeparator;
+    this.decimalSeparator = inputFormat.decimalSeparator;
+    this.decimalPrecision = inputFormat.precision;
 
     if (['DISPLAY_ONLY', 'STACKED_LARGE_VAL'].includes(this.displayMode$)) {
-      this.formattedValue = format(this.value$, formatter ? formatter.toLowerCase() : 'currency', getCurrencyOptions(currencyISOCode));
+      this.formattedValue = formatNumberFieldForDisplay('Currency', this.value$, { ...configProps, currencyISOCode });
     }
   }
 
   fieldOnBlur(event: any) {
-    const oldVal = this.value$ ?? '';
-    const isValueChanged = event.target.value.toString() !== oldVal.toString();
-
-    if (isValueChanged) {
-      const actionsApi = this.pConn$?.getActionsApi();
-      const propName = this.pConn$?.getStateProps().value;
-      let value = event?.target?.value;
-      value = value?.substring(1);
-      // replacing thousand separator with empty string as not required in api call
-      const thousandSep = this.thousandSeparator === '.' ? '\\.' : this.thousandSeparator;
-      let regExp = new RegExp(String.raw`${thousandSep}`, 'g');
-      value = value?.replace(regExp, '');
-      // replacing decimal separator with '.'
-      if (this.decimalSeparator !== '.') {
-        regExp = new RegExp(String.raw`${this.decimalSeparator}`, 'g');
-        value = value.replace(regExp, '.');
-      }
-      handleEvent(actionsApi, 'changeNblur', propName, value);
-    }
+    const parsed = parseFormattedNumber(event?.target?.value, this.inputFormat);
+    saveNumberOnBlur(this.pConn$, parsed !== '' ? Number(parsed) : '', this.configProps$?.value);
   }
 }

package/src/tasks/create/templates/SDK-Angular/field/Decimal-Currency/demo.stories.tsx.mustache

@@ -9,7 +9,7 @@ const meta: Meta<{{COMPONENT_CLASS_NAME}}Component> = {
   title: '{{COMPONENT_CLASS_NAME}}',
   component: {{COMPONENT_CLASS_NAME}}Component,
   excludeStories: /.*Data$/,
-  render: (args) => ({
+  render: args => ({
     props: {
       ...args,
       pConn$: {

package/src/tasks/create/templates/SDK-Angular/field/Decimal-Percentage/decimal-percentage.component.html.mustache

@@ -14,7 +14,7 @@
           currencyMask
           [options]="{
             prefix: '',
-            suffix: '%',
+            suffix: '',
             thousands: thousandSeparator,
             decimal: decimalSeparator,
             align: 'left',
@@ -23,12 +23,11 @@
             inputMode: inputMode
           }"
           [placeholder]="placeholder"
-          step=".01"
+          step="0.01"
           [formControlName]="controlName$"
           [required]="bRequired$"
           [formControl]="fieldControl"
           [attr.data-test-id]="testId"
-          (change)="fieldOnChange($event)"
           (blur)="fieldOnBlur($event)"
           [readonly]="bReadonly$"
         />

package/src/tasks/create/templates/SDK-Angular/field/Decimal-Percentage/decimal-percentage.component.ts.mustache

@@ -1,29 +1,48 @@
 import { Component, forwardRef } from '@angular/core';
 import { CommonModule } from '@angular/common';
-import { FormControl, ReactiveFormsModule } from '@angular/forms';
+import { FormControl, FormsModule, 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 { getCurrencyCharacters } from '@pega/angular-sdk-components';
-import { format } from '@pega/angular-sdk-components';
+import {
+  formatNumberFieldForDisplay,
+  getNumberInputFormat,
+  NumberInputFormat,
+  parseDecimalPrecision,
+  parseFormattedNumber,
+  saveNumberOnBlur
+} from '@pega/angular-sdk-components';
 import { PConnFieldProps } from '@pega/angular-sdk-components';
 
 interface {{COMPONENT_CLASS_NAME}}Props extends Omit<PConnFieldProps, 'value'> {
-  value?: number;
-  showGroupSeparators?: string;
-  decimalPrecision?: number;
+  // If any, enter additional props that only exist on Decimal here
+  value?: number | string;
   currencyISOCode?: string;
-  // If any, enter additional props that only exist on Percentage here
+  decimalPrecision?: number | string;
+  showGroupSeparators?: boolean | string;
+  formatter?: string;
+  currencyDisplay?: 'symbol' | 'code' | 'name';
+  negative?: 'minus-sign' | 'parentheses';
+  notation?: 'standard' | 'compact';
+  currencyDecimalPrecision?: string;
 }
 
 @Component({
   selector: 'app-{{COMPONENT_CLASS_NAME_KEBAB}}',
   templateUrl: './{{COMPONENT_CLASS_NAME_KEBAB}}.component.html',
   styleUrls: ['./{{COMPONENT_CLASS_NAME_KEBAB}}.component.scss'],
-  imports: [CommonModule, ReactiveFormsModule, MatFormFieldModule, MatInputModule, NgxCurrencyDirective, forwardRef(() => ComponentMapperComponent)]
+  imports: [
+    CommonModule,
+    ReactiveFormsModule,
+    FormsModule,
+    MatFormFieldModule,
+    MatInputModule,
+    NgxCurrencyDirective,
+    forwardRef(() => ComponentMapperComponent)
+  ]
 })
 export class {{COMPONENT_CLASS_NAME}}Component extends FieldBase {
   configProps$: {{COMPONENT_CLASS_NAME}}Props;
@@ -31,81 +50,51 @@ export class {{COMPONENT_CLASS_NAME}}Component extends FieldBase {
 
   decimalSeparator: string;
   thousandSeparator: string;
-  inputMode: any = NgxCurrencyInputMode.Natural;
   decimalPrecision: number | undefined;
-  formattedValue: string;
+  formattedValue: any;
+  inputMode: any = NgxCurrencyInputMode.Natural;
+  private inputFormat: NumberInputFormat;
 
   /**
    * Updates the component when there are changes in the state.
    */
   override updateSelf(): void {
-    // Resolve configuration properties
+    // Resolve config properties
     this.configProps$ = this.pConn$.resolveConfigProps(this.pConn$.getConfigProps()) as {{COMPONENT_CLASS_NAME}}Props;
 
-    // Update component common properties
+    // Update common properties
     this.updateComponentCommonProperties(this.configProps$);
 
-    // Set component specific properties
+    // Extract and normalize the value property
     const { value } = this.configProps$;
-    if (value) {
-      this.value$ = value;
-      this.fieldControl.setValue(value);
-    }
+    this.value$ = value === undefined || value === null || value === '' ? '' : Number(value);
+    this.fieldControl.setValue(this.value$ === '' ? null : this.value$);
 
-    // update percentage properties
-    this.updatePercentageProperties(this.configProps$);
+    // updates decimal properties
+    this.updateDecimalProperties(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 Decimal component.
    */
-  updatePercentageProperties(configProps): void {
-    const { showGroupSeparators, decimalPrecision } = configProps;
+  protected updateDecimalProperties(configProps: {{COMPONENT_CLASS_NAME}}Props): void {
+    const { decimalPrecision, showGroupSeparators = true } = configProps;
+    const numberOfDecimals = parseDecimalPrecision(decimalPrecision, 2);
+    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();
+    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 = numberOfDecimals ?? 2;
 
     if (['DISPLAY_ONLY', 'STACKED_LARGE_VAL'].includes(this.displayMode$)) {
-      this.formattedValue = this.value$ ? format(this.value$, 'percentage') : '';
-    }
-  }
-
-  fieldOnChange(event: any) {
-    const oldVal = this.value$ ?? '';
-    const isValueChanged = event.target.value.toString() !== oldVal.toString();
-
-    if (isValueChanged) {
-      this.pConn$.clearErrorMessages({
-        property: this.propName
-      });
+      this.formattedValue = formatNumberFieldForDisplay('Decimal', this.value$, configProps);
     }
   }
 
   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);
+    saveNumberOnBlur(this.pConn$, parsed !== '' ? Number(parsed) : '', this.configProps$?.value);
   }
 }