vite-pages-theme-doc/src/utils.ts

A document theme for vite-plugin-react-pages.

import { useLayoutEffect, useEffect } from 'react'
import { IS_SSR } from 'vite-plugin-react-pages/client'

import type { I18nConfig, LocalConfig } from './ThemeConfig.doc'

export function withClsPrefix(cls: string) {
  return `vp-theme-${cls}`
}

export function removeStartSlash(s: string) {
  return s.replace(/^\//, '')
}

export function removeTrailingSlash(s: string) {
  return s.replace(/\/$/, '')
}

export function ensureStartSlash(s: string) {
  return '/' + removeStartSlash(s)
}

export function normalizeI18nConfig(
  i18n: I18nConfig | undefined
): I18nConfig | undefined {
  if (!i18n) return i18n
  const newLocales = Object.fromEntries(
    Object.entries(i18n.locales).map(([key, locale]) => {
      const newLocale: LocalConfig = { ...locale }
      if (newLocale.label === undefined) newLocale.label = key
      if (newLocale.lang === undefined) newLocale.lang = key
      if (newLocale.routePrefix === undefined) newLocale.routePrefix = key
      newLocale.routePrefix = ensureStartSlash(
        removeTrailingSlash(newLocale.routePrefix)
      )
      return [key, locale]
    })
  )
  return { ...i18n, locales: newLocales }
}

export function getStaticDataValue(pageStaticData: any, key: string) {
  return pageStaticData?.[key] ?? pageStaticData?.main?.[key]
}

/**
 * normalize commonjs export so that it works with rollup(vite build)
 * and native node esm (vite ssr)
 *
 * https://github.com/evanw/esbuild/issues/532#issuecomment-1044740080
 */
export function commonjsExportsInterop<T>(commonjsExports: T) {
  if (
    (commonjsExports as any).__esModule === true &&
    'default' in (commonjsExports as any)
  )
    return (commonjsExports as any).default as T
  return commonjsExports
}

export const Anchor_Scroll_Offset = 72

export const isSSR = IS_SSR

// fix warning of useLayoutEffect during ssr
// https://gist.github.com/gaearon/e7d97cdf38a2907924ea12e4ebdf3c85
export const useIsomorphicLayoutEffect = isSSR ? useEffect : useLayoutEffect