Skip to content

Function: mergeVitePressSidebar()

Merges generated API docs sidebar data into an existing VitePress sidebar.

Signature

ts
export function mergeVitePressSidebar(sidebar: unknown, generated: VitePressSidebarItem, options: MergeVitePressSidebarOptions = {}): unknown

Parameters

NameTypeDescription
sidebarunknownExisting VitePress sidebar configuration.
generatedVitePressSidebarItemGenerated API docs sidebar section.
optionsMergeVitePressSidebarOptionsSidebar merge options. (optional, default: {})

Returns

unknown — Updated VitePress sidebar configuration.

Examples

ts
import { mergeVitePressSidebar } from 'vitepress-api-references'

const sidebar = mergeVitePressSidebar(
  [{ text: 'Guide', link: '/guide/' }],
  { text: 'API Reference', items: [{ text: 'Config', link: '/api/config' }] },
  { insert: 'append' }
)