@oracle/oraclejet-audit 11.1.3 → 12.1.0

package/types/index.d.ts

@@ -287,6 +287,7 @@
   export interface ElementListenerContext extends AuditListenerContext {
     tag: string,
     node: DomNode,
+    tagNode: DomNode,
     position: {line?:number, col?:number, start?:number, end?:number},
     elemStack: Array<DomNode>,
     ojTag: boolean,
@@ -417,6 +418,13 @@
     index:number
   }
 
+  export interface AttribPos {
+    row: number,
+    col: number,
+    start: number,
+    end: number
+  }
+
 
 
   // Interfaces for utility classes available to audit authors -----------------------------------
@@ -522,15 +530,25 @@
     getSiblings(node: DomNode): Array<DomNode>,
     getAttribs(node: DomNode): DomNodeAttribs,
     getAttribValue(node: DomNode, attrName: string): string,
+    getAttribPosition(data: string, node: DomNode, attrName: string): AttribPos,
+    getAttribValuePosition(data: string, node: DomNode, attrName: string): AttribPos,
+    getAttribIndex(data: string, node: DomNode, attrName: string): number,
     hasAttrib(node: DomNode, attrName: string): boolean,
     hasChildren(node: DomNode): boolean,
     hasNext(node: DomNode): boolean,
     getFirst(): DomNode,
     getFirstElement(): DomNode,
     getLast(): DomNode,
+    getBody(): DomNode,
+    getHead(): DomNode,
+    getLinks(): Array<DomNode>,
+    getScripts(): Array<DomNode>,
     getElemsByName(elemName: string): Array<DomNode>,
     getElemById(id: string): DomNode,
