@pega/custom-dx-components 0.242.33 → 0.242.35

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pega/custom-dx-components",
-  "version": "0.242.33",
+  "version": "0.242.35",
   "description": "Utility for building custom UI components",
   "bin": "./bin/index.js",
   "scripts": {
@@ -19,7 +19,7 @@
     "@babel/plugin-transform-class-properties": "^7.23.3",
     "@babel/preset-react": "^7.23.3",
     "@pega/auth": "^0.1.6",
-    "@pega/constellation-dx-components-build-utils": "^1.0.1-dev-0.16",
+    "@pega/constellation-dx-components-build-utils": "^1.0.1-dev-0.17",
     "ajv": "^8.12.0",
     "ajv-keywords": "^5.1.0",
     "archiver": "^7.0.1",

package/src/cli.js

@@ -19,6 +19,7 @@ import {
   deleteVersion,
   importArchive,
   exportArchive,
+  importComponent,
   initProject,
   listComponents,
   listLibrary,
@@ -32,6 +33,7 @@ import {
   revertWebPack,
   promoteWebPack,
   showStatus,
+  showHelp,
   setPermanent,
   storeComponents,
   updateComponent,
@@ -63,6 +65,7 @@ const TASKS = {
   LIST_LIB: 'listLibrary',
   LIST_PUB: 'listPublished',
   SHOW_STATUS: 'showStatus',
+  SHOW_HELP: 'showHelp',
   SET_PERM: 'setPermanent',
   STORE: 'storeComponents',
   VALIDATE_SCHEMA: 'validateSchema',
@@ -74,6 +77,7 @@ const TASKS = {
   DELETE_VERSION: 'deleteVersion',
   IMPORT_ARCHIVE: 'importArchive',
   EXPORT_ARCHIVE: 'exportArchive',
+  IMPORT_COMP: 'importComponent',
   AUTHENTICATE: 'authenticate',
   UPGRADE: 'upgrade',
   BUILD_JEST_ASSETS: 'buildJestAssets'
@@ -190,6 +194,10 @@ export default async (args = []) => {
       showStatus(options);
       break;
     }
+    case TASKS.SHOW_HELP: {
+      showHelp(options);
+      break;
+    }
     case TASKS.SET_PERM: {
       setPermanent(options);
       break;
@@ -206,6 +214,10 @@ export default async (args = []) => {
       exportArchive(options);
       break;
     }
+    case TASKS.IMPORT_COMP: {
+      importComponent(options);
+      break;
+    }
     case TASKS.VALIDATE_SCHEMA: {
       validate(options);
       break;

package/src/tasks/create-lib/index.js

@@ -67,7 +67,6 @@ addDebugLog("createLibrary", "", "+");
   // store it before clearing out /src/components
 
   if (hasArch) {
-
     const hasLib = await hasLibraryAndVersion(libraryName, version, !permBuild);
     if (hasLib) {
       console.log(`${chalk.bold.red(`Library ${orgLib.organization}_${libraryName} already exists.`)}`);

package/src/tasks/create-version/index.js

@@ -15,7 +15,8 @@ import {
   setConfigDevBuild,
   checkLibraryAndArchives,
   getConfigDefaults,
-  forceDefaultsUpdate
+  forceDefaultsUpdate,
+  modAddAboutData
 } from '../../util.js';
 
 import { getCreateVersionComponentQuestions, updateAllComponentsConfig } from './helper.js';
@@ -47,6 +48,14 @@ addDebugLog("createVersion", "", "+");
     version = options.params[3];
     const dPerm = options.params[4];
     const copyExist = options.params[5]
+
+    // if have [6] will be "NoAbout" from Jest, to turn off build date
+    if (options.params.length >= 7 ) {
+      if (options.params[6] === "NoAbout") {
+        modAddAboutData(false);
+      }
+    }
+
     permBuild = !!(dPerm === 'Y' || dPerm === 'y' || dPerm === true || dPerm === 'true');
     copyExisting = !!(copyExist === 'Y' || copyExist === 'y' || copyExist === true || copyExist === 'true');
 

package/src/tasks/delete-lib/index.js

@@ -35,12 +35,12 @@ addDebugLog("deleteLibraryVersion", "", "+");
     process.exit();
   }
 
-  if (version === "") {
-    try {
-      libVersions = await getLibraryArchivesVersions(libraryName, "");
-    }
-    catch (ex) {}
+  try {
+    libVersions = await getLibraryArchivesVersions(libraryName, "");
+  }
+  catch (ex) {}
 
+  if (version === "") {
 
     if (libVersions.length > 0) {
       // ALL option

package/src/tasks/import-archive/index.js

@@ -148,6 +148,27 @@ addDebugLog("renameComponent", `library: ${library}, componentKey: ${componentKe
 
 };
 
+export const getPackgeOrg = async(packagePath) => {
+  const sPackData = fs.readFileSync(packagePath, { encoding: 'utf8' });
+  const packData = sPackData && JSON.parse(sPackData);
+
+  return packData.organization;
+}
+
+export const getLocalConfigData = async(tasksPath) => {
+  let configData = { library: "", version: "", buildVersion: "", devBuild: false};
+  const sTaskData = fs.readFileSync(tasksPath, { encoding: 'utf8' });
+  const taskData = sTaskData && JSON.parse(sTaskData);
+
+  const devBuild = taskData["server-config"].devBuild;
+  configData.library = taskData["component"].library;
+  configData.version = taskData["component"].version;
+  configData.devBuild = devBuild;
+
+  configData.buildVersion = devBuild ? configData.version.concat("-dev") : configData.version;
+
+  return configData;
+}
 
 export const moveComp = async(componentKey, orgLibName, version, copyShared, options) => {
 
@@ -203,7 +224,9 @@ addDebugLog("importArch", `filePath: ${filePath}, fileName: ${fileName}`, "");
 
   // check to see if have a tasks.config.json file, if not, archive not good
   const tempTasksConfig = join(tempDirectory, "tasks.config.json");
-  if (!fs.existsSync(tempTasksConfig)) {
+  const tempPackage = join(tempDirectory, "package.json");
+
+  if (!fs.existsSync(tempTasksConfig) || !fs.existsSync(tempPackage)) {
     console.log(chalk.red.bold(`Zip file: ${fileName} not a compatible DX Component archive.`));
     console.log(chalk.red.bold("Cleaning up..."));
     fs.rmSync(tempDirectory, { recursive: true, force: true, maxRetries: 5  });
@@ -212,20 +235,23 @@ addDebugLog("importArch", `filePath: ${filePath}, fileName: ${fileName}`, "");
 
   }
 
+  // need to get info from tasks.config and package.json
+  // we won't rely on name of file, as owner can change it
+
+  let organization = await getPackgeOrg(tempPackage);
+  let localConfig = await getLocalConfigData(tempTasksConfig);
 
+  let orgLibName = `${organization}_${localConfig.library}`;
+  const version = localConfig.buildVersion;
+  const devBuild = localConfig.devBuild;
 
-  const arFileData = fileName.split("_");
-  let orgLibName = `${arFileData[0]}_${arFileData[1]}`;
-  let libName = arFileData[1];
-  const version = arFileData[2].replace(".zip", "");
-  const devBuild = version.indexOf("-dev") > 0 ? true : false;
   const configDef = getConfigDefaults();
 
-  if (arFileData[0] !== configDef.organization) {
+  if (organization !== configDef.organization) {
     console.log(`\nImported ${chalk.yellow(`${orgLibName}/${version}`)} is not the same organization as your current organization: ${chalk.yellow(`${configDef.organization}`)}.`);
     console.log(`\nTo import, the organization of the components will be changed to match your organization.`);
     console.log(`\n\t>>> If you don't want this to happen, then end and create a new project with an organization`);
-    console.log(`\t    of ${chalk.yellow(`${arFileData[0]}`)} and import there.\n`);
+    console.log(`\t    of ${chalk.yellow(`${organization}`)} and import there.\n`);
 
     const proceedAnswers = await inquirer.prompt([
 

package/src/tasks/import-comp/helper.js

@@ -0,0 +1,49 @@
+import chalk from 'chalk';
+import fs from 'fs';
+import path from 'path';
+import { join } from 'path';
+import { Listr } from 'listr2';
+import { addDebugLog, getConfigDefaults, convertIntoPascalCase, getComponents, getComponentDirectoryPath, getDirectoryFiles } from '../../util.js';
+import { TASKS_CONFIG_JSON_FILENAME, TEMP_PATH, PACKAGE_JSON_FILENAME } from '../../constants.js';
+
+
+export const getFilePathQuestions = async () => {
+addDebugLog("getFilePathQuestions", "", "");
+
+  console.log("\nFile path examples:");
+  if (path.sep === "/") {
+    console.log("\tMac OS/Unix:\t/Users/name/...\n");
+  }
+  else {
+    console.log("\tWindows:\tC:\\Users\\name\\...\n");
+  }
+
+  const currentDirectory = process.cwd();
+  const arPathParts = currentDirectory.split(path.sep);
+  let defaultPath = join(arPathParts[0], arPathParts[1], arPathParts[2], "Downloads");
+  if (path.sep === "/") {
+    defaultPath = "/".concat(defaultPath);
+  }
+
+
+  return [
+    {
+      name: 'filePath',
+      message: 'Enter full file path of zip file location:',
+      default: defaultPath
+    }
+  ];
+};
+
+export const getFileNameQuestions = async (zipFileList) => {
+addDebugLog("getFileNameQuestions", "", "");
+
+  return [
+    {
+      name: 'fileName',
+      type: 'rawlist',
+      message: `Select zip file`,
+      choices: zipFileList
+    },
+  ];
+};

package/src/tasks/import-comp/index.js

@@ -0,0 +1,321 @@
+import fs from 'fs';
+import { promisify } from 'util';
+import { join } from 'path';
+
+import inquirer from 'inquirer';
+import ncp from 'ncp';
+import chalk from 'chalk';
+
+import {
+  sanitize,
+  checkPathAccess,
+  showVersion,
+  getDirectoryFiles,
+  addDebugLog,
+  checkLibraryAndArchives,
+  getConfigDefaults,
+  getComponents
+ } from '../../util.js';
+import { TASKS_CONFIG_JSON_FILENAME } from '../../constants.js';
+import { getFilePathQuestions, getFileNameQuestions  } from './helper.js';
+
+export const DXCB_CONFIG_INTERNAL_JSON_FILENAME = 'src/dxcb.config.json';
+const currentDirectory = process.cwd();
+const pegaConfigJsonPath = join(currentDirectory, TASKS_CONFIG_JSON_FILENAME);
+
+import {
+  convertIntoPascalCase,
+  getComponentDirectoryPath
+} from '../../util.js';
+import Choice from 'inquirer/lib/objects/choice.js';
+
+
+const copy = promisify(ncp);
+
+let gFilePath = "";
+
+
+export const updateConfig = async (
+  {
+    oldComponentKey,
+    newComponentKey,
+    library,
+    version,
+    targetDirectory,
+    newLabel = "",
+  },
+  options,
+  onlyCompanion = false
+) => {
+
+addDebugLog("updateConfig", `oldComponentKey: ${oldComponentKey}, newComponentKey: ${newComponentKey}`, "");
+
+  let configData = fs.readFileSync(join(targetDirectory, "/config.json"), { encoding: 'utf8' });
+  configData = configData && JSON.parse(configData);
+
+  configData.name = newComponentKey;
+  if (configData.componentKey) configData.componentKey = newComponentKey;
+  configData.library = library;
+  configData.version = version;
+
+  if (newLabel != "") {
+    configData.label = newLabel;
+    configData.description = newLabel;
+  }
+
+  // stringify "4", makes the json string look like JSON in the file, formated instead of a single line
+  fs.writeFileSync(join(targetDirectory, "/config.json"), JSON.stringify(configData, null, 4), { encoding: 'utf8' });
+
+};
+
+export const updateFile = async (
+    fileName,
+    oldComponentKeyPC,
+    newComponentKeyPC,
+    targetDirectory,
+) => {
+
+addDebugLog("updateFile", `fileName: ${fileName}, oldComponentKeyPC: ${oldComponentKeyPC}, newComponentKeyPC: ${newComponentKeyPC}, targetDirectory: ${targetDirectory}`, "");
+
+  let fileData = fs.readFileSync(join(targetDirectory, "/", fileName), { encoding: 'utf8' });
+
+  if (fileData.indexOf(oldComponentKeyPC) >= 0) {
+    fileData = fileData.replaceAll(oldComponentKeyPC, newComponentKeyPC);
+
+    fs.writeFileSync(join(targetDirectory, "/", fileName), fileData, { encoding: 'utf8' });
+  }
+
+};
+
+
+// rename the component
+export const renameComponent = async (
+    componentKey,
+    library,
+    version,
+    newName = "",
+    newLabel = "",
+    options
+) => {
+
+addDebugLog("renameComponent", `library: ${library}, componentKey: ${componentKey}`, "");
+
+  const componentName = newName != "" ? newName : componentKey.split("_")[2];
+  const newComponentKey = `${library}_${componentName}`;
+  const oldComponentKey = componentKey;
+  const newComponentKeyPC = convertIntoPascalCase(newComponentKey);
+  const oldComponentKeyPC = convertIntoPascalCase(oldComponentKey);
+
+  const currentDirectory = await getComponentDirectoryPath(componentKey);
+  const targetDirectory = await getComponentDirectoryPath(newComponentKey);
+
+  // custom component
+  try {
+    fs.renameSync(currentDirectory, targetDirectory);
+  } catch(err) {
+    console.log(err)
+  }
+
+  const targetFileList = await getDirectoryFiles(targetDirectory);
+
+  for (var fileIndex in targetFileList) {
+    const fileName = targetFileList[fileIndex];
+
+    if (fileName === "config.json") {
+      await updateConfig(
+        {
+          oldComponentKey,
+          newComponentKey,
+          componentName,
+          library,
+          version,
+          targetDirectory,
+          newLabel
+        },
+        options
+      );
+    }
+    else {
+      await updateFile(
+          fileName,
+          oldComponentKeyPC,
+          newComponentKeyPC,
+          targetDirectory );
+
+    }
+
+  } // for
+
+
+  return newComponentKey;
+
+};
+
+
+export const importComp = async(filePath, fileName) => {
+addDebugLog("importComp", `filePath: ${filePath}, fileName: ${fileName}`, "");
+
+  const currentDirectory = process.cwd();
+  const compDirectory = join(currentDirectory, "src", "components");
+  const copyFilePath = join(filePath, fileName);
+
+  const configDef = getConfigDefaults();
+  const copyDir = join(compDirectory, fileName);
+
+  if (fs.existsSync(copyFilePath)) {
+    fs.cpSync(copyFilePath, copyDir, { recursive: true, force: true  });
+  }
+
+  let configData = fs.readFileSync(join(copyDir, "/config.json"), { encoding: 'utf8' });
+  configData = configData && JSON.parse(configData);
+
+  const compName = configData.componentKey.split("_")[2];
+  const potentialCompKey = `${configDef.currentOrgLib}_${compName}`;
+  const currentCompList = await getComponents();
+  let newName = "";
+  let newLabel = "";
+
+  if (currentCompList && currentCompList.includes(potentialCompKey)) {
+    console.log(`\nComponent ${chalk.yellow(`${potentialCompKey}`)} already exists.`);
+    const proceedAnswers = await inquirer.prompt([
+
+      {
+        name: 'proceedAs',
+        type: 'rawlist',
+        message: `Proceed as ?`,
+        default: 'No import',
+        choices: ['No import', 'Overwrite', 'New name']
+      },
+      {
+        name: 'componentName',
+        message: 'Enter component name (required)',
+        when(answers) {
+          return answers.proceedAs === 'New name';
+        },
+        validate: value => {
+          /* value should not be empty
+          It should not have spaces
+          It should not start with a number
+          Only case-insensitive alphanumeric values are allowed
+        */
+          if (value && !/^\d/.test(value) && value === sanitize(value)) {
+            return true;
+          }
+          return 'Only alphanumeric values are allowed, starting with alphabets, no spaces.';
+        }
+      },
+      {
+        name: 'componentLabel',
+        message: 'Enter component label for display (required)',
+        when(answers) {
+          return answers.proceedAs === 'New name';
+        },
+        validate: value => {
+          if (value) {
+            return true;
+          }
+          return 'Please provide value for label';
+        }
+      }
+    ]);
+
+    switch (proceedAnswers.proceedAs) {
+      case 'No import':
+        // removed copied
+        fs.rmSync(copyDir, { recursive: true, force: true, maxRetries: 2 });
+        process.exit();
+        break;
+      case 'Overwrite':
+        // remove existing
+        const exitingComp = join(compDirectory, potentialCompKey);
+        fs.rmSync(exitingComp, { recursive: true, force: true, maxRetries: 2 });
+        break;
+      case 'New name':
+        newName = proceedAnswers.componentName;
+        newLabel = proceedAnswers.componentLabel;
+        break;
+    }
+
+  }
+
+  const newCompKey = await renameComponent(configData.componentKey, configDef.currentOrgLib, configDef.buildVersion, newName, newLabel, null);
+  console.log(`\n${chalk.green(`${fileName}`)} has been imported as ${chalk.green(`${newCompKey}`)}`);
+
+
+}
+
+
+export const getFolderList = async (filePath) => {
+addDebugLog("getFolderList", `filePath: ${filePath}`, "");
+  if (fs.existsSync(filePath)) {
+    return fs
+      .readdirSync(filePath, { withFileTypes: true })
+      .filter(dirent => dirent.isDirectory())
+      .map(dirent => dirent.name);
+  }
+  else {
+    console.log(chalk.red.bold(`File path: ${filePath} does not exist or no permissions.`));
+    process.exit(1);
+  }
+}
+
+export const hasConfig = (dir) => {
+  const configPath = join(gFilePath, dir, "config.json");
+  if (fs.existsSync(configPath)) {
+    return true;
+  }
+
+  return false;
+}
+
+export const getComponentList = async(filePath) => {
+addDebugLog("getComponentList", `filePath: ${filePath}`, "");
+  let compList = await getFolderList(filePath);
+
+  gFilePath = filePath;
+
+  if (compList.length > 0) {
+    return compList.filter(hasConfig);
+  }
+
+  return compList;
+
+}
+
+export default async options => {
+  await showVersion();
+  await checkLibraryAndArchives();
+  await checkPathAccess(pegaConfigJsonPath);
+
+addDebugLog("importComponent", "", "+");
+
+  if (options.params.length >= 5) {
+    const filePath = options.param[3];
+    const fileName = options.params[4];
+    await importComp( filePath, fileName);
+
+  }
+  else {
+
+    const filePathQuestions = await getFilePathQuestions();
+    const filePathAnswers = await inquirer.prompt(filePathQuestions);
+    const { filePath } = filePathAnswers;
+
+    const compFileList = await getComponentList(filePath);
+
+    if (!compFileList || compFileList.length === 0) {
+      console.log(chalk.red.bold(`No component files exist at path: ${filePath}`));
+      process.exit();
+    }
+
+    const fileNameQuestions = await getFileNameQuestions(compFileList);
+    const fileNameAnswers = await inquirer.prompt(fileNameQuestions);
+    const {fileName} = fileNameAnswers;
+
+    await importComp( filePath, fileName);
+
+  }
+
+addDebugLog("importComponent", "END", "-");
+
+};

package/src/tasks/index.js

@@ -22,10 +22,12 @@ export { default as listComponents } from './list/index.js';
 export { default as listLibrary } from './list-lib/index.js';
 export { default as listPublished } from './list-pub/index.js';
 export { default as showStatus } from './show-status/index.js';
+export { default as showHelp } from './show-help/index.js';
 export { default as setPermanent } from './set-perm/index.js';
 export { default as storeComponents } from './store/index.js';
 export { default as importArchive } from './import-archive/index.js';
 export { default as exportArchive } from './export-archive/index.js';
+export { default as importComponent } from './import-comp/index.js';
 export { default as updateComponent } from './update/index.js';
 export { default as validate } from './validator/index.js';
 export { default as authenticate } from './authenticate/index.js';

package/src/tasks/init/template/package.json.mustache

@@ -19,6 +19,7 @@
     "update": "custom-dx-components update",
     "delete": "custom-dx-components delete",
     "deleteAll": "custom-dx-components deleteAll",
+    "importComponent": "custom-dx-components importComponent",
     "_***Component_mode_only***": "Component only commands",
     "publish": "custom-dx-components publish",
     "publishAll": "custom-dx-components publishAll",
@@ -34,7 +35,7 @@
     "deleteLib": "custom-dx-components deleteLibrary",
     "deletePublishedLib": "custom-dx-components deletePublished",
     "deleteLibVersion": "custom-dx-components deleteVersion",
-    "moveLibVersion": "custom-dx-components moveComponent",
+    "move": "custom-dx-components moveComponent",
     "publishLibVersion": "custom-dx-components publish",
     "storeLibVersion": "custom-dx-components storeComponents",
     "showStatus": "custom-dx-components showStatus",
@@ -43,6 +44,7 @@
     "exportLibVersion": "custom-dx-components exportArchive",
     "validate": "custom-dx-components buildComponent",
     "validateAll": "custom-dx-components buildAllComponents",
+    "help": "custom-dx-components showHelp",
     "_internal-test-coverage": "node --input-type=module  --experimental-vm-modules node_modules/jest/bin/jest.js --runInBand node_modules/@pega/custom-dx-component --ci --testResultsProcessor='jest-junit' --coverage",
     "_internal-test": "echo 'Running functional and unit tests will DELETE existing local components, proceed (y/n)?' && read proceed && if test \"$proceed\" = \"y\"; then npm run _internal-test-full; fi ",
     "_internal-test-full": "npm run _internal-test-functional && npm run _internal-test-unit",
@@ -97,7 +99,7 @@
   },
   "devDependencies": {
     "@pega/configs": "^0.6.0",
-    "@pega/custom-dx-components": "0.242.33",
+    "@pega/custom-dx-components": "0.242.35",
     "@pega/pcore-pconnect-typedefs": "~3.0.0",
     "@storybook/addon-actions": "^7.6.7",
     "@storybook/addon-essentials": "^7.6.19",

package/src/tasks/list-lib/index.js

@@ -16,7 +16,6 @@ export default async (options) => {
   await checkLibraryAndArchives();
 addDebugLog("listLibrary", "", "+");
 
-  let sourceOfLibrary;
   let organization;
   let library;
 
@@ -29,24 +28,28 @@ addDebugLog("listLibrary", "", "+");
   let libVersions = [];
 
   if (options.params.length >= 5) {
-    // sourceOfLibrary = options.params[3];
-    // selectedVersion = options.params[4];
+    libraryName = options.params[3];
+    selectedVersion = options.params[4];
 
-    // libVersions.push(selectedVersion);
+    try {
+      libVersions = await getLibraryArchivesVersions(libraryName, "");
+    }
+    catch (ex) {}
 
   }
+  else {
 
-  const questions = await getArchiveLibraryQuestions();
-  const answers = await inquirer.prompt(questions);
-  ({ libraryName } = answers);
+    const questions = await getArchiveLibraryQuestions();
+    const answers = await inquirer.prompt(questions);
+    ({ libraryName } = answers);
 
-  try {
-    libVersions = await getLibraryArchivesVersions(libraryName, "");
-  }
-  catch (ex) {}
+    try {
+      libVersions = await getLibraryArchivesVersions(libraryName, "");
+    }
+    catch (ex) {}
 
 
-  if (libVersions.length > 0) {
+    if (libVersions.length > 0) {
 
       if (selectedVersion === undefined) {
         const libAnswers = await inquirer.prompt([
@@ -61,10 +64,14 @@ addDebugLog("listLibrary", "", "+");
 
         selectedVersion = libAnswers.libVersion;
       }
+    }
+  }
+
+  let data;
+  // get built on from first component if exists
+  let builtOn = "(date unavailable)";
 
-      let data;
-      // get built on from first component if exists
-      let builtOn = "(date unavailable)";
+  if (libVersions.length > 0) {
 
       if (libraryName === compDef.currentOrgLib && selectedVersion === compDef.buildVersion) {
 

package/src/tasks/move/index.js

@@ -20,7 +20,7 @@ import {
   getLibraryArchivesVersions,
   getLibraryArchiveDirectories
  } from '../../util.js';
-import { TASKS_CONFIG_JSON_FILENAME, COMPONENTS_DIRECTORY_PATH, COMPONENTS_PATH, ARCHIVES_PATH, TEMP_PATH } from '../../constants.js';
+import { TASKS_CONFIG_JSON_FILENAME, COMPONENTS_DIRECTORY_PATH, ARCHIVES_PATH, TEMP_PATH } from '../../constants.js';
 import { getComponentKeyQuestion, getLibraryQuestions, getLibraryVersionQuestion } from './helper.js';
 
 export const DXCB_CONFIG_INTERNAL_JSON_FILENAME = 'src/dxcb.config.json';
@@ -96,26 +96,21 @@ export const renameComponent = async (
 
 addDebugLog("renameComponent", `library: ${library}, componentKey: ${componentKey}`, "");
 
-
   const componentName = componentKey.split("_")[2];
-
-  const configDef = getConfigDefaults();
-
   const newComponentKey = `${library}_${componentName}`;
-
   const oldComponentKey = componentKey;
   const newComponentKeyPC = convertIntoPascalCase(newComponentKey);
   const oldComponentKeyPC = convertIntoPascalCase(oldComponentKey);
 
-  const currentDirectory = await getComponentDirectoryPath(componentKey);
-  const targetDirectory = await getComponentDirectoryPath(newComponentKey);
-
-
+  const currentDirectory = process.cwd();
+  const tempDirectory = join(currentDirectory, TEMP_PATH, "src", "components");
+  const existingDirectory = await getComponentDirectoryPath(componentKey);
+  const targetDirectory = await getComponentDirectoryPath(newComponentKey, tempDirectory);
 
   if (copyMove === "Move") {
     // custom component
     try {
-      fs.renameSync(currentDirectory, targetDirectory);
+      fs.renameSync(existingDirectory, targetDirectory);
     } catch(err) {
       console.log(err)
     }
@@ -124,15 +119,12 @@ addDebugLog("renameComponent", `library: ${library}, componentKey: ${componentKe
     // copy
     // custom component
     try {
-      fs.cpSync(currentDirectory, targetDirectory, { recursive: true});
+      fs.cpSync(existingDirectory, targetDirectory, { recursive: true});
     } catch(err) {
       console.log(err)
     }
   }
 
-
-
-
   const targetFileList = await getDirectoryFiles(targetDirectory);
 
   for (var fileIndex in targetFileList) {
@@ -214,18 +206,9 @@ export const moveComp = async(componentKey, copyMove, orgLibName, version, copyS
       // delete temp directory
       fs.rmSync(tempDirectory, { recursive: true, force: true, maxRetries: 5  });
 
-
-
     }
     else {
 
-      // if (copyMove === "Move") {
-      //    await localMoveComp(componentKey, orgLibName, version, currentDirectory, tempDirectory);
-      // }
-      // else {
-      //   await localCopyComp(componentKey, orgLibName, version, currentDirectory, tempDirectory);
-      // }
-
       const newComponentKey = await localMoveCopyComp(componentKey, orgLibName, version, copyMove, currentDirectory, tempDirectory);
 
       if (newComponentKey) {
@@ -237,7 +220,6 @@ export const moveComp = async(componentKey, copyMove, orgLibName, version, copyS
           fs.cpSync(currentSharedPath, targetSharedPatah, { recursive: true, force: true  });
         }
 
-
         console.log(`\n${copiedOrMoved} ${chalk.green(`${componentKey}`)} to ${chalk.green(`${orgLibName}/${version}`)} as ${chalk.green(`${newComponentKey}`)}\n`);
 
         // rearchive temp directory
@@ -247,7 +229,6 @@ export const moveComp = async(componentKey, copyMove, orgLibName, version, copyS
         console.log(chalk.yellow(`No components were ${copiedOrMoved}`));
       }
 
-
       // delete temp directory
       fs.rmSync(tempDirectory, { recursive: true, force: true, maxRetries: 5  });
     }
@@ -276,24 +257,15 @@ export const localMoveCopyComp = async(componentKey, orgLibName, version, copyMo
       if (!answers.confirmOverride) {
         return null;
       }
+      else {
+        // delete the one in the temp directory, so can move/copy latest
+        fs.rmSync(tempDirComp,  { recursive: true, force: true, maxRetries: 2  });
+      }
     }
 
-
     // rename the component
     const newComponentKey = await renameComponent(componentKey, orgLibName, version, copyMove);
 
-
-
-
-    const currentComponentsPath = join(currentCompPath, `${newComponentKey}`);
-    const tempDirectoryComponents = join(tempCompPath, `${newComponentKey}`);
-
-    // copy component into temp directory
-    fs.cpSync(currentComponentsPath, tempDirectoryComponents, { recursive: true, force: true  });
-
-    // remove from components
-    fs.rmSync(currentComponentsPath, { recursive: true, force: true, maxRetries: 2  });
-
     return newComponentKey;
 }
 
@@ -337,8 +309,8 @@ addDebugLog("move", "", "+");
   }
 
   if (options.params.length >= 8) {
-    componentKey = options.params[3];
-    copyMove = options.param[4];
+    copyMove = options.params[3];
+    componentKey = options.params[4];
     orgLibName = options.params[5];
     version = options.params[6];
     copyShared = options.params[7];

package/src/tasks/show-help/index.js

@@ -0,0 +1,130 @@
+import fs from 'fs';
+import path from 'path';
+
+import chalk from 'chalk';
+
+import { showVersion, getLibraryBased } from '../../util.js';
+
+export const showCurrentStatus = async () => {
+
+  const configDefaults = await getConfigDefaults();
+  const componentList = await getComponents();
+
+  console.log("");
+  console.log("\tCurrent status");
+  console.log("\t---------------------");
+  console.log(`\tOrganization:\t ${chalk.bold.green(`${configDefaults.organization}`)}`);
+  console.log(`\tLibrary:\t ${chalk.bold.green(`${configDefaults.library}`)}`);
+  console.log(`\tVersion:\t ${chalk.bold.green(`${configDefaults.buildVersion}`)}`);
+  if (!configDefaults.devBuild) {
+    console.log(`\tPermanent:\t ${chalk.bold.magentaBright(`${!configDefaults.devBuild}`)}`);
+  }
+  else {
+    console.log(`\tPermanent:\t ${chalk.bold.green(`${!configDefaults.devBuild}`)}`);
+  }
+  console.log(`\tComponent count: ${chalk.bold.green(`${componentList.length}`)}`);
+
+  console.log("");
+
+}
+
+export const showHelpV1 = () => {
+  console.log("");
+  console.log(`\nnpm run <command>`);
+  console.log(`\nUsage:`);
+
+  console.log(`\n${chalk.underline(`Authenticate (for Server commands)`)}`);
+  console.log(`${chalk.cyan('npm run authenticate')}\t\tauthenticate to a server`);
+
+  console.log(`\n${chalk.underline(`Components`)}`);
+  console.log(`${chalk.cyan('npm run create           ')}\tcreate a component`);
+  console.log(`${chalk.cyan('npm run createAll        ')}\tcreate components of all different types`);
+  console.log(`${chalk.cyan('npm run buildComponent   ')}\tvalidate a component before publishing, checking for errors`);
+  console.log(`${chalk.cyan('npm run buildAllComponents')}\tvalidate and build a component before publishing, checking for errors`);
+  console.log(`${chalk.cyan('npm run validateAll      ')}\tvalidate and build ALL components before publishing, checking for errors`);
+  console.log(`${chalk.cyan('npm run rename           ')}\trename a component`);
+  console.log(`${chalk.cyan('npm run importComponent  ')}\timport a component from a path`);
+  console.log(`${chalk.cyan('npm run startStorybook   ')}\tstorybook components for testing`);
+
+  console.log(`\n${chalk.underline(`Local and Server`)}`);
+  console.log(`${chalk.cyan('npm run list             ')}\tget list of components`);
+  console.log(`${chalk.cyan('npm run delete           ')}\tdelete a component`);
+  console.log(`${chalk.cyan('npm run deleteAll        ')}\tdelete ALL components`);
+
+  console.log(`\n${chalk.underline(`Server`)}`);
+  console.log(`${chalk.cyan('npm run publish          ')}\tpublish a component to server`);
+  console.log(`${chalk.cyan('npm run publishAll       ')}\tpublish ALL components to server`);
+
+  console.log("");
+
+};
+
+export const showHelpV2 = () => {
+  console.log("");
+  console.log(`All commands will not work until a library is created via ${chalk.cyan(`npm run createLib`)}.`);
+  console.log(`\nnpm run <command>`);
+  console.log(`\nUsage:`);
+
+
+  console.log(`\n${chalk.underline(`Authenticate`)}`);
+  console.log(`${chalk.cyan('npm run authenticate')}\t\tauthenticate to a server (required for publish commands)`);
+
+  console.log(`\n${chalk.underline(`Library`)}`);
+  console.log(`${chalk.cyan('npm run createLib' )}\t\tcreate a new library and version`);
+  console.log(`${chalk.cyan('npm run switchLib' )}\t\tswitch to different library and version`);
+  console.log(`${chalk.cyan('npm run listLib   ')}\t\tget contents of library and version`);
+  console.log(`${chalk.cyan('npm run deleteLib ')}\t\tdelete library, version or ALL versions`);
+  console.log(`${chalk.cyan('npm run showStatus')}\t\tshow state of current library`);
+
+  console.log(`\n${chalk.underline(`Library Versions`)}`);
+  console.log(`${chalk.cyan('npm run createLibVersion')}\tcreate a new version within the current library`);
+  console.log(`${chalk.cyan('npm run switchLibVersion')}\tswitch to different version within the current library`);
+  console.log(`${chalk.cyan('npm run deleteLibVersion')}\tdelete current version, move to another version`);
+  console.log(`${chalk.cyan('npm run storeLibVersion ')}\tstore current version to local storage (must SAVE before)`);
+  console.log(`${chalk.cyan('npm run exportLibVersion')}\texport currnet version as a zip file to a given local path`);
+  console.log(`${chalk.cyan('npm run importLibVersion')}\timport a zip file (created by export) from a given local path`);
+  console.log(`${chalk.cyan('npm run setPermanent    ')}\tmake current version permanent or non permanent upon publish`);
+
+  console.log(`\n${chalk.underline(`Published Versions (needs authentication)`)}`);
+  console.log(`${chalk.cyan('npm run publishLibVersion')}\tpublish current library/version to server (creates a local published library as well)`);
+  console.log(`${chalk.cyan('npm run listPublishedLib')}\tget contents of published library/version (local or server)`);
+  console.log(`${chalk.cyan('npm run deletePublishedLib')}\tdelete ALL contents of published libary/version (local or server)`);
+
+  console.log(`\n${chalk.underline(`Components (in current library/version context)`)}`);
+  console.log(`${chalk.cyan('npm run create     ')}\t\tcreate a component`);
+  console.log(`${chalk.cyan('npm run createAll  ')}\t\tcreate components of all different types`);
+  console.log(`${chalk.cyan('npm run validate   ')}\t\tvalidate a component before publishing, checking for errors`);
+  console.log(`${chalk.cyan('npm run validateAll')}\t\tvalidate ALL components before publishing, checking for errors`);
+  console.log(`${chalk.cyan('npm run rename     ')}\t\trename a component`);
+  console.log(`${chalk.cyan('npm run move       ')}\t\tmove (or copy) single component or ALL in current version to another version or library`);
+  console.log(`${chalk.cyan('npm run importComponent')}\t\timport a component from a path`);
+  console.log(`${chalk.cyan('npm run list       ')}\t\tget list of components`);
+  console.log(`${chalk.cyan('npm run delete     ')}\t\tdelete a component`);
+  console.log(`${chalk.cyan('npm run deleteAll  ')}\t\tdelete ALL components`);
+  console.log(`${chalk.cyan('npm run startStorybook')}\t\tstorybook components for testing`);
+  console.log("");
+
+  console.log(`\n${chalk.underline(`Notes`)}`);
+  console.log(`The following commands will store existing version in storage before executing the command:`);
+  console.log(`${chalk.cyan(`createLib, switchLib, createLibVersion, switchLibVersion, publishLibVersion, exportLibVersion`)}`);
+  console.log(`\nWhen editing in an IDE, always ${chalk.yellow("SAVE")} changes to components before doing a library/version context switch`);
+  console.log(`or changes will be lost!`);
+  console.log("");
+}
+
+
+export default async options => {
+  const isLibraryBased =  getLibraryBased();
+
+  await showVersion();
+
+  if (isLibraryBased) {
+    await showHelpV2();
+  }
+  else {
+    await showHelpV1();
+  }
+
+
+
+}

package/src/tasks/switch-version/index.js

@@ -16,7 +16,8 @@ import {
   checkLibraryAndArchives,
   getConfigDefaults,
   getHaveDependencyDifference,
-  forceDefaultsUpdate
+  forceDefaultsUpdate,
+  modAddAboutData
 } from '../../util.js';
 
 import { getSwitchVersionComponentQuestions } from './helper.js';
@@ -49,6 +50,13 @@ addDebugLog("switchVersion", "", "+");
     const okToCont = options.params[3];
     version = options.params[4];
 
+    // if have [5] will be "NoAbout" from Jest, to turn off build date
+    if (options.params.length >= 6 ) {
+      if (options.params[5] === "NoAbout") {
+        modAddAboutData(false);
+      }
+    }
+
     okToContinue = !!(okToCont === 'Y' || okToCont === 'y' || okToCont === true || okToCont === 'true');
 
   } else {

package/src/util.js

@@ -42,6 +42,7 @@ const access = promisify(fs.access);
 let showDebug = false;
 let debugLevel = 1;
 let haveDependencyDifference = false;
+let addAboutData = true;
 
 // updated upon start
 let defaultConfigs = {
@@ -62,6 +63,11 @@ let pegaData = null;
 let sPegaData;
 let sPegaServerConfig;
 
+export const modAddAboutData = (addInAboutData) => {
+  // used by jest to not put in to match assets without aboutData
+  addAboutData = addInAboutData;
+}
+
 export const addDebugLog = (sFunctionName, sLogData, sIncDec) => {
 
   let sLog;
@@ -703,33 +709,42 @@ if (showDebug) addDebugLog("updateConfigVersion", `componentKey: ${componentKey}
         }
       }
 
-      if (foundProp) {
-        foundProp.label = aboutData;
-      }
-      else {
-        // don't have "About"
-        const aboutLabelJSON =  {
-          "format": "LABEL",
-          "label": "About",
-          "name": "PegaAboutLabel",
-          "variant": "h3"
-        };
-        const aboutDataJSON = {
-          "format": "LABEL",
-          "label": aboutData,
-          "name": "PegaAboutData",
-          "variant": "primary"
+      if (addAboutData) {
+        if (foundProp) {
+          foundProp.label = aboutData;
+        }
+        else {
+          // don't have "About"
+          const aboutLabelJSON =  {
+            "format": "LABEL",
+            "label": "About",
+            "name": "PegaAboutLabel",
+            "variant": "h3"
+          };
+          const aboutDataJSON = {
+            "format": "LABEL",
+            "label": aboutData,
+            "name": "PegaAboutData",
+            "variant": "primary"
+          }
+          properties.push(aboutLabelJSON);
+          properties.push(aboutDataJSON);
         }
-        properties.push(aboutLabelJSON);
-        properties.push(aboutDataJSON);
       }
+
+
     }
   } catch (er) {
     throw new Error(`Invalid schema json in config.json: ${er}`);
   }
 
   data.version = buildVersion;
-  data.buildDate = dateStamp;
+
+  if (addAboutData) {
+    data.buildDate = dateStamp;
+  }
+
+
 
   // write back file
   fs.writeFileSync(configFile, JSON.stringify(data, null, 4), { encoding: 'utf8' });