@pega/angular-sdk-overrides 0.23.7 → 0.23.9

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

@@ -0,0 +1,363 @@
+import { CommonModule } from '@angular/common';
+import { Component, forwardRef, Input, OnDestroy, OnInit } from '@angular/core';
+import { FormControl, FormGroup, ReactiveFormsModule } from '@angular/forms';
+import { MatAutocompleteModule, MatAutocompleteSelectedEvent, MatAutocompleteTrigger } from '@angular/material/autocomplete';
+import { MatChipsModule } from '@angular/material/chips';
+import { MatCheckboxModule } from '@angular/material/checkbox';
+import { MatOptionModule } from '@angular/material/core';
+import { MatFormFieldModule } from '@angular/material/form-field';
+import { MatInputModule } from '@angular/material/input';
+import { MatIconModule } from '@angular/material/icon';
+import { AngularPConnectData, AngularPConnectService } from '@pega/angular-sdk-components';
+import { ComponentMapperComponent } from '@pega/angular-sdk-components';
+import { Utils } from '@pega/angular-sdk-components';
+import { doSearch, getDisplayFieldsMetaData, getGroupDataForItemsTree, preProcessColumns } from './utils';
+import { deleteInstruction, insertInstruction } from '@pega/angular-sdk-components';
+
+@Component({
+  selector: 'app-multiselect',
+  templateUrl: './multiselect.component.html',
+  styleUrls: ['./multiselect.component.scss'],
+  standalone: true,
+  imports: [
+    CommonModule,
+    ReactiveFormsModule,
+    MatFormFieldModule,
+    MatInputModule,
+    MatAutocompleteModule,
+    MatOptionModule,
+    MatCheckboxModule,
+    MatIconModule,
+    MatChipsModule,
+    forwardRef(() => ComponentMapperComponent)
+  ]
+})
+export class MultiselectComponent implements OnInit, OnDestroy {
+  @Input() pConn$: typeof PConnect;
+  @Input() formGroup$: FormGroup;
+
+  // Used with AngularPConnect
+  angularPConnectData: AngularPConnectData = {};
+
+  label$ = '';
+  value$ = '';
+  bRequired$ = false;
+  bDisabled$ = false;
+  bVisible$ = true;
+  controlName$: string;
+  bHasForm$ = true;
+  listType: string;
+  placeholder: string;
+  fieldControl = new FormControl('', null);
+  parameters: {};
+  hideLabel: boolean;
+  configProps$: any;
+
+  referenceList: any;
+  selectionKey: string;
+  primaryField: string;
+  initialCaseClass: any;
+  showSecondaryInSearchOnly = false;
+  isGroupData = false;
+  referenceType;
+  secondaryFields;
+  groupDataSource = [];
+  matchPosition = 'contains';
+  maxResultsDisplay;
+  groupColumnsConfig = [{}];
+  selectionList;
+  listActions: any;
+  selectedItems: any[] = [];
+  itemsTreeBaseData = [];
+  displayFieldMeta: any;
+  dataApiObj: any;
+  itemsTree: any[] = [];
+  trigger: any;
+
+  constructor(
+    private angularPConnect: AngularPConnectService,
+    private utils: Utils
+  ) {}
+
+  ngOnInit(): void {
+    // First thing in initialization is registering and subscribing to the AngularPConnect service
+    this.angularPConnectData = this.angularPConnect.registerAndSubscribeComponent(this, this.onStateChange);
+    this.controlName$ = this.angularPConnect.getComponentID(this);
+
+    // Then, continue on with other initialization
+    this.checkAndUpdate();
+
+    if (this.formGroup$) {
+      // add control to formGroup
+      this.formGroup$.addControl(this.controlName$, this.fieldControl);
+      this.fieldControl.setValue(this.value$);
+      this.bHasForm$ = true;
+    } else {
+      this.bHasForm$ = false;
+    }
+  }
+
+  ngOnDestroy(): void {
+    if (this.formGroup$) {
+      this.formGroup$.removeControl(this.controlName$);
+    }
+
+    if (this.angularPConnectData.unsubscribeFn) {
+      this.angularPConnectData.unsubscribeFn();
+    }
+  }
+
+  // Callback passed when subscribing to store change
+  onStateChange() {
+    this.checkAndUpdate();
+  }
+
+  checkAndUpdate() {
+    // Should always check the bridge to see if the component should
+    // update itself (re-render)
+    const bUpdateSelf = this.angularPConnect.shouldComponentUpdate(this);
+
+    // ONLY call updateSelf when the component should update
+    if (bUpdateSelf) {
+      this.updateSelf();
+    }
+  }
+
+  // updateSelf
+  updateSelf() {
+    this.configProps$ = this.pConn$.resolveConfigProps(this.pConn$.getConfigProps());
+
+    let { datasource = [], columns = [{}] } = this.configProps$;
+    this.setPropertyValuesFromProps();
+
+    if (this.referenceList.length > 0) {
+      datasource = this.referenceList;
+      columns = [
+        {
+          value: this.primaryField,
+          display: 'true',
+          useForSearch: true,
+          primary: 'true'
+        },
+        {
+          value: this.selectionKey,
+          setProperty: this.selectionKey,
+          key: 'true'
+        }
+      ];
+      let secondaryColumns: any = [];
+      if (this.secondaryFields) {
+        secondaryColumns = this.secondaryFields.map(secondaryField => ({
+          value: secondaryField,
+          display: 'true',
+          secondary: 'true',
+          useForSearch: 'true'
+        }));
+      } else {
+        secondaryColumns = [
+          {
+            value: this.selectionKey,
+            display: 'true',
+            secondary: 'true',
+            useForSearch: 'true'
+          }
+        ];
+      }
+      if (this.referenceType === 'Case') {
+        columns = [...columns, ...secondaryColumns];
+      }
+    }
+
+    this.value$ = this.value$ ? this.value$ : '';
+    const contextName = this.pConn$.getContextName();
+
+    const dataConfig = {
+      dataSource: datasource,
+      groupDataSource: this.groupDataSource,
+      isGroupData: this.isGroupData,
+      showSecondaryInSearchOnly: this.showSecondaryInSearchOnly,
+      parameters: this.parameters,
+      matchPosition: this.matchPosition,
+      listType: this.listType,
+      maxResultsDisplay: this.maxResultsDisplay || '100',
+      columns: preProcessColumns(columns),
+      groupColumnsConfig: preProcessColumns(this.groupColumnsConfig)
+    };
+
+    const groupsDisplayFieldMeta = this.listType !== 'associated' ? getDisplayFieldsMetaData(dataConfig.groupColumnsConfig) : null;
+
+    this.itemsTreeBaseData = getGroupDataForItemsTree(this.groupDataSource, groupsDisplayFieldMeta, this.showSecondaryInSearchOnly) || [];
+
+    this.itemsTree = this.isGroupData ? getGroupDataForItemsTree(this.groupDataSource, groupsDisplayFieldMeta, this.showSecondaryInSearchOnly) : [];
+
+    this.displayFieldMeta = this.listType !== 'associated' ? getDisplayFieldsMetaData(dataConfig.columns) : null;
+
+    this.listActions = this.pConn$.getListActions();
+    this.pConn$.setReferenceList(this.selectionList);
+
+    if (this.configProps$.visibility != null) {
+      this.bVisible$ = this.utils.getBooleanValue(this.configProps$.visibility);
+    }
+
+    // disabled
+    if (this.configProps$.disabled != undefined) {
+      this.bDisabled$ = this.utils.getBooleanValue(this.configProps$.disabled);
+    }
+
+    if (this.bDisabled$) {
+      this.fieldControl.disable();
+    } else {
+      this.fieldControl.enable();
+    }
+
+    if (this.listType !== 'associated') {
+      PCore.getDataApi()
+        ?.init(dataConfig, contextName)
+        .then(async dataObj => {
+          this.dataApiObj = dataObj;
+          if (!this.isGroupData) {
+            this.getCaseListBasedOnParams(this.value$ ?? '', '', [...this.selectedItems], [...this.itemsTree]);
+          }
+        });
+    }
+  }
+
+  setPropertyValuesFromProps() {
+    this.label$ = this.configProps$.label;
+    this.placeholder = this.configProps$.placeholder || '';
+    this.listType = this.configProps$.listType ? this.configProps$.listType : '';
+    this.hideLabel = this.configProps$.hideLabel;
+    this.parameters = this.configProps$?.parameters ? this.configProps$?.parameters : {};
+    this.referenceList = this.configProps$?.referenceList;
+    this.selectionKey = this.configProps$?.selectionKey;
+    this.primaryField = this.configProps$?.primaryField;
+    this.initialCaseClass = this.configProps$?.initialCaseClass;
+    this.showSecondaryInSearchOnly = this.configProps$?.showSecondaryInSearchOnly ? this.configProps$?.showSecondaryInSearchOnly : false;
+    this.isGroupData = this.configProps$?.isGroupData ? this.configProps$.isGroupData : false;
+    this.referenceType = this.configProps$?.referenceType;
+    this.secondaryFields = this.configProps$?.secondaryFields;
+    this.groupDataSource = this.configProps$?.groupDataSource ? this.configProps$?.groupDataSource : [];
+    this.matchPosition = this.configProps$?.matchPosition ? this.configProps$?.matchPosition : 'contains';
+    this.maxResultsDisplay = this.configProps$?.maxResultsDisplay;
+    this.groupColumnsConfig = this.configProps$?.groupColumnsConfig ? this.configProps$?.groupColumnsConfig : [{}];
+    this.selectionList = this.configProps$?.selectionList;
+    this.value$ = this.configProps$?.value;
+  }
+
+  // main search function trigger
+  getCaseListBasedOnParams(searchText, group, selectedRows, currentItemsTree, isTriggeredFromSearch = false) {
+    if (this.referenceList && this.referenceList.length > 0) {
+      this.listActions.getSelectedRows(true).then(result => {
+        selectedRows =
+          result.length > 0
+            ? result.map(item => {
+                return {
+                  id: item[this.selectionKey.startsWith('.') ? this.selectionKey.substring(1) : this.selectionKey],
+                  primary: item[this.primaryField.startsWith('.') ? this.primaryField.substring(1) : this.primaryField]
+                };
+              })
+            : [];
+        this.selectedItems = selectedRows;
+
+        const initalItemsTree = isTriggeredFromSearch || !currentItemsTree ? [...this.itemsTreeBaseData] : [...currentItemsTree];
+
+        doSearch(
+          searchText,
+          group,
+          this.initialCaseClass,
+          this.displayFieldMeta,
+          this.dataApiObj,
+          initalItemsTree,
+          this.isGroupData,
+          this.showSecondaryInSearchOnly,
+          selectedRows || []
+        ).then(res => {
+          this.itemsTree = res || [];
+          if (this.trigger) {
+            this.trigger.openPanel();
+          }
+        });
+      });
+    }
+  }
+
+  fieldOnChange(event: Event) {
+    this.value$ = (event.target as HTMLInputElement).value;
+    this.getCaseListBasedOnParams(this.value$, '', [...this.selectedItems], [...this.itemsTree], true);
+  }
+
+  optionChanged(event: MatAutocompleteSelectedEvent) {
+    this.angularPConnectData.actions?.onChange(this, event);
+  }
+
+  optionClicked = (event: Event, data: any, trigger?: MatAutocompleteTrigger): void => {
+    event.stopPropagation();
+    this.toggleSelection(data, trigger);
+  };
+
+  toggleSelection = (data: any, trigger?: MatAutocompleteTrigger): void => {
+    data.selected = !data.selected;
+    this.trigger = trigger;
+    this.itemsTree.map((ele: any) => {
+      if (ele.id === data.id) {
+        ele.selected = data.selected;
+      }
+      return ele;
+    });
+
+    if (data.selected === true) {
+      this.selectedItems.push(data);
+    } else {
+      const index = this.selectedItems.findIndex(value => value.id === data.id);
+      this.selectedItems.splice(index, 1);
+    }
+
+    this.value$ = '';
+    // if this is a referenceList case
+    if (this.referenceList) this.setSelectedItemsForReferenceList(data);
+
+    this.getCaseListBasedOnParams(this.value$, '', [...this.selectedItems], [...this.itemsTree], true);
+  };
+
+  removeChip = (data: any): void => {
+    if (data) {
+      data = this.itemsTree.filter((ele: any) => {
+        return ele.id === data.id;
+      });
+      this.toggleSelection(data[0]);
+    }
+  };
+
+  setSelectedItemsForReferenceList(data: any) {
+    // Clear error messages if any
+    const propName = (this.pConn$.getStateProps() as any).selectionList;
+    this.pConn$.clearErrorMessages({
+      property: propName,
+      category: '',
+      context: ''
+    });
+    const { selected } = data;
+    if (selected) {
+      insertInstruction(this.pConn$, this.selectionList, this.selectionKey, this.primaryField, data);
+    } else {
+      deleteInstruction(this.pConn$, this.selectionList, this.selectionKey, data);
+    }
+  }
+
+  getErrorMessage() {
+    let errMessage = '';
+
+    // look for validation messages for json, pre-defined or just an error pushed from workitem (400)
+    if (this.fieldControl.hasError('message')) {
+      errMessage = this.angularPConnectData.validateMessage ?? '';
+      return errMessage;
+    }
+    if (this.fieldControl.hasError('required')) {
+      errMessage = 'You must enter a value';
+    } else if (this.fieldControl.errors) {
+      errMessage = this.fieldControl.errors.toString();
+    }
+
+    return errMessage;
+  }
+}

