"use client"; import { useCallback, useMemo, useState } from "react"; import { Button, Divider, Group, ScrollArea, SimpleGrid, Stack, Text, Title, Tooltip, UnstyledButton, } from "@mantine/core"; import { useLocalStorage } from "@mantine/hooks"; import { IconArchive, IconCheck, IconCircleDot, IconCircleFilled, IconExternalLink, IconGitFork, IconProgressCheck, IconStar, IconTriangleFilled, } from "@tabler/icons-react"; import combineClasses from "clsx"; import { useFormatter, useNow } from "next-intl"; import ReactMarkdown from "react-markdown"; import { clientApi } from "@homarr/api/client"; import { useRequiredBoard } from "@homarr/boards/context"; import { createId, isDateWithin, isNullOrWhitespace, splitToChunksWithNItems } from "@homarr/common"; import type { ReleaseProviderKind } from "@homarr/definitions"; import { getReleaseProviderIconUrl, getReleaseProviderName } from "@homarr/definitions"; import { useI18n } from "@homarr/translation/client"; import { MaskedOrNormalImage } from "@homarr/ui"; import { getSafeApplicationUrl, SAFE_NEW_TAB_REL } from "../common/application-url"; import { isInitialWidgetQueryPending } from "../common/query-state"; import { WidgetQueryLoadingState } from "../common/query-state-indicator"; import { WidgetEmptyState } from "../common/empty-state"; import type { WidgetComponentProps } from "../definition"; import classes from "./component.module.scss"; import { selectReleaseRepositoriesForDisplay } from "./display"; import type { ReleasesRepository, ReleasesRepositoryResponse } from "./releases-repository"; import { getReleasesQueryStaleTimeMs } from "./query-options"; const formatRelativeDate = (value: string): string => { const isMonths = /\d+m/g.test(value); const isOtherUnits = /\d+[HDWY]/g.test(value); return isMonths ? value.toUpperCase() : isOtherUnits ? value.toLowerCase() : value; }; export default function ReleasesWidget({ options, itemId, width, displayMode }: WidgetComponentProps<"releases">) { const t = useI18n("widget.releases"); const now = useNow(); const formatter = useFormatter(); const board = useRequiredBoard(); const [expandedRepositoryId, setExpandedRepositoryId] = useState(null); const hasIconColor = useMemo(() => board.iconColor !== null, [board.iconColor]); const [releasesViewedList, setReleasesViewedList] = useLocalStorage>({ key: "releases-viewed-versions", defaultValue: {}, }); const isAdvanced = displayMode === "advanced"; const columns = isAdvanced ? Math.max(1, Math.floor(width / 420)) : 1; const relativeDateOptions = useMemo( () => ({ newReleaseWithin: formatRelativeDate(options.newReleaseWithin), staleReleaseWithin: formatRelativeDate(options.staleReleaseWithin), }), [options.newReleaseWithin, options.staleReleaseWithin], ); const normalizedRepositories = useMemo( () => options.repositories.map((repo) => (repo.id ? repo : { ...repo, id: createId() })), [options.repositories], ); // Group repositories by provider const groupedRepositories = useMemo(() => { return normalizedRepositories.reduce( (acc, repo) => { const key = repo.provider; if (!key) return acc; acc[key] ??= []; acc[key].push(repo); return acc; }, {} as Partial>, ); }, [normalizedRepositories]); // For each group, split into chunks of 5 const batchedRepositories = useMemo(() => { return Object.entries(groupedRepositories).flatMap(([provider, group]) => splitToChunksWithNItems(group, 5).map((chunk) => ({ provider: provider as ReleaseProviderKind, repositories: chunk, })), ); }, [groupedRepositories]); const queryResults = clientApi.useQueries((trpc) => batchedRepositories.flatMap(({ provider, repositories }) => trpc.widget.releases.getLatest( { itemId, repositories: repositories.map((repository) => ({ id: repository.id, provider, identifier: repository.identifier, versionFilter: repository.versionFilter, providerUrl: repository.providerUrl, })), }, { staleTime: getReleasesQueryStaleTimeMs }, ), ), ); const results = useMemo( () => queryResults.map((q) => q.data).filter((d): d is NonNullable => d != null), [queryResults], ); const isInitialLoading = queryResults.some(isInitialWidgetQueryPending); const repositories = useMemo(() => { const resultById = new Map(results.flat().map((result) => [result.id, result])); const formattedResults = normalizedRepositories .map((repository) => { if (!repository.provider) return { ...repository, error: { code: "noProviderSelected" } }; const repositoryResult = resultById.get(repository.id); if (!repositoryResult) return { ...repository, error: { code: "noProviderResponse" } }; if (!repositoryResult.success) return { ...repository, error: repositoryResult.error }; const { data: release, provider } = repositoryResult; const isReleaseWithin = (relativeDate: string) => Boolean(relativeDate) && isDateWithin(release.latestReleaseAt, relativeDate); return { ...repository, ...release, providerMetadata: { name: getReleaseProviderName(provider), iconUrl: getReleaseProviderIconUrl(provider) }, isNewRelease: isReleaseWithin(relativeDateOptions.newReleaseWithin), isStaleRelease: !isReleaseWithin(relativeDateOptions.staleReleaseWithin), viewed: releasesViewedList[repository.id] === release.latestRelease, }; }) .toSorted((repoA, repoB) => { if ("error" in repoA) return -1; if ("error" in repoB) return 1; return repoA.latestReleaseAt > repoB.latestReleaseAt ? -1 : 1; }) as ReleasesRepositoryResponse[]; return selectReleaseRepositoriesForDisplay(formattedResults, { displayMode, showOnlyHighlighted: options.showOnlyHighlighted, topReleases: options.topReleases, }); }, [ displayMode, results, normalizedRepositories, options.showOnlyHighlighted, options.topReleases, relativeDateOptions.newReleaseWithin, relativeDateOptions.staleReleaseWithin, releasesViewedList, ]); const toggleExpandedDisplay = useCallback( (repository: ReleasesRepositoryResponse) => setExpandedRepositoryId(expandedRepositoryId === repository.id ? null : repository.id), [expandedRepositoryId], ); const markReleaseViewed = useCallback( (repository: ReleasesRepositoryResponse) => { repository.viewed = true; setReleasesViewedList((prev) => ({ ...prev, [repository.id]: repository.latestRelease ?? "" })); }, [setReleasesViewedList], ); if (isInitialLoading) return ; if (repositories.length === 0) return ; return ( 1 ? "sm" : 0} p={columns > 1 ? "xs" : 0}> {repositories.map((repository: ReleasesRepositoryResponse) => { const isActive = expandedRepositoryId === repository.id; const hasError = repository.error !== undefined; return ( 1 ? { border: "1px solid var(--mantine-color-default-border)", borderRadius: "var(--mantine-radius-sm)", } : undefined } > toggleExpandedDisplay(repository)} aria-expanded={isActive} aria-label={t(isActive ? "collapseDetails" : "expandDetails", { // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing name: repository.name || repository.identifier, })} > {(isAdvanced || !options.showOnlyIcon) && ( {/* eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing */} {repository.name || repository.identifier} )} {hasError ? t("error.label") : (repository.latestRelease ?? t("not-found"))} {repository.latestReleaseAt && !hasError && formatter.relativeTime(repository.latestReleaseAt, { now, style: "long", })} {hasError ? ( ) : repository.viewed ? ( ) : ( (repository.isNewRelease || repository.isStaleRelease) && ( ) )} {(isAdvanced || options.showDetails) && ( )} {isActive && ( )} ); })} ); } interface DetailsDisplayProps { repository: ReleasesRepositoryResponse; isExpanded: boolean; toggleExpandedDisplay: (repository: ReleasesRepositoryResponse) => void; } const DetailsDisplay = ({ repository, isExpanded, toggleExpandedDisplay }: DetailsDisplayProps) => { const t = useI18n("widget.releases"); const formatter = useFormatter(); return ( <> toggleExpandedDisplay(repository)} aria-expanded={isExpanded} aria-label={t(isExpanded ? "collapseDetails" : "expandDetails", { // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing name: repository.name || repository.identifier, })} > {!repository.starsCount ? "-" : formatter.number(repository.starsCount, { notation: "compact", maximumFractionDigits: 1, })} {!repository.forksCount ? "-" : formatter.number(repository.forksCount, { notation: "compact", maximumFractionDigits: 1, })} {!repository.openIssues ? "-" : formatter.number(repository.openIssues, { notation: "compact", maximumFractionDigits: 1, })} ); }; interface ExtendedDisplayProps { repository: ReleasesRepositoryResponse; hasIconColor: boolean; markReleaseViewed: (repository: ReleasesRepositoryResponse) => void; toggleExpandedDisplay: (repository: ReleasesRepositoryResponse) => void; } const ExpandedDisplay = ({ repository, hasIconColor, markReleaseViewed, toggleExpandedDisplay, }: ExtendedDisplayProps) => { const t = useI18n("widget.releases"); const now = useNow(); const formatter = useFormatter(); const releaseUrl = getSafeApplicationUrl(repository.releaseUrl); const repositoryUrl = releaseUrl ?? getSafeApplicationUrl(repository.projectUrl); return ( <> {repository.identifier} {repository.providerMetadata && ( {repository.providerMetadata.name} )} {repository.createdAt && ( {`${t("created")} | `} {formatter.relativeTime(repository.createdAt, { now, style: "long", })} )} {repositoryUrl && ( )} {repository.error && ( <> {t("error.label")} {repository.error.code ? t(`error.messages.${repository.error.code}` as never) : t("error.messages.unexpected")} )} {repository.releaseDescription ? ( ) : ( )} ); }; interface DescriptionProps { title: string; description: string | null; } const Description = ({ title, description }: DescriptionProps) => { if (isNullOrWhitespace(description)) return null; return ( <> {title} {description} ); };