@pega/custom-dx-components 25.1.17 → 25.1.19

package/README.md

@@ -37,9 +37,9 @@ Ensure you have access to the following in your system:
 
 - Git version 2.30 or later
 
-- System node version >= 22.15.0
+- System node version >= 24.4.1
 
-- System npm version 10.9.2
+- System npm version 11.4.2
 
 ## Latest Documentation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pega/custom-dx-components",
-  "version": "25.1.17",
+  "version": "25.1.19",
   "description": "Utility for building custom UI components",
   "bin": "./bin/index.js",
   "keywords": [

package/src/tasks/create/index.js

@@ -26,7 +26,9 @@ import {
   getConfigDefaults,
   getSubTypeLabel,
   getMaxComponentNameCount,
-  getStandaloneMaxComponentNameCount
+  getStandaloneMaxLibraryCount,
+  getStandaloneMaxComponentNameCount,
+  getStandaloneMaxLibraryFromPrefixCount
 } from '../../util.js';
 import { COMPONENT_SCHEMA, SHARED_FILE_NAMES } from '../../constants.js';
 
@@ -38,6 +40,7 @@ const copyComponentTemplate = async options => {
   });
 };
 
+
 const compileMustacheTemplates = async (
   componentDirectory,
   {
@@ -305,6 +308,7 @@ addDebugLog("create", "", "+");
       options
     );
   } else {
+    const framework = "Constellation";
     const componentDefaults = getConfigDefaults();
     const serverType = getServerType();
     const maxChars = isLibraryBased ? getMaxComponentNameCount() : getStandaloneMaxComponentNameCount();
@@ -400,10 +404,24 @@ addDebugLog("create", "", "+");
           return 'Please provide semver compatible version e.g 0.0.1';
         },
         when: () => !isLibraryBased
-      },
+      }
+
+    ];
+
+    const answers = await inquirer.prompt(questions);
+    const maxLibChars = await getStandaloneMaxLibraryCount(answers.componentName);
+
+    const libQuestions = [
       {
         name: 'library',
-        message: 'Enter library name (required)',
+        message: value => {
+          if (serverType === "launchpad") {
+            return `Enter library name (required)`;
+          }
+          else {
+            return `Enter library name (required) (${maxLibChars} max chars)`;
+          }
+        },
         default: componentDefaults.library,
         validate: value => {
           /* value should not be empty
@@ -412,6 +430,9 @@ addDebugLog("create", "", "+");
             Only case-insensitive alphanumeric values are allowed
           */
           if (value && !/^\d/.test(value) && value === sanitize(value)) {
+            if (value.length > maxLibChars && serverType != "launchpad") {
+              return `${value.length - maxLibChars} too many characters.`
+            }
             return true;
           }
           return 'Only alphanumeric values are allowed, starting with alphabets';
@@ -426,32 +447,22 @@ addDebugLog("create", "", "+");
       }
     ];
 
-    await inquirer.prompt(questions).then(async answers => {
-      const {
-        componentName,
-        componentLabel,
-        library,
-        version,
+    const libAnswers = await inquirer.prompt(libQuestions);
+
+    await validateCompile(
+      {
+        componentName : answers.componentName,
+        componentLabel : answers.componentLabel,
+        library : libAnswers.library,
+        version : answers.version,
         framework,
-        type,
-        subtype,
-        description
-      } = answers;
-
-      await validateCompile(
-        {
-          componentName,
-          componentLabel,
-          library,
-          version,
-          framework,
-          type,
-          subtype,
-          description
-        },
-        options
-      );
-    });
+        type : answers.type,
+        subtype : answers.subtype,
+        description : libAnswers.description
+      },
+      options
+    );
+
   }
 
   addDebugLog("create", "END", "-");

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

@@ -27,10 +27,13 @@ import { checkPathAccess, showVersion ,
   getConfigDefaults,
   getSubTypeLabel,
   getMaxPrefixCount,
-  getStandaloneMaxPrefixCount
+  getStandaloneMaxPrefixCount,
+  getMaxComponentLibraryCount,
+  getStandaloneMaxLibraryFromPrefixCount
 } from '../../util.js';
 
 import { COMPONENT_SCHEMA, COMPONENTS_DIRECTORY_PATH, TASKS_CONFIG_JSON_FILENAME, COMPONENTS_PATH, CATEGORY_CONSTELLATION, SHARED_FILE_NAMES } from '../../constants.js';
+import lib from 'babel-loader';
 
 export const DXCB_CONFIG_INTERNAL_JSON_FILENAME = 'src/dxcb.config.json';
 
@@ -418,7 +421,7 @@ addDebugLog("createAll", "", "+");
             return `Enter prefix label (${maxPrefixCount} max chars)`;
           }
         },
