@oracle/oraclejet-audit 14.1.5 → 15.0.1

package/corePackMigrator/metadata/statusMeterGaugeMetadata.json

@@ -0,0 +1,99 @@
+{
+  "legacyTag": "oj-status-meter-gauge",
+  "corePackTag": "oj-c-meter-bar",
+  "migrateImports": {
+    "from": "ojs/ojgauge",
+    "to": ["oj-c/meter-bar", "oj-c/meter-circle", "oj-c/rating-gauge"]
+  },
+  "migrateTagByAttribute": [
+    {
+      "fromTag": "oj-status-meter-gauge",
+      "toTag": "oj-c-meter-bar",
+      "attribute": "orientation",
+      "attributeValue": "vertical"
+    },
+    {
+      "fromTag": "oj-status-meter-gauge",
+      "toTag": "oj-c-meter-bar",
+      "attribute": "orientation",
+      "attributeValue": "horizontal"
+    },
+    {
+      "fromTag": "oj-status-meter-gauge",
+      "toTag": "oj-c-meter-circle",
+      "attribute": "orientation",
+      "attributeValue": "circular"
+    }
+  ],
+  "migrateAttributes": [
+    {
+      "fromAttribute": "metric-label.converter",
+      "fromValue": "",
+      "toAttribute": "",
+      "toValue": ""
+    },
+    {
+      "fromAttribute": "metric-label.position",
+      "fromValue": "",
+      "toAttribute": "",
+      "toValue": ""
+    },
+    {
+      "fromAttribute": "metric-label.rendered",
+      "fromValue": "",
+      "toAttribute": "",
+      "toValue": ""
+    },
+    {
+      "fromAttribute": "metric-label.scaling",
+      "fromValue": "",
+      "toAttribute": "",
+      "toValue": ""
+    },
+    {
+      "fromAttribute": "metric-label.style",
+      "fromValue": "",
+      "toAttribute": "",
+      "toValue": ""
+    },
+    {
+      "fromAttribute": "metric-label.text",
+      "fromValue": "",
+      "toAttribute": "",
+      "toValue": ""
+    },
+    {
+      "fromAttribute": "metric-label.text-type",
+      "fromValue": "",
+      "toAttribute": "",
+      "toValue": ""
+    },
+    {
+      "fromAttribute": "thresholds.shortDesc",
+      "fromValue": "",
+      "toAttribute": "thresholds.accessibleLabel",
+      "toValue": ""
+    },
+    {
+      "fromAttribute": "",
+      "fromValue": "",
+      "toAttribute": "orientation",
+      "toValue": "horizontal"
+    },
+    {
+      "fromAttribute": "threshold-display",
+      "fromValue": "currentOnly",
+      "toAttribute": "threshold-display",
+      "toValue": "plotArea"
+    },
+    {
+      "fromAttribute": "threshold-display",
+      "fromValue": "onIndicator",
+      "toAttribute": "threshold-display",
+      "toValue": "indicator"
+    }
+  ],
+  "NOT COMPLETE YET. NEED TO ADD MORE": {
+    "plot-area": "auto"
+  }
+}

package/corePackMigrator/metadata/textAreaMetadata.json

@@ -0,0 +1,44 @@
+{
+  "legacyTag": "oj-text-area",
+  "corePackTag": "oj-c-text-area",
+  "migrateImports": {
+    "from": "ojs/ojinputtext",
+    "to": ["oj-c/input-text", "oj-c/text-area", "oj-c/input-password"]
+  },
+  "classNameToAttribute": [
+    {
+      "className": "oj-form-control-text-align-right",
+      "attribute": "textAlign",
+      "attributeValue": "right"
+    },
+    {
+      "className": "oj-form-control-text-align-start",
+      "attribute": "textAlign",
+      "attributeValue": "start"
+    },
+    {
+      "className": "oj-form-control-text-align-end",
+      "attribute": "textAlign",
+      "attributeValue": "end"
+    }
+  ],
+  "migrateAttributes": [
+    {
+      "fromAttribute": "translations.required.message-detail",
+      "fromValue": "",
+      "toAttribute": "required-message-detail",
+      "toValue": ""
+    },
+    {
+      "fromAttribute": "labeledge",
+      "fromValue": "provided",
+      "toAttribute": "labeledge",
+      "toValue": ""
+    }
+  ],
+  "ruleSetToIgnore": [
+    {
+      "attribute": "converter"
+    }
+  ]
+}

package/corePackMigrator/resource/astUtils.js

