Codebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.
Python aicode-complexitycode-healthcode-intelligencecode-qualitydead-codedeveloper-toolsdocumentationgit-analyticsmcpopen-sourcepythonrefactoringstatic-analysistechnical-debt
"use client";
import Link from "next/link";
import { BarChart3 } from "lucide-react";
import { useParams, usePathname } from "next/navigation";
import { useTranslations } from "next-intl";
import useSWR from "swr";
import {
DocsHeader as DocsHeaderShell,
type DocsHeaderTab,
} from "@repowise-dev/ui/docs/docs-header";
import {
DocsMoreMenu,
type DocsMenuGroup,
} from "@repowise-dev/ui/docs/docs-more-menu";
import type { DocDriftResponse } from "@repowise-dev/types/doc-drift";
import { getDocDrift } from "@/lib/api/doc-drift";
const TABS = [
{ labelKey: "explorer", segment: "", icon: "explorer" as const },
{ labelKey: "drift", segment: "/drift", icon: "drift" as const },
];
// "Doc freshness", not "Coverage": coverage means test coverage everywhere
// else in the app. A secondary view, so it is a link in More, not a tab.
const FRESHNESS_SEGMENT = "/coverage";
/**
* Web wrapper: resolves the route-aware tab list and injects Next's ``Link``
* into the presentational ``DocsHeader`` ui shell.
*/
export function DocsHeader({
children,
menuGroups = [],
menuBusy = false,
}: {
children?: React.ReactNode;
/** The page's own More items (export, present...). The view link is added here. */
menuGroups?: DocsMenuGroup[];
/** Spinner on the More trigger while one of its actions runs. */
menuBusy?: boolean;
}) {
const t = useTranslations("views.docsTabs");
const td = useTranslations("docs");
const pathname = usePathname();
const { id } = useParams<{ id: string }>();
const basePath = `/repos/${id}/docs`;
// `limit: 1`: the summary counts before the cap, so one row carries the
// badge. No badge when the drift pass has not run: the response then
// carries a cause rather than a summary, and a 0 would read as clean.
const { data: drift } = useSWR<DocDriftResponse>(
`doc-drift-badge:${id}`,
() => getDocDrift(id, { limit: 1 }),
{ revalidateOnFocus: false },
);
const driftCount = drift?.summary?.findings_total;
const tabs: DocsHeaderTab[] = TABS.map((tab) => {
const href = `${basePath}${tab.segment}`;
return {
label: t(tab.labelKey),
href,
icon: tab.icon,
isActive:
tab.segment === "" ? pathname === basePath : pathname.startsWith(href),
...(tab.icon === "drift" && driftCount !== undefined ? { badge: driftCount } : {}),
};
});
const freshnessHref = `${basePath}${FRESHNESS_SEGMENT}`;
const groups: DocsMenuGroup[] = [
{
key: "views",
items: [
{
key: "freshness",
label: t("freshness"),
icon: BarChart3,
href: freshnessHref,
current: pathname.startsWith(freshnessHref),
},
],
},
...menuGroups,
];
return (
<DocsHeaderShell tabs={tabs} LinkComponent={Link}>
{children}
<DocsMoreMenu
label={td("explorer.more")}
busy={menuBusy}
groups={groups}
LinkComponent={Link}
/>
</DocsHeaderShell>
);
}