@pega/dx-component-builder-sdk 8.23.16 → 8.23.18

package/tests/assets/components/SDK-Angular/createAll/custom-constellation/widget/Pega_DXIL_MyPageCaseWidget/Operator.jsx

@@ -0,0 +1,237 @@
+/* eslint-disable no-undef */
+import { useState, useEffect, Fragment } from 'react';
+import {
+  Link,
+  Button,
+  Popover,
+  Flex,
+  useOuterEvent,
+  useElement,
+  Progress,
+  FormField,
+  useTheme
+} from '@pega/cosmos-react-core';
+import { Glimpse } from '@pega/cosmos-react-work';
+import PropTypes from 'prop-types';
+
+import Avatar from './Avatar.jsx';
+
+const Operator = (props) => {
+  const { id, name, label, testId, helperText, externalUser, metaObj } = props;
+  const [isOpen, setIsOpen] = useState(false);
+  const [isLoading, setIsLoading] = useState(true);
+  const [popoverTarget, setPopoverTarget] = useState(null);
+  const [popoverEl, setPopoverEl] = useElement(null);
+  const [popoverContent, setpopoverContent] = useState(null);
+  const theme = useTheme();
+
+  /* If the id has changed, we need to reset the popover */
+  useEffect(() => {
+    setPopoverTarget(null);
+  }, [id]);
+
+
+
+  const OperatorPreview = () => {
+    const localizedVal = PCore.getLocaleUtils().getLocaleValue;
+    const localeCategory = 'Operator';
+    setpopoverContent(
+      <Progress variant='ring' message={localizedVal('Loading operator...', localeCategory)} placement='local' />
+    );
+    if (externalUser && externalUser.classID !== 'Data-Party-Operator') {
+      const fields = [
+        {
+          id: 'pyFirstName',
+          name: localizedVal('Name', localeCategory),
+          value: externalUser.name
+        },
+        {
+          id: 'pyEmail1',
+          name: localizedVal('Email', localeCategory),
+          value:
+            externalUser.email !== '' ? <Link href={`mailto:${externalUser.email}`}>{externalUser.email}</Link> : ''
+        },
+        {
+          id: 'pyPhoneNumber',
+          name: localizedVal('Phone', localeCategory),
+          value: externalUser.phone !== '' ? <Link href={`tel:${externalUser.phone}`}>{externalUser.phone}</Link> : ''
+        }
+      ];
+      setIsLoading(false);
+      setpopoverContent(
+        <Glimpse
+          visual={
+            <Avatar
+              metaObj={{
+                name: externalUser.name
+              }}
+            />
+          }
+          primary={externalUser.name}
+          secondary={[externalUser.position]}
+          fields={fields}
+        />
+      );
+    } else {
+      const { getOperatorDetails } = PCore.getUserApi();
+      getOperatorDetails(id)
+        .then((res) => {
+          if (res.data && res.data.pyOperatorInfo && res.data.pyOperatorInfo.pyUserName) {
+            const fields = [
+              {
+                id: 'pyOrganization',
+                name: localizedVal('Organization', localeCategory),
+                value: res.data.pyOperatorInfo.pyOrganization
+              },
+              {
+                id: 'pyTelephone',
+                name: localizedVal('Telephone', localeCategory),
+                value:
+                  res.data.pyOperatorInfo.pyTelephone !== '' ? (
+                    <Link href={`tel:${res.data.pyOperatorInfo.pyTelephone}`}>
+                      {res.data.pyOperatorInfo.pyTelephone}
+                    </Link>
+                  ) : (
+                    ''
+                  )
+              },
+              {
+                id: 'pyEmailAddress',
+                name: localizedVal('Email address', localeCategory),
+                value:
+                  res.data.pyOperatorInfo.pyEmailAddress !== '' ? (
+                    <Link href={`mailto:${res.data.pyOperatorInfo.pyEmailAddress}`}>
+                      {res.data.pyOperatorInfo.pyEmailAddress}
+                    </Link>
+                  ) : (
+                    ''
+                  )
+              },
+              {
+                id: 'ReportToUserName',
+                name: localizedVal('Reports to', localeCategory),
+                value: res.data.pyOperatorInfo.pyReportToUserName
+              }
+            ];
+            setIsLoading(false);
+            setpopoverContent(
+              <Glimpse
+                visual={
+                  <Avatar
+                    metaObj={{
+                      image: res.data.pyOperatorInfo.pyImageInsKey || '',
+                      name: res.data.pyOperatorInfo.pyUserName
+                    }}
+                  />
+                }
+                primary={res.data.pyOperatorInfo.pyUserName}
+                secondary={[res.data.pyOperatorInfo.pyPosition]}
+                fields={fields}
+              />
+            );
+          } else {
+            setIsLoading(false);
+            setpopoverContent(<Flex container={{ pad: 1 }}>{localizedVal('Operator not found', localeCategory)}</Flex>);
+          }
+        })
+        .catch(() => {
+          setIsLoading(false);
+          setpopoverContent(
+            <Flex container={{ pad: 1 }}>{localizedVal('Error loading the operator profile', localeCategory)}</Flex>
+          );
+        });
+    }
+  };
+
+
+  const clickAction = (e) => {
+    setPopoverTarget(e.currentTarget);
+    setIsOpen(!isOpen);
+    if (popoverTarget === null) {
+      OperatorPreview();
+    }
+  };
+
+  const hidePopover = () => {
+    if (isOpen) {
+      setIsOpen(false);
+    }
+  };
+  useOuterEvent('mousedown', [popoverEl, popoverTarget], hidePopover); // Call the method on clicking outside these elements
+  const hideOnEscape = (e) => {
+    if (e.key === 'Escape') hidePopover(); // Call the method when Escape key is pressed
+  };
+
+  const comp = (
+    <Fragment>
+      {metaObj ? (
+        <Button
+          variant='text'
+          aria-haspopup
+          aria-expanded={isOpen}
+          onClick={clickAction}
+          onKeyDown={hideOnEscape}
+          data-test-id={testId}
+          style={label !== null ? { width: 'max-content', height: theme.components.input.height } : undefined}
+        >
+          <Avatar metaObj={metaObj}></Avatar>
+        </Button>
+      ) : (
+        <Button
+          variant='link'
+          aria-haspopup
+          aria-expanded={isOpen}
+          onClick={clickAction}
+          onKeyDown={hideOnEscape}
+          data-test-id={testId}
+          style={label !== null ? { width: 'max-content', height: theme.components.input.height } : undefined}
+        >
+          {name}
+        </Button>
+      )}
+
+      {isOpen && (
+        <Popover
+          ref={setPopoverEl}
+          groupId='operator'
+          target={popoverTarget}
+          placement='bottom-start'
+          style={isLoading ? { position: 'relative', width: '10rem', minHeight: '4rem' } : undefined}
+          strategy='fixed'
+        >
+          {popoverContent}
+        </Popover>
+      )}
+    </Fragment>
+  );
+
+  if (label !== null) {
+    return (
+      <FormField label={label} info={helperText}>
+        {comp}
+      </FormField>
+    );
+  }
+
+  return comp;
+};
+
+Operator.propTypes = {
+  name: PropTypes.string,
+  id: PropTypes.string,
+  label: PropTypes.string,
+  testId: PropTypes.string,
+  helperText: PropTypes.string,
+  metaObj: PropTypes.object
+};
+
+Operator.defaultProps = {
+  name: '',
+  id: '',
+  label: null,
+  testId: null,
+  helperText: null,
+  metaObj: null
+};
+
+export default Operator;