@@ -0,0 +1,6 @@
+/*
+ * Copyright (c) 2018, 2023, Oracle and/or its affiliates.
+ * Licensed under The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ */
+const estree=require("@typescript-eslint/typescript-estree");const traverse=require("ast-traverse");const logging=require("../utilities/logging");function _checkFileUpdate(){if(!global.fileIsUpdated){global.fileIsUpdated=true;global.migrationMetrics.files+=1;logging.logFilePath(global.filePath);return true}return false}function _generateAST(code){return estree.parse(code,{comment:true,filePath:global.filePath,jsx:true,loc:true,range:true})}function _commentJSXNode(text,locObj){let dataArray=text.split("\n");let{start,end}=locObj;let startString=dataArray[start.line-1];dataArray[start.line-1]=[startString.slice(0,start.column)," {/* ",startString.slice(start.column)].join("");let endString=dataArray[end.line-1];if(start.line===end.line){end.column+=5}dataArray[end.line-1]=[endString.slice(0,end.column)," */} ",endString.slice(end.column)].join("");text=dataArray.join("\n");return text}function _getText(text,locObj){let specificText;const dataArray=text.split("\n");const{start,end}=locObj;if(start.line===end.line){specificText=dataArray[start.line-1].substring(start.column,end.column);return specificText}else{dataArray[start.line-1]=dataArray[start.line-1].substring(start.column);const textByLines=dataArray.slice(start.line-1,end.line).map(s=>s.trim());specificText=textByLines.join("\n");return specificText}}function _updateText(text,locObj,replaceString){let replaceArray=replaceString.split("");let dataArray=text.split("\n");let{start,end}=locObj;if(start.line!=end.line){let firtLineArray=dataArray[locObj.start.line-1].split("");dataArray[locObj.start.line-1]=firtLineArray.splice(0,start.column).concat(...replaceArray).join("");for(let i=locObj.end.line-2;i>start.line-1;i--){dataArray[i]=""}let lastLineArray=dataArray[end.line-1].split("");dataArray[end.line-1]=lastLineArray.splice(end.column,end.column).join("")}else{let updateLineArray=dataArray[locObj.start.line-1].split("");updateLineArray.splice(locObj.start.column,locObj.end.column-locObj.start.column,...replaceArray);dataArray[locObj.start.line-1]=updateLineArray.join("")}text=dataArray.join("\n");return text}function _appendText(text,locObj,appendString){let appendArray=appendString.split("");let dataArray=text.split("\n");let updateLineArray=dataArray[locObj.end.line-1].split("");updateLineArray.splice(locObj.end.column+1,0,...appendArray);dataArray[locObj.end.line-1]=updateLineArray.join("");text=dataArray.join("\n");return text}function _getLabelFromASTDOMNode(astnode,code){let label="";for(let currentNode of astnode.children){if(currentNode.type=="JSXText"){if(/\S/.test(currentNode.value)){label=currentNode.value.trim()}}else if(currentNode.type=="JSXExpressionContainer"){if(currentNode.expression&&currentNode.expression.type!="JSXEmptyExpression"){expression=_getText(code,currentNode.loc);label={expression:expression}}}else if(currentNode.type=="JSXElement"&&currentNode.openingElement.name.name.toUpperCase()=="OJ-BIND-TEXT"){currentNode.openingElement.attributes.forEach(attr=>{if(attr.name.name=="value")label=attr.value.value})}else if(currentNode.children){label=_getLabelFromASTDOMNode(currentNode,code)}}return label}function _getLabelFromLegacyButton(astnode,slotName,code){for(let child of astnode.children){switch(child.type){case"JSXText":if(/\S/.test(child.value)){return{label:child.value.trim(),cnode:child}}break;case"JSXExpressionContainer":if(child.expression&&child.expression.type!="JSXEmptyExpression"){expression=_getText(code,child.loc);return{label:{expression:expression},cnode:child}}break;case"JSXElement":let slotValue;switch(child.openingElement.name.name.toUpperCase()){case"SPAN":case"DIV":child.openingElement.attributes.forEach(attr=>{if(attr.name.name=="slot"&&(attr.value.value===slotName||!attr.value.value.length))slotValue=true});if(!child.openingElement.attributes.map(att=>att.name.name).includes("slot")){slotValue=true}if(slotValue){let label=_getLabelFromASTDOMNode(child,code);return{label:label,cnode:child}}break}break}}}function _hasAttributesToIgnore(component,ignoreRuleData){if(ignoreRuleData&&component.attributes.length){for(let obj of ignoreRuleData){for(let i=0;i<component.attributes.length;i++){let attribute=component.attributes[i];if(obj.attribute&&obj.attribute===attribute.name.name){_checkFileUpdate();logging.logIgnoreComponent(component.name.name,obj.attribute);return true}let arr=Object.keys(obj);let key=arr[0];if(attribute.name.name===key&&attribute.value.value===obj[key]){_checkFileUpdate();logging.logIgnoreComponent(component.name.name,key,obj[key]);return true}}}}return false}function _hasExpressionAttributes(component,code,isPre=false){const excludedAttributes=global.configData.excludeAttributeExpressions[component.name.name];if(global.jaf.options.dryRunMode&&isPre){component.attributes.forEach(attribute=>{if(attribute.value&&attribute.value.type==="JSXExpressionContainer"){const expression=_getText(code,attribute.value.loc);if(_checkFileUpdate()){logging.logAttributeExpression(component.name.name,attribute.name.name,expression)}}})}if(excludedAttributes&&excludedAttributes.length){for(let exAtt of excludedAttributes){for(let i=0;i<component.attributes.length;i++){const attribute=component.attributes[i];if(exAtt===attribute.name.name&&attribute.value.type==="JSXExpressionContainer"){const expression=_getText(code,attribute.value.loc);if(isPre){_checkFileUpdate();logging.logExcludeAttributeExpression(component.name.name,exAtt,expression)}return true}}}}return false}function commentSlotContent(code,data,ignoreRuleData,componentName){let ast=_generateAST(code);traverse(ast,{pre:function(node){if(node.type=="JSXElement"&&node.openingElement.name.name===componentName&&(!_hasAttributesToIgnore(node.openingElement,ignoreRuleData)||global.configData.forceMigration.includes(componentName))&&!_hasExpressionAttributes(node.openingElement,code,true)){node.children.forEach(child=>{if(child.openingElement&&child.openingElement.attributes){child.openingElement.attributes.forEach(attribute=>{if(attribute.name.name=="slot"&&attribute.value.value==data.slot){code=_commentJSXNode(code,child.loc);_checkFileUpdate();logging.logCommentSlotContent(componentName,data.slot)}})}})}}});return code}function slotContentToAttribute(code,data,ignoreRuleData,componentName){if(data.attribute||data.slotName){let isUpdated=false;let ast=_generateAST(code);traverse(ast,{pre:function(node){if(!isUpdated&&node.type=="JSXElement"&&node.openingElement.name.name===componentName&&(!_hasAttributesToIgnore(node.openingElement,ignoreRuleData)||global.configData.forceMigration.includes(componentName))&&!_hasExpressionAttributes(node.openingElement,code,true)&&!node.openingElement.attributes.map(att=>att.name.name).includes(data.attribute)){let obj={line:node.openingElement.loc.end.line,column:node.openingElement.loc.end.column-1};const legacyButtonLabel=_getLabelFromLegacyButton(node,data.slotName,code);if(legacyButtonLabel){const{label,cnode}=legacyButtonLabel;if(label){code=_commentJSXNode(code,cnode.loc);code=_updateText(code,{start:obj,end:obj},` ${data.attribute}=${label.expression?`${label.expression}`:`"${label}"`}`);_checkFileUpdate()}logging.logSlotContentToAttribute(componentName,data.attribute,label.expression?label.expression:label);code=slotContentToAttribute(code,data,ignoreRuleData,componentName)}}},post:function(node){if(!isUpdated&&node.type=="JSXElement"&&node.openingElement.name.name===componentName&&(!_hasAttributesToIgnore(node.openingElement,ignoreRuleData)||global.configData.forceMigration.includes(componentName))&&!_hasExpressionAttributes(node.openingElement,code)&&!node.openingElement.attributes.map(att=>att.name.name).includes(data.attribute)){isUpdated=true}}})}return code}function classNameToAttribute(code,data){for(let obj of data){let isUpdated=false;let ast=_generateAST(code);traverse(ast,{pre:function(node){if(!isUpdated&&node.type=="JSXAttribute"&&node.name.name=="class"&&node.value?.value?.includes(obj.className)){if(obj.attribute){classNames=node.value.value.split(" ");index=classNames.indexOf(obj.className);classNames.splice(index,1);if(classNames.length===0){code=_updateText(code,node.loc,obj.attribute+"="+"\""+obj.attributeValue+"\"")}else{code=_updateText(code,node.loc,`class="${classNames.join(" ")}"`);node.loc.end.column-=obj.className.length+2;code=_appendText(code,node.loc,`\n${obj.attribute}="${obj.attributeValue}"`)}_checkFileUpdate();logging.logClassNameToAttribute(obj.className,obj.attribute,obj.attributeValue);code=classNameToAttribute(code,data)}}},post:function(node){if(!isUpdated&&node.type=="JSXAttribute"&&node.name.name=="class"&&node.value?.value?.includes(obj.className)){isUpdated=true}}})}return code}function handleSpecialCase(code,data){let obj;let regex;if(data[1]){obj=data[1];regex=new RegExp(obj.fromString.split(" ").join("\\s*"),"igm");code=code.replace(regex,obj.toString)}obj=data[0];regex=new RegExp(obj.fromString.split(" ").join("\\s*"),"igm");code=code.replace(regex,obj.toString);return code}function migrateTag(code,legacyComponentName,coreComponentName,ignoreRuleData){let isUpdated=false;let ast=_generateAST(code);traverse(ast,{pre:function(node){if(!isUpdated&&node.type=="JSXElement"&&node.openingElement.name.name===legacyComponentName&&(!_hasAttributesToIgnore(node.openingElement,ignoreRuleData)||global.configData.forceMigration.includes(legacyComponentName))&&!_hasExpressionAttributes(node.openingElement,code,true)){code=_updateText(code,node.openingElement.name.loc,coreComponentName);_checkFileUpdate();logging.logTagMigration(legacyComponentName,coreComponentName);global.migrationMetrics.components+=1;if(node.closingElement&&node.closingElement.name.name===legacyComponentName){if(node.openingElement.name.loc.start.line===node.closingElement.name.loc.start.line){const lengthDif=coreComponentName.length-node.closingElement.name.name.length;node.closingElement.name.loc.start.column+=lengthDif;node.closingElement.name.loc.end.column+=lengthDif}code=_updateText(code,node.closingElement.name.loc,coreComponentName)}code=migrateTag(code,legacyComponentName,coreComponentName,ignoreRuleData)}},post:function(node){if(!isUpdated&&node.type=="JSXElement"&&node.openingElement.name.name===legacyComponentName&&(!_hasAttributesToIgnore(node.openingElement,ignoreRuleData)||global.configData.forceMigration.includes(legacyComponentName))&&!_hasExpressionAttributes(node.openingElement,code)){isUpdated=true}}});return code}function migrateTagByAttribute(code,data,ignoreRuleData){for(const tagSet in data){let isUpdated=false;let ast=_generateAST(code);traverse(ast,{pre:function(node){tag=data[tagSet];if(!isUpdated&&node.type=="JSXElement"&&node.openingElement.name.name===tag.fromTag&&(!_hasAttributesToIgnore(node.openingElement,ignoreRuleData)||global.configData.forceMigration.includes(componentName))&&!_hasExpressionAttributes(node.openingElement,code,true)){node.openingElement.attributes.forEach(attribute=>{if(attribute.name.name===tag.attribute&&attribute.value.value===tag.attributeValue){code=_updateText(code,node.openingElement.name.loc,tag.toTag);_checkFileUpdate();logging.logTagMigration(tag.fromTag,tag.toTag);global.migrationMetrics.components+=1;if(node.closingElement&&node.closingElement.name.name===tag.fromTag){if(node.openingElement.name.loc.start.line===node.closingElement.name.loc.start.line){const lengthDif=tag.toTag.length-node.closingElement.name.name.length;node.closingElement.name.loc.start.column+=lengthDif;node.closingElement.name.loc.end.column+=lengthDif}code=_updateText(code,node.closingElement.name.loc,tag.toTag)}code=migrateTagByAttribute(code,data,ignoreRuleData)}})}},post:function(node){if(!isUpdated&&node.type=="JSXElement"&&node.openingElement.name.name===tag.fromTag&&(!_hasAttributesToIgnore(node.openingElement,ignoreRuleData)||global.configData.forceMigration.includes(componentName))&&!_hasExpressionAttributes(node.openingElement,code)){isUpdated=true}}})}return code}function migrateImports(code,importData,ruleSetToIgnore){if(importData){if(Array.isArray(importData.to)&&importData.to.some(s=>code.includes(s))||code.includes(importData.to)){if(Array.isArray(importData.to)){for(let i=0;i<importData.to.length;i++){if(new RegExp(`\nimport ('|")${importData.to[i]}('|")*`).test(code)){return code}}}else if(new RegExp(`\nimport ('|")${importData.to}('|")*`).test(code)){return code}}if(ruleSetToIgnore&&ruleSetToIgnore.length>0){if(Array.isArray(importData.to)&&importData.to.length>0){importData.to.forEach(toVal=>{let isUpdated=false;let ast=_generateAST(code);traverse(ast,{pre:function(node){if(!isUpdated&&node.type=="ImportDeclaration"&&node.source.value===importData.from&&!node.specifiers.length){code=_appendText(code,node.loc,`\nimport "${toVal}";`);_checkFileUpdate();logging.logImportAppend(importData.from,toVal);code=migrateImports(code,importData,ruleSetToIgnore)}},post:function(node){if(!isUpdated&&node.type=="ImportDeclaration"&&node.source.value===importData.from&&!node.specifiers.length){isUpdated=true}}})})}else{let isUpdated=false;let ast=_generateAST(code);traverse(ast,{pre:function(node){if(!isUpdated&&node.type=="ImportDeclaration"&&node.source.value===importData.from&&!node.specifiers.length){code=_appendText(code,node.loc,`\nimport "${importData.to}";`);_checkFileUpdate();logging.logImportAppend(importData.from,importData.to);code=migrateImports(code,importData,ruleSetToIgnore)}},post:function(node){if(!isUpdated&&node.type=="ImportDeclaration"&&node.source.value===importData.from&&!node.specifiers.length){isUpdated=true}}})}}else{if(Array.isArray(importData.to)&&importData.to.length>0){let isUpdated=false;let ast=_generateAST(code);traverse(ast,{pre:function(node){if(!isUpdated&&node.type=="ImportDeclaration"&&node.source.value===importData.from&&!node.specifiers.length){code=_updateText(code,node.loc,`import "${importData.to[0]}";`);_checkFileUpdate();logging.logImportUpdate(importData.from,importData.to);for(let i=1;i<importData.to.length;i++){node.loc.end.column=node.loc.end.column+`"${importData.to[i-1]}"`.length;code=_appendText(code,node.loc,`\nimport "${importData.to[i]}";`);_checkFileUpdate();logging.logImportAppend(importData.from,importData.to[i]);code=migrateImports(code,importData,ruleSetToIgnore)}}},post:function(node){if(!isUpdated&&node.type=="ImportDeclaration"&&node.source.value===importData.from&&!node.specifiers.length){isUpdated=true}}})}else{let ast=_generateAST(code);traverse(ast,{pre:function(node){if(node.type=="ImportDeclaration"&&!node.specifiers.length&&node.source.value===importData.from){code=_updateText(code,node.loc,`import "${importData.to}";`);_checkFileUpdate();logging.logImportUpdate(importData.from,importData.to);code=migrateImports(code,importData,ruleSetToIgnore)}}})}}return code}}function migrateAttributes(code,data,ignoreRuleData,componentName){if(data&&data.length>0){for(const attributeSet in data){let isUpdated=false;let ast=_generateAST(code);traverse(ast,{pre:function(node){if(!isUpdated&&node.type==="JSXElement"&&node.openingElement.name.name===componentName&&(!_hasAttributesToIgnore(node.openingElement,ignoreRuleData)||global.configData.forceMigration.includes(componentName))){let component=node.openingElement;let attObj=data[attributeSet];let hasDepAttribute=true;if(attObj.depAttribute){hasDepAttribute=component.attributes.map(att=>att.name.name).includes(attObj.depAttribute)}const hasToAttribute=component.attributes.map(att=>att.name.name).includes(attObj.toAttribute);component.attributes.forEach(attribute=>{const hasFromAttribute=attObj.fromValue?attribute.name.name===attObj.fromAttribute&&attribute.value.value===attObj.fromValue:attribute.name.name===attObj.fromAttribute;if(hasDepAttribute&&hasFromAttribute&&attObj.toAttribute){if(attObj.toValue){code=_updateText(code,attribute.loc,` ${attObj.toAttribute}="${attObj.toValue}" `);_checkFileUpdate();logging.logAttributeMigration(attObj.fromAttribute,attObj.fromValue,attObj.toAttribute,attObj.toValue)}else{const attValue=attribute.value.value||{expression:_getText(code,attribute.value.loc)};code=_updateText(code,attribute.loc,` ${attObj.toAttribute}=${attValue.expression||`"${attValue}"`} `);_checkFileUpdate();logging.logAttributeMigration(attObj.fromAttribute,attValue.expression||attValue,attObj.toAttribute,attValue.expression||attValue)}code=migrateAttributes(code,data,ignoreRuleData,componentName)}else if(hasDepAttribute&&hasFromAttribute&&!attObj.toAttribute){code=_updateText(code,attribute.loc,"");_checkFileUpdate();logging.logAttributeDeprecation(attObj.fromAttribute,attObj.fromValue);code=migrateAttributes(code,data,ignoreRuleData,componentName)}});if(hasDepAttribute&&!attObj.fromAttribute&&attObj.toAttribute&&!hasToAttribute){code=_appendText(code,node.openingElement.name.loc,` ${attObj.toAttribute}="${attObj.toValue}" `);_checkFileUpdate();logging.logAttributeAddition(attObj.toAttribute,attObj.toValue);code=migrateAttributes(code,data,ignoreRuleData,componentName)}}},post:function(node){if(!isUpdated&&node.type==="JSXElement"&&node.openingElement.name.name===componentName&&(!_hasAttributesToIgnore(node.openingElement,ignoreRuleData)||global.configData.forceMigration.includes(componentName))){isUpdated=true}}})}return code}}exports.commentSlotContent=commentSlotContent;exports.slotContentToAttribute=slotContentToAttribute;exports.classNameToAttribute=classNameToAttribute;exports.handleSpecialCase=handleSpecialCase;exports.migrateImports=migrateImports;exports.migrateTag=migrateTag;exports.migrateTagByAttribute=migrateTagByAttribute;exports.migrateAttributes=migrateAttributes;