-          validate: value => {
+        validate: value => {
           /* value should not be empty
           It should not start with a number
           Only case-insensitive alphanumeric values are allowed
@@ -444,10 +447,24 @@ addDebugLog("createAll", "", "+");
           return 'Please provide semver compatible version e.g 0.0.1';
         },
         when: () => !isLibraryBased
-      },
-      {
+      }
+
+    ];
+
+    const answers = await inquirer.prompt(questions);
+    const maxLibChars = await getStandaloneMaxLibraryFromPrefixCount(answers.prefix);
+
+    const libQuestions = [
+    {
         name: 'library',
-        message: 'Enter library name (required)',
+        message: value => {
+          if (serverType === "launchpad") {
+            return `Enter library name (required)`;
+          }
+          else {
+            return `Enter library name (required) (${maxLibChars} max chars)`;
+          }
+        },
         default: componentDefaults.library,
         validate: (value) => {
           /* value should not be empty
@@ -456,6 +473,9 @@ addDebugLog("createAll", "", "+");
             Only case-insensitive alphanumeric values are allowed
           */
           if (value && !/^\d/.test(value) && value === sanitize(value)) {
+            if (value.length > maxLibChars && serverType != "launchpad") {
+              return `${value.length - maxLibChars} too many characters.`
+            }
             return true;
           }
           return 'Only alphanumeric values are allowed, starting with alphabets';
@@ -464,28 +484,28 @@ addDebugLog("createAll", "", "+");
       }
     ];
 
-    await inquirer.prompt(questions).then(async (answers) => {
-      ({library} = answers);
+    const libAnswers = await inquirer.prompt(libQuestions);
+    library = libAnswers.library;
 
-      if (isLibraryBased) {
-        // library comes from config
-        const orgLib = getConfigDefaults();
-        library = orgLib.library;
-      }
+    if (isLibraryBased) {
+      // library comes from config
+      const orgLib = getConfigDefaults();
+      library = orgLib.library;
+    }
+
+    const { version } = answers;
+    let { prefix } = answers;
+    prefix = prefix.replace(/[^a-zA-Z0-9 ]/g, '');
+    await validateCompileAll(
+      {
+        prefix,
+        library,
+        version,
+        organization
+      },
+      options
+    );
 
-      const { version } = answers;
-      let { prefix } = answers;
-      prefix = prefix.replace(/[^a-zA-Z0-9 ]/g, '');
-      await validateCompileAll(
-        {
-          prefix,
-          library,
-          version,
-          organization
-        },
-        options
-      );
-    });
   }
 
 addDebugLog("createAll", "END", "-");

package/src/tasks/init/template/README.md

@@ -37,9 +37,9 @@ Ensure you have access to the following in your system:
 
 - Git version 2.30 or later
 
-- System node version >= 22.15.0
+- System node version >= 24.4.1
 
-- System npm version 10.9.2
+- System npm version 11.4.2
 
 ## Latest Documentation
 

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

@@ -25,13 +25,13 @@
     "delete": "custom-dx-components delete",
     "deleteAll": "custom-dx-components deleteAll",
     "importComponent": "custom-dx-components importComponent",
-    "exportRC" : "custom-dx-components exportRC",
     "help": "custom-dx-components showHelp",
     "publish": "custom-dx-components publish",
     "_***Component_mode_only***": "Component only commands",
     "publishAll": "custom-dx-components publishAll",
     "promoteWebPack": "custom-dx-components promoteWebPack",
     "revertWebPack": "custom-dx-components revertWebPack",
+    "exportRC" : "custom-dx-components exportRC",
     "_***Library_mode_only***": "Library CL mode only commands",
     "createLib": "custom-dx-components createLibrary",
     "switchLib": "custom-dx-components switchLibrary",
@@ -108,7 +108,7 @@
     "@babel/preset-react": "^7.27.1",
     "@babel/preset-typescript": "^7.27.1",
     "@pega/configs": "^0.16.3",
-    "@pega/custom-dx-components": "~25.1.17",
+    "@pega/custom-dx-components": "~25.1.19",
     "@pega/pcore-pconnect-typedefs": "^4.1.0",
     "@storybook/addon-actions": "^8.6.14",
     "@storybook/addon-essentials": "^8.6.14",

package/src/tasks/validator/index.js

@@ -423,6 +423,20 @@ export default async (option) => {
          throw new Error (`${chalk.redBright(`Error: Invalid folder name or componentKey in config.json for component '${data.name}'.\n --> Component folder name: '${componentToValidate}' must match component key '${data.componentKey}'.\n --> NOTE: Values are case sensitve.`)}`);
       }
 
