@nomercy-entertainment/nomercy-player-core 2.2.7 → 2.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/CONTRIBUTING.md +6 -5
  3. package/MIGRATION.md +1 -1
  4. package/RELEASING.md +2 -2
  5. package/THIRD-PARTY-NOTICES.md +29 -0
  6. package/dist/adapters/cue-parser/ICueParser.d.ts +1 -1
  7. package/dist/core/kit-version.js +1 -1
  8. package/dist/core/mixins/i18n.js +2 -2
  9. package/dist/core/mixins/i18n.js.map +1 -1
  10. package/dist/core/plugin/base.d.ts +1 -1
  11. package/dist/core/plugin/base.d.ts.map +1 -1
  12. package/dist/core/plugin/base.js +1 -1
  13. package/dist/core/plugin/base.js.map +1 -1
  14. package/dist/core/plugin-translations.d.ts +2 -0
  15. package/dist/core/plugin-translations.d.ts.map +1 -1
  16. package/dist/core/plugin-translations.js +8 -1
  17. package/dist/core/plugin-translations.js.map +1 -1
  18. package/dist/errors/index.d.ts +1 -1
  19. package/dist/errors/index.js +1 -1
  20. package/dist/errors/player.d.ts +1 -1
  21. package/dist/errors/player.js +1 -1
  22. package/dist/index.d.ts +2 -2
  23. package/dist/index.d.ts.map +1 -1
  24. package/dist/index.js +1 -1
  25. package/dist/index.js.map +1 -1
  26. package/dist/plugins/equalizer/index.js +2 -2
  27. package/dist/plugins/equalizer/index.js.map +1 -1
  28. package/dist/plugins/equalizer/presets.d.ts +3 -3
  29. package/dist/plugins/equalizer/presets.js +1 -1
  30. package/dist/plugins/visualization/frame-texture.d.ts +26 -0
  31. package/dist/plugins/visualization/frame-texture.d.ts.map +1 -0
  32. package/dist/plugins/visualization/frame-texture.js +84 -0
  33. package/dist/plugins/visualization/frame-texture.js.map +1 -0
  34. package/dist/plugins/visualization/gpu-surface.d.ts +50 -0
  35. package/dist/plugins/visualization/gpu-surface.d.ts.map +1 -0
  36. package/dist/plugins/visualization/gpu-surface.js +103 -0
  37. package/dist/plugins/visualization/gpu-surface.js.map +1 -0
  38. package/dist/plugins/visualization/index.d.ts +31 -5
  39. package/dist/plugins/visualization/index.d.ts.map +1 -1
  40. package/dist/plugins/visualization/index.js +57 -4
  41. package/dist/plugins/visualization/index.js.map +1 -1
  42. package/dist/types/plugin.d.ts +1 -1
  43. package/dist/types/translations.d.ts +1 -1
  44. package/package.json +5 -3