package/corePackMigrator/resource/componentMigrator.js

@@ -0,0 +1,6 @@
+/*
+ * Copyright (c) 2018, 2023, Oracle and/or its affiliates.
+ * Licensed under The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ */
+"use strict";var fs=require("fs");const utils=require("./htmlUtils");const astUtils=require("./astUtils");function migrateHTML(filePath,componentMetadata){let text=fs.readFileSync(filePath,{encoding:"utf8",flag:"r"});const COMPONENT_NAME=componentMetadata.legacyTag;for(let key in componentMetadata){if(typeof utils[key]=="function"&&key!=="migrateTagByAttribute"){text=utils[key](text,COMPONENT_NAME,componentMetadata[key],componentMetadata.ruleSetToIgnore)}}if(componentMetadata["migrateTagByAttribute"]){text=utils["migrateTagByAttribute"](text,componentMetadata.legacyTag,componentMetadata["migrateTagByAttribute"],componentMetadata.ruleSetToIgnore)}else{text=utils["migrateTag"](text,componentMetadata.legacyTag,componentMetadata.corePackTag,componentMetadata.ruleSetToIgnore)}if(!global.jaf.options.dryRunMode&&global.fileIsUpdated){fs.writeFileSync(filePath,text,err=>{if(err){console.error(err)}})}}function migrateTSX(filePath,componentMetadata){let code=fs.readFileSync(filePath,{encoding:"utf8",flag:"r"});const COMPONENT_NAME=componentMetadata.legacyTag;for(let key in componentMetadata){if(typeof astUtils[key]=="function"&&key!=="migrateTagByAttribute"){code=astUtils[key](code,componentMetadata[key],componentMetadata.ruleSetToIgnore,COMPONENT_NAME)}}if(componentMetadata["migrateTagByAttribute"]){code=astUtils["migrateTagByAttribute"](code,componentMetadata["migrateTagByAttribute"],componentMetadata.ruleSetToIgnore)}else{code=astUtils["migrateTag"](code,componentMetadata.legacyTag,componentMetadata.corePackTag,componentMetadata.ruleSetToIgnore)}const importToData=componentMetadata.migrateImports.to;if(code.includes(componentMetadata.corePackTag)&&(Array.isArray(importToData)&&!importToData.some(s=>code.includes(s))||!code.includes(importToData))){if(Array.isArray(importToData)){importToData.forEach(toImport=>{code=`import "${toImport}";\n`+code})}else{code=`import "${importToData}";\n`+code}}if(!global.jaf.options.dryRunMode&&global.fileIsUpdated){fs.writeFileSync(filePath,code,err=>{if(err){console.error(err)}})}}exports.migrateHTML=migrateHTML;exports.migrateTSX=migrateTSX;