package/tests/assets/components/SDK-Angular/createAll/custom-constellation/widget/Pega_DXIL_MyPageCaseWidget/demo.stories.jsx

@@ -0,0 +1,68 @@
+import { withKnobs } from '@storybook/addon-knobs';
+
+import PegaDxilMyPageCaseWidget from './index.jsx';
+
+import { configProps, operatorDetails } from './mock.stories';
+
+export default {
+  title: 'PegaDxilMyPageCaseWidget',
+  decorators: [withKnobs],
+  component: PegaDxilMyPageCaseWidget
+};
+
+if (!window.PCore) {
+  window.PCore = {};
+}
+
+window.PCore.getLocaleUtils = () => {
+  return {
+    getLocaleValue: value => {
+      return value;
+    }
+  };
+};
+
+window.PCore.getUserApi = () => {
+  return {
+    getOperatorDetails: () => {
+      return new Promise(resolve => {
+        resolve(operatorDetails);
+      });
+    }
+  };
+};
+
+export const basePegaDxilMyPageCaseWidget = () => {
+
+  const props = {
+    label: configProps.label,
+    createLabel: configProps.createLabel,
+    updateLabel: configProps.updateLabel,
+    createOperator: configProps.createOperator,
+    updateOperator: configProps.updateOperator,
+    createDateTime: configProps.createDateTime,
+    updateDateTime: configProps.updateDateTime,
+    hideLabel: configProps.hideLabel,
+
+    getPConnect: () => {
+      return {
+        getActionsApi: () => {
+          return {
+            updateFieldValue: () => {/* nothing */},
+            triggerFieldChange: () => {/* nothing */}
+          };
+        },
+        ignoreSuggestion: () => {/* nothing */},
+        acceptSuggestion: () => {/* nothing */},
+        setInheritedProps: () => {/* nothing */},
+        resolveConfigProps: () => {/* nothing */}
+      };
+    }
+};
+
+return (
+    <>
+      <PegaDxilMyPageCaseWidget {...props} />
+    </>
+  );
+};

