const ejs = require('ejs') const slash = require('slash') const debug = require('debug') const GeneratorAPI = require('./GeneratorAPI') const sortObject = require('./util/sortObject') const writeFileTree = require('./util/writeFileTree') const configTransforms = require('./util/configTransforms') const injectImportsAndOptions = require('./util/injectImportsAndOptions') const { toShortPluginId, matchesPluginId } = require('@vue/cli-shared-utils') const logger = require('@vue/cli-shared-utils/lib/logger') const logTypes = { log: logger.log, info: logger.info, done: logger.done, warn: logger.warn, error: logger.error } module.exports = class Generator { constructor (context, { pkg = {}, plugins = [], completeCbs = [], files = {} } = {}) { this.context = context this.plugins = plugins this.originalPkg = pkg this.pkg = Object.assign({}, pkg) this.imports = {} this.rootOptions = {} this.completeCbs = completeCbs // for conflict resolution this.depSources = {} // virtual file tree this.files = files this.fileMiddlewares = [] this.postProcessFilesCbs = [] // exit messages this.exitLogs = [] const cliService = plugins.find(p => p.id === '@vue/cli-service') const rootOptions = cliService && cliService.options // apply generators from plugins plugins.forEach(({ id, apply, options }) => { const api = new GeneratorAPI(id, this, options, rootOptions || {}) apply(api, options, rootOptions) }) } async generate ({ extractConfigFiles = false, checkExisting = false } = {}) { // save the file system before applying plugin for comparison const initialFiles = Object.assign({}, this.files) // extract configs from package.json into dedicated files. this.extractConfigFiles(extractConfigFiles, checkExisting) // wait for file resolve await this.resolveFiles() // set package.json this.sortPkg() this.files['package.json'] = JSON.stringify(this.pkg, null, 2) // write/update file tree to disk await writeFileTree(this.context, this.files, initialFiles) } extractConfigFiles (extractAll, checkExisting) { const extract = key => { if ( configTransforms[key] && this.pkg[key] && // do not extract if the field exists in original package.json !this.originalPkg[key] ) { const value = this.pkg[key] const transform = configTransforms[key] const res = transform( value, checkExisting, this.context ) const { content, filename } = res this.files[filename] = content delete this.pkg[key] } } if (extractAll) { for (const key in this.pkg) { extract(key) } } else { if (!process.env.VUE_CLI_TEST) { // by default, always extract vue.config.js extract('vue') } // always extract babel.config.js as this is the only way to apply // project-wide configuration even to dependencies. // TODO: this can be removed when Babel supports root: true in package.json extract('babel') } } sortPkg () { // ensure package.json keys has readable order this.pkg.dependencies = sortObject(this.pkg.dependencies) this.pkg.devDependencies = sortObject(this.pkg.devDependencies) this.pkg.scripts = sortObject(this.pkg.scripts, [ 'serve', 'build', 'test', 'e2e', 'lint', 'deploy' ]) this.pkg = sortObject(this.pkg, [ 'name', 'version', 'private', 'scripts', 'dependencies', 'devDependencies', 'vue', 'babel', 'eslintConfig', 'prettier', 'postcss', 'browserslist', 'jest' ]) debug('vue:cli-pkg')(this.pkg) } async resolveFiles () { const files = this.files for (const middleware of this.fileMiddlewares) { await middleware(files, ejs.render) } Object.keys(files).forEach(file => { // normalize paths const normalized = slash(file) if (file !== normalized) { files[normalized] = files[file] delete files[file] } // handle imports and root option injections files[normalized] = injectImportsAndOptions( files[normalized], this.imports[normalized], this.rootOptions[normalized] ) }) for (const postProcess of this.postProcessFilesCbs) { await postProcess(files) } debug('vue:cli-files')(this.files) } hasPlugin (_id) { return [ ...this.plugins.map(p => p.id), ...Object.keys(this.pkg.devDependencies || {}), ...Object.keys(this.pkg.dependencies || {}) ].some(id => matchesPluginId(_id, id)) } printExitLogs () { if (this.exitLogs.length) { this.exitLogs.forEach(({ id, msg, type }) => { const shortId = toShortPluginId(id) const logFn = logTypes[type] if (!logFn) { logger.error(`Invalid api.exitLog type '${type}'.`, shortId) } else { logFn(msg, msg && shortId) } }) logger.log() } } }