@pega/dx-component-builder-sdk 23.1.11 → 23.1.12

package/tests/assets/sdk-a/components/create/custom-sdk/field/pega-dxil-my-test-text/pega-dxil-my-test-text.component.ts

@@ -0,0 +1,172 @@
+import { Component, OnInit, Input, forwardRef, OnDestroy } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { FormControl, FormGroup, ReactiveFormsModule } from '@angular/forms';
+import { MatInputModule } from '@angular/material/input';
+import { MatFormFieldModule } from '@angular/material/form-field';
+import { interval } from 'rxjs';
+import { AngularPConnectData, AngularPConnectService } from '@pega/angular-sdk-components';
+import { Utils } from '@pega/angular-sdk-components';
+import { ComponentMapperComponent } from '@pega/angular-sdk-components';
+import { PConnFieldProps } from '@pega/angular-sdk-components';
+
+interface PegaDxilMyTestTextProps extends PConnFieldProps {
+  // If any, enter additional props that only exist on Text here
+}
+
+@Component({
+  selector: 'app-pega-dxil-my-test-text',
+  templateUrl: './pega-dxil-my-test-text.component.html',
+  styleUrls: ['./pega-dxil-my-test-text.component.scss'],
+  standalone: true,
+  imports: [CommonModule, MatInputModule, MatFormFieldModule, ReactiveFormsModule, forwardRef(() => ComponentMapperComponent)]
+})
+export class PegaDxilMyTestTextComponent implements OnInit, OnDestroy {
+  @Input() pConn$: typeof PConnect;
+  @Input() formGroup$: FormGroup;
+
+  // For interaction with AngularPConnect
+  angularPConnectData: AngularPConnectData = {};
+  configProps$: PegaDxilMyTestTextProps;
+
+  value$ = '';
+  placeholder: string;
+  bVisible$ = true;
+  bDisabled$ = false;
+  bReadonly$ = false;
+  bRequired$ = false;
+  label$ = '';
+  bHideLabel$ = false;
+  testId = '';
+  helperText: string;
+
+  controlName$: string;
+  bHasForm$ = true;
+  componentReference = '';
+
+  fieldControl = new FormControl('', null);
+
+  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
+
+    // call updateSelf when initializing
+    // this.updateSelf();
+    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.bReadonly$ = true;
+      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(): void {
+    this.componentReference = (this.pConn$.getStateProps() as any).value;
+    // moved this from ngOnInit() and call this from there instead...
+    this.configProps$ = this.pConn$.resolveConfigProps(this.pConn$.getConfigProps()) as PegaDxilMyTestTextProps;
+
+    this.value$ = this.configProps$.value || '';
+    this.testId = this.configProps$.testId;
+    this.label$ = this.configProps$.label;
+    this.helperText = this.configProps$.helperText;
+    this.placeholder = this.configProps$.placeholder || '';
+
+    if (this.configProps$.visibility != null) {
+      this.bVisible$ = this.utils.getBooleanValue(this.configProps$.visibility);
+    }
+
+    if (this.configProps$.required != null) {
+      this.bRequired$ = this.utils.getBooleanValue(this.configProps$.required);
+    }
+
+    // disabled
+    if (this.configProps$.disabled != null) {
+      this.bDisabled$ = this.utils.getBooleanValue(this.configProps$.disabled);
+    }
+
+    if (this.bDisabled$) {
+      this.fieldControl.disable();
+    } else {
+      this.fieldControl.enable();
+    }
+
+    if (this.configProps$.readOnly != null) {
+      this.bReadonly$ = this.utils.getBooleanValue(this.configProps$.readOnly);
+    }
+
+    // trigger display of error message with field control
+    if (this.angularPConnectData.validateMessage != null && this.angularPConnectData.validateMessage != '') {
+      const timer = interval(100).subscribe(() => {
+        this.fieldControl.setErrors({ message: true });
+        this.fieldControl.markAsTouched();
+
+        timer.unsubscribe();
+      });
+    }
+  }
+
+  fieldOnChange(event: any) {
+    this.angularPConnectData.actions?.onChange(this, event);
+  }
+
+  fieldOnBlur(event: any) {
+    // PConnect wants to use eventHandler for onBlur
+    this.angularPConnectData.actions?.onBlur(this, event);
+  }
+
+  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/tests/assets/sdk-a/components/create/override-sdk/designSystemExtension/alert/alert.component.html

@@ -0,0 +1,19 @@
+<div
+  class="psdk-alert"
+  [ngClass]="{
+    'psdk-alert-error': severity === 'error',
+    'psdk-grid-warning': severity === 'warning',
+    'psdk-grid-success': severity === 'success',
+    'psdk-grid-info': severity === 'info'
+  }"
+>
+  <div class="psdk-alert-icon">
+    <mat-icon>{{ getMatIcon(severity) }}</mat-icon>
+  </div>
+  <div>{{ message }}</div>
+  <div *ngIf="!hideClose" style="margin-left: auto">
+    <button class="close-button" mat-icon-button (click)="onCloseClick()">
+      <mat-icon>close</mat-icon>
+    </button>
+  </div>
+</div>

