@vkontakte/videoplayer-core 2.0.171 → 2.0.172-beta.0

package/types/providers/utils/Abr/rules/video/bufferRule.d.ts

@@ -1,4 +1,4 @@
-import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext } from "../../types";
+import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext, RuleLogData } from "../../types";
 import type { IVideoTrack } from "../../../../../player/types";
 import type { Nullable } from "@vkontakte/videoplayer-shared";
 import { LimitAboveRule } from "../limitAboveRule";
@@ -12,6 +12,6 @@ type BufferRuleLogsArgs = [currentVideoTrack: Nullable<IVideoTrack>, lastVideoTr
 export declare class BufferRule extends LimitAboveRule<IVideoTrack, IVideoAbrContext, BufferRuleLogsArgs> implements IAbrRule<IVideoTrack, IVideoAbrContext> {
 	constructor(phaseConfig: RulePhaseConfig);
 	execute(context: IVideoAbrContext): IAbrRuleResolution<IVideoTrack>;
-	protected createLogMessage(selectedTrack: IVideoTrack, currentVideoTrack: Nullable<IVideoTrack>, lastVideoTrackSelected: Nullable<IVideoTrack>, forwardBufferHealth: Nullable<number>, abrTuning: ITuningConfig["autoTrackSelection"]): string;
+	protected createLogData(selectedTrack: IVideoTrack, currentVideoTrack: Nullable<IVideoTrack>, lastVideoTrackSelected: Nullable<IVideoTrack>, forwardBufferHealth: Nullable<number>, abrTuning: ITuningConfig["autoTrackSelection"]): RuleLogData;
 }
 export {};

package/types/providers/utils/Abr/rules/video/fitsContainerRule.d.ts

@@ -1,4 +1,4 @@
-import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext } from "../../types";
+import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext, RuleLogData } from "../../types";
 import type { IVideoTrack } from "../../../../../player/types";
 import type { IRectangle, Nullable } from "@vkontakte/videoplayer-shared";
 import { LimitAboveRule } from "../limitAboveRule";
@@ -9,7 +9,7 @@ type FitsContainerLogsArgs = [containerSizeLimit: Nullable<IContainerSizeLimit>,
 export declare class FitsContainerRule extends LimitAboveRule<IVideoTrack, IVideoAbrContext, FitsContainerLogsArgs> implements IAbrRule<IVideoTrack, IVideoAbrContext> {
 	constructor(phaseConfig: RulePhaseConfig);
 	execute(context: IVideoAbrContext): IAbrRuleResolution<IVideoTrack>;
-	protected createLogMessage(selectedTrack: IVideoTrack, containerSizeLimit: Nullable<IContainerSizeLimit>, containerSizeFactor: number, abrTuning: ITuningConfig["autoTrackSelection"]): string;
+	protected createLogData(selectedTrack: IVideoTrack, containerSizeLimit: Nullable<IContainerSizeLimit>, containerSizeFactor: number, abrTuning: ITuningConfig["autoTrackSelection"]): RuleLogData;
 	private getContainerSizeLimit;
 }
 export {};

package/types/providers/utils/Abr/rules/video/insufficientBufferRule.d.ts

@@ -1,4 +1,4 @@
-import type { IAbrRule, IAbrRuleResolution, IRuleInitContext, IVideoAbrContext } from "../../types";
+import type { IAbrRule, IAbrRuleResolution, IRuleInitContext, IVideoAbrContext, RuleLogData } from "../../types";
 import type { IVideoTrack } from "../../../../../player/types";
 import type { Milliseconds } from "@vkontakte/videoplayer-shared";
 import { LimitAboveRule } from "../limitAboveRule";
@@ -10,6 +10,6 @@ export declare class InsufficientBufferRule extends LimitAboveRule<IVideoTrack,
 	override init(initContext: IRuleInitContext): void;
 	execute(context: IVideoAbrContext): IAbrRuleResolution<IVideoTrack>;
 	private selectThroughputAwareFallback;
-	protected createLogMessage(selectedTrack: IVideoTrack, forwardBufferDuration: Milliseconds | undefined, thresholdMs: Milliseconds, triggered: boolean, suppressedByGrace: boolean): string;
+	protected createLogData(selectedTrack: IVideoTrack, forwardBufferDuration: Milliseconds | undefined, thresholdMs: Milliseconds, triggered: boolean, suppressedByGrace: boolean): RuleLogData;
 }
 export {};

package/types/providers/utils/Abr/rules/video/lowerLimitRule.d.ts

@@ -1,4 +1,4 @@
-import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext } from "../../types";
+import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext, RuleLogData } from "../../types";
 import type { IVideoTrack } from "../../../../../player/types";
 import type { Nullable, QualityLimits } from "@vkontakte/videoplayer-shared";
 import { type ExactVideoQuality } from "@vkontakte/videoplayer-shared";
