style: auto-fix lint and format

The v1.69.0 caching refactor replaced Redis pub/sub with a global 30s
client polling interval. Live monitoring widgets (health-monitoring,
Dashdot, dns-hole) that previously refreshed every 5s were stuck at 30s.

Adds refetchInterval?: number | null to WidgetDefinition:
- number = poll every N seconds (e.g. 5 for live monitoring)
- null = fetch on mount only, no background polling
- undefined = use global 30s default

9 widgets set refetchInterval: 5 (live monitoring)
16 widgets set refetchInterval: null (slow data, mount-only)
Removed inline refetchInterval from docker widget component.

Fixes #6268

apps/nextjs/src/app/[locale]/_client-providers/trpc.tsx

@@ -93,10 +93,10 @@ export function TRPCReactProvider(props: PropsWithChildren) {
     });
     client.setQueryDefaults([["widget"]], { refetchInterval: queryCacheDefaultRefetchIntervalMs });
     for (const { definition } of Object.values(widgetImports)) {
-      const def = definition as { refetchInterval?: number | false; queryKey?: QueryKey; kind: string };
+      const def = definition as { refetchInterval?: number | null; queryKey?: QueryKey; kind: string };
       if (def.refetchInterval === undefined) continue;
       const key = def.queryKey ?? [["widget", def.kind]];
-      const interval = def.refetchInterval === false ? false : def.refetchInterval * 1000;
+      const interval = def.refetchInterval === null ? false : def.refetchInterval * 1000;
       client.setQueryDefaults(key, { refetchInterval: interval });
     }
     return client;

packages/widgets/src/definition.ts

@@ -67,17 +67,10 @@ export const createWidgetDefinition = <TKind extends WidgetKind, TDefinition ext
   withDynamicImport: createWithDynamicImport(kind, definition),
 });
 
