@pega/react-sdk-overrides 0.23.6

package/lib/forms/Phone/Phone.tsx

@@ -0,0 +1,90 @@
+import React from 'react';
+import MuiPhoneNumber from 'material-ui-phone-number';
+import FieldValueList from '@pega/react-sdk-components/lib/components/designSystemExtensions/FieldValueList';
+
+export default function Phone(props) {
+  const {
+    label,
+    required,
+    disabled,
+    value = '',
+    validatemessage,
+    status,
+    onChange,
+    onBlur,
+    readOnly,
+    testId,
+    helperText,
+    displayMode
+  } = props;
+  const helperTextToDisplay = validatemessage || helperText;
+
+  let testProp = {};
+
+  testProp = {
+    'data-test-id': testId
+  };
+
+  if(displayMode === 'LABELS_LEFT') {
+    const field = {
+      [label]: value
+    };
+    return <FieldValueList item={field} />
+  }
+
+  if (readOnly) {
+    const disableDropdown = true;
+    return (
+      <div>
+        <MuiPhoneNumber
+          fullWidth
+          helperText={helperTextToDisplay}
+          placeholder=''
+          size='small'
+          required={required}
+          disabled={disabled}
+          onChange={onChange}
+          error={status === 'error'}
+          label={label}
+          value={value}
+          InputProps={{
+            readOnly: true
+          }}
+          disableDropdown={disableDropdown}
+        />
+      </div>
+    );
+  }
+
+
+  const handleChange = inputVal => {
+    let phoneValue = inputVal && inputVal.replace(/\D+/g, '');
+    phoneValue = `+${phoneValue}`;
+    onChange({ value: phoneValue });
+  };
+
+  const handleBlur = event => {
+    const phoneValue = event?.target?.value;
+    event.target.value = `+${phoneValue && phoneValue.replace(/\D+/g, '')}`;
+    onBlur(event);
+  };
+
+  return (
+    <MuiPhoneNumber
+      fullWidth
+      variant='outlined'
+      helperText={helperTextToDisplay}
+      placeholder=''
+      size='small'
+      defaultCountry='us'
+      required={required}
+      disabled={disabled}
+      onChange={handleChange}
+      onBlur={!readOnly ? handleBlur : undefined}
+      error={status === 'error'}
+      label={label}
+      value={value}
+      InputProps={{ ...testProp }}
+    />
+  );
+}

package/lib/forms/Phone/index.tsx

@@ -0,0 +1 @@
+export { default } from './Phone';

package/lib/forms/RadioButtons/RadioButtons.tsx

@@ -0,0 +1,73 @@
+import React, { useState, useEffect } from 'react';
+import {
+  Radio,
+  RadioGroup,
+  FormControl,
+  FormControlLabel,
+  FormLabel,
+  FormHelperText
+} from '@material-ui/core';
+
+import Utils from '@pega/react-sdk-components/lib/components/helpers/utils';
+import handleEvent from '@pega/react-sdk-components/lib/components/helpers/event-utils';
+
+export default function RadioButtons(props) {
+  const {
+    getPConnect,
+    label,
+    value = '',
+    readOnly,
+    validatemessage,
+    helperText,
+    status,
+    required,
+    inline
+  } = props;
+  const [theSelectedButton, setSelectedButton] = useState(value);
+
+  const thePConn = getPConnect();
+  const theConfigProps = thePConn.getConfigProps();
+  const actionsApi = thePConn.getActionsApi();
+  const propName = thePConn.getStateProps().value;
+  const helperTextToDisplay = validatemessage || helperText;
+
+  // theOptions will be an array of JSON objects that are literally key/value pairs.
+  //  Ex: [ {key: "Basic", value: "Basic"} ]
+  const theOptions = Utils.getOptionList(theConfigProps, thePConn.getDataObject());
+
+  useEffect(() => {
+    // This update theSelectedButton which will update the UI to show the selected button correctly
+    setSelectedButton(value);
+  }, [value]);
+
+  const handleChange = event => {
+    handleEvent(actionsApi, 'changeNblur', propName, event.target.value);
+  };
+
+  const handleBlur = event => {
+    thePConn.getValidationApi().validate(event.target.value);
+  };
+
+  return (
+    <FormControl error={status === 'error'} required={required}>
+      <FormLabel component='legend'>{label}</FormLabel>
+      <RadioGroup 
+        value={theSelectedButton} 
+        onChange={handleChange} 
+        onBlur={!readOnly ? handleBlur : undefined} 
+        row={inline}>
+        {theOptions.map(theOption => {
+          return (
+            <FormControlLabel
+              value={theOption.key}
+              key={theOption.key}
+              label={theOption.value}
+              control={<Radio key={theOption.key} color='primary' disabled={readOnly} />}
+            />
+          );
+        })}
+      </RadioGroup>
+      <FormHelperText>{helperTextToDisplay}</FormHelperText>
+    </FormControl>
+  );
+}

