feat: add Japanese Furigana support to lyrics display (#2161)

src/main/features/core/lyrics/furigana.ts

@@ -0,0 +1,37 @@
+import Kuroshiro from 'kuroshiro';
+import KuromojiAnalyzer from 'kuroshiro-analyzer-kuromoji';
+
+// doc: https://kuroshiro.org
+
+let kuroshiroInstance: any = null;
+let initPromise: null | Promise<void> = null;
+
+const getKuroshiro = async () => {
+    if (kuroshiroInstance) return kuroshiroInstance;
+    if (initPromise) {
+        await initPromise;
+        return kuroshiroInstance;
+    }
+
+    const KuroshiroClass = (Kuroshiro as any).default || Kuroshiro;
+    kuroshiroInstance = new KuroshiroClass();
+    initPromise = kuroshiroInstance.init(new KuromojiAnalyzer());
+    await initPromise;
+    return kuroshiroInstance;
+};
+
+export const convertFurigana = async (text: string): Promise<string> => {
+    const KuroshiroClass = (Kuroshiro as any).default || Kuroshiro;
+
+    // check if the text contains any Japanese kana (to distinguish Japanese from Chinese text, which shares Kanji)
+    // If no Japanese kana is detected, skip processing
+    if (!KuroshiroClass.Util.hasKana(text)) return text;
+
+    try {
+        const kuroshiro = await getKuroshiro();
+        return await kuroshiro.convert(text, { mode: 'furigana', to: 'hiragana' });
+    } catch (e) {
+        console.error('Furigana conversion error: ', e);
+        return text;
+    }
+};

src/main/features/core/lyrics/index.ts

@@ -1,6 +1,7 @@
 import { ipcMain } from 'electron';
 
 import { store } from '../settings';
+import { convertFurigana } from './furigana';
 import { getLyricsBySongId as getGenius, getSearchResults as searchGenius } from './genius';
 import { getLyricsBySongId as getLrcLib, getSearchResults as searchLrcLib } from './lrclib';
 import { getLyricsBySongId as getNetease, getSearchResults as searchNetease } from './netease';
@@ -231,3 +232,7 @@ ipcMain.handle('lyric-by-remote-id', async (_event, params: LyricGetQuery) => {
     const lyricResults = await getRemoteLyricsById(params);
     return lyricResults;
 });
+
+ipcMain.handle('lyric-convert-furigana', async (_event, text: string) => {
+    return await convertFurigana(text);
+});