@brillout/docpress 0.13.2 → 0.14.0

package/dist/types/Config.d.ts

@@ -28,6 +28,7 @@ type Config = {
     bannerUrl?: string;
     twitterHandle: string;
     globalNote?: React.ReactNode;
+    topNavigation?: React.ReactNode;
     i18n?: true;
     pressKit?: true;
     sponsorGithubAccount?: string;

package/dist/types/Heading.d.ts

@@ -15,7 +15,8 @@ type HeadingResolved = {
     color?: string;
     titleIcon?: string;
     titleIconStyle?: React.CSSProperties;
-} & Tmp;
+    titleDocument?: string;
+};
 type PageDesign = {
     hideTitle?: true;
     hideMenuLeft?: true;
@@ -35,16 +36,7 @@ type HeadingDetachedDefinition = HeadingDefinitionCommon & {
     sectionTitles?: string[];
     category?: string;
 };
-type HeadingDefinition = HeadingDefinitionCommon & {
-    url?: null | string;
-    titleInNav?: string;
-} & HeadingDefinitionLevel & Tmp;
-type IsCategory = {
-    url?: undefined;
-    titleDocument?: undefined;
-    titleInNav?: undefined;
-};
-type HeadingDefinitionLevel = ({
+type HeadingDefinition = HeadingDefinitionCommon & {} & (({
     level: 1;
     color: string;
     titleIcon?: string;
@@ -53,9 +45,12 @@ type HeadingDefinitionLevel = ({
     level: 4;
 } & IsCategory) | {
     level: 2;
+    titleInNav?: string;
+    titleDocument?: string;
     sectionTitles?: string[];
     url: null | string;
-};
-type Tmp = {
-    titleDocument?: string;
+});
+type IsCategory = {
+    url?: undefined;
+    titleInNav?: undefined;
 };

package/docsearch/DocSearchInstall.tsx

@@ -7,7 +7,7 @@ import { Hit } from '../components/Algolia/Hit'
 
 function DocSearchInstall() {
   const pageContext = usePageContext()
-  const { algolia } = pageContext.meta
+  const { algolia } = pageContext.globalContext.config.docpress
   if (!algolia) return null
   return (
     <div style={{ display: 'none' }}>

package/index.ts

@@ -8,7 +8,11 @@ export {
   Emoji,
 } from './components'
 export { MenuToggle } from './Layout'
-export { usePageContext, usePageContext2 } from './renderer/usePageContext'
+
+// The only place usePageContext() is used at:
+// https://github.com/vikejs/vike/blob/0b1b109f64aafbed23a1c2ac2630e6146a270ec0/packages/vike.dev/components/CommunityNote.tsx#L4
+export { usePageContext } from './renderer/usePageContext'
+
 export * from './components/Note'
 export * from './icons/index'
 export { assert } from './utils/assert'

package/installSectionUrlHashs.ts

@@ -2,6 +2,7 @@ export { installSectionUrlHashs }
 
 import { assert } from './utils/client'
 
+// TO-DO/eventually: use React instead of manually installing click handlers?
 function installSectionUrlHashs() {
   {
     const isLandingPage = window.location.pathname === '/'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brillout/docpress",
-  "version": "0.13.2",
+  "version": "0.14.0",
   "type": "module",
   "dependencies": {
     "@brillout/picocolors": "^1.0.10",
@@ -10,18 +10,18 @@
     "@mdx-js/react": "3.0.1",
     "@mdx-js/rollup": "3.0.1",
     "@shikijs/transformers": "1.2.0",
-    "@vitejs/plugin-react-swc": ">=3.0.0",
+    "@vitejs/plugin-react-swc": "^3.10.2",
     "rehype-pretty-code": "0.13.0",
     "remark-gfm": "4.0.0",
     "shiki": "1.2.0",
-    "vite": ">=5.2.0"
+    "vite": "^6.3.5"
   },
   "peerDependencies": {
     "@vitejs/plugin-react-swc": ">=3.0.0",
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0",
     "typescript": ">=5.0.0",
-    "vike": ">=0.4.222",
+    "vike": ">=0.4.234",
     "vite": ">=5.2.0"
   },
   "peerDependenciesMeta": {
@@ -35,8 +35,7 @@
   "exports": {
     "./renderer/onRenderHtml": "./renderer/onRenderHtml.tsx",
     "./renderer/onRenderClient": "./renderer/onRenderClient.tsx",
-    "./renderer/onBeforeRender": "./renderer/onBeforeRender.ts",
-    "./Layout": "./Layout.tsx",
+    "./renderer/onCreatePageContext": "./renderer/onCreatePageContext.ts",
     ".": "./index.ts",
     "./config": "./dist/+config.js",
     "./style": "./css/index.css",
@@ -73,9 +72,8 @@
     "// Build vite.config.ts and +config.ts (other files don't need to be built as @brillout/docpress is noExternal)": "",
     "build": "rm -rf dist/ && tsc --project tsconfig.config.json",
     "======== Develop": "",
-    "dev": "tsc --watch --project tsconfig.config.json",
-    "// Check types of all source files while developing": "",
-    "typecheck": "tsc --noEmit --watch",
+    "// Typecheck + build vite.config.ts and +config.ts": "",
+    "dev": "tsc --watch",
     "========= Release": "",
     "release": "release-me patch",
     "release:minor": "release-me minor",

package/parsePageSections.ts

@@ -47,7 +47,7 @@ function transform(code: string) {
 
       if (
         line.startsWith('#')
-        /* TODO/eventually: implement.
+        /* TO-DO/eventually: implement.
         || line.startsWith('<h2')
         */
       ) {

package/renderer/getPageElement.tsx

@@ -1,18 +1,16 @@
 export { getPageElement }
 
 import type { PageContext } from 'vike/types'
-import type { PageContextResolved } from '../config/resolvePageContext'
-import { PageContextProvider, PageContextProvider2 } from './usePageContext'
+import { PageContextProvider } from './usePageContext'
 import React from 'react'
 import { DocSearchInstall } from '../docsearch/DocSearchInstall'
-import { PassThrough } from '../utils/PassTrough'
+import { Layout } from '../Layout'
 
-function getPageElement(pageContext: PageContext, pageContextResolved: PageContextResolved) {
+function getPageElement(pageContext: PageContext) {
   const { Page } = pageContext
-  const Layout = pageContext.config.Layout || PassThrough
   const page = (
-    <Wrapper {...{ pageContext, pageContextResolved }}>
-      <Layout pageContext={pageContextResolved} pageContext2={pageContext}>
+    <Wrapper {...{ pageContext }}>
+      <Layout>
         <Page />
       </Layout>
       <DocSearchInstall />
@@ -21,16 +19,10 @@ function getPageElement(pageContext: PageContext, pageContextResolved: PageConte
   return page
 }
 
-function Wrapper({
-  children,
-  pageContext,
-  pageContextResolved,
-}: { children: React.ReactNode; pageContext: PageContext; pageContextResolved: PageContextResolved }) {
+function Wrapper({ children, pageContext }: { children: React.ReactNode; pageContext: PageContext }) {
   return (
     <React.StrictMode>
-      <PageContextProvider2 pageContext={pageContext}>
-        <PageContextProvider pageContext={pageContextResolved}>{children}</PageContextProvider>
-      </PageContextProvider2>
+      <PageContextProvider pageContext={pageContext}>{children}</PageContextProvider>
     </React.StrictMode>
   )
 }

package/renderer/onCreatePageContext.ts

@@ -0,0 +1,8 @@
+export { onCreatePageContext }
+
+import type { PageContextServer } from 'vike/types'
+import { resolveConf } from '../resolveConf'
+
+function onCreatePageContext(pageContext: PageContextServer) {
+  pageContext.conf = resolveConf(pageContext)
+}

package/renderer/onRenderClient.tsx

@@ -3,7 +3,6 @@ export { onRenderClient }
 import React, { useEffect } from 'react'
 import type { PageContextClient } from 'vike/types'
 import ReactDOM from 'react-dom/client'
-import { PageContextResolved } from '../config/resolvePageContext'
 import { getPageElement } from './getPageElement'
 import { closeMenuModal } from '../MenuModal/toggleMenuModal'
 import '../css/index.css'
@@ -25,13 +24,11 @@ initOnNavigation()
 async function onRenderClient(pageContext: PageContextClient) {
   onRenderStart()
 
-  // TODO: stop using any
-  const pageContextResolved: PageContextResolved = (pageContext as any).pageContextResolved
   let renderPromiseResolve!: () => void
   const renderPromise = new Promise<void>((r) => {
     renderPromiseResolve = r
   })
-  let page = getPageElement(pageContext, pageContextResolved)
+  let page = getPageElement(pageContext)
   page = <OnRenderDoneHook renderPromiseResolve={renderPromiseResolve}>{page}</OnRenderDoneHook>
   const container = document.getElementById('page-view')!
   if (pageContext.isHydration) {
@@ -49,9 +46,7 @@ async function onRenderClient(pageContext: PageContextClient) {
 }
 
 function applyHead(pageContext: PageContextClient) {
-  // TODO: stop using any
-  const pageContextResolved: PageContextResolved = (pageContext as any).pageContextResolved
-  document.title = pageContextResolved.documentTitle
+  document.title = pageContext.conf.documentTitle
 }
 
 function onRenderStart() {
@@ -61,7 +56,6 @@ function onRenderStart() {
 
 function onRenderDone(renderPromiseResolve: () => void) {
   autoScrollNav()
-  // TODO/refactor: use React?
   installSectionUrlHashs()
   setHydrationIsFinished()
   renderPromiseResolve()

package/renderer/onRenderHtml.tsx

@@ -3,37 +3,36 @@ export { onRenderHtml }
 import ReactDOMServer from 'react-dom/server'
 import { escapeInject, dangerouslySkipEscape } from 'vike/server'
 import { assert } from '../utils/server'
-import type { PageContextResolved } from '../config/resolvePageContext'
 import { getPageElement } from './getPageElement'
-import type { OnRenderHtmlAsync } from 'vike/types'
-import { ActiveCategory } from '../config/resolveHeadingsData'
+import type { PageContextServer } from 'vike/types'
 
-const onRenderHtml: OnRenderHtmlAsync = async (
-  pageContext,
-): // TODO: Why is Promise<Awaited<>> needed?
-Promise<Awaited<ReturnType<OnRenderHtmlAsync>>> => {
-  const pageContextResolved: PageContextResolved = (pageContext as any).pageContextResolved
+async function onRenderHtml(pageContext: PageContextServer): Promise<any> {
+  const page = getPageElement(pageContext)
 
-  const page = getPageElement(pageContext, pageContextResolved)
-
-  const descriptionTag = pageContextResolved.isLandingPage
-    ? dangerouslySkipEscape(`<meta name="description" content="${pageContextResolved.meta.tagline}" />`)
-    : ''
+  const { isLandingPage } = pageContext.conf
+  assert(typeof isLandingPage === 'boolean')
+  const { tagline } = pageContext.globalContext.config.docpress
+  assert(tagline)
+  const descriptionTag = isLandingPage ? escapeInject`<meta name="description" content="${tagline}" />` : ''
 
   const pageHtml = ReactDOMServer.renderToString(page)
 
-  const faviconUrl = pageContextResolved.config.faviconUrl ?? pageContextResolved.config.logoUrl
+  const faviconUrl =
+    pageContext.globalContext.config.docpress.faviconUrl ?? pageContext.globalContext.config.docpress.logoUrl
+  assert(faviconUrl)
 
+  const { documentTitle } = pageContext.conf
+  assert(documentTitle)
   return escapeInject`<!DOCTYPE html>
     <html>
       <head>
         <meta charset="UTF-8" />
         <link rel="icon" href="${faviconUrl ?? ''}" />
-        <title>${pageContextResolved.documentTitle}</title>
+        <title>${documentTitle}</title>
         ${descriptionTag}
         <meta name="viewport" content="width=device-width,initial-scale=1">
-        ${getOpenGraphTags(pageContext.urlPathname, pageContextResolved.documentTitle, pageContextResolved.meta)}
-        ${getAlgoliaTags(pageContextResolved.activeCategory)}
+        ${getOpenGraphTags(pageContext.urlPathname, documentTitle, pageContext.globalContext.config.docpress)}
+        ${getAlgoliaTags(pageContext)}
       </head>
       <body>
         <div id="page-view">${dangerouslySkipEscape(pageHtml)}</div>
@@ -41,7 +40,8 @@ Promise<Awaited<ReturnType<OnRenderHtmlAsync>>> => {
     </html>`
 }
 
-function getAlgoliaTags(activeCategory: ActiveCategory) {
+function getAlgoliaTags(pageContext: PageContextServer) {
+  const activeCategory = getActiveCategory(pageContext)
   const categoryNameTag = escapeInject`<meta name="algolia:category" content="${activeCategory.name}">`
   if (activeCategory.hide) {
     return escapeInject`${categoryNameTag}<meta name="algolia:category:hide"> `
@@ -49,6 +49,28 @@ function getAlgoliaTags(activeCategory: ActiveCategory) {
     return escapeInject`${categoryNameTag}<meta name="algolia:category:order" content="${activeCategory.order.toString()}"> `
   }
 }
+type ActiveCategory = {
+  name: string
+  order: number
+  hide?: boolean
+}
+function getActiveCategory(pageContext: PageContextServer) {
+  const config = pageContext.globalContext.config.docpress
+  const { activeCategoryName } = pageContext.conf
+
+  const activeCategory: ActiveCategory = config.categories
+    // normalize
+    ?.map((c, i) => ({
+      order: i,
+      ...(typeof c === 'string' ? { name: c } : c),
+    }))
+    .find((c) => c.name === activeCategoryName) ?? {
+    name: activeCategoryName,
+    order: 99999999999,
+  }
+
+  return activeCategory
+}
 
 function getOpenGraphTags(
   url: string,
@@ -56,18 +78,26 @@ function getOpenGraphTags(
   meta: { tagline: string; websiteUrl: string; twitterHandle: string; bannerUrl?: string },
 ) {
   const { tagline, websiteUrl, twitterHandle, bannerUrl } = meta
-
   assert(url.startsWith('/'))
-  if (!bannerUrl) return ''
 
+  const metaBanner = !bannerUrl
+    ? ''
+    : escapeInject`
+    <meta property="og:image" content="${bannerUrl}">
+    <meta name="twitter:card" content="summary_large_image">
+  `
+  const metaTwitter = !twitterHandle
+    ? ''
+    : escapeInject`
+    <meta name="twitter:site" content="${twitterHandle}">
+  `
   // See view-source:https://vitejs.dev/
   return escapeInject`
     <meta property="og:type" content="website">
     <meta property="og:title" content="${documentTitle}">
-    <meta property="og:image" content="${bannerUrl}">
     <meta property="og:url" content="${websiteUrl}">
     <meta property="og:description" content="${tagline}">
-    <meta name="twitter:card" content="summary_large_image">
-    <meta name="twitter:site" content="${twitterHandle}">
+    ${metaBanner}
+    ${metaTwitter}
   `
 }

package/renderer/usePageContext.tsx

@@ -1,48 +1,32 @@
-export { usePageContext }
 export { PageContextProvider }
+export { usePageContext }
+export { usePageContextLegacy }
 
 import React, { useContext } from 'react'
-import type { PageContextResolved } from '../config/resolvePageContext'
 import type { PageContext } from 'vike/types'
 import { getGlobalObject } from '../utils/getGlobalObject'
 
 const globalObject = getGlobalObject('usePageContext.ts', {
-  Context: React.createContext<PageContextResolved>(undefined as any),
-  Context2: React.createContext<PageContext>(undefined as any),
+  Ctx: React.createContext<PageContext>(undefined as any),
 })
 
-function PageContextProvider({
-  pageContext,
-  children,
-}: {
-  pageContext: PageContextResolved
-  children: React.ReactNode
-}) {
-  const { Context } = globalObject
-  return <Context.Provider value={pageContext}>{children}</Context.Provider>
-}
-
-function usePageContext(): PageContextResolved {
-  const { Context } = globalObject
-  const pageContext = useContext(Context)
-  return pageContext
+function usePageContextLegacy() {
+  const { Ctx } = globalObject
+  const pageContext = useContext(Ctx)
+  return pageContext.conf
 }
 
-export { PageContextProvider2 }
-// TODO/refactor: rename to usePageContext and remove old implementation
-export { usePageContext2 }
-
-function usePageContext2(): PageContext {
-  const pageContext = useContext(globalObject.Context2)
+function usePageContext(): PageContext {
+  const pageContext = useContext(globalObject.Ctx)
   return pageContext
 }
-function PageContextProvider2({
+function PageContextProvider({
   pageContext,
   children,
 }: {
   pageContext: PageContext
   children: React.ReactNode
 }) {
-  const { Context2 } = globalObject
-  return <Context2.Provider value={pageContext}>{children}</Context2.Provider>
+  const { Ctx } = globalObject
+  return <Ctx.Provider value={pageContext}>{children}</Ctx.Provider>
 }

package/{config/resolveHeadingsData.ts → resolveConf.ts}

@@ -1,21 +1,22 @@
-export { resolveHeadingsData }
-export type { ActiveCategory }
+export { resolveConf }
+export type Conf = ReturnType<typeof resolveConf>
 
-import { assert, isBrowser, jsxToTextContent } from '../utils/server'
+import type { Config } from './types/Config'
+import type { NavItem } from './NavItemComponent'
+import type { LinkData } from './components'
+import type { PageContextServer } from 'vike/types'
+import type { PageSection } from './parsePageSections'
 import type {
   HeadingDefinition,
   HeadingDetachedDefinition,
   HeadingResolved,
   HeadingDetachedResolved,
-} from '../types/Heading'
-import type { Config } from '../types/Config'
-import type { NavItem } from '../NavItemComponent'
-import type { LinkData } from '../components'
-import type { Exports, PageContextOriginal } from './resolvePageContext'
+} from './types/Heading'
+import { assert } from './utils/assert'
+import { jsxToTextContent } from './utils/jsxToTextContent'
 import pc from '@brillout/picocolors'
-import { parseMarkdownMini } from '../parseMarkdownMini'
-import { determineNavItemsColumnLayout } from '../renderer/determineNavItemsColumnLayout'
-assert(!isBrowser())
+import { parseMarkdownMini } from './parseMarkdownMini'
+import { determineNavItemsColumnLayout } from './determineNavItemsColumnLayout'
 
 type PageSectionResolved = {
   url: string | null
@@ -25,14 +26,10 @@ type PageSectionResolved = {
   pageSectionLevel: number
 }
 
-type ActiveCategory = {
-  name: string
-  order: number
-  hide?: boolean
-}
-
-function resolveHeadingsData(pageContext: PageContextOriginal) {
-  const config = pageContext.config.docpress!
+function resolveConf(pageContext: PageContextServer) {
+  const config = pageContext.globalContext.config.docpress
+  const { urlPathname } = pageContext
+  const pageSections = pageContext.config.pageSectionsExport ?? []
 
   {
     const { headings, headingsDetached } = config
@@ -46,18 +43,19 @@ function resolveHeadingsData(pageContext: PageContextOriginal) {
   const { activeHeading, isDetachedPage, activeCategoryName } = getActiveHeading(
     headingsResolved,
     headingsDetachedResolved,
-    pageContext,
+    urlPathname,
   )
 
-  const { documentTitle, isLandingPage, pageTitle } = getTitles(activeHeading, pageContext, config)
+  const { documentTitle, isLandingPage, pageTitle } = getTitles(activeHeading, urlPathname, config)
 
-  const pageSectionsResolved = getPageSectionsResolved(pageContext, activeHeading)
+  const pageSectionsResolved = getPageSectionsResolved(pageSections, activeHeading)
 
-  const linksAll: LinkData[] = [
-    ...pageSectionsResolved.map(pageSectionToLinkData),
+  const linksGlobal: LinkData[] = [
     ...headingsResolved.map(headingToLinkData),
     ...headingsDetachedResolved.map(headingToLinkData),
   ]
+  const linksPage: LinkData[] = pageSectionsResolved.map(pageSectionToLinkData)
+  const linksAll = [...linksPage, ...linksGlobal]
 
   let navItemsAll: NavItem[]
   let navItemsDetached: NavItem[] | undefined
@@ -70,7 +68,7 @@ function resolveHeadingsData(pageContext: PageContextOriginal) {
     if (isDetachedPage) {
       navItemsDetached = [headingToNavItem(activeHeading), ...navItemsPageSections]
     } else {
-      const activeHeadingIndex = navItemsAll.findIndex((navItem) => navItem.url === pageContext.urlPathname)
+      const activeHeadingIndex = navItemsAll.findIndex((navItem) => navItem.url === urlPathname)
       assert(activeHeadingIndex >= 0)
       navItemsPageSections.forEach((navItem, i) => {
         navItemsAll.splice(activeHeadingIndex + 1 + i, 0, navItem)
@@ -78,18 +76,7 @@ function resolveHeadingsData(pageContext: PageContextOriginal) {
     }
   }
 
-  const activeCategory: ActiveCategory = config.categories
-    // normalize
-    ?.map((c, i) => ({
-      order: i,
-      ...(typeof c === 'string' ? { name: c } : c),
-    }))
-    .find((c) => c.name === activeCategoryName) ?? {
-    name: activeCategoryName,
-    order: 99999999999,
-  }
-
-  const pageContextAddendum = {
+  const conf = {
     navItemsAll,
     navItemsDetached,
     pageDesign: activeHeading.pageDesign,
@@ -97,10 +84,9 @@ function resolveHeadingsData(pageContext: PageContextOriginal) {
     isLandingPage,
     pageTitle,
     documentTitle,
-    // TODO: don't pass to client-side
-    activeCategory,
+    activeCategoryName,
   }
-  return pageContextAddendum
+  return conf
 }
 
 function headingToNavItem(heading: HeadingResolved | HeadingDetachedResolved): NavItem {
@@ -139,13 +125,8 @@ function pageSectionToLinkData(pageSection: PageSectionResolved): LinkData {
   }
 }
 
-function getTitles(
-  activeHeading: HeadingResolved | HeadingDetachedResolved,
-  pageContext: { urlPathname: string },
-  config: Config,
-) {
-  const url = pageContext.urlPathname
-  const isLandingPage = url === '/'
+function getTitles(activeHeading: HeadingResolved | HeadingDetachedResolved, urlPathname: string, config: Config) {
+  const isLandingPage = urlPathname === '/'
 
   const { title } = activeHeading
   let pageTitle = isLandingPage ? null : title
@@ -165,12 +146,11 @@ function getTitles(
 function getActiveHeading(
   headingsResolved: HeadingResolved[],
   headingsDetachedResolved: HeadingDetachedResolved[],
-  pageContext: { urlPathname: string; exports: Exports },
+  urlPathname: string,
 ) {
   let activeHeading: HeadingResolved | HeadingDetachedResolved | null = null
   let activeCategoryName = 'Miscellaneous'
   let headingCategory: string | undefined
-  const { urlPathname } = pageContext
   assert(urlPathname)
   for (const heading of headingsResolved) {
     if (heading.level === 1) {
@@ -206,11 +186,9 @@ function getActiveHeading(
 }
 
 function getPageSectionsResolved(
-  pageContext: { exports: Exports },
+  pageSections: PageSection[],
   activeHeading: HeadingResolved | HeadingDetachedResolved,
 ): PageSectionResolved[] {
-  const pageSections = pageContext.exports.pageSectionsExport ?? []
-
   const pageSectionsResolved = pageSections.map((pageSection) => {
     const { pageSectionTitle } = pageSection
     const url: null | string = pageSection.pageSectionId === null ? null : '#' + pageSection.pageSectionId

package/tsconfig.config.json

@@ -1,7 +1,4 @@
 {
   "extends": "./tsconfig.json",
-  "files": ["vite.config.ts", "+config.ts"],
-  "compilerOptions": {
-    "outDir": "./dist/"
-  }
+  "files": ["vite.config.ts", "+config.ts"]
 }

package/tsconfig.json

@@ -1,5 +1,6 @@
 {
   "compilerOptions": {
+    "outDir": "./dist/",
     "jsx": "react",
     "module": "ES2020",
     "moduleResolution": "Bundler",

package/types/Config.ts

@@ -30,6 +30,7 @@ type Config = {
   bannerUrl?: string
   twitterHandle: string
   globalNote?: React.ReactNode
+  topNavigation?: React.ReactNode
   i18n?: true
   pressKit?: true
   sponsorGithubAccount?: string

package/types/Heading.ts

@@ -16,7 +16,8 @@ type HeadingResolved = {
   color?: string
   titleIcon?: string
   titleIconStyle?: React.CSSProperties
-} & Tmp
+  titleDocument?: string
+}
 
 type PageDesign = {
   hideTitle?: true
@@ -41,26 +42,18 @@ type HeadingDetachedDefinition = HeadingDefinitionCommon & {
   category?: string
 }
 
-type HeadingDefinition = HeadingDefinitionCommon & {
-  url?: null | string
-  titleInNav?: string
-} & HeadingDefinitionLevel &
-  Tmp
+type HeadingDefinition = HeadingDefinitionCommon & {} & (
+    | ({ level: 1; color: string; titleIcon?: string; titleIconStyle?: React.CSSProperties } & IsCategory)
+    | ({ level: 4 } & IsCategory)
+    | {
+        level: 2
+        titleInNav?: string
+        titleDocument?: string
+        sectionTitles?: string[]
+        url: null | string
+      }
+  )
 type IsCategory = {
   url?: undefined
-  titleDocument?: undefined
   titleInNav?: undefined
 }
-type HeadingDefinitionLevel =
-  | ({ level: 1; color: string; titleIcon?: string; titleIconStyle?: React.CSSProperties } & IsCategory)
-  | ({ level: 4 } & IsCategory)
-  | {
-      level: 2
-      sectionTitles?: string[]
-      url: null | string
-    }
-
-type Tmp = {
-  // TODO: remove? Both Vike and Telefunc set it to the same value than docpress.config.js#projectInfo.projectName
-  titleDocument?: string
-}