package/lib/field/multiselect/utils.ts

@@ -0,0 +1,209 @@
+import cloneDeep from 'lodash/cloneDeep';
+
+export function setVisibilityForList(c11nEnv, visibility) {
+  const { selectionMode, selectionList, renderMode, referenceList } = c11nEnv.getComponentConfig();
+  // usecase:multiselect, fieldgroup, editable table
+  if ((selectionMode === PCore.getConstants().LIST_SELECTION_MODE.MULTI && selectionList) || (renderMode === 'Editable' && referenceList)) {
+    c11nEnv.getListActions().setVisibility(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;
+    }
+    return tempColObj;
+  });
+}
+
+function getDisplayFieldsMetaData(columns) {
+  const displayColumns = columns?.filter(col => col.display === 'true');
+  const metaDataObj: any = {
+    key: '',
+    primary: '',
+    secondary: []
+  };
+  const keyCol = columns?.filter(col => col.key === 'true');
+  metaDataObj.key = keyCol?.length > 0 ? keyCol[0].value : 'auto';
+  const itemsRecordsColumn = columns?.filter(col => col.itemsRecordsColumn === 'true');
+  if (itemsRecordsColumn?.length > 0) {
+    metaDataObj.itemsRecordsColumn = itemsRecordsColumn[0].value;
+  }
+  const itemsGroupKeyColumn = columns?.filter(col => col.itemsGroupKeyColumn === 'true');
+  if (itemsGroupKeyColumn?.length > 0) {
+    metaDataObj.itemsGroupKeyColumn = itemsGroupKeyColumn[0].value;
+  }
+  for (let index = 0; index < displayColumns?.length; index += 1) {
+    if (displayColumns[index].secondary === 'true') {
+      metaDataObj.secondary.push(displayColumns[index].value);
+    } else if (displayColumns[index].primary === 'true') {
+      metaDataObj.primary = displayColumns[index].value;
+    }
+  }
+  return metaDataObj;
+}
+
+function createSingleTreeObejct(entry, displayFieldMeta, showSecondaryData, selected) {
+  const secondaryArr: any = [];
+  displayFieldMeta.secondary.forEach(col => {
+    secondaryArr.push(entry[col]);
+  });
+  const isSelected = selected.some(item => item.id === entry[displayFieldMeta.key]);
+
+  return {
+    id: entry[displayFieldMeta.key],
+    primary: entry[displayFieldMeta.primary],
+    secondary: showSecondaryData ? secondaryArr : [],
+    selected: isSelected
+  };
+}
+
+function putItemsDataInItemsTree(listObjData, displayFieldMeta, itemsTree, showSecondaryInSearchOnly, selected) {
+  let newTreeItems = itemsTree.slice();
+  const showSecondaryData = !showSecondaryInSearchOnly;
+  for (const obj of listObjData) {
+    const items = obj[displayFieldMeta.itemsRecordsColumn].map(entry => createSingleTreeObejct(entry, displayFieldMeta, showSecondaryData, selected));
+
+    newTreeItems = newTreeItems.map(caseObject => {
+      if (caseObject.id === obj[displayFieldMeta.itemsGroupKeyColumn]) {
+        caseObject.items = [...items];
+      }
+      return caseObject;
+    });
+  }
+  return newTreeItems;
+}
+
+function prepareSearchResults(listObjData, displayFieldMeta) {
+  const searchResults: any = [];
+  for (const obj of listObjData) {
+    searchResults.push(...obj[displayFieldMeta.itemsRecordsColumn]);
+  }
+  return searchResults;
+}
+
+async function doSearch(
+  searchText,
+  clickedGroup,
+  initialCaseClass,
+  displayFieldMeta,
+  dataApiObj, // deep clone of the dataApiObj
+  itemsTree,
+  isGroupData,
+  showSecondaryInSearchOnly,
+  selected
+) {
+  let searchTextForUngroupedData = '';
+  if (dataApiObj) {
+    // creating dataApiObject in grouped data cases
+    if (isGroupData) {
+      dataApiObj = cloneDeep(dataApiObj);
+      dataApiObj.fetchedNQData = false;
+      dataApiObj.cache = {};
+
+      // if we have no search text and no group selected, return the original tree
+      if (searchText === '' && clickedGroup === '') {
+        return itemsTree;
+      }
+
+      // setting the inital search text & search classes in ApiObject
+      dataApiObj.parameters[Object.keys(dataApiObj.parameters)[1]] = searchText;
+      dataApiObj.parameters[Object.keys(dataApiObj.parameters)[0]] = initialCaseClass;
+
+      // if we have a selected group
+      if (clickedGroup) {
+        // check if the data for this group is already present and no search text
+        if (searchText === '') {
+          const containsData = itemsTree.find(item => item.id === clickedGroup);
+          // do not make API call when items of respective group are already fetched
+          if (containsData?.items?.length) return itemsTree;
+        }
+
+        dataApiObj.parameters[Object.keys(dataApiObj.parameters)[0]] = JSON.stringify([clickedGroup]);
+      }
+    } else {
+      searchTextForUngroupedData = searchText;
+    }
+
+    // search API call
+    const response = await dataApiObj.fetchData(searchTextForUngroupedData).catch(() => {
+      return itemsTree;
+    });
+
+    let listObjData = response.data;
+    let newItemsTree = [];
+    if (isGroupData) {
+      if (searchText) {
+        listObjData = prepareSearchResults(listObjData, displayFieldMeta);
+      } else {
+        newItemsTree = putItemsDataInItemsTree(listObjData, displayFieldMeta, itemsTree, showSecondaryInSearchOnly, selected);
+        return newItemsTree;
+      }
+    }
+    const showSecondaryData = showSecondaryInSearchOnly ? !!searchText : true;
+    if (listObjData !== undefined && listObjData.length > 0) {
+      newItemsTree = listObjData.map(entry => createSingleTreeObejct(entry, displayFieldMeta, showSecondaryData, selected));
+    }
+    return newItemsTree;
+  }
+
+  return itemsTree;
+}
+
+function setValuesToPropertyList(searchText, assocProp, items, columns, actions, updatePropertyInRedux = true) {
+  const setPropertyList = columns
+    ?.filter(col => col.setProperty)
+    .map(col => {
+      return {
+        source: col.value,
+        target: col.setProperty,
+        key: col.key,
+        primary: col.primary
+      };
+    });
+  const valueToSet: any = [];
+  if (setPropertyList.length > 0) {
+    setPropertyList.forEach(prop => {
+      items.forEach(item => {
+        if (prop.key === 'true' && item) {
+          valueToSet.push(item.id);
+        } else if (prop.primary === 'true' || !item) {
+          valueToSet.push(searchText);
+        }
+      });
+
+      if (updatePropertyInRedux) {
+        // BUG-666851 setting options so that the store values are replaced and not merged
+        const options = {
+          isArrayDeepMerge: false
+        };
+        if (prop.target === 'Associated property') {
+          actions.updateFieldValue(assocProp, valueToSet, options);
+        } else {
+          actions.updateFieldValue(`.${prop.target}`, valueToSet, options);
+        }
+      }
+    });
+  }
+  return valueToSet;
+}
+
+function getGroupDataForItemsTree(groupDataSource, groupsDisplayFieldMeta, showSecondaryInSearchOnly) {
+  return groupDataSource?.map(group => {
+    const secondaryArr: any = [];
+    groupsDisplayFieldMeta.secondary.forEach(col => {
+      secondaryArr.push(group[col]);
+    });
+    return {
+      id: group[groupsDisplayFieldMeta.key],
+      primary: group[groupsDisplayFieldMeta.primary],
+      secondary: showSecondaryInSearchOnly ? [] : secondaryArr,
+      items: []
+    };
+  });
+}
+
+export { preProcessColumns, getDisplayFieldsMetaData, doSearch, setValuesToPropertyList, getGroupDataForItemsTree };

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

