@pega/custom-dx-components 0.26.7 → 0.26.8

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": "0.26.7",
+  "version": "0.26.8",
   "description": "Utility for building custom UI components",
   "bin": "./bin/index.js",
   "keywords": [

package/src/tasks/create/index.js

@@ -13,6 +13,7 @@ import {
   getComponentDirectoryPath,
   getComponents,
   getPegaServerConfig,
+  getServerType,
   sanitize,
   validateSemver,
   showVersion,
@@ -25,7 +26,9 @@ import {
   getConfigDefaults,
   getSubTypeLabel,
   getMaxComponentNameCount,
-  getStandaloneMaxComponentNameCount
+  getStandaloneMaxLibraryCount,
+  getStandaloneMaxComponentNameCount,
+  getStandaloneMaxLibraryFromPrefixCount
 } from '../../util.js';
 import { COMPONENT_SCHEMA, SHARED_FILE_NAMES } from '../../constants.js';
 
@@ -305,7 +308,9 @@ addDebugLog("create", "", "+");
       options
     );
   } else {
+    const framework = "Constellation";
     const componentDefaults = getConfigDefaults();
+    const serverType = getServerType();
     const maxChars = isLibraryBased ? getMaxComponentNameCount() : getStandaloneMaxComponentNameCount();
     const questions = [
       {
@@ -354,7 +359,14 @@ addDebugLog("create", "", "+");
       },
       {
         name: 'componentName',
-        message: `Enter component name (required) (${maxChars} max chars)`,
+        message: value => {
+          if (serverType === "launchpad") {
+            return `Enter component name (required)`;
+          }
+          else {
+            return `Enter component name (required) (${maxChars} max chars)`;
+          }
+        },
         validate: value => {
           /* value should not be empty
           It should not have spaces
@@ -362,7 +374,7 @@ addDebugLog("create", "", "+");
           Only case-insensitive alphanumeric values are allowed
         */
           if (value && !/^\d/.test(value) && value === sanitize(value)) {
-            if (value.length > maxChars) {
+            if (value.length > maxChars && serverType != "launchpad") {
               return `${value.length - maxChars} too many characters.`
             }
             return true;
@@ -392,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
@@ -404,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';
@@ -418,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

@@ -14,6 +14,7 @@ import { checkPathAccess, showVersion ,
   compileMustacheTemplate,
   getComponentDirectoryPath,
   getPegaServerConfig,
+  getServerType,
   getComponents,
   sanitize,
   validateSemver,
@@ -26,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';
 
@@ -405,17 +409,25 @@ addDebugLog("createAll", "", "+");
     );
   } else {
     const maxPrefixCount = isLibraryBased ? getMaxPrefixCount() : getStandaloneMaxPrefixCount();
+    const serverType = getServerType();
     const questions = [
       {
         name: 'prefix',
-        message: `Enter prefix label (${maxPrefixCount} max chars)`,
-          validate: value => {
+        message: value => {
+          if (serverType === "launchpad") {
+            return `Enter prefix label`;
+          }
+          else {
+            return `Enter prefix label (${maxPrefixCount} max chars)`;
+          }
+        },
+        validate: value => {
           /* value should not be empty
           It should not start with a number
           Only case-insensitive alphanumeric values are allowed
         */
           if (value && !/^\d/.test(value) ) {
-            if (value.length > maxPrefixCount) {
+            if (value.length > maxPrefixCount && serverType != "launchpad") {
               return `${value.length - maxPrefixCount} too many characters.`
             }
             return true;
@@ -435,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
@@ -447,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';
@@ -455,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

@@ -31,6 +31,7 @@
     "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",
@@ -107,7 +108,7 @@
     "@babel/preset-react": "^7.27.1",
     "@babel/preset-typescript": "^7.27.1",
     "@pega/configs": "^0.16.3",
-    "@pega/custom-dx-components": "~0.26.7",
+    "@pega/custom-dx-components": "~0.26.8",
     "@pega/pcore-pconnect-typedefs": "^4.1.0",
     "@storybook/addon-docs": "^9.1.7",
     "@storybook/addon-essentials": "^9.0.0-alpha.12",

package/src/tasks/validator/index.js

@@ -419,9 +419,22 @@ export default async (option) => {
         throw new Error (`${chalk.redBright(`Error: Invalid componentKey in config.json for component '${data.name}'.\n --> Component prefix Org_Lib: '${sPrefix}' must match '${configDef.currentOrgLib}'. \n --> These represent organization and library values found in package.json and tasks.config.json respectively. `)}`);
       }
 
-      if (data.componentKey.indexOf(componentToValidate) !== 0) {
+      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.`)}`);
+      }
+
+    }
+    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.`)}`);
       }
 
     }

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);
@@ -2822,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;
 
@@ -2843,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") {