tabler/shared/lib/docs-children.ts

type DocsPageFrontmatter = {
  title?: string
  description?: string
  icon?: string
  order?: number
}

export type DocsChildPage = {
  url: string
  title: string
  description: string
  icon?: string
  order: number
}

// Both page conventions are supported: `foo/index.mdx` and flat `foo.mdx`
// produce the same route (/foo/) with the default 'directory' build format.
// `@pages` is a per-package vite alias (preview: ./src/pages, docs: ./pages) —
// that's what lets this file live in shared/ despite import.meta.glob being
// resolved relative to the importer.
const pageModules = import.meta.glob('@pages/**/*.mdx', { eager: true })

function getFrontmatter(mod: unknown): DocsPageFrontmatter | null {
  if (!mod || typeof mod !== 'object') return null

  if ('frontmatter' in mod && mod.frontmatter && typeof mod.frontmatter === 'object') {
    return mod.frontmatter as DocsPageFrontmatter
  }

  return null
}

function urlFromGlobPath(path: string): string {
  // glob keys for alias patterns are resolved paths — derive the route from
  // the segment after the pages dir
  const marker = path.indexOf('/pages/')
  const rel = (marker === -1 ? path : path.slice(marker + '/pages/'.length)).replace(/(?:^|\/)index\.mdx$/, '').replace(/\.mdx$/, '')
  return rel ? `/${rel}/` : '/'
}

function normalizeUrl(url: string): string {
  const parts = url.split('/').filter(Boolean)
  return parts.length ? `/${parts.join('/')}/` : '/'
}

/** Direct child pages of a docs index URL. */
export function getDocsChildren(parentUrl: string): DocsChildPage[] {
  const parentParts = normalizeUrl(parentUrl).split('/').filter(Boolean)

  return (
    Object.entries(pageModules)
      .flatMap(([path, mod]): DocsChildPage[] => {
        const pageUrl = urlFromGlobPath(path)
        const parts = pageUrl.split('/').filter(Boolean)
        const isDirectChild = parts.length === parentParts.length + 1 && parts.slice(0, -1).join('/') === parentParts.join('/')

        if (!isDirectChild) return []

        const fm = getFrontmatter(mod)
        if (!fm?.title) return []

        return [
          {
            url: pageUrl,
            title: String(fm.title),
            description: String(fm.description ?? ''),
            ...(fm.icon ? { icon: String(fm.icon) } : {}),
            order: Number(fm.order ?? 999),
          },
        ]
      })
      // if a route exists in both conventions (foo.mdx AND foo/index.mdx), count it once
      .filter((page, i, all) => all.findIndex((p) => p.url === page.url) === i)
      .sort((a, b) => a.order - b.order || a.title.localeCompare(b.title))
  )
}