@quasar/app-webpack/lib/app-devserver.js

Quasar Framework App CLI with Webpack

const { AppTool } = require('./app-tool.js')
const { printDevRunningBanner } = require('./utils/banner.js')
const { encodeForDiff } = require('./utils/encode-for-diff.js')
const { EntryFilesGenerator } = require('./entry-files-generator.js')
const { generateTypes } = require('./types-generator.js')

function getConfSnapshot (extractFn, quasarConf, diffExtractFnMap) {
  return extractFn(quasarConf, diffExtractFnMap).map(item => (item ? encodeForDiff(item) : ''))
}

module.exports.AppDevserver = class AppDevserver extends AppTool {
  #diffList = {}
  #diffExtractFnMap = {}
  #entryFiles
  #runQueue = Promise.resolve()
  #runId = 0

  constructor (opts) {
    super(opts)

    this.#entryFiles = new EntryFilesGenerator(this.ctx)

    this.registerDiff('entryFiles', quasarConf => ([
      quasarConf.boot,
      quasarConf.css,
      quasarConf.extras,
      quasarConf.animations,
      quasarConf.framework,
      quasarConf.sourceFiles,
      quasarConf.preFetch,
      quasarConf.build.publicPath,
      quasarConf.ctx.mode.ssr === true
        ? [
            quasarConf.ssr.pwa,
            quasarConf.ssr.middlewares,
            quasarConf.ssr.manualStoreSsrContextInjection,
            quasarConf.ssr.manualStoreSerialization,
            quasarConf.ssr.manualStoreHydration,
            quasarConf.ssr.manualPostHydrationTrigger
          ]
        : ''
    ]))

    this.registerDiff('types', quasarConf => ([
      quasarConf.build.typescript,
      quasarConf.build.alias
    ]))

    this.registerDiff('webpackUrl', quasarConf => ([
      quasarConf.metaConf.APP_URL
    ]))

    this.registerDiff('webpack', quasarConf => ([
      quasarConf.eslint,
      quasarConf.htmlVariables,
      quasarConf.devServer,
      quasarConf.build,
      quasarConf.vendor,
      quasarConf.sourceFiles
    ]))

    this.registerDiff('esbuild', quasarConf => [
      quasarConf.eslint,
      quasarConf.build.env,
      quasarConf.build.rawDefine,
      quasarConf.metaConf.fileEnv,
      quasarConf.build.alias,
      quasarConf.build.minify,
      quasarConf.build.esbuildTarget
    ])
  }

  // to be called from inheriting class
  run (quasarConf, __isRetry) {
    if (this.#diff('entryFiles', quasarConf)) {
      this.#entryFiles.generate(quasarConf)
    }

    if (this.#diff('types', quasarConf)) {
      generateTypes(quasarConf)
    }

    if (__isRetry !== true) {
      this.#runId++
    }

    // we return wrappers because we want these methods private
    // -- they shouldn't be called in all scenarios, which is why we
    // artificially restrict them to run() only
    return {
      diff: (name, quasarConf) => this.#diff(name, quasarConf),
      queue: fn => {
        return this.#queue(this.#runId, quasarConf, fn)
      }
    }
  }

  #queue (runId, quasarConf, fn) {
    this.#runQueue = this.#runQueue.then(() => fn()).then(() => {
      if (this.#runId === runId) {
        this.run(quasarConf, true)
      }
    })

    return this.#runQueue
  }

  registerDiff (name, extractFn) {
    this.#diffList[ name ] = {
      snapshot: null,
      extractFn
    }

    this.#diffExtractFnMap[ name ] = extractFn
  }

  #diff (name, quasarConf) {
    const target = this.#diffList[ name ]
    const { snapshot, extractFn } = target

    const newSnapshot = getConfSnapshot(extractFn, quasarConf, this.#diffExtractFnMap)
    target.snapshot = newSnapshot

    if (snapshot === null) {
      return true
    }

    const len = newSnapshot.length
    for (let i = 0; i < len; i++) {
      if (newSnapshot[ i ] !== snapshot[ i ]) {
        // Leave here for debugging when needed
        // console.log(name, 'at index', i)
        // console.log('NEW >>>', newSnapshot[i])
        // console.log('OLD >>>', snapshot[i])
        // console.log('---')

        return true
      }
    }

    return false
  }

  async clearWatcherList (watcherList, clearFn) {
    const list = watcherList.slice()
    clearFn()

    for (const watcher of list) {
      await watcher.close()
    }
  }

  printBanner (quasarConf) {
    printDevRunningBanner(quasarConf)
  }
}