Function normalizePages

packages/nextra/src/client/normalize-pages.ts:117–355

({
  list,
  route,
  /** @default '' */
  docsRoot = '',
  /** @default DEFAULT_PAGE_THEME */
  pageThemeContext = DEFAULT_PAGE_THEME
}: {
  list: PageMapItem[]
  route: string
  docsRoot?: string
  underCurrentDocsRoot?: boolean
  pageThemeContext?: PageTheme
})

}

export function normalizePages({
  list,
  route,
  /** @default '' */
  docsRoot = '',
  /** @default DEFAULT_PAGE_THEME */
  pageThemeContext = DEFAULT_PAGE_THEME
}: {
  list: PageMapItem[]
  route: string
  docsRoot?: string
  underCurrentDocsRoot?: boolean
  pageThemeContext?: PageTheme
}): NormalizedResult {
  // If the doc is under the active page root.
  const underCurrentDocsRoot = route.startsWith(docsRoot)
  const directories: Item[] = []
  const docsDirectories: DocsItem[] = []
  const flatDocsDirectories: DocsItem[] = []
  const topLevelNavbarItems: (PageItem | MenuItem)[] = []
  const firstItem = list[0]! // always exists
  const meta = 'data' in firstItem ? (firstItem.data as MetaType) : {}
  // Normalize items based on files and _meta.json.
  const items = ('data' in firstItem ? list.slice(1) : list) as (
    | (Folder & { frontMatter?: FrontMatter })
    | MdxFile
  )[]

  const fallbackMeta = meta['*'] || {}

  let activeType: NormalizedResult['activeType'] = fallbackMeta.type
  let activeIndex = 0
  let activeThemeContext = {
    ...pageThemeContext,
    ...fallbackMeta.theme
  }
  let activePath: Item[] = []

  for (const currentItem of items) {
    // Get the item's meta information.
    const extendedMeta = extendMeta(
      meta[currentItem.name],
      fallbackMeta,
      currentItem.frontMatter
    )
    const { display, type = 'doc' } = extendedMeta
    const extendedPageThemeContext = {
      ...pageThemeContext,
      ...extendedMeta.theme
    }

    const normalizedChildren: false | NormalizedResult =
      'children' in currentItem &&
      normalizePages({
        list: currentItem.children,
        route,
        docsRoot:
          type === 'page' || type === 'menu' ? currentItem.route : docsRoot,