vitepress-theme-element-plus 0.0.3 → 0.0.4

package/client/hooks/useSize.ts

@@ -1,69 +1,69 @@
-import type { MaybeRef } from '@vueuse/core'
-import type { Ref, ShallowRef } from 'vue'
-import { useEventListener } from '@vueuse/core'
-import { computed, isRef, onMounted, ref, shallowRef, unref, watch } from 'vue'
-import { isString } from '../utils/common'
-
-function getValue(value: string | number): string {
-  return isString(value) ? value : `${value}px`
-}
-
-export interface SizeOptions {
-  width: string | number | undefined
-  height: string | number | undefined
-  ratio: string | number | undefined
-}
-
-export interface SizeInfo<E extends HTMLElement> {
-  el: ShallowRef<E | undefined>
-  width: Ref<string>
-  height: Ref<string>
-  resize: () => void
-}
-
-export function useSize<E extends HTMLElement>(options: SizeOptions, extraHeight: MaybeRef<number> = 0): SizeInfo<E> {
-  const el = shallowRef<E>()
-  const width = computed(() => getValue(unref(options.width) ?? '100%'))
-  const height = ref('auto')
-
-  const getRadio = (ratio: number | string | undefined): number => {
-    if (isString(ratio)) {
-      const [width, height] = ratio.split(':')
-      const parsedRadio = Number(width) / Number(height)
-
-      if (!Number.isNaN(parsedRadio))
-        return parsedRadio
-    }
-
-    return typeof ratio === 'number' ? ratio : 16 / 9
-  }
-
-  const getHeight = (width: number): string => {
-    const height = unref(options.height)
-    const ratio = getRadio(unref(options.ratio))
-
-    return height
-      ? getValue(height)
-      : `${Number(width) / ratio + unref(extraHeight)}px`
-  }
-
-  const updateHeight = (): void => {
-    if (el.value)
-      height.value = getHeight(el.value.clientWidth)
-  }
-
-  onMounted(() => {
-    updateHeight()
-    if (isRef(extraHeight))
-      watch(extraHeight, updateHeight)
-    useEventListener('orientationchange', updateHeight)
-    useEventListener('resize', updateHeight)
-  })
-
-  return {
-    el,
-    width,
-    height,
-    resize: updateHeight,
-  }
-}
+import type { MaybeRef } from '@vueuse/core'
+import type { Ref, ShallowRef } from 'vue'
+import { useEventListener } from '@vueuse/core'
+import { computed, isRef, onMounted, ref, shallowRef, unref, watch } from 'vue'
+import { isString } from '../utils/common'
+
+function getValue(value: string | number): string {
+  return isString(value) ? value : `${value}px`
+}
+
+export interface SizeOptions {
+  width: string | number | undefined
+  height: string | number | undefined
+  ratio: string | number | undefined
+}
+
+export interface SizeInfo<E extends HTMLElement> {
+  el: ShallowRef<E | undefined>
+  width: Ref<string>
+  height: Ref<string>
+  resize: () => void
+}
+
+export function useSize<E extends HTMLElement>(options: SizeOptions, extraHeight: MaybeRef<number> = 0): SizeInfo<E> {
+  const el = shallowRef<E>()
+  const width = computed(() => getValue(unref(options.width) ?? '100%'))
+  const height = ref('auto')
+
+  const getRadio = (ratio: number | string | undefined): number => {
+    if (isString(ratio)) {
+      const [width, height] = ratio.split(':')
+      const parsedRadio = Number(width) / Number(height)
+
+      if (!Number.isNaN(parsedRadio))
+        return parsedRadio
+    }
+
+    return typeof ratio === 'number' ? ratio : 16 / 9
+  }
+
+  const getHeight = (width: number): string => {
+    const height = unref(options.height)
+    const ratio = getRadio(unref(options.ratio))
+
+    return height
+      ? getValue(height)
+      : `${Number(width) / ratio + unref(extraHeight)}px`
+  }
+
+  const updateHeight = (): void => {
+    if (el.value)
+      height.value = getHeight(el.value.clientWidth)
+  }
+
+  onMounted(() => {
+    updateHeight()
+    if (isRef(extraHeight))
+      watch(extraHeight, updateHeight)
+    useEventListener('orientationchange', updateHeight)
+    useEventListener('resize', updateHeight)
+  })
+
+  return {
+    el,
+    width,
+    height,
+    resize: updateHeight,
+  }
+}

package/client/utils/client/common.ts