package/tests/assets/sdk-a/components/create/override-sdk/designSystemExtension/alert/alert.component.scss

@@ -0,0 +1,52 @@
+.psdk-alert {
+  border: 1px solid;
+  display: flex;
+  align-items: center;
+  border-radius: 4px;
+  padding: 10px;
+  margin: 5px 0px;
+}
+
+.psdk-alert-icon {
+  display: flex;
+  align-items: center;
+  margin-right: 10px;
+}
+
+.psdk-alert-error {
+  color: var(--app-alert-error-color);
+  border: 1px solid var(--app-alert-error-border-color);
+  .mat-icon {
+    color: var(--app-alert-error-border-color);
+  }
+}
+
+.psdk-grid-warning {
+  color: var(--app-alert-warning-color);
+  border: 1px solid var(--app-alert-warning-border-color);
+  .mat-icon {
+    color: var(--app-alert-warning-border-color);
+  }
+}
+
+.psdk-grid-success {
+  color: var(--app-alert-success-color);
+  border: 1px solid var(--app-alert-success-border-color);
+  .mat-icon {
+    color: var(--app-alert-success-border-color);
+  }
+}
+
+.psdk-grid-info {
+  color: var(--app-alert-info-color);
+  border: 1px solid var(--app-alert-info-border-color);
+  .mat-icon {
+    color: var(--app-alert-info-border-color);
+  }
+}
+
+.close-button {
+  background: none;
+  border: none;
+  cursor: pointer;
+}

package/tests/assets/sdk-a/components/create/override-sdk/designSystemExtension/alert/alert.component.spec.ts

@@ -0,0 +1,22 @@
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+
+import { AlertComponent } from './alert.component';
+
+describe('AlertComponent', () => {
+  let component: AlertComponent;
+  let fixture: ComponentFixture<AlertComponent>;
+
+  beforeEach(async () => {
+    await TestBed.configureTestingModule({
+      declarations: [AlertComponent]
+    }).compileComponents();
+
+    fixture = TestBed.createComponent(AlertComponent);
+    component = fixture.componentInstance;
+    fixture.detectChanges();
+  });
+
+  it('should create', () => {
+    expect(component).toBeTruthy();
+  });
+});

package/tests/assets/sdk-a/components/create/override-sdk/designSystemExtension/alert/alert.component.ts

