import { DocSearchProps } from './docsearch.js' import { LocalSearchTranslations } from './local-search.js' export namespace DefaultTheme { export interface Config { /** * The logo file of the site. * * @example '/logo.svg' */ logo?: ThemeableImage /** * Custom site title in navbar. If the value is undefined, * `config.title` will be used. */ siteTitle?: string | false /** * Custom header levels of outline in the aside component. * * @default 2 */ outline?: Outline | Outline['level'] | false /** * @deprecated * Use `outline.label` instead. * * @default 'On this page' */ outlineTitle?: string /** * The nav items. */ nav?: NavItem[] /** * The sidebar items. */ sidebar?: Sidebar /** * Set to `false` to prevent rendering of aside container. * Set to `true` to render the aside to the right. * Set to `left` to render the aside to the left. * * @default true */ aside?: boolean | 'left' /** * Info for the edit link. If it's undefined, the edit link feature will * be disabled. */ editLink?: EditLink /** * Set custom last updated text. * * @default 'Last updated' */ lastUpdatedText?: string /** * Set custom prev/next labels. */ docFooter?: DocFooter /** * The social links to be displayed at the end of the nav bar. Perfect for * placing links to social services such as GitHub, Twitter, Facebook, etc. */ socialLinks?: SocialLink[] /** * The footer configuration. */ footer?: Footer /** * @default 'Appearance' */ darkModeSwitchLabel?: string /** * @default 'Menu' */ sidebarMenuLabel?: string /** * @default 'Return to top' */ returnToTopLabel?: string /** * Set custom `aria-label` for language menu button. * * @default 'Change language' */ langMenuLabel?: string search?: | { provider: 'local'; options?: LocalSearchOptions } | { provider: 'algolia'; options: AlgoliaSearchOptions } /** * @deprecated Use `search` instead. */ algolia?: AlgoliaSearchOptions /** * The carbon ads options. Leave it undefined to disable the ads feature. */ carbonAds?: CarbonAdsOptions /** * Changing locale when current url is `/foo` will redirect to `/locale/foo`. * * @default true */ i18nRouting?: boolean } // nav ----------------------------------------------------------------------- export type NavItem = NavItemWithLink | NavItemWithChildren export interface NavItemWithLink { text: string link: string /** * `activeMatch` is expected to be a regex string. We can't use actual * RegExp object here because it isn't serializable */ activeMatch?: string target?: string rel?: string } export interface NavItemChildren { text?: string items: NavItemWithLink[] } export interface NavItemWithChildren { text?: string items: (NavItemChildren | NavItemWithLink)[] /** * `activeMatch` is expected to be a regex string. We can't use actual * RegExp object here because it isn't serializable */ activeMatch?: string } // image --------------------------------------------------------------------- export type ThemeableImage = | string | { src: string; alt?: string } | { light: string; dark: string; alt?: string } export type FeatureIcon = | string | { src: string; alt?: string; width?: string; height: string } | { light: string dark: string alt?: string width?: string height: string } // sidebar ------------------------------------------------------------------- export type Sidebar = SidebarItem[] | SidebarMulti export interface SidebarMulti { [path: string]: SidebarItem[] } export type SidebarItem = { /** * The text label of the item. */ text?: string /** * The link of the item. */ link?: string /** * The children of the item. */ items?: SidebarItem[] /** * If not specified, group is not collapsible. * * If `true`, group is collapsible and collapsed by default * * If `false`, group is collapsible but expanded by default */ collapsed?: boolean } // edit link ----------------------------------------------------------------- export interface EditLink { /** * Pattern for edit link. * * @example 'https://github.com/vuejs/vitepress/edit/main/docs/:path' */ pattern: string | ((payload: { relativePath: string }) => string) /** * Custom text for edit link. * * @default 'Edit this page' */ text?: string } // prev-next ----------------------------------------------------------------- export interface DocFooter { /** * Custom label for previous page button. * * @default 'Previous page' */ prev?: string /** * Custom label for next page button. * * @default 'Next page' */ next?: string } // social link --------------------------------------------------------------- export interface SocialLink { icon: SocialLinkIcon link: string } export type SocialLinkIcon = | 'discord' | 'facebook' | 'github' | 'instagram' | 'linkedin' | 'mastodon' | 'slack' | 'twitter' | 'youtube' | { svg: string } // footer -------------------------------------------------------------------- export interface Footer { message?: string copyright?: string } // team ---------------------------------------------------------------------- export interface TeamMember { avatar: string name: string title?: string org?: string orgLink?: string desc?: string links?: SocialLink[] sponsor?: string } // outline ------------------------------------------------------------------- export interface Outline { level?: number | [number, number] | 'deep' label?: string } // local search -------------------------------------------------------------- export interface LocalSearchOptions { /** * @default false */ disableDetailedView?: boolean /** * @default false */ disableQueryPersistence?: boolean translations?: LocalSearchTranslations locales?: Record>> } // algolia ------------------------------------------------------------------- /** * The Algolia search options. Partially copied from * `@docsearch/react/dist/esm/DocSearch.d.ts` */ export interface AlgoliaSearchOptions extends DocSearchProps { locales?: Record> } // carbon ads ---------------------------------------------------------------- export interface CarbonAdsOptions { code: string placement: string } }