package/tests/assets/components/SDK-Angular/createAll/custom-constellation/widget/Pega_DXIL_MyPageCaseWidget/index.jsx

@@ -0,0 +1,108 @@
+/* eslint-disable no-nested-ternary */
+import { Fragment } from 'react';
+import { DateTimeDisplay, Card, CardHeader, CardContent, Flex } from '@pega/cosmos-react-core';
+import PropTypes from 'prop-types';
+
+// includes in bundle
+import Operator from './Operator.jsx';
+
+import StyledPegaDxilMyPageCaseWidgetWrapper from './styles';
+
+
+// Duplicated runtime code from Constellation Design System Component
+
+// props passed in combination of props from property panel (config.json) and run time props from Constellation
+// any default values in config.pros should be set in defaultProps at bottom of this file
+export default function PegaDxilMyPageCaseWidget(props) {
+
+  const {
+    getPConnect,
+    title,
+    label,
+    createLabel,
+    updateLabel,
+    createOperator,
+    updateOperator,
+    createDateTime,
+    updateDateTime,
+    resolveLabel,
+    resolveOperator,
+    resolveDateTime,
+    hideLabel
+  } = props;
+
+
+  const [_label, user, dateTimeValue] =
+    label === 'Create operator'
+      ? [createLabel, createOperator, createDateTime]
+      : label === 'Update operator'
+      ? [updateLabel, updateOperator, updateDateTime]
+      : [resolveLabel, resolveOperator, resolveDateTime];
+
+
+
+  return user.userId && user.userName ? (
+    <StyledPegaDxilMyPageCaseWidgetWrapper>
+      <Card>
+      <CardHeader>{title}</CardHeader>
+      <CardContent>
+      <Flex container={{ direction: 'row'}}>
+      <Operator label={hideLabel ? null : _label} name={user.userName} id={user.userId} getPConnect={getPConnect} />
+
+      {dateTimeValue && (
+        <Fragment>
+          {' '}
+          <DateTimeDisplay value={dateTimeValue} variant='relative' />
+        </Fragment>
+      )}
+      </Flex>
+      </CardContent>
+      </Card>
+
+    </StyledPegaDxilMyPageCaseWidgetWrapper>
+  ) : (
+    <StyledPegaDxilMyPageCaseWidgetWrapper>
+    defVal
+    </StyledPegaDxilMyPageCaseWidgetWrapper>
+  );
+
+
+
+}
+
+PegaDxilMyPageCaseWidget.defaultProps = {
+  "label": "Create operator",
+  "title": "Create operator",
+  createLabel: null,
+  updateLabel: null,
+  createOperator: null,
+  updateOperator: null,
+  createDateTime: null,
+  updateDateTime: null,
+  resolveLabel: null,
+  resolveOperator: null,
+  resolveDateTime: null,
+  hideLabel: false
+};
+
+PegaDxilMyPageCaseWidget.propTypes = {
+  getPConnect: PropTypes.func.isRequired,
+  label: PropTypes.string,
+  title: PropTypes.string,
+  createLabel: PropTypes.string,
+  updateLabel: PropTypes.string,
+  resolveLabel: PropTypes.string,
+  createOperator: PropTypes.objectOf(PropTypes.any),
+  updateOperator: PropTypes.objectOf(PropTypes.any),
+  resolveOperator: PropTypes.objectOf(PropTypes.any),
+  createDateTime: PropTypes.string,
+  updateDateTime: PropTypes.string,
+  resolveDateTime: PropTypes.string,
+  hideLabel: PropTypes.bool
+};
+
+// as objects are there in props, shallow comparision fails & re-rendering of comp happens even with
+// same key value pairs in obj. hence using custom comparison function on when to re-render
+// const comparisonFn = (prevProps, nextProps) => {
+//   return prevProps.updateDateTime === nextProps.updateDateTime;
+// };

