vuepress-theme-plume/theme/src/node/detector/dependency.ts

import type { ThemeBuiltinPlugins, ThemeOptions } from '../../shared/index.js'
import { isEmptyObject, isPlainObject } from '@pengzhanbo/utils'
import { isPackageExists } from 'local-pkg'
import { getUserAgent, resolveCommand } from 'package-manager-detector'
import { colors } from 'vuepress/utils'
import { createTranslate, logger } from '../utils/index.js'

const DEPENDENCIES: Record<string, string[]> = {
  twoslash: ['@vuepress/shiki-twoslash'],
  pythonRepl: ['pyodide'],

  chartjs: ['chart.js'],
  echarts: ['echarts'],
  markmap: ['markmap-lib', 'markmap-toolbar', 'markmap-view'],
  mermaid: ['mermaid'],
  flowchart: ['flowchart.ts'],

  artPlayer: ['artplayer'],
  mathjax: ['mathjax-full'],
}

const t = createTranslate({
  en: {
    notFoundDeps: 'Enabling features such as {{ features }} requires the installation of the following dependencies: {{ dependencies }}',
    install: 'Run the command to install:  {{ command }}',
  },
  zh: {
    notFoundDeps: '启用 {{ features }} 等功能需要安装以下依赖: {{ dependencies }}',
    install: '运行安装命令:  {{ command }}',
  },
})

/**
 * 部分功能需要手动安装依赖，
 * 检查环境中是否缺少依赖
 */
export function detectDependencies(options: ThemeOptions, plugins: ThemeBuiltinPlugins): void {
  const shouldInstall: Record<string, string[]> = {}

  const markdown = options.markdown || {}
  const mdPower = isPlainObject(plugins.markdownPower) ? plugins.markdownPower : {}
  const mdEnhance = isPlainObject(plugins.markdownEnhance) ? plugins.markdownEnhance : {}

  const add = (name: string) => {
    const list = DEPENDENCIES[name].filter(dep => !isPackageExists(dep))
    if (list.length)
      shouldInstall[name] = list
  }

  if (options.codeHighlighter && options.codeHighlighter.twoslash)
    add('twoslash')

  if (markdown.repl && markdown.repl.python)
    add('pythonRepl')

  ;['chartjs', 'echarts', 'markmap', 'mermaid', 'flowchart'].forEach((dep) => {
    if (markdown[dep] || mdEnhance[dep])
      add(dep)
  })

  const math = markdown.math || plugins.markdownMath
  if (math && math.type === 'mathjax')
    add('mathjax')

  if (markdown.artPlayer || mdPower.artPlayer)
    add('artPlayer')

  if (isEmptyObject(shouldInstall))
    return

  const features = Object.keys(shouldInstall)
  const dependencies = Object.values(shouldInstall).flat()

  logger.error(t('notFoundDeps', {
    features: features.map(feat => colors.green(feat)).join(', '),
    dependencies: dependencies.map(dep => colors.magenta(dep)).join(', '),
  }))

  const agent = getUserAgent()
  if (agent) {
    const { command = '', args = [] } = resolveCommand(agent, 'add', dependencies) || {}

    logger.info(t('install', {
      command: colors.cyan(`${command} ${
        args.join(' ').replace(DEPENDENCIES.twoslash[0], `${DEPENDENCIES.twoslash[0]}@next`)
      }`),
    }))
  }
}