@@ -1,49 +1,49 @@
-import type { DefaultTheme } from 'vitepress'
-import { isActive } from '../common'
-
-export interface SidebarLink {
-  text: string
-  link: string
-  docFooterText?: string
-}
-export function getFlatSideBarLinks(sidebar: DefaultTheme.SidebarItem[]): SidebarLink[] {
-  const links: SidebarLink[] = []
-
-  function recursivelyExtractLinks(items: DefaultTheme.SidebarItem[]) {
-    for (const item of items) {
-      if (item.text && item.link) {
-        links.push({
-          text: item.text,
-          link: item.link,
-          docFooterText: item.docFooterText,
-        })
-      }
-
-      if (item.items) {
-        recursivelyExtractLinks(item.items)
-      }
-    }
-  }
-
-  recursivelyExtractLinks(sidebar)
-
-  return links
-}
-
-/**
- * Check if the given sidebar item contains any active link.
- */
-export function hasActiveLink(
-  path: string,
-  items: DefaultTheme.SidebarItem | DefaultTheme.SidebarItem[],
-): boolean {
-  if (Array.isArray(items)) {
-    return items.some(item => hasActiveLink(path, item))
-  }
-
-  return isActive(path, items.link)
-    ? true
-    : items.items
-      ? hasActiveLink(path, items.items)
-      : false
-}
+import type { DefaultTheme } from 'vitepress'
+import { isActive } from '../common'
+
+export interface SidebarLink {
+  text: string
+  link: string
+  docFooterText?: string
+}
+export function getFlatSideBarLinks(sidebar: DefaultTheme.SidebarItem[]): SidebarLink[] {
+  const links: SidebarLink[] = []
+
+  function recursivelyExtractLinks(items: DefaultTheme.SidebarItem[]) {
+    for (const item of items) {
+      if (item.text && item.link) {
+        links.push({
+          text: item.text,
+          link: item.link,
+          docFooterText: item.docFooterText,
+        })
+      }
+
+      if (item.items) {
+        recursivelyExtractLinks(item.items)
+      }
+    }
+  }
+
+  recursivelyExtractLinks(sidebar)
+
+  return links
+}
+
+/**
+ * Check if the given sidebar item contains any active link.
+ */
+export function hasActiveLink(
+  path: string,
+  items: DefaultTheme.SidebarItem | DefaultTheme.SidebarItem[],
+): boolean {
+  if (Array.isArray(items)) {
+    return items.some(item => hasActiveLink(path, item))
+  }
+
+  return isActive(path, items.link)
+    ? true
+    : items.items
+      ? hasActiveLink(path, items.items)
+      : false
+}

package/client/utils/client/outline.ts

