@music-lyric-player/base 0.14.0 → 0.15.0

package/dist/index.ecma.d.ts

@@ -10,17 +10,18 @@ export declare class BaseLyricPlayer {
     private state;
     private active;
     private time;
-    private offset;
     private info;
-    private mergedLineEnd;
+    private merger;
+    private offset;
+    private driver;
     constructor();
     private onConfigUpdate;
     private handleGetCurrentTime;
     private handleGetEffectiveTime;
-    private handleRefreshOffset;
-    private handleGetLineTime;
+    /**
+     * Rebuild the merged line-end table from the current lyric and merge config.
+     */
     private handleBuildMergedLineEnd;
-    private handleGetMergedLineTime;
     private handleGetActiveIndex;
     private handleBridgeActive;
     private handleEmitLinesUpdate;
@@ -30,6 +31,7 @@ export declare class BaseLyricPlayer {
     updateLyric(info: Lyric.Info): void;
     /**
      * Start playback
+     *
      * @param time Optional time in ms to seek to before starting playback. If not provided, playback will start from the current position.
      */
     play(time?: number): void;
@@ -43,13 +45,17 @@ export declare class BaseLyricPlayer {
     dispose(): void;
     /**
      * Update the temp offset in ms (the user's temporary adjustment).
+     *
      * Stacked on top of the global config offset and the lyric's meta offset, then resyncs immediately.
+     *
      * @param value temp offset in ms; non-finite values are treated as 0.
      */
     updateTempOffset(value: number): void;
     /**
      * Find all active lines at the given time (ms). Does not mutate internal state.
+     *
      * Assumes `info.lines` is sorted by `time.start` ascending.
+     *
      * @param time time in ms to find active lines for.
      */
     matchLinesWithTime(time: number): {
@@ -58,7 +64,9 @@ export declare class BaseLyricPlayer {
     };
     /**
      * Convert a content (lyric) time to the playback clock by removing the active offset.
+     *
      * Seeking playback to the returned time makes a line at `contentTime` become active.
+     *
      * @param contentTime content time in ms (e.g. a line's start).
      */
     convertContentTime(contentTime: number): number;
@@ -182,6 +190,16 @@ declare interface Root {
      * @default 300
      */
     mergeWindow?: number;
+    /**
+     * Maximum number of consecutive lines that {@link mergeWindow} may fold into a single deactivation batch.
+     *
+     * When a run of close‑ending lines is longer than this, the batch is force‑flushed every `mergeLimit` lines so no batch ever holds more than this many lines.
+     *
+     * A value of `0` or less removes the cap; `1` effectively disables merging.
+     *
+     * @default 3
+     */
+    mergeLimit?: number;
     /**
      * Lyric time offset settings.
      */