vue3-core/packages/runtime-core/src/compat/globalConfig.ts

import { extend, isArray, isString } from '@vue/shared'
import { AppConfig } from '../apiCreateApp'
import { isRuntimeOnly } from '../component'
import { deepMergeData } from './data'
import {
  DeprecationTypes,
  warnDeprecation,
  isCompatEnabled
} from './compatConfig'
import { isCopyingConfig } from './global'

// legacy config warnings
export type LegacyConfig = {
  /**
   * @deprecated `config.silent` option has been removed
   */
  silent?: boolean
  /**
   * @deprecated use __VUE_PROD_DEVTOOLS__ compile-time feature flag instead
   * https://github.com/vuejs/vue-next/tree/master/packages/vue#bundler-build-feature-flags
   */
  devtools?: boolean
  /**
   * @deprecated use `config.isCustomElement` instead
   * https://v3.vuejs.org/guide/migration/global-api.html#config-ignoredelements-is-now-config-iscustomelement
   */
  ignoredElements?: (string | RegExp)[]
  /**
   * @deprecated
   * https://v3.vuejs.org/guide/migration/keycode-modifiers.html
   */
  keyCodes?: Record<string, number | number[]>
  /**
   * @deprecated
   * https://v3.vuejs.org/guide/migration/global-api.html#config-productiontip-removed
   */
  productionTip?: boolean
}

// dev only
export function installLegacyConfigProperties(config: AppConfig) {
  const legacyConfigOptions: Record<string, DeprecationTypes> = {
    silent: DeprecationTypes.CONFIG_SILENT,
    devtools: DeprecationTypes.CONFIG_DEVTOOLS,
    ignoredElements: DeprecationTypes.CONFIG_IGNORED_ELEMENTS,
    keyCodes: DeprecationTypes.CONFIG_KEY_CODES,
    productionTip: DeprecationTypes.CONFIG_PRODUCTION_TIP
  }

  Object.keys(legacyConfigOptions).forEach(key => {
    let val = (config as any)[key]
    Object.defineProperty(config, key, {
      enumerable: true,
      get() {
        return val
      },
      set(newVal) {
        if (!isCopyingConfig) {
          warnDeprecation(legacyConfigOptions[key], null)
        }
        val = newVal

        // compat for runtime ignoredElements -> isCustomElement
        if (
          key === 'ignoredElements' &&
          isCompatEnabled(DeprecationTypes.CONFIG_IGNORED_ELEMENTS, null) &&
          !isRuntimeOnly() &&
          isArray(newVal)
        ) {
          config.isCustomElement = tag => {
            return newVal.some(
              val => (isString(val) ? val === tag : val.test(tag))
            )
          }
        }
      }
    })
  })

  // Internal merge strats which are no longer needed in v3, but we need to
  // expose them because some v2 plugins will reuse these internal strats to
  // merge their custom options.
  const strats = config.optionMergeStrategies as any
  strats.data = deepMergeData
  // lifecycle hooks
  strats.beforeCreate = mergeHook
  strats.created = mergeHook
  strats.beforeMount = mergeHook
  strats.mounted = mergeHook
  strats.beforeUpdate = mergeHook
  strats.updated = mergeHook
  strats.beforeDestroy = mergeHook
  strats.destroyed = mergeHook
  strats.activated = mergeHook
  strats.deactivated = mergeHook
  strats.errorCaptured = mergeHook
  strats.serverPrefetch = mergeHook
  // assets
  strats.components = mergeObjectOptions
  strats.directives = mergeObjectOptions
  strats.filters = mergeObjectOptions
  // objects
  strats.props = mergeObjectOptions
  strats.methods = mergeObjectOptions
  strats.inject = mergeObjectOptions
  strats.computed = mergeObjectOptions
  // watch has special merge behavior in v2, but isn't actually needed in v3.
  // since we are only exposing these for compat and nobody should be relying
  // on the watch-specific behavior, just expose the object merge strat.
  strats.watch = mergeObjectOptions
}

function mergeHook(to: Function[] | undefined, from: Function | Function[]) {
  return Array.from(new Set([...(to || []), from]))
}

function mergeObjectOptions(to: Object | undefined, from: Object | undefined) {
  return to ? extend(extend(Object.create(null), to), from) : from
}