@@ -1,113 +1,113 @@
-import type { Header } from 'vitepress'
-import type { DefaultTheme } from 'vitepress/theme'
-
-const ignoreRE = /\b(?:VPBadge|header-anchor|footnote-ref|ignore-header)\b/
-
-// cached list of anchor elements from resolveHeaders
-const resolvedHeaders: { element: HTMLHeadElement, link: string }[] = []
-
-export type MenuItem = Omit<Header, 'slug' | 'children'> & {
-  element: HTMLHeadElement
-  children?: MenuItem[]
-}
-
-export function resolveTitle(theme: DefaultTheme.Config): string {
-  return (
-    (typeof theme.outline === 'object'
-      && !Array.isArray(theme.outline)
-      && theme.outline.label)
-    || theme.outlineTitle
-    || 'On this page'
-  )
-}
-
-export function getHeaders(range: DefaultTheme.Config['outline']): MenuItem[] {
-  const headers = Array.from(document.querySelectorAll('.VPDoc :where(h1,h2,h3,h4,h5,h6)'))
-    .filter(el => el.id && el.hasChildNodes())
-    .map((el) => {
-      const level = Number(el.tagName[1])
-      return {
-        element: el as HTMLHeadElement,
-        title: serializeHeader(el),
-        link: `#${el.id}`,
-        level,
-      }
-    })
-
-  return resolveHeaders(headers, range)
-}
-
-function serializeHeader(h: Element): string {
-  let ret = ''
-  for (const node of Array.from(h.childNodes)) {
-    if (node.nodeType === 1) {
-      if (ignoreRE.test((node as Element).className))
-        continue
-      ret += node.textContent
-    }
-    else if (node.nodeType === 3) {
-      ret += node.textContent
-    }
-  }
-  return ret.trim()
-}
-
-export function resolveHeaders(
-  headers: MenuItem[],
-  range?: DefaultTheme.Config['outline'],
-): MenuItem[] {
-  if (range === false) {
-    return []
-  }
-
-  const levelsRange
-    = (typeof range === 'object' && !Array.isArray(range)
-      ? range.level
-      : range) || 2
-
-  const [high, low]: [number, number]
-    = typeof levelsRange === 'number'
-      ? [levelsRange, levelsRange]
-      : levelsRange === 'deep'
-        ? [2, 6]
-        : levelsRange
-
-  return buildTree(headers, high, low)
-}
-
-function buildTree(data: MenuItem[], min: number, max: number): MenuItem[] {
-  resolvedHeaders.length = 0
-
-  const result: MenuItem[] = []
-  const stack: (MenuItem | { level: number, shouldIgnore: true })[] = []
-
-  data.forEach((item) => {
-    const node = { ...item, children: [] }
-    let parent = stack[stack.length - 1]
-
-    while (parent && parent.level >= node.level) {
-      stack.pop()
-      parent = stack[stack.length - 1]
-    }
-
-    if (
-      node.element.classList.contains('ignore-header')
-      || (parent && 'shouldIgnore' in parent)
-    ) {
-      stack.push({ level: node.level, shouldIgnore: true })
-      return
-    }
-
-    if (node.level > max || node.level < min)
-      return
-    resolvedHeaders.push({ element: node.element, link: node.link })
-
-    if (parent)
-      (parent as MenuItem).children.push(node)
-    else result.push(node)
-
-    stack.push(node)
-  })
-
-  return result
-}
+import type { Header } from 'vitepress'
+import type { DefaultTheme } from 'vitepress/theme'
+
+const ignoreRE = /\b(?:VPBadge|header-anchor|footnote-ref|ignore-header)\b/
+
+// cached list of anchor elements from resolveHeaders
+const resolvedHeaders: { element: HTMLHeadElement, link: string }[] = []
+
+export type MenuItem = Omit<Header, 'slug' | 'children'> & {
+  element: HTMLHeadElement
+  children?: MenuItem[]
+}
+
+export function resolveTitle(theme: DefaultTheme.Config): string {
+  return (
+    (typeof theme.outline === 'object'
+      && !Array.isArray(theme.outline)
+      && theme.outline.label)
+    || theme.outlineTitle
+    || 'On this page'
+  )
+}
+
+export function getHeaders(range: DefaultTheme.Config['outline']): MenuItem[] {
+  const headers = Array.from(document.querySelectorAll('.VPDoc :where(h1,h2,h3,h4,h5,h6)'))
+    .filter(el => el.id && el.hasChildNodes())
+    .map((el) => {
+      const level = Number(el.tagName[1])
+      return {
+        element: el as HTMLHeadElement,
+        title: serializeHeader(el),
+        link: `#${el.id}`,
+        level,
+      }
+    })
+
+  return resolveHeaders(headers, range)
+}
+
+function serializeHeader(h: Element): string {
+  let ret = ''
+  for (const node of Array.from(h.childNodes)) {
+    if (node.nodeType === 1) {
+      if (ignoreRE.test((node as Element).className))
+        continue
+      ret += node.textContent
+    }
+    else if (node.nodeType === 3) {
+      ret += node.textContent
+    }
+  }
+  return ret.trim()
+}
+
+export function resolveHeaders(
+  headers: MenuItem[],
+  range?: DefaultTheme.Config['outline'],
+): MenuItem[] {
+  if (range === false) {
+    return []
+  }
+
+  const levelsRange
+    = (typeof range === 'object' && !Array.isArray(range)
+      ? range.level
+      : range) || 2
+
+  const [high, low]: [number, number]
+    = typeof levelsRange === 'number'
+      ? [levelsRange, levelsRange]
+      : levelsRange === 'deep'
+        ? [2, 6]
+        : levelsRange
+
+  return buildTree(headers, high, low)
+}
+
+function buildTree(data: MenuItem[], min: number, max: number): MenuItem[] {
+  resolvedHeaders.length = 0
+
+  const result: MenuItem[] = []
+  const stack: (MenuItem | { level: number, shouldIgnore: true })[] = []
+
+  data.forEach((item) => {
+    const node = { ...item, children: [] }
+    let parent = stack[stack.length - 1]
+
+    while (parent && parent.level >= node.level) {
+      stack.pop()
+      parent = stack[stack.length - 1]
+    }
+
+    if (
+      node.element.classList.contains('ignore-header')
+      || (parent && 'shouldIgnore' in parent)
+    ) {
+      stack.push({ level: node.level, shouldIgnore: true })
+      return
+    }
+
+    if (node.level > max || node.level < min)
+      return
+    resolvedHeaders.push({ element: node.element, link: node.link })
+
+    if (parent)
+      (parent as MenuItem).children.push(node)
+    else result.push(node)
+
+    stack.push(node)
+  })
+
+  return result
+}

package/client/utils/common.ts

