@applemusic-like-lyrics/core 0.1.3 → 0.2.0-alpha.0

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

@@ -1,8 +1,8 @@
-import { Disposable, HasElement } from "../interfaces";
+import { Disposable, HasElement } from '../interfaces';
 export declare abstract class AbstractBaseRenderer implements Disposable, HasElement {
     /**
-     * 修改背景的流动速度，数字越大越快，默认为 2
-     * @param speed 背景的流动速度，默认为 2
+     * 修改背景的流动速度，数字越大越快，默认为 8
+     * @param speed 背景的流动速度，默认为 8
      */
     abstract setFlowSpeed(speed: number): void;
     /**
@@ -75,8 +75,8 @@ export declare abstract class BaseRenderer extends AbstractBaseRenderer {
      */
     protected onResize(width: number, height: number): void;
     /**
-     * 修改背景的流动速度，数字越大越快，默认为 2
-     * @param speed 背景的流动速度，默认为 2
+     * 修改背景的流动速度，数字越大越快，默认为 4
+     * @param speed 背景的流动速度，默认为 4
      */
     setFlowSpeed(speed: number): void;
     /**
@@ -105,4 +105,5 @@ export declare abstract class BaseRenderer extends AbstractBaseRenderer {
      */
     abstract setAlbum(albumSource: string | HTMLImageElement | HTMLVideoElement, isVideo?: boolean): Promise<void>;
     dispose(): void;
+    getElement(): HTMLElement;
 }

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

@@ -0,0 +1,4 @@
+export declare function blurImage(imageData: ImageData, radius: number, quality: number): void;
+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;

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

@@ -1,12 +1,12 @@
+import { AbstractBaseRenderer, BaseRenderer } from './base';
 /**
  * @fileoverview
  * 一个播放歌词的组件
  * @author SteveXMH
  */