package/corePackMigrator/resource/fileScanner.js

@@ -0,0 +1,6 @@
+/*
+ * Copyright (c) 2018, 2023, Oracle and/or its affiliates.
+ * Licensed under The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ */
+const path=require("path");const fs=require("fs");const fileSets={};function getConfigData(sourcePath){try{if(!fs.existsSync(sourcePath)){return}if(sourcePath.toLowerCase().includes("migrationconfig.json")){let text=fs.readFileSync(sourcePath,{encoding:"utf8",flag:"r"});return JSON.parse(text)}}catch(error){console.log("Error: "+error.stack);process.exit(0)}}function scanForFiles(startPath){let{excludeFolders,fileTypes,excludeFiles}=global.configData;const regex=new RegExp(`.(${fileTypes.map(i=>"."+i).join("|")})$`,"i");try{if(!fs.existsSync(startPath)){return}let files=fs.readdirSync(startPath);for(let i=0;i<files.length;i++){let filename=path.join(startPath,files[i]);let stat=fs.lstatSync(filename);if(stat.isDirectory()){if(!excludeFolders.includes(filename)){scanForFiles(filename)}}else{if(!excludeFiles.includes(filename)){let info=regex.exec(filename);if(info&&info["index"]){if(fileSets[info[1]]){fileSets[info[1]].push(filename)}else{fileSets[info[1]]=[filename]}}}}}return fileSets}catch(error){console.log("Error: "+error.stack);process.exit(0)}}exports.scanForFiles=scanForFiles;exports.getConfigData=getConfigData;

