@pega/dx-component-builder-sdk 25.1.16 → 26.1.11

package/package.json

@@ -1,8 +1,16 @@
 {
   "name": "@pega/dx-component-builder-sdk",
-  "version": "25.1.16",
+  "version": "26.1.11",
   "description": "Utility for building custom UI components",
   "bin": "./bin/index.js",
+  "files": [
+    "bin",
+    "src",
+    "tests",
+    "README.md",
+    "LICENSE",
+    "SECURITY.md"
+  ],
   "scripts": {
     "lint:es": "eslint .",
     "lint:format": "prettier -c .",
@@ -19,7 +27,7 @@
     "@babel/plugin-transform-class-properties": "^7.23.3",
     "@babel/preset-env": "^7.23.3",
     "@babel/preset-react": "^7.23.3",
-    "adm-zip": "^0.5.10",
+    "adm-zip": "^0.6.1",
     "ajv": "^8.12.0",
     "arg": "^5.0.2",
     "babel-loader": "^9.1.3",

package/src/constants.js

@@ -315,6 +315,10 @@ export const COMPONENT_SCHEMA = {
         name: 'Email',
         value: 'Email'
       },
+      {
+        name: 'EmbeddedData Multi',
+        value: 'EmbeddedDataMulti'
+      },
       {
         name: 'Field Group',
         value: 'Group'
@@ -866,14 +870,6 @@ export const COMPONENT_SCHEMA = {
         name: 'Material Case Summary',
         value: 'MaterialCaseSummary'
       },
-      {
-        name: 'Material Details',
-        value: 'MaterialDetails'
-      },
-      {
-        name: 'Material Details Fields',
-        value: 'MaterialDetailsFields'
-      },
       {
         name: 'Material Summary Item',
         value: 'MaterialSummaryItem'

package/src/tasks/create/index.js

@@ -40,6 +40,7 @@ import {
   validateSemver
 } from '../../util.js';
 import { COMPONENT_SCHEMA } from '../../constants.js';
+import { getPrettierFormattedString } from '../map/map.js';
 
 const copy = promisify(ncp);
 
@@ -130,7 +131,7 @@ export const compileMustacheTemplates = async (
   const framework = await getFramework();
 
   // allowedApplications = allowedApplications.filter(el => !!el.trim()).map(el => el.trim());
-  files.forEach(file => {
+  for (const file of files) {
 
     const filePath = path.join(componentDirectory, file);
 
@@ -151,7 +152,10 @@ export const compileMustacheTemplates = async (
       IS_BOOLEAN: isBool,
       IS_PHONE: isPhone
     });
-    fs.writeFileSync(filePath, output);
+
+    const formattedOutput = await getPrettierFormattedString(output, filePath.replace(/\.mustache$/, ''));
+
+    fs.writeFileSync(filePath, formattedOutput);
 
     switch (framework) {
       case "SDK-React":
@@ -171,8 +175,7 @@ export const compileMustacheTemplates = async (
         break;
     }
 
-
-  });
+  }
 };
 
 
@@ -324,15 +327,17 @@ export const validateCompile = async (
 export default async options => {
   showVersion();
 
-  console.log(
-    chalk.red(
-      'Custom-constellation are aligned with Pega constellation which is still on react 18.\n' +
-      'Please make sure any changes to custom-constellation should be aligned with React 18 development.'
-    )
-  );
-  
   const framework = await getFramework();
 
+  if (framework === 'SDK-React') {
+    console.log(
+      chalk.red(
+        'Custom-constellation are aligned with Pega constellation which is still on react 18.\n' +
+        'Please make sure any changes to custom-constellation should be aligned with React 18 development.'
+      )
+    );
+  }
+
   if (options.params.length >= 12) {
     const type = options.params[3];
     const subtype = options.params[4];

package/src/tasks/create/templates/Constellation/field/Boolean/Boolean.ts.mustache

@@ -1,25 +1,11 @@
 function Boolean(value: any, { allowEmpty = true, tick = '', cross = '' } = {}) {
-  if (
-    (!allowEmpty && !value) ||
-    value === false ||
-    value?.toString()?.toLowerCase() === 'false' ||
-    value === 0 ||
-    value === '0'
-  ) {
+  if ((!allowEmpty && !value) || value === false || value?.toString()?.toLowerCase() === 'false' || value === 0 || value === '0') {
     return cross || '';
   }
-  if (
-    value === true ||
-    value?.toString()?.toLowerCase() === 'true' ||
-    value === 1 ||
-    value === '1'
-  ) {
+  if (value === true || value?.toString()?.toLowerCase() === 'true' || value === 1 || value === '1') {
     return tick || '';
   }
-  if (
-    allowEmpty &&
-    (value === 'null' || value === '' || value === null || typeof value === 'undefined')
-  ) {
+  if (allowEmpty && (value === 'null' || value === '' || value === null || typeof value === 'undefined')) {
     return '––';
   }
   return value;

package/src/tasks/create/templates/Constellation/field/Boolean/PConnProps.d.ts.mustache

@@ -1,4 +1,4 @@
-import  {PConnect } from '@pega/pcore-pconnect-typedefs';
+import { PConnect } from '@pega/pcore-pconnect-typedefs';
 
 // PConnProps.d.ts
 // This gives us a place to have each component (which is most DX Components) that is
@@ -22,25 +22,24 @@ export interface PConnProps {
   // [key: string]: any;
 }
 
-
 // PConnFieldProps extends PConnProps to bring in the common properties that are
 // associated with most field components (ex: Dropdown, TextInput, etc.) in the
 //  components/field directory
 export interface PConnFieldProps extends PConnProps {
-  label: string,
-  required: boolean,
-  disabled: boolean,
-  value: any,
-  validatemessage: string,
-  status?: string,
-  onChange?: any,
-  onBlur?: any,
-  readOnly: boolean,
-  testId: string,
-  helperText: string,
-  displayMode?: string,
-  hideLabel: boolean,
-  placeholder?: string,
-  fieldMetadata?: any,
-  additionalProps?: any
+  label: string;
+  required: boolean;
+  disabled: boolean;
+  value: any;
+  validatemessage: string;
+  status?: string;
+  onChange?: any;
+  onBlur?: any;
+  readOnly: boolean;
+  testId: string;
+  helperText: string;
+  displayMode?: string;
+  hideLabel: boolean;
+  placeholder?: string;
+  fieldMetadata?: any;
+  additionalProps?: any;
 }

package/src/tasks/create/templates/Constellation/field/Boolean/boolean-format.ts.mustache

@@ -1,19 +1,15 @@
-import Boolean from "./Boolean";
+import Boolean from './Boolean';
 
 export default {
   ...Boolean
 };
 
-
-
 export function format(value: any, type: string) {
   let formattedValue;
 
   switch (type?.toLowerCase()) {
-
-
-    case "boolean":
-    case "checkbox": {
+    case 'boolean':
+    case 'checkbox': {
       formattedValue = Boolean.TrueFalse(value, { allowEmpty: false });
       break;
     }

package/src/tasks/create/templates/Constellation/field/Boolean/demo.stories.tsx.mustache

@@ -1,5 +1,3 @@
-
-/* eslint-disable react/jsx-no-useless-fragment */
 import { useState } from 'react';
 import type { Meta, StoryObj } from '@storybook/react';
 
@@ -17,7 +15,6 @@ export default meta;
 type Story = StoryObj<typeof {{COMPONENT_CLASS_NAME}}>;
 
 export const Base{{COMPONENT_CLASS_NAME}}: Story = (args: any) => {
-
   const [value, setValue] = useState(configProps.value);
 
   const props = {
@@ -33,12 +30,16 @@ export const Base{{COMPONENT_CLASS_NAME}}: Story = (args: any) => {
             updateFieldValue: (propName: string, theValue: any) => {
               setValue(theValue);
             },
-            triggerFieldChange: () => { /* nothing */}
+            triggerFieldChange: () => {
+              /* nothing */
+            }
           };
         },
         getValidationApi: () => {
           return {
-            validate: () => { /* nothing */}
+            validate: () => {
+              /* nothing */
+            }
           };
         }
       };

package/src/tasks/create/templates/Constellation/field/Boolean/index.tsx.mustache

@@ -1,17 +1,10 @@
-import {
-  Checkbox as CosmosCheckbox,
-  CheckboxGroup,
-  FieldValueList,
-  Text,
-  withConfiguration,
-  BooleanDisplay
-} from "@pega/cosmos-react-core";
+import { Checkbox as CosmosCheckbox, CheckboxGroup, FieldValueList, Text, withConfiguration, BooleanDisplay } from '@pega/cosmos-react-core';
 
 import type { PConnFieldProps } from './PConnProps';
 import './create-nonce';
 
 // includes in bundle
-import handleEvent from "./event-utils";
+import handleEvent from './event-utils';
 import Styled{{COMPONENT_CLASS_NAME}}Wrapper from './styles';
 
 // interface for props
@@ -64,29 +57,27 @@ function {{COMPONENT_CLASS_NAME}}(props: {{COMPONENT_CLASS_NAME}}Props) {
   const propName: string = stateProps.value;
 
   let { readOnly = false, required = false, disabled = false } = props;
-  [readOnly, required, disabled] = [readOnly, required, disabled].map(
-    (prop) => prop === true || (typeof prop === 'string' && prop === 'true')
-  );
+  [readOnly, required, disabled] = [readOnly, required, disabled].map(prop => prop === true || (typeof prop === 'string' && prop === 'true'));
 
-  let status: "error" | "success" | "warning" | "pending" | undefined;
-  if (validatemessage !== "") {
-    status = "error";
+  let status: 'error' | 'success' | 'warning' | 'pending' | undefined;
+  if (validatemessage !== '') {
+    status = 'error';
   }
 
   const aCosmosCheckbox = (
     <CosmosCheckbox
       {...additionalProps}
-      className="standard"
+      className='standard'
       checked={value}
       label={caption}
       disabled={disabled}
       readOnly={readOnly}
       required={required}
       onClick={actionsProps.onClick}
-      onChange={(event) => {
-        handleEvent(actions, "changeNblur", propName, event.target.checked);
+      onChange={event => {
+        handleEvent(actions, 'changeNblur', propName, event.target.checked);
       }}
-      onBlur={(event: { target: { checked: any; }; }) => {
+      onBlur={(event: { target: { checked: any } }) => {
         pConn.getValidationApi().validate(event.target.checked);
       }}
       data-testid={testId}
@@ -97,70 +88,54 @@ function {{COMPONENT_CLASS_NAME}}(props: {{COMPONENT_CLASS_NAME}}Props) {
 
   let displayComponent;
   if (displayMode) {
-    displayComponent = (
-      <BooleanDisplay value={value} trueLabel={trueLabel} falseLabel={falseLabel} />
-    );
+    displayComponent = <BooleanDisplay value={value} trueLabel={trueLabel} falseLabel={falseLabel} />;
   }
 
   if (displayMode === 'DISPLAY_ONLY') {
-    return (
-      <Styled{{COMPONENT_CLASS_NAME}}Wrapper>
-       {displayComponent}
-      </Styled{{COMPONENT_CLASS_NAME}}Wrapper>
-    );
+    return <Styled{{COMPONENT_CLASS_NAME}}Wrapper>{displayComponent}</Styled{{COMPONENT_CLASS_NAME}}Wrapper>;
   }
 
-  if (displayMode === "LABELS_LEFT") {
+  if (displayMode === 'LABELS_LEFT') {
     return (
       <Styled{{COMPONENT_CLASS_NAME}}Wrapper>
-      <FieldValueList
-        variant={hideLabel ? 'stacked' : variant}
-        data-testid={testId}
-        fields={[{ id: '1', name: hideLabel ? '' : caption, value: displayComponent }]}
-      />
-     </Styled{{COMPONENT_CLASS_NAME}}Wrapper>
+        <FieldValueList
+          variant={hideLabel ? 'stacked' : variant}
+          data-testid={testId}
+          fields={[{ id: '1', name: hideLabel ? '' : caption, value: displayComponent }]}
+        />
+      </Styled{{COMPONENT_CLASS_NAME}}Wrapper>
     );
   }
 
-  if (displayMode === "STACKED_LARGE_VAL") {
+  if (displayMode === 'STACKED_LARGE_VAL') {
     return (
       <Styled{{COMPONENT_CLASS_NAME}}Wrapper>
-      <FieldValueList
-        variant='stacked'
-        data-testid={testId}
-        fields={[
-          {
-            id: '2',
-            name: hideLabel ? '' : caption,
-            value: (
-              <Text variant='h1' as='span'>
-                {displayComponent}
-              </Text>
-            )
-          }
-        ]}
-      />
+        <FieldValueList
+          variant='stacked'
+          data-testid={testId}
+          fields={[
+            {
+              id: '2',
+              name: hideLabel ? '' : caption,
+              value: (
+                <Text variant='h1' as='span'>
+                  {displayComponent}
+                </Text>
+              )
+            }
+          ]}
+        />
       </Styled{{COMPONENT_CLASS_NAME}}Wrapper>
     );
   }
 
-
   return (
     <Styled{{COMPONENT_CLASS_NAME}}Wrapper>
-    <CheckboxGroup
-      label={label}
-      labelHidden={hideLabel}
-      data-testid={parentTestId}
-      info={validatemessage || helperText}
-      status={status}
-    >
-      {aCosmosCheckbox}
-    </CheckboxGroup>
+      <CheckboxGroup label={label} labelHidden={hideLabel} data-testid={parentTestId} info={validatemessage || helperText} status={status}>
+        {aCosmosCheckbox}
+      </CheckboxGroup>
     </Styled{{COMPONENT_CLASS_NAME}}Wrapper>
   );
-
-
-};
-
+}
 
 export default withConfiguration({{COMPONENT_CLASS_NAME}});

package/src/tasks/create/templates/Constellation/field/Date/DateFormatter.ts.mustache

@@ -11,13 +11,8 @@ dayjs.extend(timezone);
 
 const types = ['fromNow', 'customFormat'];
 
-
-
 // value should be in ISO 8601 format.
-function DateFormatter(
-  value: any,
-  { type = types[1], format = "DD/MM/YYYY", tzone = null } = {}
-) {
+function DateFormatter(value: any, { type = types[1], format = 'DD/MM/YYYY', tzone = null } = {}) {
   if (!value) return value;
   switch (type) {
     case types[1]:
@@ -33,7 +28,7 @@ function DateFormatter(
 // value should be in hh:mm:ss format (00:00:00 - 23:59:59).
 function TimeFormatter(value: any, options: any) {
   if (!value) return value;
-  const { locale = "en-US" } = options;
+  const { locale = 'en-US' } = options;
   const timeOnlyRegex = /^(?:[01]\d|2[0123]):(?:[012345]\d):(?:[012345]\d)$/;
   if (value.length === 8 && timeOnlyRegex.test(value)) {
     const tempDate = new Date();
@@ -50,8 +45,7 @@ function TimeFormatter(value: any, options: any) {
 
 export default {
   Date: (value: any, options: any) => DateFormatter(value, { type: 'customFormat', ...options }),
-  'Date-Time-Default': (value: any, options: any) =>
-    DateFormatter(value, { ...options, type: 'customFormat', format: 'lll' }),
+  'Date-Time-Default': (value: any, options: any) => DateFormatter(value, { ...options, type: 'customFormat', format: 'lll' }),
   'Time-Default': (value: any, options: any) =>
     TimeFormatter(value, {
       ...options,

package/src/tasks/create/templates/Constellation/field/Date/PConnProps.d.ts.mustache

@@ -1,4 +1,4 @@
-import  {PConnect } from '@pega/pcore-pconnect-typedefs';
+import { PConnect } from '@pega/pcore-pconnect-typedefs';
 
 // PConnProps.d.ts
 // This gives us a place to have each component (which is most DX Components) that is
@@ -22,25 +22,24 @@ export interface PConnProps {
   // [key: string]: any;
 }
 
-
 // PConnFieldProps extends PConnProps to bring in the common properties that are
 // associated with most field components (ex: Dropdown, TextInput, etc.) in the
 //  components/field directory
 export interface PConnFieldProps extends PConnProps {
-  label: string,
-  required: boolean,
-  disabled: boolean,
-  value: any,
-  validatemessage: string,
-  status?: string,
-  onChange?: any,
-  onBlur?: any,
-  readOnly: boolean,
-  testId: string,
-  helperText: string,
-  displayMode?: string,
-  hideLabel: boolean,
-  placeholder?: string,
-  fieldMetadata?: any,
-  additionalProps?: any
+  label: string;
+  required: boolean;
+  disabled: boolean;
+  value: any;
+  validatemessage: string;
+  status?: string;
+  onChange?: any;
+  onBlur?: any;
+  readOnly: boolean;
+  testId: string;
+  helperText: string;
+  displayMode?: string;
+  hideLabel: boolean;
+  placeholder?: string;
+  fieldMetadata?: any;
+  additionalProps?: any;
 }

package/src/tasks/create/templates/Constellation/field/Date/date.ts.mustache

@@ -153,7 +153,7 @@ export const getDayJSObject = text => {
  * @returns {object} relative time from now
  */
 export const getRelativeTime = time => {
-  let relativetime = '';
+  let relativetime: string;
   if (dayjs(time).isUTC()) {
     relativetime = dayjs(time).fromNow();
   } else {
@@ -169,8 +169,7 @@ export const getRelativeTime = time => {
  * @param {string} value from which Year needs to be taken out
  * @returns {number} year for the date passed
  */
-export const getFullYear = value =>
-  value ? new Date(value).getFullYear() : new Date().getFullYear();
+export const getFullYear = value => (value ? new Date(value).getFullYear() : new Date().getFullYear());
 
 /**
  * Return maxDate for the date passed
@@ -219,8 +218,7 @@ export const getMinDate = (previousYears, currentYear, yearFromValue) => {
  *
  * @returns {number} clockFormat
  */
-export const parseClockFormat = clockFormat =>
-  typeof clockFormat === 'string' ? parseInt(clockFormat, 10) : clockFormat;
+export const parseClockFormat = clockFormat => (typeof clockFormat === 'string' ? parseInt(clockFormat, 10) : clockFormat);
 
 /**
  * Return datetime value string off to seconds
@@ -264,14 +262,7 @@ export const timeCorrectedToSeconds = (datetime, withSeconds) => {
  *
  * @returns {void}
  */
-export const datetimeFireChangeBlurEvents = (
-  errorState,
-  actualValue,
-  formattedValue,
-  actions,
-  propName,
-  pConn
-) => {
+export const datetimeFireChangeBlurEvents = (errorState, actualValue, formattedValue, actions, propName, pConn) => {
   // TODO - clean up, we should not rely on timestamp from cosmos to check InComplete validation
   // above triggerFieldChange should have validated this
   if (errorState) {

package/src/tasks/create/templates/Constellation/field/Date/demo.stories.tsx.mustache

@@ -1,5 +1,3 @@
-
-/* eslint-disable react/jsx-no-useless-fragment */
 import type { Meta, StoryObj } from '@storybook/react';
 import { configProps, stateProps } from './mock';
 import {{COMPONENT_CLASS_NAME}} from './index';
@@ -22,13 +20,19 @@ export const Base{{COMPONENT_CLASS_NAME}}: Story = args => {
       return {
         getActionsApi: () => {
           return {
-            updateFieldValue: () => {/* nothing */},
-            triggerFieldChange: () => {/* nothing */}
+            updateFieldValue: () => {
+              /* nothing */
+            },
+            triggerFieldChange: () => {
+              /* nothing */
+            }
           };
         },
         getValidationApi: () => {
           return {
-            validate: () => {/* nothing */}
+            validate: () => {
+              /* nothing */
+            }
           };
         },
         getStateProps: () => {
@@ -37,9 +41,15 @@ export const Base{{COMPONENT_CLASS_NAME}}: Story = args => {
         getConfigProps: () => {
           return configProps;
         },
-        ignoreSuggestion: () => {/* nothing */},
-        acceptSuggestion: () => {/* nothing */},
-        clearErrorMessages: () => {/* nothing */}
+        ignoreSuggestion: () => {
+          /* nothing */
+        },
+        acceptSuggestion: () => {
+          /* nothing */
+        },
+        clearErrorMessages: () => {
+          /* nothing */
+        }
       };
     }
   };