@@ -1,48 +1,53 @@
 <div class="psdk-user-reference">
-  <div *ngIf="type === 'operator'">
-    <component-mapper name="Operator" [props]="{ pConn$ }"></component-mapper>
-  </div>
-  <div [formGroup]="formGroup$" *ngIf="type === 'dropdown'">
-    <mat-form-field class="psdk-full-width" subscriptSizing="dynamic" [hintLabel]="helperText">
-      <mat-select
-        [value]="value$"
-        [required]="bRequired$"
-        [formControl]="fieldControl"
-        [attr.data-test-id]="testId"
-        (selectionChange)="fieldOnChange($event)"
-      >
-        <mat-option *ngFor="let opt of options$" [value]="opt.key">
-          {{ opt.value }}
-        </mat-option>
-      </mat-select>
-      <mat-label>{{ label$ }}</mat-label>
-      <mat-error *ngIf="fieldControl.invalid">
-        {{ getErrorMessage() }}
-      </mat-error>
-    </mat-form-field>
-  </div>
-  <div [formGroup]="formGroup$" *ngIf="type === 'searchbox'">
-    <mat-form-field class="psdk-full-width" subscriptSizing="dynamic" [hintLabel]="helperText">
-      <mat-label>{{ label$ }}</mat-label>
-      <input
-        matInput
-        [placeholder]="placeholder"
-        [formControl]="fieldControl"
-        [value]="value$"
-        [required]="bRequired$"
-        [matAutocomplete]="auto"
-        [attr.data-test-id]="testId"
-        (change)="fieldOnChange($event)"
-        (blur)="fieldOnBlur($event)"
-      />
-      <mat-autocomplete #auto="matAutocomplete">
-        <mat-option *ngFor="let opt of options$" [value]="opt.value">
-          <span>{{ opt.value }}</span>
-        </mat-option>
-      </mat-autocomplete>
-      <mat-error *ngIf="fieldControl.invalid">
-        {{ getErrorMessage() }}
-      </mat-error>
-    </mat-form-field>
+  <div *ngIf="displayMode$; else noDisplayMode">
+    <component-mapper name="FieldValueList" [props]="{ label$, value$, displayMode$ }"></component-mapper>
   </div>