package/lib/forms/RadioButtons/index.tsx

@@ -0,0 +1 @@
+export { default } from './RadioButtons';

package/lib/forms/SemanticLink/SemanticLink.tsx

@@ -0,0 +1,69 @@
+import React from "react";
+import PropTypes from "prop-types";
+import Typography from '@material-ui/core/Typography';
+import Grid from '@material-ui/core/Grid';
+import { makeStyles } from '@material-ui/core/styles';
+
+/* 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. */
+
+const useStyles = makeStyles((theme) => ({
+  root: {
+    paddingRight: theme.spacing(1),
+    paddingLeft: theme.spacing(1),
+    paddingTop: theme.spacing(1),
+    paddingBottom: theme.spacing(1),
+    marginRight: theme.spacing(1),
+    marginLeft: theme.spacing(1),
+    marginTop: theme.spacing(1),
+    marginBottom: theme.spacing(1),
+  },
+  fieldMargin: {
+    paddingRight: theme.spacing(1),
+    paddingLeft: theme.spacing(1),
+    paddingTop: theme.spacing(1),
+    paddingBottom: theme.spacing(1),
+    marginRight: theme.spacing(1),
+    marginLeft: theme.spacing(1),
+    marginTop: theme.spacing(1),
+    marginBottom: theme.spacing(1),
+  },
+  fieldLabel: {
+    fontWeight: 400,
+    color: theme.palette.text.secondary
+  },
+  fieldValue: {
+    fontWeight: 400,
+    color: theme.palette.text.primary
+  }
+}));
+
+export default function SemanticLink(props) {
+  const {
+    text,
+    displayMode,
+    label,
+  } = props;
+  const classes = useStyles();
+
+
+  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>
+    );
+  }
+}
+
+SemanticLink.propTypes = {
+  text: PropTypes.string.isRequired,
+  displayMode: PropTypes.string,
+  label: PropTypes.string,
+};

package/lib/forms/SemanticLink/index.tsx

@@ -0,0 +1 @@
+export { default } from './SemanticLink';

package/lib/forms/SemanticLink/utils.ts

@@ -0,0 +1,51 @@
+declare const PCore;
+
+function getDataReferenceInfo(pConnect, dataRelationshipContext) {
+  if (!pConnect) {
+    throw Error("PConnect parameter is required");
+  }
+
+  let dataContext = "";
+  const payload = {};
+  const pageReference = pConnect.getPageReference();
+  const annotationUtils = PCore.getAnnotationUtils();
+  let fieldMetadata;
+
+  if (pageReference) {
+    /*
+    For page list the page refernce will be something like caseInfo.content.EmployeeRef[1].
+    Need to extract EmployeeRef from caseInfo.content.EmployeeRef[1]
+    */
+    const propertySplit = pageReference.split(".");
+
+    // Regex to match if the property is list type. Eg: EmployeeRef[1]
+    const listPropertyRegex = /([a-z|A-Z]*[[][\d]*)[\]]$/gm;
+    // Regex to match [1] part of the property EmployeeRef[1]
+    const indexRegex = /([[][\d]*[\]])+/gm;
+
+    let contextProperty = dataRelationshipContext !== null ? dataRelationshipContext : propertySplit.pop();
+    const isListProperty = listPropertyRegex.test(contextProperty);
+    contextProperty = isListProperty
+      ? contextProperty.replace(indexRegex, "")
+      : contextProperty;
+    fieldMetadata = pConnect.getFieldMetadata(contextProperty);
+  }
+
+  if (!!fieldMetadata && fieldMetadata.datasource) {
+    const { name, parameters } = fieldMetadata.datasource;
+    dataContext = name;
+    for (const [key, value] of Object.entries(parameters)) {
+      const property = dataRelationshipContext !== null ? annotationUtils.getPropertyName(value) : annotationUtils.getLeafPropertyName(value)
+      payload[key] = pConnect.getValue(`.${property}`);
+    }
+    return { dataContext, dataContextParameters: payload };
+  }
+
+  return {};
+}
+
+function isLinkTextEmpty(text) {
+  return text === "" || text === undefined || text === null;
+}
+
+export default { getDataReferenceInfo, isLinkTextEmpty };