package/corePackMigrator/resource/htmlUtils.js

@@ -0,0 +1,6 @@
+/*
+ * Copyright (c) 2018, 2023, Oracle and/or its affiliates.
+ * Licensed under The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ */
+const{parseDocument,DomUtils}=require("htmlparser2");const render=require("dom-serializer").default;const logging=require("../utilities/logging");function _checkFileUpdate(){if(!global.fileIsUpdated){global.fileIsUpdated=true;global.migrationMetrics.files+=1;logging.logFilePath(global.filePath);return true}return false}function _getLabelFromDOMNode(node,slotName){let label;let cnode;if(node&&node.children&&!!node.children.length){for(let child of node.children){if(child.type&&child.type=="text"){if(/\S/.test(child.data)){label=child.data.trim();cnode=_getDom("<!-- "+render(child,{decodeEntities:false})+" -->");DomUtils.replaceElement(child,cnode);break}}else if(child.type&&child.type=="tag"&&child.name.toUpperCase()=="OJ-BIND-TEXT"&&(!slotName&&!child.attribs.slot||slotName&&child.attribs.slot===slotName)){label=child.attribs.value;cnode=_getDom("<!-- "+render(child,{decodeEntities:false})+" -->");DomUtils.replaceElement(child,cnode);break}else if(child.children&&!!child.children.length){label=_getLabelFromDOMNode(child,slotName)}}}return label}function _getDom(text=""){return parseDocument(text,{withStartIndices:true,withEndIndices:true})}function _filterComponentsByIgnoreRule(components,ignoreRuleData){let obj;components=components.filter(component=>{for(let i=0;i<ignoreRuleData.length;i++){obj=ignoreRuleData[i];let arr=Object.keys(obj);let key=arr[0];if(obj[key].includes(component.attribs[key])){_checkFileUpdate();logging.logIgnoreComponent(component.name,key,obj[key]);return false}else{for(let child of component.children){if(child.attribs&&obj[key].includes(child.attribs[key])){_checkFileUpdate();logging.logIgnoreComponent(child.name,key,obj[key]);return false}}}}return true});return components}function _filterComponentsAttributeExpressions(components,componentName){const excludedAttributes=global.configData.excludeAttributeExpressions[componentName];const regex=new RegExp(`((\\{\\{)|(\\[\\[)).*((\\}\\})|(\\]\\]))`);components=components.filter(component=>{if(global.jaf.options.dryRunMode){for(const attribute in component.attribs){if(regex.test(component.attribs[attribute])){if(_checkFileUpdate()){logging.logAttributeExpression(component.name,attribute,component.attribs[attribute])}}}}if(excludedAttributes&&excludedAttributes.length){for(let i=0;i<excludedAttributes.length;i++){if(component.attribs[`:${excludedAttributes[i]}`]){excludedAttributes[i]=`:${excludedAttributes[i]}`}if(regex.test(component.attribs[excludedAttributes[i]])){_checkFileUpdate();logging.logExcludeAttributeExpression(componentName,excludedAttributes[i],component.attribs[excludedAttributes[i]]);return false}}}return true});return components}function commentSlotContent(text,componentName,data,ignoreRuleData){let slotValue=data.slot;const dom=_getDom(text);let components=DomUtils.getElementsByTagName(componentName,dom);if(ignoreRuleData&&!global.configData.forceMigration.includes(componentName))components=_filterComponentsByIgnoreRule(components,ignoreRuleData);components=_filterComponentsAttributeExpressions(components,componentName);components.forEach(component=>{component.children.forEach(child=>{if(child.name&&child.attribs.slot==slotValue){let cnode=_getDom("<!-- "+render(child,{decodeEntities:false})+" -->");DomUtils.replaceElement(child,cnode);_checkFileUpdate();logging.logCommentSlotContent(component.name,slotValue,child.name)}})});return render(dom,{decodeEntities:false})}function slotContentToAttribute(text,componentName,data,ignoreRuleData){const dom=_getDom(text);let components=DomUtils.getElementsByTagName(componentName,dom);if(ignoreRuleData&&!global.configData.forceMigration.includes(componentName))components=_filterComponentsByIgnoreRule(components,ignoreRuleData);components=_filterComponentsAttributeExpressions(components,componentName);components.forEach(component=>{if(!Object.keys(component.attribs).includes(data.attribute)){component.attribs[data.attribute]=_getLabelFromDOMNode(component,data.slotName);if(!component.attribs[data.attribute]){delete component.attribs[data.attribute]}_checkFileUpdate();logging.logSlotContentToAttribute(component.name,data.attribute,component.attribs[data.attribute])}});return render(dom,{decodeEntities:false})}function migrateTag(text,legacyComponentName,coreComponentName,ignoreRuleData){if(!coreComponentName)return text;const dom=_getDom(text);let components=DomUtils.getElementsByTagName(legacyComponentName,dom);if(ignoreRuleData&&!global.configData.forceMigration.includes(legacyComponentName))components=_filterComponentsByIgnoreRule(components,ignoreRuleData);components=_filterComponentsAttributeExpressions(components,legacyComponentName);components.forEach(component=>{component.name=coreComponentName;_checkFileUpdate();logging.logTagMigration(legacyComponentName,coreComponentName);global.migrationMetrics.components+=1});return render(dom,{decodeEntities:false})}function migrateTagByAttribute(text,componentName,data,ignoreRuleData){const dom=_getDom(text);let components=DomUtils.getElementsByTagName(componentName,dom);if(ignoreRuleData&&!global.configData.forceMigration.includes(componentName))components=_filterComponentsByIgnoreRule(components,ignoreRuleData);components=_filterComponentsAttributeExpressions(components,componentName);components.forEach(component=>{for(const tagSet in data){tag=data[tagSet];hasAttAndVal=tag.attributeValue===DomUtils.getAttributeValue(component,tag.attribute);if(hasAttAndVal){component.name=tag.toTag;_checkFileUpdate();logging.logTagMigration(componentName,tag.toTag);global.migrationMetrics.components+=1}}});return render(dom,{decodeEntities:false})}function classNameToAttribute(text,componentName,data,ignoreRuleData){const dom=_getDom(text);let components=DomUtils.getElementsByTagName(componentName,dom);let classNames;let index;if(ignoreRuleData&&!global.configData.forceMigration.includes(componentName))components=_filterComponentsByIgnoreRule(components,ignoreRuleData);components=_filterComponentsAttributeExpressions(components,componentName);data.forEach(obj=>{let from=obj.className;let to=obj.attributeValue;let attribute=obj.attribute;components.forEach(component=>{if(component.attribs.class){classNames=component.attribs.class.split(" ");index=classNames.indexOf(from);if(index!=-1&&attribute){classNames.splice(index,1);if(classNames.length==0)delete component.attribs.class;else component.attribs.class=classNames.join(" ");component.attribs[attribute]=to;_checkFileUpdate();logging.logClassNameToAttribute(from,attribute,to)}}})});return render(dom,{decodeEntities:false})}function migrateAttributes(text,componentName,data,ignoreRuleData){const dom=_getDom(text);let components=DomUtils.getElementsByTagName(componentName,dom);let obj;if(ignoreRuleData&&!global.configData.forceMigration.includes(componentName))components=_filterComponentsByIgnoreRule(components,ignoreRuleData);components=_filterComponentsAttributeExpressions(components,componentName);for(const attributeName in data){obj=data[attributeName];components.forEach(component=>{let hasDepAttribute=true;if(obj.depAttribute){hasDepAttribute=DomUtils.hasAttrib(component,obj.depAttribute)}const hasFromAttribute=obj.fromValue?obj.fromValue===DomUtils.getAttributeValue(component,obj.fromAttribute):DomUtils.hasAttrib(component,obj.fromAttribute);const hasToAttribute=DomUtils.hasAttrib(component,obj.toAttribute);if(hasDepAttribute&&hasFromAttribute&&obj.toAttribute){if(obj.toValue){component.attribs[obj.toAttribute]=obj.toValue;_checkFileUpdate();logging.logAttributeMigration(obj.fromAttribute,obj.fromValue,obj.toAttribute,obj.toValue)}else{component.attribs[obj.toAttribute]=component.attribs[obj.fromAttribute];_checkFileUpdate();logging.logAttributeMigration(obj.fromAttribute,component.attribs[obj.fromAttribute],obj.toAttribute,component.attribs[obj.fromAttribute])}delete component.attribs[obj.fromAttribute]}else if(hasDepAttribute&&hasFromAttribute&&!obj.toAttribute){delete component.attribs[obj.fromAttribute];_checkFileUpdate();logging.logAttributeDeprecation(obj.fromAttribute,obj.fromValue)}else if(hasDepAttribute&&!obj.fromAttribute&&obj.toAttribute&&!hasToAttribute){component.attribs[obj.toAttribute]=obj.toValue;_checkFileUpdate();logging.logAttributeAddition(obj.toAttribute,obj.toValue)}})}return render(dom,{decodeEntities:false})}function handleSpecialCase(code,componentName,data){let obj;let regex;if(data[1]){obj=data[1];regex=new RegExp(obj.fromString.split(" ").join("\\s*"),"igm");code=code.replace(regex,obj.toString)}obj=data[0];regex=new RegExp(obj.fromString.split(" ").join("\\s*"),"igm");code=code.replace(regex,obj.toString);return code}exports.slotContentToAttribute=slotContentToAttribute;exports.commentSlotContent=commentSlotContent;exports.migrateTag=migrateTag;exports.classNameToAttribute=classNameToAttribute;exports.handleSpecialCase=handleSpecialCase;exports.migrateAttributes=migrateAttributes;exports.migrateTagByAttribute=migrateTagByAttribute;