-export const widgetRefetchInterval = {
-  fiveSeconds: 5,
-  never: false,
-} as const;
-
-export type WidgetRefetchInterval = (typeof widgetRefetchInterval)[keyof typeof widgetRefetchInterval];
-
 export interface WidgetDefinition {
   icon: TablerIcon;
   queryKey?: QueryKey;
-  refetchInterval?: WidgetRefetchInterval;
+  refetchInterval?: number | null;
   supportedIntegrations?: IntegrationKind[];
   integrationsRequired?: boolean;
   maxIntegrations?: number;

packages/widgets/src/dns-hole/controls/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../../definition";
 import { IconDeviceGamepad, IconServerOff } from "@tabler/icons-react";
 
 import { getIntegrationKindsByCategory } from "@homarr/definitions";
@@ -11,7 +10,7 @@ export const widgetKind = "dnsHoleControls";
 export const { definition, componentLoader } = createWidgetDefinition(widgetKind, {
   icon: IconDeviceGamepad,
   queryKey: [["widget", "dnsHole"]],
-  refetchInterval: widgetRefetchInterval.fiveSeconds,
+  refetchInterval: 5,
   createOptions() {
     return optionsBuilder.from((factory) => ({
       showToggleAllButtons: factory.switch({

packages/widgets/src/dns-hole/summary/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../../definition";
 import { IconAd, IconServerOff } from "@tabler/icons-react";
 
 import { getIntegrationKindsByCategory } from "@homarr/definitions";
@@ -11,7 +10,7 @@ export const widgetKind = "dnsHoleSummary";
 export const { definition, componentLoader } = createWidgetDefinition(widgetKind, {
   icon: IconAd,
   queryKey: [["widget", "dnsHole"]],
-  refetchInterval: widgetRefetchInterval.fiveSeconds,
+  refetchInterval: 5,
   createOptions() {
     return optionsBuilder.from((factory) => ({
       usePiHoleColors: factory.switch({

packages/widgets/src/downloads/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../definition";
 import { IconDownload } from "@tabler/icons-react";
 import { z } from "zod/v4";
 
@@ -34,7 +33,7 @@ const columnsSort = columnsList.filter((column) =>
 
 export const { definition, componentLoader } = createWidgetDefinition("downloads", {
   icon: IconDownload,
-  refetchInterval: widgetRefetchInterval.fiveSeconds,
+  refetchInterval: 5,
   createOptions() {
     return optionsBuilder.from(
       (factory) => ({

packages/widgets/src/firewall/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../definition";
 import { IconWall, IconWallOff } from "@tabler/icons-react";
 
 import { getIntegrationKindsByCategory } from "@homarr/definitions";
@@ -8,7 +7,7 @@ import { optionsBuilder } from "../options";
 
 export const { definition, componentLoader } = createWidgetDefinition("firewall", {
   icon: IconWall,
-  refetchInterval: widgetRefetchInterval.fiveSeconds,
+  refetchInterval: 5,
   createOptions() {
     return optionsBuilder.from(() => ({}));
   },

packages/widgets/src/health-monitoring/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../definition";
 import { IconHeartRateMonitor, IconServerOff } from "@tabler/icons-react";
 
 import { getIntegrationKindsByCategory } from "@homarr/definitions";
@@ -9,7 +8,7 @@ import { createStorageVolumeMultiSelectOptions } from "../storage-volume-options
 
 export const { definition, componentLoader } = createWidgetDefinition("healthMonitoring", {
   icon: IconHeartRateMonitor,
-  refetchInterval: widgetRefetchInterval.fiveSeconds,
+  refetchInterval: 5,
   createOptions() {
     return optionsBuilder.from(
       (factory) => ({

packages/widgets/src/immich/album-carousel/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../../definition";
 import { IconPhoto } from "@tabler/icons-react";
 import z from "zod";
 
@@ -10,7 +9,7 @@ import { optionsBuilder } from "../../options";
 export const { definition, componentLoader } = createWidgetDefinition("immich-albumCarousel", {
   icon: IconPhoto,
   queryKey: [["widget", "immich"]],
-  refetchInterval: widgetRefetchInterval.never,
+  refetchInterval: null,
   supportedIntegrations: ["immich"],
   integrationsRequired: true,
   createOptions() {

packages/widgets/src/immich/server-stats/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../../definition";
 import { IconGraphFilled } from "@tabler/icons-react";
 
 import { createWidgetDefinition } from "../../definition";
@@ -7,7 +6,7 @@ import { optionsBuilder } from "../../options";
 export const { definition, componentLoader } = createWidgetDefinition("immich-serverStats", {
   icon: IconGraphFilled,
   queryKey: [["widget", "immich"]],
-  refetchInterval: widgetRefetchInterval.never,
+  refetchInterval: null,
   supportedIntegrations: ["immich"],
   integrationsRequired: true,
   createOptions() {

packages/widgets/src/index.tsx

@@ -70,9 +70,7 @@ export type {
   WidgetContextMenuAction,
   WidgetContextActionProps,
   WidgetOptionsSettings,
-  WidgetRefetchInterval,
 } from "./definition";
-export { widgetRefetchInterval } from "./definition";
 export type { WidgetComponentProps };
 export type { WidgetOptionDefinition, WidgetOptionType } from "./options";
 

packages/widgets/src/indexer-manager/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../definition";
 import { IconReportSearch, IconServerOff } from "@tabler/icons-react";
 
 import { getIntegrationKindsByCategory } from "@homarr/definitions";
@@ -8,7 +7,7 @@ import { optionsBuilder } from "../options";
 
 export const { definition, componentLoader } = createWidgetDefinition("indexerManager", {
   icon: IconReportSearch,
-  refetchInterval: widgetRefetchInterval.never,
+  refetchInterval: null,
   createOptions() {
     return optionsBuilder.from((factory) => ({
       openIndexerSiteInNewTab: factory.switch({

packages/widgets/src/media-releases/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../definition";
 import { IconTicket } from "@tabler/icons-react";
 
 import { createWidgetDefinition } from "../definition";
@@ -7,7 +6,7 @@ import { optionsBuilder } from "../options";
 export const { definition, componentLoader } = createWidgetDefinition("mediaReleases", {
   icon: IconTicket,
   queryKey: [["widget", "mediaRelease"]],
-  refetchInterval: widgetRefetchInterval.never,
+  refetchInterval: null,
   createOptions() {
     return optionsBuilder.from((factory) => ({
       layout: factory.select({

packages/widgets/src/media-server/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../definition";
 import { IconVideo } from "@tabler/icons-react";
 
 import { getIntegrationKindsByCategory } from "@homarr/definitions";
@@ -8,7 +7,7 @@ import { optionsBuilder } from "../options";
 
 export const { componentLoader, definition } = createWidgetDefinition("mediaServer", {
   icon: IconVideo,
-  refetchInterval: widgetRefetchInterval.fiveSeconds,
+  refetchInterval: 5,
   createOptions() {
     return optionsBuilder.from((factory) => ({
       showOnlyPlaying: factory.switch({ defaultValue: true, withDescription: true }),

packages/widgets/src/media-transcoding/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../definition";
 import { IconTransform } from "@tabler/icons-react";
 import { z } from "zod/v4";
 
@@ -12,7 +11,7 @@ export const views = ["workers", "queue", "statistics"] as const;
 
 export const { componentLoader, definition } = createWidgetDefinition("mediaTranscoding", {
   icon: IconTransform,
-  refetchInterval: widgetRefetchInterval.never,
+  refetchInterval: null,
   createOptions() {
     return optionsBuilder.from((factory) => ({
       defaultView: factory.select({

packages/widgets/src/minecraft/server-status/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../../definition";
 import { IconBrandMinecraft } from "@tabler/icons-react";
 import { z } from "zod/v4";
 
@@ -8,7 +7,7 @@ import { optionsBuilder } from "../../options";
 export const { componentLoader, definition } = createWidgetDefinition("minecraftServerStatus", {
   icon: IconBrandMinecraft,
   queryKey: [["widget", "minecraft"]],
-  refetchInterval: widgetRefetchInterval.never,
+  refetchInterval: null,
   createOptions() {
     return optionsBuilder.from((factory) => ({
       title: factory.text({ defaultValue: "" }),

packages/widgets/src/network-controller/network-status/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../../definition";
 import { IconServerOff, IconTopologyFull } from "@tabler/icons-react";
 
 import { getIntegrationKindsByCategory } from "@homarr/definitions";
@@ -9,7 +8,7 @@ import { optionsBuilder } from "../../options";
 export const { definition, componentLoader } = createWidgetDefinition("networkControllerStatus", {
   icon: IconTopologyFull,
   queryKey: [["widget", "networkController"]],
-  refetchInterval: widgetRefetchInterval.never,
+  refetchInterval: null,
   createOptions() {
     return optionsBuilder.from((factory) => ({
       content: factory.select({

packages/widgets/src/network-controller/summary/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../../definition";
 import { IconServerOff, IconTopologyFull } from "@tabler/icons-react";
 
 import { getIntegrationKindsByCategory } from "@homarr/definitions";
@@ -9,7 +8,7 @@ import { optionsBuilder } from "../../options";
 export const { definition, componentLoader } = createWidgetDefinition("networkControllerSummary", {
   icon: IconTopologyFull,
   queryKey: [["widget", "networkController"]],
-  refetchInterval: widgetRefetchInterval.never,
+  refetchInterval: null,
   createOptions() {
     return optionsBuilder.from(() => ({}));
   },

packages/widgets/src/notifications/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../definition";
 import { IconMessage } from "@tabler/icons-react";
 
 import { getIntegrationKindsByCategory } from "@homarr/definitions";
@@ -8,7 +7,7 @@ import { optionsBuilder } from "../options";
 
 export const { componentLoader, definition } = createWidgetDefinition("notifications", {
   icon: IconMessage,
-  refetchInterval: widgetRefetchInterval.never,
+  refetchInterval: null,
   createOptions() {
     return optionsBuilder.from((factory) => ({
       hideLogos: factory.switch({ defaultValue: false }),

packages/widgets/src/paperless-ngx/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../definition";
 import { IconFileText, IconServerOff } from "@tabler/icons-react";
 
 import { createWidgetDefinition } from "../definition";
@@ -6,7 +5,7 @@ import { optionsBuilder } from "../options";
 
 export const { definition, componentLoader } = createWidgetDefinition("paperlessNgx", {
   icon: IconFileText,
-  refetchInterval: widgetRefetchInterval.never,
+  refetchInterval: null,
   supportedIntegrations: ["paperlessNgx"],
   integrationsRequired: true,
   createOptions() {

packages/widgets/src/releases/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../definition";
 import { IconRocket } from "@tabler/icons-react";
 import { z } from "zod/v4";
 
@@ -15,7 +14,7 @@ const relativeDateSchema = z
 
 export const { definition, componentLoader } = createWidgetDefinition("releases", {
   icon: IconRocket,
-  refetchInterval: widgetRefetchInterval.never,
+  refetchInterval: null,
   createOptions() {
     return optionsBuilder.from((factory) => ({
       newReleaseWithin: factory.text({

packages/widgets/src/rssFeed/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../definition";
 import { IconRss } from "@tabler/icons-react";
 import { z } from "zod/v4";
 
@@ -13,7 +12,7 @@ import { optionsBuilder } from "../options";
  */
 export const { definition, componentLoader } = createWidgetDefinition("rssFeed", {
   icon: IconRss,
-  refetchInterval: widgetRefetchInterval.never,
+  refetchInterval: null,
   createOptions() {
     return optionsBuilder.from((factory) => ({
       feedUrls: factory.multiText({

packages/widgets/src/speedtest-tracker/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../definition";
 import { IconServerOff, IconSpeedboat } from "@tabler/icons-react";
 
 import { createWidgetDefinition } from "../definition";
@@ -6,7 +5,7 @@ import { optionsBuilder } from "../options";
 
 export const { definition, componentLoader } = createWidgetDefinition("speedtestTracker", {
   icon: IconSpeedboat,
-  refetchInterval: widgetRefetchInterval.never,
+  refetchInterval: null,
   createOptions() {
     return optionsBuilder.from(
       (factory) => ({

packages/widgets/src/stocks/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../definition";
 import { IconBuildingBank } from "@tabler/icons-react";
 
 import { createWidgetDefinition } from "../definition";
@@ -14,7 +13,7 @@ const timeIntervalOptions = stockPriceTimeFrames.interval;
 
 export const { definition, componentLoader } = createWidgetDefinition("stockPrice", {
   icon: IconBuildingBank,
-  refetchInterval: widgetRefetchInterval.never,
+  refetchInterval: null,
   createOptions() {
     return optionsBuilder.from((factory) => ({
       stock: factory.text({

packages/widgets/src/system-disks/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../definition";
 import { IconServer2 } from "@tabler/icons-react";
 
 import { createWidgetDefinition } from "../definition";
@@ -8,7 +7,7 @@ import { createStorageVolumeMultiSelectOptions } from "../storage-volume-options
 export const { definition, componentLoader } = createWidgetDefinition("systemDisks", {
   icon: IconServer2,
   queryKey: [["widget", "healthMonitoring"]],
-  refetchInterval: widgetRefetchInterval.fiveSeconds,
+  refetchInterval: 5,
   supportedIntegrations: ["dashDot", "openmediavault", "truenas", "unraid", "synology"],
   createOptions() {
     return optionsBuilder.from(

packages/widgets/src/system-resources/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../definition";
 import { IconAlignLeft, IconEyeOff, IconGraphFilled, IconListDetails, IconPhoto } from "@tabler/icons-react";
 
 import { objectEntries } from "@homarr/common";
@@ -16,7 +15,7 @@ const labelDisplayModeOptions = {
 export const { definition, componentLoader } = createWidgetDefinition("systemResources", {
   icon: IconGraphFilled,
   queryKey: [["widget", "healthMonitoring"]],
-  refetchInterval: widgetRefetchInterval.fiveSeconds,
+  refetchInterval: 5,
   supportedIntegrations: ["dashDot", "openmediavault", "truenas", "unraid", "glances", "synology"],
   createOptions() {
     return optionsBuilder.from((factory) => ({

packages/widgets/src/tracearr/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../definition";
 import { IconActivityHeartbeat, IconServerOff } from "@tabler/icons-react";
 
 import { createWidgetDefinition } from "../definition";
@@ -6,7 +5,7 @@ import { optionsBuilder } from "../options";
 
 export const { definition, componentLoader } = createWidgetDefinition("tracearr", {
   icon: IconActivityHeartbeat,
-  refetchInterval: widgetRefetchInterval.fiveSeconds,
+  refetchInterval: 5,
   createOptions() {
     return optionsBuilder.from((factory) => ({
       showStreams: factory.switch({

packages/widgets/src/umami/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../definition";
 import { IconChartBar, IconServerOff } from "@tabler/icons-react";
 import { z } from "zod/v4";
 
@@ -9,7 +8,7 @@ export const timeFrameValues = ["today", "24h", "7d", "30d", "month", "lastMonth
 
 export const { definition, componentLoader } = createWidgetDefinition("umami", {
   icon: IconChartBar,
-  refetchInterval: widgetRefetchInterval.never,
+  refetchInterval: null,
   supportedIntegrations: ["umami"],
   createOptions() {
     return optionsBuilder.from(

packages/widgets/src/vpn/index.ts

@@ -1,4 +1,3 @@
-import { widgetRefetchInterval } from "../definition";
 import { IconShieldLock } from "@tabler/icons-react";
 
 import { getIntegrationKindsByCategory } from "@homarr/definitions";
@@ -8,7 +7,7 @@ import { optionsBuilder } from "../options";
 
 export const { componentLoader, definition } = createWidgetDefinition("vpn", {
   icon: IconShieldLock,
-  refetchInterval: widgetRefetchInterval.never,
+  refetchInterval: null,
   createOptions() {
     return optionsBuilder.from(() => ({}));
   },