@@ -8,6 +8,6 @@ type LowerLimitLogsArgs = [limitsAreInvalid: boolean, lowestAvailableQuality: Nu
 export declare class LowerLimitRule extends LimitBelowRule<IVideoTrack, IVideoAbrContext, LowerLimitLogsArgs> implements IAbrRule<IVideoTrack, IVideoAbrContext> {
 	constructor(phaseConfig: RulePhaseConfig);
 	execute(context: IVideoAbrContext): IAbrRuleResolution<IVideoTrack>;
-	protected createLogMessage(selectedTrack: IVideoTrack, limitsAreInvalid: boolean, lowestAvailableQuality: Nullable<ExactVideoQuality>, highestAvailableQuality: Nullable<ExactVideoQuality>, limits: QualityLimits): string;
+	protected createLogData(selectedTrack: IVideoTrack, limitsAreInvalid: boolean, lowestAvailableQuality: Nullable<ExactVideoQuality>, highestAvailableQuality: Nullable<ExactVideoQuality>, limits: QualityLimits): RuleLogData;
 }
 export {};

package/types/providers/utils/Abr/rules/video/stallsRule.d.ts

@@ -1,4 +1,4 @@
-import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext } from "../../types";
+import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext, RuleLogData } from "../../types";
 import type { IVideoTrack } from "../../../../../player/types";
 import type { Kbps, Nullable } from "@vkontakte/videoplayer-shared";
 import { LimitAboveRule } from "../limitAboveRule";
@@ -11,9 +11,13 @@ export declare class StallsRule extends LimitAboveRule<IVideoTrack, IVideoAbrCon
 	private lastStallDurationRestriction;
 	private maxQualityLimitOnStall;
 	private predictedThroughputWithoutData;
+	private restrictionTracer;
+	private restrictionStartedAt;
 	constructor(phaseConfig: RulePhaseConfig);
 	execute(context: IVideoAbrContext): IAbrRuleResolution<IVideoTrack>;
-	protected createLogMessage(selectedTrack: IVideoTrack, forwardBufferHealth: Nullable<number>, playbackRate: number, reserve: Kbps, playbackRateFactor: number, bitrateFactor: number, tuning: ITuningConfig): string;
+	protected createLogData(selectedTrack: IVideoTrack, forwardBufferHealth: Nullable<number>, playbackRate: number, reserve: Kbps, playbackRateFactor: number, bitrateFactor: number, tuning: ITuningConfig): RuleLogData;
+	private traceRestrictionSet;
+	private traceRestrictionReset;
 	private updateStallQualityLimits;
 }
 export {};

package/types/providers/utils/Abr/rules/video/throughputRule.d.ts

@@ -1,4 +1,4 @@
-import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext } from "../../types";
+import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext, RuleLogData } from "../../types";
 import type { IVideoTrack } from "../../../../../player/types";
 import type { Kbps, Nullable } from "@vkontakte/videoplayer-shared";
 import { LimitAboveRule } from "../limitAboveRule";
@@ -8,6 +8,6 @@ type ThroughputLogsArgs = [forwardBufferHealth: Nullable<number>, playbackRate:
 export declare class ThroughputRule extends LimitAboveRule<IVideoTrack, IVideoAbrContext, ThroughputLogsArgs> implements IAbrRule<IVideoTrack, IVideoAbrContext> {
 	constructor(phaseConfig: RulePhaseConfig);
 	execute(context: IVideoAbrContext): IAbrRuleResolution<IVideoTrack>;
-	protected createLogMessage(selectedTrack: IVideoTrack, forwardBufferHealth: Nullable<number>, playbackRate: number, reserve: Kbps, playbackRateFactor: number, bitrateFactor: number, estimatedThroughput: Kbps, phase: AbrPhase | undefined, tuning: ITuningConfig): string;
+	protected createLogData(selectedTrack: IVideoTrack, forwardBufferHealth: Nullable<number>, playbackRate: number, reserve: Kbps, playbackRateFactor: number, bitrateFactor: number, estimatedThroughput: Kbps, phase: AbrPhase | undefined, tuning: ITuningConfig): RuleLogData;
 }
 export {};

package/types/providers/utils/Abr/rules/video/tvDisabledVideoTrackRule.d.ts

@@ -1,9 +1,9 @@
-import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext } from "../../types";
+import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext, RuleLogData } from "../../types";
 import type { IVideoTrack } from "../../../../../player/types";
 import { LimitAboveRule } from "../limitAboveRule";
 import type { RulePhaseConfig } from "../../controllers/abrPhaseController";
 export declare class TvDisabledVideoTrackRule extends LimitAboveRule<IVideoTrack, IVideoAbrContext> implements IAbrRule<IVideoTrack, IVideoAbrContext> {
 	constructor(phaseConfig: RulePhaseConfig);
 	execute(context: IVideoAbrContext): IAbrRuleResolution<IVideoTrack>;
-	protected createLogMessage(selectedTrack: IVideoTrack): string;
+	protected createLogData(selectedTrack: IVideoTrack): RuleLogData;
 }

package/types/providers/utils/Abr/rules/video/upperLimitRule.d.ts

@@ -1,4 +1,4 @@
-import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext } from "../../types";
+import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext, RuleLogData } from "../../types";
 import type { IVideoTrack } from "../../../../../player/types";
 import type { Nullable, QualityLimits, VideoQuality } from "@vkontakte/videoplayer-shared";
 import { type ExactVideoQuality } from "@vkontakte/videoplayer-shared";