package/corePackMigrator/resource/manifest.json

@@ -0,0 +1,102 @@
+[
+  {
+    "componentName": "oj-button",
+    "metadata": "buttonMetadata",
+    "migrationApiLink": "https://jet.oraclecorp.com/trunk/jsdocs/oj.ojButton.html#migration-section"
+  },
+  {
+    "componentName": "oj-avatar",
+    "metadata": "avatarMetadata",
+    "migrationApiLink": "https://jet.oraclecorp.com/trunk/jsdocs/oj.ojAvatar.html#migration-section"
+  },
+  {
+    "componentName": "oj-collapsible",
+    "metadata": "collapsibleMetadata",
+    "migrationApiLink": "https://jet.oraclecorp.com/trunk/jsdocs/oj.ojCollapsible.html#migration-section"
+  },
+  {
+    "componentName": "oj-messages",
+    "metadata": "messagesMetadata",
+    "migrationApiLink": "https://jet.oraclecorp.com/trunk/jsdocs/oj.ojMessages.html#migration-section"
+  },
+  {
+    "componentName": "oj-file-picker",
+    "metadata": "filePickerMetadata",
+    "migrationApiLink": "https://jet.oraclecorp.com/trunk/jsdocs/oj.ojFilePicker.html#migration-section"
+  },
+  {
+    "componentName": "oj-list-item-layout",
+    "metadata": "listItemLayoutMetadata",
+    "migrationApiLink": "https://jet.oraclecorp.com/trunk/jsdocs/oj.ojListItemLayout.html#migration-section"
+  },
+  {
+    "componentName": "oj-progress-circle",
+    "metadata": "progressCircleMetadata",
+    "migrationApiLink": "https://jet.oraclecorp.com/trunk/jsdocs/oj.ojProgressCircle.html#migration-section"
+  },
+  {
+    "componentName": "oj-progress-bar",
+    "metadata": "progressBarMetadata",
+    "migrationApiLink": "https://jet.oraclecorp.com/trunk/jsdocs/oj.ojProgressBar.html#migration-section"
+  },
+  {
+    "componentName": "oj-rating-gauge",
+    "metadata": "ratingGaugeMetadata",
+    "migrationApiLink": "https://jet.oraclecorp.com/trunk/jsdocs/oj.ojRatingGauge.html#migration-section"
+  },
+  {
+    "componentName": "oj-input-number",
+    "metadata": "inputNumberMetadata",
+    "migrationApiLink": "https://jet.oraclecorp.com/trunk/jsdocs/oj.ojInputNumber.html#migration-section"
+  },
+  {
+    "componentName": "oj-input-password",
+    "metadata": "inputPasswordMetadata",
+    "migrationApiLink": "https://jet.oraclecorp.com/trunk/jsdocs/oj.ojInputPassword.html#migration-section"
+  },
+  {
+    "componentName": "oj-input-text",
+    "metadata": "inputTextMetadata",
+    "migrationApiLink": "https://jet.oraclecorp.com/trunk/jsdocs/oj.ojInputText.html#migration-section"
+  },
+  {
+    "componentName": "oj-text-area",
+    "metadata": "textAreaMetadata",
+    "migrationApiLink": "https://jet.oraclecorp.com/trunk/jsdocs/oj.ojTextArea.html#migration-section"
+  },
+  {
+    "componentName": "oj-list-view",
+    "metadata": "listViewMetadata",
+    "migrationApiLink": "https://jet.oraclecorp.com/trunk/jsdocs/oj.ojListView.html#migration-section"
+  },
+  {
+    "componentName": "oj-select-single",
+    "metadata": "selectSingleMetadata",
+    "migrationApiLink": "https://jet.oraclecorp.com/trunk/jsdocs/oj.ojSelectSingle.html#migration-section"
+  },
+  {
+    "componentName": "oj-select-many",
+    "metadata": "selectManyMetadata",
+    "migrationApiLink": "https://jet.oraclecorp.com/trunk/jsdocs/oj.ojSelectMany.html#migration-section"
+  },
+  {
+    "componentName": "oj-status-meter-gauge",
+    "metadata": "statusMeterGaugeMetadata",
+    "migrationApiLink": "https://jet.oraclecorp.com/trunk/jsdocs/oj.ojStatusMeterGauge.html#migration-section"
+  },
+  {
+    "componentName": "oj-legend",
+    "metadata": "legendMetadata",
+    "migrationApiLink": "https://jet.oraclecorp.com/trunk/jsdocs/oj.ojLegend.html#migration-section"
+  },
+  {
+    "componentName": "oj-legend-item",
+    "metadata": "legendItemMetadata",
+    "migrationApiLink": "https://jet.oraclecorp.com/trunk/jsdocs/oj.ojLegend.html#migration-section"
+  },
+  {
+    "componentName": "oj-legend-section",
+    "metadata": "legendSectionMetadata",
+    "migrationApiLink": "https://jet.oraclecorp.com/trunk/jsdocs/oj.ojLegend.html#migration-section"
+  }
+]

