import type { EnvironmentProject } from "@t3tools/client-runtime/state/shell";
import {
getProjectFaviconResourceKey,
isProjectFaviconFallbackUrl,
} from "@t3tools/shared/projectFavicon";
import { FolderCodeIcon } from "lucide-react";
import type { ComponentType } from "react";
import { createElement, lazy, Suspense, useState } from "react";
import { useAtomValue } from "@effect/atom-react";
import { projectFaviconUrlAtom } from "../state/assets";
import { deriveProjectIdentity } from "../projectIdentity";
import { projectIconColorClassName } from "../projectIconColors";
import { ProjectMonogram } from "./ProjectMonogram";
import { cn } from "~/lib/utils";
// All lucide icons load as one chunk, only once a project uses a lucide override.
const LucideProjectIcon = lazy(() =>
import("../lib/lucideIconByName").then(({ lucideIconByName }) => ({
default: function LucideProjectIcon(props: { name: string; className: string }) {
return createElement(lucideIconByName(props.name) ?? FolderCodeIcon, {
className: props.className,
});
},
})),
);
function DynamicProjectIconFallback() {
return <FolderCodeIcon className="size-full text-inherit" />;
}
export type ProjectFaviconProject = Pick<
EnvironmentProject,
"environmentId" | "workspaceRoot" | "title" | "faviconPath" | "projectIcon"
>;
export function ProjectFavicon(input: {
project: ProjectFaviconProject;
className?: string | undefined;
fallbackIcon?: ComponentType<{ className?: string }>;
}) {
const { project } = input;
if (project.projectIcon?.kind === "monogram") {
return (
<ProjectMonogram
text={project.projectIcon.text}
color={project.projectIcon.color}
className={input.className}
/>
);
}
if (project.projectIcon?.kind === "emoji") {
return (
<ProjectFaviconFallback
className={input.className}
icon={FolderCodeIcon}
emoji={project.projectIcon.emoji}
/>
);
}
if (project.projectIcon?.kind === "lucide") {
const colorClassName = projectIconColorClassName(project.projectIcon.color);
const iconClassName = cn(
"inline-flex size-3.5 shrink-0 items-center justify-center",
colorClassName,
input.className,
);
return (
<span aria-hidden="true" className={iconClassName}>
<Suspense fallback={<DynamicProjectIconFallback />}>
<LucideProjectIcon
name={project.projectIcon.name}
className={cn("size-full", colorClassName)}
/>
</Suspense>
</span>
);
}
return <AutomaticProjectFavicon {...input} />;
}
function AutomaticProjectFavicon(input: Parameters<typeof ProjectFavicon>[0]) {
const { project } = input;
const src = useAtomValue(
projectFaviconUrlAtom({
environmentId: project.environmentId,
cwd: project.workspaceRoot,
faviconPath: project.faviconPath,
}),
);
const FallbackIcon = input.fallbackIcon ?? FolderCodeIcon;
if (!src || isProjectFaviconFallbackUrl(src)) {
return (
<ProjectFaviconFallback
className={input.className}
icon={FallbackIcon}
projectName={project.title}
/>
);
}
const cacheKey = getProjectFaviconResourceKey(
project.environmentId,
project.workspaceRoot,
project.faviconPath,
);
return (
<ProjectFaviconImage
key={cacheKey}
src={src}
className={input.className}
fallbackIcon={FallbackIcon}
fallbackProjectName={project.title}
/>
);
}
function ProjectFaviconFallback({
className,
icon: Icon,
emoji,
projectName,
}: {
readonly className?: string | undefined;
readonly icon: ComponentType<{ className?: string }>;
readonly emoji?: string | undefined;
readonly projectName?: string | undefined;
}) {
if (projectName && projectName.trim().length > 0) {
const identity = deriveProjectIdentity(projectName);
return (
<ProjectMonogram text={identity.monogram} color={identity.color} className={className} />
);
}
if (emoji) {
return (
<span
aria-hidden="true"
className={cn(
"inline-flex size-3.5 shrink-0 items-center justify-center leading-none [container-type:size]",
className,
)}
>
<span className="text-[length:80cqh] leading-none">{emoji}</span>
</span>
);
}
return <Icon className={cn("size-3.5 shrink-0 text-icon-muted", className)} />;
}
function ProjectFaviconImage({
src,
className,
fallbackIcon: FallbackIcon,
fallbackProjectName,
}: {
readonly src: string;
readonly className?: string | undefined;
readonly fallbackIcon: ComponentType<{ className?: string }>;
readonly fallbackProjectName?: string | undefined;
}) {
const [displayedSrc, setDisplayedSrc] = useState<string | null>(() =>
src.startsWith("data:image/") ? src : null,
);
const isLoading = displayedSrc !== src;
const handleLoadError = (failedSrc: string) => {
setDisplayedSrc((currentSrc) => (currentSrc === failedSrc ? null : currentSrc));
};
return (
<>
{displayedSrc === null ? (
<ProjectFaviconFallback
className={className}
icon={FallbackIcon}
projectName={fallbackProjectName}
/>
) : null}
{displayedSrc ? (
<img
src={displayedSrc}
alt=""
className={cn("size-3.5 shrink-0 rounded-[25%] object-contain", className)}
onError={() => handleLoadError(displayedSrc)}
/>
) : null}
{isLoading ? (
<img
src={src}
alt=""
className="hidden"
onLoad={() => {
setDisplayedSrc(src);
}}
onError={() => handleLoadError(src)}
/>
) : null}
</>
);
}