fix(overlay): stop Hyprland/Sway tracker polls from blocking the main thread (#289 )

fix(overlay): poll cheap playback state in the open subtitle sidebar (#290 )
fix(hachidori): close an open pane after its attention is released
2026-11-14 04:46:07 -08:00 · 2026-10-11 01:02:02 -07:00 · 2026-10-11 01:02:02 -07:00 · 2026-10-11 00:54:01 -07:00 · 2026-10-11 00:44:07 -07:00 · 2026-10-11 00:35:19 -07:00
138 changed files with 2747 additions and 958 deletions
@@ -78,10 +78,6 @@ jobs:
      - name: End-to-end suite
        run: bun run test:e2e

-      - name: Dictionary backend windows (Linux)
-        if: runner.os == 'Linux'
-        run: xvfb-run -a bun run test:dictionary:electron
-
      - name: Upload session logs (on failure)
        if: failure()
        uses: actions/upload-artifact@v4
@@ -1,50 +1,5 @@
 # Changelog

-## v0.21.0 (2026-10-24)
-
-### Added
- **Hachidori Dictionary Backend**:
-  - Hachidori is now bundled as an alternative to Yomitan. Select it with `dictionaryBackend`, then restart SubMiner.
-  - It works with subtitle scanning, popups, frequency highlighting, character dictionaries, Anki mining, and stats dashboard mining.
-  - First-run setup builds Hachidori's Anki template from your SubMiner settings. It can also link an external Hachidori app, browser, or Docker host.
-  - The tray and dictionary-settings shortcut open settings for the active backend. Use `--hachidori` or `--yomitan` to open a specific one.
- **Jellyfin Subtitle Generation**: You can now generate Japanese subtitles while playing a Jellyfin episode, with both direct play and transcoded playback.
-
-### Fixed
- **Jellyfin**:
-  - `subminer jellyfin -p` now lists libraries and shows image previews when SubMiner is already running. Real errors are shown instead of an empty list.
-  - Watch progress from terminal playback is reported to Jellyfin even with cast discovery off.
-  - When `subminer jellyfin -p` starts SubMiner, the app shows its tray icon and quits when mpv closes.
-  - Casting on macOS now finds mpv when SubMiner is opened from Finder, the Dock, or Spotlight.
- **Halfwidth Katakana**: Halfwidth katakana in subtitles now displays as fullwidth, including in mined cards and older stats lines. Stats sentence search matches katakana in either width.
- **Media Timing Review**: The review opens on the first attempt instead of after a delay. Playback stays paused while it is open.
- **Subtitle Annotations**: Lines shown while two cues overlap now get annotations right away. Prefetching no longer restarts during startup.
- **Keyboard-Only Mode**: `h`, `l`, and the arrow keys now work for typing in modal text fields instead of seeking mpv.
- **Stats Dashboard Mining**: Cards mined from the stats dashboard keep the selected history line and media.
- **Hyprland and Sway**: The app no longer freezes when `hyprctl` or `swaymsg` is slow or hangs.
- **Subtitle Sidebar**: The open sidebar does much less background work during playback.
- **macOS Launcher Status**: The command-line launcher no longer shows "Not on PATH" when SubMiner is opened from Finder or the Dock.
- **Security Updates**: Updated Electron, undici, and follow-redirects to address security advisories.
-
-### Docs
- **Hachidori Setup**: Documented backend selection, Hachidori dictionary and Anki setup, settings shortcuts, and external host linking.
- **Jellyfin Casting**: Explained when SubMiner joins the cast menu at startup, and how casting finds mpv on each platform. Added a troubleshooting entry for casts that never start mpv.
- **Jimaku Key**: Removed environment variables that never had any effect. Set the key with `jimaku.apiKey` or `jimaku.apiKeyCommand`.
-
-<details>
-<summary>Internal changes</summary>
-
-### Internal
- **End-to-End Harness**: Added a headless e2e harness (`bun run test:e2e`, `bun run e2e`) with real mpv, a fixture dictionary, and a fake AnkiConnect.
- **Hachidori Fork**: The bundled Hachidori integration lives in a pinned fork submodule.
- **Dead Code Removal**:
-  - Removed the unused launcher Jimaku client, the mpv plugin hover-highlight module, and the unused character dictionary config keys.
-  - Removed 16 unused overlay IPC methods. SubMiner no longer forwards every ASS line to the overlay.
-  - Typecheck now runs with `noUnusedLocals`.
- **Setup Launcher Label**: First-run setup now labels a missing launcher "Not set up" instead of "Not installed".
-
-</details>
-
 ## v0.20.1 (2026-10-03)

 ### Added
@@ -201,7 +201,7 @@ The AppImage is all you need. First-run setup can install the optional `subminer

 Download the latest DMG from [GitHub Releases](https://github.com/ksyasuda/SubMiner/releases/latest) and drag `SubMiner.app` into `/Applications`.

-Then enable SubMiner under **System Settings > Privacy & Security > Accessibility** (named **Device Control and Data Access** on macOS 27) so the overlay can track the mpv window. Without it, SubMiner falls back to a basic window lookup that cannot tell when mpv is minimized. If macOS blocks the first launch, right-click the app and choose **Open**.
+Then enable SubMiner under **System Settings > Privacy & Security > Accessibility**, or the overlay cannot follow the mpv window. If macOS blocks the first launch, right-click the app and choose **Open**.

 </details>

@@ -5,6 +5,8 @@
    "": {
      "name": "subminer",
      "dependencies": {
+        "@fontsource-variable/geist": "^5.2.8",
+        "@fontsource-variable/geist-mono": "^5.2.7",
        "@xhayper/discord-rpc": "^1.3.4",
        "axios": "^1.20.0",
        "commander": "^14.0.3",
@@ -19,12 +21,13 @@
        "@electron/asar": "3.4.1",
        "@types/node": "^24.10.0",
        "@types/ws": "^8.18.1",
-        "electron": "43.8.3",
+        "electron": "43.7.7",
        "electron-builder": "26.16.1",
        "esbuild": "^0.25.12",
+        "eslint": "^10.8.0",
        "prettier": "^3.8.1",
        "typescript": "^5.9.3",
-        "undici": "7.30.1",
+        "undici": "7.29.1",
      },
    },
  },
@@ -37,7 +40,6 @@
    "brace-expansion": "5.0.11",
    "electron-builder-squirrel-windows": "26.16.1",
    "fast-uri": "3.1.7",
-    "follow-redirects": "1.16.1",
    "form-data": "4.0.6",
    "ip-address": "10.2.0",
    "js-yaml": "4.3.2",
@@ -46,7 +48,7 @@
    "picomatch": "4.0.4",
    "tar": "7.5.21",
    "tmp": "0.2.7",
-    "undici": "7.30.1",
+    "undici": "7.29.1",
  },
  "packages": {
    "@discordjs/collection": ["@discordjs/collection@2.1.1", "", {}, "sha512-LiSusze9Tc7qF03sLCujF5iZp7K+vRNEDBZ86FT9aQAv3vxMLihUvKvpsCWiQ2DJq1tVckopKm1rxomgNUc9hg=="],
@@ -125,6 +127,34 @@

    "@esbuild/win32-x64": ["@esbuild/win32-x64@0.25.12", "", { "os": "win32", "cpu": "x64" }, "sha512-alJC0uCZpTFrSL0CCDjcgleBXPnCrEAhTBILpeAp7M/OFgoqtAetfBzX0xM00MUsVVPpVjlPuMbREqnZCXaTnA=="],

+    "@eslint-community/eslint-utils": ["@eslint-community/eslint-utils@4.9.1", "", { "dependencies": { "eslint-visitor-keys": "^3.4.3" }, "peerDependencies": { "eslint": "^6.0.0 || ^7.0.0 || >=8.0.0" } }, "sha512-phrYmNiYppR7znFEdqgfWHXR6NCkZEK7hwWDHZUjit/2/U0r6XvkDl0SYnoM51Hq7FhCGdLDT6zxCCOY1hexsQ=="],
+
+    "@eslint-community/regexpp": ["@eslint-community/regexpp@4.12.2", "", {}, "sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew=="],
+
+    "@eslint/config-array": ["@eslint/config-array@0.23.5", "", { "dependencies": { "@eslint/object-schema": "^3.0.5", "debug": "^4.3.1", "minimatch": "^10.2.4" } }, "sha512-Y3kKLvC1dvTOT+oGlqNQ1XLqK6D1HU2YXPc52NmAlJZbMMWDzGYXMiPRJ8TYD39muD/OTjlZmNJ4ib7dvSrMBA=="],
+
+    "@eslint/config-helpers": ["@eslint/config-helpers@0.7.0", "", { "dependencies": { "@eslint/core": "^1.2.1" } }, "sha512-DObd/KKUsU+FaFv4PLxSRenpXfQWmPXXP3pPZ6/K1PCrMu2vQpMDMuQe/BqYeoLcz8ro0bVDF1RxOJgfVEdhUw=="],
+
+    "@eslint/core": ["@eslint/core@1.2.1", "", { "dependencies": { "@types/json-schema": "^7.0.15" } }, "sha512-MwcE1P+AZ4C6DWlpin/OmOA54mmIZ/+xZuJiQd4SyB29oAJjN30UW9wkKNptW2ctp4cEsvhlLY/CsQ1uoHDloQ=="],
+
+    "@eslint/object-schema": ["@eslint/object-schema@3.0.5", "", {}, "sha512-vqTaUEgxzm+YDSdElad6PiRoX4t8VGDjCtt05zn4nU810UIx/uNEV7/lZJ6KwFThKZOzOxzXy48da+No7HZaMw=="],
+
+    "@eslint/plugin-kit": ["@eslint/plugin-kit@0.7.2", "", { "dependencies": { "@eslint/core": "^1.2.1", "levn": "^0.4.1" } }, "sha512-+CNAzxglkrpNf/kKywqQfk74QjtceuOE7Qm+AF8miRvPF/wmmK5+OJOgVh3AVTT3RP2mH3+FOaxlE5v72owk0A=="],
+
+    "@fontsource-variable/geist": ["@fontsource-variable/geist@5.2.8", "", {}, "sha512-cJ6m9e+8MQ5dCYJsLylfZrgBh6KkG4bOLckB35Tr9J/EqdkEM6QllH5PxqP1dhTvFup+HtMRPuz9xOjxXJggxw=="],
+
+    "@fontsource-variable/geist-mono": ["@fontsource-variable/geist-mono@5.2.7", "", {}, "sha512-ZKlZ5sjtalb2TwXKs400mAGDlt/+2ENLNySPx0wTz3bP3mWARCsUW+rpxzZc7e05d2qGch70pItt3K4qttbIYA=="],
+
+    "@humanfs/core": ["@humanfs/core@0.19.2", "", { "dependencies": { "@humanfs/types": "^0.15.0" } }, "sha512-UhXNm+CFMWcbChXywFwkmhqjs3PRCmcSa/hfBgLIb7oQ5HNb1wS0icWsGtSAUNgefHeI+eBrA8I1fxmbHsGdvA=="],
+
+    "@humanfs/node": ["@humanfs/node@0.16.8", "", { "dependencies": { "@humanfs/core": "^0.19.2", "@humanfs/types": "^0.15.0", "@humanwhocodes/retry": "^0.4.0" } }, "sha512-gE1eQNZ3R++kTzFUpdGlpmy8kDZD/MLyHqDwqjkVQI0JMdI1D51sy1H958PNXYkM2rAac7e5/CnIKZrHtPh3BQ=="],
+
+    "@humanfs/types": ["@humanfs/types@0.15.0", "", {}, "sha512-ZZ1w0aoQkwuUuC7Yf+7sdeaNfqQiiLcSRbfI08oAxqLtpXQr9AIVX7Ay7HLDuiLYAaFPu8oBYNq/QIi9URHJ3Q=="],
+
+    "@humanwhocodes/module-importer": ["@humanwhocodes/module-importer@1.0.1", "", {}, "sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA=="],
+
+    "@humanwhocodes/retry": ["@humanwhocodes/retry@0.4.3", "", {}, "sha512-bV0Tgo9K4hfPCek+aMAn81RppFKv2ySDQeMoSZuvTASywNTnVJCArCZE2FWqpvIatKu7VMRLWlR1EazvVhDyhQ=="],
+
    "@isaacs/fs-minipass": ["@isaacs/fs-minipass@4.0.1", "", { "dependencies": { "minipass": "^7.0.4" } }, "sha512-wgm9Ehl2jpeqP3zw/7mo3kRHFp5MEDhqAdwy1fTGkHAwnkGOVsgpvQhL8B5n1qlb01jV3n/bI0ZfZp5lWA1k4w=="],

    "@libsql/darwin-arm64": ["@libsql/darwin-arm64@0.5.28", "", { "os": "darwin", "cpu": "arm64" }, "sha512-Lc/b8JXO2W2+H+5UXfw7PCHZCim1jlrB0CmLPsjfVmihMluBpdYafFImhjAHxHlWGfuZ32WzjVPUap5fGmkthw=="],
@@ -173,10 +203,16 @@

    "@types/debug": ["@types/debug@4.1.13", "", { "dependencies": { "@types/ms": "*" } }, "sha512-KSVgmQmzMwPlmtljOomayoR89W4FynCAi3E8PPs7vmDVPe84hT+vGPKkJfThkmXs0x0jAaa9U8uW8bbfyS2fWw=="],

+    "@types/esrecurse": ["@types/esrecurse@4.3.1", "", {}, "sha512-xJBAbDifo5hpffDBuHl0Y8ywswbiAp/Wi7Y/GtAgSlZyIABppyurxVueOPE8LUQOxdlgi6Zqce7uoEpqNTeiUw=="],
+
+    "@types/estree": ["@types/estree@1.0.9", "", {}, "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg=="],
+
    "@types/fs-extra": ["@types/fs-extra@9.0.13", "", { "dependencies": { "@types/node": "*" } }, "sha512-nEnwB++1u5lVDM2UI4c1+5R+FYaKfaAzS4OococimjVm3nQw3TuzH5UNsocrcTBbhnerblyHj4A49qXbIiZdpA=="],

    "@types/http-cache-semantics": ["@types/http-cache-semantics@4.2.0", "", {}, "sha512-L3LgimLHXtGkWikKnsPg0/VFx9OGZaC+eN1u4r+OB1XRqH3meBIAVC2zr1WdMH+RHmnRkqliQAOHNJ/E0j/e0Q=="],

+    "@types/json-schema": ["@types/json-schema@7.0.15", "", {}, "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA=="],
+
    "@types/keyv": ["@types/keyv@3.1.4", "", { "dependencies": { "@types/node": "*" } }, "sha512-BQ5aZNSCpj7D6K2ksrRCTmKRLEpnPvWDiLPfoGyhZ++8YtiK9d/3DBKPJgry359X/P1PfruyYwvnvwFjuEiEIg=="],

    "@types/ms": ["@types/ms@2.1.0", "", {}, "sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA=="],
@@ -195,9 +231,13 @@

    "abbrev": ["abbrev@4.0.0", "", {}, "sha512-a1wflyaL0tHtJSmLSOVybYhy22vRih4eduhhrkcjgrWGnRfrZtovJ2FRjxuTtkkj47O/baf0R86QU5OuYpz8fA=="],

+    "acorn": ["acorn@8.16.0", "", { "bin": { "acorn": "bin/acorn" } }, "sha512-UVJyE9MttOsBQIDKw1skb9nAwQuR5wuGD3+82K6JgJlm/Y+KI92oNsMNGZCYdDsVtRHSak0pcV5Dno5+4jh9sw=="],
+
+    "acorn-jsx": ["acorn-jsx@5.3.2", "", { "peerDependencies": { "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0" } }, "sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ=="],
+
    "agent-base": ["agent-base@6.0.2", "", { "dependencies": { "debug": "4" } }, "sha512-RZNwNclF7+MS/8bDg70amg32dyeZGZxiDuQmZxKLAlQjr3jGyLx+4Kkk58UO7D2QdgFIQCovuSuZESne6RG6XQ=="],

-    "ajv": ["ajv@8.20.0", "", { "dependencies": { "fast-deep-equal": "^3.1.3", "fast-uri": "^3.0.1", "json-schema-traverse": "^1.0.0", "require-from-string": "^2.0.2" } }, "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA=="],
+    "ajv": ["ajv@6.14.0", "", { "dependencies": { "fast-deep-equal": "^3.1.1", "fast-json-stable-stringify": "^2.0.0", "json-schema-traverse": "^0.4.1", "uri-js": "^4.2.2" } }, "sha512-IWrosm/yrn43eiKqkfkHis7QioDleaXQHdDVPKg0FSwwd/DuvyX79TZnFOnYpB7dcsFAMmtFztZuXPDvSePkFw=="],

    "ansi-regex": ["ansi-regex@5.0.1", "", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="],

@@ -277,6 +317,8 @@

    "decompress-response": ["decompress-response@6.0.0", "", { "dependencies": { "mimic-response": "^3.1.0" } }, "sha512-aW35yZM6Bb/4oJlZncMH2LCoZtJXTRxES17vE3hoRiowU2kWHaJKFkSBDnDR+cm9J+9QhXmREyIfv0pji9ejCQ=="],

+    "deep-is": ["deep-is@0.1.4", "", {}, "sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ=="],
+
    "defer-to-connect": ["defer-to-connect@2.0.1", "", {}, "sha512-4tvttepXG1VaYGrRibk5EwJd1t4udunSOVMdLSAL6mId1ix438oPwPZMALY41FCijukO1L0twNcGsdzS7dHgDg=="],

    "define-data-property": ["define-data-property@1.1.4", "", { "dependencies": { "es-define-property": "^1.0.0", "es-errors": "^1.3.0", "gopd": "^1.0.1" } }, "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A=="],
@@ -305,7 +347,7 @@

    "ejs": ["ejs@3.1.10", "", { "dependencies": { "jake": "^10.8.5" }, "bin": { "ejs": "bin/cli.js" } }, "sha512-UeJmFfOrAQS8OJWPZ4qtgHyWExa088/MtK5UEyoJGFH67cDEXkZSviOiKRCZ4Xij0zxI3JECgYs3oKx+AizQBA=="],

-    "electron": ["electron@43.8.3", "", { "dependencies": { "@electron-internal/extract-zip": "^1.0.1", "@electron/get": "^5.0.0", "@types/node": "^24.9.0" }, "bin": { "electron": "cli.js", "install-electron": "install.js" } }, "sha512-KgvSm3bHXz96hSXzqxyRjLeli80rIdszbDQFKlRSfckmGazTPCH/CxUN31Dp9c5rFKTQSNf9gPJRWl1yWNB3pA=="],
+    "electron": ["electron@43.7.7", "", { "dependencies": { "@electron-internal/extract-zip": "^1.0.1", "@electron/get": "^5.0.0", "@types/node": "^24.9.0" }, "bin": { "electron": "cli.js", "install-electron": "install.js" } }, "sha512-y0pg+KhWLAkW2Ts2njkFFNFl3KtB1FmbUp9Te9i+R2Og2v1fcI/I6MADJ7jvnzB5UKdt+U+0EUoCnVL79xMPMA=="],

    "electron-builder": ["electron-builder@26.16.1", "", { "dependencies": { "app-builder-lib": "26.16.1", "builder-util": "26.16.0", "builder-util-runtime": "9.7.0", "chalk": "^4.1.2", "ci-info": "^4.2.0", "dmg-builder": "26.16.1", "fs-extra": "^10.1.0", "lazy-val": "^1.0.5", "simple-update-notifier": "2.0.0", "yargs": "^17.6.2" }, "bin": { "electron-builder": "./cli.js", "install-app-deps": "./install-app-deps.js" } }, "sha512-LrLK65QX5PUYYODXqp23FKrV7CILTtVY7mrJckNknO9jLNSMiqFkKbSMiDRw4CjOADMPVDdWLxY4mezOZWswxg=="],

@@ -341,17 +383,45 @@

    "escape-string-regexp": ["escape-string-regexp@4.0.0", "", {}, "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA=="],

+    "eslint": ["eslint@10.8.0", "", { "dependencies": { "@eslint-community/eslint-utils": "^4.8.0", "@eslint-community/regexpp": "^4.12.2", "@eslint/config-array": "^0.23.5", "@eslint/config-helpers": "^0.7.0", "@eslint/core": "^1.2.1", "@eslint/plugin-kit": "^0.7.2", "@humanfs/node": "^0.16.6", "@humanwhocodes/module-importer": "^1.0.1", "@humanwhocodes/retry": "^0.4.2", "@types/estree": "^1.0.6", "ajv": "^6.14.0", "cross-spawn": "^7.0.6", "debug": "^4.3.2", "escape-string-regexp": "^4.0.0", "eslint-scope": "^9.1.2", "eslint-visitor-keys": "^5.0.1", "espree": "^11.2.0", "esquery": "^1.7.0", "esutils": "^2.0.2", "fast-deep-equal": "^3.1.3", "file-entry-cache": "^8.0.0", "find-up": "^5.0.0", "glob-parent": "^6.0.2", "ignore": "^5.2.0", "imurmurhash": "^0.1.4", "is-glob": "^4.0.0", "json-stable-stringify-without-jsonify": "^1.0.1", "minimatch": "^10.2.5", "natural-compare": "^1.4.0", "optionator": "^0.9.3" }, "peerDependencies": { "jiti": "*" }, "optionalPeers": ["jiti"], "bin": { "eslint": "bin/eslint.js" } }, "sha512-nuKKvN+oIBO0koN7Tm7dlkmnkc21mtt0QJLwAKzjLq14y6lRTdVG36MZHJ8eQHwdJMwZbQNMlPOYedMq/oVJvQ=="],
+
+    "eslint-scope": ["eslint-scope@9.1.2", "", { "dependencies": { "@types/esrecurse": "^4.3.1", "@types/estree": "^1.0.8", "esrecurse": "^4.3.0", "estraverse": "^5.2.0" } }, "sha512-xS90H51cKw0jltxmvmHy2Iai1LIqrfbw57b79w/J7MfvDfkIkFZ+kj6zC3BjtUwh150HsSSdxXZcsuv72miDFQ=="],
+
+    "eslint-visitor-keys": ["eslint-visitor-keys@5.0.1", "", {}, "sha512-tD40eHxA35h0PEIZNeIjkHoDR4YjjJp34biM0mDvplBe//mB+IHCqHDGV7pxF+7MklTvighcCPPZC7ynWyjdTA=="],
+
+    "espree": ["espree@11.2.0", "", { "dependencies": { "acorn": "^8.16.0", "acorn-jsx": "^5.3.2", "eslint-visitor-keys": "^5.0.1" } }, "sha512-7p3DrVEIopW1B1avAGLuCSh1jubc01H2JHc8B4qqGblmg5gI9yumBgACjWo4JlIc04ufug4xJ3SQI8HkS/Rgzw=="],
+
+    "esquery": ["esquery@1.7.0", "", { "dependencies": { "estraverse": "^5.1.0" } }, "sha512-Ap6G0WQwcU/LHsvLwON1fAQX9Zp0A2Y6Y/cJBl9r/JbW90Zyg4/zbG6zzKa2OTALELarYHmKu0GhpM5EO+7T0g=="],
+
+    "esrecurse": ["esrecurse@4.3.0", "", { "dependencies": { "estraverse": "^5.2.0" } }, "sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag=="],
+
+    "estraverse": ["estraverse@5.3.0", "", {}, "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA=="],
+
+    "esutils": ["esutils@2.0.3", "", {}, "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g=="],
+
    "exponential-backoff": ["exponential-backoff@3.1.3", "", {}, "sha512-ZgEeZXj30q+I0EN+CbSSpIyPaJ5HVQD18Z1m+u1FXbAeT94mr1zw50q4q6jiiC447Nl/YTcIYSAftiGqetwXCA=="],

    "fast-deep-equal": ["fast-deep-equal@3.1.3", "", {}, "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q=="],

+    "fast-json-stable-stringify": ["fast-json-stable-stringify@2.1.0", "", {}, "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw=="],
+
+    "fast-levenshtein": ["fast-levenshtein@2.0.6", "", {}, "sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw=="],
+
    "fast-uri": ["fast-uri@3.1.7", "", {}, "sha512-dOvZVzjdZdz7phd9v6jCbwxrBW3fK6n8Rc0CtdmM4bumzMnxywBYhuph6J819RRw/ku+rLbelwfMunktuzVVHg=="],

    "fdir": ["fdir@6.5.0", "", { "peerDependencies": { "picomatch": "^3 || ^4" }, "optionalPeers": ["picomatch"] }, "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg=="],

+    "file-entry-cache": ["file-entry-cache@8.0.0", "", { "dependencies": { "flat-cache": "^4.0.0" } }, "sha512-XXTUwCvisa5oacNGRP9SfNtYBNAMi+RPwBFmblZEF7N7swHYQS6/Zfk7SRwx4D5j3CH211YNRco1DEMNVfZCnQ=="],
+
    "filelist": ["filelist@1.0.6", "", { "dependencies": { "minimatch": "^5.0.1" } }, "sha512-5giy2PkLYY1cP39p17Ech+2xlpTRL9HLspOfEgm0L6CwBXBTgsK5ou0JtzYuepxkaQ/tvhCFIJ5uXo0OrM2DxA=="],

-    "follow-redirects": ["follow-redirects@1.16.1", "", { "peerDependencies": { "debug": "*" }, "optionalPeers": ["debug"] }, "sha512-FNvFGzoMLWmE6Yj9spb/zjd7yiNCHiAW9/Tg9CXrQ8wuu32HtlJOwWO11OJafl5FfY3DxTdQ0vj42zU1kvv5jg=="],
+    "find-up": ["find-up@5.0.0", "", { "dependencies": { "locate-path": "^6.0.0", "path-exists": "^4.0.0" } }, "sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng=="],
+
+    "flat-cache": ["flat-cache@4.0.1", "", { "dependencies": { "flatted": "^3.2.9", "keyv": "^4.5.4" } }, "sha512-f7ccFPK3SXFHpx15UIGyRJ/FJQctuKZ0zVuN3frBo4HnK3cay9VEW0R6yPYFHC0AgqhukPzKjq22t5DmAyqGyw=="],
+
+    "flatted": ["flatted@3.4.2", "", {}, "sha512-PjDse7RzhcPkIJwy5t7KPWQSZ9cAbzQXcafsetQoD7sOJRQlGikNbx7yZp2OotDnJyrDcbyRq3Ttb18iYOqkxA=="],
+
+    "follow-redirects": ["follow-redirects@1.16.0", "", {}, "sha512-y5rN/uOsadFT/JfYwhxRS5R7Qce+g3zG97+JrtFZlC9klX/W5hD7iiLzScI4nZqUS7DNUdhPgw4xI8W2LuXlUw=="],

    "form-data": ["form-data@4.0.6", "", { "dependencies": { "asynckit": "^0.4.0", "combined-stream": "^1.0.8", "es-set-tostringtag": "^2.1.0", "hasown": "^2.0.4", "mime-types": "^2.1.35" } }, "sha512-vKatAh4SlVfgbv+YtmhiRjhEMJsYpsG1Y2rMQtR+SVSbytsSD1YGzDIcrAJmdFec88u/+VoGmxnl+80gL1tRCQ=="],

@@ -371,6 +441,8 @@

    "glob": ["glob@7.2.3", "", { "dependencies": { "fs.realpath": "^1.0.0", "inflight": "^1.0.4", "inherits": "2", "minimatch": "^3.1.1", "once": "^1.3.0", "path-is-absolute": "^1.0.0" } }, "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q=="],

+    "glob-parent": ["glob-parent@6.0.2", "", { "dependencies": { "is-glob": "^4.0.3" } }, "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A=="],
+
    "global-agent": ["global-agent@3.0.0", "", { "dependencies": { "boolean": "^3.0.1", "es6-error": "^4.1.1", "matcher": "^3.0.0", "roarr": "^2.15.3", "semver": "^7.3.2", "serialize-error": "^7.0.1" } }, "sha512-PT6XReJ+D07JvGoxQMkT6qji/jVNfX/h364XHZOWeRzy64sSFr+xJ5OX7LI3b4MPQzdL4H8Y8M0xzPpsVMwA8Q=="],

    "globalthis": ["globalthis@1.0.4", "", { "dependencies": { "define-properties": "^1.2.1", "gopd": "^1.0.1" } }, "sha512-DpLKbNU4WylpxJykQujfCcwYWiV/Jhm50Goo0wrVILAv5jOr9d+H+UR3PhSCD2rCCEIg0uc+G+muBTwD54JhDQ=="],
@@ -403,12 +475,20 @@

    "https-proxy-agent": ["https-proxy-agent@5.0.1", "", { "dependencies": { "agent-base": "6", "debug": "4" } }, "sha512-dFcAjpTQFgoLMzC2VwU+C/CbS7uRL0lWmxDITmqm7C+7F0Odmj6s9l6alZc6AELXhrnggM2CeWSXHGOdX2YtwA=="],

+    "ignore": ["ignore@5.3.2", "", {}, "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g=="],
+
+    "imurmurhash": ["imurmurhash@0.1.4", "", {}, "sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA=="],
+
    "inflight": ["inflight@1.0.6", "", { "dependencies": { "once": "^1.3.0", "wrappy": "1" } }, "sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA=="],

    "inherits": ["inherits@2.0.4", "", {}, "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ=="],

+    "is-extglob": ["is-extglob@2.1.1", "", {}, "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ=="],
+
    "is-fullwidth-code-point": ["is-fullwidth-code-point@3.0.0", "", {}, "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg=="],

+    "is-glob": ["is-glob@4.0.3", "", { "dependencies": { "is-extglob": "^2.1.1" } }, "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg=="],
+
    "isarray": ["isarray@1.0.0", "", {}, "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ=="],

    "isbinaryfile": ["isbinaryfile@5.0.7", "", {}, "sha512-gnWD14Jh3FzS3CPhF0AxNOJ8CxqeblPTADzI38r0wt8ZyQl5edpy75myt08EG2oKvpyiqSqsx+Wkz9vtkbTqYQ=="],
@@ -423,7 +503,9 @@

    "json-buffer": ["json-buffer@3.0.1", "", {}, "sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ=="],

-    "json-schema-traverse": ["json-schema-traverse@1.0.0", "", {}, "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug=="],
+    "json-schema-traverse": ["json-schema-traverse@0.4.1", "", {}, "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg=="],
+
+    "json-stable-stringify-without-jsonify": ["json-stable-stringify-without-jsonify@1.0.1", "", {}, "sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw=="],

    "json-stringify-safe": ["json-stringify-safe@5.0.1", "", {}, "sha512-ZClg6AaYvamvYEE82d3Iyd3vSSIjQ+odgjaTzRuO3s7toCdFKczob2i0zCh7JE8kWn17yvAWhUVxvqGwUalsRA=="],

@@ -439,8 +521,12 @@

    "lazy-val": ["lazy-val@1.0.5", "", {}, "sha512-0/BnGCCfyUMkBpeDgWihanIAF9JmZhHBgUhEqzvf+adhNGLoP6TaiI5oF8oyb3I45P+PcnrqihSf01M0l0G5+Q=="],

+    "levn": ["levn@0.4.1", "", { "dependencies": { "prelude-ls": "^1.2.1", "type-check": "~0.4.0" } }, "sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ=="],
+
    "libsql": ["libsql@0.5.28", "", { "dependencies": { "@neon-rs/load": "^0.0.4", "detect-libc": "2.0.2" }, "optionalDependencies": { "@libsql/darwin-arm64": "0.5.28", "@libsql/darwin-x64": "0.5.28", "@libsql/linux-arm-gnueabihf": "0.5.28", "@libsql/linux-arm-musleabihf": "0.5.28", "@libsql/linux-arm64-gnu": "0.5.28", "@libsql/linux-arm64-musl": "0.5.28", "@libsql/linux-x64-gnu": "0.5.28", "@libsql/linux-x64-musl": "0.5.28", "@libsql/win32-x64-msvc": "0.5.28" }, "os": [ "linux", "win32", "darwin", ], "cpu": [ "arm", "x64", "arm64", ] }, "sha512-wKqx9FgtPcKHdPfR/Kfm0gejsnbuf8zV+ESPmltFvsq5uXwdeN9fsWn611DmqrdXj1e94NkARcMA2f1syiAqOg=="],

+    "locate-path": ["locate-path@6.0.0", "", { "dependencies": { "p-locate": "^5.0.0" } }, "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw=="],
+
    "lodash": ["lodash@4.18.0", "", {}, "sha512-l1mfj2atMqndAHI3ls7XqPxEjV2J9ZkcNyHpoZA3r2T1LLwDB69jgkMWh71YKwhBbK0G2f4WSn05ahmQXVxupA=="],

    "lodash.escaperegexp": ["lodash.escaperegexp@4.1.2", "", {}, "sha512-TM9YBvyC84ZxE3rgfefxUWiQKLilstD6k7PTGt6wfbtXF8ixIJLOL3VYyV/z+ZiPLsVxAsKAFVwWlWeb2Y8Yyw=="],
@@ -477,6 +563,8 @@

    "ms": ["ms@2.1.3", "", {}, "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA=="],

+    "natural-compare": ["natural-compare@1.4.0", "", {}, "sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw=="],
+
    "node-abi": ["node-abi@4.28.0", "", { "dependencies": { "semver": "^7.6.3" } }, "sha512-Qfp5XZL1cJDOabOT8H5gnqMTmM4NjvYzHp4I/Kt/Sl76OVkOBBHRFlPspGV0hYvMoqQsypFjT/Yp7Km0beXW9g=="],

    "node-api-version": ["node-api-version@0.2.1", "", { "dependencies": { "semver": "^7.3.5" } }, "sha512-2xP/IGGMmmSQpI1+O/k72jF/ykvZ89JeuKX3TLJAYPDVLUalrshrLHkeVcCCZqG/eEa635cr8IBYzgnDvM2O8Q=="],
@@ -493,10 +581,16 @@

    "once": ["once@1.4.0", "", { "dependencies": { "wrappy": "1" } }, "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w=="],

+    "optionator": ["optionator@0.9.4", "", { "dependencies": { "deep-is": "^0.1.3", "fast-levenshtein": "^2.0.6", "levn": "^0.4.1", "prelude-ls": "^1.2.1", "type-check": "^0.4.0", "word-wrap": "^1.2.5" } }, "sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g=="],
+
    "p-cancelable": ["p-cancelable@2.1.1", "", {}, "sha512-BZOr3nRQHOntUjTrH8+Lh54smKHoHyur8We1V8DSMVrl5A2malOOwuJRnKRDjSnkoeBh4at6BwEnb5I7Jl31wg=="],

    "p-limit": ["p-limit@3.1.0", "", { "dependencies": { "yocto-queue": "^0.1.0" } }, "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ=="],

+    "p-locate": ["p-locate@5.0.0", "", { "dependencies": { "p-limit": "^3.0.2" } }, "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw=="],
+
+    "path-exists": ["path-exists@4.0.0", "", {}, "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w=="],
+
    "path-is-absolute": ["path-is-absolute@1.0.1", "", {}, "sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg=="],

    "path-key": ["path-key@3.1.1", "", {}, "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q=="],
@@ -513,6 +607,8 @@

    "postject": ["postject@1.0.0-alpha.6", "", { "dependencies": { "commander": "^9.4.0" }, "bin": { "postject": "dist/cli.js" } }, "sha512-b9Eb8h2eVqNE8edvKdwqkrY6O7kAwmI8kcnBv1NScolYJbo59XUF0noFq+lxbC1yN20bmC0WBEbDC5H/7ASb0A=="],

+    "prelude-ls": ["prelude-ls@1.2.1", "", {}, "sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g=="],
+
    "prettier": ["prettier@3.8.1", "", { "bin": { "prettier": "bin/prettier.cjs" } }, "sha512-UOnG6LftzbdaHZcKoPFtOcCKztrQ57WkHDeRD9t/PTQtmT0NHSeWWepj6pS0z/N7+08BHFDQVUrfmfMRcZwbMg=="],

    "proc-log": ["proc-log@6.1.0", "", {}, "sha512-iG+GYldRf2BQ0UDUAd6JQ/RwzaQy6mXmsk/IzlYyal4A4SNFw54MeH4/tLkF4I5WoWG9SQwuqWzS99jaFQHBuQ=="],
@@ -529,6 +625,8 @@

    "pump": ["pump@3.0.4", "", { "dependencies": { "end-of-stream": "^1.1.0", "once": "^1.3.1" } }, "sha512-VS7sjc6KR7e1ukRFhQSY5LM2uBWAUPiOPa/A3mkKmiMwSmRFUITt0xuj+/lesgnCv+dPIEYlkzrcyXgquIHMcA=="],

+    "punycode": ["punycode@2.3.1", "", {}, "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg=="],
+
    "pvtsutils": ["pvtsutils@1.3.6", "", { "dependencies": { "tslib": "^2.8.1" } }, "sha512-PLgQXQ6H2FWCaeRak8vvk1GW462lMxB5s3Jm673N82zI4vqtVUPuZdffdZbPDFRoU8kAhItWFtPCWiPpp4/EDg=="],

    "pvutils": ["pvutils@1.1.5", "", {}, "sha512-KTqnxsgGiQ6ZAzZCVlJH5eOjSnvlyEgx1m8bkRJfOhmGRqfo5KLvmAlACQkrjEtOQ4B7wF9TdSLIs9O90MX9xA=="],
@@ -613,11 +711,13 @@

    "tslib": ["tslib@2.8.1", "", {}, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],

+    "type-check": ["type-check@0.4.0", "", { "dependencies": { "prelude-ls": "^1.2.1" } }, "sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew=="],
+
    "type-fest": ["type-fest@0.13.1", "", {}, "sha512-34R7HTnG0XIJcBSn5XhDd7nNFPRcXYRZrBB2O2jdKqYODldSzBAqzsWoZYYvduky73toYS/ESqxPvkDf/F0XMg=="],

    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],

-    "undici": ["undici@7.30.1", "", {}, "sha512-03KrMbjIFDWQR5RNPrSw3bd1r12JpyFQl9/yxjUbJtqkjmllqC5lFjZh6ujeuJCKr8EOQvRW872Oy/az+nLYxg=="],
+    "undici": ["undici@7.29.1", "", {}, "sha512-RYONW2MeafgYlkVOKYKkA/Ag7BmXqgIWCa8t1m0JcxrQg9pI9lEqRhAOruOBCbAohOa/gkCF+iPi9hrgvTzu6Q=="],

    "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],

@@ -625,6 +725,8 @@

    "unzipper": ["unzipper@0.12.5", "", { "dependencies": { "bluebird": "~3.7.2", "duplexer2": "~0.1.4", "fs-extra": "11.3.1", "graceful-fs": "^4.2.2", "node-int64": "^0.4.0" } }, "sha512-tXYOi9R57Uj/2Z25SOs5RRSzq886MBQj2gY8dPL+xl/kv6s6SvByoKfAtvfVeEuhntWDgjd2o9p2lb4TVPAz0A=="],

+    "uri-js": ["uri-js@4.4.1", "", { "dependencies": { "punycode": "^2.1.0" } }, "sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg=="],
+
    "utf8-byte-length": ["utf8-byte-length@1.0.5", "", {}, "sha512-Xn0w3MtiQ6zoz2vFyUVruaCL53O/DwUvkEeOvj+uulMm0BkUGYWmBYVyElqZaSLhY6ZD0ulfU3aBra2aVT4xfA=="],

    "util-deprecate": ["util-deprecate@1.0.2", "", {}, "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw=="],
@@ -633,6 +735,8 @@

    "which": ["which@5.0.0", "", { "dependencies": { "isexe": "^3.1.1" }, "bin": { "node-which": "bin/which.js" } }, "sha512-JEdGzHwwkrbWoGOlIHqQ5gtprKGOenpDHpxE9zVR1bWbOtYRyPPHMe9FaP6x61CmNaTThSkb0DAJte5jD+DmzQ=="],

+    "word-wrap": ["word-wrap@1.2.5", "", {}, "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA=="],
+
    "wrap-ansi": ["wrap-ansi@7.0.0", "", { "dependencies": { "ansi-styles": "^4.0.0", "string-width": "^4.1.0", "strip-ansi": "^6.0.0" } }, "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q=="],

    "wrappy": ["wrappy@1.0.2", "", {}, "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ=="],
@@ -667,6 +771,8 @@

    "@electron/windows-sign/fs-extra": ["fs-extra@11.3.4", "", { "dependencies": { "graceful-fs": "^4.2.0", "jsonfile": "^6.0.1", "universalify": "^2.0.0" } }, "sha512-CTXd6rk/M3/ULNQj8FBqBWHYBVYybQ3VPBw0xGKFe3tuH7ytT6ACnvzpIQ3UZtB8yvUKC2cXn1a+x+5EVQLovA=="],

+    "@eslint-community/eslint-utils/eslint-visitor-keys": ["eslint-visitor-keys@3.4.3", "", {}, "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag=="],
+
    "@malept/flatpak-bundler/fs-extra": ["fs-extra@9.1.0", "", { "dependencies": { "at-least-node": "^1.0.0", "graceful-fs": "^4.2.0", "jsonfile": "^6.0.1", "universalify": "^2.0.0" } }, "sha512-hcg3ZmepS30/7BSFqRvoo3DOMQu7IjqxO5nCDt+zM9XWjb33Wg7ziNT+Qvqbuc3+gWpzO02JubVyk2G4Zvo1OQ=="],

    "@types/cacheable-request/@types/node": ["@types/node@25.5.0", "", { "dependencies": { "undici-types": "~7.18.0" } }, "sha512-jp2P3tQMSxWugkCUKLRPVUpGaL5MVFwF8RDuSRztfwgN1wmqJeMSbKlnEtQqU8UrhTmzEmZdu2I6v2dpp7XIxw=="],
@@ -681,6 +787,8 @@

    "app-builder-lib/@electron/get": ["@electron/get@3.1.0", "", { "dependencies": { "debug": "^4.1.1", "env-paths": "^2.2.0", "fs-extra": "^8.1.0", "got": "^11.8.5", "progress": "^2.0.3", "semver": "^6.2.0", "sumchecker": "^3.0.1" }, "optionalDependencies": { "global-agent": "^3.0.0" } }, "sha512-F+nKc0xW+kVbBRhFzaMgPy3KwmuNTYX1fx6+FxxoSnNgwYX6LD7AKBTWkU0MQ6IBoe7dz069CNkR673sPAgkCQ=="],

+    "app-builder-lib/ajv": ["ajv@8.20.0", "", { "dependencies": { "fast-deep-equal": "^3.1.3", "fast-uri": "^3.0.1", "json-schema-traverse": "^1.0.0", "require-from-string": "^2.0.2" } }, "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA=="],
+
    "app-builder-lib/ci-info": ["ci-info@4.3.1", "", {}, "sha512-Wdy2Igu8OcBpI2pZePZ5oWjPC38tmDVx5WKUXKwlLYkA0ozo85sLsLvkBbBn/sZaSCMFOGZJ14fvW9t5/d7kdA=="],

    "builder-util/https-proxy-agent": ["https-proxy-agent@7.0.6", "", { "dependencies": { "agent-base": "^7.1.2", "debug": "4" } }, "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw=="],
@@ -727,6 +835,8 @@

    "app-builder-lib/@electron/get/semver": ["semver@6.3.1", "", { "bin": { "semver": "bin/semver.js" } }, "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA=="],

+    "app-builder-lib/ajv/json-schema-traverse": ["json-schema-traverse@1.0.0", "", {}, "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug=="],
+
    "builder-util/https-proxy-agent/agent-base": ["agent-base@7.1.4", "", {}, "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ=="],

    "cross-spawn/which/isexe": ["isexe@2.0.0", "", {}, "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw=="],
@@ -0,0 +1,4 @@
+type: internal
+area: testing
+
+- Added a headless end-to-end harness (`bun run test:e2e`, `bun run e2e`) that boots the built app with a real mpv, a synthetic clip, a fixture Yomitan dictionary, and a fake AnkiConnect on an offscreen display.
@@ -0,0 +1,4 @@
+type: fixed
+area: anki
+
+- Media timing review now keeps playback paused while it is open when the dictionary popup or subtitle hover pause ends, as with Hachidori popups closing when the review appears. Playback resumes after the review closes unless a dictionary popup is still open.
@@ -0,0 +1,14 @@
+type: added
+area: dictionary
+
+- Added a bundled Hachidori dictionary backend alongside the default Yomitan backend. Select it with `dictionaryBackend` and restart SubMiner.
+- The tray and dictionary-settings shortcut follow the selected backend. `--hachidori` opens Hachidori settings, while `--yomitan` opens Yomitan settings unless a read-only external Yomitan profile is configured. This restriction also applies with Hachidori active, without blocking Hachidori settings.
+- Hachidori integrates with subtitle scanning, popup controls, lookup tracking, character dictionaries, and Anki media enrichment, with separate dictionaries and settings for each backend. Character dictionaries reach a linked host over the link (Hachidori 0.2.3 or later, or a current Docker host), retry busy imports, and replace the previous dictionary only after a successful import. Older hosts report where to import the dictionary manually.
+- Hachidori auto-populates its first Anki template from SubMiner's deck, tags, and field mappings, detects an unambiguous matching note type, and preserves existing custom templates apart from the deck, which follows `ankiConnect.deck` so polling mode enriches Hachidori cards. Anki discovery retries after an unavailable connection.
+- Hachidori saves downloadable word audio before sending a note through SubMiner's Anki proxy, so freshly mined animated cards include the word-audio delay.
+- Both bundled dictionary backends reload their background code on startup so extension updates take effect while preserving installed dictionaries and settings. Failed Yomitan connection-setting updates can be retried without manually resetting the managed Anki endpoint.
+- First-run setup remembers each backend that finished it, including when reopened for legacy plugin cleanup, so switching back does not repeat setup, and the launcher gates playback on the backend the running app started with. Current incomplete or cancelled setup takes precedence over stale completion history. A running Yomitan session keeps using its external profile until it restarts into Hachidori.
+- Stats dashboard mining and deck lookup use the selected backend, with the Anki proxy enabled or disabled. Dashboard cards retain the selected history line and media instead of being processed again with the current mpv subtitle, with both Yomitan and Hachidori. Stats cards carry a `SubMiner::Stats` tag so polling also preserves their context. Hachidori word mining supplies dictionary aliases, IDs, and frequency metadata to its native Anki renderer. Settings labels for popup pause and the dictionary deck no longer name Yomitan, and the backend selector sits with the other dictionary settings.
+- Hachidori scans, dictionary counts, and settings reads wait for the dictionary engine to finish loading or importing instead of caching empty results.
+- First-run setup can link an external Hachidori dictionary host in an app, browser, or Docker container, verify its library, and unlink back to local dictionaries. The optional host controls are collapsed by default and explain which apps or containers must stay running. Unresponsive connection checks time out so setup remains usable. Anki mining, media enrichment, and custom toolbar buttons stay in SubMiner, including when editing buttons while linked.
+- Hachidori frequency highlighting reuses dictionary-entry ranks and fills missing ranks through its existing API. Entries without a matching definition may remain unranked. The bundled integration is maintained in a pinned fork submodule using upstream HoshiDicts and WASM binaries.
@@ -0,0 +1,4 @@
+type: docs
+area: dictionary
+
+- Documented backend selection, separate Hachidori dictionary and Anki setup, the settings flags and shortcuts, and external host linking with local Anki mining and the running requirements for each host type.
@@ -0,0 +1,7 @@
+type: fixed
+area: jellyfin
+
+- Fixed `subminer jellyfin -p` reporting "No Jellyfin libraries found." when SubMiner was already running (for example right after `subminer jellyfin` login). The app now hands library, item, and preview-auth results to the launcher directly instead of through log files, so picker image previews work again and real errors (expired session, unreachable server) are shown instead of an empty list.
+- The rofi "Jellyfin Search (optional)" step after picking a library is now a compact input box with a "Type to search, or press Enter to browse all" hint instead of a blank list.
+- Playing from the terminal (`subminer jellyfin -p`) now reports watch progress to Jellyfin even when cast discovery is off, so Jellyfin remembers where you stopped and marks finished episodes as played. Previously progress was only sent while the cast connection was active.
+- When `subminer jellyfin -p` has to start SubMiner itself, the app now shows its tray icon and quits when you close mpv, the same as playing a local file. Before, it had no tray icon and kept running hidden after playback. A SubMiner that was already running is still reused and left running.
@@ -0,0 +1,4 @@
+type: docs
+area: jellyfin
+
+- Corrected the Jellyfin docs: SubMiner only joins the cast menu at startup when `startupWarmups.jellyfinRemoteSession` is on (off by default) along with `jellyfin.remoteControlAutoConnect`. Otherwise tick **Jellyfin Discovery** in the tray.
@@ -0,0 +1,4 @@
+type: fixed
+area: overlay
+
+- Keyboard-only mode no longer swallows `h`, `l`, and the left/right arrows while a modal is open or a text field has focus, so typing into fields like the Jimaku or TsukiHime title works and no longer seeks mpv. Pressing `Ctrl/Cmd+Shift+Y` (or the controller toggle) inside a modal no longer turns on a hidden keyboard-only mode in the modal window.
@@ -0,0 +1,4 @@
+type: fixed
+area: setup
+
+- Fixed the command-line launcher showing "Not on PATH" on macOS when SubMiner was opened from Finder or the Dock, even though the launcher directory was already on your terminal PATH.
@@ -0,0 +1,4 @@
+type: fixed
+area: overlay
+
+- Overlay modals such as the media timing review open on the first attempt when their dedicated window is created on demand, instead of after a four-second retry.
@@ -0,0 +1,5 @@
+type: fixed
+area: annotations
+
+- Subtitle lines shown while two cues overlap (common in Jimaku and Jellyfin SRTs, and usually the long lines) are now prefetched, so their annotations appear immediately instead of after a delay.
+- Subtitle prefetching no longer restarts each time the same subtitle file is re-selected during startup, and a line tokenized before a restart or seek is kept instead of discarded.
@@ -0,0 +1,4 @@
+type: fixed
+area: setup
+
+- First-run setup now labels a missing command-line launcher "Not set up" instead of "Not installed", so the AppImage catalog test no longer reads the setup window as an error screen.
@@ -0,0 +1,4 @@
+type: fixed
+area: overlay
+
+- The open subtitle sidebar no longer re-fetches the whole subtitle list and re-queries mpv about 12 times a second. It polls only the current time and line, and reloads the list when the subtitle track, file, or parsed cues change (plus a slow ~2 s fallback), cutting idle sidebar IPC and renderer work during playback.
@@ -0,0 +1,5 @@
+type: fixed
+area: overlay
+
+- Hyprland and Sway window tracking no longer freezes the app when `hyprctl` or `swaymsg` is slow or hangs: polls now run in the background with a timeout and no longer pile up.
+- The Hyprland/Sway trackers read each mpv process's command line once instead of spawning `ps` on every poll.
@@ -741,10 +741,10 @@
  // autoStartSubMiner starts SubMiner in the background; auto_start_overlay only controls visible overlay display.
  // Set mpv.launchMode to choose normal, maximized, or fullscreen SubMiner-managed mpv playback.
  // Set mpv.profile to pass an mpv profile to managed mpv launches; leave it blank to pass none.
-  // Leave mpv.executablePath blank to auto-discover mpv from SUBMINER_MPV_PATH, PATH, or (macOS) Homebrew and /Applications/mpv.app.
+  // Leave mpv.executablePath blank to auto-discover mpv.exe from SUBMINER_MPV_PATH or PATH.
  // ==========================================
  "mpv": {
-    "executablePath": "", // Optional absolute path to the mpv binary SubMiner starts itself (Windows launches, Jellyfin casting, timing preview). Leave empty to auto-discover from SUBMINER_MPV_PATH, PATH, and on macOS the Homebrew and /Applications/mpv.app locations.
+    "executablePath": "", // Optional absolute path to mpv.exe for Windows launch flows. Leave empty to auto-discover from SUBMINER_MPV_PATH or PATH.
    "launchMode": "normal", // Default window state for SubMiner-managed mpv launches. Values: normal | maximized | fullscreen
    "profile": "", // Optional mpv profile name passed to SubMiner-managed mpv launches. Leave empty to pass no profile.
    "socketPath": "/tmp/subminer-socket", // mpv IPC socket path used by SubMiner-managed playback and the bundled mpv plugin.
@@ -49,7 +49,7 @@ Clients must send notes to the proxy (`http://127.0.0.1:8766` here), not to Anki
 With the [Hachidori backend](/usage#hachidori-setup), SubMiner fills Hachidori's first Anki template from your `ankiConnect` settings on startup and whenever you open Hachidori Settings:

 - The deck always follows `ankiConnect.deck`, because polling only looks for new cards in that deck.
- While the template still has Hachidori's default `hachidori` tag, the configured tags are added ahead of it so cards carry both. Tags you edit in Hachidori settings are kept as written.
+- Configured tags go into untouched defaults.
 - Missing word, sentence, pronunciation-audio, and picture mappings are filled with fields that exist in Anki. Pronunciation uses `fields.wordAudio`, or `fields.audio` when no word-audio field is set.
 - If the note type is unset, SubMiner picks the one note type that has your word and sentence fields. Enabled Lapis, Kiku, or Senren narrows the search. A fresh mapping also gets Hachidori's matching preset for readings, definitions, and other known fields.

@@ -1,56 +1,6 @@
 # Changelog

-## v0.21.0 (2026-10-24)
-
-**Added**
- **Hachidori Dictionary Backend**:
-  - Hachidori is now bundled as an alternative to Yomitan. Select it with `dictionaryBackend`, then restart SubMiner.
-  - It works with subtitle scanning, popups, frequency highlighting, character dictionaries, Anki mining, and stats dashboard mining.
-  - First-run setup builds Hachidori's Anki template from your SubMiner settings. It can also link an external Hachidori app, browser, or Docker host.
-  - The tray and dictionary-settings shortcut open settings for the active backend. Use `--hachidori` or `--yomitan` to open a specific one.
- **Jellyfin Subtitle Generation**: You can now generate Japanese subtitles while playing a Jellyfin episode, with both direct play and transcoded playback.
-
-**Fixed**
- **Jellyfin**:
-  - `subminer jellyfin -p` now lists libraries and shows image previews when SubMiner is already running. Real errors are shown instead of an empty list.
-  - Watch progress from terminal playback is reported to Jellyfin even with cast discovery off.
-  - When `subminer jellyfin -p` starts SubMiner, the app shows its tray icon and quits when mpv closes.
-  - Casting on macOS now finds mpv when SubMiner is opened from Finder, the Dock, or Spotlight.
- **Halfwidth Katakana**: Halfwidth katakana in subtitles now displays as fullwidth, including in mined cards and older stats lines. Stats sentence search matches katakana in either width.
- **Media Timing Review**: The review opens on the first attempt instead of after a delay. Playback stays paused while it is open.
- **Subtitle Annotations**: Lines shown while two cues overlap now get annotations right away. Prefetching no longer restarts during startup.
- **Keyboard-Only Mode**: `h`, `l`, and the arrow keys now work for typing in modal text fields instead of seeking mpv.
- **Stats Dashboard Mining**: Cards mined from the stats dashboard keep the selected history line and media.
- **Hyprland and Sway**: The app no longer freezes when `hyprctl` or `swaymsg` is slow or hangs.
- **Subtitle Sidebar**: The open sidebar does much less background work during playback.
- **macOS Launcher Status**: The command-line launcher no longer shows "Not on PATH" when SubMiner is opened from Finder or the Dock.
- **Security Updates**: Updated Electron, undici, and follow-redirects to address security advisories.
-
-**Docs**
- **Hachidori Setup**: Documented backend selection, Hachidori dictionary and Anki setup, settings shortcuts, and external host linking.
- **Jellyfin Casting**: Explained when SubMiner joins the cast menu at startup, and how casting finds mpv on each platform. Added a troubleshooting entry for casts that never start mpv.
- **Jimaku Key**: Removed environment variables that never had any effect. Set the key with `jimaku.apiKey` or `jimaku.apiKeyCommand`.
-
-<details>
-<summary>Internal changes</summary>
-
-**Internal**
- **End-to-End Harness**: Added a headless e2e harness (`bun run test:e2e`, `bun run e2e`) with real mpv, a fixture dictionary, and a fake AnkiConnect.
- **Hachidori Fork**: The bundled Hachidori integration lives in a pinned fork submodule.
- **Dead Code Removal**:
-  - Removed the unused launcher Jimaku client, the mpv plugin hover-highlight module, and the unused character dictionary config keys.
-  - Removed 16 unused overlay IPC methods. SubMiner no longer forwards every ASS line to the overlay.
-  - Typecheck now runs with `noUnusedLocals`.
- **Setup Launcher Label**: First-run setup now labels a missing launcher "Not set up" instead of "Not installed".
-
-</details>
-
-## Previous Versions
-
-<details>
-<summary>v0.20.x</summary>
-
-<h2>v0.20.1 (2026-10-03)</h2>
+## v0.20.1 (2026-10-03)

 **Added**
 - **YouTube Browser Window**:
@@ -100,7 +50,7 @@

 </details>

-<h2>v0.20.0 (2026-09-23)</h2>
+## v0.20.0 (2026-09-23)

 **Added**
 - **Japanese Subtitle Generation**:
@@ -221,7 +171,7 @@

 </details>

-</details>
+## Previous Versions

 <details>
 <summary>v0.19.x</summary>
@@ -585,18 +585,18 @@ A local web dashboard at `http://127.0.0.1:<serverPort>`, also available as an o

 Settings for mpv instances that SubMiner starts, and for the bundled mpv plugin. See [mpv plugin](/mpv-plugin).

-| Key                          | Default           | What it does                                                                                            |
-| ---------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------- |
-| `mpv.executablePath`         | `""`              | Full path to mpv. Empty auto-discovers it ([lookup order](/jellyfin-integration#casting-from-jellyfin)) |
-| `mpv.launchMode`             | `"normal"`        | Window state: `normal`, `maximized`, or `fullscreen`                                                    |
-| `mpv.profile`                | `""`              | mpv profile to pass. Combined with a launcher `--profile` if both are set                               |
-| `mpv.socketPath`             | platform-specific | mpv IPC socket. See the warning under [Config file](#configuration-file)                                |
-| `mpv.backend`                | `"auto"`          | Window tracking: `auto`, `hyprland`, `sway`, `x11`, `macos`, `windows`                                  |
-| `mpv.autoStartSubMiner`      | `true`            | Start SubMiner in the background when mpv loads a file                                                  |
-| `mpv.pauseUntilOverlayReady` | `true`            | Keep mpv paused until subtitles are ready, up to 30 seconds                                             |
-| `mpv.subminerBinaryPath`     | `""`              | SubMiner app path for the plugin. Empty uses the detected path                                          |
-| `mpv.aniskipEnabled`         | `true`            | Detect intros with AniSkip and show a skip prompt                                                       |
-| `mpv.aniskipButtonKey`       | `"TAB"`           | mpv key that skips the intro while the prompt is shown                                                  |
+| Key                          | Default           | What it does                                                                |
+| ---------------------------- | ----------------- | --------------------------------------------------------------------------- |
+| `mpv.executablePath`         | `""`              | Path to `mpv.exe` on Windows. Empty checks `SUBMINER_MPV_PATH`, then `PATH` |
+| `mpv.launchMode`             | `"normal"`        | Window state: `normal`, `maximized`, or `fullscreen`                        |
+| `mpv.profile`                | `""`              | mpv profile to pass. Combined with a launcher `--profile` if both are set   |
+| `mpv.socketPath`             | platform-specific | mpv IPC socket. See the warning under [Config file](#configuration-file)    |
+| `mpv.backend`                | `"auto"`          | Window tracking: `auto`, `hyprland`, `sway`, `x11`, `macos`, `windows`      |
+| `mpv.autoStartSubMiner`      | `true`            | Start SubMiner in the background when mpv loads a file                      |
+| `mpv.pauseUntilOverlayReady` | `true`            | Keep mpv paused until subtitles are ready, up to 30 seconds                 |
+| `mpv.subminerBinaryPath`     | `""`              | SubMiner app path for the plugin. Empty uses the detected path              |
+| `mpv.aniskipEnabled`         | `true`            | Detect intros with AniSkip and show a skip prompt                           |
+| `mpv.aniskipButtonKey`       | `"TAB"`           | mpv key that skips the intro while the prompt is shown                      |

 ### YouTube playback settings

@@ -175,6 +175,9 @@ Run `make help` for the full list.
 | `SUBMINER_MPV_PLUGIN_PATH`         | mpv plugin directory the launcher injects                        |
 | `SUBMINER_LOG_LEVEL`               | App log level (`debug`, `info`, `warn`, `error`)                 |
 | `SUBMINER_MPV_LOG`                 | Shared mpv/app log file path                                     |
+| `SUBMINER_JIMAKU_API_KEY`          | Jimaku API key for launcher subtitle downloads                   |
+| `SUBMINER_JIMAKU_API_KEY_COMMAND`  | Command that prints the Jimaku API key                           |
+| `SUBMINER_JIMAKU_API_BASE_URL`     | Jimaku API base URL                                              |
 | `SUBMINER_JELLYFIN_ACCESS_TOKEN`   | Jellyfin access token, used before the stored encrypted session  |
 | `SUBMINER_JELLYFIN_USER_ID`        | Jellyfin user ID                                                 |
 | `SUBMINER_SKIP_MACOS_HELPER_BUILD` | Set to `1` to skip the macOS helper build during `bun run build` |
@@ -187,7 +187,7 @@ First-run setup can install the `subminer` command for you.
   xattr -d com.apple.quarantine /Applications/SubMiner.app
   ```

-3. Open **System Settings > Privacy & Security > Accessibility** and enable SubMiner (add it if it is missing). On macOS 27 this list is named **Device Control and Data Access**. SubMiner uses it to track the mpv window. Without it, SubMiner falls back to a basic window lookup that cannot tell when mpv is minimized.
+3. Open **System Settings > Privacy & Security > Accessibility** and enable SubMiner (add it if it is missing). The overlay cannot follow the mpv window without this.

 First-run setup can install the `subminer` command for you.

@@ -23,9 +23,7 @@ SubMiner starts mpv if it is not already running. Pause, seek, stop, and track c

 SubMiner selects a Japanese subtitle track automatically and resets mpv's subtitle delay to zero. It direct-plays files when it can and asks Jellyfin to transcode the rest.

-If an episode has no Japanese subtitles, you can [generate them with Whisper](/subtitle-generation#generating-from-the-overlay) while it plays.
-
-Casting finds mpv through `mpv.executablePath`, then `SUBMINER_MPV_PATH`, then `PATH`. On macOS it then checks `/opt/homebrew/bin/mpv`, `/usr/local/bin/mpv`, and `/Applications/mpv.app`, because an app opened from Finder, the Dock, or Spotlight does not get your shell's `PATH`. If mpv lives somewhere else, set `mpv.executablePath` to its full path (`command -v mpv` prints it). An invalid `mpv.executablePath` stops mpv from starting.
+On Windows, casting finds mpv through `mpv.executablePath`, then `SUBMINER_MPV_PATH`, then `PATH`. An invalid `mpv.executablePath` stops mpv from starting.

 ## Playing from the terminal

@@ -741,10 +741,10 @@
  // autoStartSubMiner starts SubMiner in the background; auto_start_overlay only controls visible overlay display.
  // Set mpv.launchMode to choose normal, maximized, or fullscreen SubMiner-managed mpv playback.
  // Set mpv.profile to pass an mpv profile to managed mpv launches; leave it blank to pass none.
-  // Leave mpv.executablePath blank to auto-discover mpv from SUBMINER_MPV_PATH, PATH, or (macOS) Homebrew and /Applications/mpv.app.
+  // Leave mpv.executablePath blank to auto-discover mpv.exe from SUBMINER_MPV_PATH or PATH.
  // ==========================================
  "mpv": {
-    "executablePath": "", // Optional absolute path to the mpv binary SubMiner starts itself (Windows launches, Jellyfin casting, timing preview). Leave empty to auto-discover from SUBMINER_MPV_PATH, PATH, and on macOS the Homebrew and /Applications/mpv.app locations.
+    "executablePath": "", // Optional absolute path to mpv.exe for Windows launch flows. Leave empty to auto-discover from SUBMINER_MPV_PATH or PATH.
    "launchMode": "normal", // Default window state for SubMiner-managed mpv launches. Values: normal | maximized | fullscreen
    "profile": "", // Optional mpv profile name passed to SubMiner-managed mpv launches. Leave empty to pass no profile.
    "socketPath": "/tmp/subminer-socket", // mpv IPC socket path used by SubMiner-managed playback and the bundled mpv plugin.
@@ -16,7 +16,7 @@ The modal's **Local tools** section lists anything missing. After you install a

 ## Generating from the overlay

-1. Open a local video in mpv and select its Japanese audio track, or play a Jellyfin or YouTube video.
+1. Open a local video in mpv and select its Japanese audio track, or play a YouTube video.
 2. Press `Ctrl+Shift+G`. If the subtitle sidebar is empty, its **Generate Japanese subtitles** button opens the same modal.
 3. Pick a model and download it if needed.
 4. Optionally check **Focus on spoken dialogue** (see below).
@@ -26,8 +26,6 @@ The modal shows progress. **Cancel** stops the job. Closing the modal lets the j

 SubMiner saves `<video>.ja.generated.srt` next to the video and adds a number if that name is taken. If the same file is still playing, it loads the subtitles and resets the subtitle delay.

-For a Jellyfin video, SubMiner reads the original file from your server and saves the subtitles to `~/.cache/subminer/generated-subs/`, since a stream has no folder of its own. Each Jellyfin generation replaces the previous file there. Playback keeps going while it works. If Jellyfin is transcoding, SubMiner transcribes the audio track that playback started with.
-
 For a YouTube video, SubMiner downloads its audio first and pauses the video until the subtitles load. The subtitles are temporary, and the audio is deleted when generation ends or you switch videos. See [YouTube integration](/youtube-integration#generate-subtitles-with-whisper).

 Change the shortcut with `shortcuts.openSubtitleGeneration`.
@@ -48,7 +46,7 @@ subminer generate-subs episode.mkv --model-path /path/to/ggml-small.bin
 | `--audio-stream <index>` | Pick an audio stream by its absolute FFmpeg index             |
 | `--output <path>`        | Write to this SRT path. Existing files are never overwritten. |

-With a file argument, SubMiner uses the audio stream tagged Japanese, or the first stream. `Ctrl+C` cancels. The launcher only works with local files. Use the overlay for Jellyfin and YouTube.
+With a file argument, SubMiner uses the audio stream tagged Japanese, or the first stream. `Ctrl+C` cancels.

 ## Choosing a model

@@ -39,18 +39,11 @@ SubMiner reads subtitles from mpv over an IPC socket (a named pipe on Windows).

 SubMiner reconnects on its own if mpv restarts.

-## Casting from Jellyfin does nothing
-
-When `connect ENOENT /tmp/subminer-socket` follows a cast in the app log, SubMiner could not start mpv, so the socket never appeared. Look for `Failed handling Jellyfin remote Play event` or `Failed to launch mpv for Jellyfin remote playback` just before it.
-
- Check that `mpv --version` works in a terminal.
- If it does, SubMiner is not finding mpv where it is installed. Set `mpv.executablePath` to the output of `command -v mpv`. See [Casting from Jellyfin](/jellyfin-integration#casting-from-jellyfin) for where SubMiner looks.
-
 ## Overlay does not appear

 - Confirm SubMiner is running (`SubMiner.AppImage --start`, or check for the process).
 - Linux: Hyprland and Sway work natively. Any other compositor needs mpv and SubMiner under X11 or Xwayland, with `xdotool`, `xprop`, and `xwininfo` installed. See [KDE Plasma and other Wayland compositors](#kde-plasma-and-other-wayland-compositors).
- macOS: grant Accessibility permission. See [macOS](#macos).
+- macOS: grant Accessibility permission in System Settings > Privacy & Security > Accessibility.

 ## Overlay is on the wrong monitor or position

@@ -262,5 +255,5 @@ mpv --gpu-context=x11vk,x11egl,x11 video.mkv

 ## macOS

- Grant Accessibility permission under System Settings > Privacy & Security > Accessibility (named **Device Control and Data Access** on macOS 27). Without it, SubMiner falls back to a basic window lookup that cannot tell when mpv is minimized.
+- Accessibility permission is required for window tracking: System Settings > Privacy & Security > Accessibility.
 - If Gatekeeper blocks the app, right-click it and choose Open, or run `xattr -d com.apple.quarantine /path/to/SubMiner.app`.
@@ -24,7 +24,7 @@ The bundled Yomitan is separate from any Yomitan in your browser. It has its own

 Hachidori is an alternative lookup backend. Set `dictionaryBackend` to `"hachidori"` in settings or `config.jsonc`, then restart SubMiner. Set it back to `"yomitan"` and restart to switch back.

-Open Hachidori settings with `Alt+Shift+Y`, the tray's **Open Hachidori Settings**, or `subminer app --hachidori`. Import dictionary ZIPs or use Hachidori's recommended dictionary installer, then set up its Anki template (SubMiner [fills in what it can](/anki-integration#hachidori-settings-from-subminer)). Yomitan and Hachidori keep separate dictionaries and settings. Yomitan profiles, custom Handlebars templates, and `yomitan.externalProfilePath` do not carry over. Subtitle annotations and lookups wait while Hachidori imports a dictionary, so large imports pause them until the import finishes.
+Open Hachidori settings with `Alt+Shift+Y`, the tray's **Open Hachidori Settings**, or `subminer app --hachidori`. Import dictionary ZIPs or use Hachidori's recommended dictionary installer, then set up its Anki template (SubMiner [fills in what it can](/anki-integration#hachidori-settings-from-subminer)). Yomitan and Hachidori keep separate dictionaries and settings. Yomitan profiles, custom Handlebars templates, and `yomitan.externalProfilePath` do not carry over.

 Hachidori uses SubMiner's subtitle scanning, popup pause, controller commands, character dictionaries, and Anki media. Keep the [Anki proxy](/anki-integration#proxy-mode-setup-yomitan-texthooker) on for screenshots and sentence audio. Hachidori's own screen recorder and screenshot capture are off inside SubMiner. `startupWarmups.yomitanExtension` and `subtitleStyle.autoPauseVideoOnYomitanPopup` apply to whichever backend is selected.

@@ -0,0 +1,298 @@
+# Renderer Performance Optimizations
+
+**Date:** 2026-03-15
+**Status:** Draft
+
+## Goal
+
+Minimize the time between a subtitle line appearing and annotations being displayed. Three optimizations target different pipeline stages to achieve this.
+
+## Current Pipeline (Warm State)
+
+```text
+MPV subtitle change (0ms)
+  -> IPC to main (5ms)
+  -> Cache check (2ms)
+  -> [CACHE MISS] Yomitan parser (35-180ms)
+  -> Parallel: MeCab enrichment (20-80ms) + Frequency lookup (15-50ms)
+  -> Annotation stage: 4 sequential passes (25-70ms)
+  -> IPC to renderer (10ms)
+  -> DOM render: createElement per token (15-50ms)
+  ─────────────────────────────────
+  Total: ~200-320ms (cache miss)
+  Total: ~72ms (cache hit)
+```
+
+## Target Pipeline
+
+```text
+MPV subtitle change (0ms)
+  -> IPC to main (5ms)
+  -> Cache check (2ms)
+  -> [CACHE HIT via prefetch] (0ms)
+  -> IPC to renderer (10ms)
+  -> DOM render: cloneNode from template (10-30ms)
+  ─────────────────────────────────
+  Total: ~30-50ms (prefetch-warmed, normal playback)
+
+  [CACHE MISS, e.g. immediate seek]
+  -> Yomitan parser (35-180ms)
+  -> Parallel: MeCab enrichment + Frequency lookup
+  -> Annotation stage: 1 batched pass (10-25ms)
+  -> IPC to renderer (10ms)
+  -> DOM render: cloneNode from template (10-30ms)
+  ─────────────────────────────────
+  Total: ~150-260ms (cache miss, still improved)
+```
+
+---
+
+## Optimization 1: Subtitle Prefetching
+
+### Summary
+
+A new `SubtitlePrefetchService` parses external subtitle files and tokenizes upcoming lines in the background before they appear on screen. This converts most cache misses into cache hits during normal playback.
+
+### Scope
+
+External subtitle files only (SRT, VTT, ASS). Embedded subtitle tracks are out of scope since Japanese subtitles are virtually always external files.
+
+### Architecture
+
+#### Subtitle File Parsing
+
+A cue parser extracts both timing and text content from subtitle files for prefetching.
+
+**Parsed cue structure:**
+
+```typescript
+interface SubtitleCue {
+  startTime: number; // seconds
+  endTime: number; // seconds
+  text: string; // plain text, decoded from the source format
+  source?: 'canonical-ass'; // recovered authored text for generated ASS animation
+  animationStartTime?: number; // full generated-frame envelope; entrance/exit frames
+  animationEndTime?: number; //   run past the authored timing, live matching uses this
+}
+```
+
+**Supported formats:**
+
+- SRT/VTT: Regex-based parsing of timing lines + text content between timing blocks.
+- ASS: Parse the `[Events]` section, read the field order from the `Format:` row, and extract timed `Dialogue:` lines. Timed `Comment:` lines are normally ignored, but can supply canonical authored text when they match a nearby generated animation from the same style and actor. Text can itself contain commas.
+
+**ASS decoding.** The parser is where ASS text is decoded, once, via `assToPlainText()` in `src/core/services/ass-text.ts`. That decoder mirrors mpv's `ass_to_plaintext` so a cue read from a file reads identically to the same line arriving live on `sub-text`: `{...}` override blocks are markup, `\pN … \p0` vector drawing runs are dropped rather than shown as text, `\N`/`\n`/`\h` are the only escapes (`\{`, `\}` and `\\` are not), and an unclosed `{` is rendered verbatim. Every layer downstream — renderer, timing tracker, tokenizer, tokenization cache keys — receives plain text and uses `normalizePlainSubtitleText()` for whitespace only, so nothing decodes the same string twice and one authored line always maps to one cache key.
+
+**Duplicate collapsing.** Typeset scripts emit one `Dialogue:` event per animation frame, plus layered copies of the same line. The parser collapses identical text over an identical span unconditionally, and collapses contiguous same-text runs of at least three events when the run looks like an animation. For ASS that means shared style and actor plus authoring evidence: a temporal tag (`\t`, `\move`, `\k`/`\kf`/`\ko`/`\K`, or anything wrapped in `\t(...)`), an animated `Effect` column (`Karaoke`, `Banner`, `Scroll`), or override values that change across the run. Static tags shared by every event (`\pos`, an identical `\clip`) are not evidence. SRT/VTT carry no such metadata, so there collapsing needs at least five contiguous events all under 0.1s — the frame timing left behind by ASS-to-SRT conversion. The parser keeps this authoring metadata (style, actor, layer, `Effect`, parsed override commands, source order) private; `parseSubtitleCues()` returns only `SubtitleCue`.
+
+ASS scripts can also redraw one complete lyric for two or more long color/highlight phases. Those flush-timed phases collapse separately from short animation frames when they share text, style, actor, and layer and carry direct animation evidence, such as temporal tags or changing non-spatial overrides. Spatial command changes do not prove a phase, so separately positioned signs remain distinct.
+
+**Canonical animation recovery.** Some ASS producers keep the readable lyric or sign as a timed `Comment:` and generate hundreds of `Dialogue:` frames containing repeated glyphs or changing clip regions. Others retain the complete line as brief `Dialogue:` events around the generated fragments. A complete event is promoted only when nearby dialogue from the same style and actor forms a proven animation cluster and reconstructs its entire text in source order. The generated frames are then replaced by one cue marked `source: 'canonical-ass'`. This source marker lets the live primary-subtitle path prefer the clean authored text and timing for display, sidebar history, immersion recording, and mining, while unmatched editor notes and alternative translations remain ignored. Secondary selection advances to an entering canonical cue at its generated animation start when the preceding authored cue ends before the new authored span. Unrelated simultaneous cues that continue through the new span remain visible.
+
+**Font texture cleanup.** A clipped repeated-glyph run or frequent changes to secondary alpha marks a texture seed. Clipped runs do not need a font override because some signs build their masks from ordinary `l` glyphs. The parser removes short clipped pieces that share a no-font seed's style and timing, or pieces that share a font seed's style, timing, and font even when the actor changes. It also removes positioned text layers with at least `E0` global alpha when they overlap a seed in the same style. Opaque authored sign text stays publishable when the texture switches fonts or actors around it.
+
+#### Prefetch Service Lifecycle
+
+1. **Activation trigger:** When a subtitle track is activated (or changes), check if it's external via MPV's `track-list` property. If `external === true`, read the file via `external-filename` using the existing `loadSubtitleSourceText` infrastructure.
+2. **Parse phase:** Parse all cues from the file content. Sort by start time. Store as an ordered array.
+3. **Priority window:** Determine the current playback position. Identify the next 10 cues as the priority window.
+4. **Priority tokenization:** Tokenize the priority window cues sequentially, storing results into the `SubtitleProcessingController`'s tokenization cache.
+5. **Background tokenization:** After the priority window is done, tokenize remaining cues working forward from the current position, then wrapping around to cover earlier cues. The prefetcher stops once it has tokenized all cues or the cache is full (whichever comes first) to avoid wasteful eviction churn. For files with more cues than the cache limit, background tokenization focuses on cues ahead of the current position.
+6. **Seek handling:** On seek, re-compute the priority window from the new position. A seek is detected by observing MPV's `time-pos` property and checking if the delta from the last observed position exceeds a threshold (e.g., > 3 seconds forward or any backward jump). The current in-flight tokenization finishes naturally, then the new priority window takes over.
+7. **Teardown:** When the subtitle track changes or playback ends, stop all prefetch work and discard state.
+
+#### Live Priority
+
+The prefetcher and live subtitle handler share the Yomitan parser (single-threaded IPC). Live subtitle requests must always take priority. The prefetcher:
+
+- Checks a `paused` flag before each cue tokenization. The live handler sets `paused = true` on subtitle change and clears it after emission.
+- Yields between each background cue tokenization (via `setTimeout(0)` or equivalent) so the live handler can set the pause flag between cues.
+- When paused, the prefetcher waits (polling the flag on a short interval or awaiting a resume signal) before continuing with the next cue.
+
+#### Cache Integration
+
+The prefetcher calls the same `tokenizeSubtitle` function used by live processing to produce `SubtitleData` results, then stores them into the existing `SubtitleProcessingController` tokenization cache via a new method:
+
+```typescript
+// New methods on SubtitleProcessingController
+preCacheTokenization: (text: string, data: SubtitleData) => void;
+isCacheFull: () => boolean;
+```
+
+`preCacheTokenization` uses the same `setCachedTokenization` logic internally (LRU eviction, Map-based storage). `isCacheFull` returns `true` when the cache has reached its limit, allowing the prefetcher to stop background tokenization and avoid wasteful eviction churn.
+
+#### Cache Invalidation
+
+When the user marks a word as known (or any event triggers `invalidateTokenizationCache()`), all cached results are cleared -- including prefetched ones, since they share the same cache. After invalidation, the prefetcher re-computes the priority window from the current playback position and re-tokenizes those cues to restore warm cache state.
+
+#### Error Handling
+
+If the subtitle file is malformed or partially parseable, the cue parser uses what it can extract. A file that yields zero cues disables prefetching silently (falls back to live-only processing). Encoding errors from `loadSubtitleSourceText` are caught and logged; prefetching is skipped for that track.
+
+#### Integration Points
+
+- **MPV property subscriptions:** Needs `track-list` (to detect external subtitle file path) and `time-pos` (to track playback position for window calculation and seek detection).
+- **File loading:** Uses existing `loadSubtitleSourceText` dependency.
+- **Tokenization:** Calls the same `tokenizeSubtitle` function used by live processing.
+- **Cache:** Writes into `SubtitleProcessingController`'s cache.
+- **Cache invalidation:** Listens for cache invalidation events to re-prefetch the priority window.
+
+### Files Affected
+
+- **New:** `src/core/services/subtitle-prefetch.ts` -- the prefetch service
+- **New:** `src/core/services/subtitle-cue-parser.ts` -- SRT/VTT/ASS cue parser (text + timing)
+- **Modified:** `src/core/services/subtitle-processing-controller.ts` -- expose `preCacheTokenization` method
+- **Modified:** `src/main.ts` -- wire up the prefetch service, listen to track changes
+
+---
+
+## Optimization 2: Batched Annotation Pass
+
+### Summary
+
+Collapse the 4 sequential annotation passes (`applyKnownWordMarking` -> `applyFrequencyMarking` -> `applyJlptMarking` -> `markNPlusOneTargets`) into a single iteration over the token array, followed by N+1 marking.
+
+**Important context:** Frequency rank _values_ (`token.frequencyRank`) are already assigned at the parser level by `applyFrequencyRanks()` in `tokenizer.ts`, before the annotation stage is called. The annotation stage's `applyFrequencyMarking` only performs POS-based _filtering_ -- clearing `frequencyRank` to `undefined` for tokens that should be excluded (particles, noise tokens, etc.) and normalizing valid ranks. This optimization does not change the parser-level frequency rank assignment; it only batches the annotation-level filtering.
+
+### Current Flow (4 passes, 4 array copies)
+
+```text
+tokens (already have frequencyRank values from parser-level applyFrequencyRanks)
+  -> applyKnownWordMarking()   // .map() -> new array
+  -> applyFrequencyMarking()   // .map() -> new array (POS-based filtering only)
+  -> applyJlptMarking()        // .map() -> new array
+  -> markNPlusOneTargets()     // .map() -> new array
+```
+
+### Dependency Analysis
+
+All annotations either depend on MeCab POS data or benefit from running after it:
+
+- **Known word marking:** Needs base tokens (surface/headword). No POS dependency, but no reason to run separately.
+- **Frequency filtering:** Uses `pos1Exclusions` and `pos2Exclusions` to clear frequency ranks on excluded tokens (particles, noise). Depends on MeCab POS data.
+- **JLPT marking:** Uses `shouldIgnoreJlptForMecabPos1` to filter. Depends on MeCab POS data.
+- **N+1 marking:** Uses POS exclusion sets to filter candidates. Depends on known word status + MeCab POS.
+
+Since frequency filtering and JLPT marking both depend on POS data from MeCab enrichment, and MeCab enrichment already happens before the annotation stage, all four can run in a single pass after MeCab completes.
+
+### New Flow (1 pass + N+1)
+
+```typescript
+function annotateTokens(tokens, deps, options): MergedToken[] {
+  const pos1Exclusions = resolvePos1Exclusions(options);
+  const pos2Exclusions = resolvePos2Exclusions(options);
+
+  // Single pass: known word + frequency filtering + JLPT computed together
+  const annotated = tokens.map((token) => {
+    const isKnown = nPlusOneEnabled ? token.isKnown || computeIsKnown(token, deps) : false;
+
+    // Filter frequency rank using POS exclusions (rank values already set at parser level)
+    const frequencyRank = frequencyEnabled
+      ? filterFrequencyRank(token, pos1Exclusions, pos2Exclusions)
+      : undefined;
+
+    const jlptLevel = jlptEnabled ? computeJlptLevel(token, deps.getJlptLevel) : undefined;
+
+    return { ...token, isKnown, frequencyRank, jlptLevel };
+  });
+
+  // N+1 must run after known word status is set for all tokens
+  if (nPlusOneEnabled) {
+    return markNPlusOneTargets(annotated, minSentenceWords, pos1Exclusions, pos2Exclusions);
+  }
+
+  return annotated;
+}
+```
+
+### What Changes
+
+- The individual `applyKnownWordMarking`, `applyFrequencyMarking`, `applyJlptMarking` functions are refactored into per-token computation helpers (pure functions that compute a single field). The frequency helper is named `filterFrequencyRank` to clarify it performs POS-based exclusion, not rank computation.
+- The `annotateTokens` orchestrator runs one `.map()` call that invokes all three helpers per token.
+- `markNPlusOneTargets` remains a separate pass because it needs the full array with `isKnown` set (it examines sentence-level context).
+- The parser-level `applyFrequencyRanks()` call in `tokenizer.ts` is unchanged -- it remains a separate step outside the annotation stage.
+- Net: 4 array copies + 4 iterations become 1 array copy + 1 iteration + N+1 pass.
+
+### Expected Savings
+
+~15-45ms saved (3 fewer array allocations + 3 fewer full iterations). Annotation drops from ~25-70ms to ~10-25ms.
+
+### Files Affected
+
+- **Modified:** `src/core/services/tokenizer/annotation-stage.ts` -- refactor into batched single-pass
+
+---
+
+## Optimization 3: DOM Template Pooling
+
+### Summary
+
+Replace `document.createElement('span')` calls in the renderer with `templateSpan.cloneNode(false)` from a pre-created template element.
+
+### Current Behavior
+
+In `renderWithTokens` (`subtitle-render.ts`), each render cycle:
+
+1. Clears DOM with `innerHTML = ''`
+2. Creates a `DocumentFragment`
+3. Calls `document.createElement('span')` for each token (~10-15 per subtitle)
+4. Sets `className`, `textContent`, `dataset.*` individually
+5. Appends fragment to root
+
+### New Behavior
+
+1. At renderer initialization (`createSubtitleRenderer`), create a single template:
+   ```typescript
+   const templateSpan = document.createElement('span');
+   ```
+2. In `renderWithTokens`, replace every `document.createElement('span')` with:
+   ```typescript
+   const span = templateSpan.cloneNode(false) as HTMLSpanElement;
+   ```
+3. Replace all `innerHTML = ''` calls with `root.replaceChildren()` to avoid the HTML parser invocation on clear. This applies to `renderSubtitle` (primary subtitle root), `renderSecondarySub` (secondary subtitle root), and `renderCharacterLevel` if applicable.
+4. Everything else stays the same (setting className, textContent, dataset, appending to fragment).
+
+### Why cloneNode Over Full Node Recycling
+
+Full recycling (collecting old nodes, clearing attributes, reusing them) requires carefully resetting every `dataset.*` property that might have been set on a previous render. This is error-prone -- a stale `data-frequency-rank` from a previous subtitle appearing on a new token would cause incorrect styling. `cloneNode(false)` on a bare template is nearly as fast and produces a clean node every time.
+
+### Expected Savings
+
+`cloneNode(false)` is ~2-3x faster than `createElement` in most browser engines. For 10-15 tokens per subtitle: ~3-8ms saved per render cycle.
+
+### Files Affected
+
+- **Modified:** `src/renderer/subtitle-render.ts` -- template creation + cloneNode usage
+
+---
+
+## Combined Impact Summary
+
+| Scenario                          | Before     | After      | Improvement |
+| --------------------------------- | ---------- | ---------- | ----------- |
+| Normal playback (prefetch-warmed) | ~200-320ms | ~30-50ms   | ~80-85%     |
+| Cache hit (repeated subtitle)     | ~72ms      | ~55-65ms   | ~10-20%     |
+| Cache miss (immediate seek)       | ~200-320ms | ~150-260ms | ~20-25%     |
+
+---
+
+## Files Summary
+
+### New Files
+
+- `src/core/services/subtitle-prefetch.ts`
+- `src/core/services/subtitle-cue-parser.ts`
+
+### Modified Files
+
+- `src/core/services/subtitle-processing-controller.ts` (expose `preCacheTokenization`)
+- `src/core/services/tokenizer/annotation-stage.ts` (batched single-pass)
+- `src/renderer/subtitle-render.ts` (template cloneNode)
+- `src/main.ts` (wire up prefetch service)
+
+### Test Files
+
+- New tests for subtitle cue parser (SRT, VTT, ASS formats)
+- New tests for subtitle prefetch service (priority window, seek, pause/resume)
+- Updated tests for annotation stage (same behavior, new implementation)
+- Updated tests for subtitle render (template cloning)
@@ -32,7 +32,7 @@ Update checks and startup launcher migration share a serialized update-state sto
 - `src/main/boot/` owns boot-phase assembly seams so `src/main.ts` can stay focused on lifecycle coordination and startup-path selection.
 - `src/main/runtime/linux-overlay-mode-runtime.ts` owns Linux fullscreen mode state and window replacement. App cleanup cancels pending replacements; `main.ts` supplies window creation and subtitle refresh hooks.
 - `src/core/services/` owns focused runtime services plus pure or side-effect-bounded logic.
- `src/core/services/subtitle-generation*.ts` shares local whisper.cpp transcription, safe model downloads, and progress between the launcher and Electron. Optional dialogue mode retains both Silero-detected speech and other audible sections, omits confidently silent gaps, decodes passages independently, and restores original media timing. `src/main/runtime/subtitle-generation-runtime.ts` owns the overlay job lifecycle and only loads completed subtitles into the same media. For Jellyfin playback it reads the item's original-file stream (`toJellyfinOriginalStreamUrl`) into one reused output folder, where each run best-effort deletes earlier files and writes a uniquely named SRT; transcoded playback uses Jellyfin's audio index and only external references, since mpv's track indexes describe the transcode. Subprocess errors redact URL tokens; `src/shared/subtitle-generation*.ts` owns configuration, the multilingual model catalog, and IPC contracts. The overlay runtime retains a session model selection, validates picker requests through IPC, and keeps external model paths authoritative.
+- `src/core/services/subtitle-generation*.ts` shares local whisper.cpp transcription, safe model downloads, and progress between the launcher and Electron. Optional dialogue mode retains both Silero-detected speech and other audible sections, omits confidently silent gaps, decodes passages independently, and restores original media timing. `src/main/runtime/subtitle-generation-runtime.ts` owns the overlay job lifecycle and only loads completed subtitles into the same local media; `src/shared/subtitle-generation*.ts` owns configuration, the multilingual model catalog, and IPC contracts. The overlay runtime retains a session model selection, validates picker requests through IPC, and keeps external model paths authoritative.
 - Subtitle model recommendations use bounded `nvidia-smi` and Whisper CUDA discovery probes in `subtitle-generation-acceleration.ts`. The overlay runtime caches results by executable path for 30 seconds and exposes acceleration status through the existing status IPC. Recommendations do not alter model selection or transcription arguments.
 - `subtitle-generation-reference.ts` ranks mpv's loaded text subtitle tracks, excludes signs/songs and forced references, and extracts timing hints with FFmpeg. The overlay and launcher snapshot references only for matching media, including active subtitle delays. Hints guide long-passage cuts with or without VAD; they never limit audio coverage or replace Whisper timestamps.
 - `src/main/runtime/subtitle-selection.ts` reads and validates mpv subtitle tracks and applies primary/secondary selections. Its opt-in session shortcut opens the shared overlay modal window, with renderer focus and subtitle suppression handled by the modal registry.
@@ -66,7 +66,7 @@ bun run docs:build
  Content checks run inside the electron-builder afterPack hook. See the
  [release guide](../RELEASING.md#package-contents-checks) for the
  installed-app verification checklist.
- Dictionary backend windows: after a full build, run `xvfb-run -a bun run test:dictionary:electron` on headless Linux (CI runs it in the Linux E2E job). It uses temporary profiles to check both named settings commands, backend session isolation, the overlay's external-link bridge, and Hachidori's native dictionary parser.
+- Dictionary backend windows: after a full build, run `xvfb-run -a bun run test:dictionary:electron` on headless Linux. It uses temporary profiles to check both named settings commands, backend session isolation, the overlay's external-link bridge, and Hachidori's native dictionary parser.
 - Coverage for the maintained source lane: `bun run test:coverage:src`
 - Deep/local full gate: default handoff gate above

@@ -6,9 +6,11 @@ import type { LauncherCommandContext } from './context.js';
 import { runConfigCommand } from './config-command.js';
 import { runDictionaryCommand } from './dictionary-command.js';
 import { runDoctorCommand } from './doctor-command.js';
+import { runLogsCommand } from './logs-command.js';
 import { runMpvPostAppCommand, runMpvPreAppCommand } from './mpv-command.js';
 import { runAppPassthroughCommand } from './app-command.js';
 import { runStatsCommand } from './stats-command.js';
+import { runUpdateCommand } from './update-command.js';

 class ExitSignal extends Error {
  code: number;
@@ -65,7 +65,7 @@ export async function runMpvPostAppCommand(
  context: LauncherCommandContext,
  deps: MpvCommandDeps = defaultDeps,
 ): Promise<boolean> {
-  const { args, appPath, mpvSocketPath, pluginRuntimeConfig } = context;
+  const { args, appPath, scriptPath, mpvSocketPath, pluginRuntimeConfig } = context;
  if (!args.mpvIdle) {
    return false;
  }
@@ -17,11 +17,20 @@ test('parseLauncherYoutubeSubgenConfig keeps only valid typed values', () => {
    secondarySub: {
      secondarySubLanguages: ['eng', true, 'deu'],
    },
+    jimaku: {
+      apiKey: 'abc',
+      apiKeyCommand: 'pass show key',
+      apiBaseUrl: 'https://jimaku.cc',
+      languagePreference: 'ja',
+      maxEntryResults: 8.7,
+    },
  });

  assert.equal('mode' in parsed, false);
  assert.deepEqual(parsed.primarySubLanguages, ['ja', 'en']);
  assert.deepEqual(parsed.secondarySubLanguages, ['eng', 'deu']);
+  assert.equal(parsed.jimakuLanguagePreference, 'ja');
+  assert.equal(parsed.jimakuMaxEntryResults, 8);
 });

 test('parseLauncherJellyfinConfig omits legacy token and user id fields', () => {
@@ -10,6 +10,7 @@ import type {
  LogLevel,
 } from '../types.js';
 import {
+  DEFAULT_JIMAKU_API_BASE_URL,
  DEFAULT_YOUTUBE_PRIMARY_SUB_LANGS,
  DEFAULT_YOUTUBE_SECONDARY_SUB_LANGS,
 } from '../types.js';
@@ -124,6 +125,11 @@ export function createDefaultArgs(
    recursive: false,
    profile: mpvConfig.profile ?? '',
    startOverlay: false,
+    jimakuApiKey: process.env.SUBMINER_JIMAKU_API_KEY || '',
+    jimakuApiKeyCommand: process.env.SUBMINER_JIMAKU_API_KEY_COMMAND || '',
+    jimakuApiBaseUrl: process.env.SUBMINER_JIMAKU_API_BASE_URL || DEFAULT_JIMAKU_API_BASE_URL,
+    jimakuLanguagePreference: launcherConfig.jimakuLanguagePreference || 'ja',
+    jimakuMaxEntryResults: launcherConfig.jimakuMaxEntryResults || 10,
    jellyfin: false,
    jellyfinLogin: false,
    jellyfinLogout: false,
@@ -178,6 +184,15 @@ export function createDefaultArgs(
    targetKind: '',
  };

+  if (launcherConfig.jimakuApiKey) parsed.jimakuApiKey = launcherConfig.jimakuApiKey;
+  if (launcherConfig.jimakuApiKeyCommand)
+    parsed.jimakuApiKeyCommand = launcherConfig.jimakuApiKeyCommand;
+  if (launcherConfig.jimakuApiBaseUrl) parsed.jimakuApiBaseUrl = launcherConfig.jimakuApiBaseUrl;
+  if (launcherConfig.jimakuLanguagePreference)
+    parsed.jimakuLanguagePreference = launcherConfig.jimakuLanguagePreference;
+  if (launcherConfig.jimakuMaxEntryResults !== undefined)
+    parsed.jimakuMaxEntryResults = launcherConfig.jimakuMaxEntryResults;
+
  return parsed;
 }

@@ -16,9 +16,31 @@ export function parseLauncherYoutubeSubgenConfig(
    secondarySubRaw && typeof secondarySubRaw === 'object'
      ? (secondarySubRaw as Record<string, unknown>)
      : null;
+  const jimakuRaw = root.jimaku;
+  const jimaku =
+    jimakuRaw && typeof jimakuRaw === 'object' ? (jimakuRaw as Record<string, unknown>) : null;
+
+  const jimakuLanguagePreference = jimaku?.languagePreference;
+  const jimakuMaxEntryResults = jimaku?.maxEntryResults;

  return {
    primarySubLanguages: asStringArray(youtube?.primarySubLanguages),
    secondarySubLanguages: asStringArray(secondarySub?.secondarySubLanguages),
+    jimakuApiKey: typeof jimaku?.apiKey === 'string' ? jimaku.apiKey : undefined,
+    jimakuApiKeyCommand:
+      typeof jimaku?.apiKeyCommand === 'string' ? jimaku.apiKeyCommand : undefined,
+    jimakuApiBaseUrl: typeof jimaku?.apiBaseUrl === 'string' ? jimaku.apiBaseUrl : undefined,
+    jimakuLanguagePreference:
+      jimakuLanguagePreference === 'ja' ||
+      jimakuLanguagePreference === 'en' ||
+      jimakuLanguagePreference === 'none'
+        ? jimakuLanguagePreference
+        : undefined,
+    jimakuMaxEntryResults:
+      typeof jimakuMaxEntryResults === 'number' &&
+      Number.isFinite(jimakuMaxEntryResults) &&
+      jimakuMaxEntryResults > 0
+        ? Math.floor(jimakuMaxEntryResults)
+        : undefined,
  };
 }
@@ -0,0 +1,518 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import http from 'node:http';
+import https from 'node:https';
+import { spawnSync } from 'node:child_process';
+import type { Args, JimakuLanguagePreference } from './types.js';
+import { DEFAULT_JIMAKU_API_BASE_URL } from './types.js';
+import { commandExists } from './util.js';
+
+export interface JimakuEntry {
+  id: number;
+  name: string;
+  english_name?: string | null;
+  japanese_name?: string | null;
+  flags?: {
+    anime?: boolean;
+    movie?: boolean;
+    adult?: boolean;
+    external?: boolean;
+    unverified?: boolean;
+  };
+}
+
+interface JimakuFileEntry {
+  name: string;
+  url: string;
+  size: number;
+  last_modified: string;
+}
+
+interface JimakuApiError {
+  error: string;
+  code?: number;
+  retryAfter?: number;
+}
+
+type JimakuApiResponse<T> = { ok: true; data: T } | { ok: false; error: JimakuApiError };
+
+type JimakuDownloadResult = { ok: true; path: string } | { ok: false; error: JimakuApiError };
+
+interface JimakuConfig {
+  apiKey: string;
+  apiKeyCommand: string;
+  apiBaseUrl: string;
+  languagePreference: JimakuLanguagePreference;
+  maxEntryResults: number;
+}
+
+interface JimakuMediaInfo {
+  title: string;
+  season: number | null;
+  episode: number | null;
+  confidence: 'high' | 'medium' | 'low';
+  filename: string;
+  rawTitle: string;
+}
+
+function getRetryAfter(headers: http.IncomingHttpHeaders): number | undefined {
+  const value = headers['x-ratelimit-reset-after'];
+  if (!value) return undefined;
+  const raw = Array.isArray(value) ? value[0] : value;
+  if (!raw) return undefined;
+  const parsed = Number.parseFloat(raw);
+  if (!Number.isFinite(parsed)) return undefined;
+  return parsed;
+}
+
+export function matchEpisodeFromName(name: string): {
+  season: number | null;
+  episode: number | null;
+  index: number | null;
+  confidence: 'high' | 'medium' | 'low';
+} {
+  const seasonEpisode = name.match(/S(\d{1,2})E(\d{1,3})/i);
+  if (seasonEpisode && seasonEpisode.index !== undefined) {
+    const seasonText = seasonEpisode[1];
+    const episodeText = seasonEpisode[2];
+    if (!seasonText || !episodeText) {
+      return { season: null, episode: null, index: null, confidence: 'low' };
+    }
+    return {
+      season: Number.parseInt(seasonText, 10),
+      episode: Number.parseInt(episodeText, 10),
+      index: seasonEpisode.index,
+      confidence: 'high',
+    };
+  }
+
+  const alt = name.match(/(\d{1,2})x(\d{1,3})/i);
+  if (alt && alt.index !== undefined) {
+    const seasonText = alt[1];
+    const episodeText = alt[2];
+    if (!seasonText || !episodeText) {
+      return { season: null, episode: null, index: null, confidence: 'low' };
+    }
+    return {
+      season: Number.parseInt(seasonText, 10),
+      episode: Number.parseInt(episodeText, 10),
+      index: alt.index,
+      confidence: 'high',
+    };
+  }
+
+  const epOnly = name.match(/(?:^|[\s._-])E(?:P)?(\d{1,3})(?:\b|[\s._-])/i);
+  if (epOnly && epOnly.index !== undefined) {
+    const episodeText = epOnly[1];
+    if (!episodeText) {
+      return { season: null, episode: null, index: null, confidence: 'low' };
+    }
+    return {
+      season: null,
+      episode: Number.parseInt(episodeText, 10),
+      index: epOnly.index,
+      confidence: 'medium',
+    };
+  }
+
+  const numeric = name.match(/(?:^|[-–—]\s*)(\d{1,3})\s*[-–—]/);
+  if (numeric && numeric.index !== undefined) {
+    const episodeText = numeric[1];
+    if (!episodeText) {
+      return { season: null, episode: null, index: null, confidence: 'low' };
+    }
+    return {
+      season: null,
+      episode: Number.parseInt(episodeText, 10),
+      index: numeric.index,
+      confidence: 'medium',
+    };
+  }
+
+  return { season: null, episode: null, index: null, confidence: 'low' };
+}
+
+function detectSeasonFromDir(mediaPath: string): number | null {
+  const parent = path.basename(path.dirname(mediaPath));
+  const match = parent.match(/(?:Season|S)\s*(\d{1,2})/i);
+  if (!match) return null;
+  const seasonText = match[1];
+  if (!seasonText) return null;
+  const parsed = Number.parseInt(seasonText, 10);
+  return Number.isFinite(parsed) ? parsed : null;
+}
+
+function parseGuessitOutput(mediaPath: string, stdout: string): JimakuMediaInfo | null {
+  const payload = stdout.trim();
+  if (!payload) return null;
+
+  try {
+    const parsed = JSON.parse(payload) as {
+      title?: string;
+      title_original?: string;
+      series?: string;
+      season?: number | string;
+      episode?: number | string;
+      episode_list?: Array<number | string>;
+    };
+    const season =
+      typeof parsed.season === 'number'
+        ? parsed.season
+        : typeof parsed.season === 'string'
+          ? Number.parseInt(parsed.season, 10)
+          : null;
+    const directEpisode =
+      typeof parsed.episode === 'number'
+        ? parsed.episode
+        : typeof parsed.episode === 'string'
+          ? Number.parseInt(parsed.episode, 10)
+          : null;
+    const episodeFromList =
+      parsed.episode_list && parsed.episode_list.length > 0
+        ? Number.parseInt(String(parsed.episode_list[0]), 10)
+        : null;
+    const episodeValue =
+      directEpisode !== null && Number.isFinite(directEpisode) ? directEpisode : episodeFromList;
+    const episode = Number.isFinite(episodeValue as number) ? (episodeValue as number) : null;
+    const title = (parsed.title || parsed.title_original || parsed.series || '').trim();
+    const hasStructuredData =
+      title.length > 0 ||
+      Number.isFinite(season as number) ||
+      Number.isFinite(episodeValue as number);
+
+    if (!hasStructuredData) return null;
+
+    return {
+      title: title || '',
+      season: Number.isFinite(season as number) ? season : detectSeasonFromDir(mediaPath),
+      episode: episode,
+      confidence: 'high',
+      filename: path.basename(mediaPath),
+      rawTitle: path.basename(mediaPath).replace(/\.[^/.]+$/, ''),
+    };
+  } catch {
+    return null;
+  }
+}
+
+function parseMediaInfoWithGuessit(mediaPath: string): JimakuMediaInfo | null {
+  if (!commandExists('guessit')) return null;
+
+  try {
+    const fileName = path.basename(mediaPath);
+    const result = spawnSync('guessit', ['--json', fileName], {
+      cwd: path.dirname(mediaPath),
+      encoding: 'utf8',
+      maxBuffer: 2_000_000,
+      windowsHide: true,
+    });
+    if (result.error || result.status !== 0) return null;
+    return parseGuessitOutput(mediaPath, result.stdout || '');
+  } catch {
+    return null;
+  }
+}
+
+function cleanupTitle(value: string): string {
+  return value
+    .replace(/^[\s-–—]+/, '')
+    .replace(/[\s-–—]+$/, '')
+    .replace(/\s+/g, ' ')
+    .trim();
+}
+
+function formatLangScore(name: string, pref: JimakuLanguagePreference): number {
+  if (pref === 'none') return 0;
+  const upper = name.toUpperCase();
+  const hasJa =
+    /(^|[\W_])JA([\W_]|$)/.test(upper) ||
+    /(^|[\W_])JPN([\W_]|$)/.test(upper) ||
+    upper.includes('.JA.');
+  const hasEn =
+    /(^|[\W_])EN([\W_]|$)/.test(upper) ||
+    /(^|[\W_])ENG([\W_]|$)/.test(upper) ||
+    upper.includes('.EN.');
+  if (pref === 'ja') {
+    if (hasJa) return 2;
+    if (hasEn) return 1;
+  } else if (pref === 'en') {
+    if (hasEn) return 2;
+    if (hasJa) return 1;
+  }
+  return 0;
+}
+
+export async function resolveJimakuApiKey(config: JimakuConfig): Promise<string | null> {
+  if (config.apiKey && config.apiKey.trim()) {
+    return config.apiKey.trim();
+  }
+  if (config.apiKeyCommand && config.apiKeyCommand.trim()) {
+    try {
+      const commandResult = spawnSync(config.apiKeyCommand, {
+        shell: true,
+        encoding: 'utf8',
+        timeout: 10000,
+      });
+      if (commandResult.error) return null;
+      const key = (commandResult.stdout || '').trim();
+      return key.length > 0 ? key : null;
+    } catch {
+      return null;
+    }
+  }
+  return null;
+}
+
+export function jimakuFetchJson<T>(
+  endpoint: string,
+  query: Record<string, string | number | boolean | null | undefined>,
+  options: { baseUrl: string; apiKey: string },
+): Promise<JimakuApiResponse<T>> {
+  const url = new URL(endpoint, options.baseUrl);
+  for (const [key, value] of Object.entries(query)) {
+    if (value === null || value === undefined) continue;
+    url.searchParams.set(key, String(value));
+  }
+
+  return new Promise((resolve) => {
+    const requestUrl = new URL(url.toString());
+    const transport = requestUrl.protocol === 'https:' ? https : http;
+    const req = transport.request(
+      requestUrl,
+      {
+        method: 'GET',
+        headers: {
+          Authorization: options.apiKey,
+          'User-Agent': 'SubMiner',
+        },
+      },
+      (res) => {
+        let data = '';
+        res.on('data', (chunk) => {
+          data += chunk.toString();
+        });
+        res.on('end', () => {
+          const status = res.statusCode || 0;
+          if (status >= 200 && status < 300) {
+            try {
+              const parsed = JSON.parse(data) as T;
+              resolve({ ok: true, data: parsed });
+            } catch {
+              resolve({
+                ok: false,
+                error: { error: 'Failed to parse Jimaku response JSON.' },
+              });
+            }
+            return;
+          }
+
+          let errorMessage = `Jimaku API error (HTTP ${status})`;
+          try {
+            const parsed = JSON.parse(data) as { error?: string };
+            if (parsed && parsed.error) {
+              errorMessage = parsed.error;
+            }
+          } catch {
+            // ignore parse errors
+          }
+
+          resolve({
+            ok: false,
+            error: {
+              error: errorMessage,
+              code: status || undefined,
+              retryAfter: status === 429 ? getRetryAfter(res.headers) : undefined,
+            },
+          });
+        });
+      },
+    );
+
+    req.on('error', (error) => {
+      resolve({
+        ok: false,
+        error: { error: `Jimaku request failed: ${(error as Error).message}` },
+      });
+    });
+
+    req.end();
+  });
+}
+
+export function parseMediaInfo(mediaPath: string | null): JimakuMediaInfo {
+  if (!mediaPath) {
+    return {
+      title: '',
+      season: null,
+      episode: null,
+      confidence: 'low',
+      filename: '',
+      rawTitle: '',
+    };
+  }
+
+  const guessitInfo = parseMediaInfoWithGuessit(mediaPath);
+  if (guessitInfo) return guessitInfo;
+
+  const filename = path.basename(mediaPath);
+  let name = filename.replace(/\.[^/.]+$/, '');
+  name = name.replace(/\[[^\]]*]/g, ' ');
+  name = name.replace(/\(\d{4}\)/g, ' ');
+  name = name.replace(/[._]/g, ' ');
+  name = name.replace(/[–—]/g, '-');
+  name = name.replace(/\s+/g, ' ').trim();
+
+  const parsed = matchEpisodeFromName(name);
+  let titlePart = name;
+  if (parsed.index !== null) {
+    titlePart = name.slice(0, parsed.index);
+  }
+
+  const seasonFromDir = parsed.season ?? detectSeasonFromDir(mediaPath);
+  const title = cleanupTitle(titlePart || name);
+
+  return {
+    title,
+    season: seasonFromDir,
+    episode: parsed.episode,
+    confidence: parsed.confidence,
+    filename,
+    rawTitle: name,
+  };
+}
+
+export function sortJimakuFiles(
+  files: JimakuFileEntry[],
+  pref: JimakuLanguagePreference,
+): JimakuFileEntry[] {
+  if (pref === 'none') return files;
+  return [...files].sort((a, b) => {
+    const scoreDiff = formatLangScore(b.name, pref) - formatLangScore(a.name, pref);
+    if (scoreDiff !== 0) return scoreDiff;
+    return a.name.localeCompare(b.name);
+  });
+}
+
+export async function downloadToFile(
+  url: string,
+  destPath: string,
+  headers: Record<string, string>,
+  redirectCount = 0,
+): Promise<JimakuDownloadResult> {
+  if (redirectCount > 3) {
+    return {
+      ok: false,
+      error: { error: 'Too many redirects while downloading subtitle.' },
+    };
+  }
+
+  return new Promise((resolve) => {
+    const parsedUrl = new URL(url);
+    const transport = parsedUrl.protocol === 'https:' ? https : http;
+
+    const req = transport.get(parsedUrl, { headers }, (res) => {
+      const status = res.statusCode || 0;
+      if ([301, 302, 303, 307, 308].includes(status) && res.headers.location) {
+        const redirectUrl = new URL(res.headers.location, parsedUrl).toString();
+        res.resume();
+        downloadToFile(redirectUrl, destPath, headers, redirectCount + 1).then(resolve);
+        return;
+      }
+
+      if (status < 200 || status >= 300) {
+        res.resume();
+        resolve({
+          ok: false,
+          error: {
+            error: `Failed to download subtitle (HTTP ${status}).`,
+            code: status,
+          },
+        });
+        return;
+      }
+
+      const fileStream = fs.createWriteStream(destPath);
+      res.pipe(fileStream);
+      fileStream.on('finish', () => {
+        fileStream.close(() => {
+          resolve({ ok: true, path: destPath });
+        });
+      });
+      fileStream.on('error', (err: Error) => {
+        resolve({
+          ok: false,
+          error: { error: `Failed to save subtitle: ${err.message}` },
+        });
+      });
+    });
+
+    req.on('error', (err) => {
+      resolve({
+        ok: false,
+        error: {
+          error: `Download request failed: ${(err as Error).message}`,
+        },
+      });
+    });
+  });
+}
+
+export function isValidSubtitleCandidateFile(filename: string): boolean {
+  const ext = path.extname(filename).toLowerCase();
+  return ext === '.srt' || ext === '.vtt' || ext === '.ass' || ext === '.ssa' || ext === '.sub';
+}
+
+export function mapPreferenceToLanguages(preference: JimakuLanguagePreference): string[] {
+  if (preference === 'en') return ['en', 'eng'];
+  if (preference === 'none') return [];
+  return ['ja', 'jpn'];
+}
+
+export function normalizeJimakuSearchInput(mediaPath: string): string {
+  const trimmed = (mediaPath || '').trim();
+  if (!trimmed) return '';
+  if (!/^https?:\/\/.*/.test(trimmed)) return trimmed;
+
+  try {
+    const url = new URL(trimmed);
+    const titleParam =
+      url.searchParams.get('title') || url.searchParams.get('name') || url.searchParams.get('q');
+    if (titleParam && titleParam.trim()) return titleParam.trim();
+
+    const pathParts = url.pathname.split('/').filter(Boolean).reverse();
+    const candidate = pathParts.find((part) => {
+      const decoded = decodeURIComponent(part || '').replace(/\.[^/.]+$/, '');
+      const lowered = decoded.toLowerCase();
+      return lowered.length > 2 && !/^[0-9.]+$/.test(lowered) && !/^[a-f0-9]{16,}$/i.test(lowered);
+    });
+
+    const fallback = candidate || url.hostname.replace(/^www\./, '');
+    return sanitizeJimakuQueryInput(decodeURIComponent(fallback));
+  } catch {
+    return trimmed;
+  }
+}
+
+export function sanitizeJimakuQueryInput(value: string): string {
+  return value
+    .replace(/^\s*-\s*/, '')
+    .replace(/[^\w\s\-'".:(),]/g, ' ')
+    .replace(/\s+/g, ' ')
+    .trim();
+}
+
+export function buildJimakuConfig(args: Args): {
+  apiKey: string;
+  apiKeyCommand: string;
+  apiBaseUrl: string;
+  languagePreference: JimakuLanguagePreference;
+  maxEntryResults: number;
+} {
+  return {
+    apiKey: args.jimakuApiKey,
+    apiKeyCommand: args.jimakuApiKeyCommand,
+    apiBaseUrl: args.jimakuApiBaseUrl || DEFAULT_JIMAKU_API_BASE_URL,
+    languagePreference: args.jimakuLanguagePreference,
+    maxEntryResults: args.jimakuMaxEntryResults || 10,
+  };
+}
@@ -543,6 +543,7 @@ test(
        const appStartEntries = readJsonLines(appStartPath);
        const appStopEntries = readJsonLines(appStopPath);
        const controlEntries = readJsonLines(controlServer.logPath);
+        const mpvEntries = readJsonLines(path.join(smokeCase.artifactsDir, 'fake-mpv.log'));

        assert.equal(result.status, 0);
        if (process.platform === 'linux') {
@@ -52,6 +52,7 @@ export function getDefaultMpvLogFile(options?: {

 export const DEFAULT_MPV_LOG_FILE = getDefaultMpvLogFile();
 export const DEFAULT_YOUTUBE_YTDL_FORMAT = 'bestvideo*+bestaudio/best';
+export const DEFAULT_JIMAKU_API_BASE_URL = 'https://jimaku.cc';
 export const DEFAULT_MPV_SUBMINER_ARGS = [
  '--sub-auto=fuzzy',
  '--sub-file-paths=.;subs;subtitles',
@@ -68,6 +69,7 @@ export function shouldForwardLogLevel(level: LogLevel): boolean {
  return level === 'debug' || level === 'error';
 }
 export type Backend = 'auto' | 'hyprland' | 'sway' | 'x11' | 'macos' | 'windows';
+export type JimakuLanguagePreference = 'ja' | 'en' | 'none';

 export interface Args {
  generateSubtitles?: {
@@ -101,6 +103,11 @@ export interface Args {
  passwordStore: string;
  target: string;
  targetKind: '' | 'file' | 'url';
+  jimakuApiKey: string;
+  jimakuApiKeyCommand: string;
+  jimakuApiBaseUrl: string;
+  jimakuLanguagePreference: JimakuLanguagePreference;
+  jimakuMaxEntryResults: number;
  jellyfin: boolean;
  jellyfinLogin: boolean;
  jellyfinLogout: boolean;
@@ -144,6 +151,11 @@ export interface Args {
 export interface LauncherYoutubeSubgenConfig {
  primarySubLanguages?: string[];
  secondarySubLanguages?: string[];
+  jimakuApiKey?: string;
+  jimakuApiKeyCommand?: string;
+  jimakuApiBaseUrl?: string;
+  jimakuLanguagePreference?: JimakuLanguagePreference;
+  jimakuMaxEntryResults?: number;
 }

 export interface LauncherJellyfinConfig {
@@ -2,7 +2,7 @@
  "name": "subminer",
  "productName": "SubMiner",
  "desktopName": "SubMiner.desktop",
-  "version": "0.21.0",
+  "version": "0.20.1",
  "description": "All-in-one sentence mining overlay with AnkiConnect and dictionary integration",
  "packageManager": "bun@1.3.5",
  "main": "dist/main-entry.js",
@@ -93,7 +93,6 @@
    "brace-expansion": "5.0.11",
    "electron-builder-squirrel-windows": "26.16.1",
    "fast-uri": "3.1.7",
-    "follow-redirects": "1.16.1",
    "form-data": "4.0.6",
    "ip-address": "10.2.0",
    "js-yaml": "4.3.2",
@@ -102,7 +101,7 @@
    "picomatch": "4.0.4",
    "tar": "7.5.21",
    "tmp": "0.2.7",
-    "undici": "7.30.1"
+    "undici": "7.29.1"
  },
  "keywords": [
    "anki",
@@ -117,6 +116,8 @@
  "author": "",
  "license": "GPL-3.0-or-later",
  "dependencies": {
+    "@fontsource-variable/geist": "^5.2.8",
+    "@fontsource-variable/geist-mono": "^5.2.7",
    "@xhayper/discord-rpc": "^1.3.4",
    "axios": "^1.20.0",
    "commander": "^14.0.3",
@@ -131,12 +132,13 @@
    "@electron/asar": "3.4.1",
    "@types/node": "^24.10.0",
    "@types/ws": "^8.18.1",
-    "electron": "43.8.3",
+    "electron": "43.7.7",
    "electron-builder": "26.16.1",
    "esbuild": "^0.25.12",
+    "eslint": "^10.8.0",
    "prettier": "^3.8.1",
    "typescript": "^5.9.3",
-    "undici": "7.30.1"
+    "undici": "7.29.1"
  },
  "build": {
    "appId": "com.sudacode.SubMiner",
@@ -56,6 +56,9 @@ function M.init()
 	ctx.binary = make_lazy_proxy("binary", function()
 		return require("binary").create(ctx)
 	end)
+	ctx.hover = make_lazy_proxy("hover", function()
+		return require("hover").create(ctx)
+	end)
 	ctx.process = make_lazy_proxy("process", function()
 		return require("process").create(ctx)
 	end)
@@ -0,0 +1,430 @@
+local M = {}
+
+local DEFAULT_HOVER_BASE_COLOR = "FFFFFF"
+local DEFAULT_HOVER_COLOR = "C6A0F6"
+
+function M.create(ctx)
+	local mp = ctx.mp
+	local msg = ctx.msg
+	local utils = ctx.utils
+	local state = ctx.state
+
+	local function to_hex_color(input)
+		if type(input) ~= "string" then
+			return nil
+		end
+
+		local hex = input:gsub("[%#%']", ""):gsub("^0x", "")
+		if #hex ~= 6 and #hex ~= 3 then
+			return nil
+		end
+		if #hex == 3 then
+			return hex:sub(1, 1) .. hex:sub(1, 1) .. hex:sub(2, 2) .. hex:sub(2, 2) .. hex:sub(3, 3) .. hex:sub(3, 3)
+		end
+		return hex
+	end
+
+	local function fix_ass_color(input, fallback)
+		local hex = to_hex_color(input)
+		if not hex then
+			return fallback or DEFAULT_HOVER_BASE_COLOR
+		end
+		local r, g, b = hex:sub(1, 2), hex:sub(3, 4), hex:sub(5, 6)
+		return b .. g .. r
+	end
+
+	local function sanitize_hover_ass_color(input, fallback_rgb)
+		local fallback = fix_ass_color(fallback_rgb or DEFAULT_HOVER_COLOR, DEFAULT_HOVER_COLOR)
+		local converted = fix_ass_color(input, fallback)
+		if converted == "000000" then
+			return fallback
+		end
+		return converted
+	end
+
+	local function escape_ass_text(text)
+		return (text or ""):gsub("\\", "\\\\"):gsub("{", "\\{"):gsub("}", "\\}"):gsub("\n", "\\N")
+	end
+
+	local function resolve_osd_dimensions()
+		local width = mp.get_property_number("osd-width", 0) or 0
+		local height = mp.get_property_number("osd-height", 0) or 0
+
+		if width <= 0 or height <= 0 then
+			local osd_dims = mp.get_property_native("osd-dimensions")
+			if type(osd_dims) == "table" and type(osd_dims.w) == "number" and osd_dims.w > 0 then
+				width = osd_dims.w
+			end
+			if type(osd_dims) == "table" and type(osd_dims.h) == "number" and osd_dims.h > 0 then
+				height = osd_dims.h
+			end
+		end
+
+		if width <= 0 then
+			width = 1280
+		end
+		if height <= 0 then
+			height = 720
+		end
+
+		return width, height
+	end
+
+	local function resolve_metrics()
+		local sub_font_size = mp.get_property_number("sub-font-size", 36) or 36
+		local sub_scale = mp.get_property_number("sub-scale", 1) or 1
+		local sub_scale_by_window = mp.get_property_bool("sub-scale-by-window", true) == true
+		local sub_pos = mp.get_property_number("sub-pos", 100) or 100
+		local sub_margin_y = mp.get_property_number("sub-margin-y", 0) or 0
+		local sub_font = mp.get_property("sub-font", "sans-serif") or "sans-serif"
+		local sub_spacing = mp.get_property_number("sub-spacing", 0) or 0
+		local sub_bold = mp.get_property_bool("sub-bold", false) == true
+		local sub_italic = mp.get_property_bool("sub-italic", false) == true
+		local sub_border_size = mp.get_property_number("sub-border-size", 2) or 2
+		local sub_shadow_offset = mp.get_property_number("sub-shadow-offset", 0) or 0
+		local osd_w, osd_h = resolve_osd_dimensions()
+		local window_scale = 1
+		if sub_scale_by_window and osd_h > 0 then
+			window_scale = osd_h / 720
+		end
+		local effective_margin_y = sub_margin_y * window_scale
+
+		return {
+			font_size = sub_font_size * (sub_scale > 0 and sub_scale or 1) * window_scale,
+			pos = sub_pos,
+			margin_y = effective_margin_y,
+			font = sub_font,
+			spacing = sub_spacing,
+			bold = sub_bold,
+			italic = sub_italic,
+			border = sub_border_size * window_scale,
+			shadow = sub_shadow_offset * window_scale,
+			base_color = fix_ass_color(mp.get_property("sub-color"), DEFAULT_HOVER_BASE_COLOR),
+			hover_color = sanitize_hover_ass_color(nil, DEFAULT_HOVER_COLOR),
+		}
+	end
+
+	local function get_subtitle_ass_property()
+		local ass_text = mp.get_property("sub-text/ass")
+		if ass_text ~= nil then
+			if type(ass_text) == "string" and ass_text ~= "" then
+				return ass_text
+			end
+			return nil
+		end
+		ass_text = mp.get_property("sub-text-ass")
+		if type(ass_text) == "string" and ass_text ~= "" then
+			return ass_text
+		end
+		return nil
+	end
+
+	local function plain_text_and_ass_map(text)
+		local plain = {}
+		local map = {}
+		local plain_len = 0
+		local i = 1
+		local text_len = #text
+
+		while i <= text_len do
+			local ch = text:sub(i, i)
+			if ch == "{" then
+				local close = text:find("}", i + 1, true)
+				if not close then
+					break
+				end
+				i = close + 1
+			elseif ch == "\\" then
+				local esc = text:sub(i + 1, i + 1)
+				if esc == "N" or esc == "n" then
+					plain_len = plain_len + 1
+					plain[plain_len] = "\n"
+					map[plain_len] = i
+					i = i + 2
+				elseif esc == "h" then
+					plain_len = plain_len + 1
+					plain[plain_len] = " "
+					map[plain_len] = i
+					i = i + 2
+				elseif esc == "{" then
+					plain_len = plain_len + 1
+					plain[plain_len] = "{"
+					map[plain_len] = i
+					i = i + 2
+				elseif esc == "}" then
+					plain_len = plain_len + 1
+					plain[plain_len] = "}"
+					map[plain_len] = i
+					i = i + 2
+				elseif esc == "\\" then
+					plain_len = plain_len + 1
+					plain[plain_len] = "\\"
+					map[plain_len] = i
+					i = i + 2
+				else
+					local seq_end = i + 1
+					while seq_end <= text_len and text:sub(seq_end, seq_end):match("[%a]") do
+						seq_end = seq_end + 1
+					end
+					if text:sub(seq_end, seq_end) == "(" then
+						local close = text:find(")", seq_end, true)
+						if close then
+							i = close + 1
+						else
+							i = seq_end + 1
+						end
+					else
+						i = seq_end + 1
+					end
+				end
+			else
+				plain_len = plain_len + 1
+				plain[plain_len] = ch
+				map[plain_len] = i
+				i = i + 1
+			end
+		end
+
+		return table.concat(plain), map
+	end
+
+	local function find_hover_span(payload, plain)
+		local source_len = #plain
+		local cursor = 1
+		for _, token in ipairs(payload.tokens or {}) do
+			if type(token) == "table" and type(token.text) == "string" and token.text ~= "" then
+				local token_text = token.text
+				local start_pos = nil
+				local end_pos = nil
+
+				if type(token.startPos) == "number" and type(token.endPos) == "number" then
+					if token.startPos >= 0 and token.endPos >= token.startPos then
+						local candidate_start = token.startPos + 1
+						local candidate_stop = token.endPos
+						if candidate_start >= 1 and candidate_stop <= source_len and candidate_stop >= candidate_start and plain:sub(candidate_start, candidate_stop) == token_text then
+							start_pos = candidate_start
+							end_pos = candidate_stop
+						end
+					end
+				end
+
+				if not start_pos or not end_pos then
+					local fallback_start, fallback_stop = plain:find(token_text, cursor, true)
+					if not fallback_start then
+						fallback_start, fallback_stop = plain:find(token_text, 1, true)
+					end
+					start_pos, end_pos = fallback_start, fallback_stop
+				end
+
+				if start_pos and end_pos then
+					if token.index == payload.hoveredTokenIndex then
+						return start_pos, end_pos
+					end
+					cursor = end_pos + 1
+				end
+			end
+		end
+
+		return nil
+	end
+
+	local function inject_hover_color_to_ass(raw_ass, plain_map, hover_start, hover_end, hover_color, base_color)
+		if hover_start == nil or hover_end == nil then
+			return raw_ass
+		end
+
+		local raw_open_idx = plain_map[hover_start] or 1
+		local raw_close_idx = plain_map[hover_end + 1] or (#raw_ass + 1)
+		if raw_open_idx < 1 then
+			raw_open_idx = 1
+		end
+		if raw_close_idx < 1 then
+			raw_close_idx = 1
+		end
+		if raw_open_idx > #raw_ass + 1 then
+			raw_open_idx = #raw_ass + 1
+		end
+		if raw_close_idx > #raw_ass + 1 then
+			raw_close_idx = #raw_ass + 1
+		end
+
+		local before = raw_ass:sub(1, raw_open_idx - 1)
+		local hovered = raw_ass:sub(raw_open_idx, raw_close_idx - 1)
+		local after = raw_ass:sub(raw_close_idx)
+		local hover_suffix = string.format("\\1c&H%s&", hover_color)
+
+		-- Keep hover foreground stable even when inline ASS override tags (\1c/\c/\r) appear inside token.
+		hovered = hovered:gsub("{([^}]*)}", function(inner)
+			if inner:find("\\1c&H", 1, true) or inner:find("\\c&H", 1, true) or inner:find("\\r", 1, true) then
+				return "{" .. inner .. hover_suffix .. "}"
+			end
+			return "{" .. inner .. "}"
+		end)
+
+		local open_tag = string.format("{\\1c&H%s&}", hover_color)
+		local close_tag = string.format("{\\1c&H%s&}", base_color)
+		return before .. open_tag .. hovered .. close_tag .. after
+	end
+
+	local function build_hover_subtitle_content(payload)
+		local source_ass = get_subtitle_ass_property()
+		if type(source_ass) == "string" and source_ass ~= "" then
+			state.hover_highlight.cached_ass = source_ass
+		else
+			source_ass = state.hover_highlight.cached_ass
+		end
+		if type(source_ass) ~= "string" or source_ass == "" then
+			return nil
+		end
+
+		local plain_source, plain_map = plain_text_and_ass_map(source_ass)
+		if type(plain_source) ~= "string" or plain_source == "" then
+			return nil
+		end
+
+		local hover_start, hover_end = find_hover_span(payload, plain_source)
+		if not hover_start or not hover_end then
+			return nil
+		end
+
+		local metrics = resolve_metrics()
+		local hover_color = sanitize_hover_ass_color(payload.colors and payload.colors.hover or nil, DEFAULT_HOVER_COLOR)
+		local base_color = fix_ass_color(payload.colors and payload.colors.base or nil, metrics.base_color)
+		return inject_hover_color_to_ass(source_ass, plain_map, hover_start, hover_end, hover_color, base_color)
+	end
+
+	local function clear_hover_overlay()
+		if state.hover_highlight.clear_timer then
+			state.hover_highlight.clear_timer:kill()
+			state.hover_highlight.clear_timer = nil
+		end
+		if state.hover_highlight.overlay_active then
+			if type(state.hover_highlight.saved_sub_visibility) == "string" then
+				mp.set_property("sub-visibility", state.hover_highlight.saved_sub_visibility)
+			else
+				mp.set_property("sub-visibility", "yes")
+			end
+			if type(state.hover_highlight.saved_secondary_sub_visibility) == "string" then
+				mp.set_property("secondary-sub-visibility", state.hover_highlight.saved_secondary_sub_visibility)
+			end
+			state.hover_highlight.saved_sub_visibility = nil
+			state.hover_highlight.saved_secondary_sub_visibility = nil
+			state.hover_highlight.overlay_active = false
+		end
+		mp.set_osd_ass(0, 0, "")
+		state.hover_highlight.payload = nil
+		state.hover_highlight.revision = -1
+		state.hover_highlight.cached_ass = nil
+		state.hover_highlight.last_hover_update_ts = 0
+	end
+
+	local function schedule_hover_clear(delay_seconds)
+		if state.hover_highlight.clear_timer then
+			state.hover_highlight.clear_timer:kill()
+			state.hover_highlight.clear_timer = nil
+		end
+		state.hover_highlight.clear_timer = mp.add_timeout(delay_seconds or 0.08, function()
+			state.hover_highlight.clear_timer = nil
+			clear_hover_overlay()
+		end)
+	end
+
+	local function render_hover_overlay(payload)
+		if not payload or payload.hoveredTokenIndex == nil or payload.subtitle == nil then
+			clear_hover_overlay()
+			return
+		end
+
+		local ass = build_hover_subtitle_content(payload)
+		if not ass then
+			return
+		end
+
+		local osd_w, osd_h = resolve_osd_dimensions()
+		local metrics = resolve_metrics()
+		local osd_dims = mp.get_property_native("osd-dimensions")
+		local ml = (type(osd_dims) == "table" and type(osd_dims.ml) == "number") and osd_dims.ml or 0
+		local mr = (type(osd_dims) == "table" and type(osd_dims.mr) == "number") and osd_dims.mr or 0
+		local mt = (type(osd_dims) == "table" and type(osd_dims.mt) == "number") and osd_dims.mt or 0
+		local mb = (type(osd_dims) == "table" and type(osd_dims.mb) == "number") and osd_dims.mb or 0
+		local usable_w = math.max(1, osd_w - ml - mr)
+		local usable_h = math.max(1, osd_h - mt - mb)
+		local anchor_x = math.floor(ml + usable_w / 2)
+		local baseline_adjust = (metrics.border + metrics.shadow) * 5
+		local anchor_y = math.floor(mt + (usable_h * metrics.pos / 100) - metrics.margin_y + baseline_adjust)
+		local font_size = math.max(8, metrics.font_size)
+		local anchor_tag = string.format(
+			"{\\an2\\q2\\pos(%d,%d)\\fn%s\\fs%g\\b%d\\i%d\\fsp%g\\bord%g\\shad%g\\1c&H%s&}",
+			anchor_x,
+			anchor_y,
+			escape_ass_text(metrics.font),
+			font_size,
+			metrics.bold and 1 or 0,
+			metrics.italic and 1 or 0,
+			metrics.spacing,
+			metrics.border,
+			metrics.shadow,
+			metrics.base_color
+		)
+		if not state.hover_highlight.overlay_active then
+			state.hover_highlight.saved_sub_visibility = mp.get_property("sub-visibility")
+			state.hover_highlight.saved_secondary_sub_visibility = mp.get_property("secondary-sub-visibility")
+			mp.set_property("sub-visibility", "no")
+			mp.set_property("secondary-sub-visibility", "no")
+			state.hover_highlight.overlay_active = true
+		end
+		mp.set_osd_ass(osd_w, osd_h, anchor_tag .. ass)
+	end
+
+	local function handle_hover_message(payload_json)
+		local parsed, parse_error = utils.parse_json(payload_json)
+		if not parsed then
+			msg.warn("Invalid hover-highlight payload: " .. tostring(parse_error))
+			clear_hover_overlay()
+			return
+		end
+
+		if type(parsed.revision) ~= "number" then
+			clear_hover_overlay()
+			return
+		end
+
+		if parsed.revision < state.hover_highlight.revision then
+			return
+		end
+
+		if type(parsed.hoveredTokenIndex) == "number" and type(parsed.tokens) == "table" then
+			if state.hover_highlight.clear_timer then
+				state.hover_highlight.clear_timer:kill()
+				state.hover_highlight.clear_timer = nil
+			end
+			state.hover_highlight.revision = parsed.revision
+			state.hover_highlight.payload = parsed
+			state.hover_highlight.last_hover_update_ts = mp.get_time() or 0
+			render_hover_overlay(state.hover_highlight.payload)
+			return
+		end
+
+		local now = mp.get_time() or 0
+		local elapsed_since_hover = now - (state.hover_highlight.last_hover_update_ts or 0)
+		state.hover_highlight.revision = parsed.revision
+		state.hover_highlight.payload = nil
+		if state.hover_highlight.overlay_active then
+			if elapsed_since_hover > 0.35 then
+				return
+			end
+			schedule_hover_clear(0.08)
+		else
+			clear_hover_overlay()
+		end
+	end
+
+	return {
+		HOVER_MESSAGE_NAME = "subminer-hover-token",
+		HOVER_MESSAGE_NAME_LEGACY = "yomipv-hover-token",
+		handle_hover_message = handle_hover_message,
+		clear_hover_overlay = clear_hover_overlay,
+	}
+end
+
+return M
@@ -10,6 +10,7 @@ function M.create(ctx)
 	local state = ctx.state
 	local options_helper = ctx.options_helper
 	local process = ctx.process
+	local hover = ctx.hover
 	local subminer_log = ctx.log.subminer_log
 	local show_osd = ctx.log.show_osd

@@ -307,6 +308,7 @@ function M.create(ctx)

 	local function on_shutdown()
 		next_auto_start_retry_generation()
+		hover.clear_hover_overlay()
 		process.disarm_auto_play_ready_gate()
 		process.stop_overlay_loading_osd()
 		clear_pending_visible_overlay_hide()
@@ -324,9 +326,13 @@ function M.create(ctx)
 		mp.register_event("start-file", on_start_file)
 		mp.register_event("file-loaded", on_file_loaded)
 		mp.register_event("shutdown", on_shutdown)
+		mp.register_event("file-loaded", function()
+			hover.clear_hover_overlay()
+		end)
 		mp.register_event("end-file", function(event)
 			process.stop_overlay_loading_osd()
 			process.disarm_auto_play_ready_gate()
+			hover.clear_hover_overlay()
 			local reason = type(event) == "table" and event.reason or nil
 			if is_reload_end_file(reason) then
 				state.pending_reload_media_identity = state.current_media_identity or resolve_media_identity()
@@ -346,6 +352,15 @@ function M.create(ctx)
 				hide_visible_overlay_after_end_file()
 			end
 		end)
+		mp.register_event("shutdown", function()
+			hover.clear_hover_overlay()
+		end)
+		mp.add_hook("on_unload", 10, function()
+			hover.clear_hover_overlay()
+		end)
+		mp.observe_property("sub-start", "native", function()
+			hover.clear_hover_overlay()
+		end)
 	end

 	return {
@@ -4,6 +4,7 @@ function M.create(ctx)
 	local mp = ctx.mp
 	local opts = ctx.opts
 	local process = ctx.process
+	local hover = ctx.hover
 	local ui = ctx.ui
 	local state = ctx.state

@@ -48,6 +49,12 @@ function M.create(ctx)
 		mp.register_script_message("subminer-overlay-loading-ready", function()
 			process.stop_overlay_loading_osd()
 		end)
+		mp.register_script_message(hover.HOVER_MESSAGE_NAME, function(payload_json)
+			hover.handle_hover_message(payload_json)
+		end)
+		mp.register_script_message(hover.HOVER_MESSAGE_NAME_LEGACY, function(payload_json)
+			hover.handle_hover_message(payload_json)
+		end)
 		mp.register_script_message("subminer-stats-toggle", function()
 			if opts.osd_messages then
 				mp.osd_message("Stats: press ` (backtick) in overlay", 3)
@@ -8,6 +8,16 @@ function M.new()
 		binary_available = false,
 		binary_path = nil,
 		detected_backend = nil,
+		hover_highlight = {
+			revision = -1,
+			payload = nil,
+			saved_sub_visibility = nil,
+			saved_secondary_sub_visibility = nil,
+			overlay_active = false,
+			cached_ass = nil,
+			clear_timer = nil,
+			last_hover_update_ts = 0,
+		},
 		auto_play_ready_gate_armed = false,
 		auto_play_ready_should_resume_playback = false,
 		auto_play_ready_timeout = nil,
@@ -1,60 +0,0 @@
-## Highlights
-### Added
- **Hachidori Dictionary Backend**: Bundled Hachidori backend as an alternative to Yomitan. Select it with `dictionaryBackend` and restart SubMiner.
-  - Works with subtitle scanning, popups, frequency highlighting, character dictionaries, Anki mining, and stats dashboard mining.
-  - First-run setup builds Hachidori's Anki template from your existing SubMiner deck, tags, and field mappings.
-  - Can link an external Hachidori app, browser, or Docker host while Anki mining stays in SubMiner.
-  - The tray and dictionary-settings shortcut open the selected backend's settings. `--hachidori` and `--yomitan` open a specific one.
- **Jellyfin Subtitle Generation**: Japanese subtitle generation now works while playing Jellyfin episodes, with both direct-play and transcoded playback.
-
-### Fixed
- **Media Timing Review**: Opens on the first try and keeps playback paused while open, even when a dictionary popup closes.
- **Jellyfin Terminal Playback**:
-  - `subminer jellyfin -p` lists libraries when SubMiner is already running, and picker image previews work again.
-  - Real errors, like an expired session or an unreachable server, now appear instead of an empty list.
-  - Watch progress and played status reach Jellyfin even when cast discovery is off.
-  - When it starts SubMiner itself, SubMiner now shows a tray icon and quits when mpv closes.
-  - The rofi search step is now a compact input box.
- **macOS Casting**: Jellyfin casting finds mpv when SubMiner is opened from Finder, the Dock, or Spotlight. `mpv.executablePath` and `SUBMINER_MPV_PATH` are now honored on macOS and Linux.
- **macOS Launcher PATH**: The command-line launcher no longer shows "Not on PATH" when SubMiner is opened from Finder or the Dock.
- **Keyboard-Only Mode**: `h`, `l`, and the arrow keys type normally in modals and text fields instead of seeking mpv. Toggling the mode inside a modal no longer turns on a hidden keyboard-only mode.
- **Halfwidth Katakana**: Halfwidth katakana in subtitles now displays as fullwidth, including in mined cards and the stats dashboard. Stats sentence search matches katakana in either width.
- **Subtitle Annotations**: Lines shown while two cues overlap now get annotations right away. Prefetching no longer restarts during startup.
- **Subtitle Sidebar**: The open sidebar does far less work during playback.
- **Hyprland and Sway**: A slow or hung `hyprctl` or `swaymsg` no longer freezes the app.
- **Stats Mining**: Cards mined from the stats dashboard keep the selected history line and media.
- **Security Updates**: Updated Electron, undici, and follow-redirects to fix new security advisories.
-
-### Docs
- **Hachidori Setup**: Covers backend selection, Hachidori dictionary and Anki setup, settings flags and shortcuts, and linking an external host.
- **Jellyfin**: The docs now say SubMiner joins the cast menu at startup only when both `startupWarmups.jellyfinRemoteSession` and `jellyfin.remoteControlAutoConnect` are on. Otherwise, enable **Jellyfin Discovery** in the tray.
- **Casting and mpv**: Added how casting finds mpv on each platform, a troubleshooting entry for casts that never start mpv, and a note on the macOS 27 Accessibility list rename.
- **Jimaku Environment Variables**: Removed the unused `SUBMINER_JIMAKU_*` variables from the docs. Set the key with `jimaku.apiKey` or `jimaku.apiKeyCommand` instead.
-
-## What's Changed
-
- feat(dictionary): add Hachidori backend support by @ksyasuda in #266
- fix(jellyfin): make terminal play work with a running app and report progress by @ksyasuda in #288
- fix(overlay): stop Hyprland/Sway tracker polls from blocking the main thread by @ksyasuda in #289
- fix(overlay): poll cheap playback state in the open subtitle sidebar by @ksyasuda in #290
- fix(overlay): keep keyboard mode from swallowing modal and text-field keys by @ksyasuda in #291
- refactor: remove dead code and enable noUnusedLocals by @ksyasuda in #292
- feat(subtitles): generate Japanese subtitles during Jellyfin playback by @ksyasuda in #294
- fix(subtitles): widen halfwidth katakana where subtitle text enters the app by @ksyasuda in #295
- fix(jellyfin): find mpv when SubMiner is launched from Finder by @ksyasuda in #298
-
-## Installation
-
-See the README and docs/installation guide for full setup steps.
-
-## Assets
-
- Linux: `SubMiner.AppImage`
- macOS: `SubMiner-*.dmg` and `SubMiner-*.zip`
- Windows: `SubMiner-*.exe` and `SubMiner-*-win.zip`
- Optional extras: `subminer-assets.tar.gz`, the `subminer` launcher, and the Windows `subminer.cmd` launcher
- Bun corresponding source: `bun-v1.3.5-source.tar.gz` and its `.sha256` file
-
-Both launcher downloads use Bun included with the SubMiner app. Download `subminer` on Linux or macOS and `subminer.cmd` on Windows.
-
-The app bundles an unmodified Bun 1.3.5 runtime. Bun is MIT licensed and statically links JavaScriptCore (LGPL 2.0) and TinyCC (LGPL 2.1). License texts and third-party notices ship inside the app under `resources/bun/licenses`, and the source archive above contains the matching Bun, WebKit, and dependency sources for relinking.
@@ -141,7 +141,7 @@ app
      );
      assert.equal(anki.model, 'Custom Japanese');
      assert.equal(anki.deck, 'Test Mining');
-      assert.deepEqual(anki.tags, [...ankiConfig.tags, 'hachidori']);
+      assert.deepEqual(anki.tags, ankiConfig.tags);
      assert.equal(anki.fieldTemplates.Term.value, '{expression}');
      assert.equal(anki.fieldTemplates.Pronunciation.value, '{audio}');
      assert.equal(anki.fieldTemplates.Context.value, '{sentence}');
@@ -1,5 +1,6 @@
 local MODULE_PATHS = {
 	"plugin/subminer/bootstrap.lua",
+	"plugin/subminer/hover.lua",
 	"plugin/subminer/environment.lua",
 	"plugin/subminer/version.lua",
 }
@@ -267,6 +267,7 @@ local function run_plugin_scenario(config)
 	package.loaded["binary"] = nil
 	package.loaded["bootstrap"] = nil
 	package.loaded["environment"] = nil
+	package.loaded["hover"] = nil
 	package.loaded["init"] = nil
 	package.loaded["lifecycle"] = nil
 	package.loaded["log"] = nil
@@ -41,6 +41,7 @@ import type { NPlusOneMatchMode, SubtitleMiningContext } from './types/subtitle'
 import { DEFAULT_ANKI_CONNECT_CONFIG } from './config';
 import {
  getConfiguredWordFieldCandidates,
+  getConfiguredWordFieldName,
  getPreferredWordValueFromExtractedFields,
 } from './anki-field-config';
 import { createLogger } from './logger';
@@ -1631,6 +1632,10 @@ export class AnkiIntegration {
    return sentenceCardConfig.audioField || 'SentenceAudio';
  }

+  private getConfiguredWordFieldName(): string {
+    return getConfiguredWordFieldName(this.config);
+  }
+
  private getConfiguredWordFieldCandidates(): string[] {
    return getConfiguredWordFieldCandidates(this.config);
  }
@@ -1,6 +1,10 @@
 import { DEFAULT_ANKI_CONNECT_CONFIG } from '../config';
 import type { AnkiConnectConfig } from '../types/anki';
-import { getKnownWordCacheLifecycleConfig } from './known-word-cache';
+import {
+  getKnownWordCacheLifecycleConfig,
+  getKnownWordCacheRefreshIntervalMinutes,
+  getKnownWordCacheScopeForConfig,
+} from './known-word-cache';

 export interface AnkiIntegrationRuntimeProxyServer {
  start(options: { host: string; port: number; upstreamUrl: string }): void;
@@ -251,6 +255,14 @@ export class AnkiIntegrationRuntime {
    return getKnownWordCacheLifecycleConfig(config);
  }

+  private getKnownWordRefreshIntervalMinutes(config: AnkiConnectConfig): number {
+    return getKnownWordCacheRefreshIntervalMinutes(config);
+  }
+
+  private getKnownWordCacheScopeForConfig(config: AnkiConnectConfig): string {
+    return getKnownWordCacheScopeForConfig(config);
+  }
+
  getOrCreateProxyServer(): AnkiIntegrationRuntimeProxyServer {
    if (!this.proxyServer) {
      this.proxyServer = this.deps.proxyServerFactory();
@@ -133,7 +133,9 @@ export const INTEGRATIONS_DEFAULT_CONFIG: Pick<
    enabled: false,
    accessToken: '',
    characterDictionary: {
+      refreshTtlHours: 168,
      maxLoaded: 3,
+      evictionPolicy: 'delete',
      profileScope: 'all',
      collapsibleSections: {
        description: false,
@@ -37,6 +37,8 @@ function collectConfigLeafPaths(config: ResolvedConfig): string[] {
 // an allowlist entry. Only allowlist a path when the registry is genuinely
 // the wrong surface for it.
 const UNDOCUMENTED_LEAVES: ReadonlySet<string> = new Set([
+  'anilist.characterDictionary.evictionPolicy',
+  'anilist.characterDictionary.refreshTtlHours',
  'keybindings',
  'subtitleStyle.backdropFilter',
  'subtitleStyle.backgroundColor',
@@ -554,7 +554,7 @@ export function buildIntegrationConfigOptionRegistry(
      kind: 'string',
      defaultValue: defaultConfig.mpv.executablePath,
      description:
-        'Optional absolute path to the mpv binary SubMiner starts itself (Windows launches, Jellyfin casting, timing preview). Leave empty to auto-discover from SUBMINER_MPV_PATH, PATH, and on macOS the Homebrew and /Applications/mpv.app locations.',
+        'Optional absolute path to mpv.exe for Windows launch flows. Leave empty to auto-discover from SUBMINER_MPV_PATH or PATH.',
    },
    {
      path: 'mpv.launchMode',
@@ -223,7 +223,7 @@ const INTEGRATION_TEMPLATE_SECTIONS: ConfigTemplateSection[] = [
      'autoStartSubMiner starts SubMiner in the background; auto_start_overlay only controls visible overlay display.',
      'Set mpv.launchMode to choose normal, maximized, or fullscreen SubMiner-managed mpv playback.',
      'Set mpv.profile to pass an mpv profile to managed mpv launches; leave it blank to pass none.',
-      'Leave mpv.executablePath blank to auto-discover mpv from SUBMINER_MPV_PATH, PATH, or (macOS) Homebrew and /Applications/mpv.app.',
+      'Leave mpv.executablePath blank to auto-discover mpv.exe from SUBMINER_MPV_PATH or PATH.',
    ],
    key: 'mpv',
  },
@@ -94,6 +94,27 @@ export function applyIntegrationConfig(context: ResolveContext): void {
    if (isObject(src.anilist.characterDictionary)) {
      const characterDictionary = src.anilist.characterDictionary;

+      const refreshTtlHours = asNumber(characterDictionary.refreshTtlHours);
+      if (refreshTtlHours !== undefined) {
+        const normalized = Math.min(24 * 365, Math.max(1, Math.floor(refreshTtlHours)));
+        if (normalized !== refreshTtlHours) {
+          warn(
+            'anilist.characterDictionary.refreshTtlHours',
+            characterDictionary.refreshTtlHours,
+            normalized,
+            'Out of range; clamped to 1..8760 hours.',
+          );
+        }
+        resolved.anilist.characterDictionary.refreshTtlHours = normalized;
+      } else if (characterDictionary.refreshTtlHours !== undefined) {
+        warn(
+          'anilist.characterDictionary.refreshTtlHours',
+          characterDictionary.refreshTtlHours,
+          resolved.anilist.characterDictionary.refreshTtlHours,
+          'Expected number.',
+        );
+      }
+
      const maxLoaded = asNumber(characterDictionary.maxLoaded);
      if (maxLoaded !== undefined) {
        const normalized = Math.min(20, Math.max(1, Math.floor(maxLoaded)));
@@ -115,6 +136,28 @@ export function applyIntegrationConfig(context: ResolveContext): void {
        );
      }

+      const evictionPolicyRaw = asString(characterDictionary.evictionPolicy);
+      if (evictionPolicyRaw !== undefined) {
+        const evictionPolicy = evictionPolicyRaw.trim().toLowerCase();
+        if (evictionPolicy === 'disable' || evictionPolicy === 'delete') {
+          resolved.anilist.characterDictionary.evictionPolicy = evictionPolicy;
+        } else {
+          warn(
+            'anilist.characterDictionary.evictionPolicy',
+            characterDictionary.evictionPolicy,
+            resolved.anilist.characterDictionary.evictionPolicy,
+            "Expected one of: 'disable', 'delete'.",
+          );
+        }
+      } else if (characterDictionary.evictionPolicy !== undefined) {
+        warn(
+          'anilist.characterDictionary.evictionPolicy',
+          characterDictionary.evictionPolicy,
+          resolved.anilist.characterDictionary.evictionPolicy,
+          'Expected string.',
+        );
+      }
+
      const profileScopeRaw = asString(characterDictionary.profileScope);
      if (profileScopeRaw !== undefined) {
        const profileScope = profileScopeRaw.trim().toLowerCase();
@@ -97,7 +97,9 @@ test('anilist character dictionary fields are parsed, clamped, and enum-validate
  const { context, warnings } = createResolveContext({
    anilist: {
      characterDictionary: {
+        refreshTtlHours: 0,
        maxLoaded: 99,
+        evictionPolicy: 'purge' as never,
        profileScope: 'global' as never,
        collapsibleSections: {
          description: true,
@@ -110,7 +112,9 @@ test('anilist character dictionary fields are parsed, clamped, and enum-validate

  applyIntegrationConfig(context);

+  assert.equal(context.resolved.anilist.characterDictionary.refreshTtlHours, 1);
  assert.equal(context.resolved.anilist.characterDictionary.maxLoaded, 20);
+  assert.equal(context.resolved.anilist.characterDictionary.evictionPolicy, 'delete');
  assert.equal(context.resolved.anilist.characterDictionary.profileScope, 'all');
  assert.equal(context.resolved.anilist.characterDictionary.collapsibleSections.description, true);
  assert.equal(
@@ -120,7 +124,9 @@ test('anilist character dictionary fields are parsed, clamped, and enum-validate
  assert.equal(context.resolved.anilist.characterDictionary.collapsibleSections.voicedBy, true);

  const warnedPaths = warnings.map((warning) => warning.path);
+  assert.ok(warnedPaths.includes('anilist.characterDictionary.refreshTtlHours'));
  assert.ok(warnedPaths.includes('anilist.characterDictionary.maxLoaded'));
+  assert.ok(warnedPaths.includes('anilist.characterDictionary.evictionPolicy'));
  assert.ok(warnedPaths.includes('anilist.characterDictionary.profileScope'));
  assert.ok(
    warnedPaths.includes('anilist.characterDictionary.collapsibleSections.characterInformation'),
@@ -128,7 +134,7 @@ test('anilist character dictionary fields are parsed, clamped, and enum-validate
 });

 test('yomitan externalProfilePath is trimmed and invalid values warn', () => {
-  const { context } = createResolveContext({
+  const { context, warnings } = createResolveContext({
    yomitan: {
      externalProfilePath: '  /tmp/gsm-profile  ',
    },
@@ -335,7 +335,7 @@ function humanizePath(path: string): string {
 }

 function categoryAndSection(path: string): { category: ConfigSettingsCategory; section: string } {
-  if (path === 'dictionaryBackend') {
+  if (path === 'dictionaryBackend' || path.startsWith('hachidori.')) {
    return { category: 'integrations', section: 'Dictionary Lookup' };
  }
  if (
@@ -18,6 +18,10 @@ const TOP_LEVEL_SECTION_DESCRIPTION_BY_KEY = new Map(
  CONFIG_TEMPLATE_SECTIONS.map((section) => [String(section.key), section.description[0] ?? '']),
 );
 const SUBTITLE_CSS_SCOPES: SubtitleCssScope[] = ['primary', 'secondary', 'sidebar'];
+const HIDDEN_TEMPLATE_PATHS = [
+  'anilist.characterDictionary.evictionPolicy',
+  'anilist.characterDictionary.refreshTtlHours',
+];

 function normalizeCommentText(value: string): string {
  return value.replace(/\s+/g, ' ').replace(/\*\//g, '*\\/').trim();
@@ -172,6 +176,9 @@ function renderSection(
 function createTemplateConfig(config: ResolvedConfig): ResolvedConfig {
  const templateConfig = deepCloneConfig(config);
  foldSubtitleCssManagedDefaults(templateConfig);
+  for (const hiddenPath of HIDDEN_TEMPLATE_PATHS) {
+    deleteValueAtPath(templateConfig, hiddenPath);
+  }
  if (templateConfig.keybindings.length === 0) {
    templateConfig.keybindings = DEFAULT_KEYBINDINGS.map((binding) => ({
      key: binding.key,
@@ -1935,27 +1935,6 @@ describe('stats server API routes', () => {
    });
  });

-  it('POST /api/stats/mine-card widens halfwidth katakana from older stats lines', async () => {
-    await withMiningEnv({}, async (env) => {
-      const app = createStatsApp(createMockTracker(), {
-        addYomitanNote: async () => 777,
-        ankiConnectConfig: ankiConfig(env, { fields: { sentence: 'Sentence' } }),
-      });
-
-      const { status, body } = await mineCard(app, 'word', {
-        sourcePath: env.sourcePath,
-        sentence: 'ｱﾝﾀがｱｰﾀﾙたん？',
-        word: 'ｱﾝﾀ',
-      });
-
-      assert.equal(status, 200, JSON.stringify(body));
-      assert.equal(
-        sentNote(env.requests, 'updateNoteFields').fields.Sentence,
-        '<b>アンタ</b>がアータルたん？',
-      );
-    });
-  });
-
  it('POST /api/stats/mine-card leaves word card selection text to Yomitan glossary', async () => {
    await withMiningEnv({}, async (env) => {
      const app = createStatsApp(createMockTracker(), {
@@ -87,6 +87,20 @@ export interface GuessAnilistMediaInfoDeps {
  runGuessit: (target: string) => Promise<string>;
 }

+function firstString(value: unknown): string | null {
+  if (typeof value === 'string') {
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+  }
+  if (Array.isArray(value)) {
+    for (const item of value) {
+      const candidate = firstString(item);
+      if (candidate) return candidate;
+    }
+  }
+  return null;
+}
+
 function normalizeGuessitTitlePart(value: string): string {
  return value.replace(/[._]+/g, ' ').replace(/-/g, ' ').replace(/\s+/g, ' ').trim();
 }
@@ -32,6 +32,8 @@ test('anki/jimaku IPC handlers reject malformed invoke payloads', async () => {
  let previewCalls = 0;
  registerAnkiJimakuIpcHandlers(
    {
+      setAnkiConnectEnabled: () => {},
+      clearAnkiHistory: () => {},
      refreshKnownWords: async () => {},
      respondFieldGrouping: () => {},
      buildKikuMergePreview: async () => {
@@ -136,6 +138,8 @@ test('tsukihime downloads always route Japanese as primary', async () => {
  const secondaryLoads: string[] = [];
  registerAnkiJimakuIpcHandlers(
    {
+      setAnkiConnectEnabled: () => {},
+      clearAnkiHistory: () => {},
      refreshKnownWords: async () => {},
      respondFieldGrouping: () => {},
      buildKikuMergePreview: async () => ({ ok: true }),
@@ -201,8 +205,13 @@ test('tsukihime downloads always route Japanese as primary', async () => {
 test('anki/jimaku IPC command handlers ignore malformed payloads', () => {
  const { registrar, onHandlers } = createFakeRegistrar();
  const fieldGroupingChoices: unknown[] = [];
+  const enabledStates: boolean[] = [];
  registerAnkiJimakuIpcHandlers(
    {
+      setAnkiConnectEnabled: (enabled) => {
+        enabledStates.push(enabled);
+      },
+      clearAnkiHistory: () => {},
      refreshKnownWords: async () => {},
      respondFieldGrouping: (choice) => {
        fieldGroupingChoices.push(choice);
@@ -232,6 +241,10 @@ test('anki/jimaku IPC command handlers ignore malformed payloads', () => {
    registrar,
  );

+  onHandlers.get(IPC_CHANNELS.command.setAnkiConnectEnabled)!({}, 'true');
+  onHandlers.get(IPC_CHANNELS.command.setAnkiConnectEnabled)!({}, true);
+  assert.deepEqual(enabledStates, [true]);
+
  onHandlers.get(IPC_CHANNELS.command.kikuFieldGroupingRespond)!({}, null);
  onHandlers.get(IPC_CHANNELS.command.kikuFieldGroupingRespond)!(
    {},
@@ -40,6 +40,8 @@ const { ipcMain } = electron;
 const logger = createLogger('main:anki-jimaku-ipc');

 export interface AnkiJimakuIpcDeps {
+  setAnkiConnectEnabled: (enabled: boolean) => void;
+  clearAnkiHistory: () => void;
  refreshKnownWords: () => Promise<void> | void;
  respondFieldGrouping: (choice: KikuFieldGroupingChoice) => void;
  buildKikuMergePreview: (request: KikuMergePreviewRequest) => Promise<KikuMergePreviewResponse>;
@@ -75,6 +77,15 @@ export function registerAnkiJimakuIpcHandlers(
  deps: AnkiJimakuIpcDeps,
  ipc: IpcMainRegistrar = ipcMain,
 ): void {
+  ipc.on(IPC_CHANNELS.command.setAnkiConnectEnabled, (_event: unknown, enabled: unknown) => {
+    if (typeof enabled !== 'boolean') return;
+    deps.setAnkiConnectEnabled(enabled);
+  });
+
+  ipc.on(IPC_CHANNELS.command.clearAnkiConnectHistory, () => {
+    deps.clearAnkiHistory();
+  });
+
  ipc.on(IPC_CHANNELS.command.refreshKnownWords, async () => {
    await deps.refreshKnownWords();
  });
@@ -8,6 +8,8 @@ interface RuntimeHarness {
  state: {
    ankiIntegration: unknown;
    fieldGroupingResolver: ((choice: unknown) => void) | null;
+    patches: boolean[];
+    broadcasts: number;
    fetchCalls: Array<{ endpoint: string; query?: Record<string, unknown> }>;
    tsukihimeFetchCalls: Array<{ endpoint: string; query?: Record<string, unknown> }>;
    sentCommands: Array<{ command: (string | number)[] }>;
@@ -18,6 +20,8 @@ function createHarness(): RuntimeHarness {
  const state = {
    ankiIntegration: null as unknown,
    fieldGroupingResolver: null as ((choice: unknown) => void) | null,
+    patches: [] as boolean[],
+    broadcasts: 0,
    fetchCalls: [] as Array<{
      endpoint: string;
      query?: Record<string, unknown>;
@@ -30,7 +34,11 @@ function createHarness(): RuntimeHarness {
  };

  const options: AnkiJimakuIpcRuntimeOptions = {
+    patchAnkiConnectEnabled: (enabled) => {
+      state.patches.push(enabled);
+    },
    getResolvedConfig: () => ({ tsukihime: { maxSearchResults: 2 } }),
+    getRuntimeOptionsManager: () => null,
    tsukihimeFetchJson: async (endpoint, query) => {
      state.tsukihimeFetchCalls.push({
        endpoint,
@@ -68,6 +76,7 @@ function createHarness(): RuntimeHarness {
        } as never,
      };
    },
+    getSubtitleTimingTracker: () => null,
    getMpvClient: () => ({
      connected: true,
      send: (payload) => {
@@ -90,6 +99,20 @@ function createHarness(): RuntimeHarness {
      },
    }),
    getAnkiIntegration: () => state.ankiIntegration as never,
+    setAnkiIntegration: (integration) => {
+      state.ankiIntegration = integration;
+    },
+    getKnownWordCacheStatePath: () => '/tmp/subminer-known-words-cache.json',
+    showDesktopNotification: () => {},
+    createFieldGroupingCallback: () => async () => ({
+      keepNoteId: 1,
+      deleteNoteId: 2,
+      deleteDuplicate: false,
+      cancelled: false,
+    }),
+    broadcastRuntimeOptionsChanged: () => {
+      state.broadcasts += 1;
+    },
    getFieldGroupingResolver: () => state.fieldGroupingResolver as never,
    setFieldGroupingResolver: (resolver) => {
      state.fieldGroupingResolver = resolver as never;
@@ -146,21 +169,51 @@ test('refreshKnownWords throws when integration is unavailable', async () => {
  );
 });

-test('respondFieldGrouping resolves and clears the pending resolver', () => {
+test('setAnkiConnectEnabled disables active integration and broadcasts changes', () => {
  const { registered, state } = createHarness();
+  let destroyed = 0;
+  state.ankiIntegration = {
+    destroy: () => {
+      destroyed += 1;
+    },
+  };
+
+  registered.setAnkiConnectEnabled!(false);
+
+  assert.deepEqual(state.patches, [false]);
+  assert.equal(destroyed, 1);
+  assert.equal(state.ankiIntegration, null);
+  assert.equal(state.broadcasts, 1);
+});
+
+test('clearAnkiHistory and respondFieldGrouping execute runtime callbacks', () => {
+  const { registered, state, options } = createHarness();
+  let cleaned = 0;
  let resolvedChoice: unknown = null;
  state.fieldGroupingResolver = (choice) => {
    resolvedChoice = choice;
  };

+  const originalGetTracker = options.getSubtitleTimingTracker;
+  options.getSubtitleTimingTracker = () =>
+    ({
+      cleanup: () => {
+        cleaned += 1;
+      },
+    }) as never;
+
  const choice = {
    keepNoteId: 10,
    deleteNoteId: 11,
    deleteDuplicate: true,
    cancelled: false,
  };
+  registered.clearAnkiHistory!();
  registered.respondFieldGrouping!(choice);

+  options.getSubtitleTimingTracker = originalGetTracker;
+
+  assert.equal(cleaned, 1);
  assert.deepEqual(resolvedChoice, choice);
  assert.equal(state.fieldGroupingResolver, null);
 });
@@ -1,14 +1,19 @@
 import * as fs from 'fs';
-import type { AnkiIntegration } from '../../anki-integration';
+import { AnkiIntegration } from '../../anki-integration';
+import { mergeAiConfig } from '../../ai/config';
 import {
+  AiConfig,
  TsukihimeApiResponse,
  TsukihimeConfig,
+  AnkiConnectConfig,
  JimakuApiResponse,
  JimakuEntry,
  JimakuFileEntry,
  JimakuLanguagePreference,
  JimakuMediaInfo,
  KikuFieldGroupingChoice,
+  KikuFieldGroupingRequestData,
+  OverlayNotificationPayload,
 } from '../../types';
 import { sortJimakuFiles } from '../../jimaku/utils';
 import {
@@ -30,13 +35,41 @@ interface MpvClientLike {
  request?: (command: unknown[]) => Promise<{ data?: unknown }>;
 }

+interface RuntimeOptionsManagerLike {
+  getEffectiveAnkiConnectConfig: (config?: AnkiConnectConfig) => AnkiConnectConfig;
+}
+
+interface SubtitleTimingTrackerLike {
+  cleanup: () => void;
+}
+
 export interface AnkiJimakuIpcRuntimeOptions {
+  patchAnkiConnectEnabled: (enabled: boolean) => void;
  getResolvedConfig: () => {
+    ankiConnect?: AnkiConnectConfig;
+    ai?: AiConfig;
    tsukihime?: TsukihimeConfig;
    secondarySub?: { secondarySubLanguages?: string[] };
  };
+  getRuntimeOptionsManager: () => RuntimeOptionsManagerLike | null;
+  getSubtitleTimingTracker: () => SubtitleTimingTrackerLike | null;
  getMpvClient: () => MpvClientLike | null;
  getAnkiIntegration: () => AnkiIntegration | null;
+  setAnkiIntegration: (integration: AnkiIntegration | null) => void;
+  getKnownWordCacheStatePath: () => string;
+  getCachedMediaPath?: (
+    currentVideoPath: string,
+    kind: 'audio' | 'video',
+  ) => Promise<string | null>;
+  shouldRequireRemoteMediaCache?: () => boolean;
+  getYoutubeMediaSourceUrl?: () => Promise<string | null | undefined> | string | null | undefined;
+  showDesktopNotification: (title: string, options: { body?: string; icon?: string }) => void;
+  showOverlayNotification?: (payload: OverlayNotificationPayload) => void;
+  dismissOverlayNotification?: (id: string) => void;
+  createFieldGroupingCallback: () => (
+    data: KikuFieldGroupingRequestData,
+  ) => Promise<KikuFieldGroupingChoice>;
+  broadcastRuntimeOptionsChanged: () => void;
  getFieldGroupingResolver: () => ((choice: KikuFieldGroupingChoice) => void) | null;
  setFieldGroupingResolver: (resolver: ((choice: KikuFieldGroupingChoice) => void) | null) => void;
  parseMediaInfo: (mediaPath: string | null) => JimakuMediaInfo;
@@ -102,6 +135,58 @@ export function registerAnkiJimakuIpcRuntime(
  registerHandlers: RegisterAnkiJimakuIpcRuntimeHandler,
 ): void {
  registerHandlers({
+    setAnkiConnectEnabled: (enabled) => {
+      options.patchAnkiConnectEnabled(enabled);
+      const config = options.getResolvedConfig();
+      const subtitleTimingTracker = options.getSubtitleTimingTracker();
+      const mpvClient = options.getMpvClient();
+      const ankiIntegration = options.getAnkiIntegration();
+
+      if (enabled && !ankiIntegration && subtitleTimingTracker && mpvClient) {
+        const runtimeOptionsManager = options.getRuntimeOptionsManager();
+        const effectiveAnkiConfig = runtimeOptionsManager
+          ? runtimeOptionsManager.getEffectiveAnkiConnectConfig(config.ankiConnect)
+          : config.ankiConnect;
+        const integration = new AnkiIntegration(
+          effectiveAnkiConfig as never,
+          subtitleTimingTracker as never,
+          mpvClient as never,
+          (text: string) => {
+            if (mpvClient) {
+              mpvClient.send({
+                command: ['show-text', text, '3000'],
+              });
+            }
+          },
+          options.showDesktopNotification,
+          options.createFieldGroupingCallback(),
+          options.getKnownWordCacheStatePath(),
+          mergeAiConfig(config.ai, config.ankiConnect?.ai) as AiConfig,
+          undefined,
+          options.showOverlayNotification,
+          options.getCachedMediaPath,
+          options.shouldRequireRemoteMediaCache,
+          options.getYoutubeMediaSourceUrl,
+          options.dismissOverlayNotification,
+        );
+        integration.start();
+        options.setAnkiIntegration(integration);
+        logger.info('AnkiConnect integration enabled');
+      } else if (!enabled && ankiIntegration) {
+        ankiIntegration.destroy();
+        options.setAnkiIntegration(null);
+        logger.info('AnkiConnect integration disabled');
+      }
+
+      options.broadcastRuntimeOptionsChanged();
+    },
+    clearAnkiHistory: () => {
+      const subtitleTimingTracker = options.getSubtitleTimingTracker();
+      if (subtitleTimingTracker) {
+        subtitleTimingTracker.cleanup();
+        logger.info('AnkiConnect subtitle timing history cleared');
+      }
+    },
    refreshKnownWords: async () => {
      const integration = options.getAnkiIntegration();
      if (!integration) {
@@ -147,10 +147,16 @@ import { enqueueWrite } from './immersion-tracker/queue';
 import { nowMs } from './immersion-tracker/time';
 import {
  DEFAULT_BATCH_SIZE,
+  DEFAULT_DAILY_ROLLUP_RETENTION_MS,
+  DEFAULT_EVENTS_RETENTION_MS,
  DEFAULT_FLUSH_INTERVAL_MS,
  DEFAULT_MAINTENANCE_INTERVAL_MS,
  DEFAULT_MAX_PAYLOAD_BYTES,
+  DEFAULT_MONTHLY_ROLLUP_RETENTION_MS,
  DEFAULT_QUEUE_CAP,
+  DEFAULT_SESSIONS_RETENTION_MS,
+  DEFAULT_TELEMETRY_RETENTION_MS,
+  DEFAULT_VACUUM_INTERVAL_MS,
  EVENT_CARD_MINED,
  EVENT_LOOKUP,
  EVENT_MEDIA_BUFFER,
@@ -2769,6 +2769,7 @@ test('getSessionWordsByLine joins word occurrences through imm_words.id', () =>

  try {
    ensureSchema(db);
+    const stmts = createTrackerPreparedStatements(db);
    const startedAtMs = 1_735_732_800_000;
    const videoId = getOrCreateVideoRecord(db, '/tmp/session-words-by-line.mkv', {
      canonicalTitle: 'Episode',
@@ -3936,83 +3937,6 @@ test('getWordOccurrences maps a normalized word back to anime, video, and subtit
  }
 });

-test('getWordOccurrences widens halfwidth katakana in lines recorded before ingest widening', () => {
-  const dbPath = makeDbPath();
-  const db = openTestDb(dbPath);
-
-  try {
-    ensureSchema(db);
-    const videoId = getOrCreateVideoRecord(db, 'local:/tmp/kamikatsu-s01e08.mkv', {
-      canonicalTitle: 'Episode 8',
-      sourcePath: '/tmp/KamiKatsu S01E08.mkv',
-      sourceUrl: null,
-      sourceType: SOURCE_TYPE_LOCAL,
-    });
-    const { sessionId } = startSessionRecord(db, videoId, 1_000_000);
-    const wordResult = db
-      .prepare(
-        `INSERT INTO imm_words (
-          headword, word, reading, part_of_speech, pos1, pos2, pos3, first_seen, last_seen, frequency
-        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-      )
-      .run('アンタ', 'ｱﾝﾀ', 'あんた', 'noun', '名詞', '代名詞', '', 1_000, 1_000, 1);
-    const lineResult = db
-      .prepare(
-        `INSERT INTO imm_subtitle_lines (
-          session_id, event_id, video_id, anime_id, line_index, segment_start_ms, segment_end_ms, text, CREATED_DATE, LAST_UPDATE_DATE
-        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-      )
-      .run(sessionId, null, videoId, null, 1, 0, 1000, 'ｱﾝﾀがｱｰﾀﾙたん？', 1_000, 1_000);
-    db.prepare(
-      `INSERT INTO imm_word_line_occurrences (line_id, word_id, occurrence_count)
-       VALUES (?, ?, ?)`,
-    ).run(Number(lineResult.lastInsertRowid), Number(wordResult.lastInsertRowid), 1);
-
-    const rows = getWordOccurrences(db, 'アンタ', 'ｱﾝﾀ', 'あんた', 10);
-
-    assert.deepEqual(
-      rows.map((row) => row.text),
-      ['アンタがアータルたん？'],
-    );
-  } finally {
-    db.close();
-    cleanupDbPath(dbPath);
-  }
-});
-
-test('searchSubtitleSentences matches halfwidth and fullwidth katakana in either direction', () => {
-  const dbPath = makeDbPath();
-  const db = openTestDb(dbPath);
-
-  try {
-    ensureSchema(db);
-    const videoId = getOrCreateVideoRecord(db, 'local:/tmp/kamikatsu-s01e08.mkv', {
-      canonicalTitle: 'Episode 8',
-      sourcePath: '/tmp/KamiKatsu S01E08.mkv',
-      sourceUrl: null,
-      sourceType: SOURCE_TYPE_LOCAL,
-    });
-    const { sessionId } = startSessionRecord(db, videoId, 1_000_000);
-    const insertLine = db.prepare(
-      `INSERT INTO imm_subtitle_lines (
-        session_id, event_id, video_id, anime_id, line_index, segment_start_ms, segment_end_ms, text, CREATED_DATE, LAST_UPDATE_DATE
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-    );
-    insertLine.run(sessionId, null, videoId, null, 1, 0, 1000, 'ｱﾝﾀがｱｰﾀﾙたん？', 1_000, 1_000);
-    insertLine.run(sessionId, null, videoId, null, 2, 1000, 2000, 'アンタ、ダキニ', 2_000, 2_000);
-
-    for (const query of ['アンタ', 'ｱﾝﾀ']) {
-      assert.deepEqual(
-        searchSubtitleSentences(db, query, 10).map((row) => row.text),
-        ['アンタ、ダキニ', 'アンタがアータルたん？'],
-      );
-    }
-  } finally {
-    db.close();
-    cleanupDbPath(dbPath);
-  }
-});
-
 test('searchSubtitleSentences searches known subtitle lines and returns media context', () => {
  const dbPath = makeDbPath();
  const db = openTestDb(dbPath);
@@ -18,7 +18,6 @@ import type {
 } from './types';
 import { fromDbTimestamp, toDbTimestamp } from './query-shared';
 import { nowMs } from './time';
-import { narrowFullwidthKana, widenHalfwidthKana } from '../../utils/halfwidth-kana';
 import {
  areLexicalDailyRollupsReady,
  getLexicalDailyRollups,
@@ -383,13 +382,6 @@ export function getKanjiStats(db: DatabaseSync, limit = 100): KanjiStatsRow[] {
  return stmt.all(limit) as KanjiStatsRow[];
 }

-// Lines recorded before subtitle text was widened at ingest can still hold halfwidth
-// katakana; widen them on the way out so the dashboard and cards mined from it match
-// newer rows. Display-only: word identity columns stay as stored since they are keys.
-function widenLineText<T extends { text: string }>(row: T): T {
-  return { ...row, text: widenHalfwidthKana(row.text) };
-}
-
 export function getWordOccurrences(
  db: DatabaseSync,
  headword: string,
@@ -398,7 +390,7 @@ export function getWordOccurrences(
  limit = 100,
  offset = 0,
 ): WordOccurrenceRow[] {
-  const rows = db
+  return db
    .prepare(
      `
        SELECT
@@ -426,7 +418,6 @@ export function getWordOccurrences(
      `,
    )
    .all(headword, word, reading, limit, offset) as unknown as WordOccurrenceRow[];
-  return rows.map(widenLineText);
 }

 export function getKanjiOccurrences(
@@ -435,7 +426,7 @@ export function getKanjiOccurrences(
  limit = 100,
  offset = 0,
 ): KanjiOccurrenceRow[] {
-  const rows = db
+  return db
    .prepare(
      `
        SELECT
@@ -463,7 +454,6 @@ export function getKanjiOccurrences(
      `,
    )
    .all(kanji, limit, offset) as unknown as KanjiOccurrenceRow[];
-  return rows.map(widenLineText);
 }

 export function searchSubtitleSentences(
@@ -480,14 +470,6 @@ export function searchSubtitleSentences(
  const params: string[] = [];
  for (const term of terms) {
    const likeTerm = `%${escapeLikeTerm(term)}%`;
-    // Lines recorded before ingest widening can hold halfwidth katakana, so subtitle
-    // text is matched against the term's widened and narrowed forms as well.
-    const widenedTerm = widenHalfwidthKana(term);
-    const textLikeTerms = uniqueNonEmptyTerms([
-      term,
-      widenedTerm,
-      narrowFullwidthKana(widenedTerm),
-    ]).map((variant) => `%${escapeLikeTerm(variant)}%`);
    const headwords = getHeadwordCandidatesForSentenceSearchTerm(term, options);
    const headwordClause =
      headwords.length > 0
@@ -503,16 +485,16 @@ export function searchSubtitleSentences(
        : '';
    clauses.push(`
      (
-        ${textLikeTerms.map(() => "l.text LIKE ? ESCAPE '\\'").join(' OR ')}
+        l.text LIKE ? ESCAPE '\\'
        OR v.canonical_title LIKE ? ESCAPE '\\'
        OR COALESCE(a.canonical_title, '') LIKE ? ESCAPE '\\'
        ${headwordClause}
      )
    `);
-    params.push(...textLikeTerms, likeTerm, likeTerm, ...headwords);
+    params.push(likeTerm, likeTerm, likeTerm, ...headwords);
  }

-  const rows = db
+  return db
    .prepare(
      `
        SELECT
@@ -536,7 +518,6 @@ export function searchSubtitleSentences(
      `,
    )
    .all(...params, resolvedLimit) as unknown as SentenceSearchResultRow[];
-  return rows.map(widenLineText);
 }

 export function getSessionEvents(
@@ -18,6 +18,7 @@ import type {
 } from './types';
 import {
  ACTIVE_SESSION_METRICS_CTE,
+  SESSION_WORD_COUNTS_CTE,
  SESSION_WORD_COUNTS_SELECT,
  fromDbTimestamp,
  resolvedCoverBlobExpr,
@@ -16,6 +16,7 @@ import { deriveStoredPartOfSpeech } from '../tokenizer/part-of-speech';
 import {
  cleanupUnusedCoverArtBlobHash,
  findSharedCoverBlobHash,
+  toDbMs,
  toDbTimestamp,
 } from './query-shared';

@@ -9,7 +9,7 @@ import { ensureLexicalDailyRollupTables, markLexicalDailyRollupsReady } from './
 import { isVocabularyStatsRowVisible, type VocabularyVisibilityRow } from './vocabulary-visibility';
 import { SCHEMA_VERSION } from './types';
 import type { QueuedWrite, VideoMetadata, YoutubeVideoMetadata } from './types';
-import { toDbTimestamp } from './query-shared';
+import { toDbMs, toDbTimestamp } from './query-shared';

 export interface TrackerPreparedStatements {
  telemetryInsertStmt: ReturnType<DatabaseSync['prepare']>;
@@ -130,7 +130,6 @@ export {
  listSubtitleTracks as listJellyfinSubtitleTracksRuntime,
  resolvePlaybackPlan as resolveJellyfinPlaybackPlanRuntime,
  ticksToSeconds as jellyfinTicksToSecondsRuntime,
-  toJellyfinOriginalStreamUrl,
 } from './jellyfin';
 export { JellyfinRemoteSessionService } from './jellyfin-remote';
 export {
@@ -114,15 +114,23 @@ function createSubtitleSidebarSnapshotFixture(): SubtitleSidebarSnapshot {
 function createRegisterIpcDeps(overrides: Partial<IpcServiceDeps> = {}): IpcServiceDeps {
  return {
    onOverlayModalClosed: () => {},
+    openYomitanSettings: () => {},
+    quitApp: () => {},
    toggleDevTools: () => {},
+    getVisibleOverlayVisibility: () => false,
+    toggleVisibleOverlay: () => {},
    tokenizeCurrentSubtitle: async () => null,
    getCurrentSubtitleRaw: () => '',
+    getCurrentSubtitleAss: () => '',
    getSubtitleSidebarSnapshot: async () => createSubtitleSidebarSnapshotFixture(),
    getPlaybackPaused: () => false,
    getSubtitlePosition: () => null,
    getSubtitleStyle: () => null,
    saveSubtitlePosition: () => {},
+    getMecabStatus: () => ({ available: false, enabled: false, path: null }),
+    setMecabEnabled: () => {},
    handleMpvCommand: () => {},
+    getKeybindings: () => [],
    getSessionBindings: () => [],
    getConfiguredShortcuts: () => ({}),
    dispatchSessionAction: async () => {},
@@ -131,19 +139,23 @@ function createRegisterIpcDeps(overrides: Partial<IpcServiceDeps> = {}): IpcServ
    getOverlayNotificationPosition: () => 'top-right',
    getControllerConfig: () => createControllerConfigFixture(),
    saveControllerConfig: async () => {},
+    saveControllerPreference: async () => {},
    getSecondarySubMode: () => 'hover',
    getCurrentSecondarySub: () => '',
    focusMainWindow: () => {},
    activatePlaybackWindowForOverlayInteraction: () => false,
    runSubsyncManual: async () => ({ ok: true, message: 'ok' }),
+    getAnkiConnectStatus: () => false,
    getRuntimeOptions: () => [],
    setRuntimeOption: () => ({ ok: true }),
+    cycleRuntimeOption: () => ({ ok: true }),
    reportOverlayContentBounds: () => {},
    getAnilistStatus: () => ({}),
    clearAnilistToken: () => {},
    openAnilistSetup: () => {},
    getAnilistQueueStatus: () => ({}),
    retryAnilistQueueNow: async () => ({ ok: true, message: 'ok' }),
+    appendClipboardVideoToQueue: () => ({ ok: true, message: 'ok' }),
    getPlaylistBrowserSnapshot: async () => ({
      directoryPath: null,
      directoryAvailable: false,
@@ -300,17 +312,26 @@ test('registerIpcHandlers skips AniList update when manual mark watched has no a
 test('registerIpcHandlers rejects malformed runtime-option payloads', async () => {
  const { registrar, handlers } = createFakeIpcRegistrar();
  const calls: Array<{ id: string; value: unknown }> = [];
+  const cycles: Array<{ id: string; direction: 1 | -1 }> = [];
  registerIpcHandlers(
    {
      onOverlayModalClosed: () => {},
+      openYomitanSettings: () => {},
+      quitApp: () => {},
      toggleDevTools: () => {},
+      getVisibleOverlayVisibility: () => false,
+      toggleVisibleOverlay: () => {},
      tokenizeCurrentSubtitle: async () => null,
      getCurrentSubtitleRaw: () => '',
+      getCurrentSubtitleAss: () => '',
      getPlaybackPaused: () => null,
      getSubtitlePosition: () => null,
      getSubtitleStyle: () => null,
      saveSubtitlePosition: () => {},
+      getMecabStatus: () => ({ available: false, enabled: false, path: null }),
+      setMecabEnabled: () => {},
      handleMpvCommand: () => {},
+      getKeybindings: () => [],
      getSessionBindings: () => [],
      getConfiguredShortcuts: () => ({}),
      dispatchSessionAction: async () => {},
@@ -319,15 +340,21 @@ test('registerIpcHandlers rejects malformed runtime-option payloads', async () =
      getOverlayNotificationPosition: () => 'top-right',
      getControllerConfig: () => createControllerConfigFixture(),
      saveControllerConfig: () => {},
+      saveControllerPreference: () => {},
      getSecondarySubMode: () => 'hover',
      getCurrentSecondarySub: () => '',
      focusMainWindow: () => {},
      runSubsyncManual: async () => ({ ok: true, message: 'ok' }),
+      getAnkiConnectStatus: () => false,
      getRuntimeOptions: () => [],
      setRuntimeOption: (id, value) => {
        calls.push({ id, value });
        return { ok: true };
      },
+      cycleRuntimeOption: (id, direction) => {
+        cycles.push({ id, direction });
+        return { ok: true };
+      },
      getSubtitleSidebarSnapshot: async () => createSubtitleSidebarSnapshotFixture(),
      reportOverlayContentBounds: () => {},
      getAnilistStatus: () => ({}),
@@ -335,6 +362,7 @@ test('registerIpcHandlers rejects malformed runtime-option payloads', async () =
      openAnilistSetup: () => {},
      getAnilistQueueStatus: () => ({}),
      retryAnilistQueueNow: async () => ({ ok: true, message: 'ok' }),
+      appendClipboardVideoToQueue: () => ({ ok: true, message: 'ok' }),
      getPlaylistBrowserSnapshot: async () => ({
        directoryPath: null,
        directoryAvailable: false,
@@ -371,6 +399,16 @@ test('registerIpcHandlers rejects malformed runtime-option payloads', async () =
    { id: 'subtitle.annotation.jlpt', value: false },
  ]);

+  const cycleHandler = handlers.handle.get(IPC_CHANNELS.request.cycleRuntimeOption);
+  assert.ok(cycleHandler);
+  const invalidDirection = await cycleHandler!({}, 'anki.kikuFieldGrouping', 2);
+  assert.deepEqual(invalidDirection, {
+    ok: false,
+    error: 'Invalid runtime option cycle direction',
+  });
+  await cycleHandler!({}, 'anki.kikuFieldGrouping', -1);
+  assert.deepEqual(cycles, [{ id: 'anki.kikuFieldGrouping', direction: -1 }]);
+
  const getPlaybackPausedHandler = handlers.handle.get(IPC_CHANNELS.request.getPlaybackPaused);
  assert.ok(getPlaybackPausedHandler);
  assert.equal(getPlaybackPausedHandler!({}), null);
@@ -571,6 +609,7 @@ test('registerIpcHandlers records yomitan lookup when subtitle context recording
 test('registerIpcHandlers ignores malformed fire-and-forget payloads', () => {
  const { registrar, handlers } = createFakeIpcRegistrar();
  const saves: unknown[] = [];
+  const controllerSaves: unknown[] = [];
  const closedModals: unknown[] = [];
  const openedModals: unknown[] = [];
  registerIpcHandlers(
@@ -581,9 +620,14 @@ test('registerIpcHandlers ignores malformed fire-and-forget payloads', () => {
      onOverlayModalOpened: (modal) => {
        openedModals.push(modal);
      },
+      openYomitanSettings: () => {},
+      quitApp: () => {},
      toggleDevTools: () => {},
+      getVisibleOverlayVisibility: () => false,
+      toggleVisibleOverlay: () => {},
      tokenizeCurrentSubtitle: async () => null,
      getCurrentSubtitleRaw: () => '',
+      getCurrentSubtitleAss: () => '',
      getSubtitleSidebarSnapshot: async () => createSubtitleSidebarSnapshotFixture(),
      getPlaybackPaused: () => false,
      getSubtitlePosition: () => null,
@@ -591,7 +635,10 @@ test('registerIpcHandlers ignores malformed fire-and-forget payloads', () => {
      saveSubtitlePosition: (position) => {
        saves.push(position);
      },
+      getMecabStatus: () => ({ available: false, enabled: false, path: null }),
+      setMecabEnabled: () => {},
      handleMpvCommand: () => {},
+      getKeybindings: () => [],
      getSessionBindings: () => [],
      getConfiguredShortcuts: () => ({}),
      dispatchSessionAction: async () => {},
@@ -600,18 +647,24 @@ test('registerIpcHandlers ignores malformed fire-and-forget payloads', () => {
      getOverlayNotificationPosition: () => 'top-right',
      getControllerConfig: () => createControllerConfigFixture(),
      saveControllerConfig: () => {},
+      saveControllerPreference: (update) => {
+        controllerSaves.push(update);
+      },
      getSecondarySubMode: () => 'hover',
      getCurrentSecondarySub: () => '',
      focusMainWindow: () => {},
      runSubsyncManual: async () => ({ ok: true, message: 'ok' }),
+      getAnkiConnectStatus: () => false,
      getRuntimeOptions: () => [],
      setRuntimeOption: () => ({ ok: true }),
+      cycleRuntimeOption: () => ({ ok: true }),
      reportOverlayContentBounds: () => {},
      getAnilistStatus: () => ({}),
      clearAnilistToken: () => {},
      openAnilistSetup: () => {},
      getAnilistQueueStatus: () => ({}),
      retryAnilistQueueNow: async () => ({ ok: true, message: 'ok' }),
+      appendClipboardVideoToQueue: () => ({ ok: true, message: 'ok' }),
      getPlaylistBrowserSnapshot: async () => ({
        directoryPath: null,
        directoryAvailable: false,
@@ -645,6 +698,96 @@ test('registerIpcHandlers ignores malformed fire-and-forget payloads', () => {
  assert.deepEqual(openedModals, ['subsync', 'runtime-options']);
 });

+test('registerIpcHandlers awaits saveControllerPreference through request-response IPC', async () => {
+  const { registrar, handlers } = createFakeIpcRegistrar();
+  const controllerSaves: unknown[] = [];
+  registerIpcHandlers(
+    {
+      onOverlayModalClosed: () => {},
+      openYomitanSettings: () => {},
+      quitApp: () => {},
+      toggleDevTools: () => {},
+      getVisibleOverlayVisibility: () => false,
+      toggleVisibleOverlay: () => {},
+      tokenizeCurrentSubtitle: async () => null,
+      getCurrentSubtitleRaw: () => '',
+      getCurrentSubtitleAss: () => '',
+      getSubtitleSidebarSnapshot: async () => createSubtitleSidebarSnapshotFixture(),
+      getPlaybackPaused: () => false,
+      getSubtitlePosition: () => null,
+      getSubtitleStyle: () => null,
+      saveSubtitlePosition: () => {},
+      getMecabStatus: () => ({ available: false, enabled: false, path: null }),
+      setMecabEnabled: () => {},
+      handleMpvCommand: () => {},
+      getKeybindings: () => [],
+      getSessionBindings: () => [],
+      getConfiguredShortcuts: () => ({}),
+      dispatchSessionAction: async () => {},
+      getStatsToggleKey: () => 'Backquote',
+      getMarkWatchedKey: () => 'KeyW',
+      getOverlayNotificationPosition: () => 'top-right',
+      getControllerConfig: () => createControllerConfigFixture(),
+      saveControllerConfig: async () => {},
+      saveControllerPreference: async (update) => {
+        await Promise.resolve();
+        controllerSaves.push(update);
+      },
+      getSecondarySubMode: () => 'hover',
+      getCurrentSecondarySub: () => '',
+      focusMainWindow: () => {},
+      runSubsyncManual: async () => ({ ok: true, message: 'ok' }),
+      getAnkiConnectStatus: () => false,
+      getRuntimeOptions: () => [],
+      setRuntimeOption: () => ({ ok: true }),
+      cycleRuntimeOption: () => ({ ok: true }),
+      reportOverlayContentBounds: () => {},
+      getAnilistStatus: () => ({}),
+      clearAnilistToken: () => {},
+      openAnilistSetup: () => {},
+      getAnilistQueueStatus: () => ({}),
+      retryAnilistQueueNow: async () => ({ ok: true, message: 'ok' }),
+      appendClipboardVideoToQueue: () => ({ ok: true, message: 'ok' }),
+      getPlaylistBrowserSnapshot: async () => ({
+        directoryPath: null,
+        directoryAvailable: false,
+        directoryStatus: '',
+        directoryItems: [],
+        playlistItems: [],
+        playingIndex: null,
+        currentFilePath: null,
+      }),
+      appendPlaylistBrowserFile: async () => ({ ok: true, message: 'ok' }),
+      playPlaylistBrowserIndex: async () => ({ ok: true, message: 'ok' }),
+      removePlaylistBrowserIndex: async () => ({ ok: true, message: 'ok' }),
+      movePlaylistBrowserIndex: async () => ({ ok: true, message: 'ok' }),
+      onYoutubePickerResolve: async () => ({ ok: true, message: 'ok' }),
+    },
+    registrar,
+  );
+
+  const saveHandler = handlers.handle.get(IPC_CHANNELS.command.saveControllerPreference);
+  assert.ok(saveHandler);
+
+  await assert.rejects(async () => {
+    await saveHandler!({}, { preferredGamepadId: 12 });
+  }, /Invalid controller preference payload/);
+  await saveHandler!(
+    {},
+    {
+      preferredGamepadId: 'pad-1',
+      preferredGamepadLabel: 'Pad 1',
+    },
+  );
+
+  assert.deepEqual(controllerSaves, [
+    {
+      preferredGamepadId: 'pad-1',
+      preferredGamepadLabel: 'Pad 1',
+    },
+  ]);
+});
+
 test('registerIpcHandlers accepts per-controller profile config updates', async () => {
  const { registrar, handlers } = createFakeIpcRegistrar();
  const controllerSaves: unknown[] = [];
@@ -832,6 +975,76 @@ test('registerIpcHandlers forwards valid overlay notification actions', () => {
  ]);
 });

+test('registerIpcHandlers rejects malformed controller preference payloads', async () => {
+  const { registrar, handlers } = createFakeIpcRegistrar();
+  registerIpcHandlers(
+    {
+      onOverlayModalClosed: () => {},
+      openYomitanSettings: () => {},
+      quitApp: () => {},
+      toggleDevTools: () => {},
+      getVisibleOverlayVisibility: () => false,
+      toggleVisibleOverlay: () => {},
+      tokenizeCurrentSubtitle: async () => null,
+      getCurrentSubtitleRaw: () => '',
+      getCurrentSubtitleAss: () => '',
+      getSubtitleSidebarSnapshot: async () => createSubtitleSidebarSnapshotFixture(),
+      getPlaybackPaused: () => false,
+      getSubtitlePosition: () => null,
+      getSubtitleStyle: () => null,
+      saveSubtitlePosition: () => {},
+      getMecabStatus: () => ({ available: false, enabled: false, path: null }),
+      setMecabEnabled: () => {},
+      handleMpvCommand: () => {},
+      getKeybindings: () => [],
+      getSessionBindings: () => [],
+      getConfiguredShortcuts: () => ({}),
+      dispatchSessionAction: async () => {},
+      getStatsToggleKey: () => 'Backquote',
+      getMarkWatchedKey: () => 'KeyW',
+      getOverlayNotificationPosition: () => 'top-right',
+      getControllerConfig: () => createControllerConfigFixture(),
+      saveControllerConfig: async () => {},
+      saveControllerPreference: async () => {},
+      getSecondarySubMode: () => 'hover',
+      getCurrentSecondarySub: () => '',
+      focusMainWindow: () => {},
+      runSubsyncManual: async () => ({ ok: true, message: 'ok' }),
+      getAnkiConnectStatus: () => false,
+      getRuntimeOptions: () => [],
+      setRuntimeOption: () => ({ ok: true }),
+      cycleRuntimeOption: () => ({ ok: true }),
+      reportOverlayContentBounds: () => {},
+      getAnilistStatus: () => ({}),
+      clearAnilistToken: () => {},
+      openAnilistSetup: () => {},
+      getAnilistQueueStatus: () => ({}),
+      retryAnilistQueueNow: async () => ({ ok: true, message: 'ok' }),
+      appendClipboardVideoToQueue: () => ({ ok: true, message: 'ok' }),
+      getPlaylistBrowserSnapshot: async () => ({
+        directoryPath: null,
+        directoryAvailable: false,
+        directoryStatus: '',
+        directoryItems: [],
+        playlistItems: [],
+        playingIndex: null,
+        currentFilePath: null,
+      }),
+      appendPlaylistBrowserFile: async () => ({ ok: true, message: 'ok' }),
+      playPlaylistBrowserIndex: async () => ({ ok: true, message: 'ok' }),
+      removePlaylistBrowserIndex: async () => ({ ok: true, message: 'ok' }),
+      movePlaylistBrowserIndex: async () => ({ ok: true, message: 'ok' }),
+      onYoutubePickerResolve: async () => ({ ok: true, message: 'ok' }),
+    },
+    registrar,
+  );
+
+  const saveHandler = handlers.handle.get(IPC_CHANNELS.command.saveControllerPreference);
+  await assert.rejects(async () => {
+    await saveHandler!({}, { preferredGamepadId: 12 });
+  }, /Invalid controller preference payload/);
+});
+
 test('registerIpcHandlers exposes character dictionary selection handlers', async () => {
  const { registrar, handlers } = createFakeIpcRegistrar();
  const calls: number[] = [];
@@ -7,6 +7,7 @@ import type {
  ControllerConfigUpdate,
  PlaylistBrowserMutationResult,
  PlaylistBrowserSnapshot,
+  ControllerPreferenceUpdate,
  ResolvedControllerConfig,
  RuntimeOptionId,
  RuntimeOptionValue,
@@ -33,8 +34,10 @@ import { IPC_CHANNELS, type OverlayHostedModal } from '../../shared/ipc/contract
 import {
  parseMpvCommand,
  parseControllerConfigUpdate,
+  parseControllerPreferenceUpdate,
  parseOptionalForwardingOptions,
  parseOverlayHostedModal,
+  parseRuntimeOptionDirection,
  parseRuntimeOptionId,
  parseRuntimeOptionValue,
  parseSessionActionDispatchRequest,
@@ -68,9 +71,14 @@ export interface IpcServiceDeps {
    actionId: string,
    noteId?: number,
  ) => void | Promise<void>;
+  openYomitanSettings: () => void;
+  quitApp: () => void;
  toggleDevTools: () => void;
+  getVisibleOverlayVisibility: () => boolean;
+  toggleVisibleOverlay: () => void;
  tokenizeCurrentSubtitle: () => Promise<unknown>;
  getCurrentSubtitleRaw: () => string;
+  getCurrentSubtitleAss: () => string;
  getSubtitleSidebarSnapshot?: () => Promise<SubtitleSidebarSnapshot>;
  getSubtitleSidebarPlaybackState?: () => SubtitleSidebarPlaybackState;
  getSubtitleSidebarOpen?: () => boolean;
@@ -78,7 +86,14 @@ export interface IpcServiceDeps {
  getSubtitlePosition: () => unknown;
  getSubtitleStyle: () => unknown;
  saveSubtitlePosition: (position: SubtitlePosition) => void;
+  getMecabStatus: () => {
+    available: boolean;
+    enabled: boolean;
+    path: string | null;
+  };
+  setMecabEnabled: (enabled: boolean) => void;
  handleMpvCommand: (command: Array<string | number>) => void;
+  getKeybindings: () => unknown;
  getMpvInputBindings?: () => Promise<MpvInputBindingsSnapshot>;
  getSessionBindings?: () => CompiledSessionBinding[] | Promise<CompiledSessionBinding[]>;
  getConfiguredShortcuts: () => unknown;
@@ -88,6 +103,7 @@ export interface IpcServiceDeps {
  getOverlayNotificationPosition: () => string;
  getControllerConfig: () => ResolvedControllerConfig;
  saveControllerConfig: (update: ControllerConfigUpdate) => void | Promise<void>;
+  saveControllerPreference: (update: ControllerPreferenceUpdate) => void | Promise<void>;
  getSecondarySubMode: () => unknown;
  getCurrentSecondarySub: () => string;
  focusMainWindow: () => void;
@@ -109,8 +125,10 @@ export interface IpcServiceDeps {
  resolveMediaTimingReview?: (
    request: MediaTimingReviewResolveRequest,
  ) => MediaTimingReviewActionResult | Promise<MediaTimingReviewActionResult>;
+  getAnkiConnectStatus: () => boolean;
  getRuntimeOptions: () => unknown;
  setRuntimeOption: (id: RuntimeOptionId, value: RuntimeOptionValue) => unknown;
+  cycleRuntimeOption: (id: RuntimeOptionId, direction: 1 | -1) => unknown;
  reportOverlayContentBounds: (
    payload: unknown,
    senderWindow: ElectronBrowserWindow | null,
@@ -131,6 +149,7 @@ export interface IpcServiceDeps {
  getCharacterDictionaryManagerSnapshot?: () => Promise<unknown>;
  removeCharacterDictionaryManagedEntry?: (mediaId: number) => Promise<unknown>;
  moveCharacterDictionaryManagedEntry?: (mediaId: number, direction: 1 | -1) => Promise<unknown>;
+  appendClipboardVideoToQueue: () => { ok: boolean; message: string };
  getChangelogSnapshot?: (options?: { refresh?: boolean }) => Promise<ChangelogSnapshot>;
  getPlaylistBrowserSnapshot: () => Promise<PlaylistBrowserSnapshot>;
  appendPlaylistBrowserFile: (filePath: string) => Promise<PlaylistBrowserMutationResult>;
@@ -155,6 +174,15 @@ interface WindowLike {
  };
 }

+interface MecabTokenizerLike {
+  getStatus: () => {
+    available: boolean;
+    enabled: boolean;
+    path: string | null;
+  };
+  setEnabled: (enabled: boolean) => void;
+}
+
 interface MpvClientLike {
  currentSecondarySubText?: string;
 }
@@ -314,6 +342,7 @@ function parseMediaTimingReviewResolveRequest(

 export interface IpcDepsRuntimeOptions {
  getMainWindow: () => WindowLike | null;
+  getVisibleOverlayVisibility: () => boolean;
  onOverlayModalClosed: (
    modal: OverlayHostedModal,
    senderWindow: ElectronBrowserWindow | null,
@@ -335,8 +364,12 @@ export interface IpcDepsRuntimeOptions {
    actionId: string,
    noteId?: number,
  ) => void | Promise<void>;
+  openYomitanSettings: () => void;
+  quitApp: () => void;
+  toggleVisibleOverlay: () => void;
  tokenizeCurrentSubtitle: () => Promise<unknown>;
  getCurrentSubtitleRaw: () => string;
+  getCurrentSubtitleAss: () => string;
  getSubtitleSidebarSnapshot?: () => Promise<SubtitleSidebarSnapshot>;
  getSubtitleSidebarPlaybackState?: () => SubtitleSidebarPlaybackState;
  getSubtitleSidebarOpen?: () => boolean;
@@ -344,7 +377,9 @@ export interface IpcDepsRuntimeOptions {
  getSubtitlePosition: () => unknown;
  getSubtitleStyle: () => unknown;
  saveSubtitlePosition: (position: SubtitlePosition) => void;
+  getMecabTokenizer: () => MecabTokenizerLike | null;
  handleMpvCommand: (command: Array<string | number>) => void;
+  getKeybindings: () => unknown;
  getMpvInputBindings?: () => Promise<MpvInputBindingsSnapshot>;
  getSessionBindings?: () => CompiledSessionBinding[] | Promise<CompiledSessionBinding[]>;
  getConfiguredShortcuts: () => unknown;
@@ -354,6 +389,7 @@ export interface IpcDepsRuntimeOptions {
  getOverlayNotificationPosition: () => string;
  getControllerConfig: () => ResolvedControllerConfig;
  saveControllerConfig: (update: ControllerConfigUpdate) => void | Promise<void>;
+  saveControllerPreference: (update: ControllerPreferenceUpdate) => void | Promise<void>;
  getSecondarySubMode: () => unknown;
  getMpvClient: () => MpvClientLike | null;
  focusMainWindow: () => void;
@@ -367,8 +403,10 @@ export interface IpcDepsRuntimeOptions {
  getMediaTimingReviewWaveform?: IpcServiceDeps['getMediaTimingReviewWaveform'];
  stopMediaTimingReviewPreview?: IpcServiceDeps['stopMediaTimingReviewPreview'];
  resolveMediaTimingReview?: IpcServiceDeps['resolveMediaTimingReview'];
+  getAnkiConnectStatus: () => boolean;
  getRuntimeOptions: () => unknown;
  setRuntimeOption: (id: RuntimeOptionId, value: RuntimeOptionValue) => unknown;
+  cycleRuntimeOption: (id: RuntimeOptionId, direction: 1 | -1) => unknown;
  reportOverlayContentBounds: (payload: unknown) => void;
  getAnilistStatus: () => unknown;
  clearAnilistToken: () => void;
@@ -386,6 +424,7 @@ export interface IpcDepsRuntimeOptions {
  getCharacterDictionaryManagerSnapshot?: () => Promise<unknown>;
  removeCharacterDictionaryManagedEntry?: (mediaId: number) => Promise<unknown>;
  moveCharacterDictionaryManagedEntry?: (mediaId: number, direction: 1 | -1) => Promise<unknown>;
+  appendClipboardVideoToQueue: () => { ok: boolean; message: string };
  getChangelogSnapshot?: (options?: { refresh?: boolean }) => Promise<ChangelogSnapshot>;
  getPlaylistBrowserSnapshot: () => Promise<PlaylistBrowserSnapshot>;
  appendPlaylistBrowserFile: (filePath: string) => Promise<PlaylistBrowserMutationResult>;
@@ -405,14 +444,19 @@ export function createIpcDepsRuntime(options: IpcDepsRuntimeOptions): IpcService
    onOverlayMouseInteractionChanged: options.onOverlayMouseInteractionChanged,
    onOverlayInteractiveHint: options.onOverlayInteractiveHint,
    handleOverlayNotificationAction: options.handleOverlayNotificationAction,
+    openYomitanSettings: options.openYomitanSettings,
    recordSubtitleMiningContext: options.recordSubtitleMiningContext,
+    quitApp: options.quitApp,
    toggleDevTools: () => {
      const mainWindow = options.getMainWindow();
      if (!mainWindow || mainWindow.isDestroyed()) return;
      mainWindow.webContents.toggleDevTools();
    },
+    getVisibleOverlayVisibility: options.getVisibleOverlayVisibility,
+    toggleVisibleOverlay: options.toggleVisibleOverlay,
    tokenizeCurrentSubtitle: options.tokenizeCurrentSubtitle,
    getCurrentSubtitleRaw: options.getCurrentSubtitleRaw,
+    getCurrentSubtitleAss: options.getCurrentSubtitleAss,
    getSubtitleSidebarSnapshot: options.getSubtitleSidebarSnapshot,
    getSubtitleSidebarPlaybackState: options.getSubtitleSidebarPlaybackState,
    getSubtitleSidebarOpen: options.getSubtitleSidebarOpen ?? (() => false),
@@ -420,7 +464,19 @@ export function createIpcDepsRuntime(options: IpcDepsRuntimeOptions): IpcService
    getSubtitlePosition: options.getSubtitlePosition,
    getSubtitleStyle: options.getSubtitleStyle,
    saveSubtitlePosition: options.saveSubtitlePosition,
+    getMecabStatus: () => {
+      const mecabTokenizer = options.getMecabTokenizer();
+      return mecabTokenizer
+        ? mecabTokenizer.getStatus()
+        : { available: false, enabled: false, path: null };
+    },
+    setMecabEnabled: (enabled) => {
+      const mecabTokenizer = options.getMecabTokenizer();
+      if (!mecabTokenizer) return;
+      mecabTokenizer.setEnabled(enabled);
+    },
    handleMpvCommand: options.handleMpvCommand,
+    getKeybindings: options.getKeybindings,
    getMpvInputBindings: options.getMpvInputBindings,
    getSessionBindings: options.getSessionBindings ?? (() => []),
    getConfiguredShortcuts: options.getConfiguredShortcuts,
@@ -430,6 +486,7 @@ export function createIpcDepsRuntime(options: IpcDepsRuntimeOptions): IpcService
    getOverlayNotificationPosition: options.getOverlayNotificationPosition,
    getControllerConfig: options.getControllerConfig,
    saveControllerConfig: options.saveControllerConfig,
+    saveControllerPreference: options.saveControllerPreference,
    getSecondarySubMode: options.getSecondarySubMode,
    getCurrentSecondarySub: () => options.getMpvClient()?.currentSecondarySubText || '',
    focusMainWindow: () => {
@@ -446,8 +503,10 @@ export function createIpcDepsRuntime(options: IpcDepsRuntimeOptions): IpcService
    getMediaTimingReviewWaveform: options.getMediaTimingReviewWaveform,
    stopMediaTimingReviewPreview: options.stopMediaTimingReviewPreview,
    resolveMediaTimingReview: options.resolveMediaTimingReview,
+    getAnkiConnectStatus: options.getAnkiConnectStatus,
    getRuntimeOptions: options.getRuntimeOptions,
    setRuntimeOption: options.setRuntimeOption,
+    cycleRuntimeOption: options.cycleRuntimeOption,
    reportOverlayContentBounds: (payload, senderWindow) => {
      const mainWindow = options.getMainWindow();
      if (!mainWindow || mainWindow.isDestroyed()) return;
@@ -494,6 +553,7 @@ export function createIpcDepsRuntime(options: IpcDepsRuntimeOptions): IpcService
        message: 'Character dictionary manager unavailable.',
        entries: [],
      })),
+    appendClipboardVideoToQueue: options.appendClipboardVideoToQueue,
    getChangelogSnapshot: options.getChangelogSnapshot,
    getPlaylistBrowserSnapshot: options.getPlaylistBrowserSnapshot,
    appendPlaylistBrowserFile: options.appendPlaylistBrowserFile,
@@ -620,6 +680,10 @@ export function registerIpcHandlers(deps: IpcServiceDeps, ipc: IpcMainRegistrar
    },
  );

+  ipc.on(IPC_CHANNELS.command.openYomitanSettings, () => {
+    deps.openYomitanSettings();
+  });
+
  ipc.on(IPC_CHANNELS.command.recordYomitanLookup, (_event: unknown, payload: unknown) => {
    try {
      deps.recordSubtitleMiningContext?.(parseSubtitleMiningContext(payload));
@@ -647,10 +711,22 @@ export function registerIpcHandlers(deps: IpcServiceDeps, ipc: IpcMainRegistrar
    return marked;
  });

+  ipc.on(IPC_CHANNELS.command.quitApp, () => {
+    deps.quitApp();
+  });
+
  ipc.on(IPC_CHANNELS.command.toggleDevTools, () => {
    deps.toggleDevTools();
  });

+  ipc.on(IPC_CHANNELS.command.toggleOverlay, () => {
+    deps.toggleVisibleOverlay();
+  });
+
+  ipc.handle(IPC_CHANNELS.request.getVisibleOverlayVisibility, () => {
+    return deps.getVisibleOverlayVisibility();
+  });
+
  ipc.handle(IPC_CHANNELS.request.getCurrentSubtitle, async () => {
    return await deps.tokenizeCurrentSubtitle();
  });
@@ -659,6 +735,10 @@ export function registerIpcHandlers(deps: IpcServiceDeps, ipc: IpcMainRegistrar
    return deps.getCurrentSubtitleRaw();
  });

+  ipc.handle(IPC_CHANNELS.request.getCurrentSubtitleAss, () => {
+    return deps.getCurrentSubtitleAss();
+  });
+
  ipc.handle(IPC_CHANNELS.request.getSubtitleSidebarSnapshot, async () => {
    if (!deps.getSubtitleSidebarSnapshot) {
      throw new Error('Subtitle sidebar snapshot is unavailable.');
@@ -695,6 +775,17 @@ export function registerIpcHandlers(deps: IpcServiceDeps, ipc: IpcMainRegistrar
    deps.saveSubtitlePosition(parsedPosition);
  });

+  ipc.handle(
+    IPC_CHANNELS.command.saveControllerPreference,
+    async (_event: unknown, update: unknown) => {
+      const parsedUpdate = parseControllerPreferenceUpdate(update);
+      if (!parsedUpdate) {
+        throw new Error('Invalid controller preference payload');
+      }
+      await deps.saveControllerPreference(parsedUpdate);
+    },
+  );
+
  ipc.handle(
    IPC_CHANNELS.command.saveControllerConfig,
    async (_event: unknown, update: unknown) => {
@@ -706,6 +797,15 @@ export function registerIpcHandlers(deps: IpcServiceDeps, ipc: IpcMainRegistrar
    },
  );

+  ipc.handle(IPC_CHANNELS.request.getMecabStatus, () => {
+    return deps.getMecabStatus();
+  });
+
+  ipc.on(IPC_CHANNELS.command.setMecabEnabled, (_event: unknown, enabled: unknown) => {
+    if (typeof enabled !== 'boolean') return;
+    deps.setMecabEnabled(enabled);
+  });
+
  ipc.on(IPC_CHANNELS.command.mpvCommand, (_event: unknown, command: unknown) => {
    const parsedCommand = parseMpvCommand(command);
    if (!parsedCommand) return;
@@ -723,6 +823,10 @@ export function registerIpcHandlers(deps: IpcServiceDeps, ipc: IpcMainRegistrar
    },
  );

+  ipc.handle(IPC_CHANNELS.request.getKeybindings, () => {
+    return deps.getKeybindings();
+  });
+
  ipc.handle(IPC_CHANNELS.request.getMpvInputBindings, () => {
    return deps.getMpvInputBindings?.() ?? { keys: [], blockedKeys: [] };
  });
@@ -775,6 +879,10 @@ export function registerIpcHandlers(deps: IpcServiceDeps, ipc: IpcMainRegistrar
    return await deps.runSubsyncManual(parsedRequest);
  });

+  ipc.handle(IPC_CHANNELS.request.getAnkiConnectStatus, () => {
+    return deps.getAnkiConnectStatus();
+  });
+
  ipc.handle(IPC_CHANNELS.request.getRuntimeOptions, () => {
    return deps.getRuntimeOptions();
  });
@@ -791,6 +899,18 @@ export function registerIpcHandlers(deps: IpcServiceDeps, ipc: IpcMainRegistrar
    return deps.setRuntimeOption(parsedId, parsedValue);
  });

+  ipc.handle(IPC_CHANNELS.request.cycleRuntimeOption, (_event, id: unknown, direction: unknown) => {
+    const parsedId = parseRuntimeOptionId(id);
+    if (!parsedId) {
+      return { ok: false, error: 'Invalid runtime option id' };
+    }
+    const parsedDirection = parseRuntimeOptionDirection(direction);
+    if (!parsedDirection) {
+      return { ok: false, error: 'Invalid runtime option cycle direction' };
+    }
+    return deps.cycleRuntimeOption(parsedId, parsedDirection);
+  });
+
  ipc.on(IPC_CHANNELS.command.reportOverlayContentBounds, (event: unknown, payload: unknown) => {
    const senderWindow =
      electron.BrowserWindow?.fromWebContents((event as IpcMainEvent).sender) ?? null;
@@ -900,6 +1020,10 @@ export function registerIpcHandlers(deps: IpcServiceDeps, ipc: IpcMainRegistrar
    },
  );

+  ipc.handle(IPC_CHANNELS.request.appendClipboardVideoToQueue, () => {
+    return deps.appendClipboardVideoToQueue();
+  });
+
  ipc.handle(IPC_CHANNELS.request.getChangelogSnapshot, async (_event, payload: unknown) => {
    const refresh =
      typeof payload === 'object' && payload !== null && 'refresh' in payload
@@ -7,7 +7,6 @@ import {
  listSubtitleTracks,
  resolvePlaybackPlan,
  ticksToSeconds,
-  toJellyfinOriginalStreamUrl,
 } from './jellyfin';

 const clientInfo = {
@@ -863,26 +862,3 @@ test('resolvePlaybackPlan replaces a legacy api_key on the server transcoding ur
    globalThis.fetch = originalFetch;
  }
 });
-
-test('toJellyfinOriginalStreamUrl maps direct and transcoded playback to the original file', () => {
-  assert.equal(
-    toJellyfinOriginalStreamUrl(
-      'https://media.example/jf/videos/item-1/master.m3u8?ApiKey=token&MediaSourceId=src&VideoCodec=h264&StartTimeTicks=9',
-      'item-1',
-    ),
-    'https://media.example/jf/Videos/item-1/stream?static=true&ApiKey=token&MediaSourceId=src',
-  );
-  assert.equal(
-    toJellyfinOriginalStreamUrl(
-      'http://jf.local:8096/Videos/item-1/stream?static=true&api_key=legacy&AudioStreamIndex=2',
-      'item-1',
-    ),
-    'http://jf.local:8096/Videos/item-1/stream?static=true&ApiKey=legacy',
-  );
-  assert.equal(
-    toJellyfinOriginalStreamUrl('https://jf/Videos/other/stream?ApiKey=token', 'item-1'),
-    null,
-  );
-  assert.equal(toJellyfinOriginalStreamUrl('https://jf/Videos/item-1/stream', 'item-1'), null);
-  assert.equal(toJellyfinOriginalStreamUrl('/media/item-1.mkv', 'item-1'), null);
-});
@@ -254,29 +254,6 @@ function createDirectPlayUrl(
  return `${session.serverUrl}/Videos/${itemId}/stream?${query.toString()}`;
 }

-/**
- * Maps a playing stream URL of `itemId`, direct or transcoded, to its original file. Returns null
- * when the URL is not that item's stream or carries no access token.
- */
-export function toJellyfinOriginalStreamUrl(playbackUrl: string, itemId: string): string | null {
-  let url: URL;
-  try {
-    url = new URL(playbackUrl);
-  } catch {
-    return null;
-  }
-  const at = url.pathname.toLowerCase().indexOf(`/videos/${itemId.toLowerCase()}/`);
-  if (!/^https?:$/.test(url.protocol) || !itemId || at < 0) return null;
-  const param = (pattern: RegExp) =>
-    [...url.searchParams].find(([key, value]) => pattern.test(key) && value)?.[1];
-  const accessToken = param(/^api_?key$/i);
-  if (!accessToken) return null;
-  const query = new URLSearchParams({ static: 'true', ApiKey: accessToken });
-  const mediaSourceId = param(/^mediasourceid$/i);
-  if (mediaSourceId) query.set('MediaSourceId', mediaSourceId);
-  return `${url.origin}${url.pathname.slice(0, at)}/Videos/${itemId}/stream?${query.toString()}`;
-}
-
 function createTranscodeUrl(
  session: JellyfinAuthSession,
  itemId: string,
@@ -20,6 +20,7 @@ import {
  MPV_REQUEST_ID_SUB_SHADOW_OFFSET,
  MPV_REQUEST_ID_SUB_SPACING,
  MPV_REQUEST_ID_SUBTEXT,
+  MPV_REQUEST_ID_SUBTEXT_ASS,
  MPV_REQUEST_ID_SUB_USE_MARGINS,
  MPV_REQUEST_ID_PAUSE,
 } from './mpv-protocol';
@@ -53,6 +54,7 @@ const MPV_SUBTITLE_PROPERTY_OBSERVATIONS: string[] = [
  'sub-scale-by-window',
  'osd-height',
  'osd-dimensions',
+  'sub-text/ass',
  'sub-border-size',
  'sub-shadow-offset',
  'sub-ass-override',
@@ -74,6 +76,10 @@ const MPV_INITIAL_PROPERTY_REQUESTS: Array<MpvProtocolCommand> = [
    command: ['get_property', 'sub-text'],
    request_id: MPV_REQUEST_ID_SUBTEXT,
  },
+  {
+    command: ['get_property', 'sub-text/ass'],
+    request_id: MPV_REQUEST_ID_SUBTEXT_ASS,
+  },
  {
    command: ['get_property', 'path'],
    request_id: MPV_REQUEST_ID_PATH,
@@ -59,6 +59,7 @@ function createDeps(overrides: Partial<MpvProtocolHandleMessageDeps> = {}): {
      getSubtitleMetrics: () => metrics,
      isVisibleOverlayVisible: () => false,
      emitSubtitleChange: (payload) => state.events.push(payload),
+      emitSubtitleAssChange: (payload) => state.events.push(payload),
      emitSubtitleTiming: (payload) => state.events.push(payload),
      emitSecondarySubtitleChange: (payload) => state.events.push(payload),
      emitSubtitleTrackChange: (payload) => state.events.push(payload),
@@ -131,16 +132,26 @@ test('dispatchMpvProtocolMessage emits subtitle text on property change', async
  assert.deepEqual(state.events, [{ text: '字幕', isOverlayVisible: false }]);
 });

-test('dispatchMpvProtocolMessage widens halfwidth katakana in subtitle text', async () => {
+test('dispatchMpvProtocolMessage emits ASS subtitle text from the current mpv property', async () => {
  const { deps, state } = createDeps();

  await dispatchMpvProtocolMessage(
-    { event: 'property-change', name: 'sub-text', data: 'ｱﾝﾀがｱｰﾀﾙたん？' },
+    { event: 'property-change', name: 'sub-text/ass', data: '{\\b1}字幕' },
    deps,
  );

-  assert.equal(state.subText, 'アンタがアータルたん？');
-  assert.deepEqual(state.events, [{ text: 'アンタがアータルたん？', isOverlayVisible: false }]);
+  assert.deepEqual(state.events, [{ text: '{\\b1}字幕' }]);
+});
+
+test('dispatchMpvProtocolMessage emits ASS subtitle text from the legacy mpv property', async () => {
+  const { deps, state } = createDeps();
+
+  await dispatchMpvProtocolMessage(
+    { event: 'property-change', name: 'sub-text-ass', data: '{\\b1}字幕' },
+    deps,
+  );
+
+  assert.deepEqual(state.events, [{ text: '{\\b1}字幕' }]);
 });

 test('dispatchMpvProtocolMessage emits subtitle track changes', async () => {
@@ -1,6 +1,5 @@
 import { MpvSubtitleRenderMetrics } from '../../types';
 import { sanitizeMediaTitle } from '../../shared/media-identity';
-import { widenHalfwidthKana } from '../utils/halfwidth-kana';

 export type MpvMessage = {
  event?: string;
@@ -25,6 +24,7 @@ export const MPV_REQUEST_ID_SUB_FONT = 111;
 export const MPV_REQUEST_ID_SUB_SCALE_BY_WINDOW = 112;
 export const MPV_REQUEST_ID_OSD_HEIGHT = 113;
 export const MPV_REQUEST_ID_OSD_DIMENSIONS = 114;
+export const MPV_REQUEST_ID_SUBTEXT_ASS = 115;
 export const MPV_REQUEST_ID_SUB_SPACING = 116;
 export const MPV_REQUEST_ID_SUB_BOLD = 117;
 export const MPV_REQUEST_ID_SUB_ITALIC = 118;
@@ -52,6 +52,7 @@ export interface MpvProtocolHandleMessageDeps {
  getSubtitleMetrics: () => MpvSubtitleRenderMetrics;
  isVisibleOverlayVisible: () => boolean;
  emitSubtitleChange: (payload: { text: string; isOverlayVisible: boolean }) => void;
+  emitSubtitleAssChange: (payload: { text: string }) => void;
  emitSubtitleTiming: (payload: { text: string; start: number; end: number }) => void;
  emitSecondarySubtitleChange: (payload: { text: string }) => void;
  emitSubtitleTrackChange: (payload: { sid: number | null }) => void;
@@ -245,13 +246,15 @@ export async function dispatchMpvProtocolMessage(
 ): Promise<void> {
  if (msg.event === 'property-change') {
    if (msg.name === 'sub-text') {
-      const nextSubText = widenHalfwidthKana((msg.data as string) || '');
+      const nextSubText = (msg.data as string) || '';
      const overlayVisible = deps.isVisibleOverlayVisible();
      deps.emitSubtitleChange({
        text: nextSubText,
        isOverlayVisible: overlayVisible,
      });
      deps.setCurrentSubText(nextSubText);
+    } else if (msg.name === 'sub-text/ass' || msg.name === 'sub-text-ass') {
+      deps.emitSubtitleAssChange({ text: (msg.data as string) || '' });
    } else if (msg.name === 'sub-start') {
      deps.setCurrentSubStart((msg.data as number) || 0);
      deps.emitSubtitleTiming({
@@ -459,12 +462,14 @@ export async function dispatchMpvProtocolMessage(
        }>,
      );
    } else if (msg.request_id === MPV_REQUEST_ID_SUBTEXT) {
-      const nextSubText = widenHalfwidthKana((msg.data as string) || '');
+      const nextSubText = (msg.data as string) || '';
      deps.setCurrentSubText(nextSubText);
      deps.emitSubtitleChange({
        text: nextSubText,
        isOverlayVisible: deps.isVisibleOverlayVisible(),
      });
+    } else if (msg.request_id === MPV_REQUEST_ID_SUBTEXT_ASS) {
+      deps.emitSubtitleAssChange({ text: (msg.data as string) || '' });
    } else if (msg.request_id === MPV_REQUEST_ID_PATH) {
      deps.emitMediaPathChange({ path: (msg.data as string) || '' });
    } else if (msg.request_id === MPV_REQUEST_ID_MEDIA_TITLE) {
@@ -444,6 +444,17 @@ test('MpvIpcClient reconnect replays property subscriptions and initial state re
      (command as { command: unknown[] }).command[1] === 1 &&
      (command as { command: unknown[] }).command[2] === 'sub-text',
  );
+  const hasAssSubtitleSubscription = commands.some(
+    (command) =>
+      Array.isArray((command as { command: unknown[] }).command) &&
+      (command as { command: unknown[] }).command[0] === 'observe_property' &&
+      (command as { command: unknown[] }).command[2] === 'sub-text/ass',
+  );
+  const hasDeprecatedAssSubtitleProperty = commands.some(
+    (command) =>
+      Array.isArray((command as { command: unknown[] }).command) &&
+      (command as { command: unknown[] }).command.includes('sub-text-ass'),
+  );
  const hasPathRequest = commands.some(
    (command) =>
      Array.isArray((command as { command: unknown[] }).command) &&
@@ -453,6 +464,8 @@ test('MpvIpcClient reconnect replays property subscriptions and initial state re

  assert.equal(hasSecondaryVisibilityReset, true);
  assert.equal(hasTrackSubscription, true);
+  assert.equal(hasAssSubtitleSubscription, true);
+  assert.equal(hasDeprecatedAssSubtitleProperty, false);
  assert.equal(hasPathRequest, true);
 });

@@ -123,6 +123,7 @@ export interface MpvIpcClientDeps extends MpvIpcClientProtocolDeps {}
 export interface MpvIpcClientEventMap {
  'connection-change': { connected: boolean };
  'subtitle-change': { text: string; isOverlayVisible: boolean };
+  'subtitle-ass-change': { text: string };
  'subtitle-timing': { text: string; start: number; end: number };
  'time-pos-change': { time: number };
  'duration-change': { duration: number };
@@ -416,6 +417,9 @@ export class MpvIpcClient implements MpvClient {
      emitSubtitleChange: (payload) => {
        this.emit('subtitle-change', payload);
      },
+      emitSubtitleAssChange: (payload) => {
+        this.emit('subtitle-ass-change', payload);
+      },
      emitSubtitleTiming: (payload) => {
        this.emit('subtitle-timing', payload);
      },
@@ -74,6 +74,9 @@ export function updateVisibleOverlayVisibility(args: {
  overlayInteractionActive?: boolean;
  mainWindow: BrowserWindow | null;
  windowTracker: BaseWindowTracker | null;
+  lastKnownWindowsForegroundProcessName?: string | null;
+  windowsOverlayProcessName?: string | null;
+  windowsFocusHandoffGraceActive?: boolean;
  macOSForegroundProbeActive?: boolean;
  trackerNotReadyWarningShown: boolean;
  setTrackerNotReadyWarningShown: (shown: boolean) => void;
@@ -165,6 +168,26 @@ export function updateVisibleOverlayVisibility(args: {
    const shouldUseMacOSMousePassthrough = args.isMacOSPlatform && !overlayInteractionActive;
    const shouldDefaultToPassthrough =
      args.isWindowsPlatform || forceMousePassthrough || shouldReleaseMacOSOverlayLevel;
+    const windowsForegroundProcessName =
+      args.lastKnownWindowsForegroundProcessName?.trim().toLowerCase() ?? null;
+    const windowsOverlayProcessName = args.windowsOverlayProcessName?.trim().toLowerCase() ?? null;
+    const hasWindowsForegroundProcessSignal =
+      args.isWindowsPlatform && windowsForegroundProcessName !== null;
+    const isTrackedWindowsTargetFocused = args.windowTracker?.isTargetWindowFocused?.() ?? true;
+    const isTrackedWindowsTargetMinimized =
+      args.isWindowsPlatform &&
+      typeof args.windowTracker?.isTargetWindowMinimized === 'function' &&
+      args.windowTracker.isTargetWindowMinimized();
+    const shouldPreserveWindowsOverlayDuringFocusHandoff =
+      args.isWindowsPlatform &&
+      args.windowsFocusHandoffGraceActive === true &&
+      !!args.windowTracker &&
+      (!hasWindowsForegroundProcessSignal ||
+        windowsForegroundProcessName === 'mpv' ||
+        (windowsOverlayProcessName !== null &&
+          windowsForegroundProcessName === windowsOverlayProcessName)) &&
+      !isTrackedWindowsTargetMinimized &&
+      (args.windowTracker.isTracking() || args.windowTracker.getGeometry() !== null);
    const shouldForcePassiveReshow = args.isWindowsPlatform && !wasVisible;
    const isNonNativeOverlay = !args.isWindowsPlatform && !args.isMacOSPlatform;
    const isNonNativePassiveOverlay = isNonNativeOverlay && !overlayInteractionActive;
@@ -185,6 +208,13 @@ export function updateVisibleOverlayVisibility(args: {
      (isNonNativePassiveOverlay && !hasNonNativeInputRegion) ||
      (shouldDefaultToPassthrough && (!isVisibleOverlayFocused || shouldForcePassiveReshow));
    const shouldBindTrackedWindowsOverlay = args.isWindowsPlatform && !!args.windowTracker;
+    const shouldKeepTrackedWindowsOverlayTopmost =
+      !args.isWindowsPlatform ||
+      !args.windowTracker ||
+      isVisibleOverlayFocused ||
+      isTrackedWindowsTargetFocused ||
+      shouldPreserveWindowsOverlayDuringFocusHandoff ||
+      (hasWindowsForegroundProcessSignal && windowsForegroundProcessName === 'mpv');
    if (shouldIgnoreMouseEvents) {
      applyOverlayClickThrough(mainWindow, args.isWindowsPlatform);
    } else {
@@ -2,6 +2,7 @@ import test from 'node:test';
 import assert from 'node:assert/strict';
 import {
  applyRuntimeOptionResultRuntime,
+  cycleRuntimeOptionFromIpcRuntime,
  setRuntimeOptionFromIpcRuntime,
 } from './runtime-options-ipc';

@@ -24,3 +25,21 @@ test('setRuntimeOptionFromIpcRuntime returns unavailable when manager missing',
  assert.equal(result.error, 'Runtime options manager unavailable');
  assert.deepEqual(osd, []);
 });
+
+test('cycleRuntimeOptionFromIpcRuntime reports errors once', () => {
+  const osd: string[] = [];
+  const result = cycleRuntimeOptionFromIpcRuntime(
+    {
+      setOptionValue: () => ({ ok: true }),
+      cycleOption: () => ({ ok: false, error: 'bad option' }),
+    },
+    'anki.kikuFieldGrouping',
+    1,
+    (text) => {
+      osd.push(text);
+    },
+  );
+  assert.equal(result.ok, false);
+  assert.equal(result.error, 'bad option');
+  assert.deepEqual(osd, ['bad option']);
+});
@@ -34,3 +34,19 @@ export function setRuntimeOptionFromIpcRuntime(
  }
  return result;
 }
+
+export function cycleRuntimeOptionFromIpcRuntime(
+  manager: RuntimeOptionsManagerLike | null,
+  id: RuntimeOptionId,
+  direction: 1 | -1,
+  showMpvOsd: (text: string) => void,
+): RuntimeOptionApplyResult {
+  if (!manager) {
+    return { ok: false, error: 'Runtime options manager unavailable' };
+  }
+  const result = applyRuntimeOptionResultRuntime(manager.cycleOption(id, direction), showMpvOsd);
+  if (!result.ok && result.error) {
+    showMpvOsd(result.error);
+  }
+  return result;
+}
@@ -1,4 +1,5 @@
 import type { RuntimeOptionApplyResult, RuntimeOptionId } from '../../types';
+import type { SessionActionId } from '../../types/session-bindings';
 import type { SessionActionDispatchRequest } from '../../types/runtime';

 export interface SessionActionExecutorDeps {
@@ -8,7 +8,6 @@ import { clampMediaEndTime } from '../../../anki-integration/media-duration.js';
 import { MediaGenerator } from '../../../media-generator.js';
 import { statsJson } from '../../../types/stats-http-contract.js';
 import { STATS_MINING_TAG } from '../../../shared/anki-source.js';
-import { widenHalfwidthKana } from '../../utils/halfwidth-kana.js';
 import {
  resolveRetimedSecondarySubtitleTextFromSidecar,
  resolveSecondarySubtitleTextFromSidecar,
@@ -37,11 +36,8 @@ export function registerStatsMiningRoutes(app: Hono, options?: StatsMiningRouteO
    const sourcePath = typeof body?.sourcePath === 'string' ? body.sourcePath.trim() : '';
    const startMs = typeof body?.startMs === 'number' ? body.startMs : NaN;
    const endMs = typeof body?.endMs === 'number' ? body.endMs : NaN;
-    // Older stats rows can carry halfwidth katakana; cards get the fullwidth form that
-    // live mining produces, and the word is widened alongside so highlighting still hits.
-    const sentence =
-      typeof body?.sentence === 'string' ? widenHalfwidthKana(body.sentence.trim()) : '';
-    const word = typeof body?.word === 'string' ? widenHalfwidthKana(body.word.trim()) : '';
+    const sentence = typeof body?.sentence === 'string' ? body.sentence.trim() : '';
+    const word = typeof body?.word === 'string' ? body.word.trim() : '';
    const bodySecondaryText =
      typeof body?.secondaryText === 'string' ? body.secondaryText.trim() : '';
    const videoTitle = typeof body?.videoTitle === 'string' ? body.videoTitle.trim() : '';
@@ -1,4 +1,4 @@
-import { selectAll, type SyncDb } from './libsql-driver';
+import { selectAll, type SqlRow, type SyncDb } from './libsql-driver';
 import { nowDbTimestamp, tableExists, type SyncMergeSummary } from './shared';

 const LOCAL_DAY_EXPR = `CAST(julianday(CAST(started_at_ms AS REAL) / 1000, 'unixepoch', 'localtime') - 2440587.5 AS INTEGER)`;
@@ -1,6 +1,7 @@
 import assert from 'node:assert/strict';
 import test from 'node:test';
 import { parseSrtCues, parseAssCues, parseSubtitleCues } from './subtitle-cue-parser';
+import type { SubtitleCue } from '../../types';

 test('parseSrtCues parses basic SRT content', () => {
  const content = [
@@ -55,36 +56,6 @@ test('parseSrtCues strips HTML-like markup while preserving line breaks', () =>
  assert.equal(cues[0]!.text, 'これは\nテストです');
 });

-test('parseSubtitleCues widens halfwidth katakana in cue text', () => {
-  const cues = parseSubtitleCues(
-    '1\n00:00:01,000 --> 00:00:02,000\n(ﾄｰｶ)ﾀﾞｷﾆお姉ちゃん\n',
-    'ep.srt',
-  );
-
-  assert.equal(cues[0]?.text, '(トーカ)ダキニお姉ちゃん');
-});
-
-test('parseSubtitleCues merges cues that differ only in halfwidth katakana', () => {
-  const cues = parseSubtitleCues(
-    [
-      '1',
-      '00:00:01,000 --> 00:00:02,000',
-      '山ｶﾞｸ',
-      '',
-      '2',
-      '00:00:01,000 --> 00:00:02,000',
-      '山ガク',
-      '',
-    ].join('\n'),
-    'ep.srt',
-  );
-
-  assert.deepEqual(
-    cues.map((cue) => cue.text),
-    ['山ガク'],
-  );
-});
-
 test('parseSrtCues handles hours in timestamps', () => {
  const content = ['1', '01:30:00,000 --> 01:30:05,000', 'テスト', ''].join('\n');

@@ -9,7 +9,6 @@ import {
  type AssOverrideCommand,
 } from './ass-text';
 import { hasAssAnimationEvidence, mergeDuplicateCues } from './subtitle-cue-dedup';
-import { widenHalfwidthKana } from '../utils/halfwidth-kana';

 /** Vertical third of the screen a cue is authored to occupy. */
 export type AssVerticalBand = 'top' | 'middle' | 'bottom';
@@ -105,7 +104,7 @@ function decodeSubtitleCueText(text: string): string {
 }

 function sanitizeSubtitleCueText(text: string): string {
-  return widenHalfwidthKana(decodeSubtitleCueText(text)).trim();
+  return decodeSubtitleCueText(text).trim();
 }

 function sanitizeAssCueText(text: string): string {
@@ -2656,16 +2655,10 @@ function parseAnnotatedAssCues(content: string): AnnotatedSubtitleCue[] {
    removeAssFontTextureEvents(parseAnnotatedAssEvents(content, placement)),
    placement.playResY,
  );
-  const cues = mergeAssCaptionRows(
+  return mergeAssCaptionRows(
    recoverFragmentOnlyAssLines(recoverCanonicalAssEvents(events)),
    placement.playResY,
  );
-  // Widened after reconstruction, which works glyph by glyph, but before duplicate
-  // merging, so ｶﾞｸ and ガク authored for the same span collapse into one cue.
-  for (const cue of cues) {
-    cue.text = widenHalfwidthKana(cue.text);
-  }
-  return cues;
 }

 export function parseAssCues(content: string): SubtitleCue[] {
@@ -3,11 +3,6 @@ import { expandSubtitleGenerationPath } from './subtitle-generation-files';

 const OUTPUT_LIMIT = 64 * 1024;

-// ffmpeg echoes input URLs in its errors; streamed media carries access tokens in the query.
-function redactUrlCredentials(text: string): string {
-  return text.replace(/([?&](?:api_?key|token|access_token)=)[^&#\s'"]+/gi, '$1<redacted>');
-}
-
 // Keep partial lines between chunks: ffmpeg and whisper both report progress on stderr.
 export function runSubtitleGenerationProcess(input: {
  command: string;
@@ -68,11 +63,7 @@ export function runSubtitleGenerationProcess(input: {
      cleanup();
      if (input.signal?.aborted) reject(new Error('Subtitle generation cancelled.'));
      else if (code !== 0) {
-        reject(
-          new Error(
-            `${input.command} exited with status ${code}: ${redactUrlCredentials(stderr.trim())}`,
-          ),
-        );
+        reject(new Error(`${input.command} exited with status ${code}: ${stderr.trim()}`));
      } else resolve(stdout);
    });
  });
@@ -378,22 +378,7 @@ test('empty executable paths find tools on PATH and explicit overrides take prec
    }
  }));

-test('generation reads an HTTP stream as-is and saves to the requested output', () =>
-  fixture(async (directory) => {
-    const input = await generationFixture(directory);
-    const mediaPath = 'https://jellyfin.example/Videos/item/stream?static=true&ApiKey=secret';
-    const outputPath = path.join(directory, 'out', 'stream.ja.srt');
-    await mkdir(path.dirname(outputPath));
-    assert.equal(await generateJapaneseSubtitles({ ...input, mediaPath, outputPath }), outputPath);
-    const calls: string[][] = (await readFile(input.callsPath, 'utf8'))
-      .trim()
-      .split('\n')
-      .map((line) => JSON.parse(line));
-    assert.equal(calls[0]?.at(-1), mediaPath);
-    assert.equal(calls[1]?.[calls[1].indexOf('-i') + 1], mediaPath);
-  }));
-
-test('generation rejects remote media without an output path, missing models, and missing tools before starting a subprocess', () =>
+test('generation rejects remote media, missing models, and missing tools before starting a subprocess', () =>
  fixture(async (directory) => {
    const input = await generationFixture(directory);
    await assert.rejects(
@@ -488,17 +473,6 @@ test('process cancellation terminates work and bounds diagnostic output', () =>
        error.message.length < 66000 &&
        error.message.includes('status 7'),
    );
-    const unauthorized = await executable(
-      directory,
-      'unauthorized',
-      "process.stderr.write('https://host/Videos/1/stream?ApiKey=se+cr/et==&static=true: Server returned 401');process.exitCode=1;",
-    );
-    await assert.rejects(
-      runSubtitleGenerationProcess({ command: unauthorized, args: [] }),
-      (error: unknown) =>
-        error instanceof Error &&
-        error.message.includes('?ApiKey=<redacted>&static=true: Server returned 401'),
-    );
  }));

 test('download uses the pinned model revision and removes files that fail integrity', () =>
@@ -191,7 +191,6 @@ export async function requireSubtitleGenerationSetup(
 export async function generateJapaneseSubtitles(input: {
  config: SubtitleGenerationConfig;
  modelDirectory: string;
-  /** A local file, or an http(s) stream when `outputPath` is set. */
  mediaPath: string;
  audioStreamIndex?: number;
  references?: readonly SubtitleGenerationReference[];
@@ -202,12 +201,10 @@ export async function generateJapaneseSubtitles(input: {
  signal?: AbortSignal;
 }): Promise<string> {
  input.signal?.throwIfAborted();
-  // HTTP streams are read by ffmpeg directly but have no directory to save beside.
-  const remote = /^https?:\/\//i.test(input.mediaPath);
-  if (remote ? !input.outputPath : /^[a-z][a-z\d+.-]*:\/\//i.test(input.mediaPath))
+  if (/^[a-z][a-z\d+.-]*:\/\//i.test(input.mediaPath))
    throw new Error('Subtitle generation requires a local media file.');
-  const mediaPath = remote ? input.mediaPath : path.resolve(input.mediaPath);
-  if (!remote && !(await stat(mediaPath)).isFile())
+  const mediaPath = path.resolve(input.mediaPath);
+  if (!(await stat(mediaPath)).isFile())
    throw new Error('Subtitle generation requires a local media file.');
  if (input.outputPath) await ensureAvailableOutput(path.resolve(input.outputPath));
  await ensureWritableDirectory(
@@ -609,6 +609,14 @@ function getYomitanFrequencyRank(
    return null;
  }

+  const normalizedHeadword = token.headword.trim();
+  const normalizedSurface = token.surface.trim();
+  const isInflectedHeadwordFallback =
+    matchMode === 'headword' &&
+    normalizedCandidateText === normalizedHeadword &&
+    normalizedSurface.length > 0 &&
+    normalizedSurface !== normalizedHeadword;
+
  return selectBestYomitanFrequencyRank(candidateEntries);
 }

@@ -390,6 +390,23 @@ function isReduplicatedKanaSfx(text: string): boolean {
  return chars.slice(0, half).join('') === chars.slice(half).join('');
 }

+function isReduplicatedKanaSfxWithOptionalTrailingTo(text: string): boolean {
+  const normalized = normalizeKana(text);
+  if (!normalized) {
+    return false;
+  }
+
+  if (isReduplicatedKanaSfx(normalized)) {
+    return true;
+  }
+
+  if (normalized.length <= 1 || !normalized.endsWith('と')) {
+    return false;
+  }
+
+  return isReduplicatedKanaSfx(normalized.slice(0, -1));
+}
+
 function hasAdjacentKanaRepeat(text: string): boolean {
  const normalized = normalizeKana(text);
  if (!normalized) {
@@ -83,7 +83,7 @@ test('fresh Hachidori settings inherit deck, tags, a unique model and configured
  assert.deepEqual(await h.sync(), { updated: true, matched: true, pending: false });
  assert.deepEqual(
    await h.run('[options.anki.url, options.anki.deck, options.anki.model, options.anki.tags]'),
-    ['http://127.0.0.1:8766', 'Mining', 'Japanese', [...config.tags, 'hachidori']],
+    ['http://127.0.0.1:8766', 'Mining', 'Japanese', config.tags],
  );
  assert.deepEqual(
    await h.run(
@@ -102,16 +102,6 @@ test('fresh Hachidori settings inherit deck, tags, a unique model and configured
  assert.equal(await h.run('writes'), 1);
 });

-test('leaves tags edited in Hachidori settings alone', async () => {
-  const h = await harness({
-    templates: [
-      { id: 'default', name: 'Default', deck: 'Mining', model: 'Japanese', tags: ['SubMiner'] },
-    ],
-  });
-  await h.sync();
-  assert.deepEqual(await h.run('options.anki.tags'), ['SubMiner']);
-});
-
 // SubMiner's new-card polling only watches ankiConnect.deck, so the first
 // template's deck follows it the way Yomitan's term card deck does.
 test('moves the first template to the SubMiner deck and preserves the rest of custom templates', async () => {
@@ -49,10 +49,8 @@ export const HACHIDORI_ANKI_SETTINGS_SCRIPT = String.raw`
        // SubMiner's new-card polling only watches its configured deck, so the
        // first template follows it like Yomitan's term card deck.
        if (deck) template.deck = deck;
-        // SubMiner's tags join Hachidori's own so cards show which backend mined
-        // them. Only the untouched default is filled; edits in Hachidori settings win.
        if (hints?.tags && JSON.stringify(first.tags) === JSON.stringify(['hachidori'])) {
-          template.tags = [...new Set([...hints.tags, 'hachidori'])];
+          template.tags = [...hints.tags];
        }
        let pending = false;
        // Advanced templates include intentionally blank fields. Preserve them
@@ -38,6 +38,7 @@ function lookupResult(matched: string, expression: string, reading: string, dict
 type UploadReply = Record<string, unknown>;
 // The parts of vendor/hachidori/extension/linked-import.js the harness drives.
 type LinkedImportModule = {
+  ENGINE_BUSY_CODE: string;
  createUploadHost(options: {
    store: {
      append(token: string, data: string): void;
@@ -84,6 +85,7 @@ async function createHarness(emptyLibrary = false) {
  let proxyUrl: unknown;
  let loadingStatusReplies = 0;
  let busyEngineReplies = 0;
+  let busyCommits = 0;
  const uploads: Array<{ fileName: string; replace: boolean; bytes: Buffer }> = [];
  const apiModule: unknown = await import(
    pathToFileURL(path.join(extensionPath, 'api-host.js')).href
@@ -106,6 +108,10 @@ async function createHarness(emptyLibrary = false) {
      token: string,
      { fileName, replace }: { fileName: string; replace: boolean },
    ) => {
+      if (busyCommits > 0) {
+        busyCommits -= 1;
+        return { ok: false, error: 'busy', errorCode: linkedImportModule.ENGINE_BUSY_CODE };
+      }
      uploads.push({ fileName, replace, bytes: Buffer.concat(uploadParts.get(token) ?? []) });
      return { ok: true, report: { success: true } };
    },
@@ -274,6 +280,9 @@ async function createHarness(emptyLibrary = false) {
    setBusyEngineReplies: (count: number) => {
      busyEngineReplies = count;
    },
+    setBusyCommits: (count: number) => {
+      busyCommits = count;
+    },
    uploads: () => uploads,
  };
 }
@@ -532,6 +541,8 @@ test('Hachidori mining requests render native dictionary aliases and frequency m

 test('Hachidori settings automation uploads ZIP bytes as a replacement and removes the matching dictionary ID', async () => {
  const harness = await createHarness();
+  // The engine is mid-change for the first commit; the same upload must still land once.
+  harness.setBusyCommits(1);
  await harness.run(
    "__subminerYomitanSettingsAutomation.importDictionaryArchiveBase64('UEstdGVzdA==', 'characters.zip')",
  );
@@ -209,11 +209,20 @@ export const HACHIDORI_PARSER_BRIDGE_SCRIPT = String.raw`
      void invoke(action, params).then(result => callback({ result }), error => callback({ error: { message: error.message } }));
    };
    // Archives go through Hachidori's upload requests: an unlinked install imports
-    // the ZIP itself and a linked one forwards it to its host. The engine queues
-    // an import behind any dictionary change already running.
-    const sendUpload = (type, fields) => chrome.runtime.sendMessage({
-      target: 'hachidori-linked-import', type, requestId: crypto.randomUUID(), ...fields,
-    });
+    // the ZIP itself and a linked one forwards it to its host. A busy engine keeps
+    // the upload open, so the same commit is sent again.
+    const sendUpload = async (type, fields) => {
+      const deadline = Date.now() + 300000;
+      for (;;) {
+        const reply = await chrome.runtime.sendMessage({
+          target: 'hachidori-linked-import', type, requestId: crypto.randomUUID(), ...fields,
+        });
+        if (type !== 'hd_import_commit' || reply?.errorCode !== 'engine-mutating' || Date.now() >= deadline) {
+          return reply;
+        }
+        await sleep(500);
+      }
+    };
    async function importArchive(blob, fileName) {
      await waitForEngineReady();
      const reply = await uploadDictionary({ blob, fileName, replace: true, send: sendUpload });
@@ -1,12 +1,23 @@
 import { MergedToken, PartOfSpeech } from '../../../types';
-import { widenHalfwidthKana } from '../../utils/halfwidth-kana';

 const KATAKANA_TO_HIRAGANA_OFFSET = 0x60;
 const KATAKANA_CODEPOINT_START = 0x30a1;
 const KATAKANA_CODEPOINT_END = 0x30f6;

+// No `u` flag: the range is entirely BMP so it changes nothing here, and
+// Bun's unicode-mode matcher mis-handles this class next to certain ligatures.
+const HALFWIDTH_KANA_RUN = /[\uff66-\uff9f]+/g;
+
+// NFKC over the halfwidth kana only, never the whole string: it composes the
+// voiced pairs (ｶ + ﾞ) into single characters so ｶﾞｸ compares equal to ガク
+// instead of counting one character longer than the word it spells, but run
+// over everything it would also rewrite unrelated text (① → 1, ㍑ → リットル).
+function composeHalfwidthKana(text: string): string {
+  return text.replace(HALFWIDTH_KANA_RUN, (run) => run.normalize('NFKC'));
+}
+
 export function normalizeKana(text: string): string {
-  const raw = widenHalfwidthKana(text).trim();
+  const raw = composeHalfwidthKana(text).trim();
  if (!raw) {
    return '';
  }
@@ -872,9 +872,6 @@ async function serveDictionaryZipOnce<T>(
    }
    return await callback(`http://127.0.0.1:${address.port}${requestPath}`);
  } finally {
-    // The extension's fetch keeps its socket open; close() alone would wait out
-    // Node's keep-alive timeout before the import reports completion.
-    server.closeAllConnections();
    await new Promise<void>((resolve) => server.close(() => resolve()));
  }
 }
Author	SHA1	Message	Date
sudacode	c18644392d	fix(overlay): stop Hyprland/Sway tracker polls from blocking the main thread (#289 )	2026-10-11 01:02:02 -07:00
sudacode	9c351a8603	fix(overlay): poll cheap playback state in the open subtitle sidebar (#290 )	2026-10-11 01:02:02 -07:00
sudacode	6c295586cb	fix(hachidori): close an open pane after its attention is released	2026-10-11 00:54:01 -07:00
sudacode	0523beef2b	fix(hachidori): treat only an open pane as an open popup for lookup controls	2026-10-11 00:44:07 -07:00
sudacode	06fc578830	Merge remote-tracking branch 'origin/main' into add-hachidori-backend # Conflicts: # src/renderer/handlers/keyboard.test.ts	2026-10-11 00:35:19 -07:00
sudacode	994483ccd6	build(hachidori): bump fork to a52694c (LF checkouts on Windows)	2026-10-10 22:39:29 -07:00
sudacode	6350ee928d	build(hachidori): bump fork to 15babde - Update vendor/hachidori submodule from 343e861 to 15babde - Remove stale generated release/release-notes.md from v0.20.1	2026-10-10 21:21:46 -07:00
sudacode	4d1adebf11	refactor(hachidori): drop the Docker management upload for character dictionaries Every supported host now takes dictionary ZIPs over the link, so remove the port 8780 upload, its hachidori.externalHostManagementUrl override and the hachidori config section. A linked host without linked-import-v1 now reports the update or manual-import fix.	2026-10-05 09:50:52 -07:00
sudacode	e1c4d6ca94	feat(hachidori): send character dictionaries over the link to Hachidori hosts Hachidori 0.2.3 accepts dictionary ZIPs as chunked upload requests: an unlinked install imports them itself and a linked one forwards them to its host. The parser bridge now imports through that path with replace, retrying a busy commit with the same upload. Linked hosts without linked-import-v1 (hachidori-docker, older Hachidori) keep the management API upload.	2026-10-05 09:10:33 -07:00
sudacode	e25d472d82	build(hachidori): bump fork to upstream 0.2.3 (991c48c)	2026-10-05 09:03:39 -07:00
sudacode	20f151482a	Merge remote-tracking branch 'origin/main' into add-hachidori-backend # Conflicts: # launcher/main.test.ts # src/cli/help.test.ts # src/core/services/__tests__/stats-server.test.ts # src/core/services/cli-command.test.ts # src/core/services/tokenizer/yomitan-parser-runtime.test.ts # src/main/overlay-runtime.test.ts # src/main/runtime/character-dictionary-auto-sync.test.ts # src/main/runtime/cli-command-context-deps.test.ts # src/main/runtime/cli-command-context-factory.test.ts # src/main/runtime/cli-command-context-main-deps.test.ts # src/main/runtime/composers/cli-startup-composer.test.ts # src/main/runtime/stats-server-runtime.test.ts # src/main/runtime/tray-main-actions.test.ts # src/main/runtime/tray-main-deps.test.ts # src/main/runtime/tray-runtime-handlers.test.ts # src/main/runtime/tray-runtime.test.ts # src/main/runtime/yomitan-anki-server-sync.test.ts # src/preload.ts # src/renderer/handlers/mouse.test.ts # src/renderer/yomitan-popup.test.ts	2026-10-05 09:01:11 -07:00
sudacode	170dbbb74c	fix(overlay): treat Hachidori popup host as a lookup target for keys - Match the Hachidori shadow-root host alongside the Yomitan popup host when routing keyboard events - Update the keyboard test stub to use HACHIDORI_HOST_SELECTOR	2026-10-04 00:59:04 -07:00
sudacode	37d3f5e03e	build(hachidori): bump fork to upstream 9e1dfa3	2026-10-04 00:22:41 -07:00
sudacode	55c751830e	build(hachidori): bump fork to upstream 0.2.2 (2a063cd)	2026-10-04 00:04:31 -07:00
sudacode	3091d7b2a7	fix(overlay): forward imported mpv input while Hachidori only claims attention Hachidori's popup-shown event also fires for any press that may start a selection, so treating it as an open popup blocked imported mpv mouse buttons and routed every key to the popup keybind handler. Once Hachidori is the reader, forwarding, popup key routing and the controller lookup state now require an unhidden popup pane. Wheel events over an in-document dictionary popup stay with the popup. Bump vendor/hachidori so presses outside a text box no longer start a glyph drag that prevented the press.	2026-10-01 23:56:14 -07:00
sudacode	4423dd56af	Merge remote-tracking branch 'origin/main' into add-hachidori-backend	2026-10-01 21:48:59 -07:00
sudacode	a6df21bdc2	feat(overlay): forward mpv mouse and wheel bindings through overlay - Accept WHEEL_UP/DOWN/LEFT/RIGHT (with modifiers) in keybindings, the plugin, and the settings key editor - Forward mpv's MBTN_* and WHEEL_* bindings from the overlay so double-click fullscreen, wheel volume, and similar inputs work on Hyprland; SubMiner bindings and right-click pause still win - Notify the overlay via mpv-input-bindings:changed when mpv's key set changes, fixing dead imported keys when the overlay loads before mpv connects - Sync README requirements/quick start with the installation guide and fix the Arch MeCab install command (AUR mecab-git)	2026-10-01 01:16:44 -07:00
sudacode	e5a6e3b178	Merge remote-tracking branch 'origin/main' into add-hachidori-backend	2026-09-30 20:52:27 -07:00
sudacode	152d2c0626	Merge remote-tracking branch 'origin/main' into add-hachidori-backend	2026-09-30 19:50:36 -07:00
sudacode	bbb0e9b6a5	Merge remote-tracking branch 'origin/main' into add-hachidori-backend	2026-09-30 01:37:19 -07:00
sudacode	e09a416422	Merge remote-tracking branch 'origin/main' into add-hachidori-backend	2026-09-29 23:00:07 -07:00
sudacode	42f86b0748	perf(subtitle-prefetch): sweep overlap spans instead of rescanning cues - Track active cues with a single sorted start/end sweep across boundaries - Join simultaneous cues in cue-list order to match mpv - Skip empty or inverted cues - Add test for multi-cue overlap spans with unsorted cue input	2026-09-29 22:17:10 -07:00
sudacode	e69cd5ea06	Merge remote-tracking branch 'origin/main' into add-hachidori-backend	2026-09-29 20:31:17 -07:00
sudacode	0cff52f8e4	Merge remote-tracking branch 'origin/main' into add-hachidori-backend	2026-09-29 20:27:55 -07:00
sudacode	b52692d826	feat(hachidori): derive Docker management URL from the linked host - Default character dictionary uploads to the linked host on port 8780; externalHostManagementUrl is now an optional override - Warn when the override points at a different machine than the link - Browser/app hosts report where to import the merged ZIP manually - Name the management origin when the upload request cannot connect - Update config descriptions, generated examples, docs, and changelog fragment	2026-09-29 20:22:07 -07:00
sudacode	4ab5e37bc5	build(hachidori): bump fork to 32e5346	2026-09-29 19:03:07 -07:00
sudacode	f00b830054	Merge remote-tracking branch 'origin/main' into add-hachidori-backend	2026-09-29 18:49:49 -07:00
sudacode	ec73157f37	build(deps): revert fast-uri override to 3.1.7 - Pin the fast-uri override in package.json and bun.lock back to 3.1.7 from 3.1.8	2026-09-28 22:37:29 -07:00
sudacode	45212c7659	build(hachidori): bump fork to upstream 6faca95 Upstream dropped Firefox, so the overlay copy now turns off custom JavaScript from its plain capability flag. The Anki audio fixture follows the removal of media capture options.	2026-09-28 21:42:37 -07:00
sudacode	b710822db2	build(deps): bump fast-uri override to 3.1.8 for audit advisories	2026-09-28 21:18:38 -07:00
sudacode	b347fdf21a	feat(youtube): add YouTube browser window and Whisper subtitle source - Add `subminer youtube`/`yt` and tray "Browse YouTube" window that plays or queues picked videos in mpv - Add `youtube.subtitleSource` (`youtube` \| `whisper`) to transcribe YouTube audio via subtitle generation - Allow the subtitle generation modal on YouTube videos - Pick the real Japanese track over machine-translated ones and fall back to yt-dlp on HTTP 429 - Remove legacy launcher youtubeSubgen/whisper/AI args and `--youtube-mode` - Fix EPIPE crash when the launching terminal is closed with Ctrl+C - Thin media timing review handles with orange original-boundary bars - Update docs and change fragments	2026-09-28 20:46:11 -07:00
sudacode	a4325740b7	fix(subtitle-prefetch): reuse startup runs and prefetch overlap lines - Warm combined text for overlapping subtitle cues. - Preserve valid in-flight tokenization across startup restarts while rejecting invalidated cache results.	2026-09-28 01:17:59 -07:00
sudacode	4648c5e5a1	chore(hachidori): update submodule to upstream 1a12326 Merge 8 upstream Hachidori commits into the subminer fork, including the Google Docs experimental lookup, monochrome image palette colours and Anki deferred-audio fixes.	2026-09-25 23:02:23 -07:00
sudacode	72d0b19d94	Merge remote-tracking branch 'origin/main' into add-hachidori-backend	2026-09-24 21:33:27 -07:00
sudacode	c627095e6e	Merge remote-tracking branch 'origin/main' into add-hachidori-backend	2026-09-24 20:43:02 -07:00
sudacode	dea1136170	Merge remote-tracking branch 'origin/main' into add-hachidori-backend # Conflicts: # docs-site/anki-integration.md # docs-site/immersion-tracking.md # docs-site/shortcuts.md # docs-site/usage.md	2026-09-24 17:26:30 -07:00
sudacode	874d2c9f1a	fix(hachidori): preserve setup completion while host connects - Reopen setup only when a reachable host has no dictionaries	2026-09-24 14:02:27 -07:00
sudacode	52fc1b63e9	fix(launcher): validate login shell paths before execution - Fall back to absolute default shells when configured values are relative - Reject invalid shells before spawning them	2026-09-24 01:31:27 -07:00
sudacode	da5074761f	fix(launcher): load macOS login shell PATH for GUI launches	2026-09-24 01:10:15 -07:00
sudacode	f7230db90c	chore(release): prepare v0.20.0 - Build v0.20.0 changelog and release notes from changes/ fragments - Remove package-size JSON reports and previous-release size comparisons from CI - Download AUR release assets via curl with retries and skip publish on failure - Update release docs, verification lanes, and workflow tests to match	2026-09-24 00:01:03 -07:00
sudacode	92ef305e8c	chore(hachidori): update submodule to fork subminer 441971b Pull in the fork fix that looks up popup definition text only when the pointer is on a glyph, so hovering beside a short glossary row no longer opens a nested popup for the next row's word.	2026-09-23 22:59:10 -07:00
sudacode	504faa51e0	fix(anki): honor overlay pause that races timing review setup - Track overlay pauses per review request so a pause arriving while setup reads mpv's pause state still cancels the playback restore - Ignore cancelPlaybackResume when no review request is in flight - Add a test covering the pause-read race and reset between requests	2026-09-23 20:08:01 -07:00
sudacode	c10174f9cd	fix(dictionary): pin Hachidori extension ID with a static manifest key Electron derives an unpacked extension's ID from its directory, so a changed userData path gave Hachidori a new storage origin and an empty library. The staged copy now carries a fixed key, like the bundled Yomitan.	2026-09-23 09:15:33 -07:00
sudacode	33e694bc61	fix(anki): keep playback paused after overlay pause during timing review - Treat overlay pause requests during an open media timing review as final: drop held resumes and the review's own playback restore - Add cancelPlaybackResume to the media timing review runtime - Test both paused and playing starting states	2026-09-23 01:36:11 -07:00
sudacode	430120cc63	fix(anki): hold playback paused while media timing review is open - Defer overlay resume requests (popup closed, hover left) during an active review and apply them when the review closes - Add deferPlaybackResume to the media timing review runtime and gate sendRendererMpvCommand on it - Document the paused-playback behavior and add a changelog fragment	2026-09-23 00:32:35 -07:00
sudacode	294e3a777e	chore(hachidori): update submodule to upstream d68089e Merge 104 upstream Hachidori commits into the subminer fork, including rebuilt engine artifacts and upstream glyph hover hit-testing.	2026-09-22 22:42:05 -07:00
sudacode	c673b71053	fix(dictionary): restore Anki proxy marker when Hachidori sync fails - Revert the proxy marker to its previous value when every settings write attempt fails, so it no longer claims a server that was never written - Add a test for the all-writes-fail path - Retry Windows managed runtime cleanup in the test while bun.exe stays locked after exit	2026-09-22 22:08:51 -07:00
sudacode	d31a28c54f	fix(dictionary): handle Hachidori extension load failures gracefully - Catch errors from the Hachidori extension runtime and log them - Clear the extension and session state and return null instead of rejecting	2026-09-22 21:54:49 -07:00
sudacode	d100789232	fix(anki): regenerate sentence furigana when mined context changes - Regenerate SentenceFurigana from the final sentence after timing-review expansion or stats-dashboard word mining - Add a Yomitan parseText-based generator with a 10s timeout and escaped, highlighted output - Clear stale furigana on failure so templates fall back to Sentence - Keep existing furigana formatting when the sentence is unchanged - Document the behavior in the anki-integration and immersion-tracking docs	2026-09-22 21:46:06 -07:00
sudacode	9a5fb02cbd	fix(dictionary): sync Hachidori deck to ankiConnect.deck for polling - Always set the first Hachidori Anki template deck to ankiConnect.deck so polling mode enriches Hachidori cards; other custom template settings stay intact - Treat right-clicks retargeted to the Hachidori popup shadow host as overlay interactions so they no longer raise mpv or toggle pause - Update anki-integration docs and changelog fragment	2026-09-22 21:43:53 -07:00
sudacode	2ba820f41a	fix(dictionary): keep Hachidori lookup highlight on in SubMiner builds Hachidori's overlay-mode first-install options turn off "Highlight the word on the page" because GSM-style hosts screenshot the see-through viewport. SubMiner captures media from mpv, and without the highlight the subtitle sidebar gave no sign of which word was looked up or where the match ended. The staged copy now seeds the highlight on; the fork source is unchanged.	2026-09-22 21:06:19 -07:00
sudacode	c39dbb5a8d	fix(overlay): keep Hachidori attention from pausing playback Hachidori's hachidori-popup-shown/hidden pair means "the reader needs mouse events", which includes a left press anywhere on the overlay that may start a selection. SubMiner treated it as popup visibility, so a click paused and resumed mpv, and holding the button kept it paused. The host element only exists after the first lookup, so the first attempt (gate on an open popup pane when a host exists) still paused on clicks before any lookup. Once a Hachidori event has been seen, popup auto-pause now requires an unhidden popup pane in the host's shadow root, and rechecks after each successful lookup so drag-select popups still pause.	2026-09-22 21:06:19 -07:00
sudacode	2958591ec9	fix(dictionary): open Hachidori hover popups only over subtitle glyphs Pin the Hachidori fork fix that stops the caret snapping into the line box from looking up a subtitle's first word when the pointer is beside the line, which kept the popup open and playback paused.	2026-09-22 20:39:35 -07:00
sudacode	c9880efee3	test(anilist): apply sqlite pragmas in cover art fetcher tests - Call applyPragmas before ensureSchema so test databases match the production setup	2026-09-22 19:30:31 -07:00
sudacode	f225ac3c89	fix(dictionary): block --yomitan when an external profile is configured - Keep read-only external-profile mode while Hachidori is active by checking the configured externalProfilePath - Hachidori settings remain available - Smoke check asserts the external-profile block, with a --bundled-yomitan path for the bundled case - Update usage docs and changelog fragment	2026-09-22 19:03:39 -07:00
sudacode	cacaa2b371	feat(overlay): add subtitle selection modal and Jellyfin 12 fixes - Add an optional subtitle selection modal for primary/secondary mpv tracks (subtitleSelection.enabled, g-s sequence shortcut) with key-sequence conflict handling - Authenticate Jellyfin URLs with the ApiKey query, answer remote keep-alives, clear now-playing on stop, and restore episode titles in Anki misc info - Honor the configured mpv executable when Jellyfin starts playback via a shared mpv-process launcher - Bump electron-builder to 26.16.1 - Condense and reconcile changelog fragments; update config example and docs	2026-09-22 18:51:59 -07:00
sudacode	9fe4c7eb33	fix(anki): preserve managed proxy state when settings sync fails	2026-09-22 15:49:24 -07:00
sudacode	ab5e50adac	fix(dictionary): complete Hachidori imports and mining integration	2026-09-22 15:01:23 -07:00
sudacode	15c74ef502	fix(dictionary): update Hachidori overlay sharing and test fixes	2026-09-22 14:26:32 -07:00
sudacode	f0d3c95b4c	fix(dictionary): pin Hachidori stats mining fix	2026-09-22 14:04:09 -07:00
sudacode	d7e1d7edc6	refactor: configure Hachidori in the SubMiner build	2026-09-22 12:26:37 -07:00
sudacode	5354fdf7b9	refactor(dictionary): use Hachidori fork submodule and upstream API	2026-09-22 01:22:14 -07:00
sudacode	d9fdc7ef6d	feat(dictionary): add Hachidori backend support - Add backend selection, setup gating, Anki integration, and external host support - Add launcher flags, documentation, packaging, and focused tests - Open on-demand overlay modals on the first attempt	2026-09-22 00:21:19 -07:00