valaxy 0.3.11 → 0.6.0

package/dist/node/index.d.ts

@@ -1,12 +1,11 @@
 import * as vite from 'vite';
 import { InlineConfig } from 'vite';
-import { V as ValaxyConfig } from '../config-de04677b.js';
+import { V as ValaxyConfig } from '../config-ad23e743.js';
 import 'type-fest';
 import 'unocss/vite';
 import 'markdown-it';
 import 'markdown-it-anchor';
 import 'katex';
-import 'vite-plugin-md';
 
 interface ResolvedValaxyOptions {
     mode: 'dev' | 'build';
@@ -36,6 +35,7 @@ interface ResolvedValaxyOptions {
      * config file path
      */
     configFile: string;
+    pages: string[];
 }
 interface ValaxyServerOptions {
     onConfigReload?: (newConfig: ValaxyConfig, config: ValaxyConfig) => void;

package/dist/node/index.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkABPVSNYIjs = require('../chunk-ABPVSNYI.js');require('../chunk-V3BMKLEW.js');exports.createServer = _chunkABPVSNYIjs.g;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkCP3UCJ2Djs = require('../chunk-CP3UCJ2D.js');require('../chunk-U5OMNIOK.js');exports.createServer = _chunkCP3UCJ2Djs.f;

package/dist/node/index.mjs

@@ -1 +1 @@
-import{g as o}from"../chunk-QOANGHSR.mjs";import"../chunk-6LIOFBAA.mjs";export{o as createServer};
+import{f as o}from"../chunk-HCVZ2UUO.mjs";import"../chunk-EAN2KU6W.mjs";export{o as createServer};

package/{src/index.ts → index.ts}

@@ -1,2 +1,3 @@
 export * from './client'
 export * from './types'
+export * from './config'

package/{src/node → node}/cli.ts

@@ -9,7 +9,8 @@ import openBrowser from 'open'
 import consola from 'consola'
 
 import { yellow } from 'kolorist'
-import { version } from '../../package.json'
+import { version } from '../package.json'
+import { findFreePort } from './utils/net'
 import { resolveOptions } from './options'
 import { bindShortcut, initServer, printInfo } from './utils/cli'
 
@@ -59,7 +60,7 @@ cli.command(
     if (!fs.existsSync(path.resolve(root, 'pages')))
       process.exit(0)
 
-    const port = userPort || 4859
+    const port = await findFreePort(userPort || 4859)
     const options = await resolveOptions({ userRoot: root })
 
     const viteConfig: InlineConfig = {

package/node/config.ts

@@ -0,0 +1,156 @@
+// import { loadConfig } from 'c12'
+import fs from 'fs'
+import { loadConfig } from 'unconfig'
+import defu from 'defu'
+import type { ValaxyConfig } from '../types'
+import type { ValaxyEntryOptions } from './options'
+
+const defaultValaxyConfig: ValaxyConfig = {
+  url: '/',
+  lang: 'en',
+  title: 'Valaxy Blog',
+  description: 'A blog generated by Valaxy.',
+  subtitle: 'Next Generation Static Blog Framework.',
+  author: {
+    avatar: 'https://cdn.jsdelivr.net/gh/YunYouJun/yun/images/meme/yun-good-with-bg.jpg',
+    email: 'me@yunyoujun.cn',
+    link: 'https://www.yunyoujun.cn',
+    name: 'YunYouJun',
+    status: {
+      emoji: '😊',
+      message: 'All at sea.',
+    },
+  },
+  favicon: '/favicon.svg',
+  feed: {
+    name: '',
+    favicon: 'favicon.svg',
+  },
+  social: [],
+
+  lastUpdated: true,
+
+  license: {
+    enabled: true,
+    language: '',
+    type: 'by-nc-sa',
+  },
+
+  sponsor: {
+    enable: true,
+    title: '我很可爱，请给我钱',
+    methods: [
+      {
+        name: '支付宝',
+        url: 'https://cdn.jsdelivr.net/gh/YunYouJun/cdn/img/donate/alipay-qrcode.jpg',
+        color: '#00A3EE',
+        icon: 'i-ri-alipay-line',
+      },
+      {
+        name: 'QQ 支付',
+        url: 'https://cdn.jsdelivr.net/gh/YunYouJun/cdn/img/donate/qqpay-qrcode.png',
+        color: '#12B7F5',
+        icon: 'i-ri-qq-line',
+      },
+      {
+        name: '微信支付',
+        url: 'https://cdn.jsdelivr.net/gh/YunYouJun/cdn/img/donate/wechatpay-qrcode.jpg',
+        color: '#2DC100',
+        icon: 'i-ri-wechat-pay-line',
+      },
+
+    ],
+  },
+
+  search: {
+    enable: true,
+    algolia: {
+      enable: false,
+      appId: '',
+      apiKey: '',
+      indexName: '',
+    },
+  },
+
+  comment: {
+    waline: {
+      enable: false,
+      serverURL: '',
+    },
+    twikoo: {
+      enable: false,
+      envId: 'https://twikoo.vercel.app',
+    },
+  },
+
+  features: {
+    katex: true,
+  },
+
+  theme: 'yun',
+  themeConfig: {
+    pkg: {
+      name: '',
+      version: '',
+    },
+  },
+
+  unocss: {},
+
+  // markdown: {
+  //   excerpt: '<!-- more -->',
+  // },
+
+  markdownIt: {
+    toc: {
+      includeLevel: [1, 2, 3, 4],
+      listType: 'ol',
+    },
+    katex: {},
+  },
+}
+
+// for user config
+export async function resolveConfig(options: ValaxyEntryOptions = {}) {
+  // c12 merge array twice, so i deprecated it
+  // const { config, configFile } = await loadConfig<ValaxyConfig>({
+  //   name: 'valaxy',
+  //   defaults: defaultValaxyConfig,
+  // })
+
+  const { config: userConfig, sources } = await loadConfig<ValaxyConfig>({
+    sources: [
+      {
+        files: 'valaxy.config',
+        extensions: ['ts', 'js', 'mjs', 'cjs', 'json'],
+      },
+    ],
+    merge: false,
+  })
+  const configFile = sources[0]
+  const config = defu(userConfig, defaultValaxyConfig)
+
+  const theme = options.theme || config.theme || 'yun'
+
+  try {
+    const { defaultThemeConfig } = await import(`valaxy-theme-${theme}`)
+    config.themeConfig = defu(config.themeConfig, defaultThemeConfig)
+  }
+  catch (e) {
+    console.error(`valaxy-theme-${theme} doesn't have default config`)
+  }
+
+  try {
+    const pkg = fs.readFileSync(require.resolve(`valaxy-theme-${theme}/package.json`), 'utf-8')
+    config.themeConfig.pkg = JSON.parse(pkg)
+  }
+  catch (e) {
+    console.error(`valaxy-theme-${theme} doesn't have package.json`)
+  }
+
+  return {
+    config,
+    configFile,
+    theme,
+  }
+}

package/{src/node → node}/markdown/index.ts

@@ -1,4 +1,4 @@
-import type MarkdownIt from 'markdown-it'
+import MarkdownIt from 'markdown-it'
 
 import Anchor from 'markdown-it-anchor'
 import Emoji from 'markdown-it-emoji'
@@ -8,30 +8,23 @@ import TaskLists from 'markdown-it-task-lists'
 import attrs from 'markdown-it-attrs'
 
 import type { KatexOptions } from 'katex'
+import type { Header } from '../../types'
 import Katex from './markdown-it/katex'
 import { containerPlugin } from './markdown-it/container'
-// import { headingPlugin } from './markdown-it/headings'
+import { headingPlugin } from './markdown-it/headings'
 import { slugify } from './slugify'
 import { parseHeader } from './markdown-it/parseHeader'
 import { highlight } from './highlight'
 import { highlightLinePlugin, preWrapperPlugin } from './markdown-it/highlightLines'
 
-export interface Header {
-  level: number
-  title: string
-  slug: string
-  /**
-   * i18n
-   */
-  lang?: string
-}
-
 export interface MarkdownParsedData {
   hoistedTags?: string[]
   links?: string[]
   headers?: Header[]
 }
 export interface MarkdownRenderer extends MarkdownIt {
+  __path: string
+  __relativePath: string
   __data: MarkdownParsedData
 }
 
@@ -59,7 +52,7 @@ export function setupMarkdownPlugins(md: MarkdownIt, mdOptions: MarkdownOptions
     // conflict with {% %}
     .use(attrs)
     // generate toc in client
-    // .use(headingPlugin, mdOptions?.toc?.includeLevel)
+    .use(headingPlugin, mdOptions?.toc?.includeLevel)
     // .use(lineNumberPlugin)
   // https://github.com/arve0/markdown-it-attrs
   // add classes
@@ -93,3 +86,18 @@ export function setupMarkdownPlugins(md: MarkdownIt, mdOptions: MarkdownOptions
 
   return md as MarkdownRenderer
 }
+
+export const createMarkdownRenderer = async (
+  srcDir: string,
+  options: MarkdownOptions = {},
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  base = '/',
+): Promise<MarkdownRenderer> => {
+  const md = MarkdownIt({
+    html: true,
+    linkify: true,
+    ...options,
+  }) as MarkdownRenderer
+  setupMarkdownPlugins(md)
+  return md
+}

package/node/markdown/markdownToVue.ts

@@ -0,0 +1,253 @@
+// copy from vitepress
+import fs from 'fs'
+import path from 'path'
+import c from 'picocolors'
+import matter from 'gray-matter'
+import LRUCache from 'lru-cache'
+import _debug from 'debug'
+import { getGitTimestamp, slash, transformObject } from '../utils'
+import { EXTERNAL_URL_RE } from '../../shared'
+import type { HeadConfig, PageData } from '../../types'
+import { deeplyParseHeader } from './markdown-it/parseHeader'
+import { createMarkdownRenderer } from '.'
+import type { MarkdownOptions } from '.'
+
+const debug = _debug('vitepress:md')
+const cache = new LRUCache<string, MarkdownCompileResult>({ max: 1024 })
+const includesRE = /<!--\s*@include:\s*(.*?)\s*-->/g
+
+export interface MarkdownCompileResult {
+  vueSrc: string
+  pageData: PageData
+  deadLinks: string[]
+  includes: string[]
+}
+
+const inferTitle = (frontmatter: Record<string, any>, content: string) => {
+  if (frontmatter.title)
+    return deeplyParseHeader(frontmatter.title)
+
+  const match = content.match(/^\s*#+\s+(.*)/m)
+
+  if (match)
+    return deeplyParseHeader(match[1].trim())
+
+  return ''
+}
+
+const getHeadMetaContent = (
+  head: HeadConfig[],
+  name: string,
+): string | undefined => {
+  if (!head || !head.length)
+    return undefined
+
+  const meta = head.find(([tag, attrs = {}]) => {
+    return tag === 'meta' && attrs.name === name && attrs.content
+  })
+
+  return meta && meta[1].content
+}
+
+const inferDescription = (frontmatter: Record<string, any>) => {
+  const { description, head } = frontmatter
+
+  if (description !== undefined)
+    return description
+
+  return (head && getHeadMetaContent(head, 'description')) || ''
+}
+
+export async function createMarkdownToVueRenderFn(
+  srcDir: string,
+  options: MarkdownOptions = {},
+  pages: string[],
+  userDefines: Record<string, any> | undefined,
+  isBuild = false,
+  base = '/',
+  includeLastUpdatedData = false,
+) {
+  const md = await createMarkdownRenderer(srcDir, options, base)
+
+  pages = pages.map(p => slash(p.replace(/\.md$/, '')))
+
+  const userDefineRegex = userDefines
+    ? new RegExp(
+        `\\b(${Object.keys(userDefines)
+          .map(key => key.replace(/[-[\]/{}()*+?.\\^$|]/g, '\\$&'))
+          .join('|')})`,
+        'g',
+    )
+    : null
+
+  return async (
+    src: string,
+    file: string,
+    publicDir: string,
+  ): Promise<MarkdownCompileResult> => {
+    const relativePath = slash(path.relative(srcDir, file))
+    const dir = path.dirname(file)
+
+    const cached = cache.get(src)
+    if (cached) {
+      debug(`[cache hit] ${relativePath}`)
+      return cached
+    }
+
+    const start = Date.now()
+
+    // resolve includes
+    const includes: string[] = []
+    src = src.replace(includesRE, (_, m1) => {
+      const includePath = path.join(dir, m1)
+      const content = fs.readFileSync(includePath, 'utf-8')
+      includes.push(slash(includePath))
+      return content
+    })
+
+    const { content, data: frontmatter } = matter(src)
+
+    // reset state before render
+    md.__path = file
+    md.__relativePath = relativePath
+
+    let html = md.render(content)
+    const data = md.__data
+
+    if (isBuild) {
+      // avoid env variables being replaced by vite
+      html = html
+        .replace(/\bimport\.meta/g, 'import.<wbr/>meta')
+        .replace(/\bprocess\.env/g, 'process.<wbr/>env')
+
+      // also avoid replacing vite user defines
+      if (userDefineRegex) {
+        html = html.replace(
+          userDefineRegex,
+          _ => `${_[0]}<wbr/>${_.slice(1)}`,
+        )
+      }
+    }
+
+    // validate data.links
+    const deadLinks: string[] = []
+    const recordDeadLink = (url: string) => {
+      console.warn(
+        c.yellow(
+          `\n(!) Found dead link ${c.cyan(url)} in file ${c.white(c.dim(file))}`,
+        ),
+      )
+      deadLinks.push(url)
+    }
+
+    if (data.links) {
+      const dir = path.dirname(file)
+      for (let url of data.links) {
+        if (/\.(?!html|md)\w+($|\?)/i.test(url))
+          continue
+
+        if (url.replace(EXTERNAL_URL_RE, '').startsWith('//localhost:')) {
+          recordDeadLink(url)
+          continue
+        }
+
+        url = url.replace(/[?#].*$/, '').replace(/\.(html|md)$/, '')
+        if (url.endsWith('/'))
+          url += 'index'
+        const resolved = decodeURIComponent(
+          slash(
+            url.startsWith('/')
+              ? url.slice(1)
+              : path.relative(srcDir, path.resolve(dir, url)),
+          ),
+        )
+        if (
+          !pages.includes(resolved)
+          && !fs.existsSync(path.resolve(dir, publicDir, `${resolved}.html`))
+        )
+          recordDeadLink(url)
+      }
+    }
+
+    const pageData: PageData = {
+      title: inferTitle(frontmatter, content),
+      titleTemplate: frontmatter.titleTemplate,
+      description: inferDescription(frontmatter),
+      frontmatter,
+      headers: data.headers || [],
+      relativePath,
+      path: path.join(srcDir, relativePath),
+    }
+
+    if (includeLastUpdatedData)
+      pageData.lastUpdated = await getGitTimestamp(file)
+
+    const valaxyMd = 'ValaxyMd'
+    const vueSrc
+      = `${genPageDataCode(data.hoistedTags || [], pageData).join('\n')
+      }\n<template><${valaxyMd} :frontmatter="frontmatter">${html}</${valaxyMd}></template>`
+
+    debug(`[render] ${file} in ${Date.now() - start}ms.`)
+
+    const result = {
+      vueSrc,
+      pageData,
+      deadLinks,
+      includes,
+    }
+    cache.set(src, result)
+    return result
+  }
+}
+
+const scriptRE = /<\/script>/
+const scriptLangTsRE = /<\s*script[^>]*\blang=['"]ts['"][^>]*/
+const scriptSetupRE = /<\s*script[^>]*\bsetup\b[^>]*/
+const scriptClientRE = /<\s*script[^>]*\bclient\b[^>]*/
+const defaultExportRE = /((?:^|\n|;)\s*)export(\s*)default/
+const namedDefaultExportRE = /((?:^|\n|;)\s*)export(.+)as(\s*)default/
+
+function genPageDataCode(tags: string[], data: PageData) {
+  const code = `\nexport const __pageData = ${transformObject(data)}`
+
+  const existingScriptIndex = tags.findIndex((tag) => {
+    return (
+      scriptRE.test(tag)
+      && !scriptSetupRE.test(tag)
+      && !scriptClientRE.test(tag)
+    )
+  })
+
+  const isUsingTS = tags.findIndex(tag => scriptLangTsRE.test(tag)) > -1
+
+  const exportScript = `
+  export default {
+    name:'${data.relativePath}',
+    data() {
+      return {frontmatter:${transformObject(data.frontmatter)}}
+    }
+  }`
+
+  if (existingScriptIndex > -1) {
+    const tagSrc = tags[existingScriptIndex]
+    // user has <script> tag inside markdown
+    // if it doesn't have export default it will error out on build
+    const hasDefaultExport
+      = defaultExportRE.test(tagSrc) || namedDefaultExportRE.test(tagSrc)
+    tags[existingScriptIndex] = tagSrc.replace(
+      scriptRE,
+      `${code
+        + (hasDefaultExport
+          ? ''
+          : `\n${exportScript}`)
+        }</script>`,
+    )
+  }
+  else {
+    tags.unshift(
+      `<script ${isUsingTS ? 'lang="ts"' : ''}>${code}\n${exportScript}</script>`,
+    )
+  }
+
+  return tags
+}

package/{src/node → node}/options.ts

@@ -1,5 +1,6 @@
 import { dirname, resolve } from 'path'
 import _debug from 'debug'
+import fg from 'fast-glob'
 import type { ValaxyConfig } from '../types'
 import { resolveConfig } from './config'
 import { resolveImportPath } from './utils'
@@ -43,6 +44,7 @@ export interface ResolvedValaxyOptions {
    * config file path
    */
   configFile: string
+  pages: string[]
 }
 
 export interface ValaxyServerOptions {
@@ -66,17 +68,30 @@ export function getThemeRoot(name: string, entry: string) {
   if (isPath(name))
     return resolve(dirname(entry), name)
   else
-    return resolveImportPath(`valaxy-theme-${name}/package.json`)
+    return dirname(resolveImportPath(`valaxy-theme-${name}/package.json`) || '')
 }
 
 // for cli options
 export async function resolveOptions(options: ValaxyEntryOptions, mode: ResolvedValaxyOptions['mode'] = 'dev') {
-  const clientRoot = resolve(resolveImportPath('valaxy/package.json'), 'src/client')
+  const clientRoot = resolve(dirname(resolveImportPath('valaxy/package.json', true)), 'client')
   const userRoot = resolve(options.userRoot || process.cwd())
 
   const { config: valaxyConfig, configFile, theme } = await resolveConfig(options)
   const themeRoot = getThemeRoot(theme, userRoot)
 
+  // Important: fast-glob doesn't guarantee order of the returned files.
+  // We must sort the pages so the input list to rollup is stable across
+  // builds - otherwise different input order could result in different exports
+  // order in shared chunks which in turns invalidates the hash of every chunk!
+  // JavaScript built-in sort() is mandated to be stable as of ES2019 and
+  // supported in Node 12+, which is required by Vite.
+  const pages = (
+    await fg(['**.md'], {
+      cwd: userRoot,
+      ignore: ['**/node_modules'],
+    })
+  ).sort()
+
   const valaxyOptions: ResolvedValaxyOptions = {
     mode,
     clientRoot,
@@ -85,6 +100,7 @@ export async function resolveOptions(options: ValaxyEntryOptions, mode: Resolved
     theme,
     config: valaxyConfig,
     configFile: configFile || '',
+    pages,
   }
   debug(valaxyOptions)
 

package/{src/node → node}/plugins/extendConfig.ts

@@ -13,13 +13,14 @@ export function createConfigPlugin(options: ResolvedValaxyOptions): Plugin {
           alias: {
             '@/': `${toAtFS(options.userRoot)}/`,
             '~/': `${toAtFS(options.clientRoot)}/`,
+            'valaxy/client': `${toAtFS(options.clientRoot)}/`,
+            'valaxy': toAtFS(resolve(options.clientRoot, 'index.ts')),
             '@valaxyjs/client': `${toAtFS(options.clientRoot)}/`,
             '@valaxyjs/config': '/@valaxyjs/config',
+            '@valaxyjs/context': '/@valaxyjs/context',
             'valaxy/package.json': toAtFS(resolve(options.clientRoot, '../../package.json')),
-            'valaxy/': `${toAtFS(resolve(options.clientRoot, '../..'))}/`,
-            'valaxy': toAtFS(resolve(options.clientRoot, '../index.ts')),
             [`valaxy-theme-${options.theme}/`]: `${toAtFS(resolve(options.themeRoot))}/`,
-            [`valaxy-theme-${options.theme}`]: `${toAtFS(resolve(options.themeRoot))}`,
+            [`valaxy-theme-${options.theme}`]: `${toAtFS(resolve(options.themeRoot))}/index.ts`,
           },
         },
 
@@ -35,6 +36,8 @@ export function createConfigPlugin(options: ResolvedValaxyOptions): Plugin {
             'dayjs',
             'nprogress',
           ],
+
+          exclude: ['@docsearch/js'],
         },
       }
       return mergeConfig(config, injection)