'use strict'; exports.__esModule = true; /** * Returns an object of node visitors that will call * 'visitor' with every discovered module path. * * todo: correct function prototype for visitor * @param {Function(String)} visitor [description] * @param {[type]} options [description] * @return {object} */ exports.default = function visitModules(visitor, options) { // if esmodule is not explicitly disabled, it is assumed to be enabled options = Object.assign({ esmodule: true }, options); let ignoreRegExps = []; if (options.ignore != null) { ignoreRegExps = options.ignore.map((p) => new RegExp(p)); } function checkSourceValue(source, importer) { if (source == null) { return; } //? // handle ignore if (ignoreRegExps.some((re) => re.test(source.value))) { return; } // fire visitor visitor(source, importer); } // for import-y declarations function checkSource(node) { checkSourceValue(node.source, node); } // for esmodule dynamic `import()` calls function checkImportCall(node) { let modulePath; // refs https://github.com/estree/estree/blob/HEAD/es2020.md#importexpression if (node.type === 'ImportExpression') { modulePath = node.source; } else if (node.type === 'CallExpression') { if (node.callee.type !== 'Import') { return; } if (node.arguments.length !== 1) { return; } modulePath = node.arguments[0]; } if (modulePath.type !== 'Literal') { return; } if (typeof modulePath.value !== 'string') { return; } checkSourceValue(modulePath, node); } // for CommonJS `require` calls // adapted from @mctep: https://git.io/v4rAu function checkCommon(call) { if (call.callee.type !== 'Identifier') { return; } if (call.callee.name !== 'require') { return; } if (call.arguments.length !== 1) { return; } const modulePath = call.arguments[0]; if (modulePath.type !== 'Literal') { return; } if (typeof modulePath.value !== 'string') { return; } checkSourceValue(modulePath, call); } function checkAMD(call) { if (call.callee.type !== 'Identifier') { return; } if (call.callee.name !== 'require' && call.callee.name !== 'define') { return; } if (call.arguments.length !== 2) { return; } const modules = call.arguments[0]; if (modules.type !== 'ArrayExpression') { return; } for (const element of modules.elements) { if (element.type !== 'Literal') { continue; } if (typeof element.value !== 'string') { continue; } if ( element.value === 'require' || element.value === 'exports' ) { continue; // magic modules: https://github.com/requirejs/requirejs/wiki/Differences-between-the-simplified-CommonJS-wrapper-and-standard-AMD-define#magic-modules } checkSourceValue(element, element); } } const visitors = {}; if (options.esmodule) { Object.assign(visitors, { ImportDeclaration: checkSource, ExportNamedDeclaration: checkSource, ExportAllDeclaration: checkSource, CallExpression: checkImportCall, ImportExpression: checkImportCall, }); } if (options.commonjs || options.amd) { const currentCallExpression = visitors.CallExpression; visitors.CallExpression = function (call) { if (currentCallExpression) { currentCallExpression(call); } if (options.commonjs) { checkCommon(call); } if (options.amd) { checkAMD(call); } }; } return visitors; }; /** * make an options schema for the module visitor, optionally * adding extra fields. */ function makeOptionsSchema(additionalProperties) { const base = { type: 'object', properties: { commonjs: { type: 'boolean' }, amd: { type: 'boolean' }, esmodule: { type: 'boolean' }, ignore: { type: 'array', minItems: 1, items: { type: 'string' }, uniqueItems: true, }, }, additionalProperties: false, }; if (additionalProperties) { for (const key in additionalProperties) { base.properties[key] = additionalProperties[key]; } } return base; } exports.makeOptionsSchema = makeOptionsSchema; /** * json schema object for options parameter. can be used to build * rule options schema object. * @type {Object} */ exports.optionsSchema = makeOptionsSchema();