package/corePackMigrator/resource/migrationConfig.json

@@ -0,0 +1,21 @@
+{
+  "excludeFolders": [
+    ".tscache",
+    ".vs",
+    ".vscode",
+    ".yarn",
+    "build",
+    "built",
+    "dt",
+    "node_modules",
+    "packages",
+    "sandbox",
+    "scripts",
+    "web"
+  ],
+  "fileTypes": ["ts", "js", "tsx", "html", "jsx", "json", "css"],
+  "excludeFiles": [],
+  "excludeComponents": [],
+  "forceMigration": [],
+  "excludeAttributeExpressions": {}
+}

package/corePackMigrator/templates/componentMetaData.json

@@ -0,0 +1,119 @@
+{
+  "description": "Requires Legacy and the Core Pack tag details.",
+  "legacyTag": "",
+  "corePackTag": "",
+  "migrateImports": {
+    "description": "Action to migrate the import statements from legacy to core pack for the components in .ts, .js, .tsx, and .json files
+                            from	: the legacy component import statement	: string
+                            to	: the core pack component import statement	: string or array or strings",
+    "from": "legacyImport",
+    "to": "corePackImport"
+  },
+  "migrateImports": {
+    "description": "Action to migrate the import statements from legacy to core pack for the components in .ts, .js, .tsx, and .json files
+                            from	the legacy component import statement	: string
+                            to	the core pack component import statement :	string or array or strings",
+    "from": "legacyImport",
+    "to": ["corePackImport", "corePackImport"]
+  },
+  "migrateTagByAttribute": [
+    {
+      "description": "Action migrates the component tag from legacy to core pack only if the legacy component contains a specific attribute/value 
+                            fromTag	: Legacy tag : string
+                            toTag	: Core pack tag	: string
+                            attribute : Attribute name that would decide the core pack tag	: string
+                            attributeValue : Attribute value that would decide the core pack tag	: string",
+      "fromTag": "legacyTag",
+      "toTag": "corePackTag",
+      "attribute": "attribute",
+      "attributeValue": "attributeValue"
+    },
+    {
+      "description": "Action migrates the component tag from legacy to core pack only if the legacy component contains a specific attribute/value 
+                            fromTag	: Legacy tag : string
+                            toTag	: Core pack tag	: string
+                            attribute :	Attribute name that would decide the core pack tag	: string
+                            attributeValue	: Attribute value that would decide the core pack tag	: string",
+      "fromTag": "legacyTag",
+      "toTag": "corePackTag",
+      "attribute": "attribute",
+      "attributeValue": "attributeValue"
+    }
+  ],
+  "slotContentToAttribute": {
+    "description": "Action to move content from a slot and assign the value of a specified attribute. 
+                            slotName	: The value of the specified slot will be added to the attribute provided	: string
+                            attribute	: Core pack attribute that will be added with the value from the slot	: string",
+    "slotName": "",
+    "attribute": ""
+  },
+  "commentSlotContent": {
+    "description": "Action to comment out a specific slot's content including the slot tag. 
+                            slotName : list all the slot names that should be commented in the core pack code. : string ",
+    "slotName": ""
+  },
+  "classNameToAttribute": [
+    {
+      "description": "Action to migrate a class defined on a component in legacy to a specific attribute value pair in the core pack.
+                            className	: information of class that now would migrate to attribute/value pair	: string
+                            attribute	: Core pack attribute	: string
+                            attributeValue	: Core pack attribute's value : string",
+      "className": "",
+      "attribute": "",
+      "attributeValue": ""
+    },
+    {
+      "description": "Action to migrate a class defined on a component in legacy to a specific attribute value pair in the core pack.
+                            className	: information of class that now would migrate to attribute/value pair	: string
+                            attribute	: Core pack attribute	: string
+                            attributeValue	: Core pack attribute's value : string",
+      "className": "",
+      "attribute": "",
+      "attributeValue": ""
+    }
+  ],
+  "migrateAttributes": [
+    {
+      "description": "Action updates the attribute/value pair with a different attribute/ value pair. If the "To" attribute/value pair is not provided then the legacy attribute/value is removed.
+                            depAttribute	: Dependency attribute	: string
+                            depValue	: Dependency attribute value	: string
+                            fromAttribute	: Legacy attribute	: string
+                            fromValue	: Legacy attribute value	: string
+                            toAttribute	: Core Pack attribute	: string
+                            toValue	: Core Pack attribute value	: string",
+      "depAttribute": "attribute",
+      "depValue": "attributeValue",
+      "fromAttribute": "attribute",
+      "fromValue": "attributeValue",
+      "toAttribute": "attribute",
+      "toValue": "attributeValue"
+    },
+    {
+      "description": "Action updates the attribute/value pair with a different attribute/ value pair. If the "To" attribute/value pair is not provided then the legacy attribute/value is removed.
+                            depAttribute	: Dependency attribute	: string
+                            depValue	: Dependency attribute value	: string
+                            fromAttribute	: Legacy attribute	: string
+                            fromValue	: Legacy attribute value	: string
+                            toAttribute	: Core Pack attribute	: string
+                            toValue	: Core Pack attribute value	: string",
+      "fromAttribute": "attribute",
+      "fromValue": "attributeValue",
+      "toAttribute": "attribute",
+      "toValue": "attributeValue"
+    }
+  ],
+  "ruleSetToIgnore": [
+    {
+      "description": "Defines the rule set that can contain a slot or attribute that will cause functionally breaking change and will be ignored as part of the migration
+                            slot : Migration will be skipped if the specified slot exists in the legacy code	: string
+                            attribute	: Migration will be skipped if the specified attribute exists in the legacy code	: string",
+      "slotName": ""
+    },
+    {
+      "description": "Defines the rule set that can contain a slot or attribute that will cause functionally breaking change and will be ignored as part of the migration
+                            slot : Migration will be skipped if the specified slot exists in the legacy code	: string
+                            attribute	: Migration will be skipped if the specified attribute exists in the legacy code	: string",
+      "attribute": ""
+    }
+  ]
+}