@@ -0,0 +1,26 @@
1
+ /**
2
+ * A `width x rows` single-channel byte texture (R8) for per-frame data such as
3
+ * the frequency row and the waveform row. Each uploaded row is resampled to
4
+ * `width`, so the shader samples a fixed width whatever the analyser size.
5
+ *
6
+ * Knows nothing about shaders. Sampling row `n` at v = (n + 0.5) / rows gives
7
+ * its value as `texture(...).r` in 0..1.
8
+ */
9
+ export declare class FrameDataTexture {
10
+ private readonly gl;
11
+ readonly width: number;
12
+ readonly rows: number;
13
+ readonly texture: WebGLTexture | null;
14
+ private readonly _pixels;
15
+ private _disposed;
16
+ constructor(gl: WebGL2RenderingContext, width: number, rows: number);
17
+ /**
18
+ * Writes `data[n]` into row `n` (resampled to `width`) and uploads the whole
19
+ * texture. Rows beyond `data.length` keep their last values. Leaves the
20
+ * texture bound to `TEXTURE_2D` on the active unit.
21
+ */
22
+ upload(data: ReadonlyArray<ArrayLike<number>>): void;
23
+ /** Deletes the GL texture. Idempotent. */
24
+ dispose(): void;
25
+ }
26
+ //# sourceMappingURL=frame-texture.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frame-texture.d.ts","sourceRoot":"","sources":["../../../src/plugins/visualization/frame-texture.ts"],"names":[],"mappings":"AA+BA;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IAKhB,OAAO,CAAC,QAAQ,CAAC,EAAE;IAA0B,QAAQ,CAAC,KAAK,EAAE,MAAM;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM;IAJtG,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,SAAS,CAAS;gBAEG,EAAE,EAAE,sBAAsB,EAAW,KAAK,EAAE,MAAM,EAAW,IAAI,EAAE,MAAM;IAYtG;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI;IAapD,0CAA0C;IAC1C,OAAO,IAAI,IAAI;CAOf"}
@@ -0,0 +1,84 @@
1
+ // -----------------------------------------------------------------------------
2
+ // Copyright (c) NoMercy Entertainment
3
+ //
4
+ // Licensed under the Apache License, Version 2.0. See LICENSE for details.
5
+ //
6
+ // SPDX-License-Identifier: Apache-2.0
7
+ // -----------------------------------------------------------------------------
8
+ /** Linear resample of `source` into `target`, end points included. */
9
+ function resampleRow(source, target) {
10
+ const width = target.length;
11
+ const count = source.length;
12
+ if (count === 0) {
13
+ target.fill(0);
14
+ return;
15
+ }
16
+ if (width === 1 || count === 1) {
17
+ target.fill(source[0] ?? 0);
18
+ return;
19
+ }
20
+ const step = (count - 1) / (width - 1);
21
+ for (let i = 0; i < width; i++) {
22
+ const position = i * step;
23
+ const index = Math.min(Math.floor(position), count - 2);
24
+ const fraction = position - index;
25
+ const from = source[index] ?? 0;
26
+ const to = source[index + 1] ?? 0;
27
+ target[i] = Math.round(from + (to - from) * fraction);
28
+ }
29
+ }
30
+ /**
31
+ * A `width x rows` single-channel byte texture (R8) for per-frame data such as
32
+ * the frequency row and the waveform row. Each uploaded row is resampled to
33
+ * `width`, so the shader samples a fixed width whatever the analyser size.
34
+ *
35
+ * Knows nothing about shaders. Sampling row `n` at v = (n + 0.5) / rows gives
36
+ * its value as `texture(...).r` in 0..1.
37
+ */
38
+ export class FrameDataTexture {
39
+ gl;
40
+ width;
41
+ rows;
42
+ texture;
43
+ _pixels;
44
+ _disposed = false;
45
+ constructor(gl, width, rows) {
46
+ this.gl = gl;
47
+ this.width = width;
48
+ this.rows = rows;
49
+ this._pixels = new Uint8Array(width * rows);
50
+ this.texture = gl.createTexture();
51
+ gl.bindTexture(gl.TEXTURE_2D, this.texture);
52
+ gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR);
53
+ gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
54
+ gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);
55
+ gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
56
+ gl.pixelStorei(gl.UNPACK_ALIGNMENT, 1);
57
+ gl.texImage2D(gl.TEXTURE_2D, 0, gl.R8, width, rows, 0, gl.RED, gl.UNSIGNED_BYTE, this._pixels);
58
+ }
59
+ /**
60
+ * Writes `data[n]` into row `n` (resampled to `width`) and uploads the whole
61
+ * texture. Rows beyond `data.length` keep their last values. Leaves the
62
+ * texture bound to `TEXTURE_2D` on the active unit.
63
+ */
64
+ upload(data) {
65
+ if (this._disposed || !this.texture)
66
+ return;
67
+ const count = Math.min(data.length, this.rows);
68
+ for (let row = 0; row < count; row++)
69
+ resampleRow(data[row], this._pixels.subarray(row * this.width, (row + 1) * this.width));
70
+ const gl = this.gl;
71
+ gl.bindTexture(gl.TEXTURE_2D, this.texture);
72
+ gl.pixelStorei(gl.UNPACK_ALIGNMENT, 1);
73
+ gl.texSubImage2D(gl.TEXTURE_2D, 0, 0, 0, this.width, this.rows, gl.RED, gl.UNSIGNED_BYTE, this._pixels);
74
+ }
75
+ /** Deletes the GL texture. Idempotent. */
76
+ dispose() {
77
+ if (this._disposed)
78
+ return;
79
+ this._disposed = true;
80
+ if (this.texture)
81
+ this.gl.deleteTexture(this.texture);
82
+ }
83
+ }
84
+ //# sourceMappingURL=frame-texture.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frame-texture.js","sourceRoot":"","sources":["../../../src/plugins/visualization/frame-texture.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,uCAAuC;AACvC,EAAE;AACF,4EAA4E;AAC5E,EAAE;AACF,uCAAuC;AACvC,gFAAgF;AAEhF,sEAAsE;AACtE,SAAS,WAAW,CAAC,MAAyB,EAAE,MAAkB;IACjE,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5B,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACf,OAAO;IACR,CAAC;IACD,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5B,OAAO;IACR,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;QAClC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;IACvD,CAAC;AACF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,gBAAgB;IAKC;IAAqC;IAAwB;IAJjF,OAAO,CAAsB;IACrB,OAAO,CAAa;IAC7B,SAAS,GAAG,KAAK,CAAC;IAE1B,YAA6B,EAA0B,EAAW,KAAa,EAAW,IAAY;QAAzE,OAAE,GAAF,EAAE,CAAwB;QAAW,UAAK,GAAL,KAAK,CAAQ;QAAW,SAAI,GAAJ,IAAI,CAAQ;QACrG,IAAI,CAAC,OAAO,GAAG,IAAI,UAAU,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC;QAClC,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5C,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,kBAAkB,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;QAClE,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,kBAAkB,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;QAClE,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,cAAc,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC;QACrE,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,cAAc,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC;QACrE,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;QACvC,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAChG,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAsC;QAC5C,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO;YAClC,OAAO;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,KAAK,EAAE,GAAG,EAAE;YACnC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAE,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAE1F,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QACnB,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5C,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;QACvC,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACzG,CAAC;IAED,0CAA0C;IAC1C,OAAO;QACN,IAAI,IAAI,CAAC,SAAS;YACjB,OAAO;QACR,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,IAAI,CAAC,OAAO;YACf,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;CACD"}
@@ -0,0 +1,50 @@
1
+ /** Options for {@link GpuSurface}. */
2
+ export interface GpuSurfaceOptions {
3
+ /** Backing-store pixels per CSS pixel. Default `1`. */
4
+ scale?: number;
5
+ /** Passed to `getContext('webgl2', ...)`. */
6
+ contextAttributes?: WebGLContextAttributes;
7
+ /** Called once when no WebGL2 context could be created. */
8
+ onUnsupported?: (reason: string) => void;
9
+ onContextLost?: () => void;
10
+ onContextRestored?: () => void;
11
+ }
12
+ /**
13
+ * A WebGL2 canvas that owns its own element under a caller-given parent.
14
+ *
15
+ * It is a separate element on purpose: a canvas that already holds a 2D
16
+ * context returns `null` for `webgl2`, and `CanvasPlugin` takes the 2D context
17
+ * of its own canvas on the first tick. The surface never throws; when WebGL2
18
+ * is missing `context()` returns `null` and `onUnsupported` fires once.
19
+ *
20
+ * The caller decides the scale (the backing store is `round(css * scale)`) and
21
+ * recreates its GL resources when `onContextRestored` fires.
22
+ */
23
+ export declare class GpuSurface {
24
+ private readonly opts;
25
+ private readonly _canvas;
26
+ private _gl;
27
+ private _scale;
28
+ private _cssWidth;
29
+ private _cssHeight;
30
+ private _lost;
31
+ private _disposed;
32
+ private readonly _onLost;
33
+ private readonly _onRestored;
34
+ constructor(parent: HTMLElement, opts?: GpuSurfaceOptions);
35
+ canvas(): HTMLCanvasElement;
36
+ /** The WebGL2 context, or `null` when unsupported or after `dispose()`. */
37
+ context(): WebGL2RenderingContext | null;
38
+ isLost(): boolean;
39
+ scale(): number;
40
+ setScale(scale: number): void;
41
+ /** Sets the backing store to `round(css * scale)` for the given CSS size. */
42
+ resize(cssWidth: number, cssHeight: number): void;
43
+ /**
44
+ * Releases the GL context through `WEBGL_lose_context` and removes the
45
+ * canvas. Browsers cap live contexts, so repeated mounts need this.
46
+ * Idempotent.
47
+ */
48
+ dispose(): void;
49
+ }
50
+ //# sourceMappingURL=gpu-surface.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gpu-surface.d.ts","sourceRoot":"","sources":["../../../src/plugins/visualization/gpu-surface.ts"],"names":[],"mappings":"AAQA,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IACjC,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IAC3C,2DAA2D;IAC3D,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,UAAU;IAoBW,OAAO,CAAC,QAAQ,CAAC,IAAI;IAnBtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,GAAG,CAAuC;IAClD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAItB;IAEF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAG1B;gBAEU,MAAM,EAAE,WAAW,EAAmB,IAAI,GAAE,iBAAsB;IA0B9E,MAAM,IAAI,iBAAiB;IAI3B,2EAA2E;IAC3E,OAAO,IAAI,sBAAsB,GAAG,IAAI;IAIxC,MAAM,IAAI,OAAO;IAIjB,KAAK,IAAI,MAAM;IAIf,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK7B,6EAA6E;IAC7E,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAOjD;;;;OAIG;IACH,OAAO,IAAI,IAAI;CAcf"}
@@ -0,0 +1,103 @@
1
+ // -----------------------------------------------------------------------------
2
+ // Copyright (c) NoMercy Entertainment
3
+ //
4
+ // Licensed under the Apache License, Version 2.0. See LICENSE for details.
5
+ //
6
+ // SPDX-License-Identifier: Apache-2.0
7
+ // -----------------------------------------------------------------------------
8
+ /**
9
+ * A WebGL2 canvas that owns its own element under a caller-given parent.
10
+ *
11
+ * It is a separate element on purpose: a canvas that already holds a 2D
12
+ * context returns `null` for `webgl2`, and `CanvasPlugin` takes the 2D context
13
+ * of its own canvas on the first tick. The surface never throws; when WebGL2
14
+ * is missing `context()` returns `null` and `onUnsupported` fires once.
15
+ *
16
+ * The caller decides the scale (the backing store is `round(css * scale)`) and
17
+ * recreates its GL resources when `onContextRestored` fires.
18
+ */
19
+ export class GpuSurface {
20
+ opts;
21
+ _canvas;
22
+ _gl = null;
23
+ _scale;
24
+ _cssWidth = 0;
25
+ _cssHeight = 0;
26
+ _lost = false;
27
+ _disposed = false;
28
+ _onLost = (event) => {
29
+ event.preventDefault();
30
+ this._lost = true;
31
+ this.opts.onContextLost?.();
32
+ };
33
+ _onRestored = () => {
34
+ this._lost = false;
35
+ this.opts.onContextRestored?.();
36
+ };
37
+ constructor(parent, opts = {}) {
38
+ this.opts = opts;
39
+ this._scale = opts.scale ?? 1;
40
+ this._canvas = document.createElement('canvas');
41
+ this._canvas.className = 'nmplayer-gpu-surface';
42
+ this._canvas.style.position = 'absolute';
43
+ this._canvas.style.left = '0';
44
+ this._canvas.style.top = '0';
45
+ this._canvas.style.width = '100%';
46
+ this._canvas.style.height = '100%';
47
+ this._canvas.style.pointerEvents = 'none';
48
+ try {
49
+ this._gl = this._canvas.getContext('webgl2', opts.contextAttributes);
50
+ }
51
+ catch { /* a blocked context is the same as an unsupported one */ }
52
+ if (!this._gl) {
53
+ opts.onUnsupported?.('webgl2-unavailable');
54
+ return;
55
+ }
56
+ this._canvas.addEventListener('webglcontextlost', this._onLost);
57
+ this._canvas.addEventListener('webglcontextrestored', this._onRestored);
58
+ parent.appendChild(this._canvas);
59
+ }
60
+ canvas() {
61
+ return this._canvas;
62
+ }
63
+ /** The WebGL2 context, or `null` when unsupported or after `dispose()`. */
64
+ context() {
65
+ return this._gl;
66
+ }
67
+ isLost() {
68
+ return this._lost;
69
+ }
70
+ scale() {
71
+ return this._scale;
72
+ }
73
+ setScale(scale) {
74
+ this._scale = scale;
75
+ this.resize(this._cssWidth, this._cssHeight);
76
+ }
77
+ /** Sets the backing store to `round(css * scale)` for the given CSS size. */
78
+ resize(cssWidth, cssHeight) {
79
+ this._cssWidth = cssWidth;
80
+ this._cssHeight = cssHeight;
81
+ this._canvas.width = Math.max(0, Math.round(cssWidth * this._scale));
82
+ this._canvas.height = Math.max(0, Math.round(cssHeight * this._scale));
83
+ }
84
+ /**
85
+ * Releases the GL context through `WEBGL_lose_context` and removes the
86
+ * canvas. Browsers cap live contexts, so repeated mounts need this.
87
+ * Idempotent.
88
+ */
89
+ dispose() {
90
+ if (this._disposed)
91
+ return;
92
+ this._disposed = true;
93
+ this._canvas.removeEventListener('webglcontextlost', this._onLost);
94
+ this._canvas.removeEventListener('webglcontextrestored', this._onRestored);
95
+ try {
96
+ this._gl?.getExtension('WEBGL_lose_context')?.loseContext();
97
+ }
98
+ catch { /* the context is already gone */ }
99
+ this._gl = null;
100
+ this._canvas.remove();
101
+ }
102
+ }
103
+ //# sourceMappingURL=gpu-surface.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gpu-surface.js","sourceRoot":"","sources":["../../../src/plugins/visualization/gpu-surface.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,10 @@
1
1
  import type { BaseEventMap, IPlayer, RequireSpec } from '../../types/index.js';
