@vkontakte/videoplayer-core 2.0.165 → 2.0.166-beta.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/videoplayer-core",
-  "version": "2.0.165",
+  "version": "2.0.166-beta.0",
   "author": "vk.com",
   "description": "Videoplayer core library based on the vk.com platform",
   "homepage": "https://vk.com",
@@ -42,6 +42,6 @@
     "**/*.d.ts"
   ],
   "dependencies": {
-    "@vkontakte/videoplayer-shared": "1.0.94"
+    "@vkontakte/videoplayer-shared": "1.0.95-beta.0"
   }
 }

package/types/player/Player.d.ts

@@ -74,48 +74,9 @@ export default class Player implements IPlayer {
 	setLiveLowLatency(isLowLatency: boolean): IPlayer;
 	setLooped(isLooped: boolean): IPlayer;
 	toggleChromecast(): void;
-	/**
-	* Starts 3D-camera constant rotation
-	* Base rotation speed is provided through the tuning config
-	*
-	* @param mx - camera X rotation speed multiplier
-	* @param my - camera Y rotation speed multiplier
-	*
-	* 1 - positive direction
-	* 0.5 - half speed in positive direction
-	* 0 - no rotation
-	* -1 negative direction
-	* -2 double speed in negative direction
-	*
-	* Limitations:
-	*    When camera reaches angles 180 or -180 in vertical direction it stops.
-	*    z-axis is frozen for now
-	*
-	* Set all zeroes to stop the camera rotation
-	*    startCameraManualRotation(0, 0);
-	*/
-	startCameraManualRotation(mx: number, my: number): this;
-	/**
-	* Rotates 3d-camera to given angles relative to current position
-	*/
-	stopCameraManualRotation(immediate?: boolean): this;
-	/**
-	* Rotates 3d-camera to given angles relative to current position
-	* using mouse deltas and scene fov
-	*/
-	moveCameraFocusPX(dxpx: number, dypx: number): this;
-	/**
-	* "Holds" camera so that it can not perform movement without manual control
-	*/
-	holdCamera(): this;
-	/**
-	* "Releases" the camera so that it can move using its internal logic
-	*/
-	releaseCamera(): this;
 	getExactTime(): Seconds;
 	getExactLiveTime(): Seconds;
 	getAllLogs(): ILogEntry[];
-	private getScene3D;
 	private setIntrinsicVideoSize;
 	private initDesiredStateSubscriptions;
 	private initProviderContainerSubscription;

package/types/player/types.d.ts

@@ -1,5 +1,4 @@
 import type { IError, ILogEntry, IObservable, IRectangle, IValueObservable, IValueSubject, Kbps, Milliseconds, QualityLimits, Seconds, Subject, ValueSubject, VideoQuality } from "@vkontakte/videoplayer-shared";
-import type { Pixel } from "../utils/3d/types";
 import type { dump } from "../utils/playbackTelemetry";
 export interface StartEnd<Unit extends number> {
 	start: Unit;
@@ -54,11 +53,6 @@ export interface IPlayer {
 	* Установить предопределенные настройки лимитов.
 	*/
 	setPredefinedQualityLimits(type: PredefinedQualityLimits): IPlayer;
-	startCameraManualRotation(mx: number, my: number): IPlayer;
-	stopCameraManualRotation(immediate: boolean): IPlayer;
-	moveCameraFocusPX(mx: Pixel, my: Pixel, dt: number): IPlayer;
-	holdCamera(): IPlayer;
-	releaseCamera(): IPlayer;
 	setPlaybackRate(playbackRate: PlaybackRate): IPlayer;
 	setLooped(isLooped: boolean): IPlayer;
 	setExternalTextTracks(tracks: Omit<IExternalTextTrack, "type">[]): IPlayer;
@@ -328,6 +322,8 @@ export interface PlayerInfoValues {
 	* default value: `undefined`
 	*/
 	currentNativeBuffer$: StartEnd<Seconds> | undefined;
+	/** Суммарная длительность всех буферизованных диапазонов в миллисекундах */
+	totalBufferDuration$: Milliseconds | undefined;
 	/**
 	* Статус буферизации видео. true если буфер пустой и воспроизведение прервано
 	* В отличии от isStalled показывает и буферизации на старте и после перемотки
@@ -453,10 +449,6 @@ export interface PlayerInfoValues {
 	*/
 	availableSources$: ISources | undefined;
 	/**
-	* Признак того; что сейчас проигрывается 3D-видео
-	*/
-	is3DVideo$: boolean;
-	/**
 	* Длина видео сегмента
 	*/
 	currentVideoSegmentLength$: number;

package/types/providers/DashProvider/baseDashProvider.d.ts

@@ -1,14 +1,13 @@
 import type { IAudioTrack, IDashURLSource, IHLSSource, IInternalTextTrack, IVideoTrack, VideoCodec } from "../../player/types";
 import type { IProviderSubscriptionInfo } from "./lib/types";
 import { ProviderState } from "./lib/types";
-import type { CommonInit, Representation, Stream } from "../utils/parsers/types";
+import type { Representation, Stream } from "../utils/parsers/types";
 import type { IProvider, IProviderAllocationResolution, IProviderParams } from "../types";
 import type { IObservableVideo } from "../utils/HTMLVideoElement/observable";
 import { TrackHistory } from "../../utils/autoSelectTrack";
 import type { IStateMachine } from "../../utils/StateMachine/types";
 import type { ExactVideoQuality, ISubscription, ITracer, Milliseconds, Nullable } from "@vkontakte/videoplayer-shared";
 import { Player } from "./lib/player";
-import { Scene3D } from "../../utils/3d/Scene3D";
 import DroppedFramesManager from "../utils/HTMLVideoElement/DroppedFramesManager";
 import TextTrackManager from "../utils/HTMLVideoElement/TextTrackManager";
 import StallsManager from "../utils/StallsManager";
@@ -22,7 +21,6 @@ type IParams = IProviderParams<IDashURLSource> & {
 	dashMaxTvVideoQuality?: Nullable<ExactVideoQuality>;
 };
 export default abstract class BaseDashProvider implements IProvider {
-	scene3D: Scene3D | undefined;
 	protected subscription: ISubscription;
 	protected volumeSubscription: ISubscription;
 	protected videoState: IStateMachine<ProviderState>;
@@ -64,8 +62,6 @@ export default abstract class BaseDashProvider implements IProvider {
 	protected selectVideoAudioRepresentations(): [Representation, Representation | undefined] | undefined;
 	protected prepare(manifestOffset?: number): void;
 	protected syncPlayback: () => void;
-	protected init3DScene: (init: CommonInit) => void;
-	protected destroy3DScene: () => void;
 	protected playIfAllowed(): void;
 	destroy(): void;
 }

package/types/providers/DashProviderVirtual/baseDashProvider.d.ts

@@ -1,13 +1,12 @@
 import type { IAudioTrack, IBaseTrack, IDashURLSource, IHLSSource, IInternalTextTrack, IVideoTrack, VideoCodec } from "../../player/types";
 import type { IProviderSubscriptionInfo } from "./lib/types";
 import { ProviderState } from "./lib/types";
-import type { CommonInit, Representation, Stream } from "../utils/parsers/types";
+import type { Representation, Stream } from "../utils/parsers/types";
 import type { IProvider, IProviderAllocationResolution, IProviderParams } from "../types";
 import type { IObservableVideo } from "../utils/HTMLVideoElement/observable";
 import { TrackHistory } from "../../utils/autoSelectTrack";
 import type { IStateMachine } from "../../utils/StateMachine/types";
 import type { ExactVideoQuality, ISubscription, ITracer, Milliseconds, Nullable } from "@vkontakte/videoplayer-shared";
-import { Scene3D } from "../../utils/3d/Scene3D";
 import DroppedFramesManager from "../utils/HTMLVideoElement/DroppedFramesManager";
 import TextTrackManager from "../utils/HTMLVideoElement/TextTrackManager";
 import StallsManager from "../utils/StallsManager";
@@ -22,7 +21,6 @@ type IParams = IProviderParams<IDashURLSource> & {
 	dashMaxTvVideoQuality?: Nullable<ExactVideoQuality>;
 };
 export default abstract class BaseDashProvider implements IProvider {
-	scene3D: Scene3D | undefined;
 	protected subscription: ISubscription;
 	protected volumeSubscription: ISubscription;
 	protected videoState: IStateMachine<ProviderState>;
@@ -64,8 +62,6 @@ export default abstract class BaseDashProvider implements IProvider {
 	protected selectVideoAudioRepresentations(): [Representation, Representation | undefined] | undefined;
 	protected prepare(manifestOffset?: number): void;
 	protected syncPlayback: () => void;
-	protected init3DScene: (init: CommonInit) => void;
-	protected destroy3DScene: () => void;
 	protected playIfAllowed(): void;
 	destroy(): void;
 }

package/types/providers/DashProviderVirtual/lib/buffer/virtualBuffer/baseVirtualBufferManager.d.ts

@@ -87,6 +87,7 @@ export declare abstract class BaseVirtualBufferManager<T extends Segment> implem
 	protected loadInits(): Promise<void>;
 	protected loadInitIfNeeded(representation: Representation, requestedPriority?: Priority, critical?: boolean): Promise<void>;
 	protected loadInit(representation: Representation, requestedPriority?: Priority, critical?: boolean): Promise<void>;
+	private isMaintainNativeBufferMutexActive;
 	protected maintainNativeBuffer(): Promise<void>;
 	protected maintainPlaybackBuffer(position: Milliseconds): Promise<void>;
 	protected actualizeLastSegmentInfo(currentPosition: Milliseconds): void;

package/types/providers/ProviderContainer/Mayday/MaydayService.d.ts

@@ -0,0 +1,21 @@
+import type { IError } from "@vkontakte/videoplayer-shared";
+import type { IMaydayDeps, IRecommendation } from "./types";
+export declare class MaydayService {
+	private deps;
+	private heuristics;
+	private tracer;
+	private providerFailures;
+	private failoverUrlIndex;
+	constructor(deps: IMaydayDeps);
+	get currentFailoverUrlIndex(): number | undefined;
+	getRecommendation(error: IError): IRecommendation;
+	private validateRecommendation;
+	private hasAvailableFailoverHost;
+	/**
+	* Если рекомендаций от эвристик нету, то идем по общему сценарию.
+	*/
+	private computeFallbackRecommendation;
+	private applyStateChange;
+	reset(): void;
+	destroy(): void;
+}

package/types/providers/ProviderContainer/Mayday/MaydayStatistics.d.ts

@@ -0,0 +1,25 @@
+import type { IObservable, IValueSubject } from "@vkontakte/videoplayer-shared";
+import { PlaybackState } from "../../../player/types";
+import type { IReinitHistory } from "./types";
+interface IMaydayStatisticsDeps {
+	firstFrameEvent$: IObservable<void>;
+	playbackState$: IValueSubject<PlaybackState | string>;
+}
+export declare class MaydayStatistics {
+	private deps;
+	private providerInitiatedAt;
+	private reinitTimestamps;
+	private reinitReachedPlaying;
+	private playingStartTime;
+	private accumulatedPlayingTime;
+	private firstFrameReceived;
+	private subscription;
+	constructor(deps: IMaydayStatisticsDeps);
+	recordReinit(): void;
+	recordProviderSwitch(): void;
+	getInitiatedAt(): number;
+	getAccumulatedPlayingTime(): number;
+	getReinitHistory(): IReinitHistory;
+	destroy(): void;
+}
+export {};

package/types/providers/ProviderContainer/Mayday/createHeuristicDeps.d.ts

@@ -0,0 +1,3 @@
+import type { ITracer } from "@vkontakte/videoplayer-shared";
+import type { IMaydayDeps, IHeuristicDeps } from "./types";
+export declare function createHeuristicDeps(deps: IMaydayDeps, tracer: ITracer): IHeuristicDeps;

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

@@ -0,0 +1,9 @@
+import type { IError } from "@vkontakte/videoplayer-shared";
+import type { IRecommendation, IHeuristicDeps } from "../types";
+import type { IHeuristic } from "./IHeuristic";
+export declare class FetcherErrorHeuristic implements IHeuristic {
+	private _deps;
+	static readonly heuristicName = "FetcherErrorHeuristic";
+	constructor(_deps: IHeuristicDeps);
+	analyze(error: IError): IRecommendation | null;
+}

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

@@ -0,0 +1,7 @@
+import type { IError } from "@vkontakte/videoplayer-shared";
+import type { IRecommendation } from "../types";
+export interface IHeuristic {
+	analyze(error: IError): IRecommendation | null;
+	reset?(): void;
+	destroy?(): void;
+}

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

@@ -0,0 +1,9 @@
+import type { IError } from "@vkontakte/videoplayer-shared";
+import type { IRecommendation, IHeuristicDeps } from "../types";
+import type { IHeuristic } from "./IHeuristic";
+export declare class MediaErrorHeuristic implements IHeuristic {
+	private deps;
+	static readonly heuristicName = "MediaErrorHeuristic";
+	constructor(deps: IHeuristicDeps);
+	analyze(error: IError): IRecommendation | null;
+}

package/types/providers/ProviderContainer/Mayday/index.d.ts

@@ -0,0 +1,6 @@
+export { MaydayService } from "./MaydayService";
+export type { IMaydayDeps, IFallbackContext, IRecommendation, RecoveryAction } from "./types";
+export type { IHeuristic } from "./heuristics/IHeuristic";
+export { MediaErrorHeuristic } from "./heuristics/MediaErrorHeuristic";
+export { FetcherErrorHeuristic } from "./heuristics/FetcherErrorHeuristic";
+export { MaydayStatistics } from "./MaydayStatistics";

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

@@ -0,0 +1,53 @@
+import type { IVideoTrack, IVideoStream, IAudioStream } from "../../../player/types";
+import type { IValueSubject, Milliseconds, Seconds, IRange, ITracer } from "@vkontakte/videoplayer-shared";
+import type { ITuningConfig } from "../../../utils/tuningConfig";
+export interface IFallbackContext {
+	hasProviderStarted: boolean;
+	canSwitchCodec: boolean;
+}
+export interface IReinitHistory {
+	reachedPlaying: boolean[];
+	deltas: number[];
+}
+export interface IMaydayProviderOutput {
+	position$: IValueSubject<number>;
+	currentVideoTrack$: IValueSubject<IVideoTrack | undefined>;
+	totalBufferDuration$: IValueSubject<Milliseconds | undefined>;
+	currentNativeBuffer$: IValueSubject<IRange<Seconds> | undefined>;
+	bufferRangeCount$: IValueSubject<number | undefined>;
+	availableVideoStreams$: IValueSubject<IVideoStream[]>;
+	currentAudioStream$: IValueSubject<IAudioStream | undefined>;
+}
+export interface IMaydayDeps {
+	tuning: ITuningConfig;
+	failoverHosts: string[];
+	providerOutput: IMaydayProviderOutput;
+	maydayStatistics: {
+		getInitiatedAt: () => number;
+		getReinitHistory: () => IReinitHistory;
+		getAccumulatedPlayingTime: () => number;
+	};
+	getFallbackContext: () => IFallbackContext;
+	tracer: ITracer;
+}
+export interface IHeuristicDeps {
+	tuning: ITuningConfig;
+	getFallbackContext: () => IFallbackContext;
+	tracer: ITracer;
+	getPosition: () => number;
+	getCurrentVideoTrack: () => IVideoTrack | undefined;
+	getInitiatedAt: () => number;
+	getBufferLength: () => number;
+	getBufferAhead: () => number;
+	getBufferRangeCount: () => number;
+	getReinitHistory: () => IReinitHistory;
+	getAccumulatedPlayingTime: () => number;
+	getVideoCodec: () => string | undefined;
+	getAudioCodec: () => string | undefined;
+	getVisibilityState: () => DocumentVisibilityState | undefined;
+}
+export type RecoveryAction = "reinit" | "failover_host" | "switch_codec" | "switch_provider";
+export interface IRecommendation {
+	action: RecoveryAction;
+	reason: string;
+}

package/types/providers/ProviderContainer/index.d.ts

@@ -34,11 +34,14 @@ export default class ProviderContainer implements IProviderContainer {
 	private log;
 	private tracer;
 	private params;
-	private failoverIndex;
+	private currentProviderStarted;
 	private currentFailedVideoTrack;
 	private volumeMultiplierManager;
 	private dashMaxTvVideoQuality;
+	private mayday;
+	private maydayStatistics;
 	constructor(params: IParams);
+	private getFallbackContext;
 	init(): void;
 	destroy(): void;
 	private initProvider;
@@ -46,6 +49,8 @@ export default class ProviderContainer implements IProviderContainer {
 	private switchToNextProvider;
 	private switchToNextVideoCodec;
 	private destroyProvider;
+	private handleMaydayRecommendation;
+	private applyErrorSideEffects;
 	private createProvider;
 	private createScreenProvider;
 	private createChromecastProvider;

package/types/providers/types.d.ts

@@ -5,10 +5,7 @@ import type { IExternalTextTrack, IInternalTextTrack, ITextTrack, IVideoTrack, I
 import type { AudioCodec, HttpConnectionMetrics, HttpConnectionType, HttpDownloadMetrics, IAudioStream, IAudioTrack, ICueSettings, ISources, IVideoStream, SeekState, VideoCodec } from "../player/types";
 import type { IStateMachine } from "../utils/StateMachine/types";
 import type ThroughputEstimator from "../utils/ThroughputEstimator";
-import type { Scene3D } from "../utils/3d/Scene3D";
-import type { Vector2D } from "../utils/3d/types";
 export interface IProvider {
-	scene3D?: Scene3D;
 	destroy(): void;
 }
 export interface IProviderDependencies {
@@ -33,7 +30,6 @@ export interface DesiredStateValues {
 	audioStream: IAudioStream | undefined;
 	autoVideoTrackLimits: QualityLimits;
 	autoVideoTrackSwitching: boolean;
-	cameraOrientation: Vector2D;
 	currentTextTrack: ITextTrack["id"] | undefined;
 	/**
 	* Дополнительные дорожки субтитров подключаемые извне
@@ -87,6 +83,8 @@ export interface IProviderOutput {
 	canChangePlaybackSpeed$: IValueSubject<boolean | undefined>;
 	currentBuffer$: IValueSubject<IRange<Seconds> | undefined>;
 	currentNativeBuffer$: IValueSubject<IRange<Seconds> | undefined>;
+	totalBufferDuration$: IValueSubject<Milliseconds | undefined>;
+	bufferRangeCount$: IValueSubject<number | undefined>;
 	videoLastDataObtainedTimestamp$: IValueSubject<Milliseconds | undefined>;
 	isBuffering$: IValueSubject<boolean>;
 	isLive$: IValueSubject<boolean | undefined>;
@@ -124,7 +122,6 @@ export interface IProviderOutput {
 	soundProhibitedEvent$: ISubject<void>;
 	canplay$: ISubject<void>;
 	severeStallOccurred$: ISubject<boolean>;
-	is3DVideo$: ISubject<boolean>;
 	inPiP$: IValueSubject<boolean>;
 	inFullscreen$: IValueSubject<boolean>;
 	playbackState$: IValueSubject<PlaybackState | string>;

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

@@ -12,6 +12,12 @@ interface IConnectData {
 	playing$: IObservable<undefined>;
 	pause$: IObservable<undefined>;
 }
+interface IDecoderMetrics {
+	totalVideoFrames: number;
+	droppedVideoFrames: number;
+	droppedPercent: number;
+	stalledFrames: number;
+}
 declare class DroppedFramesManager {
 	onDroopedVideoFramesLimit$: Subject<void>;
 	private subscription;
@@ -32,6 +38,10 @@ declare class DroppedFramesManager {
 	connect(data: IConnectData): void;
 	destroy(): void;
 	get droppedVideoMaxQualityLimit(): ExactVideoQuality | undefined;
+	/**
+	* Получить текущие метрики декодера
+	*/
+	getMetrics(): IDecoderMetrics;
 	private subscribe;
 	private handleChangeVideoQuality;
 	private onChangeQuality;

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

@@ -1,4 +1,4 @@
-import type { Seconds, IRange, IObservable, IError, IValueObservable } from "@vkontakte/videoplayer-shared";
+import type { Seconds, IRange, IObservable, IError, IValueObservable, Milliseconds } from "@vkontakte/videoplayer-shared";
 import type { IVolumeState, PlaybackRate } from "../../../player/types";
 export interface IObservableVideo {
 	playing$: IObservable<undefined>;
@@ -18,6 +18,8 @@ export interface IObservableVideo {
 	loadedData$: IObservable<undefined>;
 	isBuffering$: IObservable<boolean>;
 	currentBuffer$: IObservable<IRange<Seconds>>;
+	totalBufferDuration$: IObservable<Milliseconds>;
+	bufferRangeCount$: IObservable<number>;
 	volumeState$: IObservable<IVolumeState>;
 	playbackRateState$: IObservable<PlaybackRate>;
 	inPiP$: IValueObservable<boolean>;

package/types/utils/tuningConfig.d.ts

@@ -8,6 +8,12 @@ import { AudioRuleName, VideoRuleName } from "../providers/utils/Abr/types";
 export type ITuningConfig = {
 	/** @deprecated */
 	configName?: string[];
+	mayday: {
+		/** Порог суммарного времени проигрывания, при котором провайдер считается нестабильным после реинита (MediaError#3) */
+		playingUnstableThresholdMs: Milliseconds;
+		/** Список имён включённых эвристик. Пустой массив = все эвристики выключены */
+		heuristics: string[];
+	};
 	/**
 	* Если true, внутренний video элемент не будет уничтожаться при реините провайдера
 	* и при создании нового экземляра Player.
@@ -175,9 +181,9 @@ export type ITuningConfig = {
 		minNativeBufferSize: Milliseconds;
 		removeTimeShiftFromSegment: Milliseconds;
 		tickMaintainInterval: Milliseconds;
+		tickMaintainThrottle: Milliseconds;
 		minSafeBufferToPlay: Milliseconds;
 		useBufferHoldingOnlyOnStall: boolean;
-		useAbortResetNativeBufferMutex: boolean;
 		useNewAbr: boolean;
 		useAbrPhases: boolean;
 		abrVideoRules: VideoRuleName[];
@@ -329,6 +335,16 @@ export type ITuningConfig = {
 	useDashProviderVirtualMobile: boolean;
 	useNewAutoSelectVideoTrack: boolean;
 	useSafariEndlessRequestBugfix: boolean;
+	/**
+	* Ручка для фикса сброса playbackRate при перемотке live-трансляции на Safari.
+	*
+	* На WebKit/Safari в момент applying seek video.currentTime может кратко отдавать
+	* неверное значение (например, 0). Без фикса это проходит в условие
+	* atLiveDurationEdge и tap сбрасывает playbackRate в 1, перетирая пользовательскую скорость.
+	* С фиксом позиция берётся из optimisticPosition (seek target во время seek), и ложного
+	* срабатывания не происходит. Для VOD нейтрально (isLive=false).
+	*/
+	useSafariOptimisticPositionForLiveEdgeBugfix: boolean;
 	isAudioDisabled: boolean;
 	/**
 	* Разрешает ядру автостарт только если страница, на которой находится плеер активна
@@ -350,24 +366,6 @@ export type ITuningConfig = {
 	webrtc: {
 		connectionRetryMaxNumber: number;
 	};
-	spherical: {
-		enabled: boolean;
-		fov: {
-			x: number;
-			y: number;
-		};
-		orientation?: {
-			x: number;
-			y: number;
-			z: number;
-		};
-		rotationSpeed: number;
-		maxYawAngle: number;
-		rotationSpeedCorrection: number;
-		degreeToPixelCorrection: number;
-		speedFadeTime: Milliseconds;
-		speedFadeThreshold: Milliseconds;
-	};
 	useVolumeMultiplier: boolean;
 	ignoreAudioRendererError: boolean;
 	useEnableSubtitlesParam: boolean;

package/types/utils/3d/Camera3D.d.ts

@@ -1,14 +0,0 @@
-import type { Degree, Vector2D, Vector3D } from "./types";
-/**
-* Модель камеры трехмерной сцены
-*/
-export declare class Camera3D {
-	fov: Vector2D<Degree>;
-	/**
-	*  x: Degree; // yaw (around vertical Y axis)
-	*  y: Degree; // pitch (around horizontal X axis)
-	*  z: Degree; // roll (around normal Z axis)
-	*/
-	orientation: Vector3D<Degree>;
-	constructor(fov: Vector2D<Degree>, orientation: Vector3D<Degree>);
-}

package/types/utils/3d/CameraRotationManager.d.ts

@@ -1,62 +0,0 @@
-import type { Camera3D } from "./Camera3D";
-import type { DegreePerSecond, CameraRotationManagerParams, Degree, Vector3D } from "./types";
-/**
-* Класс управляющий вращением камеры
-*/
-export declare class CameraRotationManager {
-	private options;
-	private camera;
-	private rotating;
-	private fading;
-	private lastTickTS;
-	private lastCameraTurn;
-	private lastCameraTurnTS;
-	private fadeStartSpeed;
-	private fadeCorrection;
-	private fadeTime;
-	rotationSpeed: Vector3D<DegreePerSecond>;
-	constructor(camera: Camera3D, options: CameraRotationManagerParams);
-	/**
-	* Поворот камеры из текущего положения на заданное количество градусов
-	*/
-	turnCamera(dx?: Degree, dy?: Degree, dz?: Degree): void;
-	/**
-	* Поворот камеры в заданное положение
-	*/
-	pointCameraTo(x?: Degree, y?: Degree, z?: Degree): void;
-	/**
-	* Устанавливает угловые скорости по осям
-	* Если скорость для оси не задана будет использована ее текущая скорость
-	*/
-	setRotationSpeed(sx?: DegreePerSecond, sy?: DegreePerSecond, sz?: DegreePerSecond): void;
-	/**
-	* Start permanent rotation
-	*/
-	startRotation(): void;
-	/**
-	* Выставляет нулевую скорость, что приводит к плавной остановке
-	* при передаче поднятого флага останавливает движение мгновенно
-	*/
-	stopRotation(immediate?: boolean): void;
-	/**
-	* "Толкает" камеру для плавного затухания при наличии остаточного "крутящего момента"
-	*/
-	onCameraRelease(): void;
-	/**
-	* Запускает режим затухания
-	*/
-	private startFading;
-	/**
-	* Останавливает режим затухания
-	*/
-	private stopFading;
-	/**
-	* Ограничивает угол поворота по вертикальной оси
-	*/
-	private limitCameraRotationY;
-	/**
-	* Рассчитывает положение камеры согласно текущей скорости с эмуляцией инерции
-	* @param time - ms from page load
-	*/
-	tick(time: number): void;
-}