feat(parser): 增强 ABC 解析器以支持小节级别的歌词处理

- 新增 SNMeasureLyric 接口，定义小节级别的歌词信息，包括歌词段号和音节数组。
- 更新 SNMeasureMeta 接口，添加 lyrics 字段以支持多段歌词的存储。
- 优化 AbcParser 和 AbcMeasureParser，确保小节的歌词信息能够正确解析和组织。
- 更新歌词解析逻辑，移除歌词行和注释行，提升解析准确性。

该变更提升了 ABC 解析器对小节级别歌词的处理能力，确保乐谱信息的准确解析和存储。

Author: Encaik

packages/simple-notation/src/data/model/parser.ts

@@ -73,11 +73,21 @@ export interface SNVoiceMeta {
 
 export type SNVoiceMetaClef = 'treble' | 'bass' | 'alto' | 'tenor';
 
+/** 小节级别的歌词信息 */
+export interface SNMeasureLyric {
+  /** 歌词段号（0 = w:, 1+ = W:） */
+  verse: number;
+  /** 该小节的所有歌词音节 */
+  syllables: string[];
+}
+
 export interface SNMeasureMeta {
   annotations?: SNAnnotation[];
   chords?: SNParserChord[];
   barline?: SNBarline[];
   /** 行内声部标记 [V:数字]，表示从该小节开始属于指定声部 */
   voiceId?: string;
+  /** 小节级别的歌词（支持多段歌词） */
+  lyrics?: SNMeasureLyric[];
   [key: string]: unknown;
 }

packages/simple-notation/src/data/parser/abc-parser.ts

@@ -294,10 +294,11 @@ export class AbcParser extends BaseParser<SNAbcInput> {
     // 提取歌词
     const lyricLines = this.lyricParser.extractLyricLines(measuresContent);
 
-    // 移除声部标记和歌词行
+    // 移除声部标记、歌词行和注释行
     const musicContent = measuresContent
       .replace(/\[\s*V:\s*\d+\s*\]/g, '')
       .replace(/^\s*[wW]:\s*.*$/gim, '')
+      .replace(/^\s*%.*$/gim, '') // 移除注释行
       .trim();
 
     // 分割小节

packages/simple-notation/src/data/parser/abc/parsers/lyric-parser.ts

@@ -231,10 +231,11 @@ export class AbcLyricParser {
         let measureCountBefore = 0;
         let musicLineIndex = lineIndex - 1;
 
-        // 向前查找最近的音乐行
+        // 向前查找最近的音乐行（跳过歌词行、注释行和空行）
         while (
           musicLineIndex >= 0 &&
           (/^\s*[wW]:/i.test(lines[musicLineIndex]) ||
+            /^\s*%/.test(lines[musicLineIndex]) ||
             !lines[musicLineIndex].trim())
         ) {
           musicLineIndex--;
@@ -243,7 +244,12 @@ export class AbcLyricParser {
         // 统计之前所有音乐行的小节数
         for (let i = 0; i < musicLineIndex; i++) {
           const prevLine = lines[i];
-          if (!/^\s*[wW]:/i.test(prevLine) && prevLine.trim()) {
+          // 跳过歌词行、注释行和空行
+          if (
+            !/^\s*[wW]:/i.test(prevLine) &&
+            !/^\s*%/.test(prevLine) &&
+            prevLine.trim()
+          ) {
             const lineWithoutRepeats = prevLine
               .replace(/\|:/g, '')
               .replace(/:\|/g, '');

packages/simple-notation/src/data/parser/abc/parsers/measure-parser.ts

@@ -101,6 +101,11 @@ export class AbcMeasureParser {
       measureMeta.voiceId = measureVoiceId;
     }
 
+    // 将该小节的歌词信息添加到 meta 中（支持多段歌词）
+    if (lyricsForMeasure && lyricsForMeasure.length > 0) {
+      measureMeta.lyrics = this.organizeLyricsByVerse(lyricsForMeasure);
+    }
+
     // 如果小节数据中包含行内调号标记，将其存储到小节的 props 中
     if (keySignature) {
       measure.props = {
@@ -218,6 +223,32 @@ export class AbcMeasureParser {
     return elements;
   }
 
+  /**
+   * 将歌词按 verse 组织（用于存储在小节 meta 中）
+   *
+   * @param lyricsForMeasure - 该小节的所有歌词信息
+   * @returns 按 verse 分组的歌词数组
+   */
+  private organizeLyricsByVerse(lyricsForMeasure: LyricInfo[]): Array<{
+    verse: number;
+    syllables: string[];
+  }> {
+    // 按 verse 分组
+    const verseMap = new Map<number, string[]>();
+
+    for (const lyric of lyricsForMeasure) {
+      if (!verseMap.has(lyric.verse)) {
+        verseMap.set(lyric.verse, []);
+      }
+      verseMap.get(lyric.verse)!.push(lyric.syllable);
+    }
+
+    // 转换为数组并排序
+    return Array.from(verseMap.entries())
+      .sort((a, b) => a[0] - b[0])
+      .map(([verse, syllables]) => ({ verse, syllables }));
+  }
+
   /**
    * 将歌词附加到元素
    */