package/lib/forms/TextArea/TextArea.tsx

@@ -0,0 +1,66 @@
+import React from 'react';
+import { TextField } from '@material-ui/core';
+import FieldValueList from '@pega/react-sdk-components/lib/components/designSystemExtensions/FieldValueList';
+
+export default function TextArea(props) {
+  const {
+    label,
+    required,
+    disabled,
+    value = '',
+    validatemessage,
+    status,
+    onChange,
+    onBlur,
+    readOnly,
+    testId,
+    fieldMetadata,
+    helperText,
+    displayMode
+  } = props;
+  const helperTextToDisplay = validatemessage || helperText;
+
+  const maxLength = fieldMetadata?.maxLength;
+
+  let readOnlyProp = {};
+
+  if(displayMode === 'LABELS_LEFT') {
+    const field = {
+      [label]: value
+    };
+    return <FieldValueList item={field} />
+  }
+
+  if (readOnly) {
+    // Not just emitting a read only Textfield like some other components do
+    //  since we want to preserve the minRows, maxRows info.
+    readOnlyProp = { readOnly: true };
+  }
+
+  let testProp = {};
+
+  testProp = {
+    'data-test-id': testId
+  };
+
+  return (
+    <TextField
+      multiline
+      minRows={5}
+      maxRows={5}
+      fullWidth
+      variant={readOnly ? 'standard' : 'outlined'}
+      helperText={helperTextToDisplay}
+      placeholder=''
+      size='small'
+      required={required}
+      disabled={disabled}
+      onChange={onChange}
+      onBlur={!readOnly ? onBlur : undefined}
+      error={status === 'error'}
+      label={label}
+      value={value}
+      InputProps={{ ...readOnlyProp, inputProps: { maxLength, ...testProp } }}
+    />
+  );
+}

package/lib/forms/TextArea/index.tsx

@@ -0,0 +1 @@
+export { default } from './TextArea';

package/lib/forms/TextContent/TextContent.tsx

@@ -0,0 +1,40 @@
+import React from 'react';
+import { Typography } from '@material-ui/core';
+
+export default function TextContent(props) {
+  type ExpectedDisplayAs = 'Paragraph' | 'Heading 1' | 'Heading 2' | 'Heading 3' | 'Heading 4';
+  type ExpectedVariants = 'body1' | 'h1' | 'h2' | 'h3' | 'h4';
+
+  const { content, displayAs }: { content: string; displayAs: ExpectedDisplayAs } = props;
+
+  let theVariant: ExpectedVariants = 'body1';
+
+  switch (displayAs) {
+    case 'Paragraph':
+      theVariant = 'body1';
+      break;
+
+    case 'Heading 1':
+      theVariant = 'h1';
+      break;
+
+    case 'Heading 2':
+      theVariant = 'h2';
+      break;
+
+    case 'Heading 3':
+      theVariant = 'h3';
+      break;
+
+    case 'Heading 4':
+      theVariant = 'h4';
+      break;
+
+    default:
+      // eslint-disable-next-line no-console
+      console.error(`TextContent got an expected displayAs prop: ${displayAs}`);
+      break;
+  }
+
+  return <Typography variant={theVariant}>{content}</Typography>;
+}

package/lib/forms/TextContent/index.tsx

@@ -0,0 +1 @@
+export { default } from './TextContent';

package/lib/forms/TextInput/TextInput.tsx

@@ -0,0 +1,61 @@
+import React from 'react';
+import { TextField } from '@material-ui/core';
+import FieldValueList from '@pega/react-sdk-components/lib/components/designSystemExtensions/FieldValueList';
+
+export default function TextInput(props) {
+  const {
+    label,
+    required,
+    disabled,
+    value = '',
+    validatemessage,
+    status,
+    onChange,
+    onBlur,
+    readOnly,
+    testId,
+    fieldMetadata,
+    helperText,
+    displayMode
+  } = props;
+  const helperTextToDisplay = validatemessage || helperText;
+
+  const maxLength = fieldMetadata?.maxLength;
+
+  let readOnlyProp = {}; // Note: empty if NOT ReadOnly
+
+  if(displayMode === 'LABELS_LEFT') {
+    const field = {
+      [label]: value
+    };
+    return <FieldValueList item={field} />
+  }
+
+  if (readOnly) {
+    readOnlyProp = { readOnly: true };
+  }
+
+  let testProp = {};
+
+  testProp = {
+    'data-test-id': testId
+  };
+
+  return (
+    <TextField
+      fullWidth
+      variant={readOnly ? 'standard' : 'outlined'}
+      helperText={helperTextToDisplay}
+      placeholder=''
+      size='small'
+      required={required}
+      disabled={disabled}
+      onChange={onChange}
+      onBlur={!readOnly ? onBlur : undefined}
+      error={status === 'error'}
+      label={label}
+      value={value}
+      InputProps={{ ...readOnlyProp, inputProps: { maxLength, ...testProp } }}
+    />
+  );
+}