+  <ng-template #noDisplayMode>
+    <div *ngIf="type === 'operator'">
+      <component-mapper name="Operator" [props]="{ pConn$ }"></component-mapper>
+    </div>
+    <div [formGroup]="formGroup$" *ngIf="type === 'dropdown'">
+      <mat-form-field class="psdk-full-width" subscriptSizing="dynamic" [hintLabel]="helperText">
+        <mat-select
+          [value]="value$"
+          [required]="bRequired$"
+          [formControl]="fieldControl"
+          [attr.data-test-id]="testId"
+          (selectionChange)="fieldOnChange($event)"
+        >
+          <mat-option *ngFor="let opt of options$" [value]="opt.key">
+            {{ opt.value }}
+          </mat-option>
+        </mat-select>
+        <mat-label>{{ label$ }}</mat-label>
+        <mat-error *ngIf="fieldControl.invalid">
+          {{ getErrorMessage() }}
+        </mat-error>
+      </mat-form-field>
+    </div>
+    <div [formGroup]="formGroup$" *ngIf="type === 'searchbox'">
+      <mat-form-field class="psdk-full-width" subscriptSizing="dynamic" [hintLabel]="helperText">
+        <mat-label>{{ label$ }}</mat-label>
+        <input
+          matInput
+          [placeholder]="placeholder"
+          [formControl]="fieldControl"
+          [value]="value$"
+          [required]="bRequired$"
+          [matAutocomplete]="auto"
+          [attr.data-test-id]="testId"
+          (change)="fieldOnChange($event)"
+          (blur)="fieldOnBlur($event)"
+        />
+        <mat-autocomplete #auto="matAutocomplete">
+          <mat-option *ngFor="let opt of options$" [value]="opt.value">
+            <span>{{ opt.value }}</span>
+          </mat-option>
+        </mat-autocomplete>
+        <mat-error *ngIf="fieldControl.invalid">
+          {{ getErrorMessage() }}
+        </mat-error>
+      </mat-form-field>
+    </div>
+  </ng-template>
 </div>

package/lib/field/user-reference/user-reference.component.ts

@@ -57,6 +57,7 @@ export class UserReferenceComponent implements OnInit, OnDestroy {
   testId: string;
   helperText: string;
   placeholder: string;
+  displayMode$?: string;
 
   fieldControl = new FormControl('', null);
 
@@ -124,13 +125,14 @@ export class UserReferenceComponent implements OnInit, OnDestroy {
     const props = this.pConn$.getConfigProps() as UserReferenceProps;
     this.testId = props.testId;
 
-    const { label, displayAs, value, showAsFormattedText, helperText, placeholder } = props;
+    const { label, displayAs, value, showAsFormattedText, helperText, placeholder, displayMode } = props;
 
     this.label$ = label;
     this.showAsFormattedText$ = showAsFormattedText;
     this.displayAs$ = displayAs;
     this.helperText = helperText;
     this.placeholder = placeholder || '';
+    this.displayMode$ = displayMode;
 
     const { readOnly, required } = props;
     [this.bReadonly$, this.bRequired$] = [readOnly, required].map(prop => prop === true || (typeof prop === 'string' && prop === 'true'));