package/corePackMigrator/templates/migrationConfig.json

@@ -0,0 +1,17 @@
+{
+  "description": "migrationConfig.json can be used by the USER to fine tune the operations and behavior of the Migration Framework
+                      excludeFolder : The Array contains folder names that the migration framework will skip. The full path for the file name should be provided.
+                      excludeFiles : The Array contains file names that the migration framework will skip. The full path for the file name should be provided.
+                      excludeComponents : The Array contains Legacy component tags that the migration framework will skip migration
+                      forceMigration : The Array contains Legacy component tags for which the IgnoreRuleSet will be ignored and tag will be migrated to core pack
+                      excludeAttributeExpressions : The object contains component specific attributes that should not be migrated if contains a expression as value",
+  "excludeFolders": [],
+  "excludeFiles": [],
+  "excludeComponents": [],
+  "forceMigration": [],
+  "excludeAttributeExpressions" : 
+  {
+    "legacyTag1": ["attributes"],
+    "legacyTag2": ["attributes"]
+  }
+}

package/corePackMigrator/utilities/logging.js

@@ -0,0 +1,6 @@
+/*
+ * Copyright (c) 2018, 2023, Oracle and/or its affiliates.
+ * Licensed under The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ */
+function consoleLog(text){global.jaf.log.console(text)}function logMessage(text){global.jaf.log.msg(text)}function logFilePath(filepath){global.jaf.log.msg(`\nMigrating in: ${filepath}`)}function logImportUpdate(from,to){global.jaf.log.msg(`\tImport: Updated from "${from}" to "${to}"`)}function logImportAppend(from,to){global.jaf.log.msg(`\tImport: Appended "${to}" to "${from}"`)}function logTagMigration(from,to){global.jaf.log.msg(`\tTag migrated from "${from}" to "${to}"`)}function logClassNameToAttribute(className,attribute,value){global.jaf.log.msg(`\tClass name of "${className}" migrated to "${attribute}" attribute with value of "${value}"`)}function logAttributeMigration(fromAtt,fromVal,toAtt,toVal){global.jaf.log.msg(`\tAttribute migrated from "${fromAtt}" with a value of "${fromVal}" to "${toAtt}" with a value of "${toVal}"`)}function logAttributeDeprecation(from,fromVal){global.jaf.log.msg(`\tAttribute deprecated, removed "${from}" ${fromVal?`with a value of "${fromVal}"`:""}`)}function logAttributeAddition(toAtt,toVal){global.jaf.log.msg(`\tAttribute added, "${toAtt}" with a value of "${toVal}"`)}function logIgnoreComponent(component,attribute,value){global.jaf.log.msg(`\tRule to ignore: "${component}" filtered out due to attribute "${attribute}" ${value?`with value of "${value}"`:""}`)}function logCommentSlotContent(component,value,child){global.jaf.log.msg(`\tCommented out ${component}`);global.jaf.log.msg(`\t\t${child?`has ${child}`:""} with "slot" attribute having value of "${value}"`)}function logSlotContentToAttribute(component,attribute,value){value?global.jaf.log.msg(`\tSlot migrated: "${component}" added attribute "${attribute}" with value of "${value}"`):global.jaf.log.msg(`\tSlot migration ignored: "${component}" did not add attribute "${attribute}" due to value of "${value}"`)}function logAttributeExpression(component,attribute,value){global.jaf.log.msg(`\tAttribute expression: "${component}" has attribute "${attribute}" with value as expression of "${value}"`)}function logExcludeAttributeExpression(component,attribute,value){global.jaf.log.msg(`\tMigration skipped: "${component}" has attribute "${attribute}" with value as expression of "${value}"`)}exports.consoleLog=consoleLog;exports.logMessage=logMessage;exports.logFilePath=logFilePath;exports.logImportUpdate=logImportUpdate;exports.logImportAppend=logImportAppend;exports.logTagMigration=logTagMigration;exports.logClassNameToAttribute=logClassNameToAttribute;exports.logAttributeMigration=logAttributeMigration;exports.logAttributeDeprecation=logAttributeDeprecation;exports.logAttributeAddition=logAttributeAddition;exports.logIgnoreComponent=logIgnoreComponent;exports.logCommentSlotContent=logCommentSlotContent;exports.logSlotContentToAttribute=logSlotContentToAttribute;exports.logAttributeExpression=logAttributeExpression;exports.logExcludeAttributeExpression=logExcludeAttributeExpression;