-    getElems(): Array<DomNode>
+    getElems(): Array<DomNode>,
+
+    isExpression(val: string): boolean,
+    getExpression(val: string): string|null
   }
 
   /**
@@ -547,7 +565,8 @@
     isTagAttrValue(tag:string, attrName:string, value:string):boolean,
     hasTagAttrValues(tag:string, attrName:string):boolean,
     hasTagSlot(tag:string):boolean,
-    isTagSlotValue(tag:string, slotValue:string):boolean,
+    isTagSlotName(tag:string, slotName:string):boolean,
+    isTagSlotValue(tag:string, slotValue:string):boolean,     // DEPRECATED
     isTagEvent(tag:string, eventName:string):boolean,
     isTagSupportedInTheme(tag:string):boolean,
     isAttrSupportedInTheme(tag:string, attrName:string):boolean,
@@ -622,86 +641,107 @@
     [parameterName:string]:string
   }
   export interface AstNodeTypeExports {
-    ARRAY_EXPR               : string,
-    ARROW_FUNC_EXPR          : string,
-    ASSIGN_PATTERN           : string,
-    ASSIGN_EXPR              : string,
-    ASSIGNMENT_EXPR          : string,
-    AWAIT_EXPR               : string,
-    BINARY_EXPR              : string,
-    BLOCK_STMT               : string,
-    BREAK_STMT               : string,
-    CALL_EXPR                : string,
-    CATCH_CLAUSE             : string,
-    CLASS_BODY               : string,
-    CLASS_DECLARATION        : string,
-    CLASS_EXPR               : string,
-    CONDITIONAL_EXPR         : string,
-    CONTINUE_STMT            : string,
-    DO_WHILE_STMT            : string,
-    DEBUG_STMT               : string,
-    EMPTY_STMT               : string,
-    EX_REST_PROP             : string,
-    EX_SPREAD_STMT           : string,
-    EXPR_STMT                : string,
-    FOR_STMT                 : string,
-    FOR_IN_STMT              : string,
-    FOR_OF_STMT              : string,
-    FUNC_DECLARATION         : string,
-    FUNC_EXPR                : string,
-    IDENTIFIER               : string,
-    IF_STMT                  : string,
-    LOGIC_EXPR               : string,
-    LABELED_STMT             : string,
-    LITERAL                  : string,
-    MEMBER_EXPR              : string,
-    META_PROP                : string,
-    METH_DEF                 : string,
-    NEW_EXPR                 : string,
-    OBJ_EXPR                 : string,
-    OBJ_PATTERN              : string,
-    PROGRAM                  : string,
-    PROPERTY                 : string,
-    REST_ELEM                : string,
-    RETURN_STMT              : string,
-    SEQUENCE_EXPR            : string,
-    SPREAD_ELEM              : string,
-    SUPER                    : string,
-    SWITCH_CASE              : string,
-    SWITCH_STMT              : string,
-    TAGGED_TEMPLATE_EXPR     : string,
-    TEMPLATE_ELEM            : string,
-    TEMPLATE_LIT             : string,
-    THIS_EXPR                : string,
-    THROW_EXPR               : string,
-    TRY_STMT                 : string,
-    UNARY_EXPR               : string,
-    UPDATE_EXPR              : string,
-    VAR_DECLARATION          : string,
-    VAR_DECLARATOR           : string,
-    WHILE_STMT               : string,
-    WITH_STMT                : string,
-    YIELD_EXPR               : string,
-    JSX_ID                   : string,
-    JSX_NS_NAME              : string,
-    JSX_EMPTY_EXPR           : string,
-    JSX_EXPR_CONTAINER       : string,
-    JSX_ELEM                 : string,
-    JSX_CLOSING_ELEM         : string,
-    JSX_OPENING_ELEM         : string,
-    JSX_ATTRIB               : string,
-    JSX_SPREAD_ATTRIB        : string,
-    JSX_TEXT                 : string,
-    EXPORT_DEFAULT_DECL      : string,
-    EXPORT_NAMED_DECL        : string,
-    EXPORT_ALL_DECL          : string,
-    EXPORT_SPECIFIER         : string,
-    IMPORT_DECL              : string,
-    IMPORT_EQUALS_DECL       : string,
-    IMPORT_SPECIFIER         : string,
-    IMPORT_DEF_SPECIFIER     : string,
-    IMPORT_NS_SPECIFIER      : string,
-    EXTERN_MOD_REF           : string
+    ARRAY_EXPR              : string,
+    ARROW_FUNC_EXPR         : string,
+    ASSIGN_PATTERN          : string,
+    ASSIGN_EXPR             : string,
+    ASSIGNMENT_EXPR         : string,
+    AWAIT_EXPR              : string,
+    BINARY_EXPR             : string,
+    BLOCK_STMT              : string,
+    BREAK_STMT              : string,
+    CALL_EXPR               : string,
+    CATCH_CLAUSE            : string,
+    CLASS_BODY              : string,
+    CLASS_DECLARATION       : string,
+    CLASS_EXPR              : string,
+    CLASS_PROP              : string,
+    CONDITIONAL_EXPR        : string,
+    CONTINUE_STMT           : string,
+    DO_WHILE_STMT           : string,
+    DEBUG_STMT              : string,
+    EMPTY_STMT              : string,
+    EX_REST_PROP            : string,
+    EX_SPREAD_STMT          : string,
+    EXPR_STMT               : string,
+    FOR_STMT                : string,
+    FOR_IN_STMT             : string,
+    FOR_OF_STMT             : string,
+    FUNC_DECLARATION        : string,
+    FUNC_EXPR               : string,
+    IDENTIFIER              : string,
+    IF_STMT                 : string,
+    LOGIC_EXPR              : string,
+    LABELED_STMT            : string,
+    LITERAL                 : string,
+    MEMBER_EXPR             : string,
+    META_PROP               : string,
+    METH_DEF                : string,
+    NEW_EXPR                : string,
+    OBJ_EXPR                : string,
+    OBJ_PATTERN             : string,
+    PROGRAM                 : string,
+    PROPERTY                : string,
+    REST_ELEM               : string,
+    RETURN_STMT             : string,
+    SEQUENCE_EXPR           : string,
+    SPREAD_ELEM             : string,
+    SUPER                   : string,
+    SWITCH_CASE             : string,
+    SWITCH_STMT             : string,
+    TAGGED_TEMPLATE_EXPR    : string,
+    TEMPLATE_ELEM           : string,
+    TEMPLATE_LIT            : string,
+    THIS_EXPR               : string,
+    THROW_EXPR              : string,
+    TRY_STMT                : string,
+    UNARY_EXPR              : string,
+    UPDATE_EXPR             : string,
+    VAR_DECLARATION         : string,
+    VAR_DECLARATOR          : string,
+    WHILE_STMT              : string,
+    WITH_STMT               : string,
+    YIELD_EXPR              : string,
+    JSX_ID                  : string,
+    JSX_NS_NAME             : string,
+    JSX_EMPTY_EXPR          : string,
+    JSX_EXPR_CONTAINER      : string,
+    JSX_ELEM                : string,
+    JSX_CLOSING_ELEM        : string,
+    JSX_OPENING_ELEM        : string,
+    JSX_ATTRIB              : string,
+    JSX_SPREAD_ATTRIB       : string,
+    JSX_TEXT                : string,
+    EXPORT_DEFAULT_DECL     : string,
+    EXPORT_NAMED_DECL       : string,
+    EXPORT_ALL_DECL         : string,
+    EXPORT_ASSIGNMENT       : string,
+    EXPORT_SPECIFIER        : string,
+    IMPORT_DECL             : string,
+    IMPORT_EQUALS_DECL      : string,
+    IMPORT_SPECIFIER        : string,
+    IMPORT_DEF_SPECIFIER    : string,
+    IMPORT_NS_SPECIFIER     : string,
+    ANY_KEYWORD             : string,
+    ARRAY_TYPE              : string,
+    AS_EXPR                 : string,
+    BOOLEAN_KEYWORD         : string,
+    EXTERN_MOD_REF          : string,
+    FUNCTION_TYPE           : string,
+    INTERFACE_BODY          : string,
+    INTERFACE_DECL          : string,
+    INTERSECTION_TYPE       : string,
+    LITERAL_TYPE            : string,
+    NUMBER_KEYWORD          : string,
+    OBJECT_KEYWORD          : string,
+    OPTIONAL_TYPE           : string,
+    PROPERTY_SIGNATURE      : string,
+    STRING_KEYWORD          : string,
+    TUPLE_TYPE              : string,
+    TYPE_ALIAS_DECL         : string,
+    TYPE_LITERAL            : string,
+    TYPE_REF                : string,
+    UNION_TYPE              : string
   }
 
   /**

package/lib/imanual.js

@@ -1,6 +0,0 @@
-/*
- * Copyright (c) 2018, 2021, 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 PREFIX=["jet","jaf","csp","jetwc","jetwco"];const RP_PREFIX=["csp","jetwc","jetwco"];const RULES_JSON="rules.json";const MSGID_JSON="msgid.json";const JS=".js";const RE_WS=/^\s*$/;const RE_MARKUP=/<[^>]*>/g;const RE_MARKUP2=/\s{2,}/g;const EMPTY="";const LINELEN=100;var _nd;var _error;var _path;var _rDir;var _rpDir;var _isMsgId;var _prefix;var _msgNum;var _arg;var _sev;var _multiIDs=[];var _isColor;function showMsgHelp(nd,arg,isColor,msgCtx){var rc=_init(nd,arg,isColor,msgCtx);if(rc>0){return _process()}else{return rc===0}};function _process(){var meta;_rDir=_path.join(__dirname,"../rules");_rpDir=_path.join(__dirname,"../rulepacks");if(!(meta=_loadRuleMetadata())){return true}return _isMsgId?_processMsgId(meta):_processRuleName(meta)};function _processMsgId(meta){var mjson=meta.mjson;var rname,r,x;for(r in mjson){if(_msgNum===mjson[r]){rname=r;break}}if(!rname){_error(`No rule found for message ID ${_prefix}-${_msgNum}.`);return true}x=rname.indexOf("_");if(x>=0){rname=rname.substring(0,x)}return _displayIt(rname,_prefix,meta)};function _processRuleName(meta){var rname,rjson,r;rname=_arg.toLowerCase();rjson=meta.rjson.rules;for(r in rjson){if(r===rname){return _displayIt(rname,_prefix,meta)}}_error(`Rule ${rname} is not a core rule`);return!rname.startsWith("oj-")};function _displayIt(rname,prefix,meta){var rule,r,mjson,rjson,prefix;mjson=meta.mjson;for(r in mjson){if(r.startsWith(rname)){_multiIDs.push(mjson[r])}}rjson=meta.rjson;for(r in rjson.rules){if(r===rname){_sev=rjson.rules[r].severity;break}}_sev=_sev||"unknown";if(rule=_loadRule(rname,meta)){let o={descrip:rule.getDescription(),rule:rname,prefix:prefix,sev:_sev,idList:_multiIDs};display(o,_isColor?_nd.colors:null);return true}return false};function _loadRule(rname,meta){var rule,ruleJS,fp;try{fp=_nd.path.join(meta.rdir,rname+JS);ruleJS=_nd.ruleLoader(fp);if(ruleJS.prototype||!ruleJS.getName){try{rule=new ruleJS}catch(e){_error(`Failed to instantiate rule ${rname}`)}}else{rule=ruleJS}return rule}catch(e){_error(`Failed to load rule ${rname}`)}};function _loadRuleMetadata(){var meta,fp;fp=RP_PREFIX.includes(_prefix)?_nd.path.join(_rpDir,_prefix):_nd.path.join(_rDir,_prefix);meta=_loadRulesJson(fp);return meta}function _loadRulesJson(dir){var rjson,mjson,fp;fp=_nd.path.join(dir,RULES_JSON);if(_nd.fsUtils.fileExists(fp)){rjson=_nd.jsonLoader.load(fp,_nd,m=>{_error(m)},true,_nd.utils)}else{_error(`Internal error: rule manifest for ${_prefix} not found`);return false}fp=_nd.path.join(dir,MSGID_JSON);if(_nd.fsUtils.fileExists(fp)){mjson=_nd.jsonLoader.load(fp,_nd,m=>{_error(m)},true,_nd.utils)}else{if(!RP_PREFIX.includes(_prefix)){_error(`Internal error: rule message ID manifest for ${_prefix} not found`);return false}}if(rjson){return{rjson:rjson,mjson:mjson,rdir:dir}}};function _init(nd,arg,isColor,msgCtx){var x;_nd=nd;_isColor=isColor;_error=msgCtx.error;_path=nd.path;_arg=arg;arg=arg.toLowerCase();x=arg.indexOf("-");if(x<0){if(!isNaN(parseInt(arg))){arg="jet-"+arg;x=3}else{_error("Expected a message ID or rulename to follow --help");return 0}}_prefix=arg.substring(0,x);_msgNum=arg.substring(x+1);x=parseInt(_msgNum);_isMsgId=!isNaN(x);if(_isMsgId){if(_msgNum.length<4){_msgNum="0".repeat(4-_msgNum.length)+_msgNum}}else{_msgNum=null;if(arg.startsWith("oj-")){_prefix="jet"}}if(PREFIX.includes(_prefix)){return 1}return-1};function display(o,color){var start,end,line,s,s1,s2,s3,c,x;var multiSev=o.idList.length>1;function nop(s){return s};color=color?color:{BRIGHTGREEN:nop,BRIGHTYELLOW:nop,CYAN:nop};s=color.BRIGHTGREEN("Rule: ");s1=color.BRIGHTGREEN("Severity: ");s2=color.BRIGHTGREEN("Message ID");s3=color.BRIGHTYELLOW("\xB9");line="\n"+s+color.BRIGHTYELLOW(o.rule)+"  "+s1+color.BRIGHTYELLOW(o.sev)+(multiSev?s3:EMPTY)+"  "+s2+(multiSev?"'s":EMPTY)+": "+o.prefix+"-"+o.idList.join(", ");console.log(line);s=_removeMarkup(o.descrip);s=_removeColorMarkup(s);start=0;end=LINELEN;while(end<s.length){x=_NL(s,start,end);if(x>=0){line=s.substring(start,x).trim();console.log(color.CYAN(line));start=x+1;end=start+LINELEN;continue}c=s.charAt(end);if(RE_WS.test(c)){line=s.substring(start,end).trim();console.log(color.CYAN(line));start=end;end+=LINELEN;continue}else{end--}}if(start<end){line=s.substring(start,end).trim();console.log(color.CYAN(line))}if(multiSev){s="\n"+s3+color.BRIGHTYELLOW(" Possibility of more than 1 severity since there are "+o.idList.length+" message ID's");console.log(s)}console.log("")};function _removeMarkup(s){s=s.replace(/<oj-/g,"@@1").replace(/<\/oj-/g,"@@2").replace(/<br>/g,"@@3").replace(/<p>/g,"@@3@@3").replace(/<b>/g,"@@4").replace(/<em>/g,"@@4").replace(/<i>/g,"@@5").replace(/<\/b>/g,"@@6").replace(/<\/em>/g,"@@6").replace(/<\/i>/g,"@@6").replace(/<div/g,"@@7").replace(/<\/div>/g,"@@8").replace(RE_MARKUP,EMPTY).replace(RE_MARKUP2," ").trimRight().replace(/@@1/g,"<oj-").replace(/@@2/g,"</oj-").replace(/@@3/g,"\n").replace(/&lt;/g,"<").replace(/&gt;/g,">").replace(/&nbsp;/g,EMPTY).replace(/@@7/g,"<div").replace(/@@8/g,"</div>");if(!_isColor){s=s.replace(/@@4/g,EMPTY).replace(/@@5/g,EMPTY).replace(/@@6/g,EMPTY)}return s.trim();;};function _removeColorMarkup(s){if(_isColor){s=s.replace(/@@4/g,EMPTY).replace(/@@5/g,EMPTY).replace(/@@6/g,EMPTY)}return s.trim()};function _NL(s,start,end){while(start<end){if(s.charAt(start)==="\n"){return start}start++}return-1};module.exports.showMsgHelp=showMsgHelp;module.exports.display=display;

package/lib/xmanual.js

@@ -1,6 +0,0 @@
-/*
- * Copyright (c) 2018, 2021, 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 imanual=require("./imanual");function checkMsgHelp(rules,manCheckL,manCheckS,color,msgCtx){var check,temp,isShort,o,x,ret=false;check=manCheckL||manCheckS;if(check){temp=check.toLowerCase();x=temp.indexOf("-");check=x>=0?temp.substring(0,x):"";check=check.toUpperCase()+temp.substring(x);isShort=!!manCheckS;if(rules.getRSIByRuleName(temp)>=0){o=rules.getRuleDescriptionEx(null,temp,isShort)}else{o=rules.getRuleDescriptionEx(check,null,isShort)}if(o&&o.descrip){imanual.display(o,color)}else{msgCtx.error(`Unable to locate '${temp}' via the configuration file.`)}ret=true}return ret};module.exports.checkMsgHelp=checkMsgHelp;

package/rulepacks/jetwc-lib/component-audit-utils.js

@@ -1,6 +0,0 @@
-/*
- * Copyright (c) 2018, 2021, 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 Utils=function(){this.rootPoint=this.toJAFPath(path.resolve('.')).length+1;this.isWindows=path.sep!=='/';this.noJSWarnDone=false};Utils.prototype.getKeyPathInfoForRulepack=function(context,auditBase){const paths={isBuiltOutput:false,componentRootFolder:null,exchangeCacheFolder:null,generalSourceRoot:'src',jsSource:null,tsSource:null};let jetConfig=context.ojetConfig;if(!jetConfig&&auditBase){const remoteConfig=path.join(auditBase,'oraclejetconfig.json');if(context.utils.fsUtils.pathExistsSync(remoteConfig)){jetConfig=context.utils.fsUtils.readJsonSync(remoteConfig)}}let jsDir='js';let tsDir='ts';paths.isBuiltOutput=context.rulePack.getRuleOptions().auditBuildOutput;if(jetConfig){jsDir=jetConfig.paths.source.javascript||'js';tsDir=jetConfig.paths.source.typescript||'ts';paths.exchangeCacheFolder=jetConfig.paths.source.exchangeComponents||'jet_components';paths.componentRootFolder=jetConfig.paths.source.components||'jet-composites';if(!paths.isBuiltOutput){paths.generalSourceRoot=jetConfig.paths.source.common||'src'}else{paths.generalSourceRoot=jetConfig.paths.staging.web||'web'}}paths.jsSource=this.toJAFPath(path.join(paths.generalSourceRoot,jsDir));if(!paths.isBuiltOutput){paths.tsSource=this.toJAFPath(path.join(paths.generalSourceRoot,tsDir))}return paths};Utils.prototype.matchComponentPath=function(context,checkPathBase,recursion){let checkPath=checkPathBase;let componentMatch;if(context.rulePack.getExtension()&&context.rulePack.getExtension().hasOwnProperty('allAuditableFilePaths')){if(context.rulePack.getExtension().allAuditableFilePaths.has(checkPath)){const x=context.rulePack.getExtension().allAuditableFilePaths;componentMatch=context.rulePack.getExtension().allAuditableFilePaths.get(checkPath)}else if(checkPath.includes(context.rulePack.getExtension().componentHome)){if(context.rulePack.getExtension().auditableComponentPaths.has(checkPath)){componentMatch=context.rulePack.getExtension().auditableComponentPaths.get(checkPath)}else{const parentPath=this.toJAFPath(path.resolve(checkPath,'..'+path.sep));componentMatch=this.matchComponentPath(context,parentPath,true)}if(!recursion){context.rulePack.getExtension().allAuditableFilePaths.set(checkPath,componentMatch)}}else{context.rulePack.getExtension().allAuditableFilePaths.set(checkPath)}}else{this.reportMissingBootstrapInfo(context,'allAuditableFilePaths')}return componentMatch};Utils.prototype.reportMissingBootstrapInfo=function(context,checkTopic){const extnContext=context.rulePack.getExtension();if(!extnContext||!extnContext.bootStrap){const bootstrapRule=context.rulePack.getPrefix().toLowerCase()+'-bootstrap';if(context.rulePack.isRuleDisabled(bootstrapRule)){console.error(`ERROR: You must enable the ${bootstrapRule} rule to run in order to carry out a full component set audit`)}else{console.error(`ERROR: Apparent bootstrap error, no information cached for ${checkTopic}`)}context.rulePack.setExtension({...extnContext,bootStrap:true})}};Utils.prototype.componentInfo=function(context,componentName){if(context.rulePack.getExtension()&&context.rulePack.getExtension().hasOwnProperty('allComponents')){return context.rulePack.getExtension().allComponents.get(componentName)}else{this.reportMissingBootstrapInfo(context,'allComponents')}return};Utils.prototype.getComponentFullName=function(metadata){return metadata.pack?`${metadata.pack}-${metadata.name}`:metadata.name};Utils.prototype.getComponentType=function(metadata){return metadata.type?metadata.type:'composite'};Utils.prototype.isExpressionString=function(value){if(value){const bindingExpr=/^(?:\[{2})(.*)(?:\]{2})$|^(?:\{{2})(.*)(?:\}{2})$/g;return bindingExpr.test(value.trim())}return false};Utils.prototype.setupFileMethodMapping=function(context,node){const fileName=context.filepath;const withinComponent=this.matchComponentPath(context,path.dirname(fileName));if(withinComponent){if(node.parent&&node.parent.type==='AssignmentExpression'&&node.parent.operator==='='){if(node.parent.left&&node.parent.left.property&&node.parent.left.property.type=='Identifier'&&node.parent.left.property.name){const methodDef={name:node.parent.left.property.name,parameters:node.params?node.params.length:0};this.cacheFileMethod(context,fileName,methodDef)}}else if(node.parent&&node.parent.type==='MethodDefinition'&&node.parent.kind==='method'){if(node.parent.key&&node.parent.key.name){const methodDef={name:node.parent.key.name,parameters:node.params?node.params.length:0};this.cacheFileMethod(context,fileName,methodDef)}}else if(node.parent&&node.parent.type==='ClassProperty'){if(node.parent.key&&node.parent.key.name){const methodDef={name:node.parent.key.name,parameters:node.params?node.params.length:0};this.cacheFileMethod(context,fileName,methodDef)}}}};Utils.prototype.setupFileMethodMappingFromMethodDefintion=function(context,node){const NT=context.utils.AstUtils.getNodeTypes();const fileName=context.filepath;const withinComponent=this.matchComponentPath(context,path.dirname(fileName));if(withinComponent){const methodDef={parameters:0};if(node.key&&node.key.type===NT.IDENTIFIER){methodDef.name=node.key.name;if(node.value&&node.value.type===NT.FUNC_EXPR&&node.value.params){methodDef.parameters=node.value.params.length}}if(methodDef.name){this.cacheFileMethod(context,fileName,methodDef)}}};Utils.prototype.cacheFileMethod=function(context,filePath,methodDef){if(!context.rulePack.getExtension().allDefinedFileMethods){context.rulePack.getExtension().allDefinedFileMethods=new Map}if(!context.rulePack.getExtension().allDefinedFileMethods.has(filePath)){context.rulePack.getExtension().allDefinedFileMethods.set(filePath,{methods:new Map})}if(!context.rulePack.getExtension().allDefinedFileMethods.get(filePath).methods.has(methodDef.name)){context.rulePack.getExtension().allDefinedFileMethods.get(filePath).methods.set(methodDef.name,methodDef)}};Utils.prototype.deriveViewModels=function(context,node){const fileName=context.filepath;if(context.rulePack.getExtension()&&context.rulePack.getExtension().hasOwnProperty('allComponents')){const withinComponent=this.matchComponentPath(context,path.dirname(fileName));const componentInfo=context.rulePack.getExtension().allComponents.get(withinComponent);if(withinComponent&&componentInfo&&componentInfo.type==='composite'&&!componentInfo.viewModel.resolved){const targetLoaderExt=componentInfo.language==='tsx'?'.ts':`.${componentInfo.language}`;if(path.basename(fileName,targetLoaderExt)==='loader'){switch(componentInfo.language){case'js':case'ts':const registerInfo=this.getLoaderRegisterInfo(context,node);if(registerInfo){const vmRelativeFilePath=this._mapVMToImpl(context,node,registerInfo.viewModel,componentInfo.language==='ts');if(vmRelativeFilePath){const fullVMPath=this._expandPathInContext(context,withinComponent,vmRelativeFilePath);if(fullVMPath){componentInfo.viewModel={path:this.toJAFPath(path.resolve('.',`${fullVMPath}.${componentInfo.language}`)),resolved:true,skip:false}}}}break;case'tsx':break;}}}}else{this.reportMissingBootstrapInfo(context,'allComponents')}};Utils.prototype.getLoaderRegisterInfo=function(context,node){const NT=context.utils.AstUtils.getNodeTypes();let registerInfo;if(node.callee.type=NT.MEMBER_EXPR&&node.callee.object&&node.arguments&&node.arguments.length>0){let isRegister=false;let oldStyle=false;switch(node.callee.object.type){case NT.IDENTIFIER:if(node.callee.object.name==='Composite'){isRegister=this._astPropertyIdentifierName(node.callee,'register')}break;case NT.MEMBER_EXPR:if(node.callee.property&&node.callee.property.type===NT.IDENTIFIER&&node.callee.property.name==='register'){if(this._astPropertyIdentifierName(node.callee.object,'Composite')){isRegister=node.callee.object.object&&node.callee.object.object.type===NT.IDENTIFIER&&node.callee.object.object.name==='oj';if(isRegister){oldStyle=true}}}break;}if(isRegister){registerInfo={oldStyle:oldStyle};const tagArg=node.arguments[0];const def=node.arguments[1];registerInfo.tag=tagArg.type===NT.LITERAL?tagArg.value:'?';if(def.type===NT.OBJ_EXPR){vmProp=def.properties.filter(prop=>prop.key.name==='viewModel');if(vmProp.length===1){switch(vmProp[0].value.type){case NT.IDENTIFIER:registerInfo.viewModel=vmProp[0].value.name;break;case NT.OBJ_EXPR:if(vmProp[0].value.properties&&vmProp[0].value.properties[0]&&vmProp[0].value.properties[0].key.name==='inline'){registerInfo.viewModel=vmProp[0].value.properties[0].value.name;registerInfo.usesPromises=true}break;case NT.MEMBER_EXPR:if(vmProp[0].value.property&&vmProp[0].value.property.type===NT.IDENTIFIER){registerInfo.viewModel=vmProp[0].value.object.name;registerInfo.transpiled=true}break;case'TSAsExpression':if(vmProp[0].value.expression&&vmProp[0].value.expression.type===NT.IDENTIFIER){registerInfo.viewModel=vmProp[0].value.expression.name}else if(vmProp[0].value.expression&&vmProp[0].value.expression.type==='TSAsExpression'){registerInfo.viewModel=vmProp[0].value.expression.expression.name;console.warn(`WARNING: Component loader file ${context.filepath} attempts to redefine the composite.register viewModel interface`)}break;}}const cssCheck=def.properties.filter(prop=>prop.key.name==='css');if(cssCheck.length>0){registerInfo.registerCSS=true}}}}return registerInfo};Utils.prototype._astPropertyIdentifierName=function(node,checkName){return node&&node.property&&node.property.type==='Identifier'&&node.property.name===checkName};Utils.prototype._mapVMToImpl=function(context,node,vmName,useImports){let vmPathDef;if(vmName){let rootNode=node;if(useImports){vmPathDef=this._getImportPath(context,rootNode,vmName)}else{vmPathDef=this._getDefineStatementPath(context,rootNode,vmName);if(!vmPathDef){vmPathDef=this._mapToRequireAssignment(node,vmName)}}}return vmPathDef};Utils.prototype._mapToRequireAssignment=function(node,vmName){let requirePath;const vmDeclNode=this._locateDeclaration(node,vmName);if(vmDeclNode.type==='CallExpression'&&vmDeclNode.callee.type==='Identifier'&&vmDeclNode.callee.name==='require'){if(vmDeclNode.arguments&&vmDeclNode.arguments.length===1&&vmDeclNode.arguments[0].type==='Literal'){requirePath=vmDeclNode.arguments[0].value}}return requirePath};Utils.prototype._getImportPath=function(context,node,importAs){const NT=context.utils.AstUtils.getNodeTypes();const bodyNodeArray=context.utils.AstUtils.getBody();let definePath;for(let i=0;i<bodyNodeArray.length;i++){const testNode=bodyNodeArray[i];switch(testNode.type){case'ImportDeclaration':if(testNode.specifiers&&Array.isArray(testNode.specifiers)&&testNode.specifiers.length===1&&(testNode.specifiers[0].type==='ImportDefaultSpecifier'||testNode.specifiers[0].type==='ImportSpecifier')&&testNode.specifiers[0].local&&testNode.specifiers[0].local.name===importAs){definePath=testNode.source.value}break;case'TSImportEqualsDeclaration':if(testNode.id&&testNode.id.type===NT.IDENTIFIER&&testNode.id.name===importAs&&testNode.moduleReference&&testNode.moduleReference.type==='TSExternalModuleReference'&&testNode.moduleReference.expression&&testNode.moduleReference.expression.type===NT.LITERAL){definePath=testNode.moduleReference.expression.value}break;}if(definePath){;break}}return definePath};Utils.prototype._getDefineStatementPath=function(context,node,defineParam){const NT=context.utils.AstUtils.getNodeTypes();let checkNode=node.parent;let definePath;while(checkNode){if(checkNode.type===NT.CALL_EXPR&&checkNode.callee.name==='define'){definePath=context.utils.AstUtils.parseDefine(checkNode)[defineParam]}checkNode=checkNode.parent}return definePath};Utils.prototype._expandPathInContext=function(context,componentName,requirePath){let targetPath=requirePath;const parsePluginParts=requirePath.split('!');if(parsePluginParts.length>1){targetPath=parsePluginParts[1]}let pathParts=targetPath.split('/');const decodeRoot=pathParts[0];if(decodeRoot==='.'){pathParts[0]=this.rootPathForComponent(context,componentName)}else{const remotePart=this.rootPathForComponent(context,decodeRoot);if(!remotePart){pathParts=[]}else{pathParts[0]=remotePart}}return pathParts.join('/')};Utils.prototype.rootPathForComponent=function(context,componentName){if(context.rulePack.getExtension().allComponents.has(componentName)){return context.rulePack.getExtension().allComponents.get(componentName).rootFolder}};Utils.prototype.getVMMethodsForLocalComposite=function(context,component){let vmMethods;const opts=context.rulePack.getRuleOptions();if(component.local&&component.type==='composite'){if(!component.viewModel.skip){if(!component.viewModel.resolved&&!component.viewModel.warned){if(!opts.testMode){console.log(`Warning: unable to derive the correct viewModel implementation for component ${component.fullName}, either your audit run does not include .js/.ts files, or you may need to set 'extension.audit.jetwc.viewModel' in the metadata to provide a hint`)}component.viewModel.warned=true}else{const rpState=context.rulePack.getExtension();if(rpState.allDefinedFileMethods&&rpState.allDefinedFileMethods.size>0){const vmMethodDef=rpState.allDefinedFileMethods.get(component.viewModel.path);if(vmMethodDef){vmMethods=vmMethodDef.methods}}else{if(!this.noJSWarnDone){console.log('Error: No JavaScript / TypeScript files have been processed. You need to ensure that your audit fileset includes .js, .ts, html and .json files to enable all audits in this rule-set.  Use the ojaf --dryrun command to determine what files are covered by the audit');this.noJSWarnDone=true}}}}}return vmMethods};Utils.prototype.decomposeAssignment=function(assignmentNode){const breakdown=[];this._walkAssignmentNodes(assignmentNode.left,breakdown);if(!breakdown.includes('this')){const parentAssignment=breakdown[breakdown.length-1];const initialAssignmentNode=this._locateDeclaration(assignmentNode,parentAssignment);if(initialAssignmentNode){if(initialAssignmentNode==='<parameter>'){breakdown.push('<parameter>')}else if(initialAssignmentNode.type==='ThisExpression'){breakdown.push('this')}else if(initialAssignmentNode.type==='Identifier'){breakdown.push(initialAssignmentNode.name);const indirectAssignmentNode=this._locateDeclaration(assignmentNode,initialAssignmentNode.name);if(indirectAssignmentNode==='<parameter>'){breakdown.push('<parameter>')}else if(indirectAssignmentNode.type==='ThisExpression'){breakdown.push('this')}}}}return breakdown};Utils.prototype._walkAssignmentNodes=function(node,accumulator){switch(node.type){case'MemberExpression':accumulator.push(node.property.name);if(node.object){this._walkAssignmentNodes(node.object,accumulator)}break;case'Identifier':accumulator.push(node.name);break;case'ThisExpression':accumulator.push('this');break;}};Utils.prototype._locateDeclaration=function(node,searchVariable){let initialAssignment;let workingNode=node;while(!initialAssignment){if(workingNode.body&&workingNode.body.length>0){workingNode.body.forEach(bodyNode=>{if(bodyNode.type==='VariableDeclaration'){bodyNode.declarations.forEach(declNode=>{if(declNode.id.type==='Identifier'&&declNode.id.name===searchVariable){initialAssignment=declNode.init}})}})}else if(workingNode.params&&workingNode.params.length>0){workingNode.params.forEach(paramNode=>{if(paramNode.name===searchVariable){initialAssignment='<parameter>'}})}if(!workingNode.parent){break}else{workingNode=workingNode.parent}}return initialAssignment};Utils.prototype.extractComponentInfoFromJSONFile=function(auditContext,componentFolder,fileName,isLocal){let componentInfo={};const mdFile=this.toJAFPath(path.join(componentFolder,fileName));const compMetadata=auditContext.utils.fsUtils.readJsonSync(mdFile);if(compMetadata!==null){componentInfo.fullName=this.getComponentFullName(compMetadata);componentInfo.pack=compMetadata.pack;componentInfo.name=compMetadata.name;componentInfo.version=compMetadata.version;componentInfo.extension=compMetadata.extension;componentInfo.type=compMetadata.type?compMetadata.type:'composite';componentInfo.local=isLocal;componentInfo.rootFolder=this.toJAFPath(componentFolder);componentInfo.requirePaths=new Set;switch(componentInfo.type){case'reference':if(compMetadata.extension&&compMetadata.extension.oracle&&compMetadata.extension.oracle.businessApprovals){componentInfo.ba=compMetadata.extension.oracle.businessApprovals}if(compMetadata.paths&&compMetadata.paths.name){componentInfo.requirePaths.add(compMetadata.paths.name)}else{const extractPathSegments=compMetadata.package.split('/');if(extractPathSegments.length>1){componentInfo.requirePaths.add(extractPathSegments[1])}else{componentInfo.requirePaths.add(extractPathSegments[0])}}break;case'composite':if(compMetadata.slots){componentInfo.slots=compMetadata.slots}if(compMetadata.properties){componentInfo.properties=compMetadata.properties}if(compMetadata.events){componentInfo.events=compMetadata.events}if(compMetadata.methods&&Object.keys(compMetadata.methods).length>0){componentInfo.methods=compMetadata.methods}componentInfo.viewModel={resolved:false};if(compMetadata&&compMetadata.extension&&compMetadata.extension.audit&&compMetadata.extension.audit.jetwc&&compMetadata.extension.audit.jetwc.hasOwnProperty('viewModel')){const overrideVM=compMetadata.extension.audit.jetwc.viewModel;if(overrideVM){componentInfo.viewModel={path:this.toJAFPath(path.resolve('.',componentInfo.rootFolder,overrideVM)),resolved:true,skip:false}}else{componentInfo.viewModel={skip:true}}}case'resource':componentInfo.requirePaths.add('.');if(compMetadata.pack){componentInfo.requirePaths.add(`${compMetadata.pack}/${compMetadata.name}`)}else{componentInfo.requirePaths.add(compMetadata.name)}if(compMetadata.dependencies){componentInfo.dependencies=Object.keys(compMetadata.dependencies)}break;}return componentInfo}else{console.error(`Error Invalid JSON in component metadata  ${mdFile}, component ignored`)}return};Utils.prototype.diagnosticReplacer=function(key,value){if(value instanceof Map){return Array.from(value).map(([vKey,vValue])=>{return{[vKey]:vValue?vValue:''}})}if(value instanceof Set){return Array.from(value)}return value};Utils.prototype.toJAFPath=function(sourcePath){if(this.isWindows){return sourcePath.replace(/\\\\|\\/g,'/')}return sourcePath};Utils.prototype.getDirectoryName=function(filePath){return path.dirname(filePath)};Utils.prototype.shouldIgnoreCheck=function(context,auditName,componentName,scope,target){let ignore=false;const checkComponentDef=context.rulePack.getExtension().allComponents.get(componentName);if(checkComponentDef){let targetDef;if(scope&&checkComponentDef[scope]){if(target.includes('.')&&scope==='properties'){targetDef=this.getPropertyAttributeFromPath(context,componentName,target)}else{targetDef=checkComponentDef[scope][target==='__default__'?'':target]}}else{targetDef=checkComponentDef}if(targetDef&&targetDef.extension&&targetDef.extension.hasOwnProperty('audit')&&targetDef.extension.audit.hasOwnProperty('ignore')){const ignoreArray=targetDef.extension.audit.ignore;ignore=ignoreArray.includes(auditName)}}return ignore};Utils.prototype.getPropertyAttributeFromPath=function(context,componentName,targetPath,attribute){const checkComponentDef=context.rulePack.getExtension().allComponents.get(componentName);let targetDef;if(checkComponentDef&&checkComponentDef.properties){if(targetPath.includes('.')){const propPath=targetPath.split('.');targetDef=checkComponentDef.properties[propPath[0]];for(let i=1;i<propPath.length;i++){targetDef=targetDef.properties[propPath[i]]}}else{targetDef=checkComponentDef.properties[targetPath]}}if(attribute){return targetDef[attribute]}else{return targetDef}};Utils.prototype.detectComponentSourceType=function(context,componentPathRoot){const fs=context.utils.fsUtils;let componentImplType;if(fs.fileExistsSync(path.join(componentPathRoot,'loader.js'))){componentImplType='js'}else if(fs.fileExistsSync(path.join(componentPathRoot,'loader.ts'))){componentImplType=this._lookForTSorTSX(context,componentPathRoot)}else{const pathSegs=componentPathRoot.toLowerCase().split('/');if(pathSegs.includes('ts')){componentImplType=this._lookForTSorTSX(context,componentPathRoot)}else{componentImplType='js'}}return componentImplType};Utils.prototype._lookForTSorTSX=function(context,searchFolder,files){const fs=context.utils.fsUtils;let detectedType;let folderContents;if(!files){folderContents=fs.readDirSync(searchFolder)}else{folderContents=files}let fileCount=folderContents.length;let i=0;do{if(folderContents[i].isFile){const extn=fs.getFileExtSync(folderContents[i].name).toLowerCase();if(extn==='tsx'){detectedType='tsx';break}else if(extn==='ts'){detectedType='ts'}}else{const folderDrillType=this._lookForTSorTSX(context,null,folderContents[i].files);if(folderDrillType==='tsx'){detectedType='tsx';break}else if(folderDrillType==='ts'){detectedType='ts'}}i++}while(i<fileCount);return detectedType};Utils.prototype.getComponentCacheFolderName=function(context){return`jaftmp@-${context.rulePack.getPrefix()}`};Utils.prototype.ensureLocalCache=function(context){const cacheFolder=this.getComponentCacheFolderName(context);if(!context.utils.fsUtils.pathExistsSync(cacheFolder)){context.utils.fsUtils.createFolderSync(cacheFolder)}};Utils.prototype.removeLocalCache=function(context){const cacheFolder=this.getComponentCacheFolderName(context);if(context.utils.fsUtils.pathExistsSync(cacheFolder)){context.utils.fsUtils.deleteFolderSync(cacheFolder,true)}};Utils.prototype.generateComponentCachePath=function(context,component,componentVersion){const cacheFolder=this.getComponentCacheFolderName(context);const mungedVersion=componentVersion.replace(/\./g,'-');return path.join(cacheFolder,`${component}@${mungedVersion}-component.json`)};Utils.prototype.existsInComponentCache=function(context,component,componentVersion){const cacheFile=this.generateComponentCachePath(context,component,componentVersion);return context.utils.fsUtils.fileExistsSync(cacheFile)};Utils.prototype.writeToComponentCache=function(context,component,componentVersion,metadata){if(metadata){const cacheFile=this.generateComponentCachePath(context,component,componentVersion);context.utils.fsUtils.writeJsonSync(metadata,cacheFile)}};Utils.prototype.readFromComponentCache=function(context,component,componentVersion){let readMetadata;const cacheFile=this.generateComponentCachePath(context,component,componentVersion);return context.utils.fsUtils.readJsonSync(cacheFile)};Utils.prototype.getObjectHashSignature=function(sourceObject){const sourceAsStringArray=Array.from(JSON.stringify(sourceObject));return sourceAsStringArray.reduce((hash,c)=>Math.imul(31,hash)+c.charCodeAt(0)|0,0)};Utils.prototype.safeSetExtension=function(context,extnValue){let existingContext=context.rulePack.getExtension();if(!existingContext){existingContext={}}const newContext={...existingContext,...extnValue};context.rulePack.setExtension(newContext)};module.exports=new Utils;