@@ -1,90 +1,90 @@
-const HASH_RE = /#.*$/
-const HASH_OR_QUERY_RE = /[?#].*$/
-const INDEX_OR_EXT_RE = /(?:(^|\/)index)?\.(?:md|html)$/
-
-export const inBrowser = typeof document !== 'undefined'
-
-export function isActive(
-  currentPath: string,
-  matchPath?: string,
-  asRegex: boolean = false,
-): boolean {
-  if (matchPath === undefined) {
-    return false
-  }
-
-  currentPath = normalize(`/${currentPath}`)
-
-  if (asRegex) {
-    return new RegExp(matchPath).test(currentPath)
-  }
-
-  if (normalize(matchPath) !== currentPath) {
-    return false
-  }
-
-  const hashMatch = matchPath.match(HASH_RE)
-
-  if (hashMatch) {
-    return (inBrowser ? location.hash : '') === hashMatch[0]
-  }
-
-  return true
-}
-
-function normalize(path: string): string {
-  return decodeURI(path)
-    .replace(HASH_OR_QUERY_RE, '')
-    .replace(INDEX_OR_EXT_RE, '$1')
-}
-
-export function ensureStartingSlash(path: string): string {
-  return /^\//.test(path) ? path : `/${path}`
-}
-
-export function isPlainObject(obj: any) {
-  // 首先排除 null 和非对象类型
-  if (obj === null || typeof obj !== 'object') {
-    return false
-  }
-
-  // 检查对象的构造函数是否是 Object
-  if (obj.constructor !== Object) {
-    return false
-  }
-
-  // 检查对象的原型是否是 Object.prototype
-  if (Object.getPrototypeOf(obj) !== Object.prototype) {
-    return false
-  }
-
-  return true
-}
-
-export function isString(value) {
-  return typeof value === 'string'
-}
-
-export function capitalizeFirstLetter(string: string) {
-  if (!string)
-    return '' // 如果字符串为空，返回空字符串
-  return string.charAt(0).toUpperCase() + string.slice(1)
-}
-
-export function throttleAndDebounce(fn: () => void, delay: number): () => void {
-  let timeoutId: NodeJS.Timeout
-  let called = false
-
-  return () => {
-    if (timeoutId)
-      clearTimeout(timeoutId)
-
-    if (!called) {
-      fn()
-      ;(called = true) && setTimeout(() => (called = false), delay)
-    }
-    else {
-      timeoutId = setTimeout(fn, delay)
-    }
-  }
-}
+const HASH_RE = /#.*$/
+const HASH_OR_QUERY_RE = /[?#].*$/
+const INDEX_OR_EXT_RE = /(?:(^|\/)index)?\.(?:md|html)$/
+
+export const inBrowser = typeof document !== 'undefined'
+
+export function isActive(
+  currentPath: string,
+  matchPath?: string,
+  asRegex: boolean = false,
+): boolean {
+  if (matchPath === undefined) {
+    return false
+  }
+
+  currentPath = normalize(`/${currentPath}`)
+
+  if (asRegex) {
+    return new RegExp(matchPath).test(currentPath)
+  }
+
+  if (normalize(matchPath) !== currentPath) {
+    return false
+  }
+
+  const hashMatch = matchPath.match(HASH_RE)
+
+  if (hashMatch) {
+    return (inBrowser ? location.hash : '') === hashMatch[0]
+  }
+
+  return true
+}
+
+function normalize(path: string): string {
+  return decodeURI(path)
+    .replace(HASH_OR_QUERY_RE, '')
+    .replace(INDEX_OR_EXT_RE, '$1')
+}
+
+export function ensureStartingSlash(path: string): string {
+  return /^\//.test(path) ? path : `/${path}`
+}
+
+export function isPlainObject(obj: any) {
+  // 首先排除 null 和非对象类型
+  if (obj === null || typeof obj !== 'object') {
+    return false
+  }
+
+  // 检查对象的构造函数是否是 Object
+  if (obj.constructor !== Object) {
+    return false
+  }
+
+  // 检查对象的原型是否是 Object.prototype
+  if (Object.getPrototypeOf(obj) !== Object.prototype) {
+    return false
+  }
+
+  return true
+}
+
+export function isString(value) {
+  return typeof value === 'string'
+}
+
+export function capitalizeFirstLetter(string: string) {
+  if (!string)
+    return '' // 如果字符串为空，返回空字符串
+  return string.charAt(0).toUpperCase() + string.slice(1)
+}
+
+export function throttleAndDebounce(fn: () => void, delay: number): () => void {
+  let timeoutId: NodeJS.Timeout
+  let called = false
+
+  return () => {
+    if (timeoutId)
+      clearTimeout(timeoutId)
+
+    if (!called) {
+      fn()
+      ;(called = true) && setTimeout(() => (called = false), delay)
+    }
+    else {
+      timeoutId = setTimeout(fn, delay)
+    }
+  }
+}