refactor(main): fold remaining main-deps builders into their handlers (#308)

* refactor(main): drop remaining pass-through main-deps builders

Jellyfin client-info/setup-window/remote, overlay shortcuts/visibility/
layout/window-factory, config hot-reload, and startup bootstrap factory
builders only forwarded deps. Callers now pass deps to the handlers
directly; createWatchConfigPathHandler moves into config-hot-reload-handlers.

* refactor(main): fold small-logic main-deps builders into their handlers

Tray click, mpv client factory, startup bootstrap exit callbacks, overlay
runtime options, and dictionary roots/runtime builders move their logic
into the owning handler or call site. The two duplicated dictionary-root
builders become one createBuildDictionaryRootsHandler(vendorDirName).

* refactor(main): fold cli command context builders into the factory

createCliCommandContextFactory now adapts appState and main services to
the CLI command context deps directly (socket-path change notification,
texthooker port/websocket URL, browser-open default). The pass-through
cli-command-context-main-deps and cli-command-context-deps layers are
removed; their behavioural tests now run against the factory's context.

* refactor(main): fold subtitle tokenization builder into the mpv composer

The tokenizer deps builder's logic (known-word lookup recording and the
character-dictionary gate on name matching) becomes
buildTokenizerRuntimeOptions in mpv-runtime-composer, tested through the
composer. The MeCab check and dictionary prewarm handlers move to
subtitle-tokenization-warmup.ts, and the unused BuiltMainDeps type is
removed from composer contracts.

* refactor(main): drop redundant tokenizer deps keys and cast

* refactor(main): end the main-deps builder pattern

mpv-main-event-main-deps becomes mpv-main-event-binding-deps
(createMpvMainEventBindingDeps), returning the binding deps directly
instead of a thunk; it owns the subtitle-recording state. The will-quit
cleanup adapter likewise returns its deps directly, and the pass-through
app-lifecycle activate builders are removed.

* docs: drop references to main-deps builders

src/main/runtime/overlay-runtime-options.ts

@@ -49,69 +49,75 @@ type OverlayRuntimeOptions = {
   releaseOverlayOwner?: () => void;
 };
 
