@applemusic-like-lyrics/core 0.4.2 → 0.5.1

package/dist/amll-core.d.mts

@@ -368,7 +368,30 @@ declare class Spring {
   getCurrentPosition(): number;
 }
 //#endregion
-//#region src/lyric-player/bottom-line.d.ts
+//#region src/lyric-player/dom/interlude-dots.d.ts
+declare class InterludeDots implements HasElement, Disposable {
+  private element;
+  private dot0;
+  private dot1;
+  private dot2;
+  private left;
+  private top;
+  private playing;
+  private lastStyle;
+  private currentInterlude?;
+  private currentTime;
+  private targetBreatheDuration;
+  constructor();
+  getElement(): HTMLElement;
+  setTransform(left?: number, top?: number): void;
+  setInterlude(interlude?: [number, number]): void;
+  pause(): void;
+  resume(): void;
+  update(delta?: number): void;
+  dispose(): void;
+}
+//#endregion
+//#region src/lyric-player/base/bottom-line.d.ts
 interface LineTransforms$1 {
   posX: Spring;
   posY: Spring;
@@ -397,51 +420,210 @@ declare class BottomLineEl implements HasElement, Disposable {
   dispose(): void;
 }
 //#endregion
-//#region src/lyric-player/dom/interlude-dots.d.ts
-declare class InterludeDots implements HasElement, Disposable {
-  private element;
-  private dot0;
-  private dot1;
-  private dot2;
-  private left;
-  private top;
-  private playing;
-  private lastStyle;
-  private currentInterlude?;
-  private currentTime;
-  private targetBreatheDuration;
-  constructor();
-  getElement(): HTMLElement;
-  setTransform(left?: number, top?: number): void;
-  setInterlude(interlude?: [number, number]): void;
-  pause(): void;
-  resume(): void;
-  update(delta?: number): void;
+//#region src/lyric-player/base/consts.d.ts
+type ValueOf<T extends Record<PropertyKey, unknown>> = T[keyof T];
+/** 歌词中不雅用语的掩码模式 */
+declare const MaskObsceneWordsMode: {
+  /** 禁用任何不雅用语掩码 */readonly Disabled: ""; /** 完全掩码所有不雅用语 */
+  readonly FullMask: "full-mask"; /** 保留首尾字符，屏蔽中间字符 */
+  readonly PartialMask: "partial-mask";
+};
+/** 歌词中不雅用语的掩码模式枚举类型，见 {@link MaskObsceneWordsMode} */
+type MaskObsceneWordsMode = ValueOf<typeof MaskObsceneWordsMode>;
+/**
+* 歌词行的渲染模式
+* @internal
+*/
+declare const LyricLineRenderMode: {
+  readonly SOLID: 0;
+  readonly GRADIENT: 1;
+};
+/**
+* 歌词行的渲染模式枚举类型，见 {@link LyricLineRenderMode}
+* @internal
+*/
+type LyricLineRenderMode = ValueOf<typeof LyricLineRenderMode>;
+/** 布局对齐锚点 */
+declare const LayoutAlignAnchor: {
+  readonly Top: "top";
+  readonly Center: "center";
+  readonly Bottom: "bottom";
+};
+/** 布局对齐锚点枚举类型，见 {@link LayoutAlignAnchor} */
+type LayoutAlignAnchor = ValueOf<typeof LayoutAlignAnchor>;
+//#endregion
+//#region src/lyric-player/base/line.d.ts
+interface LineTransforms {
+  scale: Spring;
+}
+/**
+* 所有标准歌词行的基类
+* @internal
+*/
+declare abstract class LyricLineBase extends EventTarget implements Disposable {
+  protected top: number;
+  protected scale: number;
+  protected blur: number;
+  protected opacity: number;
+  protected delay: number;
+  readonly lineTransforms: LineTransforms;
+  /**
+  * 用于 CJK 词语边界检测的分词器
+  */
+  static readonly wordSegmenter: Intl.Segmenter | null;
+  /**
+  * Unicode 标准的全局 Grapheme Cluster 分词器
+  * 用于正确处理 emoji、复合字符等
+  */
+  static readonly graphemeSegmenter: Intl.Segmenter | null;
+  abstract getLine(): LyricLine;
+  abstract enable(time?: number, shouldPlay?: boolean): void;
+  abstract disable(): void;
+  abstract resume(): void;
+  abstract pause(): void;
+  abstract onLineSizeChange(size: [number, number]): void;
+  setTransform(scale?: number, opacity?: number, blur?: number, _force?: boolean, delay?: number, _mode?: LyricLineRenderMode): void;
+  rebuildElement(): void;
+  /**
+  * 判定歌词是否可以应用强调辉光效果
+  *
+  * 果子在对辉光效果的解释是一种强调（emphasized）效果
+  *
+  * 条件是一个单词时长大于等于 1s 且长度小于等于 7
+  *
+  * @param word 单词
+  * @returns 是否可以应用强调辉光效果
+  */
+  static shouldEmphasize(word: LyricWord): boolean;
+  abstract update(delta?: number): void;
   dispose(): void;
 }
 //#endregion
-//#region src/lyric-player/base.d.ts
+//#region src/lyric-player/base/group.d.ts
+interface LyricPlayerFlags {
+  getEnableSpring(): boolean;
+  getEnableScale(): boolean;
+  getIsPlaying(): boolean;
+  getAlwaysPostpositionBackground(): boolean;
+}
+declare abstract class LyricLineGroupBase<T extends LyricLineBase = LyricLineBase> implements Disposable {
+  mainLine: T;
+  bgLine?: T | undefined;
+  protected abstract readonly lyricPlayer: LyricPlayerFlags;
+  posY: Spring;
+  bgSlideY: Spring;
+  top: number;
+  delay: number;
+  isActive: boolean;
+  opacity: number;
+  blur: number;
+  isBgFirst: boolean;
+  constructor(mainLine: T, bgLine?: T | undefined);
+  get startTime(): number;
+  get endTime(): number;
+  onLineSizeChange(size: [number, number]): void;
+  setTransform(top: number, force: boolean, delay: number, isActive: boolean, opacity: number, blur: number): void;
+  private setLineTransformations;
+  protected abstract renderStyles(): void;
+  abstract get isInSight(): boolean;
+  update(delta: number): void;
+  rebuildAllLines(): void;
+  enable(time?: number, shouldPlay?: boolean): void;
+  disable(): void;
+  dispose(): void;
+}
+//#endregion
+//#region src/lyric-player/base/layout.d.ts
 /**
-* 歌词播放器的基类，已经包含了有关歌词操作和排版的功能，子类需要为其实现对应的显示展示操作
+* 播放器布局状态。
+*
+* 这部分状态保存布局计算阶段所需的配置项与缓存值，
+* 例如对齐方式、间奏点尺寸、上一轮布局命中的目标行等。
+* 不描述播放时间线或用户滚动交互，仅记录当前歌词排布。
+*/
+interface PlayerLayoutState {
+  /** 间奏点元素当前测量得到的尺寸 */
+  interludeDotsSize: [number, number];
+  /** 上一轮布局实际对齐的目标歌词行索引 */
+  targetAlignIndex: number;
+  /** 上一轮布局时是否处于间奏区间 */
+  lastInterludeState: boolean;
+  /** 当前歌词目标行的对齐锚点 */
+  alignAnchor: LayoutAlignAnchor;
+  /** 当前歌词目标行在播放器高度中的相对对齐位置 */
+  alignPosition: number;
+  /** 视口上下额外保留的预渲染距离，单位为像素 */
+  overscanPx: number;
+}
+//#endregion
+//#region src/lyric-player/base/scroll.d.ts
+/**
+* 播放器滚动状态。
+*
+* 这部分状态描述用户手势/滚轮滚动产生的临时偏移，以及当前允许滚动的范围。
+* 改状态仅记录用户如何把当前视图上下拖动，不决定应该滚动到哪一行，
+* 后者由时间线状态与布局计算共同决定。
+*/
+interface PlayerScrollState {
+  /** 允许的滚动偏移范围 */
+  scrollBoundary: {
+    /** 允许的最小偏移量 */minOffset: number; /** 允许的最大偏移量 */
+    maxOffset: number;
+  };
+  /** 当前用户滚动带来的额外偏移量 */
+  scrollOffset: number;
+  /** 是否允许用户通过手势或滚轮滚动歌词视图 */
+  allowScroll: boolean;
+  /** 是否处于用户滚动过，尚未回归自动对齐的状态 */
+  isScrolled: boolean;
+  /** 是否正在进行滚动交互或惯性滚动 */
+  isUserScrolling: boolean;
+}
+//#endregion
+//#region src/lyric-player/base/timeline.d.ts
+/**
+* 播放时间线状态。
+*
+* 描述播放器在时间轴上的当前位置，当前处于激活状态的歌词组信息
+*/
+interface PlayerTimelineState {
+  /** 当前播放时间，单位为毫秒 */
+  currentTime: number;
+  /** 上一次提交到时间线状态的播放时间，单位为毫秒 */
+  lastCurrentTime: number;
+  /** 热行：当前时间 {@link currentTime} 正在命中的组（含主行+可能的背景行） */
+  hotGroups: Set<number>;
+  /** 缓冲组：UI 上还保持激活表现的组索引，通常包含热组，和刚结束仍在过渡中的组 */
+  bufferedGroups: Set<number>;
+  /** 当前应滚动对齐到的歌词组索引 */
+  scrollToIndex: number;
+  /** 是否正在拖拽进度条。若是，更新时丢弃缓冲行，并根据当前时间直接计算热行 */
+  isSeeking: boolean;
+  /** 是否处于播放状态 */
+  isPlaying: boolean;
+  /** 是否已经完成至少一次初始布局 */
+  initialLayoutFinished: boolean;
+}
+//#endregion
+//#region src/lyric-player/base/index.d.ts
+/**
+* 歌词播放器的基类，已经包含了有关歌词操作和排版的功能，
+* 子类需要为其实现对应的显示展示操作
 */
 declare abstract class LyricPlayerBase extends EventTarget implements HasElement, Disposable {
   protected element: HTMLElement;
   abstract get baseFontSize(): number;
-  protected currentTime: number;
-  /** @internal */
-  lyricLinesSize: WeakMap<LyricLineBase, [number, number]>;
+  /** 播放时间线状态 */
+  protected timelineState: PlayerTimelineState;
   /** @internal */
-  lyricLineElementMap: WeakMap<Element, LyricLineBase>;
+  lyricGroupElementMap: WeakMap<Element, LyricLineGroupBase>;
   protected currentLyricLines: LyricLine[];
   protected processedLines: LyricLine[];
   protected lyricLinesIndexes: WeakMap<LyricLineBase, number>;
-  protected hotLines: Set<number>;
-  protected bufferedLines: Set<number>;
   protected isNonDynamic: boolean;
   protected hasDuetLine: boolean;
-  protected scrollToIndex: number;
   protected disableSpring: boolean;
-  protected interludeDotsSize: [number, number];
+  protected layoutState: PlayerLayoutState;
   protected interludeDots: InterludeDots;
   protected bottomLine: BottomLineEl;
   protected enableBlur: boolean;
@@ -449,28 +631,14 @@ declare abstract class LyricPlayerBase extends EventTarget implements HasElement
   protected maskObsceneWords: MaskObsceneWordsMode;
   protected maskObsceneWordChar: string;
   protected hidePassedLines: boolean;
-  protected scrollBoundary: [number, number];
-  protected currentLyricLineObjects: LyricLineBase[];
-  protected isSeeking: boolean;
-  protected lastCurrentTime: number;
-  protected alignAnchor: "top" | "bottom" | "center";
-  protected alignPosition: number;
-  protected scrollOffset: number;
+  protected scrollState: PlayerScrollState;
+  currentLyricGroups: LyricLineGroupBase[];
+  lyricGroupSize: WeakMap<LyricLineGroupBase, [number, number]>;
   readonly size: [number, number];
-  protected allowScroll: boolean;
   protected isPageVisible: boolean;
   protected optimizeOptions: OptimizeLyricOptions;
-  protected initialLayoutFinished: boolean;
-  /**
-  * 标记用户是否正在进行滚动交互
-  */
-  protected isUserScrolling: boolean;
-  protected wheelTimeout: ReturnType<typeof setTimeout> | undefined;
-  /**
-  * 视图额外预渲染（overscan）距离，单位：像素。
-  * 用于决定在视口之外多少距离内也认为是“可见”，以便提前创建/保留行元素。
-  */
-  protected overscanPx: number;
+  /** 是否强制让背景人声行始终后置（即始终在主歌词下方显示，不前置背景人声） */
+  protected alwaysPostpositionBackground: boolean;
   protected posXSpringParams: Partial<SpringParams>;
   protected posYSpringParams: Partial<SpringParams>;
   protected scaleSpringParams: Partial<SpringParams>;
@@ -478,16 +646,12 @@ declare abstract class LyricPlayerBase extends EventTarget implements HasElement
   private onPageShow;
   private onPageHide;
   private scrolledHandler;
-  protected isScrolled: boolean;
   /** @internal */
   resizeObserver: ResizeObserver;
   protected wordFadeWidth: number;
-  protected targetAlignIndex: number;
-  protected lastInterludeState: boolean;
   constructor(element?: HTMLElement);
   private beginScrollHandler;
   private endScrollHandler;
-  private limitScrollOffset;
   /**
   * 设置文字动画的渐变宽度，单位以歌词行的主文字字体大小的倍数为单位，默认为 0.5，即一个全角字符的一半宽度
   *
@@ -556,7 +720,7 @@ declare abstract class LyricPlayerBase extends EventTarget implements HasElement
   * - 设置成 `center` 的话将会向目标歌词行的垂直中心对齐
   * @param alignAnchor 歌词行对齐方式，详情见函数说明
   */
-  setAlignAnchor(alignAnchor: "top" | "bottom" | "center"): void;
+  setAlignAnchor(alignAnchor: LayoutAlignAnchor): void;
   /**
   * 设置默认的歌词行对齐位置，相对于整个歌词播放组件的大小位置，默认为 `0.5`
   * @param alignPosition 一个 `[0.0-1.0]` 之间的任意数字，代表组件高度由上到下的比例位置
@@ -583,15 +747,6 @@ declare abstract class LyricPlayerBase extends EventTarget implements HasElement
   */
   getEnableSpring(): boolean;
   /**
-  * 获取当前播放时间里是否处于间奏区间
-  * 如果是则会返回单位为毫秒的始末时间
-  * 否则返回 undefined
-  *
-  * 这个只允许内部调用
-  * @returns [开始时间,结束时间,大概处于的歌词行ID,下一句是否为对唱歌词] 或 undefined 如果不处于间奏区间
-  */
-  protected getCurrentInterlude(): [number, number, number, boolean] | undefined;
-  /**
   * 设置歌词的优化配置项，这些配置项默认全部开启
   *
   * 注意，如果在 `setLyricLines` 之后修改此配置，需要重新调用 `setLyricLines()` 才能对当前歌词生效
@@ -611,14 +766,14 @@ declare abstract class LyricPlayerBase extends EventTarget implements HasElement
   */
   getIsPlaying(): boolean;
   /**
-  * 设置当前播放进度，单位为毫秒且**必须是整数**，此时将会更新内部的歌词进度信息
-  * 内部会根据调用间隔和播放进度自动决定如何滚动和显示歌词，所以这个的调用频率越快越准确越好
+  * 设置当前播放进度，此时将会更新内部的歌词进度信息。
+  *
+  * 内部会根据调用间隔和播放进度自动决定如何滚动和显示歌词，所以这个的调用频率越快越准确越好。
+  * 调用完成后，应每帧调用 {@link update} 方法来执行歌词动画效果。**此函数本身不会触发动画效果**。
   *
-  * 调用完成后，可以每帧调用 `update` 函数来执行歌词动画效果
   * @param time 当前播放进度，单位为毫秒
   */
   setCurrentTime(time: number, isSeek?: boolean): void;
-  protected updateDynamicSpringParams(): void;
   /**
   * 重新布局定位歌词行的位置，调用完成后再逐帧调用 `update`
   * 函数即可让歌词通过动画移动到目标位置。
@@ -637,7 +792,6 @@ declare abstract class LyricPlayerBase extends EventTarget implements HasElement
   * @param force 是否绕过弹簧效果强制更新位置
   */
   calcLayout(sync?: boolean, force?: boolean): Promise<void>;
-  protected calculateBlur(itemIndex: number, isActive: boolean, latestIndex: number): number;
   /**
   * 设置所有歌词行在横坐标上的弹簧属性，包括重量、弹力和阻力。
   *
@@ -657,7 +811,6 @@ declare abstract class LyricPlayerBase extends EventTarget implements HasElement
   * @param params 需要设置的弹簧属性，提供的属性将会覆盖原来的属性，未提供的属性将会保持原样
   */
   setLineScaleSpringParams(params?: Partial<SpringParams>): void;
-  protected isPlaying: boolean;
   /**
   * 暂停部分效果演出，目前会暂停播放间奏点的动画，且将背景歌词显示出来
   */
@@ -704,58 +857,22 @@ declare abstract class LyricPlayerBase extends EventTarget implements HasElement
   * @returns 当前播放位置
   */
   getCurrentTime(): number;
-  getElement(): HTMLElement;
-  dispose(): void;
-}
-interface LineTransforms {
-  posY: Spring;
-  scale: Spring;
-}
-/**
-* 所有标准歌词行的基类
-* @internal
-*/
-declare abstract class LyricLineBase extends EventTarget implements Disposable {
-  protected top: number;
-  protected scale: number;
-  protected blur: number;
-  protected opacity: number;
-  protected delay: number;
-  readonly lineTransforms: LineTransforms;
-  /**
-  * 用于 CJK 词语边界检测的分词器
-  */
-  static readonly wordSegmenter: Intl.Segmenter | null;
   /**
-  * Unicode 标准的全局 Grapheme Cluster 分词器
-  * 用于正确处理 emoji、复合字符等
-  */
-  static readonly graphemeSegmenter: Intl.Segmenter | null;
-  abstract getLine(): LyricLine;
-  abstract enable(time?: number, shouldPlay?: boolean): void;
-  abstract disable(): void;
-  abstract resume(): void;
-  abstract pause(): void;
-  onLineSizeChange(_size: [number, number]): void;
-  setTransform(top?: number, scale?: number, opacity?: number, blur?: number, _force?: boolean, delay?: number, _mode?: LyricLineRenderMode): void;
-  rebuildElement(): void;
-  /**
-  * 判定歌词是否可以应用强调辉光效果
-  *
-  * 果子在对辉光效果的解释是一种强调（emphasized）效果
+  * 设置是否让背景人声行始终后置显示
   *
-  * 条件是一个单词时长大于等于 1s 且长度小于等于 7
-  *
-  * @param word 单词
-  * @returns 是否可以应用强调辉光效果
+  * 默认情况下，如果背景歌词开始时间早于主歌词，会在主歌词上方展示；
+  * 如果设置为 `true`，则无论时间顺序如何，背景歌词都会始终在主歌词下方展示
+  * @param enable 是否启用始终后置
   */
-  static shouldEmphasize(word: LyricWord): boolean;
-  abstract update(delta?: number): void;
+  setAlwaysPostpositionBackground(enable: boolean): void;
+  /** 获取当前是否设置了让背景人声行始终后置显示 */
+  getAlwaysPostpositionBackground(): boolean;
+  getElement(): HTMLElement;
   dispose(): void;
 }
 //#endregion
 //#region src/lyric-player/dom/lyric-line.d.ts
-interface RealWord$1 extends LyricWord {
+interface RealWord extends LyricWord {
   mainElement: HTMLSpanElement;
   subElements: HTMLSpanElement[];
   elementAnimations: Animation[];
@@ -765,14 +882,14 @@ interface RealWord$1 extends LyricWord {
   padding: number;
   shouldEmphasize: boolean;
 }
-declare class RawLyricLineMouseEvent$1 extends MouseEvent {
+declare class RawLyricLineMouseEvent extends MouseEvent {
   readonly line: LyricLineBase;
   constructor(line: LyricLineBase, event: MouseEvent);
 }
-type MouseEventMap$1 = { [evt in keyof HTMLElementEventMap]: HTMLElementEventMap[evt] extends MouseEvent ? evt : never };
-type MouseEventTypes$1 = MouseEventMap$1[keyof MouseEventMap$1];
-type MouseEventListener$1 = (this: LyricLineEl$1, ev: RawLyricLineMouseEvent$1) => void;
-declare class LyricLineEl$1 extends LyricLineBase {
+type MouseEventMap = { [evt in keyof HTMLElementEventMap]: HTMLElementEventMap[evt] extends MouseEvent ? evt : never };
+type MouseEventTypes = MouseEventMap[keyof MouseEventMap];
+type MouseEventListener = (this: LyricLineEl, ev: RawLyricLineMouseEvent) => void;
+declare class LyricLineEl extends LyricLineBase {
   private lyricPlayer;
   private lyricLine;
   private element;
@@ -791,9 +908,9 @@ declare class LyricLineEl$1 extends LyricLineBase {
   constructor(lyricPlayer: DomLyricPlayer, lyricLine?: LyricLine);
   private listenersMap;
   private readonly onMouseEvent;
-  addMouseEventListener(type: MouseEventTypes$1, callback: MouseEventListener$1 | null, options?: boolean | AddEventListenerOptions | undefined): void;
-  removeMouseEventListener(type: MouseEventTypes$1, callback: MouseEventListener$1 | null, options?: boolean | EventListenerOptions | undefined): void;
-  areWordsOnSameLine(word1: RealWord$1, word2: RealWord$1): boolean;
+  addMouseEventListener(type: MouseEventTypes, callback: MouseEventListener | null, options?: boolean | AddEventListenerOptions | undefined): void;
+  removeMouseEventListener(type: MouseEventTypes, callback: MouseEventListener | null, options?: boolean | EventListenerOptions | undefined): void;
+  areWordsOnSameLine(word1: RealWord, word2: RealWord): boolean;
   private isEnabled;
   enable(maskAnimationTime?: number, shouldPlay?: boolean): Promise<void>;
   disable(): void;
@@ -802,10 +919,8 @@ declare class LyricLineEl$1 extends LyricLineBase {
   pause(): Promise<void>;
   setMaskAnimationState(maskAnimationTime?: number): void;
   getLine(): LyricLine;
-  private _prevParentEl;
   private lastStyle;
   show(): void;
-  hide(): void;
   private rebuildStyle;
   override rebuildElement(): void;
   /** 设置翻译与音译行文本 */
@@ -824,14 +939,30 @@ declare class LyricLineEl$1 extends LyricLineBase {
   getElement(): HTMLElement;
   private updateMaskAlphaTargets;
   private applyAlphaToDom;
-  override setTransform(top?: number, scale?: number, opacity?: number, blur?: number, force?: boolean, delay?: number, mode?: LyricLineRenderMode): void;
+  override setTransform(scale?: number, opacity?: number, blur?: number, force?: boolean, delay?: number, mode?: LyricLineRenderMode): void;
   update(delta?: number): void;
   _getDebugTargetPos(): string;
-  get isInSight(): boolean;
+  teardownContent(): void;
   private disposeElements;
   override dispose(): void;
 }
 //#endregion
+//#region src/lyric-player/dom/lyric-group.d.ts
+declare class LyricLineGroup extends LyricLineGroupBase<LyricLineEl> {
+  lyricPlayer: DomLyricPlayer;
+  element: HTMLElement;
+  bgWrapper?: HTMLElement;
+  private lastIsActive?;
+  constructor(lyricPlayer: DomLyricPlayer, mainLine: LyricLineEl);
+  get isInSight(): boolean;
+  show(): void;
+  hide(): void;
+  override update(delta: number): void;
+  addBgLine(bgLine: LyricLineEl): void;
+  protected renderStyles(): void;
+  override dispose(): void;
+}
+//#endregion
 //#region src/lyric-player/dom/index.d.ts
 /**
 * 歌词行鼠标相关事件，可以获取到歌词行的索引和歌词行元素
@@ -854,108 +985,7 @@ type LyricLineMouseEventListener = (evt: LyricLineMouseEvent) => void;
 * 尽可能贴切 Apple Music for iPad 的歌词效果设计，且做了力所能及的优化措施
 */
 declare class DomLyricPlayer extends LyricPlayerBase {
-  override currentLyricLineObjects: LyricLineEl$1[];
-  override onResize(): void;
-  readonly supportPlusLighter: boolean;
-  readonly supportMaskImage: boolean;
-  readonly innerSize: [number, number];
-  private readonly onLineClickedHandler;
-  /**
-  * 是否为非逐词歌词
-  * @internal
-  */
-  _getIsNonDynamic(): boolean;
-  private _baseFontSize;
-  get baseFontSize(): number;
-  constructor();
-  private rebuildStyle;
-  override setWordFadeWidth(value?: number): void;
-  /**
-  * 设置当前播放歌词，要注意传入后这个数组内的信息不得修改，否则会发生错误
-  * @param lines 歌词数组
-  * @param initialTime 初始时间，默认为 0
-  */
-  override setLyricLines(lines: LyricLine[], initialTime?: number): void;
-  override pause(): void;
-  override resume(): void;
-  override update(delta?: number): void;
-  override dispose(): void;
-}
-//#endregion
-//#region src/lyric-player/dom-slim/lyric-line.d.ts
-interface RealWord extends LyricWord {
-  mainElement: HTMLSpanElement;
-  subElements: HTMLSpanElement[];
-  elementAnimations: Animation[];
-  maskAnimations: Animation[];
-  width: number;
-  height: number;
-  padding: number;
-  shouldEmphasize: boolean;
-}
-declare class RawLyricLineMouseEvent extends MouseEvent {
-  readonly line: LyricLineEl;
-  constructor(line: LyricLineEl, event: MouseEvent);
-}
-type MouseEventMap = { [evt in keyof HTMLElementEventMap]: HTMLElementEventMap[evt] extends MouseEvent ? evt : never };
-type MouseEventTypes = MouseEventMap[keyof MouseEventMap];
-type MouseEventListener = (this: LyricLineEl, ev: RawLyricLineMouseEvent) => void;
-declare class LyricLineEl extends LyricLineBase {
-  private lyricPlayer;
-  private lyricLine;
-  private element;
-  private splittedWords;
-  lineSize: number[];
-  constructor(lyricPlayer: DomSlimLyricPlayer, lyricLine?: LyricLine);
-  private listenersMap;
-  private readonly onMouseEvent;
-  addMouseEventListener(type: MouseEventTypes, callback: MouseEventListener | null, options?: boolean | AddEventListenerOptions | undefined): void;
-  removeMouseEventListener(type: MouseEventTypes, callback: MouseEventListener | null, options?: boolean | EventListenerOptions | undefined): void;
-  areWordsOnSameLine(word1: RealWord, word2: RealWord): boolean;
-  private isEnabled;
-  enable(maskAnimationTime?: number): Promise<void>;
-  disable(): void;
-  private lastWord?;
-  resume(): Promise<void>;
-  pause(): Promise<void>;
-  setMaskAnimationState(maskAnimationTime?: number): void;
-  private measureLockMark;
-  private measureLock;
-  getLine(): LyricLine;
-  show(): void;
-  hide(): void;
-  private rebuildStyle;
-  private getRubySegments;
-  private buildWordElement;
-  override rebuildElement(): void;
-  private initEmphasizeAnimation;
-  private get totalDuration();
-  private maskImageDirty;
-  private markImageDirtyPromiseResolve;
-  private markImageDirtyPromise;
-  markMaskImageDirty(_debugReason?: string): Promise<void>;
-  waitMaskImageUpdated(): Promise<void>;
-  updateMaskImage(): Promise<void>;
-  private generateCalcBasedMaskImage;
-  private generateWebAnimationBasedMaskImage;
-  getElement(): HTMLElement;
-  override setTransform(top?: number, scale?: number, opacity?: number, blur?: number, force?: boolean, delay?: number): void;
-  update(delta?: number): void;
-  _getDebugTargetPos(): string;
-  get isInSight(): boolean;
-  private disposeElements;
-  override dispose(): void;
-}
-//#endregion
-//#region src/lyric-player/dom-slim/index.d.ts
-/**
-* 歌词播放组件，本框架的核心组件
-*
-* 尽可能贴切 Apple Music for iPad 的歌词效果设计，且做了力所能及的优化措施
-*/
-declare class DomSlimLyricPlayer extends LyricPlayerBase {
-  override currentLyricLineObjects: LyricLineEl[];
-  private debounceCalcLayout;
+  override currentLyricGroups: LyricLineGroup[];
   override onResize(): void;
   readonly supportPlusLighter: boolean;
   readonly supportMaskImage: boolean;
@@ -980,30 +1010,8 @@ declare class DomSlimLyricPlayer extends LyricPlayerBase {
   override pause(): void;
   override resume(): void;
   override update(delta?: number): void;
-  override calcLayout(sync?: boolean): Promise<void>;
   override dispose(): void;
 }
 //#endregion
-//#region src/lyric-player/index.d.ts
-/**
-* 歌词中不雅用语的掩码模式
-*/
-declare enum MaskObsceneWordsMode {
-  /** 禁用任何不雅用语掩码 */
-  Disabled = "",
-  /** 完全掩码所有不雅用语 */
-  FullMask = "full-mask",
-  /** 保留首尾字符，屏蔽中间字符 */
-  PartialMask = "partial-mask"
-}
-/**
-* 歌词行的渲染模式
-* @internal
-*/
-declare enum LyricLineRenderMode {
-  SOLID = 0,
-  GRADIENT = 1
-}
-//#endregion
-export { AbstractBaseRenderer, BackgroundRender, BaseRenderer, Disposable, DomLyricPlayer, DomLyricPlayer as LyricPlayer, DomSlimLyricPlayer, HasElement, LyricLine, LyricLineMouseEvent, LyricLineMouseEventListener, LyricLineRenderMode, LyricPlayerBase, LyricWord, LyricWordBase, MaskObsceneWordsMode, MeshGradientRenderer, OptimizeLyricOptions, PixiRenderer, type spring_d_exports as spring };
+export { AbstractBaseRenderer, BackgroundRender, BaseRenderer, Disposable, DomLyricPlayer, DomLyricPlayer as LyricPlayer, HasElement, LayoutAlignAnchor, LyricLine, type LyricLineBase, LyricLineMouseEvent, LyricLineMouseEventListener, LyricLineRenderMode, LyricPlayerBase, LyricWord, LyricWordBase, MaskObsceneWordsMode, MeshGradientRenderer, OptimizeLyricOptions, PixiRenderer, type PlayerLayoutState, type PlayerScrollState, type PlayerTimelineState, type spring_d_exports as spring };
 //# sourceMappingURL=amll-core.d.mts.map