package/tests/assets/components/SDK-Angular/createAll/custom-constellation/widget/Pega_DXIL_MyPageCaseWidget/mock.stories.js

@@ -0,0 +1,51 @@
+export const configProps = {
+  label: 'Create operator',
+  createLabel: 'Created',
+  updateLabel: 'Updated',
+  updateDateTime: '2023-01-16T14:53:33.280Z',
+  createDateTime: '2023-01-16T14:53:33.198Z',
+  updateOperator: {
+    userId: 'admin@mediaco',
+    userName: 'admin'
+  },
+  createOperator: {
+    userId: 'admin@mediaco',
+    userName: 'admin'
+  },
+  hideLabel: true,
+  key: '_532zx1dah',
+  displayMode: 'LABELS_LEFT'
+};
+
+export const operatorDetails = {
+  data: {
+    pzLoadTime: 'January 18, 2023 10:33:19 AM EST',
+    pzPageNameHash: '_pa1519192551088960pz',
+    pyOperatorInfo: {
+      pyUserName: 'french DigV2',
+      pyPosition: '',
+      pyImageInsKey: '',
+      pySkills: [
+        {
+          pySkillName: '',
+          pzIndexOwnerKey: 'DATA-ADMIN-OPERATOR-ID FRENCHTEST.DIGV2',
+          pySkillRating: 0
+        }
+      ],
+      pyReportToUserName: '',
+      pyReportTo: '',
+      pyOrganization: 'DXIL',
+      pyTitle: '',
+      pyLabel: 'frenchTest.DigV2',
+      pyEmailAddress: 'User@DigV2',
+      pyTelephone: ''
+    }
+  },
+  status: 200,
+  statusText: '',
+  headers: {
+    'content-length': '435',
+    'content-type': 'application/json;charset=UTF-8'
+  },
+  request: {}
+};

package/tests/assets/components/SDK-Angular/createAll/custom-constellation/widget/Pega_DXIL_MyPageCaseWidget/styles.js

@@ -0,0 +1,14 @@
+// utilizing theming, comment out, if want individual style
+import styled from 'styled-components';
+import { Configuration } from '@pega/cosmos-react-core';
+
+export default styled(Configuration)``;
+
+// individual style, comment out above, and uncomment here and add styles
+// import styled, { css } from 'styled-components';
+//
+// export default styled.div(() => {
+//  return css`
+//    margin: 0px 0;
+//  `;
+// });

package/tests/assets/components/SDK-Angular/createAll/custom-constellation/widget/Pega_DXIL_MyPageWidget/OneColumnPage.svg

@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="100px" height="70px" viewBox="0 0 100 70" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+    <title>1 col </title>
+    <defs>
+        <rect id="path-1" x="0" y="0" width="100" height="70"></rect>
+    </defs>
+    <g id="Concepts" stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
+        <g id="Templates" transform="translate(-98.000000, -108.000000)">
+            <g id="Change-template" transform="translate(42.000000, 36.000000)">
+                <g id="1-col-" transform="translate(56.000000, 72.000000)">
+                    <mask id="mask-2" fill="white">
+                        <use xlink:href="#path-1"></use>
+                    </mask>
+                    <rect stroke="#A5A8BC" stroke-width="0.5" x="0.25" y="0.25" width="99.5" height="69.5"></rect>
+                    <g id="white" mask="url(#mask-2)" fill="#FFFFFF">
+                        <g transform="translate(3.000000, 3.000000)" id="Rectangle">
+                            <rect x="0" y="0" width="94" height="66.5"></rect>
+                        </g>
+                    </g>
+                    <g id="gray" mask="url(#mask-2)" fill="#8084A7">
+                        <g transform="translate(6.000000, 6.000000)" id="Rectangle">
+                            <rect x="0" y="-2.84217094e-14" width="88" height="77.8"></rect>
+                        </g>
+                    </g>
+                    <g id="labels" mask="url(#mask-2)" font-family="OpenSans-Semibold, Open Sans" font-size="11" font-weight="500">
+                        <g transform="translate(44.000000, 17.000000)" id="A">
+                            <text>
+                                <tspan x="0.75" y="12" fill="#FFFFFF">A</tspan>
+                            </text>
+                        </g>
+                    </g>
+                </g>
+            </g>
+        </g>
+    </g>
+</svg>