+      if (data.name !== componentToValidate) {
+         throw new Error (`${chalk.redBright(`Error: Invalid folder name or name in config.json for component '${data.name}'.\n --> Component folder name: '${componentToValidate}' must match name '${data.name}'.\n --> NOTE: Values are case sensitve.`)}`);
+      }
+
+    }
+    else {
+      if (data.componentKey !== componentToValidate) {
+         throw new Error (`${chalk.redBright(`Error: Invalid folder name or componentKey in config.json for component '${data.name}'.\n --> Component folder name: '${componentToValidate}' must match component key '${data.componentKey}'.\n --> NOTE: Values are case sensitve.`)}`);
+      }
+
+      if (data.name !== componentToValidate) {
+         throw new Error (`${chalk.redBright(`Error: Invalid folder name or name in config.json for component '${data.name}'.\n --> Component folder name: '${componentToValidate}' must match name '${data.name}'.\n --> NOTE: Values are case sensitve.`)}`);
+      }
+
     }
 
     console.log(`${chalk.bold.green(componentToValidate)} schema is valid`);

package/src/util.js

@@ -1347,11 +1347,28 @@ export const showVersion = async () => {
 
   const nodeMajorVersion = parseInt(arNodeVersion[0]);
   const nodeMinorVersion = parseInt(arNodeVersion[1]);
+  const nodePatchVersion = parseInt(arNodeVersion[2]);
 
-  if (nodeMajorVersion < 22 && nodeMinorVersion < 15 ) {
+  if (nodeMajorVersion < 24) {
     console.log(
       chalk.redBright(
-        `DX Component Builder - requires node v22.15.0 or greater, current version: ${process.version}`
+        `DX Component Builder - requires node v24.14.1 or greater, current version: ${process.version}`
+      )
+    );
+    process.exit(1);
+  }
+  else if ( nodeMajorVersion == 24 && nodeMinorVersion < 4) {
+    console.log(
+      chalk.redBright(
+        `DX Component Builder - requires node v24.14.1 or greater, current version: ${process.version}`
+      )
+    );
+    process.exit(1);
+  }
+  else if (nodeMajorVersion == 24 && nodeMinorVersion == 4 && nodePatchVersion < 1 ) {
+    console.log(
+      chalk.redBright(
+        `DX Component Builder - requires node v24.14.1 or greater, current version: ${process.version}`
       )
     );
     process.exit(1);
@@ -2653,10 +2670,14 @@ if (showDebug) addDebugLog("deleteArchives", ``, "");
   }
 }
 
-export const checkLibraryAndArchives = async () => {
+export const checkLibraryAndArchives = async (checkArch = true) => {
 if (showDebug) addDebugLog("checkLibraryAndArchives", ``, "");
   const isLibraryBased =  getLibraryBased();
-  const hasArch = await hasArchives();
+  let hasArch  = true;
+  if (checkArch) {
+    hasArch = await hasArchives();
+
+  }
 
   if (isLibraryBased && !hasArch) {
     console.log(chalk.yellow('\nPlease create/import a library before proceeding.'));
@@ -2818,7 +2839,20 @@ export const getSubTypeLabel = (type, subtype) => {
 export const getMaxComponentNameCount = () => {
   let count = MAX_RFT_CHARS;
   const configDef = getConfigDefaults();
-  const orgLibCount = configDef.currentOrgLib.length + 1;
+  const orgLibCount = configDef.currentOrgLib.length + 1; // trailing underscore
+  const versionCount = configDef.version.length - 2;
+  const prefixCount = versionCount + 4;
+
+  count = count - orgLibCount - prefixCount - 9; // 9 chars for trailing hash
+
+  return count;
+
+}
+
+export const getMaxComponentLibraryCount = (componentName) => {
+  let count = MAX_RFT_CHARS;
+  const configDef = getConfigDefaults();
+  const orgLibCount = configDef.organization.length + componentName.length + 2; // 2 underscores
   const versionCount = configDef.version.length - 2;
   const prefixCount = versionCount + 4;
 
@@ -2839,16 +2873,35 @@ export const getStandaloneMaxComponentNameCount = () => {
 
 }
 
+export const getStandaloneMaxLibraryCount = async(componentName) => {
+
+  let count = MAX_RFT_CHARS;
+  const configDef = await getConfigDefaults();
+  const orgComp = `${configDef.organization}__${componentName}`;
+  const orgCompCount = orgComp.length + 1;
+
+  count = count - orgCompCount; // 9 chars for trailing hash
+
+  return count;
+
+}
+
 export const getMaxPrefixCount = () => {
   // TwoColumnDetails is 16 chars
   return (getMaxComponentNameCount() - 16);
 }
 
+
+
 export const getStandaloneMaxPrefixCount = () => {
   // TwoColumnDetails is 16 chars
   return (getStandaloneMaxComponentNameCount() - 16);
 }
 
+export const getStandaloneMaxLibraryFromPrefixCount = async(componentName) => {
+  return (await getStandaloneMaxLibraryCount(componentName) - 16);
+}
+
 export const isComponentValidLength = (componentKey) => {
   const serverType = getServerType();
   if (serverType === "launchpad") {