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";
/**
* ThemeToggle: one icon button that shows the theme in effect and switches to
* the other on click. `showLabel` names that theme beside the icon.
*
* Relies on `next-themes` (a peer dependency of consumers) for state and
* persistence. Deliberately two-state, no "System" option. Consumers set
* `enableSystem={false}`; the mount effect migrates any stale persisted
* "system" value to light. An explicit light or dark choice is never rewritten.
*
* Until mounted the button renders a neutral placeholder of the same size, so
* server and first client markup match.
*/
import { useEffect, useState } from "react";
import { useTheme } from "next-themes";
import { Sun, Moon } from "lucide-react";
import { cn } from "../lib/cn";
export interface ThemeToggleProps {
/** Accessible name and tooltip while light is active. */
switchToDarkLabel?: string;
/** Accessible name and tooltip while dark is active. */
switchToLightLabel?: string;
/** Accepted for backwards compatibility; the control is always icon-only. */
compact?: boolean;
/** Name the theme in effect ("Light" or "Dark") beside the icon. Off by default. */
showLabel?: boolean;
className?: string;
}
/** Shared by the labelled button and its placeholder, so nothing moves on mount. */
const LABELLED_WIDTH = "min-w-[5rem]";
const BUTTON =
"inline-flex h-8 w-8 items-center justify-center rounded-md text-[var(--color-text-secondary)] transition-colors hover:bg-[var(--color-bg-wash-hover)] hover:text-[var(--color-text-primary)] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--color-focus-ring)]";
export function ThemeToggle({
switchToDarkLabel = "Switch to dark theme",
switchToLightLabel = "Switch to light theme",
showLabel = false,
className,
}: ThemeToggleProps) {
const { theme, resolvedTheme, setTheme } = useTheme();
const [mounted, setMounted] = useState(false);
useEffect(() => {
setMounted(true);
}, []);
// Migrate a persisted "system" (or any unknown) theme to the explicit light
// default. Only fires for non light/dark values.
useEffect(() => {
if (mounted && theme !== "light" && theme !== "dark") setTheme("light");
}, [mounted, theme, setTheme]);
if (!mounted) {
return (
<span
aria-hidden
className={cn("inline-block h-8", showLabel ? LABELLED_WIDTH : "w-8", className)}
/>
);
}
const isDark = resolvedTheme === "dark";
const current = isDark ? "Dark" : "Light";
const action = isDark ? switchToLightLabel : switchToDarkLabel;
// The accessible name starts with the visible text (WCAG 2.5.3).
const label = showLabel ? `${current} theme. ${action}` : action;
const Icon = isDark ? Moon : Sun;
return (
<button
type="button"
aria-label={label}
title={label}
onClick={() => setTheme(isDark ? "light" : "dark")}
className={cn(BUTTON, showLabel && cn("w-auto gap-2 px-3", LABELLED_WIDTH), className)}
>
<Icon className="h-3.5 w-3.5 shrink-0" aria-hidden />
{showLabel && <span className="text-xs font-medium">{current}</span>}
</button>
);
}