@@ -63,7 +63,7 @@ type UpperLimitsLogsArgs = [limitsAreInvalid: boolean, lowestAvailableQuality: N
 export declare class UpperLimitsRule extends LimitAboveRule<IVideoTrack, IVideoAbrContext, UpperLimitsLogsArgs> implements IAbrRule<IVideoTrack, IVideoAbrContext> {
 	constructor(phaseConfig: RulePhaseConfig);
 	execute(context: IVideoAbrContext): IAbrRuleResolution<IVideoTrack>;
-	protected createLogMessage(selectedTrack: IVideoTrack, limitsAreInvalid: boolean, lowestAvailableQuality: Nullable<ExactVideoQuality>, highestAvailableQuality: Nullable<ExactVideoQuality>, visible: boolean, limits: QualityLimits, backgroundVideoQualityLimit: VideoQuality, effectiveType: string | undefined, connectionDataQualityLimit: ExactVideoQuality | undefined): string;
+	protected createLogData(selectedTrack: IVideoTrack, limitsAreInvalid: boolean, lowestAvailableQuality: Nullable<ExactVideoQuality>, highestAvailableQuality: Nullable<ExactVideoQuality>, visible: boolean, limits: QualityLimits, backgroundVideoQualityLimit: VideoQuality, effectiveType: string | undefined, connectionDataQualityLimit: ExactVideoQuality | undefined): RuleLogData;
 	private getConnection;
 	private resolveConnectionDataQualityLimit;
 }

package/types/providers/utils/Abr/selectTrackByRules.d.ts

@@ -0,0 +1,23 @@
+import type { IComponentLogger, IRectangle, ITracer, Kbps, Milliseconds, Nullable, QualityLimits } from "@vkontakte/videoplayer-shared";
+import type { IVideoTrack } from "../../../player/types";
+import type { ITuningConfig } from "../../../utils/tuningConfig";
+export interface ISelectTrackByRulesContext {
+	videoTracks: IVideoTrack[];
+	tuning: ITuningConfig;
+	abrLogger: IComponentLogger;
+	tracer: ITracer;
+	estimatedThroughput: Kbps;
+	container?: Nullable<IRectangle>;
+	panelSize?: Nullable<IRectangle>;
+	limits?: QualityLimits;
+	playbackRate?: number;
+	forwardBufferHealth?: number;
+	forwardBufferDuration?: Milliseconds;
+	visible?: boolean;
+	currentVideoTrack?: Nullable<IVideoTrack>;
+	reserve?: Kbps;
+	isLive?: boolean;
+	element?: HTMLMediaElement;
+}
+export declare const defaultEmptyArrayErrorMessage = "Assertion \"ABR Tracks is empty array\" failed";
+export declare function selectTrackByRules(context: ISelectTrackByRulesContext): IVideoTrack;

package/types/providers/utils/Abr/types.d.ts

@@ -1,5 +1,5 @@
 import type { IAudioTrack, IBaseTrack, IVideoTrack } from "../../../player/types";
-import type { Byte, IComponentLogger, IObservable, IRectangle, IValueSubject, Kbps, Milliseconds, Nullable, QualityLimits } from "@vkontakte/videoplayer-shared";
+import type { Byte, IComponentLogger, IObservable, IRectangle, ITracer, IValueSubject, Kbps, Milliseconds, Nullable, QualityLimits } from "@vkontakte/videoplayer-shared";
 import type { ITuningConfig } from "../../../utils/tuningConfig";
 import type { Representation, Segment } from "../parsers/types";
 import type { ElementSizeManager } from "../HTMLVideoElement/ElementSizeManager";
@@ -15,15 +15,13 @@ export declare enum VideoRuleName {
 	Buffer = "buffer_rule",
 	Bola = "bola_rule",
 	FitsContainer = "fits_container_rule",
-	FailedVideoTrack = "failed_video_track_rule",
 	TvDisabledVideoTrack = "tv_disabled_video_track_rule",
 	Stalls = "stalls_rule",
 	LowerLimit = "lower_limit_rule",
 	UpperLimit = "upper_limit_rule",
 	Throughput = "throughput_rule",
 	AbandonRequest = "abandon_request_rule",
-	InsufficientBuffer = "insufficient_buffer_rule",
-	DownloadTime = "download_time_rule"
+	InsufficientBuffer = "insufficient_buffer_rule"
 }
 export declare enum AudioRuleName {
 	MinAudioForVideo = "min_audio_for_video_rule",
@@ -41,7 +39,6 @@ export interface IUpdatableAbrManagerContext {
 	desiredVideoTrack: Nullable<IVideoTrack>;
 	limits: QualityLimits;
 	forwardBufferHealth?: number;
-	forwardBufferTarget: Milliseconds;
 	forwardVideoBufferRepresentations: Nullable<Map<Representation["id"], Segment[]>>;
 	forwardAudioBufferRepresentations: Nullable<Map<Representation["id"], Segment[]>>;
 	forwardBufferDuration?: Milliseconds;
@@ -59,8 +56,8 @@ export interface IInitAbrManagerContext {
 	rtt$: IValueSubject<Milliseconds>;
 	throughputVariance$?: IValueSubject<number>;
 	element: HTMLMediaElement;
-	failedVideoTrack: Nullable<IVideoTrack>;
 	abrLogger: IComponentLogger;
+	tracer: ITracer;
 	panelSize?: IRectangle;
 }
 export interface IVideoElementAbrManagerContext {
@@ -77,12 +74,13 @@ export interface IAudioTracksContext {
 	audioTracksDesc: IAudioTrack[];
 }
 export type IAbrManagerContext = Omit<IUpdatableAbrManagerContext, "videoTracks" | "audioTracks"> & IVideoElementAbrManagerContext & IInitAbrManagerContext & IVideoTracksContext & IAudioTracksContext;
+export type RuleLogData = Record<string, string | number | boolean | undefined>;
 export interface IAbrRuleResolution<T extends IBaseTrack> {
 	track: T;
 	confidence: number;
 	type: RuleType;
 	name: string;
-	logMessage: string;
+	logData: RuleLogData;
 }
 export interface IRuleInitContext extends IInitAbrManagerContext {}
 export interface IAbrRule<
@@ -105,6 +103,7 @@ export interface IBaseAbrControllerContext extends IVideoTracksContext {
 	lastVideoTrackSelected: Nullable<IVideoTrack>;
 	tuning: ITuningConfig;
 	abrLogger: IComponentLogger;
+	tracer: ITracer;
 	estimatedThroughput: Kbps;
 	reserve: Kbps;
 	forwardBufferHealth: Nullable<number>;
@@ -122,7 +121,6 @@ export interface IVideoAbrContext extends IBaseAbrControllerContext {
 	container: Nullable<IRectangle>;
 	panelSize: Nullable<IRectangle>;
 	forwardBufferRepresentations: Nullable<Map<Representation["id"], Segment[]>>;
-	forwardBufferTarget: Milliseconds;
 	limits: QualityLimits;
 	visible: boolean;
 	severeStallOccurred: boolean;

package/types/providers/utils/Abr/utils.d.ts

@@ -1,7 +1,6 @@
 import type { Kbps, Milliseconds, Nullable } from "@vkontakte/videoplayer-shared";
 import type { IAudioTrack, IBaseTrack, IVideoTrack } from "../../../player/types";
-import type { Segment } from "../parsers/types";
-export declare const computeForwardBitrate: (segments: Nullable<Segment[]>) => Kbps;
+import type { Representation, Segment } from "../parsers/types";
 export declare const bufferToPlaybackMs: (contentMs: Milliseconds | undefined, playbackRate: number) => Milliseconds;
 export declare enum CompareTrack {
 	Descending = -1,
@@ -15,3 +14,5 @@ export declare const isLowerTrack: <T extends IBaseTrack>(track1: T, track2: T)
 export declare const logBase: (base: number, x: number) => number;
 export declare const bitrateFactorFromBufferLevel: (forwardBufferHealth: number, emptyFactor: number, fullFactor: number) => number;
 export declare const getMinPossibleAudioForVideo: (videoTrack: Nullable<IVideoTrack>, sortedVideoTracksAsc: IVideoTrack[], sortedAudioTracksAsc: IAudioTrack[], minVideoAudioRatio: number) => IAudioTrack | undefined;
+export declare const getForwardBitrateKbps: (forwardBufferRepresentations: Nullable<Map<Representation["id"], Segment[]>>, videoTrack: Nullable<IVideoTrack>) => Kbps | undefined;
+export declare const isVideoTail: (remainingDurationMs: Nullable<Milliseconds>, mpdSegmentDurationMs: Nullable<Milliseconds>) => boolean;

package/types/providers/utils/HTMLVideoElement/destroy.d.ts

@@ -1 +1 @@
-export declare const destroy: (video: HTMLMediaElement, clearVideoElementInnerHTML: boolean) => void;
+export declare const destroy: (video: HTMLMediaElement) => void;

package/types/providers/utils/HTMLVideoElement/observable.d.ts

@@ -17,7 +17,7 @@ export interface IObservableVideo {
 	loadedMetadata$: IObservable<undefined>;
 	loadedData$: IObservable<undefined>;
 	isBuffering$: IObservable<boolean>;
-	currentBuffer$: IObservable<IRange<Seconds>>;
+	currentVideoBuffer$: IObservable<IRange<Seconds>>;
 	totalBufferDuration$: IObservable<Milliseconds>;
 	bufferRangeCount$: IObservable<number>;
 	volumeState$: IObservable<IVolumeState>;

package/types/providers/utils/HTMLVideoElement/pool.d.ts

@@ -1,7 +1,6 @@
 import type { ITuningConfig } from "../../../utils/tuningConfig";
-export type AllocateConstraints = Pick<ITuningConfig, "audioVideoSyncRate" | "disableYandexPiP" | "clearVideoElementInnerHTML" | "reuseOwnVideoElement">;
-type DisposeConstraints = Pick<ITuningConfig, "keepVideoElement" | "clearVideoElementInnerHTML" | "reuseOwnVideoElement">;
-export declare const allocate: (container: HTMLElement, { audioVideoSyncRate, disableYandexPiP, clearVideoElementInnerHTML, reuseOwnVideoElement }: ITuningConfig) => HTMLVideoElement;
+type DisposeConstraints = Pick<ITuningConfig, "reuseOwnVideoElement" | "clearAudioElementOnDispose">;
+export declare const allocate: (container: HTMLElement, { audioVideoSyncRate, disableYandexPiP, reuseOwnVideoElement }: ITuningConfig) => HTMLVideoElement;
 export declare const initializeAudio: (element: HTMLAudioElement) => HTMLAudioElement;
 export declare const dispose: (element: HTMLMediaElement, constraints: DisposeConstraints) => void;
 export {};

package/types/utils/ThroughputEstimator.d.ts

@@ -14,6 +14,8 @@ declare class ThroughputEstimator {
 	trackXHR(xhr: XMLHttpRequest): void;
 	trackStream(stream: ReadableStream, isLowLatency?: boolean): void;
 	addRawSpeed(size: Byte, time: Milliseconds, concurrency?: number, isLowLatency?: boolean): void;
+	private countActiveDownloads;
+	private isFastSample;
 	/**
 	* Стоит использовать только когда другие методы совсем не получается
 	*/

package/types/utils/buffer/isBrokenSegmentAppend.d.ts

@@ -0,0 +1,3 @@
+import type { IRange, Milliseconds } from "@vkontakte/videoplayer-shared";
+declare const _default: (buffered: IRange<Milliseconds>[], segment: IRange<Milliseconds>, tolerance: Milliseconds) => boolean;
+export default _default;

package/types/utils/buffer/timeRangesToIntervals.d.ts

@@ -0,0 +1,3 @@
+import type { IRange, Milliseconds } from "@vkontakte/videoplayer-shared";
+declare const _default: (timeRanges: TimeRanges) => IRange<Milliseconds>[];
+export default _default;

package/types/utils/timers.d.ts

@@ -0,0 +1,2 @@
+import type { ITimers } from "@vkontakte/videoplayer-shared";
+export declare const timers: ITimers;

package/types/utils/tuningConfig.d.ts

@@ -2,7 +2,7 @@ import type { VideoCodecName, VideoFormat } from "../player/types";
 import { WebmCodecStrategy } from "../enums/WebmCodecStrategy";
 import { AndroidPreferredFormat } from "../enums/AndroidPreferredFormat";
 import { IOSPreferredFormat } from "../enums/IOSPreferredFormat";
-import type { Byte, Kbps, Milliseconds, RecursivePartial, Seconds } from "@vkontakte/videoplayer-shared";
+import type { Byte, Kbps, Milliseconds, RecursivePartial, Seconds, TimerModule } from "@vkontakte/videoplayer-shared";
 import { type ExactVideoQuality, VideoQuality } from "@vkontakte/videoplayer-shared";
 import { AudioRuleName, VideoRuleName } from "../providers/utils/Abr/types";
 export type ITuningConfig = {
@@ -13,24 +13,23 @@ export type ITuningConfig = {
 		playingUnstableThresholdMs: Milliseconds;
 		/** Список имён включённых эвристик. Пустой массив = все эвристики выключены */
 		heuristics: string[];
+		/** Множитель уменьшения grace-таймаута при каждом поступлении данных в StartupHangupHeuristic */
+		hangupGraceDecayFactor: number;
+		/** Минимальный grace-таймаут (мс). При достижении — следующий decay возвращает 0 (немедленный expire) */
+		hangupGraceMinTimeoutMs: Milliseconds;
+		/**
+		* Если true — audible (не muted) хэнгап в hidden-вкладке откладывается до возврата на visible (reinit),
+		* desired state при этом не меняется.
+		* Если false — audible хэнгап в hidden-вкладке мониторится: данные перезапускают decay-таймер,
+		* при ≥3 поступлениях данных без завершения перехода — эскалация в switch_codec/switch_provider.
+		*/
+		deferAudibleHangupOnHiddenTab: boolean;
 	};
 	/**
-	* Если true, внутренний video элемент не будет уничтожаться при реините провайдера
-	* и при создании нового экземляра Player.
-	* Будет веcти себя аналогично элементу переданному снаружи
-	* Для кейса прямого использовани ядра
-	*/
-	keepVideoElement: boolean;
-	/**
-	* Временный флаг для тестирования очистки video элемента
-	* Если true, при очистке будет вызван innerHTML = '' для очистки дочерних элементов трэков
-	* В противном случае они размножаются
-	*/
-	clearVideoElementInnerHTML: boolean;
-	/**
 	* Включает очистку состояния плеера при вызове метода stop()
 	*/
 	allowPlayerReuse: boolean;
+	useWorkerTimers: TimerModule[];
 	throughputEstimator: {
 		type: "TwoEma" | "EmaAndMa";
 		emaAlphaSlow: number;
@@ -57,8 +56,19 @@ export type ITuningConfig = {
 		*    - fromCache — попадание в Cache API (doFetch дёргает onCacheHit);
 		*    - TTFB — headersReceivedAt - requestStartedAt < max(rtt*0.5, 2мс) (кэш ~0, реал ≥ RTT).
 		* 2. sanityCheck отключает порог time ≤ cacheThresholdSize → реальные быстрые сэмплы проходят.
+		* 3. Прошедший быстрый сэмпл применяется только если поднимает оценку: по объекту, который
+		*    укладывается в одно окно, наблюдаемое время — латентность, а не size/полоса, поэтому
+		*    он задаёт нижнюю границу и не может доказать, что сеть стала медленнее.
+		* 4. Финальный замер стрима делит полосу на параллельные загрузки, как промежуточные:
+		*    мелкий сегмент качается параллельно с аудио и другого замера не получает.
+		*    Параллельной считается загрузка, отдававшая байты внутри окна замера: открытая,
+		*    но молчащая (подвисла либо уже выкачала своё и ждёт done) полосу не занимает.
 		* Честный кэш (мгновенная отдача → rate > 1 Гбит/с) по-прежнему режется проверкой rate выше.
 		*
+		* Пункты 3 и 4 добавлены после эксперимента 37621: без них включённые быстрые сэмплы
+		* систематически занижали оценку, ABR держал низкое качество и сегменты оставались
+		* мелкими — петля с положительной обратной связью, вердикт NO-GO.
+		*
 		* По умолчанию false — поведение не меняется.
 		*/
 		measureFastSamples: boolean;
@@ -119,6 +129,7 @@ export type ITuningConfig = {
 		activeVideoAreaThreshold: number;
 		trafficSavingLimit: ExactVideoQuality;
 		highQualityLimit: ExactVideoQuality;
+		lowQualityTelemetryLimit: ExactVideoQuality;
 	};
 	stallsManager: {
 		enabled: boolean;
@@ -159,7 +170,6 @@ export type ITuningConfig = {
 		forwardBufferTargetManual: Milliseconds;
 		forwardBufferTargetPreload: Milliseconds;
 		audioBufferAheadOfVideoMs: Milliseconds;
-		useDynamicBufferTarget: boolean;
 		seekBiasInTheEnd: Milliseconds;
 		maxSegmentDurationLeftToSelectNextSegment: Milliseconds;
 		minSafeBufferThreshold: number;
@@ -180,16 +190,15 @@ export type ITuningConfig = {
 		useNewRepresentationSwitch: boolean;
 		useDelayedRepresentationSwitch: boolean;
 		useSmartRepresentationSwitch: boolean;
-		stallForceSeekOncePerStall: boolean;
+		brokenSegmentAppendDetection: boolean;
+		brokenSegmentAppendTolerance: Milliseconds;
 		useFetchPriorityHints: boolean;
-		useAbortMSEFix: boolean;
 		enableBaseUrlSupport: boolean;
 		maxSegmentRetryCount: number;
 		sourceOpenTimeout: number;
 		vktvAbrThrottle: number;
 		timeupdateEventTickThrottle: number;
 		fetcherBufferOptimisation: boolean;
-		codecsPrioritizeEnabled: boolean;
 		usePersistentGaps: boolean;
 		abrThrottle: number;
 		useVideoElementWaitingCurrentTimeReassign: boolean;
@@ -203,14 +212,10 @@ export type ITuningConfig = {
 		tickMaintainInterval: Milliseconds;
 		minSafeBufferToPlay: Milliseconds;
 		useBufferHoldingOnlyOnStall: boolean;
-		useNewAbr: boolean;
 		useAbrPhases: boolean;
 		abrVideoRules: VideoRuleName[];
 		abrAudioRules: AudioRuleName[];
-		useDynamicBirtateRule: boolean;
-		useNewFailoverLogic: boolean;
 		useFailoverHostsOnAllProviderCrash: boolean;
-		videoTrackBanAfterProviderFail: Milliseconds;
 		saveData3gQualityLimit: ExactVideoQuality;
 		saveData2gQualityLimit: ExactVideoQuality;
 		useConnectionDataUpperLimit: boolean;
@@ -238,26 +243,28 @@ export type ITuningConfig = {
 			budgetFactor: number;
 			fallbackSegmentDurationMs: Milliseconds;
 		};
-		dynamicBufferTarget: {
-			maxMs: Milliseconds;
-			optimisticHeadroomLow: number;
-			optimisticHeadroomHigh: number;
-			weakThroughputLowKbps: Kbps;
-			weakThroughputHighKbps: Kbps;
-			maxFactor: number;
-		};
 		videoStreamRepresentaionsFilter: [VideoQuality, number, VideoCodecName][];
 		filterOnDemandQualityList: boolean;
 		dashMaxTvVideoQuality: boolean;
 		checkRepresentationCanPlayType: Extract<CanPlayTypeResult, "maybe" | "probably"> | false;
 		preloadFirstSegment: boolean;
 		maxQualityForFirstSegmentPreload: ExactVideoQuality;
-		downloadTime: {
-			minLookaheadSegments: number;
-			safetyFactor: number;
-			bootstrapBufferMs: Milliseconds;
-			demandTolerance: number;
-		};
+		/** Включает отправку телеметрии трейсера (resume) при превышении stall watchdog */
+		tracerResumeOnUnexpectedStall: boolean;
+		/**
+		* При отмене signal текущей задачи sourceBufferTaskQueue (например, через
+		* `maintainAbortController.abort()` в `prepareSeek`) прерывать зависшую MSE-операцию
+		* через `buffer.abort()`. Без этого `completeTask` не вызовется при залипшем
+		* SourceBuffer и промис `append`/`remove` зависнет навечно — `prepareSeek`
+		* застрянет на `await maintainMutexPromise` (V3 deadlock), stall растёт до
+		* `crashOnStallTimeout=25с`.
+		*
+		* По умолчанию false (opt-in). Дешёвый фикс, но поведенческое изменение:
+		* единственный побочный эффект — лишний `buffer.abort()` при штатной отмене
+		* maintain (например, при обычном seek), но MSE `abort()` без активной операции
+		* — no-op по спеке. Включать поэтапно, начиная с процента.
+		*/
+		abortSourceBufferOnSignal: boolean;
 	};
 	dashCmafLive: {
 		externalStopControl: boolean;
@@ -355,7 +362,8 @@ export type ITuningConfig = {
 	alwaysAbortPreviousSwitch: boolean;
 	useDashProviderVirtual: boolean;
 	useDashProviderVirtualMobile: boolean;
-	useNewAutoSelectVideoTrack: boolean;
+	useDashLiveProviderVirtual: boolean;
+	useDashLiveProviderVirtualMobile: boolean;
 	useSafariEndlessRequestBugfix: boolean;
 	/**
 	* Ручка для фикса сброса playbackRate при перемотке live-трансляции на Safari.
@@ -454,6 +462,19 @@ export type ITuningConfig = {
 	useDurationFromSegments: boolean;
 	/** включен режим проигрывания только аудио (без видео) */
 	audioOnly: boolean;
+	/**
+	* В audio-режиме при dispose провайдера очищает внешний <audio> (снятие src + load())
+	* вместо destroy(), который удаляет элемент из DOM.
+	*/
+	clearAudioElementOnDispose: boolean;
+	/**
+	* Переводить провайдер в READY по loadedmetadata вместо canplay.
+	* canplay означает, что видео уже может играться, что избыточно для READY —
+	* достаточно получить манифест (loadedmetadata).
+	* Применяется только когда желаемое состояние — READY (preload): при автоплее
+	* провайдер по-прежнему ждёт canplay, чтобы play() не вызывался до появления данных.
+	*/
+	readyOnLoadedMetadata: boolean;
 };
 export type IOptionalTuningConfig = RecursivePartial<ITuningConfig>;
 export declare const fillDefault: (partial: IOptionalTuningConfig) => ITuningConfig;

package/types/providers/ProviderContainer/Mayday/heuristics/HangupHeuristic.d.ts

@@ -1,23 +0,0 @@
-import { Subject } from "@vkontakte/videoplayer-shared";
-import type { IError } from "@vkontakte/videoplayer-shared";
-import type { IHeuristicDeps, IMaydayEvent } from "../types";
-import type { IAsyncHeuristic, HeuristicResult } from "./IHeuristic";
-export declare class HangupHeuristic implements IAsyncHeuristic {
-	private deps;
-	static readonly heuristicName = "HangupHeuristic";
-	readonly type = "async";
-	readonly recommendation$: Subject<IMaydayEvent>;
-	private timerId;
-	private sub;
-	private error;
-	private manifestRequested;
-	private manifestRequestedAt;
-	private manifestReceivedMs;
-	constructor(deps: IHeuristicDeps);
-	analyze(error: IError): HeuristicResult;
-	private restartTimer;
-	private expire;
-	private cancel;
-	reset(): void;
-	destroy(): void;
-}

package/types/providers/utils/Abr/rules/video/downloadTimeRule.d.ts

@@ -1,15 +0,0 @@
-import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext } from "../../types";
-import type { IVideoTrack } from "../../../../../player/types";
-import type { Kbps, Milliseconds } from "@vkontakte/videoplayer-shared";
-import { LimitAboveRule } from "../limitAboveRule";
-import type { RulePhaseConfig } from "../../controllers/abrPhaseController";
-type DownloadTimeLogsArgs = [estimatedThroughput: Kbps, forwardBufferDuration: Milliseconds, simulatedFinalBufferMs: Milliseconds | null];
-export declare class DownloadTimeRule extends LimitAboveRule<IVideoTrack, IVideoAbrContext, DownloadTimeLogsArgs> implements IAbrRule<IVideoTrack, IVideoAbrContext> {
-	constructor(phaseConfig: RulePhaseConfig);
-	execute(context: IVideoAbrContext): IAbrRuleResolution<IVideoTrack>;
-	private buildReferenceTimeline;
-	private resolveLookaheadCount;
-	private simulate;
-	protected createLogMessage(selectedTrack: IVideoTrack, estimatedThroughput: Kbps, forwardBufferDuration: Milliseconds, simulatedFinalBufferMs: Milliseconds | null): string;
-}
-export {};

package/types/providers/utils/Abr/rules/video/failedVideoTrackRule.d.ts

@@ -1,14 +0,0 @@
-import type { IAbrRule, IAbrRuleResolution, IRuleInitContext, IVideoAbrContext } from "../../types";
-import type { IVideoTrack } from "../../../../../player/types";
-import type { Nullable } from "@vkontakte/videoplayer-shared";
-import { LimitAboveRule } from "../limitAboveRule";
-import type { RulePhaseConfig } from "../../controllers/abrPhaseController";
-type FailedVideoTracLogsArgs = [banTrack: Nullable<IVideoTrack>];
-export declare class FailedVideoTrackRule extends LimitAboveRule<IVideoTrack, IVideoAbrContext, FailedVideoTracLogsArgs> implements IAbrRule<IVideoTrack, IVideoAbrContext> {
-	protected banTrack: Nullable<IVideoTrack>;
-	constructor(phaseConfig: RulePhaseConfig);
-	init(initContext: IRuleInitContext): void;
-	execute(context: IVideoAbrContext): IAbrRuleResolution<IVideoTrack>;
-	protected createLogMessage(selectedTrack: IVideoTrack, banTrack: Nullable<IVideoTrack>): string;
-}
-export {};

package/types/utils/autoSelectTrack.d.ts

@@ -1,37 +0,0 @@
-import type { ITuningConfig } from "./tuningConfig";
-import type { Kbps, Milliseconds, IRectangle, QualityLimits, IComponentLogger, Nullable } from "@vkontakte/videoplayer-shared";
-import { type ExactVideoQuality } from "@vkontakte/videoplayer-shared";
-import type { IAudioTrack, IBaseTrack, IVideoTrack } from "../player/types";
-interface IConstraints<T extends IBaseTrack> {
-	container?: IRectangle;
-	estimatedThroughput?: Kbps;
-	tuning: ITuningConfig["autoTrackSelection"];
-	limits?: QualityLimits;
-	reserve?: Kbps;
-	playbackRate?: number;
-	forwardBufferHealth?: number;
-	current?: T;
-	failedVideoTrack?: Nullable<T>;
-	visible?: boolean;
-	history?: TrackHistory<T>;
-	droppedVideoMaxQualityLimit?: ExactVideoQuality;
-	stallsVideoMaxQualityLimit?: ExactVideoQuality;
-	stallsPredictedThroughput?: Kbps;
-	abrLogger: IComponentLogger;
-	panelSize?: IRectangle;
-}
-export declare class TrackHistory<T extends IBaseTrack> {
-	last: T | undefined;
-	history: Record<IBaseTrack["id"], Milliseconds>;
-	recordSelection(track: T): void;
-	recordSwitch(track: T | undefined): void;
-	clear(): void;
-}
-export declare const defaultEmptyArrayErrorMessage = "Assertion \"ABR Tracks is empty array\" failed";
-export declare const getMinPossibleAudioForVideoOld: (videoTrack: IVideoTrack, videoTracks: IVideoTrack[], audioTracks: IAudioTrack[], minVideoAudioRatio: number) => IAudioTrack | undefined;
-export declare const getMinPossibleAudioForVideoNew: (videoTrack: IVideoTrack, videoTracks: IVideoTrack[], audioTracks: IAudioTrack[], minVideoAudioRatio: number) => IAudioTrack | undefined;
-export declare const autoSelectVideoTrackNew: (videoTracks: IVideoTrack[], { container, estimatedThroughput, tuning, limits, reserve, forwardBufferHealth, playbackRate, current, failedVideoTrack, history, visible, droppedVideoMaxQualityLimit, stallsVideoMaxQualityLimit, stallsPredictedThroughput, abrLogger, panelSize }: IConstraints<IVideoTrack>) => IVideoTrack;
-export declare const autoSelectVideoTrackOld: (videoTracks: IVideoTrack[], { container, estimatedThroughput, tuning, limits, reserve, forwardBufferHealth, playbackRate, current, failedVideoTrack, history, visible, droppedVideoMaxQualityLimit, stallsVideoMaxQualityLimit, stallsPredictedThroughput, abrLogger, panelSize }: IConstraints<IVideoTrack>) => IVideoTrack;
-export declare const autoSelectAudioTrackForVideoOld: (selectedVideoTrack: IVideoTrack, videoTracks: IVideoTrack[], audioTracks: IAudioTrack[], { estimatedThroughput, tuning, playbackRate, forwardBufferHealth, history, abrLogger, stallsPredictedThroughput }: IConstraints<IAudioTrack>) => IAudioTrack | undefined;
-export declare const autoSelectAudioTrackForVideoNew: (selectedVideoTrack: IVideoTrack, videoTracks: IVideoTrack[], audioTracks: IAudioTrack[], { estimatedThroughput, tuning, playbackRate, forwardBufferHealth, history, abrLogger, stallsPredictedThroughput }: IConstraints<IAudioTrack>) => IAudioTrack | undefined;
-export {};

package/types/utils/buffer/dynamicBufferTarget.d.ts

@@ -1,10 +0,0 @@
-import type { Kbps, Milliseconds, Nullable } from "@vkontakte/videoplayer-shared";
-import type { ITuningConfig } from "../tuningConfig";
-type DynamicBufferTargetConfig = ITuningConfig["dash"]["dynamicBufferTarget"];
-export interface IDynamicBufferTargetState {
-	throughputKbps: Kbps;
-	currentBitrateKbps: Nullable<Kbps>;
-	baseTargetMs: Milliseconds;
-}
-export declare const computeDynamicBufferTarget: (state: IDynamicBufferTargetState, config: DynamicBufferTargetConfig) => Milliseconds;
-export {};