@@ -0,0 +1,43 @@
+import { Component, Input, Output, EventEmitter } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { MatIconModule } from '@angular/material/icon';
+
+@Component({
+  selector: 'app-alert',
+  templateUrl: './alert.component.html',
+  styleUrls: ['./alert.component.scss'],
+  standalone: true,
+  imports: [CommonModule, MatIconModule]
+})
+export class AlertComponent {
+  @Input() message: any[];
+  @Input() severity;
+  @Input() hideClose;
+  @Output() onClose: EventEmitter<any> = new EventEmitter();
+
+  getMatIcon(severity) {
+    let variant;
+    switch (severity) {
+      case 'error':
+        variant = 'error_outline';
+        break;
+      case 'warning':
+        variant = 'warning_amber';
+        break;
+      case 'success':
+        variant = 'task_alt';
+        break;
+      case 'info':
+        variant = 'info_outline';
+        break;
+      default:
+        break;
+    }
+    return variant;
+  }
+
+  onCloseClick() {
+    alert('Close clicked');
+    this.onClose.emit({ Page: 'Page', target: 'target', type: 'type' });
+  }
+}

package/tests/assets/sdk-a/components/create/override-sdk/designSystemExtension/alert-banner/alert-banner.component.html

@@ -0,0 +1,12 @@
+<div>
+  <div *ngFor="let banner of banners">
+    <div *ngFor="let message of banner.messages">
+      <component-mapper
+        name="Alert"
+        [props]="{ message, severity: SEVERITY_MAP[banner.variant], hideClose: banner.variant === 'urgent' }"
+        [parent]="this"
+        [outputEvents]="{ onClose: onAlertClose }"
+      ></component-mapper>
+    </div>
+  </div>
+</div>

package/tests/assets/sdk-a/components/create/override-sdk/designSystemExtension/alert-banner/alert-banner.component.spec.ts

@@ -0,0 +1,22 @@
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+
+import { AlertBannerComponent } from './alert-banner.component';
+
+describe('AlertBannerComponent', () => {
+  let component: AlertBannerComponent;
+  let fixture: ComponentFixture<AlertBannerComponent>;
+
+  beforeEach(async () => {
+    await TestBed.configureTestingModule({
+      declarations: [AlertBannerComponent]
+    }).compileComponents();
+
+    fixture = TestBed.createComponent(AlertBannerComponent);
+    component = fixture.componentInstance;
+    fixture.detectChanges();
+  });
+
+  it('should create', () => {
+    expect(component).toBeTruthy();
+  });
+});

package/tests/assets/sdk-a/components/create/override-sdk/designSystemExtension/alert-banner/alert-banner.component.ts

@@ -0,0 +1,27 @@
+import { Component, Input, forwardRef } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { ComponentMapperComponent } from '@pega/angular-sdk-components';
+
+@Component({
+  selector: 'app-alert-banner',
+  templateUrl: './alert-banner.component.html',
+  styleUrls: ['./alert-banner.component.scss'],
+  standalone: true,
+  imports: [CommonModule, forwardRef(() => ComponentMapperComponent)]
+})
+export class AlertBannerComponent {
+  @Input() banners: any[];
+
+  SEVERITY_MAP = {
+    urgent: 'error',
+    warning: 'warning',
+    success: 'success',
+    info: 'info'
+  };
+
+  onAlertClose(config) {
+    const { PAGE, type, target } = config;
+    const { clearMessages } = PCore.getMessageManager();
+    clearMessages({ category: PAGE, type, context: target } as any);
+  }
+}

package/tests/assets/sdk-a/components/create/override-sdk/designSystemExtension/case-create-stage/case-create-stage.component.spec.ts

@@ -0,0 +1,24 @@
+import { ComponentFixture, TestBed, waitForAsync } from '@angular/core/testing';
+
+import { CaseCreateStageComponent } from './case-create-stage.component';
+
+describe('CaseCreateStageComponent', () => {
+  let component: CaseCreateStageComponent;
+  let fixture: ComponentFixture<CaseCreateStageComponent>;
+
+  beforeEach(waitForAsync(() => {
+    TestBed.configureTestingModule({
+      declarations: [CaseCreateStageComponent]
+    }).compileComponents();
+  }));
+
+  beforeEach(() => {
+    fixture = TestBed.createComponent(CaseCreateStageComponent);
+    component = fixture.componentInstance;
+    fixture.detectChanges();
+  });
+
+  it('should create', () => {
+    expect(component).toBeTruthy();
+  });
+});