+// Builds the options for core initializeOverlayRuntime from main-process state. appState
+// fields are read when the options are built (or lazily via getters), and the window tracker
+// and Anki integration produced by the core are written back to appState.
 export function createBuildInitializeOverlayRuntimeOptionsHandler(deps: {
-  getBackendOverride: () => string | null;
+  appState: {
+    backendOverride: string | null;
+    windowTracker: Parameters<OverlayRuntimeOptions['setWindowTracker']>[0];
+    subtitleTimingTracker: ReturnType<OverlayRuntimeOptions['getSubtitleTimingTracker']>;
+    mpvClient: ReturnType<OverlayRuntimeOptions['getMpvClient']>;
+    mpvSocketPath: string;
+    runtimeOptionsManager: ReturnType<OverlayRuntimeOptions['getRuntimeOptionsManager']>;
+    ankiIntegration: Parameters<OverlayRuntimeOptions['setAnkiIntegration']>[0];
+  };
+  overlayManager: {
+    getVisibleOverlayVisible: () => boolean;
+  };
+  overlayVisibilityRuntime: {
+    updateVisibleOverlayVisibility: () => void;
+  };
+  refreshCurrentSubtitle?: () => void;
+  overlayShortcutsRuntime: {
+    syncOverlayShortcuts: () => void;
+  };
   createMainWindow: () => void;
   registerGlobalShortcuts: () => void;
   updateVisibleOverlayBounds: (geometry: WindowGeometry) => void;
-  isVisibleOverlayVisible: () => boolean;
-  updateVisibleOverlayVisibility: () => void;
-  refreshCurrentSubtitle?: () => void;
   getOverlayWindows: () => BrowserWindow[];
-  syncOverlayShortcuts: () => void;
-  setWindowTracker: (tracker: BaseWindowTracker | null) => void;
-  createWindowTracker?: (
-    override?: string | null,
-    targetMpvSocketPath?: string | null,
-  ) => BaseWindowTracker | null;
+  createWindowTracker?: OverlayRuntimeOptions['createWindowTracker'];
   getResolvedConfig: () => { ankiConnect?: AnkiConnectConfig };
-  getSubtitleTimingTracker: () => unknown | null;
-  getMpvClient: () => { send?: (payload: { command: string[] }) => void } | null;
-  getMpvSocketPath: () => string;
-  getRuntimeOptionsManager: () => {
-    getEffectiveAnkiConnectConfig: (config?: AnkiConnectConfig) => AnkiConnectConfig;
-  } | null;
-  setAnkiIntegration: (integration: unknown | null) => void;
-  showDesktopNotification: (title: string, options: { body?: string; icon?: string }) => void;
+  showDesktopNotification: OverlayRuntimeOptions['showDesktopNotification'];
   showOverlayNotification?: (payload: OverlayNotificationPayload) => void;
   dismissOverlayNotification?: (id: string) => void;
-  createFieldGroupingCallback: () => (
-    data: KikuFieldGroupingRequestData,
-  ) => Promise<KikuFieldGroupingChoice>;
+  createFieldGroupingCallback: OverlayRuntimeOptions['createFieldGroupingCallback'];
   getKnownWordCacheStatePath: () => string;
-  getCachedMediaPath?: (
-    currentVideoPath: string,
-    kind: 'audio' | 'video',
-  ) => Promise<string | null>;
+  getCachedMediaPath?: OverlayRuntimeOptions['getCachedMediaPath'];
   shouldRequireRemoteMediaCache?: () => boolean;
-  getYoutubeMediaSourceUrl?: () => Promise<string | null | undefined> | string | null | undefined;
+  getYoutubeMediaSourceUrl?: OverlayRuntimeOptions['getYoutubeMediaSourceUrl'];
   shouldStartAnkiIntegration: () => boolean;
   bindOverlayOwner?: () => void;
   releaseOverlayOwner?: () => void;
 }) {
   return (): OverlayRuntimeOptions => ({
-    backendOverride: deps.getBackendOverride(),
-    createMainWindow: deps.createMainWindow,
-    registerGlobalShortcuts: deps.registerGlobalShortcuts,
-    updateVisibleOverlayBounds: deps.updateVisibleOverlayBounds,
-    isVisibleOverlayVisible: deps.isVisibleOverlayVisible,
-    updateVisibleOverlayVisibility: deps.updateVisibleOverlayVisibility,
-    refreshCurrentSubtitle: deps.refreshCurrentSubtitle,
-    getOverlayWindows: deps.getOverlayWindows,
-    syncOverlayShortcuts: deps.syncOverlayShortcuts,
-    setWindowTracker: deps.setWindowTracker,
+    backendOverride: deps.appState.backendOverride,
+    createMainWindow: () => deps.createMainWindow(),
+    registerGlobalShortcuts: () => deps.registerGlobalShortcuts(),
+    updateVisibleOverlayBounds: (geometry) => deps.updateVisibleOverlayBounds(geometry),
+    isVisibleOverlayVisible: () => deps.overlayManager.getVisibleOverlayVisible(),
+    updateVisibleOverlayVisibility: () =>
+      deps.overlayVisibilityRuntime.updateVisibleOverlayVisibility(),
+    refreshCurrentSubtitle: () => deps.refreshCurrentSubtitle?.(),
+    getOverlayWindows: () => deps.getOverlayWindows(),
+    syncOverlayShortcuts: () => deps.overlayShortcutsRuntime.syncOverlayShortcuts(),
+    setWindowTracker: (tracker) => {
+      deps.appState.windowTracker = tracker;
+    },
     createWindowTracker: deps.createWindowTracker,
-    getResolvedConfig: deps.getResolvedConfig,
-    getSubtitleTimingTracker: deps.getSubtitleTimingTracker,
-    getMpvClient: deps.getMpvClient,
-    getMpvSocketPath: deps.getMpvSocketPath,
-    getRuntimeOptionsManager: deps.getRuntimeOptionsManager,
-    setAnkiIntegration: deps.setAnkiIntegration,
+    getResolvedConfig: () => deps.getResolvedConfig(),
+    getSubtitleTimingTracker: () => deps.appState.subtitleTimingTracker,
+    getMpvClient: () => deps.appState.mpvClient,
+    getMpvSocketPath: () => deps.appState.mpvSocketPath,
+    getRuntimeOptionsManager: () => deps.appState.runtimeOptionsManager,
+    setAnkiIntegration: (integration) => {
+      deps.appState.ankiIntegration = integration;
+    },
     showDesktopNotification: deps.showDesktopNotification,
     showOverlayNotification: deps.showOverlayNotification,
     dismissOverlayNotification: deps.dismissOverlayNotification,
-    createFieldGroupingCallback: deps.createFieldGroupingCallback,
-    getKnownWordCacheStatePath: deps.getKnownWordCacheStatePath,
+    createFieldGroupingCallback: () => deps.createFieldGroupingCallback(),
+    getKnownWordCacheStatePath: () => deps.getKnownWordCacheStatePath(),
     ...(deps.getCachedMediaPath ? { getCachedMediaPath: deps.getCachedMediaPath } : {}),
     ...(deps.shouldRequireRemoteMediaCache
       ? { shouldRequireRemoteMediaCache: deps.shouldRequireRemoteMediaCache }
@@ -119,7 +125,7 @@ export function createBuildInitializeOverlayRuntimeOptionsHandler(deps: {
     ...(deps.getYoutubeMediaSourceUrl
       ? { getYoutubeMediaSourceUrl: deps.getYoutubeMediaSourceUrl }
       : {}),
-    shouldStartAnkiIntegration: deps.shouldStartAnkiIntegration,
+    shouldStartAnkiIntegration: () => deps.shouldStartAnkiIntegration(),
     bindOverlayOwner: deps.bindOverlayOwner,
     releaseOverlayOwner: deps.releaseOverlayOwner,
   });