package/tests/assets/components/SDK-Angular/createAll/custom-constellation/widget/Pega_DXIL_MyPageWidget/demo.stories.jsx

@@ -0,0 +1,30 @@
+import { withKnobs } from '@storybook/addon-knobs';
+
+import PegaDxilMyPageWidget from './index.jsx';
+
+
+import configProps from './mock.stories';
+
+export default {
+  title: 'PegaDxilMyPageWidget',
+  decorators: [withKnobs],
+  component: PegaDxilMyPageWidget
+};
+
+export const basePegaDxilMyPageWidget = () => {
+
+  const props = {
+    label: configProps.label,
+    header: configProps.header,
+    description: configProps.description,
+    image: configProps.image,
+    datasource: configProps.datasource,
+    whatsnewlink: configProps.whatsnewlink
+};
+
+return (
+    <>
+      <PegaDxilMyPageWidget {...props} />
+    </>
+  );
+};

package/tests/assets/components/SDK-Angular/createAll/custom-constellation/widget/Pega_DXIL_MyPageWidget/index.jsx

@@ -0,0 +1,48 @@
+import PropTypes from 'prop-types';
+import { AppAnnouncement as PegaAppAnnouncement } from '@pega/cosmos-react-work';
+
+import StyledPegaDxilMyPageWidgetWrapper from './styles';
+
+
+// Duplicated runtime code from Constellation Design System Component
+
+// props passed in combination of props from property panel (config.json) and run time props from Constellation
+// any default values in config.pros should be set in defaultProps at bottom of this file
+export default function PegaDxilMyPageWidget(props) {
+
+  const { header, description, datasource, whatsnewlink, image } = props;
+  let details = [];
+  if (datasource && datasource.source) {
+    details = datasource.source.map((item) => {
+      return item.name;
+    });
+  }
+  return (
+    <StyledPegaDxilMyPageWidgetWrapper>
+    <PegaAppAnnouncement
+      heading={header}
+      description={description}
+      details={details}
+      whatsNewLink={whatsnewlink}
+      image={image.replace(/ /g, '+')}
+    />
+    </StyledPegaDxilMyPageWidgetWrapper>
+  );
+
+}
+
+PegaDxilMyPageWidget.defaultProps = {
+  header: '',
+  description: '',
+  image: '',
+  datasource: [],
+  whatsnewlink: ''
+};
+
+PegaDxilMyPageWidget.propTypes = {
+  header: PropTypes.string,
+  description: PropTypes.string,
+  datasource: PropTypes.instanceOf(Object),
+  whatsnewlink: PropTypes.string,
+  image: PropTypes.string
+};

package/tests/assets/components/SDK-Angular/createAll/custom-constellation/widget/Pega_DXIL_MyPageWidget/mock.stories.js

