@applemusic-like-lyrics/core 0.2.0-alpha.6 → 0.3.0

package/dist/bg-render/base.d.ts

@@ -75,8 +75,8 @@ export declare abstract class BaseRenderer extends AbstractBaseRenderer {
      */
     protected onResize(width: number, height: number): void;
     /**
-     * 修改背景的流动速度，数字越大越快，默认为 4
-     * @param speed 背景的流动速度，默认为 4
+     * 修改背景的流动速度，数字越大越快，默认为 1
+     * @param speed 背景的流动速度，默认为 1
      */
     setFlowSpeed(speed: number): void;
     /**
@@ -107,4 +107,3 @@ export declare abstract class BaseRenderer extends AbstractBaseRenderer {
     dispose(): void;
     getElement(): HTMLElement;
 }
-//# sourceMappingURL=base.d.ts.map

package/dist/bg-render/img.d.ts

@@ -2,4 +2,3 @@ export declare function blurImage(imageData: ImageData, radius: number, quality:
 export declare function saturateImage(imageData: ImageData, saturation: number): void;
 export declare function brightnessImage(imageData: ImageData, brightness: number): void;
 export declare function contrastImage(imageData: ImageData, contrast: number): void;
-//# sourceMappingURL=img.d.ts.map

package/dist/bg-render/index.d.ts

@@ -26,4 +26,3 @@ export declare class BackgroundRender<Renderer extends BaseRenderer> implements
     getElement(): HTMLCanvasElement;
     dispose(): void;
 }
-//# sourceMappingURL=index.d.ts.map

package/dist/bg-render/mesh-renderer/cp-generate.d.ts

@@ -4,4 +4,3 @@ normalOffset?: number, // = 0.3,
 blendFactor?: number, smoothIters?: number, // = 3,
 smoothFactor?: number, // = 0.3,
 smoothModifier?: number): ControlPointPreset;
-//# sourceMappingURL=cp-generate.d.ts.map

package/dist/bg-render/mesh-renderer/cp-presets.d.ts

@@ -19,5 +19,4 @@ export interface ControlPointPreset {
 export declare const p: (cx: number, cy: number, x: number, y: number, ur?: number, vr?: number, up?: number, vp?: number) => ControlPointConf;
 /** @internal */
 export declare const preset: (width: number, height: number, conf: ControlPointConf[]) => ControlPointPreset;
-export declare const CONTROL_POINT_PRESETS: readonly [ControlPointPreset, ControlPointPreset, ControlPointPreset, ControlPointPreset];
-//# sourceMappingURL=cp-presets.d.ts.map
+export declare const CONTROL_POINT_PRESETS: readonly [ControlPointPreset, ControlPointPreset, ControlPointPreset, ControlPointPreset, ControlPointPreset, ControlPointPreset];

package/dist/bg-render/mesh-renderer/index.d.ts

@@ -25,7 +25,6 @@ export declare class MeshGradientRenderer extends BaseRenderer {
     private gl;
     private lastFrameTime;
     private frameTime;
-    private currentImageData?;
     private lastTickTime;
     private smoothedVolume;
     private volume;
@@ -34,6 +33,10 @@ export declare class MeshGradientRenderer extends BaseRenderer {
     private paused;
     private staticMode;
     private mainProgram;
+    private quadProgram;
+    private quadBuffer;
+    private fbo;
+    private fboTexture;
     private manualControl;
     private reduceImageSizeCanvas;
     private targetSize;
@@ -52,10 +55,10 @@ export declare class MeshGradientRenderer extends BaseRenderer {
     resetSubdivition(subDivisions: number): void;
     private onTick;
     private checkIfResize;
+    private updateFBO;
     private onRedraw;
     private onTickBinded;
     private requestTick;
-    private supportTextureFloat;
     constructor(canvas: HTMLCanvasElement);
     protected onResize(width: number, height: number): void;
     setStaticMode(enable: boolean): void;
@@ -71,4 +74,3 @@ export declare class MeshGradientRenderer extends BaseRenderer {
     private updatePerformanceStats;
 }
 export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/bg-render/pixi-renderer.d.ts

@@ -20,4 +20,3 @@ export declare class PixiRenderer extends BaseRenderer {
     dispose(): void;
     getElement(): HTMLElement;
 }
-//# sourceMappingURL=pixi-renderer.d.ts.map

package/dist/canvas-test.d.ts

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=canvas-test.d.ts.map

package/dist/index.d.ts

@@ -2,4 +2,3 @@ export * from './bg-render/index.ts';
 export type * from './interfaces.ts';
 export * from './lyric-player/index.ts';
 export type * as spring from './utils/spring.ts';
-//# sourceMappingURL=index.d.ts.map

package/dist/interfaces.d.ts

@@ -23,17 +23,21 @@ export interface Disposable {
     dispose(): void;
 }
 /** 一个歌词单词 */
-export interface LyricWord {
+export interface LyricWordBase {
     /** 单词的起始时间，单位为毫秒 */
     startTime: number;
     /** 单词的结束时间，单位为毫秒 */
     endTime: number;
     /** 单词内容 */
     word: string;
+}
+export interface LyricWord extends LyricWordBase {
     /** 单词的音译内容 */
-    romanWord: string;
+    romanWord?: string;
     /** 单词内容是否包含冒犯性的不雅用语 */
-    obscene: boolean;
+    obscene?: boolean;
+    /** 单词的注音内容 */
+    ruby?: LyricWordBase[];
 }
 /** 一行歌词，存储多个单词 */
 export interface LyricLine {
@@ -55,4 +59,48 @@ export interface LyricLine {
     /** 该行是否为对唱歌词行（即歌词行靠右对齐） */
     isDuet: boolean;
 }
-//# sourceMappingURL=interfaces.d.ts.map
+/**
+ * 优化歌词行的配置选项
+ */
+export interface OptimizeLyricOptions {
+    /**
+     * 规范化歌词中的空格
+     *
+     * 将多个连续空格替换为一个空格
+     * @default true
+     */
+    normalizeSpaces?: boolean;
+    /**
+     * 是否将行级时间戳强行设为字级时间戳
+     * @default true
+     */
+    resetLineTimestamps?: boolean;
+    /**
+     * 把多行背景人声转换为单行背景人声 + 主歌词行的形式
+     * @default true
+     */
+    convertExcessiveBackgroundLines?: boolean;
+    /**
+     * 是否同步主歌词与背景人声的时间
+     * @default true
+     */
+    syncMainAndBackgroundLines?: boolean;
+    /**
+     * 清洗非刻意的重叠，以免不必要的多行高亮效果
+     *
+     * 如果两行时间轴有重叠的歌词同时满足下列条件：
+     * * 重叠小于 100ms
+     * * 重叠时长不足下一行时长的 10%
+     *
+     * 则截断上一行歌词的结束时间为下一行歌词的开始时间
+     * @default true
+     */
+    cleanUnintentionalOverlaps?: boolean;
+    /**
+     * 尝试让歌词提前最多 1 秒开始
+     *
+     * 有重叠则尝试最多提前 400ms 或上一行时长的 30%
+     * @default true
+     */
+    tryAdvanceStartTime?: boolean;
+}

package/dist/lyric-player/base.d.ts

@@ -1,12 +1,14 @@
-import { Disposable, HasElement, LyricLine, LyricWord } from '../interfaces.ts';
+import { Disposable, HasElement, LyricLine, LyricWord, OptimizeLyricOptions } from '../interfaces.ts';
 import { Spring, SpringParams } from '../utils/spring.ts';
 import { BottomLineEl } from './bottom-line.ts';
 import { InterludeDots } from './dom/interlude-dots.ts';
+import { LyricLineRenderMode, MaskObsceneWordsMode } from './index.ts';
 /**
  * 歌词播放器的基类，已经包含了有关歌词操作和排版的功能，子类需要为其实现对应的显示展示操作
  */
 export 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]>;
@@ -26,6 +28,8 @@ export declare abstract class LyricPlayerBase extends EventTarget implements Has
     protected bottomLine: BottomLineEl;
     protected enableBlur: boolean;
     protected enableScale: boolean;
+    protected maskObsceneWords: MaskObsceneWordsMode;
+    protected maskObsceneWordChar: string;
     protected hidePassedLines: boolean;
     protected scrollBoundary: number[];
     protected currentLyricLineObjects: LyricLineBase[];
@@ -37,7 +41,13 @@ export declare abstract class LyricPlayerBase extends EventTarget implements Has
     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）距离，单位：像素。
      * 用于决定在视口之外多少距离内也认为是“可见”，以便提前创建/保留行元素。
@@ -55,7 +65,8 @@ export declare abstract class LyricPlayerBase extends EventTarget implements Has
     resizeObserver: ResizeObserver;
     protected wordFadeWidth: number;
     protected targetAlignIndex: number;
-    constructor();
+    protected lastInterludeState: boolean;
+    constructor(element?: HTMLElement);
     private beginScrollHandler;
     private endScrollHandler;
     private limitScrollOffset;
@@ -101,6 +112,24 @@ export declare abstract class LyricPlayerBase extends EventTarget implements Has
      * @param enable 是否启用
      */
     setEnableBlur(enable: boolean): void;
+    /**
+     * 设置歌词中不雅用语的掩码模式
+     * @param mode 掩码模式
+     * @see {@link MaskObsceneWordsMode}
+     */
+    setMaskObsceneWords(mode: MaskObsceneWordsMode): void;
+    /**
+     * 设置不雅用语掩码使用的字符，默认为 `*`
+     * @param char 单个字符，用于替换不雅用语中的字符
+     */
+    setMaskObsceneWordChar(char: string): void;
+    rebuildLyricLines(): void;
+    /**
+     * 根据当前配置处理不雅用语单词
+     * @param word 单词对象
+     * @internal
+     */
+    processObsceneWord(word: LyricWord): string;
     /**
      * 设置目标歌词行的对齐方式，默认为 `center`
      *
@@ -144,12 +173,25 @@ export declare abstract class LyricPlayerBase extends EventTarget implements Has
      * @returns [开始时间,结束时间,大概处于的歌词行ID,下一句是否为对唱歌词] 或 undefined 如果不处于间奏区间
      */
     protected getCurrentInterlude(): [number, number, number, boolean] | undefined;
+    /**
+     * 设置歌词的优化配置项，这些配置项默认全部开启
+     *
+     * 注意，如果在 `setLyricLines` 之后修改此配置，需要重新调用 `setLyricLines()` 才能对当前歌词生效
+     * @param options 优化配置选项
+     * @see {@link OptimizeLyricOptions}
+     */
+    setOptimizeOptions(options: OptimizeLyricOptions): void;
     /**
      * 设置当前播放歌词，要注意传入后这个数组内的信息不得修改，否则会发生错误
      * @param lines 歌词数组
      * @param initialTime 初始时间，默认为 0
      */
     setLyricLines(lines: LyricLine[], initialTime?: number): void;
+    /**
+     * 获取当前是否在播放
+     * @returns 当前是否在播放
+     */
+    getIsPlaying(): boolean;
     /**
      * 设置当前播放进度，单位为毫秒且**必须是整数**，此时将会更新内部的歌词进度信息
      * 内部会根据调用间隔和播放进度自动决定如何滚动和显示歌词，所以这个的调用频率越快越准确越好
@@ -158,6 +200,7 @@ export declare abstract class LyricPlayerBase extends EventTarget implements Has
      * @param time 当前播放进度，单位为毫秒
      */
     setCurrentTime(time: number, isSeek?: boolean): void;
+    protected updateDynamicSpringParams(): void;
     /**
      * 重新布局定位歌词行的位置，调用完成后再逐帧调用 `update`
      * 函数即可让歌词通过动画移动到目标位置。
@@ -172,10 +215,11 @@ export declare abstract class LyricPlayerBase extends EventTarget implements Has
      * 2. 加载了新的歌词时（不论前后歌词是否完全一样）
      * 3. 用户自行跳转了歌曲播放位置（不论距离远近）
      *
-     * @param force 是否不经过动画直接修改布局定位
-     * @param reflow 是否进行重新布局（重新计算每行歌词大小）
+     * @param sync 是否同步执行，通常用于初始化或 Resize 时立即布局
+     * @param force 是否绕过弹簧效果强制更新位置
      */
-    calcLayout(sync?: boolean): Promise<void>;
+    calcLayout(sync?: boolean, force?: boolean): Promise<void>;
+    protected calculateBlur(itemIndex: number, isActive: boolean, latestIndex: number): number;
     /**
      * 设置所有歌词行在横坐标上的弹簧属性，包括重量、弹力和阻力。
      *
@@ -260,12 +304,13 @@ export declare abstract class LyricLineBase extends EventTarget implements Dispo
         scale: Spring;
     };
     abstract getLine(): LyricLine;
-    abstract enable(): void;
+    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): void;
+    setTransform(top?: number, scale?: number, opacity?: number, blur?: number, _force?: boolean, delay?: number, _mode?: LyricLineRenderMode): void;
+    rebuildElement(): void;
     /**
      * 判定歌词是否可以应用强调辉光效果
      *
@@ -280,4 +325,3 @@ export declare abstract class LyricLineBase extends EventTarget implements Dispo
     abstract update(delta?: number): void;
     dispose(): void;
 }
-//# sourceMappingURL=base.d.ts.map

package/dist/lyric-player/bottom-line.d.ts

@@ -12,16 +12,18 @@ export declare class BottomLineEl implements HasElement, Disposable {
         posX: Spring;
         posY: Spring;
     };
+    private isFocused;
+    private blur;
     constructor(lyricPlayer: LyricPlayerBase);
     measureSize(): Promise<[number, number]>;
     private lastStyle;
     show(): void;
     hide(): void;
+    setFocused(focused: boolean): void;
     private rebuildStyle;
     getElement(): HTMLElement;
-    setTransform(left?: number, top?: number, force?: boolean, delay?: number): void;
+    setTransform(left?: number, top?: number, blur?: number, force?: boolean, delay?: number): void;
     update(delta?: number): void;
     get isInSight(): boolean;
     dispose(): void;
 }
-//# sourceMappingURL=bottom-line.d.ts.map

package/dist/lyric-player/canvas/index.d.ts

@@ -22,4 +22,3 @@ export declare class CanvasLyricPlayer extends LyricPlayerBase {
     setFontSize(emSize: number): void;
     update(delta?: number): void;
 }
-//# sourceMappingURL=index.d.ts.map

package/dist/lyric-player/canvas/lyric-line.d.ts

@@ -14,7 +14,6 @@ export declare class CanvasLyricLine extends LyricLineBase {
     private lineCanvas;
     /** @internal */
     relayout(): void;
-    private enabled;
     enable(): void;
     disable(): void;
     resume(): void;
@@ -23,4 +22,3 @@ export declare class CanvasLyricLine extends LyricLineBase {
     get isInSight(): boolean;
     update(delta?: number): void;
 }
-//# sourceMappingURL=lyric-line.d.ts.map

package/dist/lyric-player/canvas/text-layout.d.ts

@@ -37,4 +37,3 @@ export declare function layoutWord(ctx: CanvasRenderingContext2D, text: string,
  * @param initialX 初始 X 坐标，对于需要布局多段文本的情况下有所帮助
  */
 export declare function layoutLine(ctx: CanvasRenderingContext2D, text: string, config: TextLayoutConfig, initialX?: number): Generator<TextLayoutResult, void, void>;
-//# sourceMappingURL=text-layout.d.ts.map

package/dist/lyric-player/dom/index.d.ts

@@ -57,4 +57,3 @@ export declare class DomLyricPlayer extends LyricPlayerBase {
     update(delta?: number): void;
     dispose(): void;
 }
-//# sourceMappingURL=index.d.ts.map

package/dist/lyric-player/dom/interlude-dots.d.ts

@@ -20,4 +20,3 @@ export declare class InterludeDots implements HasElement, Disposable {
     update(delta?: number): void;
     dispose(): void;
 }
-//# sourceMappingURL=interlude-dots.d.ts.map

package/dist/lyric-player/dom/lyric-line.d.ts

@@ -1,5 +1,6 @@
 import { LyricLine, LyricWord } from '../../interfaces.ts';
 import { LyricLineBase } from '../base.ts';
+import { LyricLineRenderMode } from '../index.ts';
 import { DomLyricPlayer } from '.';
 interface RealWord extends LyricWord {
     mainElement: HTMLSpanElement;
@@ -27,6 +28,12 @@ export declare class LyricLineEl extends LyricLineBase {
     private splittedWords;
     private built;
     lineSize: number[];
+    private renderMode;
+    private currentBrightAlpha;
+    private currentDarkAlpha;
+    private targetBrightAlpha;
+    private targetDarkAlpha;
+    private segmenter;
     constructor(lyricPlayer: DomLyricPlayer, lyricLine?: LyricLine);
     private listenersMap;
     private readonly onMouseEvent;
@@ -34,14 +41,13 @@ export declare class LyricLineEl extends LyricLineBase {
     removeMouseEventListener(type: MouseEventTypes, callback: MouseEventListener | null, options?: boolean | EventListenerOptions | undefined): void;
     areWordsOnSameLine(word1: RealWord, word2: RealWord): boolean;
     private isEnabled;
-    enable(maskAnimationTime?: number): Promise<void>;
+    enable(maskAnimationTime?: number, shouldPlay?: boolean): Promise<void>;
     disable(): void;
     private lastWord?;
     resume(): Promise<void>;
     pause(): Promise<void>;
     setMaskAnimationState(maskAnimationTime?: number): void;
     getLine(): LyricLine;
-    private _hide;
     private _prevParentEl;
     private lastStyle;
     show(): void;
@@ -50,10 +56,10 @@ export declare class LyricLineEl extends LyricLineBase {
     rebuildElement(): void;
     /** 设置翻译与音译行文本 */
     private setSubLinesText;
-    /** 处理一组连写（无空格）单词，包含强调效果 */
-    private buildChunkGroup;
-    /** 渲染单个词（含强调与音译处理） */
-    private buildSingleWord;
+    private getRubyCharCount;
+    private getRubySegments;
+    private createWord;
+    private buildWord;
     private initFloatAnimation;
     private initEmphasizeAnimation;
     private get totalDuration();
@@ -62,7 +68,9 @@ export declare class LyricLineEl extends LyricLineBase {
     private generateCalcBasedMaskImage;
     private generateWebAnimationBasedMaskImage;
     getElement(): HTMLElement;
-    setTransform(top?: number, scale?: number, opacity?: number, blur?: number, force?: boolean, delay?: number): void;
+    private updateMaskAlphaTargets;
+    private applyAlphaToDom;
+    setTransform(top?: number, scale?: number, opacity?: number, blur?: number, force?: boolean, delay?: number, mode?: LyricLineRenderMode): void;
     update(delta?: number): void;
     _getDebugTargetPos(): string;
     get isInSight(): boolean;
@@ -70,4 +78,3 @@ export declare class LyricLineEl extends LyricLineBase {
     dispose(): void;
 }
 export {};
-//# sourceMappingURL=lyric-line.d.ts.map

package/dist/lyric-player/dom-slim/index.d.ts

@@ -36,4 +36,3 @@ export declare class DomSlimLyricPlayer extends LyricPlayerBase {
     calcLayout(sync?: boolean): Promise<void>;
     dispose(): void;
 }
-//# sourceMappingURL=index.d.ts.map

package/dist/lyric-player/dom-slim/interlude-dots.d.ts

@@ -20,4 +20,3 @@ export declare class InterludeDots implements HasElement, Disposable {
     update(delta?: number): void;
     dispose(): void;
 }
-//# sourceMappingURL=interlude-dots.d.ts.map

package/dist/lyric-player/dom-slim/lyric-line.d.ts

@@ -42,13 +42,12 @@ export declare class LyricLineEl extends LyricLineBase {
     private measureLockMark;
     private measureLock;
     getLine(): LyricLine;
-    private _prevParentEl;
-    private lastStyle;
     show(): void;
     hide(): void;
     private rebuildStyle;
+    private getRubySegments;
+    private buildWordElement;
     rebuildElement(): void;
-    private initFloatAnimation;
     private initEmphasizeAnimation;
     private get totalDuration();
     private maskImageDirty;
@@ -68,4 +67,3 @@ export declare class LyricLineEl extends LyricLineBase {
     dispose(): void;
 }
 export {};
-//# sourceMappingURL=lyric-line.d.ts.map

package/dist/lyric-player/index.d.ts

@@ -1,11 +1,29 @@
 import { DomLyricPlayer } from './dom/index.ts';
 export { LyricPlayerBase } from './base.ts';
 export * from './canvas/index.ts';
-export * from './dom-slim/index.ts';
 export * from './dom/index.ts';
+export * from './dom-slim/index.ts';
+/**
+ * 歌词中不雅用语的掩码模式
+ */
+declare enum MaskObsceneWordsMode {
+    /** 禁用任何不雅用语掩码 */
+    Disabled = "",
+    /** 完全掩码所有不雅用语 */
+    FullMask = "full-mask",
+    /** 保留首尾字符，屏蔽中间字符 */
+    PartialMask = "partial-mask"
+}
+/**
+ * 歌词行的渲染模式
+ * @internal
+ */
+declare enum LyricLineRenderMode {
+    SOLID = 0,
+    GRADIENT = 1
+}
 export { 
 /**
  * 默认导出的歌词播放组件
  */
-DomLyricPlayer as LyricPlayer, };
-//# sourceMappingURL=index.d.ts.map
+DomLyricPlayer as LyricPlayer, LyricLineRenderMode, MaskObsceneWordsMode, };

package/dist/mg-test.d.ts

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=mg-test.d.ts.map

package/dist/utils/debounce.d.ts

@@ -1,3 +1,2 @@
 export declare function debounce<T extends Function>(cb: T, wait?: number): (...args: any) => void;
 export declare function debounceFrame<T extends Function>(cb: T, frameTime?: number): (...args: any) => void;
-//# sourceMappingURL=debounce.d.ts.map

package/dist/utils/derivative.d.ts

@@ -1,3 +1,2 @@
 export declare function derivative(f: (x: number) => number): (x: number) => number;
 export declare function getVelocity(f: (t: number) => number): (t: number) => number;
-//# sourceMappingURL=derivative.d.ts.map

package/dist/utils/eq-set.d.ts

@@ -1,2 +1 @@
 export declare const eqSet: <T>(xs: Set<T>, ys: Set<T>) => boolean;
-//# sourceMappingURL=eq-set.d.ts.map

package/dist/utils/flagsets.d.ts

@@ -15,4 +15,3 @@ export declare class FlagSets {
     delete(flag: number): void;
     has(flag: number): boolean;
 }
-//# sourceMappingURL=flagsets.d.ts.map

package/dist/utils/is-cjk.d.ts

@@ -1,2 +1 @@
 export declare const isCJK: (char: string) => boolean;
-//# sourceMappingURL=is-cjk.d.ts.map

package/dist/utils/linear.d.ts

@@ -19,4 +19,3 @@ export declare class Linear {
     setTargetPosition(targetPosition: number, delay?: number): void;
     getCurrentPosition(): number;
 }
-//# sourceMappingURL=linear.d.ts.map

package/dist/utils/lyric-split-words.d.ts

@@ -9,4 +9,3 @@ import { LyricWord } from '../interfaces.ts';
  * @returns 重新分组后的单词数组
  */
 export declare function chunkAndSplitLyricWords(words: LyricWord[]): (LyricWord | LyricWord[])[];
-//# sourceMappingURL=lyric-split-words.d.ts.map

package/dist/utils/matrix.d.ts

@@ -23,4 +23,3 @@ export declare function scaleMatrix4(m: Matrix4, scale?: number, origin?: {
 }): Matrix4;
 export declare function translateMatrix4(m: Matrix4, x?: number, y?: number, z?: number): Matrix4;
 export declare function matrix4ToCSS(m: Matrix4, fractionDigits?: number): string;
-//# sourceMappingURL=matrix.d.ts.map

package/dist/utils/mutex.d.ts

@@ -1,3 +1,2 @@
 export declare function mutexifyFunction<F extends (...args: Args) => Promise<Result>, Args extends any[], Result>(func: F): F;
 export default mutexifyFunction;
-//# sourceMappingURL=mutex.d.ts.map

package/dist/utils/optimize-lyric.d.ts

@@ -0,0 +1,9 @@
+import { LyricLine, OptimizeLyricOptions } from '../interfaces.ts';
+/**
+ * 优化歌词行的展示效果
+ *
+ * 注意会直接原地修改入参，确保你已经提前深克隆了歌词行数组
+ * @param lines 歌词行数组
+ * @param options 优化的可选配置，默认全部开启
+ */
+export declare function optimizeLyricLines(lines: LyricLine[], options?: OptimizeLyricOptions): void;

package/dist/utils/resource.d.ts

@@ -2,4 +2,3 @@ export declare function loadImage(imageUrl: string): Promise<HTMLImageElement>;
 export declare function loadVideo(videoUrl: string): Promise<HTMLVideoElement>;
 export declare function loadResourceFromUrl(url: string, isVideo?: boolean): Promise<HTMLImageElement | HTMLVideoElement>;
 export declare function loadResourceFromElement(element: HTMLImageElement | HTMLVideoElement): Promise<HTMLImageElement | HTMLVideoElement>;
-//# sourceMappingURL=resource.d.ts.map

package/dist/utils/schedule.d.ts

@@ -4,4 +4,3 @@
  */
 export declare function measure<T>(callback: () => T): Promise<T>;
 export declare function mutate(callback: () => void): Promise<unknown>;
-//# sourceMappingURL=schedule.d.ts.map

package/dist/utils/spring.d.ts

@@ -24,4 +24,3 @@ export declare class Spring {
     setTargetPosition(targetPosition: number, delay?: number): void;
     getCurrentPosition(): number;
 }
-//# sourceMappingURL=spring.d.ts.map

package/dist/utils/wa-spring.d.ts

@@ -1,9 +1,4 @@
 import { Disposable } from '../interfaces.ts';
-export interface SpringParams {
-    mass: number;
-    damping: number;
-    stiffness: number;
-}
 type CSSStyleKeys = {
     [Style in keyof CSSStyleDeclaration]: Style extends string ? CSSStyleDeclaration[Style] extends string ? Style : never : never;
 }[keyof CSSStyleDeclaration];
@@ -18,7 +13,6 @@ export declare class WebAnimationSpring extends EventTarget implements Disposabl
     private currentAnimation;
     private targetPosition;
     private isStatic;
-    private params;
     private currentSolver;
     private getV;
     constructor(element: HTMLElement, styleName: CSSStyleKeys, valueGenerator: (value: number) => string, currentPosition?: number);
@@ -31,4 +25,3 @@ export declare class WebAnimationSpring extends EventTarget implements Disposabl
     dispose(): void;
 }
 export {};
-//# sourceMappingURL=wa-spring.d.ts.map