2
+ import type { GpuSurfaceOptions } from './gpu-surface.js';
2
3
  import { Plugin } from '../../core/plugin/index.js';
4
+ import { GpuSurface } from './gpu-surface.js';
5
+ export { FrameDataTexture } from './frame-texture.js';
6
+ export { GpuSurface } from './gpu-surface.js';
7
+ export type { GpuSurfaceOptions } from './gpu-surface.js';
3
8
  /**
4
9
  * Per-frame data delivered to a VisualizationPlugin's `render()`. Includes
5
10
  * spectrum, waveform, current time, BPM/beat (when a provider has supplied
@@ -115,17 +120,24 @@ export interface VisualizationOptions {
115
120
  * Reserved for future use; currently only `'frame'` is active.
116
121
  */
117
122
  tick?: 'frame' | 'time';
123
+ /** Go inactive while `document.hidden` is true. Default `false`. */
124
+ pauseWhenHidden?: boolean;
125
+ /** Go inactive while an `IntersectionObserver` reports the canvas off-screen. Default `false`. */
126
+ pauseWhenOffscreen?: boolean;
118
127
  }
119
128
  /** Events emitted by {@link VisualizationPlugin} subclasses. */
120
129
  export interface VisualizationEvents {
121
- /** Emitted once during `use()` when AudioContext / spectrum is unavailable. */
122
- unsupported: {
130
+ /** Emitted when AudioContext / spectrum is unavailable, or a GPU surface gets no WebGL2. */
131
+ 'unsupported': {
123
132
  reason: string;
124
133
  };
125
134
  /** Emitted each render tick after `render()` completes. */
126
- rendered: {
135
+ 'rendered': {
127
136
  frame: VisualizationFrame;
128
137
  };
138
+ /** The GPU surface lost its WebGL2 context. Recreate GL resources on `gpu:contextrestored`. */
139
+ 'gpu:contextlost': Record<string, never>;
140
+ 'gpu:contextrestored': Record<string, never>;
129
141
  }
130
142
  /**
131
143
  * Base class for canvas-based visualization plugins. Layered composition:
@@ -143,11 +155,11 @@ export interface VisualizationEvents {
143
155
  * Bridges to p5.js, three.js, shader-based viz live in separate optional
144
156
  * packages and build ON TOP of this — never use kit internals.
145
157
  *
146
- * Example:
158
+ * Usage:
147
159
  *
148
160
  * ```ts
149
161
  * class WinampClassic extends VisualizationPlugin {
150
- * static readonly id = 'fillz:winamp-classic';
162
+ * static readonly id = 'winamp-classic';
151
163
  *
152
164
  * render(ctx: CanvasRenderingContext2D, frame: VisualizationFrame) {
153
165
  * for (let i = 0; i < frame.frequency.length; i++) {
@@ -189,6 +201,10 @@ export declare abstract class VisualizationPlugin<P extends IPlayer<BaseEventMap
189
201
  private _spectrumFrameHandler;
190
202
  protected _latestFrame: VisualizationFrame | undefined;
191
203
  private _setupCalled;
204
+ private _gpuSurface;
205
+ private _manualActive;
206
+ private _documentHidden;
207
+ private _offscreen;
192
208
  /**
193
209
  * Resolves the `CanvasPlugin` and `SpectrumPlugin` dependencies, registers
194
210
  * the render callback with the canvas RAF loop, and subscribes to `frame`
@@ -212,6 +228,14 @@ export declare abstract class VisualizationPlugin<P extends IPlayer<BaseEventMap
212
228
  * render loop for snapshot reads.
213
229
  */
214
230
  currentFrame(): VisualizationFrame | undefined;
231
+ /** True unless set inactive by `setActive(false)` or paused by an opted-in source. */
232
+ isActive(): boolean;
233
+ /** Stops (`false`) or resumes (`true`) all render work for this instance. Idempotent. */
234
+ setActive(active: boolean): void;
235
+ /** Opt-in WebGL2 canvas under `parent`. Never throws; without WebGL2 it emits `unsupported`. */
236
+ protected createGpuSurface(parent: HTMLElement, opts?: Pick<GpuSurfaceOptions, 'scale' | 'contextAttributes'>): GpuSurface;
237
+ /** The surface made by `createGpuSurface()`, or `null` before it or after `dispose()`. */
238
+ protected gpuSurface(): GpuSurface | null;
215
239
  /**
216
240
  * Override this. Called once per frame at the canvas plugin's configured
217
241
  * FPS, with a fully-populated VisualizationFrame and the shared 2D context.
@@ -238,6 +262,8 @@ export declare abstract class VisualizationPlugin<P extends IPlayer<BaseEventMap
238
262
  beat?: boolean;
239
263
  bpm?: number;
240
264
  }): void;
265
+ private _watchDocumentVisibility;
266
+ private _watchViewport;
241
267
  /**
242
268
  * Per-canvas-RAF tick. Reads the latest spectrum frame, builds the
243
269
  * VisualizationFrame payload (overlaying the canvas-supplied deltaMs unless
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/visualization/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/visualization/index.ts"],"names":[],"mappings":"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"}
@@ -8,6 +8,9 @@
8
8
  import { Plugin } from '../../core/plugin/index.js';
9
9
  import { CanvasPlugin } from '../canvas/index.js';
10
10
  import { SpectrumPlugin } from '../spectrum/index.js';
11
+ import { GpuSurface } from './gpu-surface.js';
12
+ export { FrameDataTexture } from './frame-texture.js';
13
+ export { GpuSurface } from './gpu-surface.js';
11
14
  /**
12
15
  * Base class for canvas-based visualization plugins. Layered composition:
13
16
  *
@@ -24,11 +27,11 @@ import { SpectrumPlugin } from '../spectrum/index.js';
24
27
  * Bridges to p5.js, three.js, shader-based viz live in separate optional
25
28
  * packages and build ON TOP of this — never use kit internals.
26
29
  *
27
- * Example:
30
+ * Usage:
28
31
  *
29
32
  * ```ts
30
33
  * class WinampClassic extends VisualizationPlugin {
31
- * static readonly id = 'fillz:winamp-classic';
34
+ * static readonly id = 'winamp-classic';
32
35
  *
33
36
  * render(ctx: CanvasRenderingContext2D, frame: VisualizationFrame) {
34
37
  * for (let i = 0; i < frame.frequency.length; i++) {
@@ -70,6 +73,10 @@ export class VisualizationPlugin extends Plugin {
70
73
  _spectrumFrameHandler = null;
71
74
  _latestFrame;
72
75
  _setupCalled = false;
76
+ _gpuSurface = null;
77
+ _manualActive = true;
78
+ _documentHidden = false;
79
+ _offscreen = false;
73
80
  /**
74
81
  * Resolves the `CanvasPlugin` and `SpectrumPlugin` dependencies, registers
75
82
  * the render callback with the canvas RAF loop, and subscribes to `frame`
@@ -101,6 +108,10 @@ export class VisualizationPlugin extends Plugin {
101
108
  this.on(SpectrumPlugin, 'frame', this._spectrumFrameHandler);
102
109
  this._renderTickBound = this._renderTick.bind(this);
103
110
  canvas.addRenderer(this._renderTickBound);
111
+ if (this.opts?.pauseWhenHidden)
112
+ this._watchDocumentVisibility();
113
+ if (this.opts?.pauseWhenOffscreen)
114
+ this._watchViewport(canvas);
104
115
  }
105
116
  /**
106
117
  * Unregisters the render callback from the canvas plugin's RAF loop and
@@ -114,6 +125,8 @@ export class VisualizationPlugin extends Plugin {
114
125
  }
115
126
  catch { /* swallow */ }
116
127
  }