@@ -0,0 +1,23 @@
+const configProps = {
+  label: 'App announcement',
+  header: 'Announcements',
+  description: 'Welcome to MediaCo Application for testing SDK frameworks.',
+  whatsnewlink: 'https://design.pega.com',
+  image:
+    'data:image/svg xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAzOSAxMSI PHRpdGxlPlBlZ2EgdGV4dC1vbmx5IGxvZ288L3RpdGxlPjxwYXRoIHN0eWxlPSJmaWxsLW9wYWNpdHk6IC4yNTsiIGZpbGw9IiNmZmYiIGQ9Ik03LjcyIDMuODJjMCAyLjI1LTEuNzggMy40MS00IDMuNDFoLTEuNnYzSDBWLjQyaDMuOTRjMi4zNiAwIDMuNzggMS4zOSAzLjc4IDMuNHptLTQtMS40N2gtMS42djNoMS43QTEuNDcgMS40NyAwIDAgMCA1LjUgMy44MmMwLS45MS0uNjUtMS40Ny0xLjc1LTEuNDd6bTcuNjggNS45MWg1LjN2Mkg5LjI5Vi40Mmg3LjM4djEuOTNoLTUuMjR2Mmg0LjI0djEuOWgtNC4yNHpNMjMuMTggMGE1IDUgMCAwIDEgMy41NyAxLjI4TDI1LjYzIDIuOGEzLjc4IDMuNzggMCAwIDAtMS4wNS0uNjNBNC4zMiA0LjMyIDAgMCAwIDIzLjMxIDIgMy4xNyAzLjE3IDAgMCAwIDIwIDUuMjdhMy4xNiAzLjE2IDAgMCAwIDEgMi4zOSAzLjA3IDMuMDcgMCAwIDAgMi4xNy44NCA0LjYgNC42IDAgMCAwIDIuMDktLjVWNi4xOWgtMi4yVjQuMzhoNC4yNXY0LjU2YTUuNDEgNS40MSAwIDAgMS00LjA4IDEuNTdBNS4zNSA1LjM1IDAgMCAxIDE5LjQzIDlhNS4wNSA1LjA1IDAgMCAxLTEuNTYtMy43NCA1LjIxIDUuMjEgMCAwIDEgMS41Ni0zLjc2QTUuMzEgNS4zMSAwIDAgMSAyMy4xOCAwem0xMS4yOS40Mmw0LjEzIDkuNzloLTIuMjVMMzUuNDggOGgtNC4wNmwtLjkgMi4xOGgtMi4yTDMyLjUxLjQyem0uMjUgNS43MkwzMy40NCAzbC0xLjI5IDMuMTR6bTMtNWEuNzEuNzEgMCAwIDEtLjc0Ljc1LjcxLjcxIDAgMCAxLS43My0uNzUuNzMuNzMgMCAwIDEgLjc1LS43Mi43Mi43MiAwIDAgMSAuNzUuNzF6TTM3IC41M2EuNTkuNTkgMCAwIDAtLjYuNi42MS42MSAwIDEgMCAxLjIxIDAgLjYuNiAwIDAgMC0uNjEtLjZ6bS0uMjQgMVYuNzFIMzdjLjEyIDAgLjE4LjA2LjI1LjA2YS4yMS4yMSAwIDAgMSAuMDcuMTguMTkuMTkgMCAwIDEtLjA3LjE4cy0uMDcuMDgtLjEzLjA4bC4yNi4zNmgtLjJMMzcgMS4yOGgtLjF2LjI5em0uMTMtLjQ0aC4yM2EuMjYuMjYgMCAwIDAgLjA3LS4wOWgtLjA2Yy0uMDUtLjE3LS4wNS0uMTctLjEzLS4xN2gtLjF6Ii8 PC9zdmc ',
+  datasource: {
+    source: [
+      {
+        name: 'New React based UI rendering'
+      },
+      {
+        name: 'Support for followers and recents'
+      },
+      {
+        name: 'New authoring experience'
+      }
+    ],
+    fields: {}
+  }
+};
+export default configProps;

package/tests/assets/components/SDK-Angular/createAll/custom-constellation/widget/Pega_DXIL_MyPageWidget/styles.js

@@ -0,0 +1,14 @@
+// utilizing theming, comment out, if want individual style
+import styled from 'styled-components';
+import { Configuration } from '@pega/cosmos-react-core';
+
+export default styled(Configuration)``;
+
+// individual style, comment out above, and uncomment here and add styles
+// import styled, { css } from 'styled-components';
+//
+// export default styled.div(() => {
+//  return css`
+//    margin: 0px 0;
+//  `;
+// });

package/tests/assets/components/SDK-Angular/createAll/custom-constellation/widget/_widget.md

@@ -0,0 +1,5 @@
+# The **custom-constellation/widget** directory
+
+The **src/components/custom-constellation/widget** directory contains the code for the Constellation-based associated component for any custom **widget** component you have created for use with the **Angular SDK**.
+
+For each component in the **src/components/custom-constellation/widget** directory, there will be a matching component in the **src/components/custom-sdk/widget** directory.

package/tests/assets/components/SDK-Angular/createAll/custom-sdk/_custom-sdk.md

@@ -0,0 +1,5 @@
+# The **components/custom-sdk** directory
+
+The **src/components/custom-sdk** directory contains the code for custom components that you create and use with the **Angular SDK**.
+
+When you run the **npm run  create** command to create new components, the generated code that you can use as a starting point for your component development will be placed in type-specific and component-specific folders in **src/components/custom-sdk**.

package/tests/assets/components/SDK-Angular/createAll/custom-sdk/field/_field.md

@@ -0,0 +1,6 @@
+# The **custom-sdk/field** directory
+
+The **src/components/custom-sdk/field** directory contains the code for the custom **field** components you want to create and use with the **Angular SDK**.
+
+When you run the **npm run  create** command to create new _field_ components, the generated code that you can use as a starting point for your component development
+will be placed in component-specific folders in **src/components/custom-sdk/field**.