-export { AbstractBaseRenderer, BaseRenderer } from "./base";
-import { AbstractBaseRenderer, BaseRenderer } from "./base";
-export { PixiRenderer } from "./pixi-renderer";
-export { EplorRenderer } from "./eplor-renderer";
+export { AbstractBaseRenderer, BaseRenderer } from './base';
+export { PixiRenderer } from './pixi-renderer';
+export { MeshGradientRenderer } from './mesh-renderer';
 export declare class BackgroundRender<Renderer extends BaseRenderer> implements AbstractBaseRenderer {
     private element;
     private renderer;

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

@@ -0,0 +1,17 @@
+interface ControlPointConf {
+    cx: number;
+    cy: number;
+    x: number;
+    y: number;
+    ur: number;
+    vr: number;
+    up: number;
+    vp: number;
+}
+interface ControlPointPreset {
+    width: number;
+    height: number;
+    conf: ControlPointConf[];
+}
+export declare const CONTROL_POINT_PRESETS: readonly [ControlPointPreset, ControlPointPreset, ControlPointPreset, ControlPointPreset, ControlPointPreset, ControlPointPreset];
+export {};

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

@@ -0,0 +1,67 @@
+import { Vec2, Vec3 } from 'gl-matrix';
+import { BaseRenderer } from '../base';
+declare class ControlPoint {
+    color: Vec3;
+    location: Vec2;
+    uTangent: Vec2;
+    vTangent: Vec2;
+    private _uRot;
+    private _vRot;
+    private _uScale;
+    private _vScale;
+    constructor();
+    get uRot(): number;
+    get vRot(): number;
+    set uRot(value: number);
+    set vRot(value: number);
+    get uScale(): number;
+    get vScale(): number;
+    set uScale(value: number);
+    set vScale(value: number);
+    private updateUTangent;
+    private updateVTangent;
+}
+export declare class MeshGradientRenderer extends BaseRenderer {
+    private gl;
+    private lastFrameTime;
+    private frameTime;
+    private lastTickTime;
+    private volume;
+    private tickHandle;
+    private maxFPS;
+    private paused;
+    private staticMode;
+    private mainProgram;
+    private blendProgram;
+    private manualControl;
+    private reduceImageSizeCanvas;
+    private targetSize;
+    private currentSize;
+    private fullScreenMesh;
+    private drawFrameBuffer;
+    private drawFrameBufferTexture;
+    private meshStates;
+    private _disposed;
+    setManualControl(enable: boolean): void;
+    setWireFrame(enable: boolean): void;
+    getControlPoint(x: number, y: number): ControlPoint | undefined;
+    resizeControlPoints(width: number, height: number): void;
+    resetSubdivition(subDivisions: number): void;
+    private onTick;
+    private checkIfResize;
+    private onRedraw;
+    private onTickBinded;
+    private requestTick;
+    private supportTextureFloat;
+    constructor(canvas: HTMLCanvasElement);
+    protected onResize(width: number, height: number): void;
+    setStaticMode(enable: boolean): void;
+    setFPS(fps: number): void;
+    pause(): void;
+    resume(): void;
+    setAlbum(albumSource: string | HTMLImageElement | HTMLVideoElement, isVideo?: boolean): Promise<void>;
+    setLowFreqVolume(volume: number): void;
+    setHasLyric(_hasLyric: boolean): void;
+    dispose(): void;
+}
+export {};

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

@@ -1,4 +1,4 @@
-import { BaseRenderer } from "./base";
+import { BaseRenderer } from './base';
 export declare class PixiRenderer extends BaseRenderer {
     protected canvas: HTMLCanvasElement;
     private app;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export type * from "./interfaces";
-export type * as spring from "./utils/spring";
-export * from "./bg-render";
-export { LyricPlayer, type LyricLineMouseEvent } from "./lyric-player";
+export type * from './interfaces';
+export type * as spring from './utils/spring';
+export * from './bg-render';
+export { LyricPlayer, type LyricLineMouseEvent } from './lyric-player';

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

@@ -1,6 +1,6 @@
-import { LyricPlayer } from ".";
-import { Disposable, HasElement } from "../interfaces";
-import { Spring } from "../utils/spring";
+import { LyricPlayer } from '.';
+import { Disposable, HasElement } from '../interfaces';
+import { Spring } from '../utils/spring';
 export declare class BottomLineEl implements HasElement, Disposable {
     private lyricPlayer;
     private element;

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

@@ -1,11 +1,6 @@
-/**
- * @fileoverview
- * 一个播放歌词的组件
- * @author SteveXMH
- */
-import type { Disposable, HasElement, LyricLine } from "../interfaces";
-import { SpringParams } from "../utils/spring";
-import { LyricLineEl } from "./lyric-line";
+import { Disposable, HasElement, LyricLine } from '../interfaces';
+import { SpringParams } from '../utils/spring';
+import { LyricLineEl } from './lyric-line';
 /**
  * 歌词行鼠标相关事件，可以获取到歌词行的索引和歌词行元素
  */
@@ -28,9 +23,7 @@ export declare class LyricLineMouseEvent extends MouseEvent {
      */
     line: LyricLineEl, event: MouseEvent);
 }
-export interface LyricLineMouseEventListener {
-    (evt: LyricLineMouseEvent): void;
-}
+export type LyricLineMouseEventListener = (evt: LyricLineMouseEvent) => void;
 /**
  * 歌词播放组件，本框架的核心组件
  *
@@ -39,6 +32,7 @@ export interface LyricLineMouseEventListener {
 export declare class LyricPlayer extends EventTarget implements HasElement, Disposable {
     private element;
     private currentTime;
+    private lastCurrentTime;
     private lyricLines;
     private processedLines;
     private lyricLinesEl;
@@ -47,18 +41,21 @@ export declare class LyricPlayer extends EventTarget implements HasElement, Disp
     private hotLines;
     private bufferedLines;
     private scrollToIndex;
+    private _wordFadeWidth;
     private allowScroll;
     private scrolledHandler;
     private isScrolled;
+    private isSeeking;
+    private initializeSeeking;
     private invokedByScrollEvent;
     private scrollOffset;
     private hidePassedLines;
+    private debounceCalcLayout;
     private resizeObserver;
     private posXSpringParams;
     private posYSpringParams;
     private scaleSpringParams;
-    private emUnit;
-    private padding;
+    private scaleForBGSpringParams;
     private enableBlur;
     private enableScale;
     private interludeDots;
@@ -70,11 +67,12 @@ export declare class LyricPlayer extends EventTarget implements HasElement, Disp
     private alignAnchor;
     private alignPosition;
     private isNonDynamic;
+    private isNonDuet;
     private scrollBoundary;
     readonly size: [number, number];
     readonly innerSize: [number, number];
     private readonly onLineClickedHandler;
-    _getIsNonDynamic(): boolean;
+    setIsSeeking(isSeeking: boolean): void;
     /**
      * 设置是否使用物理弹簧算法实现歌词动画效果，默认启用
      *
@@ -102,7 +100,6 @@ export declare class LyricPlayer extends EventTarget implements HasElement, Disp
      * @returns 是否启用歌词行缩放效果
      */
     getEnableScale(): boolean;
-    readonly style: import("jss").StyleSheet<"lyricPlayer" | "lyricLine" | "@media (max-width: 1024px)" | "lyricDuetLine" | "lyricBgLine" | "lyricMainLine" | "lyricSubLine" | "disableSpring" | "interludeDots" | "@supports (mix-blend-mode: plus-lighter)" | "tmpDisableTransition">;
     private _baseFontSize;
     get baseFontSize(): number;
     private isPageVisible;
@@ -125,6 +122,8 @@ export declare class LyricPlayer extends EventTarget implements HasElement, Disp
      * 重建样式
      *
      * 这个只允许内部调用
+     *
+     * @private
      */
     rebuildStyle(): void;
     /**
@@ -137,11 +136,25 @@ export declare class LyricPlayer extends EventTarget implements HasElement, Disp
      * @param enable 是否启用
      */
     setEnableBlur(enable: boolean): void;
+    get wordFadeWidth(): number;
+    /**
+     * 设置文字动画的渐变宽度，单位以歌词行的主文字字体大小的倍数为单位，默认为 0.5，即一个全角字符的一半宽度
+     *
+     * 如果要模拟 Apple Music for Android 的效果，可以设置为 1
+     *
+     * 如果要模拟 Apple Music for iPad 的效果，可以设置为 0.5
+     *
+     * 如果想要近乎禁用渐变效果，可以设置成非常接近 0 的小数（例如 `0.0001` ），但是**不可以为 0**
+     *
+     * @param value 需要设置的渐变宽度，单位以歌词行的主文字字体大小的倍数为单位，默认为 0.5
+     */
+    setWordFadeWidth(value?: number): void;
     /**
      * 设置当前播放歌词，要注意传入后这个数组内的信息不得修改，否则会发生错误
      * @param lines 歌词数组
+     * @param initialTime 初始时间，默认为 0
      */
-    setLyricLines(lines: LyricLine[]): void;
+    setLyricLines(lines: LyricLine[], initialTime?: number): void;
     /**
      * 重置用户滚动状态
      *

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

@@ -1,5 +1,5 @@
-import { LyricPlayer } from ".";
-import type { Disposable, HasElement } from "../interfaces";
+import { LyricPlayer } from '.';
+import { Disposable, HasElement } from '../interfaces';
 export declare class InterludeDots implements HasElement, Disposable {
     private readonly lyricPlayer;
     private element;

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

@@ -1,6 +1,16 @@
-import { LyricPlayer } from ".";
-import { Disposable, HasElement, LyricLine, LyricWord } from "../interfaces";
-import { Spring } from "../utils/spring";
+import { LyricPlayer } from '.';
+import { Disposable, HasElement, LyricLine, LyricWord } from '../interfaces';
+import { Spring } from '../utils/spring';
+interface RealWord extends LyricWord {
+    mainElement: HTMLSpanElement;
+    subElements: HTMLSpanElement[];
+    elementAnimations: Animation[];
+    maskAnimations: Animation[];
+    width: number;
+    height: number;
+    padding: number;
+    shouldEmphasize: boolean;
+}
 export declare function shouldEmphasize(word: LyricWord): boolean;
 export declare class RawLyricLineMouseEvent extends MouseEvent {
     readonly line: LyricLineEl;
@@ -32,11 +42,14 @@ export declare class LyricLineEl extends EventTarget implements HasElement, Disp
     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): void;
+    private hasFaded;
+    enable(maskAnimationTime?: number): Promise<void>;
     disable(maskAnimationTime?: number): void;
-    resume(): void;
-    pause(): void;
+    private lastWord?;
+    resume(currentTime?: number): void;
+    pause(currentTime?: number): void;
     setMaskAnimationState(maskAnimationTime?: number): void;
     measureSize(): [number, number];
     setLine(line: LyricLine): void;
@@ -51,14 +64,19 @@ export declare class LyricLineEl extends EventTarget implements HasElement, Disp
     private initFloatAnimation;
     private initEmphasizeAnimation;
     private get totalDuration();
-    updateMaskImage(): void;
+    private maskImageDirty;
+    private markImageDirtyPromises;
+    markMaskImageDirty(): Promise<void>;
+    waitMaskImageUpdated(): Promise<void>;
+    updateMaskImage(): Promise<void>;
     private generateCalcBasedMaskImage;
     private generateWebAnimationBasedMaskImage;
     getElement(): HTMLElement;
-    setTransform(left?: number, top?: number, scale?: number, opacity?: number, blur?: number, force?: boolean, delay?: number): void;
+    setTransform(left?: number, top?: number, scale?: number, opacity?: number, subopacity?: number, blur?: number, force?: boolean, delay?: number): void;
     update(delta?: number): void;
     _getDebugTargetPos(): string;
     get isInSight(): boolean;
+    private disposeElements;
     dispose(): void;
 }
 export {};

package/dist/mg-test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/debounce.d.ts

@@ -0,0 +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;

package/dist/utils/linear.d.ts

@@ -0,0 +1,21 @@
+export interface LinearParams {
+    duration: number;
+}
+export declare class Linear {
+    private currentPosition;
+    private targetPosition;
+    private currentTime;
+    private params;
+    private currentSolver;
+    private startTime;
+    private queueParams;
+    private queuePosition;
+    constructor(currentPosition?: number);
+    private resetSolver;
+    arrived(): boolean;
+    setPosition(targetPosition: number): void;
+    update(delta?: number): void;
+    updateParams(params: Partial<LinearParams>, delay?: number): void;
+    setTargetPosition(targetPosition: number, delay?: number): void;
+    getCurrentPosition(): number;
+}

package/dist/utils/schedule.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview
+ * @see https://github.com/wilsonpage/fastdom/blob/master/fastdom.js
+ */
+export declare function measure<T>(callback: () => T): Promise<T>;
+export declare function mutate(callback: () => void): Promise<unknown>;

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

@@ -1,4 +1,4 @@
-import { Disposable } from "..";
+import { Disposable } from '..';
 export interface SpringParams {
     mass: number;
     damping: number;

package/package.json

@@ -1,7 +1,6 @@
 {
   "name": "@applemusic-like-lyrics/core",
-  "packageManager": "yarn@3.6.1",
-  "version": "0.1.3",
+  "version": "0.2.0-alpha.0",
   "description": "AMLL 的纯 JS 核心组件框架，包括歌词显示组件和背景组件等其它可以复用的组件",
   "repository": {
     "url": "https://github.com/Steve-xmh/applemusic-like-lyrics.git",
@@ -15,13 +14,6 @@
     "dist/**/*.cjs",
     "dist/**/*.map"
   ],
-  "scripts": {
-    "build:docs": "typedoc --plugin typedoc-plugin-markdown --out docs src/index.ts",
-    "build": "vite build",
-    "build:dev": "vite build",
-    "fmt": "biome format --write ./src",
-    "dev": "vite dev"
-  },
   "type": "module",
   "main": "./dist/amll-core.cjs",
   "module": "./dist/amll-core.js",
@@ -31,23 +23,28 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/amll-core.js",
       "require": "./dist/amll-core.cjs"
+    },
+    "./style.css": {
+      "import": "./dist/style.css",
+      "require": "./dist/style.css"
     }
   },
   "devDependencies": {
     "@applemusic-like-lyrics/lyric": "^0.0.2",
-    "@applemusic-like-lyrics/ttml": "^0.1.1",
-    "@biomejs/biome": "1.5.3",
-    "@types/stats.js": "^0.17.0",
+    "@biomejs/biome": "^1.8.3",
+    "@types/deep-freeze": "^0.1.5",
+    "@types/stats.js": "^0.17.3",
     "lil-gui": "^0.18.2",
     "stats.js": "^0.17.0",
-    "typedoc": "^0.25.2",
-    "typedoc-plugin-markdown": "^3.16.0",
-    "typescript": "^5.2.2",
-    "vite": "^4.4.11",
-    "vite-plugin-dts": "^3.6.0",
-    "vite-plugin-glsl": "^1.2.1",
-    "vite-plugin-top-level-await": "^1.3.1",
-    "vite-plugin-wasm": "^3.2.2"
+    "typedoc": "^0.26.5",
+    "typedoc-plugin-markdown": "^4.2.3",
+    "typescript": "^5.5.4",
+    "vite": "^5.4.0",
+    "vite-plugin-dts": "^4.0.3",
+    "vite-plugin-glsl": "^1.3.0",
+    "vite-plugin-top-level-await": "^1.4.4",
+    "vite-plugin-wasm": "^3.3.0",
+    "@applemusic-like-lyrics/ttml": "^0.1.1"
   },
   "peerDependencies": {
     "@pixi/app": "*",
@@ -56,12 +53,19 @@
     "@pixi/filter-blur": "*",
     "@pixi/filter-bulge-pinch": "*",
     "@pixi/filter-color-matrix": "*",
-    "@pixi/sprite": "*",
-    "jss": "*",
-    "jss-preset-default": "*"
+    "@pixi/sprite": "*"
   },
   "dependencies": {
-    "bezier-easing": "^2.1.0"
+    "bezier-easing": "^2.1.0",
+    "deep-freeze": "^0.0.1",
+    "gl-matrix": "^4.0.0-beta.2"
   },
-  "gitHead": "6d9cb894c6510995d6a30ace7a1814dc333d57d1"
-}
+  "scripts": {
+    "build:docs": "typedoc --plugin typedoc-plugin-markdown --out docs src/index.ts",
+    "build": "vite build",
+    "build:dev": "vite build",
+    "fmt": "biome format --write ./src",
+    "dev": "vite dev",
+    "preinstall": "npx only-allow pnpm"
+  }
+}