128
+ this._gpuSurface?.dispose();
129
+ this._gpuSurface = null;
117
130
  // Spectrum subscription is auto-cleaned by the lifecycle registry via `on()`.
118
131
  this._renderTickBound = null;
119
132
  this._spectrumFrameHandler = null;
@@ -131,6 +144,30 @@ export class VisualizationPlugin extends Plugin {
131
144
  currentFrame() {
132
145
  return this._latestFrame;
133
146
  }
147
+ /** True unless set inactive by `setActive(false)` or paused by an opted-in source. */
148
+ isActive() {
149
+ return this._manualActive && !this._documentHidden && !this._offscreen;
150
+ }
151
+ /** Stops (`false`) or resumes (`true`) all render work for this instance. Idempotent. */
152
+ setActive(active) {
153
+ this._manualActive = active;
154
+ }
155
+ /** Opt-in WebGL2 canvas under `parent`. Never throws; without WebGL2 it emits `unsupported`. */
156
+ createGpuSurface(parent, opts = {}) {
157
+ this._gpuSurface?.dispose();
158
+ const surface = new GpuSurface(parent, {
159
+ ...opts,
160
+ onUnsupported: reason => this.emit('unsupported', { reason }),
161
+ onContextLost: () => this.emit('gpu:contextlost', {}),
162
+ onContextRestored: () => this.emit('gpu:contextrestored', {}),
163
+ });
164
+ this._gpuSurface = surface;
165
+ return surface;
166
+ }
167
+ /** The surface made by `createGpuSurface()`, or `null` before it or after `dispose()`. */
168
+ gpuSurface() {
169
+ return this._gpuSurface;
170
+ }
134
171
  /**
135
172
  * Optional: override to do one-time setup after `use()` has resolved deps.
136
173
  * Called once before the first `render()`.
@@ -149,13 +186,29 @@ export class VisualizationPlugin extends Plugin {
149
186
  * from raw FFT data.
150
187
  */
151
188
  onBeat(_beat) { }
189
+ _watchDocumentVisibility() {
190
+ this._documentHidden = document.hidden;
191
+ this.lifecycle.listen(document, 'visibilitychange', () => {
192
+ this._documentHidden = document.hidden;
193
+ });
194
+ }
195
+ _watchViewport(canvas) {
196
+ if (typeof IntersectionObserver === 'undefined')
197
+ return;
198
+ const observer = this.lifecycle.observe(new IntersectionObserver((entries) => {
199
+ const latest = entries[entries.length - 1];
200
+ if (latest)
201
+ this._offscreen = !latest.isIntersecting;
202
+ }));
203
+ observer.observe(canvas.canvas());
204
+ }
152
205
  /**
153
206
  * Per-canvas-RAF tick. Reads the latest spectrum frame, builds the
154
207
  * VisualizationFrame payload (overlaying the canvas-supplied deltaMs unless
155
208
  * the frame is synthetic), and dispatches to `render()`.
156
209
  */
157
210
  _renderTick(ctx, deltaMs, _rafTime) {
158
- if (!this.enabled())
211
+ if (!this.enabled() || !this.isActive())
159
212
  return;
160
213
  const spectrum = this._spectrumPlugin;
161
214
  if (!spectrum)
@@ -226,7 +279,7 @@ export class VisualizationPlugin extends Plugin {
226
279
  * ```
227
280
  */
228
281
  export class WaveformVisualization extends VisualizationPlugin {
229
- static id = 'fillz:waveform';
282
+ static id = 'waveform';
230
283
  static version = '2.0.0';
231
284
  static description = 'Oscilloscope-style waveform stroke visualizer';
232
285
  render(ctx, frame) {
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/visualization/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/visualization/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,uCAAuC;AACvC,EAAE;AACF,4EAA4E;AAC5E,EAAE;AACF,uCAAuC;AACvC,gFAAgF;AAKhF,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AA0I3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,OAAgB,mBAA+D,SAAQ,MAAoD;IAChJ,MAAM,CAAmB,EAAE,GAAW,eAAe,CAAC;IACtD,MAAM,CAAmB,OAAO,GAAW,OAAO,CAAC;IACnD,MAAM,CAAmB,WAAW,GAAW,+CAA+C,CAAC;IAE/F;;;OAGG;IACH,MAAM,CAAmB,QAAQ,GAA+B,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAE/F;;;;;OAKG;IACH,MAAM,CAAmB,OAAO,GAAG;QAClC,6BAA6B,EAAE,SAAS;KAC/B,CAAC;IAEH,aAAa,GAAwB,IAAI,CAAC;IAC1C,eAAe,GAA0B,IAAI,CAAC;IAC9C,gBAAgB,GAA0B,IAAI,CAAC;IAC/C,qBAAqB,GAA2D,IAAI,CAAC;IACnF,YAAY,CAAiC;IAC/C,YAAY,GAAG,KAAK,CAAC;IACrB,WAAW,GAAsB,IAAI,CAAC;IACtC,aAAa,GAAG,IAAI,CAAC;IACrB,eAAe,GAAG,KAAK,CAAC;IACxB,UAAU,GAAG,KAAK,CAAC;IAE3B;;;;;;;;OAQG;IACM,GAAG;QACX,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAEvD,4EAA4E;QAC5E,uEAAuE;QACvE,yEAAyE;QACzE,sEAAsE;QACtE,yBAAyB;QACzB,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YACjD,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,sBAAsB,EAAE,CAAC,CAAC;YAC1F,OAAO;QACR,CAAC;QAED,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;QAC5B,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;QAEhC,yEAAyE;QACzE,0CAA0C;QAC1C,IAAI,CAAC,qBAAqB,GAAG,CAAC,IAAI,EAAE,EAAE;YACrC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC;QAChC,CAAC,CAAC;QACF,IAAI,CAAC,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAE7D,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAE1C,IAAI,IAAI,CAAC,IAAI,EAAE,eAAe;YAC7B,IAAI,CAAC,wBAAwB,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,IAAI,EAAE,kBAAkB;YAChC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACM,OAAO;QACf,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACjD,IAAI,CAAC;gBACJ,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAC1D,CAAC;YACD,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;QACxB,CAAC;QACD,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,8EAA8E;QAC9E,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC7B,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC;QAClC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5B,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAC9B,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED;;;;;OAKG;IACH,YAAY;QACX,OAAO,IAAI,CAAC,YAAY,CAAC;IAC1B,CAAC;IAED,sFAAsF;IACtF,QAAQ;QACP,OAAO,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;IACxE,CAAC;IAED,yFAAyF;IACzF,SAAS,CAAC,MAAe;QACxB,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;IAC7B,CAAC;IAED,gGAAgG;IACtF,gBAAgB,CAAC,MAAmB,EAAE,OAA+D,EAAE;QAChH,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE;YACtC,GAAG,IAAI;YACP,aAAa,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,CAAC;YAC7D,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;YACrD,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC;SAC7D,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;QAC3B,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,0FAA0F;IAChF,UAAU;QACnB,OAAO,IAAI,CAAC,WAAW,CAAC;IACzB,CAAC;IAQD;;;OAGG;IACO,KAAK,CAAC,IAA8B,IAAS,CAAC;IAExD;;;;OAIG;IACO,QAAQ,CAAC,MAAc,EAAE,OAAe,IAAS,CAAC;IAE5D;;;;;OAKG;IACO,MAAM,CAAC,KAAuC,IAAS,CAAC;IAE1D,wBAAwB;QAC/B,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC;QACvC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,EAAE;YACxD,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC;QACxC,CAAC,CAAC,CAAC;IACJ,CAAC;IAEO,cAAc,CAAC,MAAoB;QAC1C,IAAI,OAAO,oBAAoB,KAAK,WAAW;YAC9C,OAAO;QACR,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,oBAAoB,CAAC,CAAC,OAAO,EAAE,EAAE;YAC5E,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC3C,IAAI,MAAM;gBACT,IAAI,CAAC,UAAU,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC;QAC3C,CAAC,CAAC,CAAC,CAAC;QACJ,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACK,WAAW,CAAC,GAA6B,EAAE,OAAe,EAAE,QAAgB;QACnF,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;YACtC,OAAO;QAER,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC;QACtC,IAAI,CAAC,QAAQ;YACZ,OAAO;QAER,2CAA2C;QAC3C,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACxB,IAAI,CAAC;gBACJ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACjB,CAAC;YACD,MAAM,CAAC,CAAC,kDAAkD,CAAC,CAAC;YAC5D,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC1B,CAAC;QAED,qEAAqE;QACrE,uEAAuE;QACvE,wEAAwE;QACxE,oBAAoB;QACpB,IAAI,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC;QAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,IAAI,CAAC;gBACJ,MAAM,GAAG,QAAQ,CAAC,YAAY,EAAE,CAAC;YAClC,CAAC;YACD,MAAM,CAAC;gBAAC,OAAO;YAAC,CAAC;YACjB,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;QAC5B,CAAC;QAED,qEAAqE;QACrE,oDAAoD;QACpD,MAAM,OAAO,GAAuB,QAAQ,CAAC,aAAa,EAAE;YAC3D,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE;YACf,CAAC,CAAC;gBACA,GAAG,MAAM;gBACT,OAAO;aACP,CAAC;QACJ,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;QAE5B,IAAI,CAAC;YACJ,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,GAAG,EAAE,CAAC;YACZ,IAAI,CAAC,MAAM,CAAC;gBACX,IAAI,EAAE,6BAA6B;gBACnC,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,sGAAsG;gBAC/G,KAAK,EAAE,GAAG;aACV,CAAC,CAAC;YACH,OAAO;QACR,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC;;AAGF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,qBAAiE,SAAQ,mBAAsB;IAC3G,MAAM,CAAmB,EAAE,GAAW,UAAU,CAAC;IACjD,MAAM,CAAmB,OAAO,GAAW,OAAO,CAAC;IACnD,MAAM,CAAmB,WAAW,GAAW,+CAA+C,CAAC;IAE5E,MAAM,CAAC,GAA6B,EAAE,KAAyB;QACjF,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC5B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAC7B,OAAO;QACR,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC;QACrC,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC;QACvC,IAAI,WAAW,KAAK,CAAC,IAAI,YAAY,KAAK,CAAC;YAC1C,OAAO;QAER,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC;QAClB,GAAG,CAAC,WAAW,GAAG,SAAS,CAAC;QAC5B,GAAG,CAAC,SAAS,EAAE,CAAC;QAChB,MAAM,UAAU,GAAG,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC;QAC7C,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;YAC3C,IAAI,CAAC,KAAK,CAAC;gBACV,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;;gBACb,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACtB,CAAC,IAAI,UAAU,CAAC;QACjB,CAAC;QACD,GAAG,CAAC,MAAM,EAAE,CAAC;IACd,CAAC;;AAGF,oGAAoG;AACpG,MAAM,CAAC,MAAM,qBAAqB,GAAG,qBAAqB,CAAC"}
@@ -102,7 +102,7 @@ export interface PluginAdvisory {
102
102
  * Use this to advise specifically inside a `before*` handler — works for
103
103
  * core events AND plugin-defined custom events.
104
104
  *
105
- * Example: `duringEvent: 'beforePlay'` matches mutations inside a beforePlay
105
+ * E.g. `duringEvent: 'beforePlay'` matches mutations inside a beforePlay
106
106
  * handler. `duringEvent: 'plugin:my-plugin:beforeFoo'` matches mutations
107
107
  * inside another plugin's custom before-event handler.
108
108
  */
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * Translation bundle map. Outer key is a BCP-47 language tag; inner map is
3
- * key → translated string. Example: `{ en: { 'core.network.timeout': 'Connection timed out' }, nl: { ... } }`.
3
+ * key → translated string. E.g. `{ en: { 'core.network.timeout': 'Connection timed out' }, nl: { ... } }`.
4
4
  */
5
5
  export type Translations = Record<string, Record<string, string>>;
6
6
  /**
package/package.json CHANGED
@@ -1,7 +1,8 @@
1
1
  {
2
2
  "name": "@nomercy-entertainment/nomercy-player-core",
3
3
  "type": "module",
4
- "version": "2.2.7",
4
+ "version": "2.3.0",
5
+ "packageManager": "yarn@4.18.1",
5
6
  "description": "NoMercy player core — shared spine for nomercy-music-player and nomercy-video-player. Plugin runtime, event system, lifecycle helpers, streams, cues, errors, auth.",
6
7
  "author": {
7
8
  "name": "NoMercy Entertainment",
@@ -205,6 +206,7 @@
205
206
  "MIGRATION.md",
206
207
  "RELEASING.md",
207
208
  "SECURITY.md",
209
+ "THIRD-PARTY-NOTICES.md",
208
210
  "dist",
209
211
  "scripts"
210
212
  ],
@@ -222,7 +224,7 @@
222
224
  "lint:fix": "eslint . --fix --max-warnings 0",
223
225
  "test": "vitest run",
224
226
  "test:watch": "vitest",
225
- "prepublishOnly": "npm run build"
227
+ "prepublishOnly": "yarn build"
226
228
  },
227
229
  "dependencies": {
228
230
  "hls.js": "^1.6.0"
@@ -240,7 +242,7 @@
240
242
  "vite": "^8.0.13",
241
243
  "vitest": "^4.1.11"
242
244
  },
243
- "overrides": {
245
+ "resolutions": {
244
246
  "katex": "^0.18.2"
245
247
  }
246
248
  }