package/tests/assets/sdk-a/components/create/override-sdk/designSystemExtension/case-create-stage/case-create-stage.component.ts

@@ -0,0 +1,58 @@
+import { Component, OnInit, Input, forwardRef, OnDestroy } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { FormGroup } from '@angular/forms';
+import { AngularPConnectData, AngularPConnectService } from '@pega/angular-sdk-components';
+import { ComponentMapperComponent } from '@pega/angular-sdk-components';
+
+@Component({
+  selector: 'app-case-create-stage',
+  templateUrl: './case-create-stage.component.html',
+  styleUrls: ['./case-create-stage.component.scss'],
+  standalone: true,
+  imports: [CommonModule, forwardRef(() => ComponentMapperComponent)]
+})
+export class CaseCreateStageComponent implements OnInit, OnDestroy {
+  @Input() pConn$: typeof PConnect;
+  @Input() formGroup$: FormGroup;
+
+  arChildren$: any[];
+
+  // For interaction with AngularPConnect
+  angularPConnectData: AngularPConnectData = {};
+
+  constructor(private angularPConnect: AngularPConnectService) {}
+
+  ngOnInit(): void {
+    // First thing in initialization is registering and subscribing to the AngularPConnect service
+    this.angularPConnectData = this.angularPConnect.registerAndSubscribeComponent(this, this.onStateChange);
+
+    // this.updateSelf();
+    this.checkAndUpdate();
+  }
+
+  ngOnDestroy() {
+    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() {
+    this.arChildren$ = this.pConn$.getChildren() as any[];
+  }
+}

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

@@ -0,0 +1,21 @@
+<div class="field-group-container">
+  <div *ngIf="name" class="field-group-heading">
+    <span *ngIf="collapsible; else no_collapse" id="field-group-header" class="field-group-header" (click)="headerClickHandler()">
+      <mat-icon *ngIf="collapsed; else down_arrow" aria-hidden="false" aria-label="Arrow Right" fontIcon="keyboard_arrow_right"></mat-icon>
+      <ng-template #down_arrow>
+        <mat-icon aria-hidden="false" aria-label="Arrow Down" fontIcon="keyboard_arrow_down"></mat-icon>
+      </ng-template>
+      <b>{{ name }}</b>
+    </span>
+    <ng-template #no_collapse>
+      <span>{{ name }}</span>
+    </ng-template>
+  </div>
+
+  <div *ngIf="instructions && instructions !== 'none'" class="field-group-instructions">
+    <div key="instructions" id="instruction-text" [innerHTML]="instructions"></div>
+  </div>
+  <div *ngIf="!collapsed" class="field-group-content">
+    <ng-container [ngTemplateOutlet]="childrenTemplate"></ng-container>
+  </div>
+</div>

package/tests/assets/sdk-a/components/create/override-sdk/designSystemExtension/field-group/field-group.component.scss

@@ -0,0 +1,18 @@
+.field-group-container {
+  .field-group-heading {
+    padding-top: 8px;
+    padding-bottom: 8px;
+    font-weight: bold;
+
+    .field-group-header {
+      gap: 5px;
+      display: flex;
+      align-items: center;
+      cursor: pointer;
+    }
+  }
+
+  .field-group-instructions {
+    padding: 5px 0;
+  }
+}

package/tests/assets/sdk-a/components/create/override-sdk/designSystemExtension/field-group/field-group.component.spec.ts

@@ -0,0 +1,21 @@
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+
+import { FieldGroupComponent } from './field-group.component';
+
+describe('FieldGroupComponent', () => {
+  let component: FieldGroupComponent;
+  let fixture: ComponentFixture<FieldGroupComponent>;
+
+  beforeEach(() => {
+    TestBed.configureTestingModule({
+      declarations: [FieldGroupComponent]
+    });
+    fixture = TestBed.createComponent(FieldGroupComponent);
+    component = fixture.componentInstance;
+    fixture.detectChanges();
+  });
+
+  it('should create', () => {
+    expect(component).toBeTruthy();
+  });
+});

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

@@ -0,0 +1,24 @@
+import { CommonModule } from '@angular/common';
+import { Component, Input, TemplateRef } from '@angular/core';
+import { MatGridListModule } from '@angular/material/grid-list';
+import { MatIconModule } from '@angular/material/icon';
+
+@Component({
+  selector: 'app-field-group',
+  templateUrl: './field-group.component.html',
+  styleUrls: ['./field-group.component.scss'],
+  standalone: true,
+  imports: [CommonModule, MatGridListModule, MatIconModule]
+})
+export class FieldGroupComponent {
+  @Input() name?: string;
+  @Input() collapsible = false;
+  @Input() instructions: string;
+  @Input() childrenTemplate: TemplateRef<any>;
+
+  collapsed = false;
+
+  headerClickHandler() {
+    this.collapsed = !this.collapsed;
+  }
+}

package/tests/assets/sdk-a/components/create/override-sdk/designSystemExtension/material-case-summary/material-case-summary.component.html

@@ -0,0 +1,52 @@
+<div class="psdk-case-summary-fields">
+  <dl class="psdk-case-summary-fields-primary">
+    <div *ngFor="let field of primaryFieldsWithStatus$" class="psdk-csf-primary-field">
+      <dt class="psdk-csf-primary-field-header">
+        {{ field.config.label }}
+      </dt>
+      <dd *ngIf="field.config.value === ''; else hasValue" class="psdk-csf-primary-field-data">
+        <ng-container [ngSwitch]="field.type.toLowerCase()">
+          <label *ngSwitchCase="'caseoperator'">operator</label>
+          <span *ngSwitchDefault class="psdk-csf-text-style">---</span>
+        </ng-container>
+      </dd>
+      <ng-template #hasValue>
+        <dd class="psdk-csf-primary-field-data" [ngSwitch]="field.type.toLowerCase()">
+          <span *ngSwitchCase="'textinput'" class="psdk-csf-text-style">{{ field.config.value }}</span>
+          <span *ngSwitchCase="'status'" class="psdk-csf-status-style">{{ field.config.value }}</span>
+          <a *ngSwitchCase="'phone'" as="a" href="tel: {{ field.config.value }}">{{ field.config.value }}</a>
+          <a *ngSwitchCase="'email'" href="mailto: {{ field.config.value }}">{{ field.config.value }}</a>
+          <span *ngSwitchCase="'date'" class="psdk-csf-text-style">{{ field.config.value }}</span>
+          <label *ngSwitchCase="'caseoperator'">operator</label>
+          <span *ngSwitchDefault class="psdk-csf-text-style">{{ field.config.value }}</span>
+        </dd>
+      </ng-template>
+    </div>
+  </dl>
+</div>
+<div class="psdk-case-summary-fields">
+  <dl *ngFor="let field of secondaryFields$" class="psdk-case-summary-fields-secondary">
+    <div
+      *ngIf="
+        field.config?.label?.toLowerCase() == 'create operator' || field.config?.label?.toLowerCase() == 'update operator';
+        else hasSecondaryValue
+      "
+    >
+      <component-mapper name="Operator" [props]="{ pConn$: field?.kid }"></component-mapper>
+    </div>
+    <ng-template #hasSecondaryValue>
+      <div class="psdk-csf-secondary-field">
+        <dt class="psdk-csf-secondary-field-header">
+          {{ field.config.displayLabel || field.config.label }}
+        </dt>
+        <dd class="psdk-csf-secondary-field-data">
+          <div [ngSwitch]="field.type">
+            <label *ngSwitchCase="'UserReference'" class="psdk-secondary-value">{{ field.config.value.userName || '---' }}</label>
+            <label *ngSwitchCase="'Checkbox'" class="psdk-secondary-value">{{ field.config.falseLabel || '---' }}</label>
+            <label *ngSwitchDefault class="psdk-secondary-value">{{ field.config.value || '---' }}</label>
+          </div>
+        </dd>
+      </div>
+    </ng-template>
+  </dl>
+</div>