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

package/tests/assets/sdk-r/components/create/override-sdk/field/SelectableCard/utils.tsx

@@ -0,0 +1,223 @@
+import { Link } from '@mui/material';
+
+import { Utils } from '@pega/react-sdk-components/lib/components/helpers/utils';
+
+export const resolveReferencedPConnect = pConnect => {
+  if (!pConnect || !pConnect.meta) return undefined;
+  const type = pConnect?._type ?? undefined;
+  const referencedPConnect = type === 'reference' && pConnect.getReferencedViewPConnect().getPConnect();
+  return referencedPConnect || pConnect;
+};
+
+/**
+ * A helper function to create an object consisting react component as per the type.
+ * This is used by CaseSummary template.
+ * @param {object} pConnectMeta Object containing meta information for the particular field authored
+ * @param {Function} getPConnect PConnect function passed along to other components.
+ * @param {string} displayMode displayMode string contains information about the layout of component in review mode.
+ */
+export function prepareComponentInCaseSummary(pConnectMeta: any, getPConnect: Function) {
+  const { config, children } = pConnectMeta;
+
+  const noValueComponent = <div>No Value</div>;
+  const placeholder = '...';
+  const pConnect = getPConnect();
+
+  const caseSummaryComponentObject: any = {};
+
+  let { type } = pConnectMeta;
+  let showAddressLabel = true;
+
+  if (config && config.value === `@P .${Utils.getMappedKey('pyStatusWork')}`) {
+    config.displayAsStatus = true;
+    type = 'TextInput'; // force the type to be TextInput for status field.
+    // As TextInput is loaded forcefully sometimes, TextInput component might not be available in lazy map.
+    // Load TextInput if it is not available.
+    if (!PCore.getComponentsRegistry().getLazyComponent(type)) {
+      PCore.getAssetLoader().getLoader('component-loader')([type]);
+    }
+  }
+
+  caseSummaryComponentObject.name = pConnect.resolveConfigProps({ label: config.label }).label;
+
+  if (config.inheritedProps) {
+    const labelInInheritedProp = config.inheritedProps.find(inheritedProp => inheritedProp.prop === 'label');
+    if (labelInInheritedProp) {
+      labelInInheritedProp.value = pConnect.resolveConfigProps({ label: labelInInheritedProp.value }).label;
+    }
+  }
+
+  switch (type) {
+    case 'CaseOperator': {
+      if (config.label.includes('Create operator')) {
+        caseSummaryComponentObject.name = pConnect.resolveConfigProps({
+          createLabel: config.createLabel
+        }).createLabel;
+      } else if (config.label.includes('Update operator')) {
+        caseSummaryComponentObject.name = pConnect.resolveConfigProps({
+          updateLabel: config.updateLabel
+        }).updateLabel;
+      } else {
+        caseSummaryComponentObject.name = pConnect.resolveConfigProps({
+          resolveLabel: config.resolveLabel
+        }).resolveLabel;
+      }
+
+      break;
+    }
+    case 'Checkbox': {
+      caseSummaryComponentObject.name = pConnect.resolveConfigProps({
+        label: config.caption
+      }).label;
+
+      break;
+    }
+    case 'Pega_UI_PercentageWidget': {
+      const rawValue = pConnect.resolveConfigProps({
+        value: config.value
+      }).value;
+
+      caseSummaryComponentObject.simpleValue = rawValue || rawValue === 0 ? `${rawValue}%` : noValueComponent;
+      break;
+    }
+    case 'Address': {
+      showAddressLabel = false;
+
+      caseSummaryComponentObject.variant = 'stacked';
+      break;
+    }
+    case 'Location':
+    case 'RichText': {
+      const rawValue = pConnect.resolveConfigProps({
+        value: config.value
+      }).value;
+
+      caseSummaryComponentObject.variant = 'stacked';
+      caseSummaryComponentObject.simpleValue = rawValue?.length ? rawValue : noValueComponent;
+      break;
+    }
+    case 'TextArea': {
+      const rawValue = pConnect.resolveConfigProps({
+        value: config.value
+      }).value;
+
+      if (rawValue?.length > 22) {
+        caseSummaryComponentObject.variant = 'stacked';
+      }
+
+      caseSummaryComponentObject.simpleValue = rawValue?.length ? rawValue : noValueComponent;
+      break;
+    }
+    case 'URL': {
+      if (config.displayAs === 'Image') {
+        const rawValue = pConnect.resolveConfigProps({
+          value: config.value
+        }).value;
+
+        caseSummaryComponentObject.variant = 'stacked';
+        caseSummaryComponentObject.simpleValue = rawValue?.length ? <Link href={rawValue}>{rawValue}</Link> : noValueComponent;
+      }
+      break;
+    }
+    case 'reference': {
+      const referencedPConnect = resolveReferencedPConnect(pConnect);
+      const viewType = referencedPConnect?.meta?.config.type;
+      const viewTemplate = referencedPConnect?.meta?.config.template;
+      const isTable = ['multirecordlist'].includes(viewType);
+      const isDataReference = viewTemplate === 'DataReference';
+
+      if (isTable || !isDataReference) {
+        caseSummaryComponentObject.variant = 'stacked';
+        caseSummaryComponentObject.simpleValue = placeholder;
+      }
+      break;
+    }
+    case 'view': {
+      caseSummaryComponentObject.variant = 'stacked';
+      caseSummaryComponentObject.simpleValue = placeholder;
+      break;
+    }
+    default:
+      break;
+  }
+
+  const createdComponent = pConnect.createComponent({
+    type,
+    children: children ? [...children] : [],
+    showAddressLabel,
+    config: {
+      ...config,
+      // Need a unique key for each summary component which helps in creating new component based on visibility
+      // Also a consistent key helps in rerendering summary components instead of remounting
+      key: config
+    }
+  });
+
+  createdComponent.props.getPConnect().setInheritedProp('displayMode', 'DISPLAY_ONLY');
+  createdComponent.props.getPConnect().setInheritedProp('readOnly', true);
+
+  if (type === 'Address') {
+    createdComponent.props.getPConnect().setInheritedProp('showAddressLabel', showAddressLabel);
+  }
+  // Add field label for reference summary item when not Embedded data
+  if (type === 'reference') {
+    const isEmbeddedData = config.context && config.displayAs === 'Form';
+    if (!isEmbeddedData) {
+      caseSummaryComponentObject.name = createdComponent.props.getPConnect().getInheritedProps().label;
+    }
+  }
+
+  caseSummaryComponentObject.value = createdComponent;
+
+  return caseSummaryComponentObject;
+}
+
+export function resolveReferenceFields(
+  item: {
+    [key: string]: unknown;
+  },
+  hideFieldLabels: boolean,
+  recordKey: string,
+  pConnect: typeof PConnect
+) {
+  const presets: {
+    children?: {
+      children?: {
+        config;
+        type;
+      };
+      config?;
+    };
+  } = (pConnect.getRawMetadata()?.config as any).presets ?? [];
+
+  const presetChildren = presets[0]?.children?.[0]?.children ?? [];
+
+  const maxFields = 5;
+  return presetChildren.slice(0, maxFields).map((preset, index) => {
+    const fieldMeta = {
+      meta: {
+        ...preset,
+        config: {
+          ...preset.config,
+          displayMode: 'DISPLAY_ONLY',
+          contextName: pConnect.getContextName()
+        }
+      },
+      useCustomContext: item
+    };
+    const configObj = PCore.createPConnect(fieldMeta);
+    const meta = configObj.getPConnect().getMetadata();
+    const fieldInfo: {
+      name?: string;
+      value?: React.ReactNode;
+    } = meta ? prepareComponentInCaseSummary(meta, configObj.getPConnect) : {};
+    return hideFieldLabels
+      ? { id: `${item[recordKey]} - ${index}`, value: fieldInfo.value }
+      : {
+          id: `${item[recordKey]} - ${index}`,
+          name: fieldInfo.name,
+          value: fieldInfo.value,
+          type: preset.type
+        };
+  });
+}