package/lib/forms/TextInput/index.tsx

@@ -0,0 +1 @@
+export { default } from './TextInput';

package/lib/forms/Time/Time.tsx

@@ -0,0 +1,71 @@
+import React from 'react';
+import { KeyboardTimePicker } from '@material-ui/pickers';
+import TextInput from '@pega/react-sdk-components/lib/components/forms/TextInput';
+import dayjs from 'dayjs';
+import AccessTimeIcon from '@material-ui/icons/AccessTime';
+import FieldValueList from '@pega/react-sdk-components/lib/components/designSystemExtensions/FieldValueList';
+
+export default function Time(props) {
+  const {
+    label,
+    required,
+    disabled,
+    value,
+    validatemessage,
+    status,
+    onChange,
+    readOnly,
+    helperText,
+    displayMode
+  } = props;
+  const helperTextToDisplay = validatemessage || helperText;
+
+  if (displayMode === 'LABELS_LEFT') {
+    const field = {
+      [label]: value
+    };
+    return <FieldValueList item={field} />;
+  }
+
+  if (readOnly) {
+    return <TextInput {...props} />;
+  }
+
+  const handleChange = date => {
+    const theValue = date && date.isValid() ? date.format('HH:mm') : null;
+    onChange({ value: theValue });
+  };
+
+  let timeValue: any = null;
+  if (value) {
+    const timeArray = value.split(':').map(itm => Number(itm));
+    timeValue = dayjs().hour(timeArray[0]).minute(timeArray[1]);
+  }
+
+  //
+  // TODO: Keyboard doesn't work in the minute field, it updates one digit then jump to am/pm field
+  //       try an older version of the lib or use DateTimePicker
+  //
+
+  return (
+    <KeyboardTimePicker
+      variant='inline'
+      inputVariant='outlined'
+      placeholder='hh:mm am'
+      keyboardIcon={<AccessTimeIcon />}
+      fullWidth
+      required={required}
+      disabled={disabled}
+      error={status === 'error'}
+      helperText={helperTextToDisplay}
+      minutesStep={5}
+      size='small'
+      label={label}
+      autoOk
+      mask='__:__ _m'
+      format='hh:mm a'
+      value={timeValue}
+      onChange={handleChange}
+    />
+  );
+}

package/lib/forms/Time/index.tsx

@@ -0,0 +1 @@
+export { default } from './Time';

package/lib/forms/URL/URL.tsx

@@ -0,0 +1,53 @@
+import React from 'react';
+import { TextField } from '@material-ui/core';
+import TextInput from '@pega/react-sdk-components/lib/components/forms/TextInput';
+import FieldValueList from '@pega/react-sdk-components/lib/components/designSystemExtensions/FieldValueList';
+
+// NOTE: that we had to change the name from URL to URLComponent
+//  Otherwise, we were getting all kinds of weird errors when we
+//  referred to URL as a component.
+export default function URLComponent(props) {
+  const {
+    label,
+    required,
+    disabled,
+    value = '',
+    validatemessage,
+    status,
+    onChange,
+    onBlur,
+    readOnly,
+    helperText,
+    displayMode
+  } = props;
+  const helperTextToDisplay = validatemessage || helperText;
+
+  if(displayMode === 'LABELS_LEFT') {
+    const field = {
+      [label]: value
+    };
+    return <FieldValueList item={field} />
+  }
+
+  if (readOnly) {
+    return <TextInput {...props} />;
+  }
+
+  return (
+    <TextField
+      type='url'
+      fullWidth
+      variant='outlined'
+      helperText={helperTextToDisplay}
+      placeholder=''
+      size='small'
+      required={required}
+      disabled={disabled}
+      onChange={onChange}
+      onBlur={!readOnly ? onBlur : undefined}
+      error={status === 'error'}
+      label={label}
+      value={value}
+    />
+  );
+}

package/lib/forms/URL/index.tsx

@@ -0,0 +1 @@
+export { default } from './URL';