"use client"; import type { ReactNode, RefObject } from "react"; import { useCallback, useMemo, useState } from "react"; import { Group, Loader, Menu, Text, Tooltip } from "@mantine/core"; import { IconAlertTriangle, IconCircleCheck, IconCopy, IconLayoutKanban, IconMaximize, IconRefresh, IconSettings, IconTrash, } from "@tabler/icons-react"; import type { QueryClient, QueryKey } from "@tanstack/react-query"; import { useIsFetching, useQueryClient } from "@tanstack/react-query"; import { clientApi } from "@homarr/api/client"; import { useIntegrationsWithInteractAccess, useSession } from "@homarr/auth/client"; import { useRequiredBoard } from "@homarr/boards/context"; import { useEditMode } from "@homarr/boards/edit-mode"; import { usePersistBoard } from "@homarr/boards/updater"; import { useTimeAgo } from "@homarr/common"; import { useConfirmModal, useModalAction } from "@homarr/modals"; import { showErrorNotification } from "@homarr/notifications"; import { useSettings } from "@homarr/settings"; import { translateIfNecessary } from "@homarr/translation"; import { useI18n, useScopedI18n } from "@homarr/translation/client"; import type { TranslationFunction } from "@homarr/translation"; import type { WidgetDefinition, WidgetRuntimeRef } from "@homarr/widgets"; import { getWidgetQueryKeys, getWidgetRuntimeQueries, reduceWidgetOptionsWithDefaultValues, supportsAdvancedFocus, widgetImports, } from "@homarr/widgets"; import { WidgetEditModal } from "@homarr/widgets/modals"; import type { SectionItem } from "~/app/[locale]/boards/_types"; import { useAdvancedFocus } from "../advanced-focus/context"; import { useBoardPermissions } from "../permissions/client"; import { useSectionContext } from "../sections/section-context"; import { useItemActions } from "./item-actions"; import { ItemMoveModal } from "./item-move-modal"; import { matchesWidgetItemQuery } from "./widget-query-scope"; interface WidgetContextMenuProps { item: SectionItem; widgetRuntimeRef: WidgetRuntimeRef; sourceRef: RefObject; children: ReactNode; } export const WidgetContextMenu = ({ item, widgetRuntimeRef, sourceRef, children }: WidgetContextMenuProps) => { const { data: session } = useSession(); const [isEditMode] = useEditMode(); const board = useRequiredBoard(); const { hasChangeAccess } = useBoardPermissions(board); const { updateAndPersistBoard } = usePersistBoard(board); const tItem = useScopedI18n("item"); const tMenu = useScopedI18n("item.menu.label"); const t = useI18n(); const settings = useSettings(); const isRightClickEnabled = settings.enableRightClickOnWidgets; const { openModal } = useModalAction(WidgetEditModal); const { openModal: openMoveModal } = useModalAction(ItemMoveModal); const { openConfirmModal } = useConfirmModal(); const { updateItemOptions, updateItemAdvancedOptions, updateItemIntegrations, duplicateItem, removeItem } = useItemActions(); const { data: integrationData, isPending } = clientApi.integration.all.useQuery(); const currentDefinition = useMemo( () => widgetImports[item.kind].definition as WidgetDefinition & { kind: string }, [item.kind], ); const canOpenAdvancedFocus = supportsAdvancedFocus(currentDefinition); const { gridstack } = useSectionContext().refs; const queryClient = useQueryClient(); const { open: openAdvancedFocus } = useAdvancedFocus(); const integrationsWithInteractAccess = useIntegrationsWithInteractAccess(); const [menuOpened, setMenuOpened] = useState(false); const persistBoard = useCallback( (updater: (previous: typeof board) => typeof board) => { updateAndPersistBoard(updater, { onError: () => { showErrorNotification({ title: t("item.menu.notification.saveError.title"), message: t("item.menu.notification.saveError.message"), }); }, }); }, [t, updateAndPersistBoard], ); const options = useMemo( () => reduceWidgetOptionsWithDefaultValues(item.kind, settings, item.options), [item.kind, settings, item.options], ); const widgetQueryKeys = useMemo(() => getWidgetQueryKeys(currentDefinition), [currentDefinition]); const widgetQueryMatcher = "queryMatcher" in currentDefinition ? currentDefinition.queryMatcher : undefined; const matchesWidgetQuery = useCallback( (queryKey: QueryKey) => matchesWidgetItemQuery( queryKey, widgetQueryKeys, { itemId: item.id, boardId: board.id, integrationIds: item.integrationIds, options, runtimeQueries: getWidgetRuntimeQueries(widgetRuntimeRef), }, widgetQueryMatcher, ), [board.id, item.id, item.integrationIds, options, widgetQueryKeys, widgetQueryMatcher, widgetRuntimeRef], ); const isWidgetFetching = useIsFetching({ type: "active", predicate: (query) => matchesWidgetQuery(query.queryKey), }) > 0; const handleRefetch = useCallback(() => { void queryClient.refetchQueries({ type: "active", predicate: (query) => matchesWidgetQuery(query.queryKey) }); }, [matchesWidgetQuery, queryClient]); const canInteractWithSelectedIntegrations = useMemo(() => { const allowedIds = new Set(integrationsWithInteractAccess.map(({ id }) => id)); return item.integrationIds.length > 0 && item.integrationIds.every((id) => allowedIds.has(id)); }, [integrationsWithInteractAccess, item.integrationIds]); const setItemOptions = useCallback( (partial: Record) => { if (isEditMode) { updateItemOptions({ itemId: item.id, newOptions: { ...options, ...partial } }); return; } persistBoard((previous) => ({ ...previous, items: previous.items.map((boardItem) => boardItem.id === item.id ? { ...boardItem, options: { ...boardItem.options, ...partial } } : boardItem, ), })); }, [isEditMode, item.id, options, persistBoard, updateItemOptions], ); type OptionDef = { type: string; skipContextMenu?: boolean }; const toggleOptions = useMemo(() => { if (!hasChangeAccess) return []; const rawOptions = currentDefinition.createOptions(settings) as unknown as Record; return Object.entries(rawOptions).filter(([, def]) => def.type === "switch" && !def.skipContextMenu); }, [currentDefinition, hasChangeAccess, settings]); const widgetContextActions = currentDefinition.contextActions?.({ options, setOptions: setItemOptions, integrationIds: item.integrationIds, context: { isEditMode, boardId: board.id, itemId: item.id, canInteractWithSelectedIntegrations, }, widgetRuntimeRef, }) ?? []; const openEditModal = useCallback(() => { openModal( { kind: item.kind, value: { advancedOptions: item.advancedOptions, options: item.options, integrationIds: item.integrationIds, }, onSuccessfulEdit: (editResult) => { if (isEditMode) { updateItemOptions({ itemId: item.id, newOptions: editResult.options }); updateItemAdvancedOptions({ itemId: item.id, newAdvancedOptions: editResult.advancedOptions }); updateItemIntegrations({ itemId: item.id, newIntegrations: editResult.integrationIds }); } else { persistBoard((previous) => ({ ...previous, items: previous.items.map((boardItem) => boardItem.id !== item.id ? boardItem : { ...boardItem, options: editResult.options, advancedOptions: editResult.advancedOptions, integrationIds: editResult.integrationIds, }, ), })); } }, integrationData: (integrationData ?? []).filter( (integration) => "supportedIntegrations" in currentDefinition && (currentDefinition.supportedIntegrations as string[]).some((kind) => kind === integration.kind), ), integrationSupport: "supportedIntegrations" in currentDefinition, settings, appId: item.kind === "app" ? (item.options.appId as string | undefined) : undefined, }, // eslint-disable-next-line @typescript-eslint/no-explicit-any { title: (fn: any) => `${fn("item.edit.title")} - ${fn(`widget.${item.kind}.name`)}` }, ); }, [ openModal, item, updateItemOptions, updateItemAdvancedOptions, updateItemIntegrations, integrationData, currentDefinition, settings, isEditMode, persistBoard, ]); const handleToggle = useCallback( (key: string) => (checked: boolean) => setItemOptions({ [key]: checked }), [setItemOptions], ); if (!session) return <>{children}; if (!isRightClickEnabled) return <>{children}; const visibleWidgetActions = widgetContextActions.filter((a) => !a.hidden); return ( {children} {canOpenAdvancedFocus && ( <> } onClick={() => { if (sourceRef.current) openAdvancedFocus(item.id, sourceRef.current); }} disabled={isEditMode} > {t("item.advancedFocus.open")} )} {toggleOptions.length > 0 && ( <> {tMenu("options")} {toggleOptions.map(([key]) => ( {/* eslint-disable-next-line @typescript-eslint/no-explicit-any */} {String(translateIfNecessary(t, ((fn: any) => fn(`widget.${item.kind}.option.${key}.label`)) as any))} ))} )} {visibleWidgetActions.length > 0 && ( <> {toggleOptions.length > 0 && } {tMenu("actions")} {visibleWidgetActions.map((action) => { const Icon = action.icon; return ( : undefined} onClick={action.onClick} disabled={action.disabled} color={action.color} > {translateIfNecessary(t, action.label)} ); })} )} {isEditMode && ( <> {(toggleOptions.length > 0 || visibleWidgetActions.length > 0) && } } onClick={() => { if (!gridstack.current) return; openMoveModal({ item, columnCount: gridstack.current.getColumn(), gridStack: gridstack.current }); }} > {tItem("action.moveResize")} } onClick={() => duplicateItem({ itemId: item.id })} > {tItem("action.duplicate")} )} <> {(toggleOptions.length > 0 || visibleWidgetActions.length > 0 || isEditMode) && } : } onClick={handleRefetch} disabled={isWidgetFetching} > {tMenu("refresh")} {hasChangeAccess && ( } onClick={openEditModal} disabled={isPending} > {tMenu("settings")} )} {isEditMode && ( <> } onClick={() => { openConfirmModal({ title: tItem("remove.title"), children: tItem("remove.message"), onConfirm: () => removeItem({ itemId: item.id }), }); }} > {tItem("action.remove")} )} ); }; interface WidgetQueryStatusProps { queryClient: QueryClient; matchesQuery: (queryKey: QueryKey) => boolean; isFetching: boolean; t: TranslationFunction; } const WidgetQueryStatus = ({ queryClient, matchesQuery, isFetching, t }: WidgetQueryStatusProps) => { const queries = queryClient.getQueryCache().findAll({ type: "active", predicate: (query) => matchesQuery(query.queryKey), }); const timestamps = queries.map((query) => query.state.dataUpdatedAt).filter(Boolean); const latest = timestamps.length > 0 ? Math.max(...timestamps) : 0; const ageLabel = useTimeAgo(new Date(latest || Date.now())); const ageSuffix = latest > 0 ? ` ยท ${ageLabel}` : ""; if (isFetching) { return ( {t("item.menu.status.loading")} ); } if (queries.length === 0) { return ( {t("item.menu.status.idle")} ); } const hasError = queries.some((q) => q.state.status === "error"); if (hasError) { return ( {t("item.menu.status.error")} {ageSuffix} ); } return ( {t("item.menu.status.success")} {ageSuffix} ); };