package/tests/assets/sdk-r/components/create/override-sdk/field/SemanticLink/SemanticLink.tsx

@@ -1,13 +1,11 @@
-import Typography from '@material-ui/core/Typography';
-import Grid from '@material-ui/core/Grid';
-import { makeStyles } from '@material-ui/core/styles';
+import { Link } from '@mui/material';
+import makeStyles from '@mui/styles/makeStyles';
 
-import { getComponentFromMap } from '@pega/react-sdk-components/lib/bridge/helpers/sdk_component_map';
-import { PConnFieldProps } from '@pega/react-sdk-components/lib/types/PConnProps';
+import type { PConnFieldProps } from '@pega/react-sdk-components/lib/types/PConnProps';
 
-/* although this is called the SemanticLink component, we are not yet displaying as a
-SemanticLink in SDK and only showing the value as a read only text field. */
+import semanticUtils from './utils';
 
+// eslint-disable-next-line
 const useStyles = makeStyles(theme => ({
   root: {
     paddingRight: theme.spacing(1),
@@ -41,36 +39,170 @@ const useStyles = makeStyles(theme => ({
 
 interface SemanticLinkProps extends PConnFieldProps {
   // If any, enter additional props that only exist on SemanticLink here
-  // from previous PropTypes
   text: string;
+  resourcePayload: any;
+  resourceParams: any;
+  previewKey: string | null;
+  onClick: (event: any) => void;
+  testId: string;
+  referenceType: string | null;
+  dataRelationshipContext: string | null;
+  contextPage: any;
 }
 
 export default function SemanticLink(props: SemanticLinkProps) {
-  // Get emitted components from map (so we can get any override that may exist)
-  const FieldValueList = getComponentFromMap('FieldValueList');
+  const {
+    text,
+    resourcePayload = {},
+    resourceParams = {},
+    getPConnect,
+    previewKey,
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    onClick,
+    testId = '',
+    referenceType,
+    dataRelationshipContext = null,
+    contextPage,
+    ...restProps
+  } = props;
+  const { ACTION_OPENWORKBYHANDLE, ACTION_SHOWDATA }: any = PCore.getSemanticUrlUtils().getActions();
+  const pConnect = getPConnect();
+  const dataResourcePayLoad = resourcePayload?.resourceType === 'DATA' ? resourcePayload : null;
 
-  const { text, displayMode, label, hideLabel } = props;
-  const classes = useStyles();
+  const {
+    RESOURCE_TYPES: { DATA },
+    WORKCLASS,
+    CASE_INFO: { CASE_INFO_CLASSID }
+  } = PCore.getConstants();
 
-  if (displayMode === 'LABELS_LEFT' || (!displayMode && label !== undefined)) {
-    const value = text || '---';
-    return (
-      <Grid container spacing={1} style={{ padding: '4px 0px' }} id='semantic-link-grid'>
-        <Grid item xs={6}>
-          <Typography variant='body2' component='span' className={`${classes.fieldLabel} ${classes.fieldMargin}`}>
-            {label}
-          </Typography>
-        </Grid>
-        <Grid item xs={6}>
-          <Typography variant='body2' component='span' className={classes.fieldValue}>
-            {value}
-          </Typography>
-        </Grid>
-      </Grid>
+  let linkURL = '';
+  let payload = {};
+  let dataViewName;
+  let linkComponentProps = {
+    href: linkURL
+  };
+  if (text) {
+    (linkComponentProps as any).href = linkURL;
+  }
+  let isData = false;
+  const shouldTreatAsDataReference = !previewKey && resourcePayload.caseClassName;
+  if (contextPage?.classID) {
+    resourcePayload.caseClassName = contextPage.classID;
+  }
+  /* TODO : In case of duplicate search case the classID is Work- need to set it to
+  the current case class ID */
+  if (resourcePayload.caseClassName === WORKCLASS) {
+    resourcePayload.caseClassName = pConnect.getValue(CASE_INFO_CLASSID);
+  }
+
+  function showDataAction() {
+    if (dataResourcePayLoad && dataResourcePayLoad.resourceType === 'DATA') {
+      const { content } = dataResourcePayLoad;
+      const lookUpDataPageInfo = PCore.getDataTypeUtils().getLookUpDataPageInfo(dataResourcePayLoad?.className);
+      const lookUpDataPage = PCore.getDataTypeUtils().getLookUpDataPage(dataResourcePayLoad?.className);
+      if (lookUpDataPageInfo) {
+        const { parameters }: any = lookUpDataPageInfo;
+        payload = Object.keys(parameters).reduce((acc, param) => {
+          const paramValue = parameters[param];
+          return {
+            ...acc,
+            [param]: PCore.getAnnotationUtils().isProperty(paramValue) ? content[PCore.getAnnotationUtils().getPropertyName(paramValue)] : paramValue
+          };
+        }, {});
+      }
+      getPConnect()
+        .getActionsApi()
+        .showData('pyDetails', lookUpDataPage, {
+          ...payload
+        });
+    }
+    if ((referenceType && referenceType.toUpperCase() === DATA) || shouldTreatAsDataReference) {
+      getPConnect()
+        .getActionsApi()
+        .showData('pyDetails', dataViewName, {
+          ...payload
+        });
+    }
+  }
+
+  function openLinkClick(e) {
+    if (!e.metaKey && !e.ctrlKey) {
+      e.preventDefault();
+      if (
+        (dataResourcePayLoad && dataResourcePayLoad.resourceType === 'DATA') ||
+        (referenceType && referenceType.toUpperCase() === DATA) ||
+        shouldTreatAsDataReference
+      ) {
+        showDataAction();
+      } else if (previewKey) {
+        getPConnect().getActionsApi().openWorkByHandle(previewKey, resourcePayload.caseClassName);
+      }
+    }
+  }
+
+  if ((referenceType && referenceType.toUpperCase() === DATA) || shouldTreatAsDataReference) {
+    try {
+      isData = true;
+      // @ts-expect-error
+      const dataRefContext = semanticUtils.getDataReferenceInfo(pConnect, dataRelationshipContext, contextPage);
+      dataViewName = dataRefContext.dataContext;
+      payload = dataRefContext.dataContextParameters as any;
+    } catch (error) {
+      console.log('Error in getting the data reference info', error);
+    }
+  } else if (resourcePayload && resourcePayload.resourceType === 'DATA') {
+    isData = true;
+    dataViewName = PCore.getDataTypeUtils().getLookUpDataPage(resourcePayload.className);
+    const lookUpDataPageInfo = PCore.getDataTypeUtils().getLookUpDataPageInfo(resourcePayload.className);
+    const { content } = resourcePayload;
+    if (lookUpDataPageInfo) {
+      const { parameters }: any = lookUpDataPageInfo;
+      payload = Object.keys(parameters).reduce((acc, param) => {
+        const paramValue = parameters[param];
+        return {
+          ...acc,
+          [param]: PCore.getAnnotationUtils().isProperty(paramValue) ? content[PCore.getAnnotationUtils().getPropertyName(paramValue)] : paramValue
+        };
+      }, {});
+    } else {
+      const keysInfo = PCore.getDataTypeUtils().getDataPageKeys(dataViewName) ?? [];
+      payload = keysInfo.reduce((acc, curr) => {
+        return {
+          ...acc,
+          [curr.keyName]: content[curr.isAlternateKeyStorage ? curr.linkedField : curr.keyName]
+        };
+      }, {});
+    }
+  }
+
+  if (isData && dataViewName && payload) {
+    linkURL = PCore.getSemanticUrlUtils().getResolvedSemanticURL(
+      ACTION_SHOWDATA,
+      { pageName: 'pyDetails', dataViewName },
+      {
+        ...payload
+      }
     );
+  } else {
+    // BUG-678282 fix to handle scenario when workID was not populated.
+    // Check renderParentLink in Caseview / CasePreview
+    resourceParams.objectID = resourceParams.workID === '' && typeof previewKey === 'string' ? previewKey.split(' ')[1] : resourceParams.workID;
+    if (previewKey) {
+      resourceParams.id = previewKey;
+    }
+    linkURL = PCore.getSemanticUrlUtils().getResolvedSemanticURL(ACTION_OPENWORKBYHANDLE, resourcePayload, resourceParams);
   }
 
-  if (displayMode === 'STACKED_LARGE_VAL') {
-    return <FieldValueList name={hideLabel ? '' : label} value={text} variant='stacked' />;
+  if (text) {
+    linkComponentProps = {
+      ...linkComponentProps,
+      href: linkURL
+    };
   }
+
+  return (
+    <Link component='button' {...linkComponentProps} {...restProps} onClick={openLinkClick} data-testid={testId}>
+      {text || '--'}
+    </Link>
+  );
 }

package/tests/assets/sdk-r/components/create/override-sdk/field/SemanticLink/utils.ts

@@ -32,7 +32,7 @@ function getDataReferenceInfo(pConnect, dataRelationshipContext) {
     dataContext = name;
     for (const [key, value] of Object.entries(parameters)) {
       const property =
-        // @ts-ignore - Property 'getLeafPropertyName' is private and only accessible within class 'AnnotationUtils'
+        // @ts-expect-error - Property 'getLeafPropertyName' is private and only accessible within class 'AnnotationUtils'
         dataRelationshipContext !== null ? annotationUtils.getPropertyName(value as string) : annotationUtils.getLeafPropertyName(value);
       payload[key] = pConnect.getValue(`.${property}`);
     }

package/tests/assets/sdk-r/components/create/override-sdk/field/TextArea/TextArea.tsx

@@ -1,7 +1,9 @@
-import { TextField } from '@material-ui/core';
+import { useEffect, useState } from 'react';
+import { TextField } from '@mui/material';
 
+import handleEvent from '@pega/react-sdk-components/lib/components/helpers/event-utils';
 import { getComponentFromMap } from '@pega/react-sdk-components/lib/bridge/helpers/sdk_component_map';
-import { PConnFieldProps } from '@pega/react-sdk-components/lib/types/PConnProps';
+import type { PConnFieldProps } from '@pega/react-sdk-components/lib/types/PConnProps';
 
 interface TextAreaProps extends PConnFieldProps {
   // If any, enter additional props that only exist on TextArea here
@@ -13,14 +15,13 @@ export default function TextArea(props: TextAreaProps) {
   const FieldValueList = getComponentFromMap('FieldValueList');
 
   const {
+    getPConnect,
     label,
     required,
     disabled,
     value = '',
     validatemessage,
     status,
-    onChange,
-    onBlur,
     readOnly,
     testId,
     fieldMetadata,
@@ -30,12 +31,20 @@ export default function TextArea(props: TextAreaProps) {
     placeholder
   } = props;
   const helperTextToDisplay = validatemessage || helperText;
-
+  const pConn = getPConnect();
+  const actions = pConn.getActionsApi();
+  const propName = (pConn.getStateProps() as any).value;
   const maxLength = fieldMetadata?.maxLength;
 
+  const [inputValue, setInputValue] = useState('');
+
   let readOnlyProp = {};
 
-  if (displayMode === 'LABELS_LEFT') {
+  useEffect(() => {
+    setInputValue(value);
+  }, [value]);
+
+  if (displayMode === 'DISPLAY_ONLY') {
     return <FieldValueList name={hideLabel ? '' : label} value={value} />;
   }
 
@@ -49,11 +58,16 @@ export default function TextArea(props: TextAreaProps) {
     readOnlyProp = { readOnly: true };
   }
 
-  let testProp = {};
+  const testProps: any = { 'data-test-id': testId };
 
-  testProp = {
-    'data-test-id': testId
-  };
+  function handleChange(event) {
+    // update internal value
+    setInputValue(event?.target?.value);
+  }
+
+  function handleBlur() {
+    handleEvent(actions, 'changeNblur', propName, inputValue);
+  }
 
   return (
     <TextField
@@ -67,12 +81,14 @@ export default function TextArea(props: TextAreaProps) {
       size='small'
       required={required}
       disabled={disabled}
-      onChange={onChange}
-      onBlur={!readOnly ? onBlur : undefined}
+      onChange={handleChange}
+      onBlur={!readOnly ? handleBlur : undefined}
       error={status === 'error'}
       label={label}
-      value={value}
-      InputProps={{ ...readOnlyProp, inputProps: { maxLength, ...testProp } }}
+      value={inputValue}
+      slotProps={{
+        input: { ...readOnlyProp, inputProps: { maxLength, ...testProps } }
+      }}
     />
   );
 }

package/tests/assets/sdk-r/components/create/override-sdk/field/TextContent/TextContent.tsx

@@ -1,6 +1,6 @@
-import { Typography } from '@material-ui/core';
+import { Typography } from '@mui/material';
 
-import { PConnProps } from '@pega/react-sdk-components/lib/types/PConnProps';
+import type { PConnProps } from '@pega/react-sdk-components/lib/types/PConnProps';
 
 interface TextContentProps extends PConnProps {
   // If any, enter additional props that only exist on TextContent here
@@ -38,7 +38,6 @@ export default function TextContent(props: TextContentProps) {
       break;
 
     default:
-      // eslint-disable-next-line no-console
       console.error(`TextContent got an expected displayAs prop: ${displayAs}`);
       break;
   }

package/tests/assets/sdk-r/components/create/override-sdk/field/TextInput/TextInput.tsx

@@ -1,9 +1,9 @@
 import { useState, useEffect } from 'react';
-import { TextField } from '@material-ui/core';
+import { TextField } from '@mui/material';
 
 import handleEvent from '@pega/react-sdk-components/lib/components/helpers/event-utils';
 import { getComponentFromMap } from '@pega/react-sdk-components/lib/bridge/helpers/sdk_component_map';
-import { PConnFieldProps } from '@pega/react-sdk-components/lib/types/PConnProps';
+import type { PConnFieldProps } from '@pega/react-sdk-components/lib/types/PConnProps';
 
 interface TextInputProps extends PConnFieldProps {
   // If any, enter additional props that only exist on TextInput here
@@ -47,7 +47,7 @@ export default function TextInput(props: TextInputProps) {
     setInputValue(value);
   }, [value]);
 
-  if (displayMode === 'LABELS_LEFT') {
+  if (displayMode === 'DISPLAY_ONLY') {
     return <FieldValueList name={hideLabel ? '' : label} value={value} />;
   }
 
@@ -59,11 +59,7 @@ export default function TextInput(props: TextInputProps) {
     readOnlyProp = { readOnly: true };
   }
 
-  let testProp = {};
-
-  testProp = {
-    'data-test-id': testId
-  };
+  const testProps: any = { 'data-test-id': testId };
 
   function handleChange(event) {
     // update internal value
@@ -88,7 +84,9 @@ export default function TextInput(props: TextInputProps) {
       error={status === 'error'}
       label={label}
       value={inputValue}
-      InputProps={{ ...readOnlyProp, inputProps: { maxLength, ...testProp } }}
+      slotProps={{
+        input: { ...readOnlyProp, inputProps: { maxLength, ...testProps } }
+      }}
     />
   );
 }